DragonFly On-Line Manual Pages

RESIDENT(8)            DragonFly System Manager's Manual           RESIDENT(8)

NAME
     resident -- Make a dynamic binary resident

SYNOPSIS
     resident [-l] [-f] [-x id] [-d] [-R] program ...

DESCRIPTION
     The resident utility may be used to make a dynamic binary memory-
     resident.  This works by running the binary just past its DLL mmap's and
     relocation and then making a copy of its vmspace.  The copy is registered
     in the kernel and later exec's of the program will cause a copy of the
     copy to be used.  When ld-elf.so detects that it is running resident, it
     skips all initial library loads (because they are already loaded).

     Care must be taken when using this program.  It is recommended that you
     delete all resident registrations when updating the system shared
     libraries and binaries.

     The following options are available:

     -l      List binaries that are currently memory-resident.

     -f      Force mode, even if the binary does not appear to be a dynamic
             binary.  This way you can run resident through statically
             compiled wrappers.  The first dynamic binary encountered in the
             exec chain will be operated on.

     -x id   Delete a registration by id.

     -d      Delete a registration by program name.  If neither of the above
             two options are specified a new registration is created.

     -R      Delete all registrations in the kernel.

SEE ALSO
     ld(1), ldd(1), nm(1), rtld(1), exec_sys_register(2), resident.conf(5)

AUTHORS
     The resident program, its kernel supplement and this manual page were
     written by Matthew Dillon <dillon@backplane.com>.

DragonFly 4.3                    March 7, 2016                   DragonFly 4.3