OPENPAM_LOG(3)           BSD 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 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.

BSD                            December 21, 2007                           BSD