From 379672e624516d80201f17492040301a9dc9cdc4 Mon Sep 17 00:00:00 2001 From: Alexey Zelkin Date: Thu, 18 Nov 1999 16:04:53 +0000 Subject: mdoc(7)'fy Mostly submitted by: "Philippe Charnier" --- chpass/chpass.1 | 73 +++++++++++++++++++++++++++++++-------------------------- 1 file changed, 40 insertions(+), 33 deletions(-) (limited to 'chpass/chpass.1') diff --git a/chpass/chpass.1 b/chpass/chpass.1 index 763f6bd..b36ddbb 100644 --- a/chpass/chpass.1 +++ b/chpass/chpass.1 @@ -36,7 +36,12 @@ .Dt CHPASS 1 .Os .Sh NAME -.Nm chpass, chfn, chsh, ypchpass, ypchfn, ypchsh +.Nm chpass , +.Nm chfn , +.Nm chsh , +.Nm ypchpass , +.Nm ypchfn , +.Nm ypchsh .Nd add or change user database information .Sh SYNOPSIS .Nm chpass @@ -46,7 +51,7 @@ .Op user .Sh DESCRIPTION The -.Nm chpass +.Nm program allows editing of the user database information associated with @@ -57,14 +62,14 @@ The information is formatted and supplied to an editor for changes. Only the information that the user is allowed to change is displayed. .Pp The options are as follows: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl a The super-user is allowed to directly supply a user database entry, in the format specified by .Xr passwd 5 , as an argument. This argument must be a colon -.Pq Dq : +.Pq Dq \: separated list of all the user database fields, although they may be empty. .It Fl p @@ -72,10 +77,8 @@ The super-user is allowed to directly supply an encrypted password field, in the format used by .Xr crypt 3 , as an argument. -.It Fl s -The -.Fl s -option attempts to change the user's shell to +.It Fl s Ar newshell +Attempt to change the user's shell to .Ar newshell . .El .Pp @@ -192,7 +195,9 @@ heading .Pp The user's .Ar home directory -is the full UNIX path name where the user +is the full +.Ux +path name where the user will be placed at login. .Pp The @@ -210,14 +215,16 @@ Non-standard is defined as a shell not found in .Pa /etc/shells . .Pp Once the information has been verified, -.Nm chpass +.Nm uses .Xr pwd_mkdb 8 to update the user database. .Sh ENVIRONMENT The .Xr vi 1 -editor will be used unless the environment variable EDITOR is set to +editor will be used unless the environment variable +.Ev EDITOR +is set to an alternate editor. When the editor terminates, the information is re-read and used to update the user database itself. @@ -228,12 +235,12 @@ with the user. can also be used in conjunction with NIS, however some restrictions apply. Currently, -.Nm chpass +.Nm can only make changes to the NIS passwd maps through .Xr rpc.yppasswdd 8 , which normally only permits changes to a user's password, shell and GECOS fields. Except when invoked by the super-user on the NIS master server, -.Nm chpass +.Nm (and, similarly, .Xr passwd 1 ) can not use the @@ -258,14 +265,14 @@ Note: these exceptions only apply when the NIS master server is a system). .Pp Consequently, except where noted, the following restrictions apply when -.Nm chpass +.Nm is used with NIS: .Bl -enum -offset indent .It .Em "Only the shell and GECOS information may be changed" . All other fields are restricted, even when -.Nm chpass +.Nm is invoked by the super-user. While support for changing other fields could be added, this would lead to @@ -330,26 +337,24 @@ will refuse to update the NIS maps. .Pp Exception: the super-user on the NIS master server is permitted to change a user's NIS password with -.Nm chpass . +.Nm Ns . .El .Pp There are also a few extra option flags that are available when -.Nm chpass +.Nm is compiled with NIS support: -.Bl -tag -width flag +.Bl -tag -width indent .It Fl l -The -.Fl l -flag forces -.Nm chpass +Force +.Nm to modify the local copy of a user's password information in the even that a user exists in both the local and NIS databases. .It Fl y -This flag has the opposite effect of +Opposite effect of .Fl l . This flag is largely redundant since -.Nm chpass +.Nm operates on NIS entries by default if NIS is enabled. .It Fl d Ar domain Specify a particular NIS domain. @@ -362,7 +367,7 @@ option can be used to override a default, or to specify a domain when the system domain name is not set. .It Fl h Ar host Specify the name or address of an NIS server to query. Normally, -.Nm chpass +.Nm will communicate with the NIS master host specified in the .Pa master.passwd or @@ -389,12 +394,14 @@ Force the use of RPC-based updates when communicating with .Xr rpc.yppasswdd 8 .Pq Dq old-mode . When invoked by the super-user on the NIS master server, -.Nm chpass +.Nm allows unrestricted changes to the NIS passwd maps using dedicated, -non-RPC-based mechanism (in this case, a UNIX domain socket). The +non-RPC-based mechanism (in this case, a +.Ux +domain socket). The .Fl o flag can be used to force -.Nm chpass +.Nm to use the standard update mechanism instead. This option is provided mainly for testing purposes. .El @@ -402,13 +409,13 @@ mainly for testing purposes. .Sh FILES .Bl -tag -width /etc/master.passwd -compact .It Pa /etc/master.passwd -The user database +the user database .It Pa /etc/passwd -A Version 7 format password file +a Version 7 format password file .It Pa /etc/chpass.XXXXXX -Temporary copy of the password file +temporary copy of the password file .It Pa /etc/shells -The list of approved shells +the list of approved shells .El .Sh SEE ALSO .Xr finger 1 , @@ -434,7 +441,7 @@ The and .Xr ypchsh 1 commands are really only links to -.Nm chpass . +.Nm Ns . .Sh BUGS User information should (and eventually will) be stored elsewhere. .Sh HISTORY -- cgit v1.2.3-56-ge451