August 18, 2005 PW_GETCONF 3

### NAME

pw_getconf - password encryption configuration access function

### LIBRARY

System Utilities Library (libutil, -lutil)

### SYNOPSIS

```void` pw_getconf(```char *data``, size_t len``, const char *key``, 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.

### FILES

```/etc/passwd.conf`

### ERRORS

pw_getconf(``) will fail if:

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

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

### SEE ALSO

passwd(5), passwd.conf(5)

### HISTORY

The pw_getconf(``) function first appeared in NetBSD1.6.