diff options
author | ru <ru@FreeBSD.org> | 2002-12-04 14:44:20 +0000 |
---|---|---|
committer | ru <ru@FreeBSD.org> | 2002-12-04 14:44:20 +0000 |
commit | 00db9b790a80ab3852c796a9085fa0be03805c16 (patch) | |
tree | 23ce85661fd2d68ab61fc0f0e9b6bcb25cd621c3 /usr.sbin/adduser/rmuser.8 | |
parent | 4e662b87d4b3d96c207df9268edda10efcf1a223 (diff) | |
download | FreeBSD-src-00db9b790a80ab3852c796a9085fa0be03805c16.zip FreeBSD-src-00db9b790a80ab3852c796a9085fa0be03805c16.tar.gz |
mdoc(7) police: overhaul.
Approved by: re
Diffstat (limited to 'usr.sbin/adduser/rmuser.8')
-rw-r--r-- | usr.sbin/adduser/rmuser.8 | 92 |
1 files changed, 51 insertions, 41 deletions
diff --git a/usr.sbin/adduser/rmuser.8 b/usr.sbin/adduser/rmuser.8 index 85d6657..e27241a 100644 --- a/usr.sbin/adduser/rmuser.8 +++ b/usr.sbin/adduser/rmuser.8 @@ -31,7 +31,7 @@ .Os .Sh NAME .Nm rmuser -.Nd removes users from the system +.Nd remove users from the system .Sh SYNOPSIS .Nm .Op Fl y @@ -41,8 +41,8 @@ The .Nm utility removes one or more users submitted on the command line -or from a file. In removing a user from the system, this utility -.Pp +or from a file. +In removing a user from the system, this utility: .Bl -enum .It Removes the user's @@ -53,7 +53,9 @@ Removes any .Xr at 1 jobs belonging to the user. .It -Sends a SIGKILL signal to all processes owned by the user. +Sends a +.Dv SIGKILL +signal to all processes owned by the user. .It Removes the user from the system's local password file. .It @@ -61,13 +63,12 @@ Removes the user's home directory (if it is owned by the user), including handling of symbolic links in the path to the actual home directory. .It -Removes the incoming mail and pop daemon mail files belonging to the +Removes the incoming mail and POP daemon mail files belonging to the user from .Pa /var/mail . .It Removes all files owned by the user from -.Pa /tmp , -.Pa /var/tmp , +.Pa /tmp , /var/tmp , and .Pa /var/tmp/vi.recover . .It @@ -76,66 +77,76 @@ Removes the username from all groups to which it belongs in (If a group becomes empty and the group name is the same as the username, the group is removed; this complements .Xr adduser 8 Ns 's -per-user unique groups). +per-user unique groups.) .El .Pp -The +The .Nm -utility refuses to remove users whose uid is 0 (typically root), since +utility refuses to remove users whose UID is 0 (typically root), since certain actions (namely, killing all the user's processes, and perhaps removing the user's home directory) would cause damage to a running system. -If it is necessary to remove a user whose uid is 0, see +If it is necessary to remove a user whose UID is 0, see .Xr vipw 8 -for information on directly editing the password file +for information on directly editing the password file. .Pp If .Nm was not invoked with the .Fl y -switch it will +option, it will show the selected user's password file entry and ask for confirmation -that the user be removed. It will then ask for confirmation to delete -the user's home directory. If the answer is in the affirmative, the home +that the user be removed. +It will then ask for confirmation to delete +the user's home directory. +If the answer is in the affirmative, the home directory and any files and subdirectories under it will be deleted only if -they are owned by the user. See +they are owned by the user. +See .Xr pw 8 for more details. .Pp As .Nm -operates, it informs the user regarding the current activity. If any +operates, it informs the user regarding the current activity. +If any errors occur, they are posted to standard error and, if it is possible for .Nm to continue, it will. .Pp -Available options: -.Pp -.Bl -tag -width username -.It Fl y -Implicitly answer "yes" to any and all prompts. Currently this includes -prompts on whether to remove the specified user and whether to remove -the home directory. This option requires that either the -.Fl f -option be used or one or more user names be given as commmand line -arguments. -.It Fl f +The options are as follows: +.Bl -tag -width ".Ar username" +.It Fl f Ar file The .Nm utility will get a list of users to be removed from .Ar file , -which will contain one user per line. Anything following a hash mark (#), +which will contain one user per line. +Anything following a hash mark +.Pq Ql # , including the hash mark itself, is considered a comment and will not -be processed. If the file is owned by anyone other than a user with -uid 0 or is writeable by anyone other than the owner +be processed. +If the file is owned by anyone other than a user with +UID 0, or is writeable by anyone other than the owner, .Nm will refuse to continue. -.It Ar \&username +.It Fl y +Implicitly answer +.Dq Li yes +to any and all prompts. +Currently, this includes +prompts on whether to remove the specified user and whether to remove +the home directory. +This option requires that either the +.Fl f +option be used, or one or more user names be given as commmand line +arguments. +.It Ar username Identifies one or more users to be removed; if not present, .Nm interactively asks for one or more users to be removed. .El .Sh FILES -.Bl -tag -width /etc/master.passwd -compact +.Bl -tag -compact .It Pa /etc/master.passwd .It Pa /etc/passwd .It Pa /etc/group @@ -157,10 +168,8 @@ interactively asks for one or more users to be removed. .Sh HISTORY The .Nm -command appeared in +utility appeared in .Fx 2.2 . -.\" .Sh AUTHOR -.\" Guy Helmer, Ames, Iowa .Sh BUGS The .Nm @@ -171,19 +180,20 @@ It is also unable to remove symbolic links that were created by the user in .Pa /tmp or -.Pa /var/tmp +.Pa /var/tmp , as symbolic links on .Bx 4.4 filesystems do not contain information -as to who created them. Also, there may be other files created in +as to who created them. +Also, there may be other files created in .Pa /var/mail other than -.Pa /var/mail/username +.Pa /var/mail/ Ns Ar username and -.Pa /var/mail/.pop.username +.Pa /var/mail/.pop. Ns Ar username that are not owned by the removed user but should be removed. .Pp The .Nm -utility has no knowledge of NIS (Yellow Pages), and it operates only on the +utility has no knowledge of YP/NIS, and it operates only on the local password file. |