[src/trunk]: src/share/man/man5 Documentation for passwd.conf.

[ad <ad%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/1ad47a5f6822
branches:  trunk
changeset: 494430:1ad47a5f6822
user:      ad <ad%NetBSD.org@localhost>
date:      Thu Jul 06 11:23:10 2000 +0000

description:
Documentation for passwd.conf.

diffstat:

 share/man/man5/Makefile      |   4 +-
 share/man/man5/passwd.conf.5 |  95 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 97 insertions(+), 2 deletions(-)

diffs (117 lines):

diff -r d6e14c64b284 -r 1ad47a5f6822 share/man/man5/Makefile
--- a/share/man/man5/Makefile   Thu Jul 06 11:20:30 2000 +0000
+++ b/share/man/man5/Makefile   Thu Jul 06 11:23:10 2000 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.32 2000/06/16 06:52:17 msaitoh Exp $
+#      $NetBSD: Makefile,v 1.33 2000/07/06 11:23:10 ad Exp $
 #      @(#)Makefile    8.1 (Berkeley) 6/5/93
 
 # missing: dump.5 plot.5 
@@ -7,7 +7,7 @@
        fstab.5 genassym.cf.5 group.5 hesiod.conf.5 hosts.5 hosts.equiv.5 \
        ifaliases.5 intro.5 ld.so.conf.5 link.5 lkm.conf.5 login.conf.5 \
        mk.conf.5 monthly.conf.5 motd.5 netconfig.5 netgroup.5 networks.5 \
-       nsswitch.conf.5 passwd.5 \
+       nsswitch.conf.5 passwd.5 passwd.conf.5 \
        phones.5 printcap.5 protocols.5 ranlib.5 rc.conf.5 remote.5 \
        resolv.conf.5 rpc.5 security.conf.5 services.5 shells.5 stab.5 \
        ttyaction.5 types.5 utmp.5 weekly.conf.5
diff -r d6e14c64b284 -r 1ad47a5f6822 share/man/man5/passwd.conf.5
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man5/passwd.conf.5      Thu Jul 06 11:23:10 2000 +0000
@@ -0,0 +1,95 @@
+.\"    $NetBSD: passwd.conf.5,v 1.1 2000/07/06 11:23:11 ad Exp $
+.\"
+.\" Copyright 1997 Niels Provos <provos%physnet.uni-hamburg.de@localhost>
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"      This product includes software developed by Niels Provos.
+.\" 4. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd June 30, 2000
+.Dt PASSWD.CONF 5
+.Os
+.Sh NAME
+.Nm passwd.conf
+.Nd password encryption configuration file
+.Sh SYNOPSIS
+.Nm
+.Sh DESCRIPTION
+The
+.Pa /etc/passwd.conf
+file, consisting of
+.Dq stanzas ,
+describes the configuration of the password cipher used
+to encrypt local or YP passwords.
+.Pp
+There are default, user and group specific stanzas.
+If no user or group
+stanza to a specific option is available, the default stanza
+is used.
+.Pp
+To differentiate between user and group stanzas, groups are prefixed
+with a single dot
+.Pq Sq \&. .
+.Pp
+Some fields and their possible values that can appear in this file are:
+.Bl -tag -width localcipher
+.It Sy localcipher
+The cipher to use for local passwords.
+Possible values are:
+.Dq old ,
+.Dq newsalt,<rounds> ,
+and
+.Dq md5 .
+For
+.Dq newsalt
+the value of rounds is a 24-bit integer with a minimum of 7250 rounds.
+.It Sy ypcipher
+The cipher to use for YP passwords.
+The possible values are the same as for localcipher.
+.El
+.Pp
+To retrieve information from this file use
+.Xr pw_getconf 3 .
+.Pp
+.Sh EXAMPLES
+Use MD5 as the local cipher and old-style DES as the YP cipher:
+.Bd -literal
+ default:
+      localcipher = md5
+      ypcipher = old
+.Ed
+.Sh FILES
+.Bl -tag -width /etc/passwd.conf -compact
+.It Pa /etc/passwd.conf
+.El
+.Sh SEE ALSO
+.Xr passwd 1 ,
+.Xr pw_getconf 3 ,
+.Xr passwd 5
+.Sh HISTORY
+The
+.Nm
+configuration file first appeared in
+.Nx 1.6 .