GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PAM_GET_USER (3)

NAME

pam_get_user - retrieve user name

CONTENTS

Library
Synopsis
Description
Module Options
Return Values
See Also
Standards
Authors

LIBRARY


.Lb libpam

SYNOPSIS


.In sys/types.h
.In security/pam_appl.h int pam_get_user pam_handle_t *pamh const char **user const char *prompt

DESCRIPTION

The pam_get_user function returns the name of the target user, as specified to pam_start(3). If no user was specified, nor set using pam_set_item(3), pam_get_user will prompt for a user name. Either way, a pointer to the user name is stored in the location pointed to by the user argument, and the corresponding PAM item is updated.

The prompt argument specifies a prompt to use if no user name is cached. If it is NULL, the PAM_USER_PROMPT item will be used. If that item is also NULL, a hardcoded default prompt will be used. Additionally, when pam_get_user is called from a service module, the prompt may be affected by module options as described below. The prompt is then expanded using openpam_subst(3) before it is passed to the conversation function.

MODULE OPTIONS

When called by a service module, pam_get_user will recognize the following module options:
user_prompt
  Prompt to use when asking for the user name. This option overrides both the prompt argument and the PAM_USER_PROMPT item.

RETURN VALUES

The pam_get_user function returns one of the following values:
[PAM_BUF_ERR]
  Memory buffer error.
[PAM_CONV_ERR]
  Conversation failure.
[PAM_SYSTEM_ERR]
  System error.

SEE ALSO

openpam_get_option(3), openpam_subst(3), pam(3), pam_conv(3), pam_get_authtok(3), pam_get_item(3), pam_set_item(3), pam_start(3), pam_strerror(3)

STANDARDS


.Rs X/Open Single Sign-On Service (XSSO) - Pluggable Authentication Modules
.Re

AUTHORS

The pam_get_user function and this manual page were developed for the
.Fx 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.

The OpenPAM library is maintained by
.An Dag-Erling Sm\(/orgrav Aq des@des.no .

Search for    or go to Top of page |  Section 3 |  Main Index


Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.