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

   1 .\" Automatically generated by Pod::Man 4.10 (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 .nr rF 0
  58 .if \n(.g .if rF .nr rF 1
  59 .if (\n(rF:(\n(.g==0)) \{\
  60 .    if \nF \{\
  61 .        de IX
  62 .        tm Index:\\$1\t\\n%\t"\\$2"
  63 ..
  64 .        if !\nF==2 \{\
  65 .            nr % 0
  66 .            nr F 2
  67 .        \}
  68 .    \}
  69 .\}
  70 .rr rF
  71 .\"
  72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  73 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  74 .    \" fudge factors for nroff and troff
  75 .if n \{\
  76 .    ds #H 0
  77 .    ds #V .8m
  78 .    ds #F .3m
  79 .    ds #[ \f1
  80 .    ds #] \fP
  81 .\}
  82 .if t \{\
  83 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  84 .    ds #V .6m
  85 .    ds #F 0
  86 .    ds #[ \&
  87 .    ds #] \&
  88 .\}
  89 .    \" simple accents for nroff and troff
  90 .if n \{\
  91 .    ds ' \&
  92 .    ds ` \&
  93 .    ds ^ \&
  94 .    ds , \&
  95 .    ds ~ ~
  96 .    ds /
  97 .\}
  98 .if t \{\
  99 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 100 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 101 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 102 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 103 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 104 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 105 .\}
 106 .    \" troff and (daisy-wheel) nroff accents
 107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 114 .ds ae a\h'-(\w'a'u*4/10)'e
 115 .ds Ae A\h'-(\w'A'u*4/10)'E
 116 .    \" corrections for vroff
 117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 119 .    \" for low resolution devices (crt and lpr)
 120 .if \n(.H>23 .if \n(.V>19 \
 121 \{\
 122 .    ds : e
 123 .    ds 8 ss
 124 .    ds o a
 125 .    ds d- d\h'-1'\(ga
 126 .    ds D- D\h'-1'\(hy
 127 .    ds th \o'bp'
 128 .    ds Th \o'LP'
 129 .    ds ae ae
 130 .    ds Ae AE
 131 .\}
 132 .rm #[ #] #H #V #F C
 133 .\" ========================================================================
 134 .\"
 135 .IX Title "STOREUTL 1"
 136 .TH STOREUTL 1 "2019-05-28" "1.1.1c" "OpenSSL"
 137 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 138 .\" way too many mistakes in technical documents.
 139 .if n .ad l
 140 .nh
 141 .SH "NAME"
 142 openssl\-storeutl, storeutl \- STORE utility
 143 .SH "SYNOPSIS"
 144 .IX Header "SYNOPSIS"
 145 \&\fBopenssl\fR \fBstoreutl\fR
 146 [\fB\-help\fR]
 147 [\fB\-out file\fR]
 148 [\fB\-noout\fR]
 149 [\fB\-passin arg\fR]
 150 [\fB\-text arg\fR]
 151 [\fB\-engine id\fR]
 152 [\fB\-r\fR]
 153 [\fB\-certs\fR]
 154 [\fB\-keys\fR]
 155 [\fB\-crls\fR]
 156 [\fB\-subject arg\fR]
 157 [\fB\-issuer arg\fR]
 158 [\fB\-serial arg\fR]
 159 [\fB\-alias arg\fR]
 160 [\fB\-fingerprint arg\fR]
 161 [\fB\-\f(BIdigest\fB\fR]
 162 \&\fBuri\fR ...
 163 .SH "DESCRIPTION"
 164 .IX Header "DESCRIPTION"
 165 The \fBstoreutl\fR command can be used to display the contents (after decryption
 166 as the case may be) fetched from the given URIs.
 167 .SH "OPTIONS"
 168 .IX Header "OPTIONS"
 169 .IP "\fB\-help\fR" 4
 170 .IX Item "-help"
 171 Print out a usage message.
 172 .IP "\fB\-out filename\fR" 4
 173 .IX Item "-out filename"
 174 specifies the output filename to write to or standard output by
 175 default.
 176 .IP "\fB\-noout\fR" 4
 177 .IX Item "-noout"
 178 this option prevents output of the \s-1PEM\s0 data.
 179 .IP "\fB\-passin arg\fR" 4
 180 .IX Item "-passin arg"
 181 the key password source. For more information about the format of \fBarg\fR
 182 see the \fB\s-1PASS PHRASE ARGUMENTS\s0\fR section in \fBopenssl\fR\|(1).
 183 .IP "\fB\-text\fR" 4
 184 .IX Item "-text"
 185 Prints out the objects in text form, similarly to the \fB\-text\fR output from
 186 \&\fBopenssl x509\fR, \fBopenssl pkey\fR, etc.
 187 .IP "\fB\-engine id\fR" 4
 188 .IX Item "-engine id"
 189 specifying an engine (by its unique \fBid\fR string) will cause \fBstoreutl\fR
 190 to attempt to obtain a functional reference to the specified engine,
 191 thus initialising it if needed.
 192 The engine will then be set as the default for all available algorithms.
 193 .IP "\fB\-r\fR" 4
 194 .IX Item "-r"
 195 Fetch objects recursively when possible.
 196 .IP "\fB\-certs\fR" 4
 197 .IX Item "-certs"
 198 .PD 0
 199 .IP "\fB\-keys\fR" 4
 200 .IX Item "-keys"
 201 .IP "\fB\-crls\fR" 4
 202 .IX Item "-crls"
 203 .PD
 204 Only select the certificates, keys or CRLs from the given \s-1URI.\s0
 205 However, if this \s-1URI\s0 would return a set of names (URIs), those are always
 206 returned.
 207 .IP "\fB\-subject arg\fR" 4
 208 .IX Item "-subject arg"
 209 Search for an object having the subject name \fBarg\fR.
 210 The arg must be formatted as \fI/type0=value0/type1=value1/type2=...\fR.
 211 Keyword characters may be escaped by \e (backslash), and whitespace is retained.
 212 Empty values are permitted but are ignored for the search.  That is,
 213 a search with an empty value will have the same effect as not specifying
 214 the type at all.
 215 .IP "\fB\-issuer arg\fR" 4
 216 .IX Item "-issuer arg"
 217 .PD 0
 218 .IP "\fB\-serial arg\fR" 4
 219 .IX Item "-serial arg"
 220 .PD
 221 Search for an object having the given issuer name and serial number.
 222 These two options \fImust\fR be used together.
 223 The issuer arg must be formatted as \fI/type0=value0/type1=value1/type2=...\fR,
 224 characters may be escaped by \e (backslash), no spaces are skipped.
 225 The serial arg may be specified as a decimal value or a hex value if preceded
 226 by \fB0x\fR.
 227 .IP "\fB\-alias arg\fR" 4
 228 .IX Item "-alias arg"
 229 Search for an object having the given alias.
 230 .IP "\fB\-fingerprint arg\fR" 4
 231 .IX Item "-fingerprint arg"
 232 Search for an object having the given fingerprint.
 233 .IP "\fB\-\f(BIdigest\fB\fR" 4
 234 .IX Item "-digest"
 235 The digest that was used to compute the fingerprint given with \fB\-fingerprint\fR.
 236 .SH "SEE ALSO"
 237 .IX Header "SEE ALSO"
 238 \&\fBopenssl\fR\|(1)
 239 .SH "HISTORY"
 240 .IX Header "HISTORY"
 241 The \fBopenssl\fR \fBstoreutl\fR app was added in OpenSSL 1.1.1.
 242 .SH "COPYRIGHT"
 243 .IX Header "COPYRIGHT"
 244 Copyright 2016\-2018 The OpenSSL Project Authors. All Rights Reserved.
 245 .PP
 246 Licensed under the OpenSSL license (the \*(L"License\*(R").  You may not use
 247 this file except in compliance with the License.  You can obtain a copy
 248 in the file \s-1LICENSE\s0 in the source distribution or at
 249 <https://www.openssl.org/source/license.html>.