FreeBSD Man Pages

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.

FreeBSD 5.4		       February 10, 2004		   FreeBSD 5.4

SPONSORED LINKS