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

   1 .\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35)
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sp \" Vertical space (when we can't use .PP)
   6 .if t .sp .5v
   7 .if n .sp
   8 ..
   9 .de Vb \" Begin verbatim text
  10 .ft CW
  11 .nf
  12 .ne \\$1
  13 ..
  14 .de Ve \" End verbatim text
  15 .ft R
  16 .fi
  17 ..
  18 .\" Set up some character translations and predefined strings.  \*(-- will
  19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  23 .\" nothing in troff, for use with C<>.
  24 .tr \(*W-
  25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  26 .ie n \{\
  27 .    ds -- \(*W-
  28 .    ds PI pi
  29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  31 .    ds L" ""
  32 .    ds R" ""
  33 .    ds C` ""
  34 .    ds C' ""
  35 'br\}
  36 .el\{\
  37 .    ds -- \|\(em\|
  38 .    ds PI \(*p
  39 .    ds L" ``
  40 .    ds R" ''
  41 .    ds C`
  42 .    ds C'
  43 'br\}
  44 .\"
  45 .\" Escape single quotes in literal strings from groff's Unicode transform.
  46 .ie \n(.g .ds Aq \(aq
  47 .el       .ds Aq '
  48 .\"
  49 .\" If the F register is >0, we'll generate index entries on stderr for
  50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  51 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  52 .\" output yourself in some meaningful fashion.
  53 .\"
  54 .\" Avoid warning from groff about undefined register 'F'.
  55 .de IX
  56 ..
  57 .if !\nF .nr F 0
  58 .if \nF>0 \{\
  59 .    de IX
  60 .    tm Index:\\$1\t\\n%\t"\\$2"
  61 ..
  62 .    if !\nF==2 \{\
  63 .        nr % 0
  64 .        nr F 2
  65 .    \}
  66 .\}
  67 .\"
  68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  69 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  70 .    \" fudge factors for nroff and troff
  71 .if n \{\
  72 .    ds #H 0
  73 .    ds #V .8m
  74 .    ds #F .3m
  75 .    ds #[ \f1
  76 .    ds #] \fP
  77 .\}
  78 .if t \{\
  79 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  80 .    ds #V .6m
  81 .    ds #F 0
  82 .    ds #[ \&
  83 .    ds #] \&
  84 .\}
  85 .    \" simple accents for nroff and troff
  86 .if n \{\
  87 .    ds ' \&
  88 .    ds ` \&
  89 .    ds ^ \&
  90 .    ds , \&
  91 .    ds ~ ~
  92 .    ds /
  93 .\}
  94 .if t \{\
  95 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  96 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  97 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  98 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  99 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 100 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 101 .\}
 102 .    \" troff and (daisy-wheel) nroff accents
 103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 110 .ds ae a\h'-(\w'a'u*4/10)'e
 111 .ds Ae A\h'-(\w'A'u*4/10)'E
 112 .    \" corrections for vroff
 113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 115 .    \" for low resolution devices (crt and lpr)
 116 .if \n(.H>23 .if \n(.V>19 \
 117 \{\
 118 .    ds : e
 119 .    ds 8 ss
 120 .    ds o a
 121 .    ds d- d\h'-1'\(ga
 122 .    ds D- D\h'-1'\(hy
 123 .    ds th \o'bp'
 124 .    ds Th \o'LP'
 125 .    ds ae ae
 126 .    ds Ae AE
 127 .\}
 128 .rm #[ #] #H #V #F C
 129 .\" ========================================================================
 130 .\"
 131 .IX Title "STOREUTL 1"
 132 .TH STOREUTL 1 "2018-09-11" "1.1.1" "OpenSSL"
 133 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 134 .\" way too many mistakes in technical documents.
 135 .if n .ad l
 136 .nh
 137 .SH "NAME"
 138 openssl\-storeutl, storeutl \- STORE utility
 139 .SH "SYNOPSIS"
 140 .IX Header "SYNOPSIS"
 141 \&\fBopenssl\fR \fBstoreutl\fR
 142 [\fB\-help\fR]
 143 [\fB\-out file\fR]
 144 [\fB\-noout\fR]
 145 [\fB\-passin arg\fR]
 146 [\fB\-text arg\fR]
 147 [\fB\-engine id\fR]
 148 [\fB\-r\fR]
 149 [\fB\-certs\fR]
 150 [\fB\-keys\fR]
 151 [\fB\-crls\fR]
 152 [\fB\-subject arg\fR]
 153 [\fB\-issuer arg\fR]
 154 [\fB\-serial arg\fR]
 155 [\fB\-alias arg\fR]
 156 [\fB\-fingerprint arg\fR]
 157 [\fB\-\f(BIdigest\fB\fR]
 158 \&\fBuri\fR ...
 159 .SH "DESCRIPTION"
 160 .IX Header "DESCRIPTION"
 161 The \fBstoreutl\fR command can be used to display the contents (after decryption
 162 as the case may be) fetched from the given URIs.
 163 .SH "OPTIONS"
 164 .IX Header "OPTIONS"
 165 .IP "\fB\-help\fR" 4
 166 .IX Item "-help"
 167 Print out a usage message.
 168 .IP "\fB\-out filename\fR" 4
 169 .IX Item "-out filename"
 170 specifies the output filename to write to or standard output by
 171 default.
 172 .IP "\fB\-noout\fR" 4
 173 .IX Item "-noout"
 174 this option prevents output of the \s-1PEM\s0 data.
 175 .IP "\fB\-passin arg\fR" 4
 176 .IX Item "-passin arg"
 177 the key password source. For more information about the format of \fBarg\fR
 178 see the \fB\s-1PASS PHRASE ARGUMENTS\s0\fR section in \fIopenssl\fR\|(1).
 179 .IP "\fB\-text\fR" 4
 180 .IX Item "-text"
 181 Prints out the objects in text form, similarly to the \fB\-text\fR output from
 182 \&\fBopenssl x509\fR, \fBopenssl pkey\fR, etc.
 183 .IP "\fB\-engine id\fR" 4
 184 .IX Item "-engine id"
 185 specifying an engine (by its unique \fBid\fR string) will cause \fBstoreutl\fR
 186 to attempt to obtain a functional reference to the specified engine,
 187 thus initialising it if needed.
 188 The engine will then be set as the default for all available algorithms.
 189 .IP "\fB\-r\fR" 4
 190 .IX Item "-r"
 191 Fetch objects recursively when possible.
 192 .IP "\fB\-certs\fR" 4
 193 .IX Item "-certs"
 194 .PD 0
 195 .IP "\fB\-keys\fR" 4
 196 .IX Item "-keys"
 197 .IP "\fB\-crls\fR" 4
 198 .IX Item "-crls"
 199 .PD
 200 Only select the certificates, keys or CRLs from the given \s-1URI.\s0
 201 However, if this \s-1URI\s0 would return a set of names (URIs), those are always
 202 returned.
 203 .IP "\fB\-subject arg\fR" 4
 204 .IX Item "-subject arg"
 205 Search for an object having the subject name \fBarg\fR.
 206 The arg must be formatted as \fI/type0=value0/type1=value1/type2=...\fR,
 207 characters may be escaped by \e (backslash), no spaces are skipped.
 208 .IP "\fB\-issuer arg\fR" 4
 209 .IX Item "-issuer arg"
 210 .PD 0
 211 .IP "\fB\-serial arg\fR" 4
 212 .IX Item "-serial arg"
 213 .PD
 214 Search for an object having the given issuer name and serial number.
 215 These two options \fImust\fR be used together.
 216 The issuer arg must be formatted as \fI/type0=value0/type1=value1/type2=...\fR,
 217 characters may be escaped by \e (backslash), no spaces are skipped.
 218 The serial arg may be specified as a decimal value or a hex value if preceded
 219 by \fB0x\fR.
 220 .IP "\fB\-alias arg\fR" 4
 221 .IX Item "-alias arg"
 222 Search for an object having the given alias.
 223 .IP "\fB\-fingerprint arg\fR" 4
 224 .IX Item "-fingerprint arg"
 225 Search for an object having the given fingerprint.
 226 .IP "\fB\-\f(BIdigest\fB\fR" 4
 227 .IX Item "-digest"
 228 The digest that was used to compute the fingerprint given with \fB\-fingerprint\fR.
 229 .SH "SEE ALSO"
 230 .IX Header "SEE ALSO"
 231 \&\fIopenssl\fR\|(1)
 232 .SH "HISTORY"
 233 .IX Header "HISTORY"
 234 \&\fBopenssl\fR \fBstoreutl\fR was added to OpenSSL 1.1.1.
 235 .SH "COPYRIGHT"
 236 .IX Header "COPYRIGHT"
 237 Copyright 2016\-2018 The OpenSSL Project Authors. All Rights Reserved.
 238 .PP
 239 Licensed under the OpenSSL license (the \*(L"License\*(R").  You may not use
 240 this file except in compliance with the License.  You can obtain a copy
 241 in the file \s-1LICENSE\s0 in the source distribution or at
 242 <https://www.openssl.org/source/license.html>.