1 .\" Generated from pam_get_user.c by gendoc.pl
2 .\" $Id: pam_get_user.c 670 2013-03-17 19:26:07Z des $
13 .In security/pam_appl.h
15 .Fn pam_get_user "pam_handle_t *pamh" "const char **user" "const char *prompt"
19 function returns the name of the target user, as
22 If no user was specified, nor set using
25 will prompt for a user name.
26 Either way, a pointer to the user name is stored in the location
29 argument, and the corresponding PAM item is
34 argument specifies a prompt to use if no user name is
43 a hardcoded default prompt will be used.
46 is called from a service module, the
47 prompt may be affected by module options as described below.
48 The prompt is then expanded using
50 before it is passed to
51 the conversation function.
53 When called by a service module,
56 following module options:
59 Prompt to use when asking for the user name.
60 This option overrides both the
69 function returns one of the following values:
73 .It Bq Er PAM_CONV_ERR
75 .It Bq Er PAM_SYSTEM_ERR
79 .Xr openpam_get_option 3 ,
83 .Xr pam_get_authtok 3 ,
90 .%T "X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules"
96 function and this manual page were
99 Project by ThinkSec AS and Network Associates Laboratories, the
100 Security Research Division of Network Associates, Inc.\& under
101 DARPA/SPAWAR contract N66001-01-C-8035
103 as part of the DARPA CHATS research program.
105 The OpenPAM library is maintained by
106 .An Dag-Erling Sm\(/orgrav Aq des@des.no .