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