개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(1M)을 검색하려면 섹션에서 1M 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.

pam_get_user(3pam)

pam_get_user(3PAM)           PAM Library Functions          pam_get_user(3PAM)



NAME
       pam_get_user - PAM routine to retrieve user name

SYNOPSIS
       cc [ flag ... ] file ...  -lpam [ library ... ]
       #include <security/pam_appl.h>



       int pam_get_user(pam_handle_t *pamh, char **user,
            const char *prompt);

DESCRIPTION
       The  pam_get_user() function is used by PAM service modules to retrieve
       the current user name from the PAM handle. If the  user  name  has  not
       been set with pam_start() or pam_set_item(), the PAM conversation func‐
       tion will be used to prompt the user for the user name with the  string
       "prompt".  If  prompt  is  NULL,  then pam_get_item() is called and the
       value of PAM_USER_PROMPT  is  used  for  prompting.  If  the  value  of
       PAM_USER_PROMPT is NULL, the following default prompt is used:

         Please enter user name:



       After   the  user  name  is  gathered  by  the  conversation  function,
       pam_set_item() is called to set the value of PAM_USER.  By  convention,
       applications   that  need  to  prompt  for  a  user  name  should  call
       pam_set_item() and set the  value  of  PAM_USER_PROMPT  before  calling
       pam_authenticate(). The service module's pam_sm_authenticate() function
       will then call pam_get_user() to prompt for the user name.


       Note that certain PAM service modules, such as a smartcard module,  may
       override  the  value  of  PAM_USER_PROMPT and pass in their own prompt.
       Applications that call pam_authenticate() multiple times should set the
       value   of   PAM_USER   to  NULL  with  pam_set_item()  before  calling
       pam_authenticate(), if they want the user to be prompted for a new user
       name  each  time.  The value of user retrieved by pam_get_user() should
       not be modified or freed. The item will be released by pam_end().

RETURN VALUES
       Upon success, pam_get_user() returns PAM_SUCCESS; otherwise it  returns
       an  error  code.  Refer  to  pam(3PAM) for information on error related
       return values.

ATTRIBUTES
       See attributes(7) for description of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE  VALUE  _  Interface  StabilityCommitted _ MT-LevelMT-Safe with
       exceptions


SEE ALSO
       pam(3PAM), pam_authenticate(3PAM),  pam_end(3PAM),  pam_get_item(3PAM),
       pam_set_item(3PAM),       pam_sm(3PAM),      pam_sm_authenticate(3PAM),
       pam_start(3PAM), attributes(7)

NOTES
       The interfaces in libpam are MT-Safe only if  each  thread  within  the
       multithreaded application uses its own PAM handle.



Oracle Solaris 11.4               11 May 2021               pam_get_user(3PAM)