개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 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(3PAM) or pam_set_item(3PAM), the PAM conversa‐
       tion function will be used to prompt the user for the  user  name  with
       the  given  prompt  string.  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(3PAM).  The service module's pam_sm_authenticate(3PAM)
       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. Ap‐
       plications  that  call pam_authenticate() multiple times should set the
       value of PAM_USER to NULL with pam_set_item()  before  calling  pam_au‐
       thenticate(),  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  re‐
       turn values.

ATTRIBUTES
       See attributes(7) for descriptions 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 ex‐
       ceptions



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

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)

HISTORY
       The pam_get_user() function was introduced in Solaris 2.6.

Oracle Solaris 11.4               15 Mar 2023               pam_get_user(3PAM)