unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (NetBSD-6.1.5)
Page:
Section:
Apropos / Subsearch:
optional field

PW_GETCONF(3)              Library Functions Manual              PW_GETCONF(3)

NAME
     pw_getconf, pw_getpwconf -- password encryption configuration access
     function

LIBRARY
     System Utilities Library (libutil, -lutil)

SYNOPSIS
     #include <&lt;util.h>&gt;

     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
     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.

NetBSD 6.1.5                      May 4, 2010                     NetBSD 6.1.5