openpam_log(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
OPENPAM_LOG(3)          NetBSD Library Functions Manual         OPENPAM_LOG(3)


NAME

     openpam_log -- log a message through syslog


LIBRARY

     Pluggable Authentication Module Library (libpam, -lpam)


SYNOPSIS

     #include <sys/types.h>
     #include <security/pam_appl.h>
     #include <security/openpam.h>

     void
     openpam_log(int level, const char *fmt, ...);


DESCRIPTION

     The openpam_log function logs messages using syslog(3).  It is primarily
     intended for internal use by the library and modules.

     The level argument indicates the importance of the message.  The follow-
     ing levels are defined:

     PAM_LOG_DEBUG       Debugging messages.  These messages are normally not
                         logged unless the global integer variable
                         _openpam_debug is set to a non-zero value, in which
                         case they are logged with a syslog(3) priority of
                         LOG_DEBUG.

     PAM_LOG_VERBOSE     Information about the progress of the authentication
                         process, or other non-essential messages.  These mes-
                         sages are logged with a syslog(3) priority of
                         LOG_INFO.

     PAM_LOG_NOTICE      Messages relating to non-fatal errors.  These mes-
                         sages are logged with a syslog(3) priority of
                         LOG_NOTICE.

     PAM_LOG_ERROR       Messages relating to serious errors.  These messages
                         are logged with a syslog(3) priority of LOG_ERR.

     The remaining arguments are a printf(3) format string and the correspond-
     ing arguments.


SEE ALSO

     pam(3), printf(3), syslog(3)


STANDARDS

     The openpam_log function is an OpenPAM extension.


AUTHORS

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

NetBSD 5.1                     December 21, 2007                    NetBSD 5.1