xref: /minix3/crypto/external/bsd/heimdal/dist/lib/krb5/krb5_find_padata.3 (revision ebfedea0ce5bbe81e252ddf32d732e40fb633fae)
1*ebfedea0SLionel Sambuc.\"	$NetBSD: krb5_find_padata.3,v 1.1.1.2 2011/04/14 14:09:23 elric Exp $
2*ebfedea0SLionel Sambuc.\"
3*ebfedea0SLionel Sambuc.\" Copyright (c) 2004 Kungliga Tekniska Högskolan
4*ebfedea0SLionel Sambuc.\" (Royal Institute of Technology, Stockholm, Sweden).
5*ebfedea0SLionel Sambuc.\" All rights reserved.
6*ebfedea0SLionel Sambuc.\"
7*ebfedea0SLionel Sambuc.\" Redistribution and use in source and binary forms, with or without
8*ebfedea0SLionel Sambuc.\" modification, are permitted provided that the following conditions
9*ebfedea0SLionel Sambuc.\" are met:
10*ebfedea0SLionel Sambuc.\"
11*ebfedea0SLionel Sambuc.\" 1. Redistributions of source code must retain the above copyright
12*ebfedea0SLionel Sambuc.\"    notice, this list of conditions and the following disclaimer.
13*ebfedea0SLionel Sambuc.\"
14*ebfedea0SLionel Sambuc.\" 2. Redistributions in binary form must reproduce the above copyright
15*ebfedea0SLionel Sambuc.\"    notice, this list of conditions and the following disclaimer in the
16*ebfedea0SLionel Sambuc.\"    documentation and/or other materials provided with the distribution.
17*ebfedea0SLionel Sambuc.\"
18*ebfedea0SLionel Sambuc.\" 3. Neither the name of the Institute nor the names of its contributors
19*ebfedea0SLionel Sambuc.\"    may be used to endorse or promote products derived from this software
20*ebfedea0SLionel Sambuc.\"    without specific prior written permission.
21*ebfedea0SLionel Sambuc.\"
22*ebfedea0SLionel Sambuc.\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
23*ebfedea0SLionel Sambuc.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24*ebfedea0SLionel Sambuc.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25*ebfedea0SLionel Sambuc.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
26*ebfedea0SLionel Sambuc.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27*ebfedea0SLionel Sambuc.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28*ebfedea0SLionel Sambuc.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29*ebfedea0SLionel Sambuc.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30*ebfedea0SLionel Sambuc.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31*ebfedea0SLionel Sambuc.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32*ebfedea0SLionel Sambuc.\" SUCH DAMAGE.
33*ebfedea0SLionel Sambuc.\"
34*ebfedea0SLionel Sambuc.\" Id
35*ebfedea0SLionel Sambuc.\"
36*ebfedea0SLionel Sambuc.Dd March 21, 2004
37*ebfedea0SLionel Sambuc.Dt KRB5_FIND_PADATA 3
38*ebfedea0SLionel Sambuc.Os
39*ebfedea0SLionel Sambuc.Sh NAME
40*ebfedea0SLionel Sambuc.Nm krb5_find_padata ,
41*ebfedea0SLionel Sambuc.Nm krb5_padata_add
42*ebfedea0SLionel Sambuc.Nd Kerberos 5 pre-authentication data handling functions
43*ebfedea0SLionel Sambuc.Sh LIBRARY
44*ebfedea0SLionel SambucKerberos 5 Library (libkrb5, -lkrb5)
45*ebfedea0SLionel Sambuc.Sh SYNOPSIS
46*ebfedea0SLionel Sambuc.In krb5/krb5.h
47*ebfedea0SLionel Sambuc.Pp
48*ebfedea0SLionel Sambuc.Ft "PA_DATA *"
49*ebfedea0SLionel Sambuc.Fo krb5_find_padata
50*ebfedea0SLionel Sambuc.Fa "PA_DATA *val"
51*ebfedea0SLionel Sambuc.Fa "unsigned len"
52*ebfedea0SLionel Sambuc.Fa "int type"
53*ebfedea0SLionel Sambuc.Fa "int *index"
54*ebfedea0SLionel Sambuc.Fc
55*ebfedea0SLionel Sambuc.Ft int
56*ebfedea0SLionel Sambuc.Fo krb5_padata_add
57*ebfedea0SLionel Sambuc.Fa "krb5_context context"
58*ebfedea0SLionel Sambuc.Fa "METHOD_DATA *md"
59*ebfedea0SLionel Sambuc.Fa "int type"
60*ebfedea0SLionel Sambuc.Fa "void *buf"
61*ebfedea0SLionel Sambuc.Fa "size_t len"
62*ebfedea0SLionel Sambuc.Fc
63*ebfedea0SLionel Sambuc.Sh DESCRIPTION
64*ebfedea0SLionel Sambuc.Fn krb5_find_padata
65*ebfedea0SLionel Sambuctries to find the pre-authentication data entry of type
66*ebfedea0SLionel Sambuc.Fa type
67*ebfedea0SLionel Sambucin the array
68*ebfedea0SLionel Sambuc.Fa val
69*ebfedea0SLionel Sambucof length
70*ebfedea0SLionel Sambuc.Fa len .
71*ebfedea0SLionel SambucThe search is started at entry pointed out by
72*ebfedea0SLionel Sambuc.Fa *index
73*ebfedea0SLionel Sambuc(zero based indexing).
74*ebfedea0SLionel SambucIf the type isn't found,
75*ebfedea0SLionel Sambuc.Dv NULL
76*ebfedea0SLionel Sambucis returned.
77*ebfedea0SLionel Sambuc.Pp
78*ebfedea0SLionel Sambuc.Fn krb5_padata_add
79*ebfedea0SLionel Sambucadds a pre-authentication data entry of type
80*ebfedea0SLionel Sambuc.Fa type
81*ebfedea0SLionel Sambucpointed out by
82*ebfedea0SLionel Sambuc.Fa buf
83*ebfedea0SLionel Sambucand
84*ebfedea0SLionel Sambuc.Fa len
85*ebfedea0SLionel Sambucto
86*ebfedea0SLionel Sambuc.Fa md .
87*ebfedea0SLionel Sambuc.Sh SEE ALSO
88*ebfedea0SLionel Sambuc.Xr krb5 3 ,
89*ebfedea0SLionel Sambuc.Xr kerberos 8
90