xref: /freebsd/crypto/heimdal/lib/gssapi/mech/mech.5 (revision ae77177087c655fc883075af4f425b37e032cd05)
1*ae771770SStanislav Sedov.\" Copyright (c) 2005 Doug Rabson
2*ae771770SStanislav Sedov.\" All rights reserved.
3*ae771770SStanislav Sedov.\"
4*ae771770SStanislav Sedov.\" Redistribution and use in source and binary forms, with or without
5*ae771770SStanislav Sedov.\" modification, are permitted provided that the following conditions
6*ae771770SStanislav Sedov.\" are met:
7*ae771770SStanislav Sedov.\" 1. Redistributions of source code must retain the above copyright
8*ae771770SStanislav Sedov.\"    notice, this list of conditions and the following disclaimer.
9*ae771770SStanislav Sedov.\" 2. Redistributions in binary form must reproduce the above copyright
10*ae771770SStanislav Sedov.\"    notice, this list of conditions and the following disclaimer in the
11*ae771770SStanislav Sedov.\"    documentation and/or other materials provided with the distribution.
12*ae771770SStanislav Sedov.\"
13*ae771770SStanislav Sedov.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14*ae771770SStanislav Sedov.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15*ae771770SStanislav Sedov.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16*ae771770SStanislav Sedov.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17*ae771770SStanislav Sedov.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18*ae771770SStanislav Sedov.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19*ae771770SStanislav Sedov.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20*ae771770SStanislav Sedov.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21*ae771770SStanislav Sedov.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22*ae771770SStanislav Sedov.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23*ae771770SStanislav Sedov.\" SUCH DAMAGE.
24*ae771770SStanislav Sedov.\"
25*ae771770SStanislav Sedov.\" $FreeBSD: src/lib/libgssapi/mech.5,v 1.1 2005/12/29 14:40:20 dfr Exp $
26*ae771770SStanislav Sedov.Dd November 14, 2005
27*ae771770SStanislav Sedov.Dt MECH 5
28*ae771770SStanislav Sedov.Os
29*ae771770SStanislav Sedov.Sh NAME
30*ae771770SStanislav Sedov.Nm mech ,
31*ae771770SStanislav Sedov.Nm qop
32*ae771770SStanislav Sedov.Nd "GSS-API Mechanism and QOP files"
33*ae771770SStanislav Sedov.Sh SYNOPSIS
34*ae771770SStanislav Sedov.Pa "/etc/gss/mech"
35*ae771770SStanislav Sedov.Pa "/etc/gss/qop"
36*ae771770SStanislav Sedov.Sh DESCRIPTION
37*ae771770SStanislav SedovThe
38*ae771770SStanislav Sedov.Pa "/etc/gss/mech"
39*ae771770SStanislav Sedovfile contains a list of installed GSS-API security mechanisms.
40*ae771770SStanislav SedovEach line of the file either contains a comment if the first character
41*ae771770SStanislav Sedovis '#' or it contains five fields with the following meanings:
42*ae771770SStanislav Sedov.Bl -tag
43*ae771770SStanislav Sedov.It Name
44*ae771770SStanislav SedovThe name of this GSS-API mechanism.
45*ae771770SStanislav Sedov.It Object identifier
46*ae771770SStanislav SedovThe OID for this mechanism.
47*ae771770SStanislav Sedov.It Library
48*ae771770SStanislav SedovA shared library containing the implementation of this mechanism.
49*ae771770SStanislav Sedov.It Kernel module (optional)
50*ae771770SStanislav SedovA kernel module containing the implementation of this mechanism (not
51*ae771770SStanislav Sedovyet supported in FreeBSD).
52*ae771770SStanislav Sedov.It Library options (optional)
53*ae771770SStanislav SedovOptionsal parameters interpreted by the mechanism. Library options
54*ae771770SStanislav Sedovmust be enclosed in brackets ([ ]) to differentiate them from the
55*ae771770SStanislav Sedovoptional kernel module entry.
56*ae771770SStanislav Sedov.El
57*ae771770SStanislav Sedov.Pp
58*ae771770SStanislav SedovThe
59*ae771770SStanislav Sedov.Pa "/etc/gss/qop"
60*ae771770SStanislav Sedovfile contains a list of Quality of Protection values for use with
61*ae771770SStanislav SedovGSS-API.
62*ae771770SStanislav SedovEach line of the file either contains a comment if the first character
63*ae771770SStanislav Sedovis '#' or it contains three fields with the following meanings:
64*ae771770SStanislav Sedov.Bl -tag
65*ae771770SStanislav Sedov.It QOP string
66*ae771770SStanislav SedovThe name of this Quality of Protection algorithm.
67*ae771770SStanislav Sedov.It QOP value
68*ae771770SStanislav SedovThe numeric value used to select this algorithm for use with GSS-API
69*ae771770SStanislav Sedovfunctions such as
70*ae771770SStanislav Sedov.Xr gss_get_mic 3 .
71*ae771770SStanislav Sedov.It Mechanism name
72*ae771770SStanislav SedovThe GSS-API mechanism name that corresponds to this algorithm.
73*ae771770SStanislav Sedov.El
74*ae771770SStanislav Sedov.Sh EXAMPLES
75*ae771770SStanislav SedovThis is a typical entry from
76*ae771770SStanislav Sedov.Pa "/etc/gss/mech" :
77*ae771770SStanislav Sedov.Bd -literal
78*ae771770SStanislav Sedovkerberosv5	1.2.840.113554.1.2.2	/usr/lib/libgssapi_krb5.so.8	-
79*ae771770SStanislav Sedov.Ed
80*ae771770SStanislav Sedov.Pp
81*ae771770SStanislav SedovThis is a typical entry from
82*ae771770SStanislav Sedov.Pa "/etc/gss/qop" :
83*ae771770SStanislav Sedov.Bd -literal
84*ae771770SStanislav SedovGSS_KRB5_CONF_C_QOP_DES		0x0100	kerberosv5
85*ae771770SStanislav Sedov.Ed
86*ae771770SStanislav Sedov.Sh HISTORY
87*ae771770SStanislav SedovThe
88*ae771770SStanislav Sedov.Nm
89*ae771770SStanislav Sedovmanual page example first appeared in
90*ae771770SStanislav Sedov.Fx 7.0 .
91*ae771770SStanislav Sedov.Sh AUTHORS
92*ae771770SStanislav SedovThis
93*ae771770SStanislav Sedovmanual page was written by
94*ae771770SStanislav Sedov.An Doug Rabson Aq dfr@FreeBSD.org .
95