xref: /netbsd-src/crypto/external/bsd/heimdal/dist/kuser/kdigest.8 (revision 49d8c9ecf4abd21261269266ef64939f71b3cd09)
1.\"	$NetBSD: kdigest.8,v 1.1.1.2 2011/04/14 14:08:18 elric 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
42userland tool to access digest interface in the KDC
43.Sh SYNOPSIS
44.Nm
45.Op Fl -ccache= Ns Ar string
46.Op Fl -version
47.Op Fl -help
48command
49.Op arguments
50.Sh DESCRIPTION
51Supported options:
52.Bl -tag -width Ds
53.It Xo
54.Fl -ccache= Ns Ar string
55.Xc
56credential cache
57.It Xo
58.Fl -version
59.Xc
60print version
61.It Xo
62.Fl -help
63.Xc
64.El
65.Pp
66Available commands are:
67.Bl -tag -width Ds
68.It Xo digest-probe
69.Op Fl -realm= Ns Ar string
70.Op Fl h | Fl -help
71.Xc
72.Bl -tag -width Ds
73.It Xo
74.Fl -realm= Ns Ar string
75.Xc
76Kerberos realm to communicate with
77.El
78.It Xo digest-server-init
79.Op Fl -type= Ns Ar string
80.Op Fl -kerberos-realm= Ns Ar realm
81.Op Fl -digest= Ns Ar digest-type
82.Op Fl -cb-type= Ns Ar type
83.Op Fl -cb-value= Ns Ar value
84.Op Fl -hostname= Ns Ar hostname
85.Op Fl -realm= Ns Ar string
86.Xc
87.Bl -tag -width Ds
88.It Xo
89.Fl -type= Ns Ar string
90.Xc
91digest type
92.It Xo
93.Fl -kerberos-realm= Ns Ar realm
94.Xc
95.It Xo
96.Fl -digest= Ns Ar digest-type
97.Xc
98digest type to use in the algorithm
99.It Xo
100.Fl -cb-type= Ns Ar type
101.Xc
102type of channel bindings
103.It Xo
104.Fl -cb-value= Ns Ar value
105.Xc
106value of channel bindings
107.It Xo
108.Fl -hostname= Ns Ar hostname
109.Xc
110hostname of the server
111.It Xo
112.Fl -realm= Ns Ar string
113.Xc
114Kerberos realm to communicate with
115.El
116.It Xo digest-server-request
117.Op Fl -type= Ns Ar string
118.Op Fl -kerberos-realm= Ns Ar realm
119.Op Fl -username= Ns Ar name
120.Op Fl -server-nonce= Ns Ar nonce
121.Op Fl -server-identifier= Ns Ar nonce
122.Op Fl -client-nonce= Ns Ar nonce
123.Op Fl -client-response= Ns Ar response
124.Op Fl -opaque= Ns Ar string
125.Op Fl -authentication-name= Ns Ar name
126.Op Fl -realm= Ns Ar realm
127.Op Fl -method= Ns Ar method
128.Op Fl -uri= Ns Ar uri
129.Op Fl -nounce-count= Ns Ar count
130.Op Fl -qop= Ns Ar qop
131.Op Fl -ccache= Ns Ar ccache
132.Xc
133.Bl -tag -width Ds
134.It Xo
135.Fl -type= Ns Ar string
136.Xc
137digest type
138.It Xo
139.Fl -kerberos-realm= Ns Ar realm
140.Xc
141.It Xo
142.Fl -username= Ns Ar name
143.Xc
144digest type
145.It Xo
146.Fl -server-nonce= Ns Ar nonce
147.Xc
148.It Xo
149.Fl -server-identifier= Ns Ar nonce
150.Xc
151.It Xo
152.Fl -client-nonce= Ns Ar nonce
153.Xc
154.It Xo
155.Fl -client-response= Ns Ar response
156.Xc
157.It Xo
158.Fl -opaque= Ns Ar string
159.Xc
160.It Xo
161.Fl -authentication-name= Ns Ar name
162.Xc
163.It Xo
164.Fl -realm= Ns Ar realm
165.Xc
166.It Xo
167.Fl -method= Ns Ar method
168.Xc
169.It Xo
170.Fl -uri= Ns Ar uri
171.Xc
172.It Xo
173.Fl -nounce-count= Ns Ar count
174.Xc
175.It Xo
176.Fl -qop= Ns Ar qop
177.Xc
178.It Xo
179.Fl -ccache= Ns Ar ccache
180.Xc
181Where the the credential cache is created when the KDC returns tickets
182.El
183.It Xo digest-client-request
184.Op Fl -type= Ns Ar string
185.Op Fl -username= Ns Ar name
186.Op Fl -password= Ns Ar password
187.Op Fl -server-nonce= Ns Ar nonce
188.Op Fl -server-identifier= Ns Ar nonce
189.Op Fl -client-nonce= Ns Ar nonce
190.Op Fl -opaque= Ns Ar string
191.Op Fl -realm= Ns Ar realm
192.Op Fl -method= Ns Ar method
193.Op Fl -uri= Ns Ar uri
194.Op Fl -nounce-count= Ns Ar count
195.Op Fl -qop= Ns Ar qop
196.Xc
197.Bl -tag -width Ds
198.It Xo
199.Fl -type= Ns Ar string
200.Xc
201digest type
202.It Xo
203.Fl -username= Ns Ar name
204.Xc
205digest type
206.It Xo
207.Fl -password= Ns Ar password
208.Xc
209.It Xo
210.Fl -server-nonce= Ns Ar nonce
211.Xc
212.It Xo
213.Fl -server-identifier= Ns Ar nonce
214.Xc
215.It Xo
216.Fl -client-nonce= Ns Ar nonce
217.Xc
218.It Xo
219.Fl -opaque= Ns Ar string
220.Xc
221.It Xo
222.Fl -realm= Ns Ar realm
223.Xc
224.It Xo
225.Fl -method= Ns Ar method
226.Xc
227.It Xo
228.Fl -uri= Ns Ar uri
229.Xc
230.It Xo
231.Fl -nounce-count= Ns Ar count
232.Xc
233.It Xo
234.Fl -qop= Ns Ar qop
235.Xc
236.El
237.It Xo ntlm-server-init
238.Op Fl -version= Ns Ar integer
239.Op Fl -kerberos-realm= Ns Ar string
240.Xc
241.Bl -tag -width Ds
242.It Xo
243.Fl -version= Ns Ar integer
244.Xc
245ntlm version
246.It Xo
247.Fl -kerberos-realm= Ns Ar string
248.Xc
249Kerberos realm to communicate with
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