crypto/external/bsd/heimdal/dist/kuser/kdigest.8

   1 .\"     $NetBSD: kdigest.8,v 1.1.1.3 2014/04/24 12:45:28 pettai 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
  47 command
  48 .Op arguments
  49 .Sh DESCRIPTION
  50 Supported options:
  51 .Bl -tag -width Ds
  52 .It Xo
  53 .Fl Fl ccache= Ns Ar string
  54 .Xc
  55 credential cache
  56 .It Xo
  57 .Fl Fl version
  58 .Xc
  59 print version
  60 .It Xo
  61 .Fl Fl help
  62 .Xc
  63 .El
  64 .Pp
  65 Available 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
  75 Kerberos 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
  90 digest 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
  97 digest type to use in the algorithm
  98 .It Xo
  99 .Fl Fl cb-type= Ns Ar type
 100 .Xc
 101 type of channel bindings
 102 .It Xo
 103 .Fl Fl cb-value= Ns Ar value
 104 .Xc
 105 value of channel bindings
 106 .It Xo
 107 .Fl Fl hostname= Ns Ar hostname
 108 .Xc
 109 hostname of the server
 110 .It Xo
 111 .Fl Fl realm= Ns Ar string
 112 .Xc
 113 Kerberos 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
 136 digest 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
 143 digest 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
 180 Where 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
 200 digest type
 201 .It Xo
 202 .Fl Fl username= Ns Ar name
 203 .Xc
 204 digest 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
 244 ntlm version
 245 .It Xo
 246 .Fl Fl kerberos-realm= Ns Ar string
 247 .Xc
 248 Kerberos realm to communicate with
 249 .El
 250 .\".Sh ENVIRONMENT
 251 .\".Sh FILES
 252 .\".Sh EXAMPLES
 253 .\".Sh DIAGNOSTICS
 254 .\".Sh SEE ALSO
 255 .\".Sh STANDARDS
 256 .\".Sh HISTORY
 257 .\".Sh AUTHORS
 258 .\".Sh BUGS