1.\" Generated from openpam_log.c by gendoc.pl
2.\" $OpenPAM: openpam_log.c 938 2017-04-30 21:34:42Z des $
3.Dd February 24, 2019
4.Dt OPENPAM_LOG 3
5.Os
6.Sh NAME
7.Nm openpam_log
8.Nd log a message through syslog
9.Sh SYNOPSIS
10.In sys/types.h
11.In security/pam_appl.h
12.In security/openpam.h
13.Ft "void"
14.Fn openpam_log "int level" "const char *fmt" "..."
15.Sh DESCRIPTION
16The
17.Fn openpam_log
18function logs messages using
19.Xr syslog 3 .
20It is primarily intended for internal use by the library and modules.
21.Pp
22The
23.Fa level
24argument indicates the importance of the message.
25The following levels are defined:
26.Bl -tag -width 18n
27.It Dv PAM_LOG_LIBDEBUG
28Debugging messages.
29For internal use only.
30.It Dv PAM_LOG_DEBUG
31Debugging messages.
32These messages are normally not logged unless the global
33integer variable
34.Va openpam_debug
35is set to a non-zero
36value, in which case they are logged with a
37.Xr syslog 3
38priority of
39.Dv LOG_DEBUG .
40.It Dv PAM_LOG_VERBOSE
41Information about the progress of the authentication
42process, or other non-essential messages.
43These messages are logged with a
44.Xr syslog 3
45priority of
46.Dv LOG_INFO .
47.It Dv PAM_LOG_NOTICE
48Messages relating to non-fatal errors.
49These messages are logged with a
50.Xr syslog 3
51priority of
52.Dv LOG_NOTICE .
53.It Dv PAM_LOG_ERROR
54Messages relating to serious errors.
55These messages are logged with a
56.Xr syslog 3
57priority of
58.Dv LOG_ERR .
59.El
60.Pp
61The remaining arguments are a
62.Xr printf 3
63format string and the
64corresponding arguments.
65.Pp
66The
67.Fn openpam_log
68function does not modify the value of
69.Va errno .
70.Sh SEE ALSO
71.Xr pam 3 ,
72.Xr printf 3 ,
73.Xr syslog 3
74.Sh STANDARDS
75The
76.Fn openpam_log
77function is an OpenPAM extension.
78.Sh AUTHORS
79The
80.Fn openpam_log
81function and this manual page were
82developed for the
83.Fx
84Project by ThinkSec AS and Network Associates Laboratories, the
85Security Research Division of Network Associates, Inc.\& under
86DARPA/SPAWAR contract N66001-01-C-8035
87.Pq Dq CBOSS ,
88as part of the DARPA CHATS research program.
89.Pp
90The OpenPAM library is maintained by
91.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
92