From 7ea5cb81a529e6fb68c076801b96edc14c5f419d Mon Sep 17 00:00:00 2001 From: Hiten Pandya Date: Thu, 3 Jun 2004 16:37:05 +0000 Subject: [PATCH] Cleanup the manual page: * add an AUTHORS section. * use the '.Pa' command to markup a filename. * remove hard sentence breaks and an empty section command. --- usr.sbin/resident/resident.8 | 31 ++++++++++++++++++++----------- 1 file changed, 20 insertions(+), 11 deletions(-) diff --git a/usr.sbin/resident/resident.8 b/usr.sbin/resident/resident.8 index 4400ee4667..0bcbac83bf 100644 --- a/usr.sbin/resident/resident.8 +++ b/usr.sbin/resident/resident.8 @@ -1,4 +1,4 @@ -.\" $DragonFly: src/usr.sbin/resident/resident.8,v 1.3 2004/06/03 16:28:15 hmp Exp $ +.\" $DragonFly: src/usr.sbin/resident/resident.8,v 1.4 2004/06/03 16:37:05 hmp Exp $ .\" .Dd May 21, 2003 .Dt RESIDENT 8 @@ -17,14 +17,19 @@ .Sh DESCRIPTION The .Nm -utility may be used to make a dynamic binary memory-resident. This works +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 +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 +.Pa ld-elf.so +detects that it is running resident, it skips all initial library loads (because they are already loaded). .Pp -Care must be taken when using this program. It is recommended that you +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. .Pp @@ -33,14 +38,14 @@ The following options are available: .It Fl l List binaries that are currently memory-resident. .It Fl 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 +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. .It Fl x Ar id Delete a registration by id. .It Fl d -Delete a registration by program name. If neither of the above two options -are specified a new registration is created. +Delete a registration by program name. +If neither of the above two options are specified a new registration is created. .It Fl R Delete all registrations in the kernel. .El @@ -49,4 +54,8 @@ Delete all registrations in the kernel. .Xr ldd 1 , .Xr nm 1 , .Xr rtld 1 -.Sh HISTORY +.Sh AUTHORS +The +.Nm +program, its kernel supplement and this manual page was written by +.An Matthew Dillon Aq dillon@backplane.com . -- 2.41.0