xref: /netbsd-src/crypto/external/bsd/heimdal/dist/kuser/kdigest.8 (revision d3273b5b76f5afaafe308cead5511dbb8df8c5e9)
1.\"	$NetBSD: kdigest.8,v 1.2 2017/01/28 21:31:45 christos Exp $
2.\"
3.\" Copyright (c) 2008 Kungliga Tekniska Högskolan
4.\" (Royal Institute of Technology, Stockholm, Sweden).
5.\" All rights reserved.
6.\"
7.\" Redistribution and use in source and binary forms, with or without
8.\" modification, are permitted provided that the following conditions
9.\" are met:
10.\"
11.\" 1. Redistributions of source code must retain the above copyright
12.\"    notice, this list of conditions and the following disclaimer.
13.\"
14.\" 2. Redistributions in binary form must reproduce the above copyright
15.\"    notice, this list of conditions and the following disclaimer in the
16.\"    documentation and/or other materials provided with the distribution.
17.\"
18.\" 3. Neither the name of the Institute nor the names of its contributors
19.\"    may be used to endorse or promote products derived from this software
20.\"    without specific prior written permission.
21.\"
22.\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32.\" SUCH DAMAGE.
33.\"
34.\" Id
35.\"
36.Dd September 25, 2008
37.Dt KDIGEST 8
38.Os
39.Sh NAME
40.Nm kdigest
41.Nd userland tool to access digest interface in the KDC
42.Sh SYNOPSIS
43.Nm
44.Op Fl Fl ccache= Ns Ar string
45.Op Fl Fl version
46.Op Fl Fl help
47command
48.Op arguments
49.Sh DESCRIPTION
50Supported options:
51.Bl -tag -width Ds
52.It Xo
53.Fl Fl ccache= Ns Ar string
54.Xc
55credential cache
56.It Xo
57.Fl Fl version
58.Xc
59print version
60.It Xo
61.Fl Fl help
62.Xc
63.El
64.Pp
65Available commands are:
66.Bl -tag -width Ds
67.It Xo digest-probe
68.Op Fl Fl realm= Ns Ar string
69.Op Fl h | Fl Fl help
70.Xc
71.Bl -tag -width Ds
72.It Xo
73.Fl Fl realm= Ns Ar string
74.Xc
75Kerberos realm to communicate with
76.El
77.It Xo digest-server-init
78.Op Fl Fl type= Ns Ar string
79.Op Fl Fl kerberos-realm= Ns Ar realm
80.Op Fl Fl digest= Ns Ar digest-type
81.Op Fl Fl cb-type= Ns Ar type
82.Op Fl Fl cb-value= Ns Ar value
83.Op Fl Fl hostname= Ns Ar hostname
84.Op Fl Fl realm= Ns Ar string
85.Xc
86.Bl -tag -width Ds
87.It Xo
88.Fl Fl type= Ns Ar string
89.Xc
90digest type
91.It Xo
92.Fl Fl kerberos-realm= Ns Ar realm
93.Xc
94.It Xo
95.Fl Fl digest= Ns Ar digest-type
96.Xc
97digest type to use in the algorithm
98.It Xo
99.Fl Fl cb-type= Ns Ar type
100.Xc
101type of channel bindings
102.It Xo
103.Fl Fl cb-value= Ns Ar value
104.Xc
105value of channel bindings
106.It Xo
107.Fl Fl hostname= Ns Ar hostname
108.Xc
109hostname of the server
110.It Xo
111.Fl Fl realm= Ns Ar string
112.Xc
113Kerberos realm to communicate with
114.El
115.It Xo digest-server-request
116.Op Fl Fl type= Ns Ar string
117.Op Fl Fl kerberos-realm= Ns Ar realm
118.Op Fl Fl username= Ns Ar name
119.Op Fl Fl server-nonce= Ns Ar nonce
120.Op Fl Fl server-identifier= Ns Ar nonce
121.Op Fl Fl client-nonce= Ns Ar nonce
122.Op Fl Fl client-response= Ns Ar response
123.Op Fl Fl opaque= Ns Ar string
124.Op Fl Fl authentication-name= Ns Ar name
125.Op Fl Fl realm= Ns Ar realm
126.Op Fl Fl method= Ns Ar method
127.Op Fl Fl uri= Ns Ar uri
128.Op Fl Fl nounce-count= Ns Ar count
129.Op Fl Fl qop= Ns Ar qop
130.Op Fl Fl ccache= Ns Ar ccache
131.Xc
132.Bl -tag -width Ds
133.It Xo
134.Fl Fl type= Ns Ar string
135.Xc
136digest type
137.It Xo
138.Fl Fl kerberos-realm= Ns Ar realm
139.Xc
140.It Xo
141.Fl Fl username= Ns Ar name
142.Xc
143digest type
144.It Xo
145.Fl Fl server-nonce= Ns Ar nonce
146.Xc
147.It Xo
148.Fl Fl server-identifier= Ns Ar nonce
149.Xc
150.It Xo
151.Fl Fl client-nonce= Ns Ar nonce
152.Xc
153.It Xo
154.Fl Fl client-response= Ns Ar response
155.Xc
156.It Xo
157.Fl Fl opaque= Ns Ar string
158.Xc
159.It Xo
160.Fl Fl authentication-name= Ns Ar name
161.Xc
162.It Xo
163.Fl Fl realm= Ns Ar realm
164.Xc
165.It Xo
166.Fl Fl method= Ns Ar method
167.Xc
168.It Xo
169.Fl Fl uri= Ns Ar uri
170.Xc
171.It Xo
172.Fl Fl nounce-count= Ns Ar count
173.Xc
174.It Xo
175.Fl Fl qop= Ns Ar qop
176.Xc
177.It Xo
178.Fl Fl ccache= Ns Ar ccache
179.Xc
180Where the the credential cache is created when the KDC returns tickets
181.El
182.It Xo digest-client-request
183.Op Fl Fl type= Ns Ar string
184.Op Fl Fl username= Ns Ar name
185.Op Fl Fl password= Ns Ar password
186.Op Fl Fl server-nonce= Ns Ar nonce
187.Op Fl Fl server-identifier= Ns Ar nonce
188.Op Fl Fl client-nonce= Ns Ar nonce
189.Op Fl Fl opaque= Ns Ar string
190.Op Fl Fl realm= Ns Ar realm
191.Op Fl Fl method= Ns Ar method
192.Op Fl Fl uri= Ns Ar uri
193.Op Fl Fl nounce-count= Ns Ar count
194.Op Fl Fl qop= Ns Ar qop
195.Xc
196.Bl -tag -width Ds
197.It Xo
198.Fl Fl type= Ns Ar string
199.Xc
200digest type
201.It Xo
202.Fl Fl username= Ns Ar name
203.Xc
204digest type
205.It Xo
206.Fl Fl password= Ns Ar password
207.Xc
208.It Xo
209.Fl Fl server-nonce= Ns Ar nonce
210.Xc
211.It Xo
212.Fl Fl server-identifier= Ns Ar nonce
213.Xc
214.It Xo
215.Fl Fl client-nonce= Ns Ar nonce
216.Xc
217.It Xo
218.Fl Fl opaque= Ns Ar string
219.Xc
220.It Xo
221.Fl Fl realm= Ns Ar realm
222.Xc
223.It Xo
224.Fl Fl method= Ns Ar method
225.Xc
226.It Xo
227.Fl Fl uri= Ns Ar uri
228.Xc
229.It Xo
230.Fl Fl nounce-count= Ns Ar count
231.Xc
232.It Xo
233.Fl Fl qop= Ns Ar qop
234.Xc
235.El
236.It Xo ntlm-server-init
237.Op Fl Fl version= Ns Ar integer
238.Op Fl Fl kerberos-realm= Ns Ar string
239.Xc
240.Bl -tag -width Ds
241.It Xo
242.Fl Fl version= Ns Ar integer
243.Xc
244ntlm version
245.It Xo
246.Fl Fl kerberos-realm= Ns Ar string
247.Xc
248Kerberos realm to communicate with
249.El
250.El
251.\".Sh ENVIRONMENT
252.\".Sh FILES
253.\".Sh EXAMPLES
254.\".Sh DIAGNOSTICS
255.\".Sh SEE ALSO
256.\".Sh STANDARDS
257.\".Sh HISTORY
258.\".Sh AUTHORS
259.\".Sh BUGS
260