summaryrefslogtreecommitdiffstats
path: root/adduser/rmuser.8
diff options
context:
space:
mode:
authorScott Long <scottl@FreeBSD.org>2002-12-03 05:41:09 +0000
committerScott Long <scottl@FreeBSD.org>2002-12-03 05:41:09 +0000
commit947f8d29cb95cc2cca135ba261063df1806da2ec (patch)
treed185d7304940d3fca49a6c38fb14c8a9f3d68a01 /adduser/rmuser.8
parent59f4e321f857f45239599e1339b19422c7f97514 (diff)
downloadpw-darwin-947f8d29cb95cc2cca135ba261063df1806da2ec.tar.gz
pw-darwin-947f8d29cb95cc2cca135ba261063df1806da2ec.tar.zst
pw-darwin-947f8d29cb95cc2cca135ba261063df1806da2ec.zip
Replace the perl versions of adduser and rmuser with shell script versions.
Submitted by: Mike Makonnen <mtm@identd.net> Approved by: re
Diffstat (limited to 'adduser/rmuser.8')
-rw-r--r--adduser/rmuser.869
1 files changed, 41 insertions, 28 deletions
diff --git a/adduser/rmuser.8 b/adduser/rmuser.8
index 2e55694..85d6657 100644
--- a/adduser/rmuser.8
+++ b/adduser/rmuser.8
@@ -26,7 +26,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd February 23, 1997
+.Dd May 10, 2002
.Dt RMUSER 8
.Os
.Sh NAME
@@ -35,11 +35,13 @@
.Sh SYNOPSIS
.Nm
.Op Fl y
-.Op Ar username
+.Op Fl f Ar file
+.Op Ar username ...
.Sh DESCRIPTION
The
.Nm
-utility
+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
.Bl -enum
.It
@@ -77,29 +79,27 @@ the group is removed; this complements
per-user unique groups).
.El
.Pp
-The
+The
.Nm
-utility
-politely 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
.Xr vipw 8
-for information on directly editing the password file, by which the desired
-user's
-.Xr passwd 5
-entry may be removed manually.
+for information on directly editing the password file
.Pp
-If not running "affirmatively" (i.e., option
-.Fl y
-is not specified),
-.Nm
-shows the selected user's password file entry and asks for confirmation
-that you wish to remove the user. If the user's home directory is owned
-by the user,
+If
.Nm
-asks whether you wish to remove the user's home directory and everything
-below.
+was not invoked with the
+.Fl y
+switch 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
+directory and any files and subdirectories under it will be deleted only if
+they are owned by the user. See
+.Xr pw 8
+for more details.
.Pp
As
.Nm
@@ -112,13 +112,27 @@ Available options:
.Pp
.Bl -tag -width username
.It Fl y
-Affirm - any question that would be asked is answered implicitly in
-the affirmative (i.e., yes). A username must also be specified on the
-command line if this option is used.
+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
+.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 (#),
+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
+.Nm
+will refuse to continue.
.It Ar \&username
-Identifies the user to be removed; if not present,
+Identifies one or more users to be removed; if not present,
.Nm
-interactively asks for the user to be removed.
+interactively asks for one or more users to be removed.
.El
.Sh FILES
.Bl -tag -width /etc/master.passwd -compact
@@ -137,12 +151,13 @@ interactively asks for the user to be removed.
.Xr group 5 ,
.Xr passwd 5 ,
.Xr adduser 8 ,
+.Xr pw 8 ,
.Xr pwd_mkdb 8 ,
.Xr vipw 8
.Sh HISTORY
The
.Nm
-utility appeared in
+command appeared in
.Fx 2.2 .
.\" .Sh AUTHOR
.\" Guy Helmer, Ames, Iowa
@@ -152,9 +167,7 @@ The
utility does not comprehensively search the filesystem for all files
owned by the removed user and remove them; to do so on a system
of any size is prohibitively slow and I/O intensive.
-The
-.Nm
-utility also is unable to remove symbolic links that were created by the
+It is also unable to remove symbolic links that were created by the
user in
.Pa /tmp
or