openpam_nullconv(3)

NAME

openpam_nullconv - null conversation function

LIBRARY

library ``libpam''

SYNOPSIS

#include <sys/types.h>
#include <security/pam_appl.h>
#include <security/openpam.h>
int
openpam_nullconv(int n, const struct pam_message **msg,
        struct pam_response **resp, void *data);

DESCRIPTION

The openpam_nullconv function is a null conversation func

tion suitable
for applications that want to use PAM but don't support in

teractive dialog with the user. Such applications should set PAM_AUTHTOK

to whatever
authentication token they've obtained on their own before

calling
pam_authenticate(3) and / or pam_chauthtok(3), and their PAM

configuration should specify the use_first_pass option for all mod

ules that
require access to the authentication token, to make sure

they use
PAM_AUTHTOK rather than try to query the user.

RETURN VALUES

The openpam_nullconv function returns one of the following

values:

[PAM_CONV_ERR] Conversation failure.

SEE ALSO

openpam_ttyconv(3), pam(3), pam_authenticate(3), pam_chauth

tok(3),
pam_prompt(3), pam_set_item(3), pam_strerror(3),

pam_vprompt(3)

STANDARDS

The openpam_nullconv function is an OpenPAM extension.

AUTHORS

The openpam_nullconv function and this manual page were de

veloped for the
FreeBSD Project by ThinkSec AS and Network Associates Labo

ratories, the
Security Research Division of Network Associates, Inc. under

DARPA/SPAWAR
contract N66001-01-C-8035 (``CBOSS''), as part of the DARPA

CHATS
research program.

BSD June 16, 2005

BSD