1*0d9d0fd8Schristos.\" $NetBSD: openpam_log.3,v 1.9 2023/06/30 21:46:20 christos Exp $ 244269bb5Schristos.\" 38fa0fefeSchristos.\" Generated from openpam_log.c by gendoc.pl 4*0d9d0fd8Schristos.Dd June 27, 2023 544269bb5Schristos.Dt OPENPAM_LOG 3 644269bb5Schristos.Os 744269bb5Schristos.Sh NAME 844269bb5Schristos.Nm openpam_log 944269bb5Schristos.Nd log a message through syslog 1044269bb5Schristos.Sh SYNOPSIS 1144269bb5Schristos.In sys/types.h 1244269bb5Schristos.In security/pam_appl.h 1344269bb5Schristos.In security/openpam.h 1444269bb5Schristos.Ft "void" 1544269bb5Schristos.Fn openpam_log "int level" "const char *fmt" "..." 1644269bb5Schristos.Sh DESCRIPTION 1744269bb5SchristosThe 18e1b25b17Schristos.Fn openpam_log 1944269bb5Schristosfunction logs messages using 2044269bb5Schristos.Xr syslog 3 . 2144269bb5SchristosIt is primarily intended for internal use by the library and modules. 2244269bb5Schristos.Pp 2344269bb5SchristosThe 2444269bb5Schristos.Fa level 2544269bb5Schristosargument indicates the importance of the message. 2644269bb5SchristosThe following levels are defined: 2744269bb5Schristos.Bl -tag -width 18n 28e1b25b17Schristos.It Dv PAM_LOG_LIBDEBUG 29e1b25b17SchristosDebugging messages. 30e1b25b17SchristosFor internal use only. 3144269bb5Schristos.It Dv PAM_LOG_DEBUG 3244269bb5SchristosDebugging messages. 3344269bb5SchristosThese messages are normally not logged unless the global 3444269bb5Schristosinteger variable 3544269bb5Schristos.Va openpam_debug 3644269bb5Schristosis set to a non-zero 3744269bb5Schristosvalue, in which case they are logged with a 3844269bb5Schristos.Xr syslog 3 3944269bb5Schristospriority of 4044269bb5Schristos.Dv LOG_DEBUG . 4144269bb5Schristos.It Dv PAM_LOG_VERBOSE 4244269bb5SchristosInformation about the progress of the authentication 4344269bb5Schristosprocess, or other non-essential messages. 4444269bb5SchristosThese messages are logged with a 4544269bb5Schristos.Xr syslog 3 4644269bb5Schristospriority of 4744269bb5Schristos.Dv LOG_INFO . 4844269bb5Schristos.It Dv PAM_LOG_NOTICE 4944269bb5SchristosMessages relating to non-fatal errors. 5044269bb5SchristosThese messages are logged with a 5144269bb5Schristos.Xr syslog 3 5244269bb5Schristospriority of 5344269bb5Schristos.Dv LOG_NOTICE . 5444269bb5Schristos.It Dv PAM_LOG_ERROR 5544269bb5SchristosMessages relating to serious errors. 5644269bb5SchristosThese messages are logged with a 5744269bb5Schristos.Xr syslog 3 5844269bb5Schristospriority of 5944269bb5Schristos.Dv LOG_ERR . 6044269bb5Schristos.El 6144269bb5Schristos.Pp 6244269bb5SchristosThe remaining arguments are a 6344269bb5Schristos.Xr printf 3 6444269bb5Schristosformat string and the 6544269bb5Schristoscorresponding arguments. 668fa0fefeSchristos.Pp 678fa0fefeSchristosThe 688fa0fefeSchristos.Fn openpam_log 698fa0fefeSchristosfunction does not modify the value of 708fa0fefeSchristos.Va errno . 7144269bb5Schristos.Sh SEE ALSO 7244269bb5Schristos.Xr pam 3 , 7344269bb5Schristos.Xr printf 3 , 7444269bb5Schristos.Xr syslog 3 7544269bb5Schristos.Sh STANDARDS 7644269bb5SchristosThe 77e1b25b17Schristos.Fn openpam_log 7844269bb5Schristosfunction is an OpenPAM extension. 7944269bb5Schristos.Sh AUTHORS 8044269bb5SchristosThe 81e1b25b17Schristos.Fn openpam_log 82e1b25b17Schristosfunction and this manual page were 83e1b25b17Schristosdeveloped for the 8444269bb5Schristos.Fx 85e1b25b17SchristosProject by ThinkSec AS and Network Associates Laboratories, the 8644269bb5SchristosSecurity Research Division of Network Associates, Inc.\& under 8744269bb5SchristosDARPA/SPAWAR contract N66001-01-C-8035 8844269bb5Schristos.Pq Dq CBOSS , 8944269bb5Schristosas part of the DARPA CHATS research program. 908fa0fefeSchristos.Pp 918fa0fefeSchristosThe OpenPAM library is maintained by 924cb4af11Schristos.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no . 93