Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

- Use .Ar for argument. 

- Move SEE ALSO section before the HISTORY section as described in
  mdoc(7) with:
	+ removing traing dot.
	+ spliting files into FILES section.
- Refer pathnames using .Pa (rather .Ar or .Xr).
This commit is contained in:
enami 2000-02-28 05:10:56 +00:00
parent e0573deb3b
commit b0a2a63928
10 changed files with 130 additions and 98 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
usr.sbin/user/group.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: group.8,v 1.3 1999/12/24 09:08:49 agc Exp $ */
.\" $NetBSD: group.8,v 1.4 2000/02/28 05:10:56 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -43,23 +43,23 @@ add
.Op Fl g Ar gid
.Op Fl o
.Op Fl v
group
.Ar group
.Nm ""
del
.Op Fl v
group
.Ar group
.Nm ""
info
.Op Fl e
.Op Fl v
group
.Ar group
.Nm ""
mod
.Op Fl g Ar gid
.Op Fl n Ar newname
.Op Fl o
.Op Fl v
group
.Ar group
.Sh DESCRIPTION
The
.Nm
@ -76,6 +76,12 @@ For a full explanation of the options, please see the relevant manual page.
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh SEE ALSO
.Xr group 5 ,
.Xr groupadd 8 ,
.Xr groupdel 8 ,
.Xr groupinfo 8 ,
.Xr groupmod 8
.Sh HISTORY
The
.Nm
@ -88,9 +94,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr group 5 ,
.Xr groupadd 8 ,
.Xr groupdel 8 ,
.Xr groupinfo 8 ,
.Xr groupmod 8 .

10
usr.sbin/user/groupadd.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: groupadd.8,v 1.3 1999/12/24 09:08:49 agc Exp $ */
.\" $NetBSD: groupadd.8,v 1.4 2000/02/28 05:10:56 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -42,7 +42,7 @@
.Op Fl g Ar gid
.Op Fl o
.Op Fl v
group
.Ar group
.Sh DESCRIPTION
The
.Nm
@ -60,6 +60,9 @@ enables verbose mode - explain the commands as they are executed.
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh SEE ALSO
.Xr group 5 ,
.Xr user 8
.Sh HISTORY
The
.Nm
@ -72,6 +75,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr group 5 ,
.Xr user 8

10
usr.sbin/user/groupdel.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: groupdel.8,v 1.4 1999/12/24 09:08:49 agc Exp $ */
.\" $NetBSD: groupdel.8,v 1.5 2000/02/28 05:10:56 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -40,7 +40,7 @@
.Sh SYNOPSIS
.Nm
.Op Fl v
group
.Ar group
.Sh DESCRIPTION
The
.Nm
@ -54,6 +54,9 @@ enables verbose mode - explain the commands as they are executed.
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh SEE ALSO
.Xr group 5 ,
.Xr user 8
.Sh HISTORY
The
.Nm
@ -66,6 +69,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr group 5 ,
.Xr user 8

13
usr.sbin/user/groupinfo.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: groupinfo.8,v 1.1 1999/12/24 09:08:49 agc Exp $ */
.\" $NetBSD: groupinfo.8,v 1.2 2000/02/28 05:10:56 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -41,7 +41,7 @@
.Nm
.Op Fl e
.Op Fl v
group
.Ar group
.Sh DESCRIPTION
The
.Nm
@ -64,6 +64,12 @@ The group argument may either be a group's name, or a gid.
The
.Nm
utility exits 0 if the group name or gid exists, and non-zero if it does not.
.Sh FILES
.Bl -tag -width /etc/usermgmt.conf -compact
.It Pa /etc/usermgmt.conf
.El
.Sh SEE ALSO
.Xr passwd 5
.Sh HISTORY
The
.Nm
@ -76,6 +82,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr passwd 5 ,
.Xr /etc/usermgmt.conf

12
usr.sbin/user/groupmod.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: groupmod.8,v 1.3 1999/12/24 09:08:50 agc Exp $ */
.\" $NetBSD: groupmod.8,v 1.4 2000/02/28 05:10:56 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -43,7 +43,7 @@
.Op Fl n Ar newname
.Op Fl o
.Op Fl v
group
.Ar group
.Sh DESCRIPTION
The
.Nm
@ -63,6 +63,10 @@ enables verbose mode - explain the commands as they are executed.
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh SEE ALSO
.Xr group 5 ,
.Xr group 8 ,
.Xr user 8
.Sh HISTORY
The
.Nm
@ -75,7 +79,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr group 5 ,
.Xr group 8 ,
.Xr user 8

44
usr.sbin/user/user.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: user.8,v 1.4 1999/12/24 09:08:50 agc Exp $ */
.\" $NetBSD: user.8,v 1.5 2000/02/28 05:10:57 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -63,7 +63,7 @@ add
.Op Fl s Ar shell
.Op Fl u Ar uid
.Op Fl v
user
.Ar user
.Nm ""
del
.Op Fl D
@ -73,12 +73,12 @@ del
.Op Fl p
.Op Fl r
.Op Fl v
user
.Ar user
.Nm ""
info
.Op Fl e
.Op Fl v
user
.Ar user
.Nm ""
mod
.Op Fl G Ar secondary-group
@ -94,7 +94,7 @@ mod
.Op Fl s Ar shell
.Op Fl u Ar uid
.Op Fl v
user
.Ar user
.Sh DESCRIPTION
The
.Nm
@ -111,6 +111,29 @@ For a full explanation of the options, please see the relevant manual page.
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh FILES
.Bl -tag -width /etc/usermgmt.conf -compact
.It Pa /etc/skel/.[A-z]*
Skelton dot files for new user
.It Pa /etc/usermgmt.conf
Configuration file for
.Xr user 8 ,
.Xr group 8
and those backend commands
.It Pa /usr/share/examples/usermgmt
A directory hopefully containing examples for
.Xr user 8
and
.Xr group 8
.El
.Sh SEE ALSO
.Xr chpass 1 ,
.Xr group 5 ,
.Xr passwd 5 ,
.Xr useradd 8 ,
.Xr userdel 8 ,
.Xr userinfo 8 ,
.Xr usermod 8
.Sh HISTORY
The
.Nm
@ -123,14 +146,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr chpass 1 ,
.Xr group 5 ,
.Xr /etc/skel/.[A-z]* ,
.Xr /etc/usermgmt.conf ,
.Xr /usr/share/examples/usermgmt ,
.Xr passwd 5 ,
.Xr useradd 8 ,
.Xr userdel 8 ,
.Xr userinfo 8 ,
.Xr usermod 8 .

53
usr.sbin/user/useradd.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: useradd.8,v 1.4 1999/12/24 09:08:50 agc Exp $ */
.\" $NetBSD: useradd.8,v 1.5 2000/02/28 05:10:57 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -61,19 +61,22 @@
.Op Fl s Ar shell
.Op Fl u Ar uid
.Op Fl v
user
.Ar user
.Sh DESCRIPTION
The
.Nm useradd
utility adds a user to the system, creating and
populating a home directory if necessary.
Any skeleton dot files will be provided
for the new user if they exist in the /etc/skel directory.
for the new user if they exist in the
.Pa /etc/skel
directory.
Default values for the base directory, the time of password expiry,
the skeleton directory,
seconds until password change, primary group, the range from which the uid will be
allocated,
and default login shell can be provided in the /etc/usermgmt.conf
and default login shell can be provided in the
.Pa /etc/usermgmt.conf
file.
.Pp
The first format of the command shown above (utilising the -D option)
@ -111,8 +114,9 @@ after setting any defaults, and then values from that file,
the command line options are processed:
.Bl -tag -width Ds
.It Fl G Ar secondary-group
is the secondary group to which the user will be added in
the /etc/group file.
is the secondary group to which the user will be added in the
.Pa /etc/group
file.
.It Fl b Ar base-directory
is the base directory name, in which the user's new home
directory will be created, should the -m option be specified.
@ -120,7 +124,7 @@ This value can be preset for all users
by using the
.Ar base_dir
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - it has the format:
.Ar base_dir <path-to-base-dir> .
.It Fl c Ar comment
@ -144,7 +148,7 @@ This value can be preset for all users
by using the
.Ar expire
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - it has the format:
.Ar expire <secs-to-expiry> .
.It Fl g Ar gid/name/=uid
@ -153,13 +157,13 @@ If this is
.Ar "-g=uid" ,
then a uid and gid will be picked which are both unique
and the same, and a line added to
.Ar /etc/group
.Pa /etc/group
to describe the new group.
This value can be preset for all users
by using the
.Ar gid
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - it has the format:
.Ar group <groupname/groupid/=uid> .
.It Fl k Ar skeleton directory
@ -178,7 +182,7 @@ This value can be preset for all users
by using the
.Ar password
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - it has the format:
.Ar password <encrypted-password> .
.It Fl s Ar shell
@ -187,7 +191,7 @@ This value can be preset for all users
by using the
.Ar shell
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - it has the format:
.Ar shell <login-shell> .
.It Fl u Ar uid
@ -196,7 +200,7 @@ Boundaries for this value can be preset for all users
by using the
.Ar range
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - they have the format:
.Ar range <starting-uid>..<ending-uid> .
.It Fl v
@ -206,6 +210,19 @@ enables verbose mode - explain the commands as they are executed.
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh FILES
.Bl -tag -width /etc/usermgmt.conf -compact
.It Pa /etc/usermgmt.conf
.It Pa /etc/skel/.[A-z]*
.It Pa /usr/share/examples/usermgmt
.El
.Sh SEE ALSO
.Xr chpass 1 ,
.Xr passwd 5 ,
.Xr group 5 ,
.Xr user 8 ,
.Xr userdel 8 ,
.Xr usermod 8
.Sh HISTORY
The
.Nm
@ -218,13 +235,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr chpass 1 ,
.Xr passwd 5 ,
.Xr group 5 ,
.Xr user 8 ,
.Xr userdel 8 ,
.Xr usermod 8 ,
.Xr /etc/usermgmt.conf ,
.Xr /etc/skel/.[A-z]* ,
.Xr /usr/share/examples/usermgmt

15
usr.sbin/user/userdel.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: userdel.8,v 1.3 1999/12/24 09:08:50 agc Exp $ */
.\" $NetBSD: userdel.8,v 1.4 2000/02/28 05:10:57 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -79,7 +79,7 @@ This option can be helpful in preserving a user's
files for later use by members of that person's
group after the user has moved on.
This value can also be set in the
/etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file, using the "preserve" field. If the field
has any of the values "true", "yes", or a non-zero number,
then user information preservation will take place.
@ -93,6 +93,13 @@ perform any actions in a verbose manner.
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh FILES
.Bl -tag -width /etc/usermgmt.conf -compact
.It Pa /etc/usermgmt.conf
.El
.Sh SEE ALSO
.Xr false 1 ,
.Xr passwd 5
.Sh HISTORY
The
.Nm
@ -105,7 +112,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr false 1 ,
.Xr passwd 5 ,
.Xr /etc/usermgmt.conf

13
usr.sbin/user/userinfo.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: userinfo.8,v 1.1 1999/12/24 09:08:50 agc Exp $ */
.\" $NetBSD: userinfo.8,v 1.2 2000/02/28 05:10:57 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -41,7 +41,7 @@
.Nm
.Op Fl e
.Op Fl v
user
.Ar user
.Sh DESCRIPTION
The
.Nm
@ -64,6 +64,12 @@ The user argument may either be a user's name, or a uid.
The
.Nm
utility exits 0 if the user name or uid exists, and non-zero if it does not.
.Sh FILES
.Bl -tag -width /etc/usermgmt.conf -compact
.It Pa /etc/usermgmt.conf
.El
.Sh SEE ALSO
.Xr passwd 5
.Sh HISTORY
The
.Nm
@ -76,6 +82,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr passwd 5 ,
.Xr /etc/usermgmt.conf

36
usr.sbin/user/usermod.8
View File

@ -1,4 +1,4 @@
.\" $NetBSD: usermod.8,v 1.3 1999/12/24 09:08:51 agc Exp $ */
.\" $NetBSD: usermod.8,v 1.4 2000/02/28 05:10:57 enami Exp $ */
.\"
.\"
.\" Copyright (c) 1999 Alistair G. Crooks. All rights reserved.
@ -52,22 +52,23 @@
.Op Fl s Ar shell
.Op Fl u Ar uid
.Op Fl v
user
.Ar user
.Sh DESCRIPTION
The
.Nm
utility modifies user login information on the system.
Default values for the user are taken from the information
provided in the
/etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file.
.Pp
After setting any defaults, and then values from that file,
the command line options are processed:
.Bl -tag -width Ds
.It Fl G Ar secondary-group
is the secondary group to which the user will be added in
the /etc/group file.
is the secondary group to which the user will be added in the
.Pa /etc/group
file.
.It Fl c Ar comment
is the comment field (also, for historical reasons known as the
GECOS field) which will be added for the user, and typically will include
@ -89,7 +90,7 @@ This value can be preset for all users
by using the
.Ar expire
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - it has the format:
.Ar expire <secs-to-expiry> .
.It Fl g Ar gid/name/=uid
@ -98,7 +99,7 @@ If this is
.Ar "-g=uid" ,
then a uid and gid will be picked which are both unique
and the same, and a line added to
.Ar /etc/group
.Pa /etc/group
to describe the new group.
This value can be preset for all users
by using the
@ -123,7 +124,7 @@ This value can be preset for all users
by using the
.Ar password
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - it has the format:
.Ar password <encrypted-password> .
.It Fl s Ar shell
@ -141,7 +142,7 @@ Boundaries for this value can be preset for all users
by using the
.Ar range
field in the
.Xr /etc/usermgmt.conf
.Pa /etc/usermgmt.conf
file - they have the format:
.Ar range <starting-uid>..<ending_uid> .
.It Fl v
@ -151,6 +152,16 @@ enables verbose mode - explain the commands as they are executed.
The
.Nm
utility exits 0 on success, and >0 if an error occurs.
.Sh FILES
.Bl -tag -width /etc/usermgmt.conf -compact
.It Pa /etc/usermgmt.conf
.It Pa /etc/skel/.[A-z]*
.It Pa /usr/share/examples/usermgmt
.El
.Sh SEE ALSO
.Xr chpass 1 ,
.Xr passwd 5 ,
.Xr group 5
.Sh HISTORY
The
.Nm
@ -163,10 +174,3 @@ package by the same author.
The
.Nm
utility was written by Alistair G. Crooks (agc@netbsd.org).
.Sh SEE ALSO
.Xr chpass 1 ,
.Xr passwd 5 ,
.Xr group 5 ,
.Xr /etc/usermgmt.conf ,
.Xr /etc/skel/.[A-z]* ,
.Xr /usr/share/examples/usermgmt