Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
OPENPAM_LOG(3)		    Library Functions Manual		OPENPAM_LOG(3)

NAME
       openpam_log -- log a message through syslog

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 pri-
       marily intended for internal use	by the library and modules.

       The level argument indicates the	importance of the message.   The  fol-
       lowing levels are defined:

       PAM_LOG_LIBDEBUG	   Debugging messages.	For internal use only.

       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 authentica-
			   tion	 process,  or  other  non-essential  messages.
			   These messages 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 mes-
			   sages are  logged  with  a  syslog(3)  priority  of
			   LOG_ERR.

       The  remaining  arguments  are a	printf(3) format string	and the	corre-
       sponding	arguments.

       The openpam_log() function does not modify the value of errno.

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.

       The OpenPAM library is maintained by Dag-Erling Smorgrav	<des@des.dev>.

FreeBSD	15.0			 May 31, 2025			OPENPAM_LOG(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=openpam_log&manpath=FreeBSD+15.0-RELEASE+and+Ports.quarterly>

home | help