1 .\" Generated from pam_get_item.c by gendoc.pl
2 .\" $Id: pam_get_item.c 648 2013-03-05 17:54:27Z des $
8 .Nd get PAM information
13 .In security/pam_appl.h
15 .Fn pam_get_item "const pam_handle_t *pamh" "int item_type" "const void **item"
19 function stores a pointer to the item specified by
22 argument in the location pointed to by the
25 The item is retrieved from the PAM context specified by the
32 argument is untouched.
34 The following item types are recognized:
37 The name of the requesting service.
39 The name of the user the application is trying to
42 The name of the current terminal.
44 The name of the applicant's host.
48 describing the current conversation
51 The current authentication token.
53 The expired authentication token.
55 The name of the applicant.
56 .It Dv PAM_USER_PROMPT
57 The prompt to use when asking the applicant for a user
58 name to authenticate as.
59 .It Dv PAM_AUTHTOK_PROMPT
60 The prompt to use when asking the applicant for an
62 .It Dv PAM_OLDAUTHTOK_PROMPT
63 The prompt to use when asking the applicant for an
64 expired authentication token prior to changing it.
66 The name of the host the application runs on.
77 function returns one of the following values:
79 .It Bq Er PAM_SYMBOL_ERR
81 .It Bq Er PAM_SYSTEM_ERR
91 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
97 function and this manual page were
100 Project by ThinkSec AS and Network Associates Laboratories, the
101 Security Research Division of Network Associates, Inc.\& under
102 DARPA/SPAWAR contract N66001-01-C-8035
104 as part of the DARPA CHATS research program.
106 The OpenPAM library is maintained by
107 .An Dag-Erling Sm\(/orgrav Aq des@des.no .