xref: /dflybsd-src/contrib/openpam/doc/man/openpam_log.3 (revision 4c84ab30f7dd59ef873b5a6d4e27bcea89d9f848)
110b5fe87SSascha Wildner.\" Generated from openpam_log.c by gendoc.pl
210b5fe87SSascha Wildner.\" $OpenPAM: openpam_log.c 938 2017-04-30 21:34:42Z des $
3*4c84ab30SSascha Wildner.Dd February 24, 2019
4ade90846SJoerg Sonnenberger.Dt OPENPAM_LOG 3
5ade90846SJoerg Sonnenberger.Os
6ade90846SJoerg Sonnenberger.Sh NAME
7ade90846SJoerg Sonnenberger.Nm openpam_log
8ade90846SJoerg Sonnenberger.Nd log a message through syslog
9ade90846SJoerg Sonnenberger.Sh SYNOPSIS
10ade90846SJoerg Sonnenberger.In sys/types.h
11ade90846SJoerg Sonnenberger.In security/pam_appl.h
12ade90846SJoerg Sonnenberger.In security/openpam.h
13ade90846SJoerg Sonnenberger.Ft "void"
14ade90846SJoerg Sonnenberger.Fn openpam_log "int level" "const char *fmt" "..."
15ade90846SJoerg Sonnenberger.Sh DESCRIPTION
16ade90846SJoerg SonnenbergerThe
17577efdeeSPeter Avalos.Fn openpam_log
18ade90846SJoerg Sonnenbergerfunction logs messages using
19ade90846SJoerg Sonnenberger.Xr syslog 3 .
20ade90846SJoerg SonnenbergerIt is primarily intended for internal use by the library and modules.
21ade90846SJoerg Sonnenberger.Pp
22ade90846SJoerg SonnenbergerThe
23ade90846SJoerg Sonnenberger.Fa level
24ade90846SJoerg Sonnenbergerargument indicates the importance of the message.
25ade90846SJoerg SonnenbergerThe following levels are defined:
26ade90846SJoerg Sonnenberger.Bl -tag -width 18n
27577efdeeSPeter Avalos.It Dv PAM_LOG_LIBDEBUG
28577efdeeSPeter AvalosDebugging messages.
29577efdeeSPeter AvalosFor internal use only.
30ade90846SJoerg Sonnenberger.It Dv PAM_LOG_DEBUG
31ade90846SJoerg SonnenbergerDebugging messages.
32ade90846SJoerg SonnenbergerThese messages are normally not logged unless the global
33ade90846SJoerg Sonnenbergerinteger variable
34a474e9feSPeter Avalos.Va openpam_debug
35ade90846SJoerg Sonnenbergeris set to a non-zero
36ade90846SJoerg Sonnenbergervalue, in which case they are logged with a
37ade90846SJoerg Sonnenberger.Xr syslog 3
38ade90846SJoerg Sonnenbergerpriority of
39ade90846SJoerg Sonnenberger.Dv LOG_DEBUG .
40ade90846SJoerg Sonnenberger.It Dv PAM_LOG_VERBOSE
41ade90846SJoerg SonnenbergerInformation about the progress of the authentication
42ade90846SJoerg Sonnenbergerprocess, or other non-essential messages.
43ade90846SJoerg SonnenbergerThese messages are logged with a
44ade90846SJoerg Sonnenberger.Xr syslog 3
45ade90846SJoerg Sonnenbergerpriority of
46ade90846SJoerg Sonnenberger.Dv LOG_INFO .
47ade90846SJoerg Sonnenberger.It Dv PAM_LOG_NOTICE
48ade90846SJoerg SonnenbergerMessages relating to non-fatal errors.
49ade90846SJoerg SonnenbergerThese messages are logged with a
50ade90846SJoerg Sonnenberger.Xr syslog 3
51ade90846SJoerg Sonnenbergerpriority of
52ade90846SJoerg Sonnenberger.Dv LOG_NOTICE .
53ade90846SJoerg Sonnenberger.It Dv PAM_LOG_ERROR
54ade90846SJoerg SonnenbergerMessages relating to serious errors.
55ade90846SJoerg SonnenbergerThese messages are logged with a
56ade90846SJoerg Sonnenberger.Xr syslog 3
57ade90846SJoerg Sonnenbergerpriority of
58ade90846SJoerg Sonnenberger.Dv LOG_ERR .
59ade90846SJoerg Sonnenberger.El
60ade90846SJoerg Sonnenberger.Pp
61ade90846SJoerg SonnenbergerThe remaining arguments are a
62ade90846SJoerg Sonnenberger.Xr printf 3
63ade90846SJoerg Sonnenbergerformat string and the
64ade90846SJoerg Sonnenbergercorresponding arguments.
6510b5fe87SSascha Wildner.Pp
6610b5fe87SSascha WildnerThe
6710b5fe87SSascha Wildner.Fn openpam_log
6810b5fe87SSascha Wildnerfunction does not modify the value of
6910b5fe87SSascha Wildner.Va errno .
70ade90846SJoerg Sonnenberger.Sh SEE ALSO
71ade90846SJoerg Sonnenberger.Xr pam 3 ,
72ade90846SJoerg Sonnenberger.Xr printf 3 ,
73ade90846SJoerg Sonnenberger.Xr syslog 3
74ade90846SJoerg Sonnenberger.Sh STANDARDS
75ade90846SJoerg SonnenbergerThe
76577efdeeSPeter Avalos.Fn openpam_log
77ade90846SJoerg Sonnenbergerfunction is an OpenPAM extension.
78ade90846SJoerg Sonnenberger.Sh AUTHORS
79ade90846SJoerg SonnenbergerThe
80577efdeeSPeter Avalos.Fn openpam_log
81577efdeeSPeter Avalosfunction and this manual page were
82577efdeeSPeter Avalosdeveloped for the
83ade90846SJoerg Sonnenberger.Fx
84577efdeeSPeter AvalosProject by ThinkSec AS and Network Associates Laboratories, the
85f23594ceSHasso TepperSecurity Research Division of Network Associates, Inc.\& under
86ade90846SJoerg SonnenbergerDARPA/SPAWAR contract N66001-01-C-8035
87ade90846SJoerg Sonnenberger.Pq Dq CBOSS ,
88ade90846SJoerg Sonnenbergeras part of the DARPA CHATS research program.
8910b5fe87SSascha Wildner.Pp
9010b5fe87SSascha WildnerThe OpenPAM library is maintained by
9110b5fe87SSascha Wildner.An Dag-Erling Sm\(/orgrav Aq Mt des@des.no .
92