xref: /dflybsd-src/contrib/openpam/doc/man/pam_error.3 (revision ade90846ffbb7aead93829eaba21d490f1a7bc6c)
1*ade90846SJoerg Sonnenberger.\"-
2*ade90846SJoerg Sonnenberger.\" Copyright (c) 2001-2003 Networks Associates Technology, Inc.
3*ade90846SJoerg Sonnenberger.\" All rights reserved.
4*ade90846SJoerg Sonnenberger.\"
5*ade90846SJoerg Sonnenberger.\" This software was developed for the FreeBSD Project by ThinkSec AS and
6*ade90846SJoerg Sonnenberger.\" Network Associates Laboratories, the Security Research Division of
7*ade90846SJoerg Sonnenberger.\" Network Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035
8*ade90846SJoerg Sonnenberger.\" ("CBOSS"), as part of the DARPA CHATS research program.
9*ade90846SJoerg Sonnenberger.\"
10*ade90846SJoerg Sonnenberger.\" Redistribution and use in source and binary forms, with or without
11*ade90846SJoerg Sonnenberger.\" modification, are permitted provided that the following conditions
12*ade90846SJoerg Sonnenberger.\" are met:
13*ade90846SJoerg Sonnenberger.\" 1. Redistributions of source code must retain the above copyright
14*ade90846SJoerg Sonnenberger.\"    notice, this list of conditions and the following disclaimer.
15*ade90846SJoerg Sonnenberger.\" 2. Redistributions in binary form must reproduce the above copyright
16*ade90846SJoerg Sonnenberger.\"    notice, this list of conditions and the following disclaimer in the
17*ade90846SJoerg Sonnenberger.\"    documentation and/or other materials provided with the distribution.
18*ade90846SJoerg Sonnenberger.\" 3. The name of the author may not be used to endorse or promote
19*ade90846SJoerg Sonnenberger.\"    products derived from this software without specific prior written
20*ade90846SJoerg Sonnenberger.\"    permission.
21*ade90846SJoerg Sonnenberger.\"
22*ade90846SJoerg Sonnenberger.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
23*ade90846SJoerg Sonnenberger.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24*ade90846SJoerg Sonnenberger.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25*ade90846SJoerg Sonnenberger.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
26*ade90846SJoerg Sonnenberger.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27*ade90846SJoerg Sonnenberger.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28*ade90846SJoerg Sonnenberger.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29*ade90846SJoerg Sonnenberger.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30*ade90846SJoerg Sonnenberger.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31*ade90846SJoerg Sonnenberger.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32*ade90846SJoerg Sonnenberger.\" SUCH DAMAGE.
33*ade90846SJoerg Sonnenberger.\"
34*ade90846SJoerg Sonnenberger.\" $P4$
35*ade90846SJoerg Sonnenberger.\"
36*ade90846SJoerg Sonnenberger.Dd June 16, 2005
37*ade90846SJoerg Sonnenberger.Dt PAM_ERROR 3
38*ade90846SJoerg Sonnenberger.Os
39*ade90846SJoerg Sonnenberger.Sh NAME
40*ade90846SJoerg Sonnenberger.Nm pam_error
41*ade90846SJoerg Sonnenberger.Nd display an error message
42*ade90846SJoerg Sonnenberger.Sh LIBRARY
43*ade90846SJoerg Sonnenberger.Lb libpam
44*ade90846SJoerg Sonnenberger.Sh SYNOPSIS
45*ade90846SJoerg Sonnenberger.In sys/types.h
46*ade90846SJoerg Sonnenberger.In security/pam_appl.h
47*ade90846SJoerg Sonnenberger.Ft "int"
48*ade90846SJoerg Sonnenberger.Fn pam_error "pam_handle_t *pamh" "const char *fmt" "..."
49*ade90846SJoerg Sonnenberger.Sh DESCRIPTION
50*ade90846SJoerg SonnenbergerThe
51*ade90846SJoerg Sonnenberger.Nm
52*ade90846SJoerg Sonnenbergerfunction displays an error message through the
53*ade90846SJoerg Sonnenbergerintermediary of the given PAM context's conversation function.
54*ade90846SJoerg Sonnenberger.Pp
55*ade90846SJoerg Sonnenberger.Sh RETURN VALUES
56*ade90846SJoerg SonnenbergerThe
57*ade90846SJoerg Sonnenberger.Nm
58*ade90846SJoerg Sonnenbergerfunction returns one of the following values:
59*ade90846SJoerg Sonnenberger.Bl -tag -width 18n
60*ade90846SJoerg Sonnenberger.It Bq Er PAM_BUF_ERR
61*ade90846SJoerg SonnenbergerMemory buffer error.
62*ade90846SJoerg Sonnenberger.It Bq Er PAM_CONV_ERR
63*ade90846SJoerg SonnenbergerConversation failure.
64*ade90846SJoerg Sonnenberger.It Bq Er PAM_SYSTEM_ERR
65*ade90846SJoerg SonnenbergerSystem error.
66*ade90846SJoerg Sonnenberger.El
67*ade90846SJoerg Sonnenberger.Sh SEE ALSO
68*ade90846SJoerg Sonnenberger.Xr pam 3 ,
69*ade90846SJoerg Sonnenberger.Xr pam_info 3 ,
70*ade90846SJoerg Sonnenberger.Xr pam_prompt 3 ,
71*ade90846SJoerg Sonnenberger.Xr pam_strerror 3 ,
72*ade90846SJoerg Sonnenberger.Xr pam_verror 3
73*ade90846SJoerg Sonnenberger.Sh STANDARDS
74*ade90846SJoerg SonnenbergerThe
75*ade90846SJoerg Sonnenberger.Nm
76*ade90846SJoerg Sonnenbergerfunction is an OpenPAM extension.
77*ade90846SJoerg Sonnenberger.Sh AUTHORS
78*ade90846SJoerg SonnenbergerThe
79*ade90846SJoerg Sonnenberger.Nm
80*ade90846SJoerg Sonnenbergerfunction and this manual page were developed for the
81*ade90846SJoerg Sonnenberger.Fx
82*ade90846SJoerg SonnenbergerProject by ThinkSec AS and Network Associates Laboratories, the
83*ade90846SJoerg SonnenbergerSecurity Research Division of Network Associates, Inc.& under
84*ade90846SJoerg SonnenbergerDARPA/SPAWAR contract N66001-01-C-8035
85*ade90846SJoerg Sonnenberger.Pq Dq CBOSS ,
86*ade90846SJoerg Sonnenbergeras part of the DARPA CHATS research program.
87