pam_authenticate man page on OpenDarwin

Man page or keyword search:  
man Server   3202 pages
apropos Keyword Search (all sections)
Output format
OpenDarwin logo
[printable version]

PAM_AUTHENTICATE(3)	   App. Programmers' Manual	   PAM_AUTHENTICATE(3)

       pam_authenticate - authenticate a user

       #include <security/pam_appl.h>

       int pam_authenticate(pam_handle_t *pamh, int  flags);


       Use  this  function  to	authenticate  an applicant user.  It is linked
       dynamically to the authentication modules by Linux-PAM.	It is the task
       of these module to perform such an authentication.  The specific nature
       of the authentication is not the concern of the application.

       Following successful completion, the name  of  the  authenticated  user
       will  be	 present  in  the  Linux-PAM  item PAM_USER.  This item may be
       recovered with a call to pam_get_item(3).

       The application developer should note that the modules may request that
       the  user  enter	 their	username  via  the conversation mechanism (see
       pam_start(3)).  Should this be the case, the user-prompt string can  be
       set via the PAM_USER_PROMPT item (see pam_set_item(3)).

       On  success  PAM_SUCCESS is returned.  All other returns should be con‐
       sidered authentication failures and will be delayed by an amount speci‐
       fied  with  prior  calls	 to pam_fail_delay(3).	Specific failures that
       demand special attention are the following:

	      the application should exit immediately. Of  course,  pam_end(3)
	      should be called first.

	      the  application	has  tried  too many times to authenticate the
	      user, authentication should not be attempted again.

       May be translated to text with pam_strerror(3).

       DCE-RFC 86.0, October 1995.

       none known.

       pam_start(3), pam_get_item(3) pam_fail_delay(3) and pam_strerror(3).

       Also, see the three Linux-PAM Guides, for System administrators, module
       developers, and application developers.

Linux-PAM 0.55			  1996 Dec 9		   PAM_AUTHENTICATE(3)

List of man pages available for OpenDarwin

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net