adjust grammar in a few man pages: s/was/were/
[dragonfly.git] / usr.sbin / resident / resident.8
CommitLineData
33a8b578 1.Dd May 21, 2003
8ca15ec8 2.Dt RESIDENT 8
33a8b578
MD
3.Os
4.Sh NAME
5.Nm resident
4041d919 6.Nd Make a dynamic binary resident
33a8b578
MD
7.Sh SYNOPSIS
8.Nm
59e2aa11 9.Op Fl l
8ca15ec8
MD
10.Op Fl f
11.Op Fl x Ar id
12.Op Fl d
13.Op Fl R
59e2aa11 14.Ar "program ..."
33a8b578 15.Sh DESCRIPTION
8ca15ec8
MD
16The
17.Nm
7ea5cb81
HP
18utility may be used to make a dynamic binary memory-resident.
19This works
8ca15ec8 20by running the binary just past its DLL mmap's and relocation and then
7ea5cb81
HP
21making a copy of its vmspace.
22The copy is registered in the kernel and later
23exec's of the program will cause a copy of the copy to be used.
24When
25.Pa ld-elf.so
26detects that it is running resident, it skips all initial library
8ca15ec8
MD
27loads (because they are already loaded).
28.Pp
7ea5cb81
HP
29Care must be taken when using this program.
30It is recommended that you
8ca15ec8
MD
31delete all resident registrations when updating the system shared libraries
32and binaries.
33.Pp
34The following options are available:
35.Bl -tag -width indent
59e2aa11
HP
36.It Fl l
37List binaries that are currently memory-resident.
8ca15ec8 38.It Fl f
7ea5cb81
HP
39Force mode, even if the binary does not appear to be a dynamic binary.
40This way you can run resident through statically compiled wrappers. The first
8ca15ec8
MD
41dynamic binary encountered in the exec chain will be operated on.
42.It Fl x Ar id
43Delete a registration by id.
44.It Fl d
7ea5cb81
HP
45Delete a registration by program name.
46If neither of the above two options are specified a new registration is created.
8ca15ec8
MD
47.It Fl R
48Delete all registrations in the kernel.
49.El
33a8b578
MD
50.Sh SEE ALSO
51.Xr ld 1 ,
52.Xr ldd 1 ,
53.Xr nm 1 ,
fe67c94a
SW
54.Xr rtld 1 ,
55.Xr resident.conf 5
7ea5cb81
HP
56.Sh AUTHORS
57The
58.Nm
97a96273 59program, its kernel supplement and this manual page were written by
e65bc1c3 60.An Matthew Dillon Aq Mt dillon@backplane.com .