secure/usr.bin/openssl/man/dgst.1

   1 .rn '' }`
   2 ''' $RCSfile$$Revision$$Date$
   3 '''
   4 ''' $Log$
   5 '''
   6 .de Sh
   7 .br
   8 .if t .Sp
   9 .ne 5
  10 .PP
  11 \fB\\$1\fR
  12 .PP
  13 ..
  14 .de Sp
  15 .if t .sp .5v
  16 .if n .sp
  17 ..
  18 .de Ip
  19 .br
  20 .ie \\n(.$>=3 .ne \\$3
  21 .el .ne 3
  22 .IP "\\$1" \\$2
  23 ..
  24 .de Vb
  25 .ft CW
  26 .nf
  27 .ne \\$1
  28 ..
  29 .de Ve
  30 .ft R
  31
  32 .fi
  33 ..
  34 '''
  35 '''
  36 '''     Set up \*(-- to give an unbreakable dash;
  37 '''     string Tr holds user defined translation string.
  38 '''     Bell System Logo is used as a dummy character.
  39 '''
  40 .tr \(*W-|\(bv\*(Tr
  41 .ie n \{\
  42 .ds -- \(*W-
  43 .ds PI pi
  44 .if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  45 .if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
  46 .ds L" ""
  47 .ds R" ""
  48 '''   \*(M", \*(S", \*(N" and \*(T" are the equivalent of
  49 '''   \*(L" and \*(R", except that they are used on ".xx" lines,
  50 '''   such as .IP and .SH, which do another additional levels of
  51 '''   double-quote interpretation
  52 .ds M" """
  53 .ds S" """
  54 .ds N" """""
  55 .ds T" """""
  56 .ds L' '
  57 .ds R' '
  58 .ds M' '
  59 .ds S' '
  60 .ds N' '
  61 .ds T' '
  62 'br\}
  63 .el\{\
  64 .ds -- \(em\|
  65 .tr \*(Tr
  66 .ds L" ``
  67 .ds R" ''
  68 .ds M" ``
  69 .ds S" ''
  70 .ds N" ``
  71 .ds T" ''
  72 .ds L' `
  73 .ds R' '
  74 .ds M' `
  75 .ds S' '
  76 .ds N' `
  77 .ds T' '
  78 .ds PI \(*p
  79 'br\}
  80 .\"     If the F register is turned on, we'll generate
  81 .\"     index entries out stderr for the following things:
  82 .\"             TH      Title
  83 .\"             SH      Header
  84 .\"             Sh      Subsection
  85 .\"             Ip      Item
  86 .\"             X<>     Xref  (embedded
  87 .\"     Of course, you have to process the output yourself
  88 .\"     in some meaninful fashion.
  89 .if \nF \{
  90 .de IX
  91 .tm Index:\\$1\t\\n%\t"\\$2"
  92 ..
  93 .nr % 0
  94 .rr F
  95 .\}
  96 .TH DGST 1 "0.9.7d" "2/Sep/2004" "OpenSSL"
  97 .UC
  98 .if n .hy 0
  99 .if n .na
 100 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
 101 .de CQ          \" put $1 in typewriter font
 102 .ft CW
 103 'if n "\c
 104 'if t \\&\\$1\c
 105 'if n \\&\\$1\c
 106 'if n \&"
 107 \\&\\$2 \\$3 \\$4 \\$5 \\$6 \\$7
 108 '.ft R
 109 ..
 110 .\" @(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2
 111 .       \" AM - accent mark definitions
 112 .bd B 3
 113 .       \" fudge factors for nroff and troff
 114 .if n \{\
 115 .       ds #H 0
 116 .       ds #V .8m
 117 .       ds #F .3m
 118 .       ds #[ \f1
 119 .       ds #] \fP
 120 .\}
 121 .if t \{\
 122 .       ds #H ((1u-(\\\\n(.fu%2u))*.13m)
 123 .       ds #V .6m
 124 .       ds #F 0
 125 .       ds #[ \&
 126 .       ds #] \&
 127 .\}
 128 .       \" simple accents for nroff and troff
 129 .if n \{\
 130 .       ds ' \&
 131 .       ds ` \&
 132 .       ds ^ \&
 133 .       ds , \&
 134 .       ds ~ ~
 135 .       ds ? ?
 136 .       ds ! !
 137 .       ds /
 138 .       ds q
 139 .\}
 140 .if t \{\
 141 .       ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 142 .       ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 143 .       ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 144 .       ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 145 .       ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 146 .       ds ? \s-2c\h'-\w'c'u*7/10'\u\h'\*(#H'\zi\d\s+2\h'\w'c'u*8/10'
 147 .       ds ! \s-2\(or\s+2\h'-\w'\(or'u'\v'-.8m'.\v'.8m'
 148 .       ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 149 .       ds q o\h'-\w'o'u*8/10'\s-4\v'.4m'\z\(*i\v'-.4m'\s+4\h'\w'o'u*8/10'
 150 .\}
 151 .       \" troff and (daisy-wheel) nroff accents
 152 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 153 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 154 .ds v \\k:\h'-(\\n(.wu*9/10-\*(#H)'\v'-\*(#V'\*(#[\s-4v\s0\v'\*(#V'\h'|\\n:u'\*(#]
 155 .ds _ \\k:\h'-(\\n(.wu*9/10-\*(#H+(\*(#F*2/3))'\v'-.4m'\z\(hy\v'.4m'\h'|\\n:u'
 156 .ds . \\k:\h'-(\\n(.wu*8/10)'\v'\*(#V*4/10'\z.\v'-\*(#V*4/10'\h'|\\n:u'
 157 .ds 3 \*(#[\v'.2m'\s-2\&3\s0\v'-.2m'\*(#]
 158 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 159 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 160 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 161 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 162 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 163 .ds ae a\h'-(\w'a'u*4/10)'e
 164 .ds Ae A\h'-(\w'A'u*4/10)'E
 165 .ds oe o\h'-(\w'o'u*4/10)'e
 166 .ds Oe O\h'-(\w'O'u*4/10)'E
 167 .       \" corrections for vroff
 168 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 169 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 170 .       \" for low resolution devices (crt and lpr)
 171 .if \n(.H>23 .if \n(.V>19 \
 172 \{\
 173 .       ds : e
 174 .       ds 8 ss
 175 .       ds v \h'-1'\o'\(aa\(ga'
 176 .       ds _ \h'-1'^
 177 .       ds . \h'-1'.
 178 .       ds 3 3
 179 .       ds o a
 180 .       ds d- d\h'-1'\(ga
 181 .       ds D- D\h'-1'\(hy
 182 .       ds th \o'bp'
 183 .       ds Th \o'LP'
 184 .       ds ae ae
 185 .       ds Ae AE
 186 .       ds oe oe
 187 .       ds Oe OE
 188 .\}
 189 .rm #[ #] #H #V #F C
 190 .SH "NAME"
 191 dgst, md5, md4, md2, sha1, sha, mdc2, ripemd160 \- message digests
 192 .SH "SYNOPSIS"
 193 \fBopenssl\fR \fBdgst\fR
 194 [\fB\-md5|\-md4|\-md2|\-sha1|\-sha|\-mdc2|\-ripemd160|\-dss1\fR]
 195 [\fB\-c\fR]
 196 [\fB\-d\fR]
 197 [\fB\-hex\fR]
 198 [\fB\-binary\fR]
 199 [\fB\-out filename\fR]
 200 [\fB\-sign filename\fR]
 201 [\fB\-verify filename\fR]
 202 [\fB\-prverify filename\fR]
 203 [\fB\-signature filename\fR]
 204 [\fBfile...\fR]
 205 .PP
 206 [\fBmd5|md4|md2|sha1|sha|mdc2|ripemd160\fR]
 207 [\fB\-c\fR]
 208 [\fB\-d\fR]
 209 [\fBfile...\fR]
 210 .SH "DESCRIPTION"
 211 The digest functions output the message digest of a supplied file or files
 212 in hexadecimal form. They can also be used for digital signing and verification.
 213 .SH "OPTIONS"
 214 .Ip "\fB\-c\fR" 4
 215 print out the digest in two digit groups separated by colons, only relevant if
 216 \fBhex\fR format output is used.
 217 .Ip "\fB\-d\fR" 4
 218 print out \s-1BIO\s0 debugging information.
 219 .Ip "\fB\-hex\fR" 4
 220 digest is to be output as a hex dump. This is the default case for a \*(L"normal\*(R"
 221 digest as opposed to a digital signature.
 222 .Ip "\fB\-binary\fR" 4
 223 output the digest or signature in binary form.
 224 .Ip "\fB\-out filename\fR" 4
 225 filename to output to, or standard output by default.
 226 .Ip "\fB\-sign filename\fR" 4
 227 digitally sign the digest using the private key in \*(L"filename\*(R".
 228 .Ip "\fB\-verify filename\fR" 4
 229 verify the signature using the the public key in \*(L"filename\*(R".
 230 The output is either \*(L"Verification \s-1OK\s0\*(R" or \*(L"Verification Failure\*(R".
 231 .Ip "\fB\-prverify filename\fR" 4
 232 verify the signature using the  the private key in \*(L"filename\*(R".
 233 .Ip "\fB\-signature filename\fR" 4
 234 the actual signature to verify.
 235 .Ip "\fB\-rand file(s)\fR" 4
 236 a file or files containing random data used to seed the random number
 237 generator, or an \s-1EGD\s0 socket (see RAND_egd(3)).
 238 Multiple files can be specified separated by a \s-1OS\s0\-dependent character.
 239 The separator is \fB;\fR for \s-1MS\s0\-Windows, \fB,\fR for OpenVMS, and \fB:\fR for
 240 all others.
 241 .Ip "\fBfile...\fR" 4
 242 file or files to digest. If no files are specified then standard input is
 243 used.
 244 .SH "NOTES"
 245 The digest of choice for all new applications is SHA1. Other digests are
 246 however still widely used.
 247 .PP
 248 If you wish to sign or verify data using the DSA algorithm then the dss1
 249 digest must be used.
 250 .PP
 251 A source of random numbers is required for certain signing algorithms, in
 252 particular DSA.
 253 .PP
 254 The signing and verify options should only be used if a single file is
 255 being signed or verified.
 256
 257 .rn }` ''
 258 .IX Title "DGST 1"
 259 .IX Name "dgst, md5, md4, md2, sha1, sha, mdc2, ripemd160 - message digests"
 260
 261 .IX Header "NAME"
 262
 263 .IX Header "SYNOPSIS"
 264
 265 .IX Header "DESCRIPTION"
 266
 267 .IX Header "OPTIONS"
 268
 269 .IX Item "\fB\-c\fR"
 270
 271 .IX Item "\fB\-d\fR"
 272
 273 .IX Item "\fB\-hex\fR"
 274
 275 .IX Item "\fB\-binary\fR"
 276
 277 .IX Item "\fB\-out filename\fR"
 278
 279 .IX Item "\fB\-sign filename\fR"
 280
 281 .IX Item "\fB\-verify filename\fR"
 282
 283 .IX Item "\fB\-prverify filename\fR"
 284
 285 .IX Item "\fB\-signature filename\fR"
 286
 287 .IX Item "\fB\-rand file(s)\fR"
 288
 289 .IX Item "\fBfile...\fR"
 290
 291 .IX Header "NOTES"
 292