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