*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->FreeBSD man pages -> pam_get_item (3)              



NAME    [Toc]    [Back]

     pam_get_item -- get PAM information

LIBRARY    [Toc]    [Back]

     PAM Library (libpam, -lpam)

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <security/pam_appl.h>

     pam_get_item(pam_handle_t *pamh, int item_type, const void **item);

DESCRIPTION    [Toc]    [Back]

     The pam_get_item function stores a pointer to the item specified by the
     item_type argument in the location specified by the item argument.  The
     item is retrieved from the PAM context specified by the pamh argument.
     The following item types are recognized:

     PAM_SERVICE         The name of the requesting service.

     PAM_USER            The name of the user the application is trying to

     PAM_TTY             The name of the current terminal.

     PAM_RHOST           The name of the applicant's host.

     PAM_CONV            A struct pam_conv describing the current conversation

     PAM_AUTHTOK         The current authentication token.

     PAM_OLDAUTHTOK      The expired authentication token.

     PAM_RUSER           The name of the applicant.

     PAM_USER_PROMPT     The prompt to use when asking the applicant for a
                         user name to authenticate as.

     PAM_AUTHTOK_PROMPT  The prompt to use when asking the applicant for an
                         authentication token.

                         The prompt to use when asking the applicant for an
                         expired authentication token prior to changing it.

     See pam_start(3) for a description of struct pam_conv.

RETURN VALUES    [Toc]    [Back]

     The pam_get_item function returns one of the following values:

     [PAM_SYMBOL_ERR]    Invalid symbol.

     [PAM_SYSTEM_ERR]    System error.

SEE ALSO    [Toc]    [Back]

     pam(3), pam_set_item(3), pam_start(3), pam_strerror(3)

STANDARDS    [Toc]    [Back]

     X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules,
     June 1997.

AUTHORS    [Toc]    [Back]

     The pam_get_item function and this manual page were developed for the
     FreeBSD Project by ThinkSec AS and Network Associates Laboratories, 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.

FreeBSD 5.2.1                    July 15, 2003                   FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
nis_intro Tru64 Network Information Service (NIS) introductory information
getfacl FreeBSD get ACL information
yp_update IRIX changes NIS information
setfacl FreeBSD set ACL information
evminfo Tru64 Provides information about EVM
setsysinfo Tru64 Set system information
sysctlbyname FreeBSD get or set system information
sysctlnametomib FreeBSD get or set system information
sysctl OpenBSD get or set system information
pam_get_data FreeBSD get module information
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service