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