Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 section,
     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 partic-
     ular 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

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | FILES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pw_getconf&sektion=3&manpath=NetBSD+6.0>

home | help