pw_getconf(3) [netbsd man page]

PW_GETCONF(3)						   BSD Library Functions Manual 					     PW_GETCONF(3)

NAME

     pw_getconf, pw_getpwconf -- password encryption configuration access function

LIBRARY

     System Utilities Library (libutil, -lutil)

SYNOPSIS

     #include <util.h>

     void
     pw_getconf(char *data, size_t len, const char *key, const char *option);

     void
     pw_getpwconf(char *data, size_t len, const struct passwd *pwd, const char *option);

DESCRIPTION

     The pw_getconf() function reads /etc/passwd.conf and retrieves the value of the option specified by option from the section given by key.	If
     no suitable entry is found for the key an empty string will be returned in data.

     To retrieve default values the key default can be used.  In this case, if /etc/passwd.conf does not exist or does not contain a default sec-
     tion, the built-in defaults will be returned.  They are as follows:

	   option	  data
	   ypcipher	  old
	   localcipher	  old

     An empty string is returned for all errors.

     pw_getpwconf() returns the value for the option specified for the particular user specified in pwd.  If that option is not found, then it
     tries to find the option in the primary group of that user, and if that fails, then it returns the default entry.

FILES

     /etc/passwd.conf

ERRORS

     pw_getconf() and pw_getpwconf() will fail if:

     [ENOENT]		There is no option named option in the specified key.

     [ENOTDIR]		There is no key in /etc/passwd.conf named key.

SEE ALSO

     passwd(5), passwd.conf(5)

HISTORY

     The pw_getconf() function first appeared in NetBSD 1.6.

BSD
								    May 4, 2010 							       BSD

PASSWD.CONF(5)						      BSD File Formats Manual						    PASSWD.CONF(5)

NAME

     passwd.conf -- password encryption configuration file

SYNOPSIS

     passwd.conf

DESCRIPTION

     The /etc/passwd.conf file, consisting of ``stanzas'', describes the configuration of the password cipher used to encrypt local or YP pass-
     words.

     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.

     To differentiate between user and group stanzas, groups are prefixed with a single colon (':').

     Some fields and their possible values that can appear in this file are:

     localcipher  The cipher to use for local passwords.

		  Possible values are: ``old'', ``newsalt,<rounds>'', ``md5'', ``sha1,<rounds>'', and ``blowfish,<rounds>''.  For ``newsalt'' the
		  value of rounds is a 24-bit integer with a minimum of 7250 rounds.  For ``sha1'' the value of rounds is a 32-bit integer, 0
		  means use the default of 24680.  For ``blowfish'' the value can be between 4 and 31.	It specifies the base 2 logarithm of the
		  number of rounds.

		  If not specified, the default value is ``old''.

     ypcipher	  The cipher to use for YP passwords.

		  The possible values are the same as for localcipher.

		  If not specified, the default value is ``old''.

     To retrieve information from this file use pw_getconf(3).

FILES

     /etc/passwd.conf

EXAMPLES

     Use SHA1 as the local cipher and old-style DES as the YP cipher.  Use blowfish with 2^5 rounds for root:

      default:
	   localcipher = sha1
	   ypcipher = old

      root:
	   localcipher = blowfish,5

SEE ALSO

     passwd(1), pwhash(1), pw_getconf(3), passwd(5)

HISTORY

     The passwd.conf configuration file first appeared in NetBSD 1.6.

     The default value of localcipher was set to ``sha1'' in /etc/passwd.conf starting from NetBSD 6.0.

BSD
								 December 3, 2010							       BSD