.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "OPENSSL-STOREUTL 1ssl" .TH OPENSSL-STOREUTL 1ssl 2026-08-25 3.6.4 OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" openssl\-storeutl \- دستور STORE برای واکشی و مدیریت اشیای رمزنگاری .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBopenssl\fR \fBstoreutl\fR [\fB\-help\fR] [\fB\-out\fR \fIfile\fR] [\fB\-noout\fR] [\fB\-passin\fR \fIarg\fR] [\fB\-text\fR \fIarg\fR] [\fB\-r\fR] [\fB\-certs\fR] [\fB\-keys\fR] [\fB\-crls\fR] [\fB\-subject\fR \fIarg\fR] [\fB\-issuer\fR \fIarg\fR] [\fB\-serial\fR \fIarg\fR] [\fB\-alias\fR \fIarg\fR] [\fB\-fingerprint\fR \fIarg\fR] [\fB\-\fR\f(BIdigest\fR] [\fB\-engine\fR \fIid\fR] [\fB\-provider\fR \fIname\fR] [\fB\-provider\-path\fR \fIpath\fR] [\fB\-provparam\fR \fI[name:]key=value\fR] [\fB\-propquery\fR \fIpropq\fR] \&\fIuri\fR .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" از این دستور می‌توان برای نمایش محتویات واکشی‌شده از URI داده‌شده (در صورت لزوم پس از رمزگشایی) استفاده کرد. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-help\fR 4 .IX Item "-help" چاپ پیام راهنمای نحوه استفاده از دستور. .IP "\fB\-out\fR \fIfilename\fR" 4 .IX Item "-out filename" فایل خروجی را برای نوشتن مشخص می‌کند. در صورت عدم استفاده از این گزینه، از خروجی استاندارد استفاده می‌شود. فایل خروجی می‌تواند همان فایل ورودی باشد که در این صورت محتوای فایل جایگزین خواهد شد. توجه داشته باشید که ورودی/خروجی فایل اتمیک (atomic) نیست؛ فایل خروجی ابتدا خالی و سپس در آن نوشته می‌شود. .IP \fB\-noout\fR 4 .IX Item "-noout" این گزینه از چاپ داده‌های PEM در خروجی جلوگیری می‌کند. .IP "\fB\-passin\fR \fIarg\fR" 4 .IX Item "-passin arg" منبع گذرواژه کلید. برای اطلاعات بیشتر درباره قالب \fIarg\fR به \fBopenssl\-passphrase\-options\fR\|(1) مراجعه کنید. .IP \fB\-text\fR 4 .IX Item "-text" اشیای مورد نظر را به شکل متنی، مشابه با خروجی \fB\-text\fR در \&\fBopenssl\-x509\fR\|(1)، \fBopenssl\-pkey\fR\|(1) و غیره، چاپ می‌کند. .IP \fB\-r\fR 4 .IX Item "-r" در صورت امکان، اشیا را به صورت بازگشتی واکشی می‌کند. .IP \fB\-certs\fR 4 .IX Item "-certs" .PD 0 .IP \fB\-keys\fR 4 .IX Item "-keys" .IP \fB\-crls\fR 4 .IX Item "-crls" .PD تنها گواهی‌ها، کلیدها یا CRLها را از URI داده‌شده انتخاب می‌کند. با این حال، اگر این URI مجموعه‌ای از نام‌ها (URIها) را بازگرداند، آن نام‌ها همیشه بازگردانده می‌شوند. .Sp توجه داشته باشید که تمامی گزینه‌ها باید پیش از آرگومان \fIuri\fR ارائه شوند. .Sp توجه داشته باشید که \fI\-keys\fR منحصراً کلیدهای خصوصی را انتخاب می‌کند؛ هیچ انتخاب‌گری فقط برای کلیدهای عمومی وجود ندارد. .IP "\fB\-subject\fR \fIarg\fR" 4 .IX Item "-subject arg" جستجو برای شیئی که نام موضوع (subject) آن برابر با \fIarg\fR باشد. .Sp آرگومان باید در قالب \f(CW\*(C`/type0=value0/type1=value1/type2=...\*(C'\fR قالب‌بندی شود. کاراکترهای خاص را می‌توان با \f(CW\*(C`\e\*(C'\fR (بک‌اسلش) اسکیپ کرد؛ فاصله‌های خالی حفظ می‌شوند. مقادیر خالی مجاز هستند اما در جستجو نادیده گرفته می‌شوند؛ یعنی جستجو با یک مقدار خالی همانند عدم مشخص کردن نوع مربوطه خواهد بود. ارائه یک \f(CW\*(C`/\*(C'\fR تکی منجر به یک توالی خالی از RDNها (یک NULL\-DN) می‌شود. RDNهای چندمقداره را می‌توان با قرار دادن یک کاراکتر \f(CW\*(C`+\*(C'\fR به جای \f(CW\*(C`/\*(C'\fR بین گزاره‌های انتساب مقدار صفت (AVAs) که اعضای مجموعه را مشخص می‌کنند، تشکیل داد. .Sp مثال: .Sp \&\f(CW\*(C`/DC=org/DC=OpenSSL/DC=users/UID=123456+CN=John Doe\*(C'\fR .IP "\fB\-issuer\fR \fIarg\fR" 4 .IX Item "-issuer arg" .PD 0 .IP "\fB\-serial\fR \fIarg\fR" 4 .IX Item "-serial arg" .PD جستجو برای شیئی با نام صادرکننده (issuer) و شماره سریال داده‌شده. این دو گزینه \fIباید\fR با یکدیگر استفاده شوند. آرگومان issuer باید به قالب \f(CW\*(C`/type0=value0/type1=value1/type2=...\*(C'\fR قالب‌بندی شود، کاراکترها را می‌توان با \e (بک‌اسلش) اسکیپ کرد و هیچ فاصله‌ای نادیده گرفته نمی‌شود. آرگومان serial می‌تواند به صورت یک مقدار ده‌دهی یا در صورت همراه بودن با پیشوند \f(CW\*(C`0x\*(C'\fR به صورت یک مقدار هگزادسیمال مشخص شود. .IP "\fB\-alias\fR \fIarg\fR" 4 .IX Item "-alias arg" جستجو برای شیئی که نام مستعار (alias) داده‌شده را دارد. .IP "\fB\-fingerprint\fR \fIarg\fR" 4 .IX Item "-fingerprint arg" جستجو برای شیئی که دارای اثر انگشت (fingerprint) مشخص‌شده است. .IP \fB\-\fR\f(BIdigest\fR 4 .IX Item "-digest" خلاصه پیامی (digest) که برای محاسبه اثر انگشت ارائه‌شده با \fB\-fingerprint\fR استفاده شده است. .IP "\fB\-engine\fR \fIid\fR" 4 .IX Item "-engine id" به «گزینه‌های موتور» (Engine Options) در \fBopenssl\fR\|(1) مراجعه کنید. این گزینه منسوخ شده است. .IP "\fB\-provider\fR \fIname\fR" 4 .IX Item "-provider name" .PD 0 .IP "\fB\-provider\-path\fR \fIpath\fR" 4 .IX Item "-provider-path path" .IP "\fB\-provparam\fR \fI[name:]key=value\fR" 4 .IX Item "-provparam [name:]key=value" .IP "\fB\-propquery\fR \fIpropq\fR" 4 .IX Item "-propquery propq" .PD به «گزینه‌های فراهم‌کننده» (Provider Options) در \fBopenssl\fR\|(1)، \fBprovider\fR\|(7) و \fBproperty\fR\|(7) مراجعه کنید. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBopenssl\fR\|(1) .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" این دستور در OpenSSL 1.1.1 اضافه شد. .PP گزینه \fB\-engine\fR در OpenSSL 3.0 منسوخ شد. .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر 2016\-2024 نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است. .PP تحت مجوز آپاچی، نسخه 2.0 ("مجوز") مجوزدهی شده است. شما نمی‌توانید از این فایل استفاده کنید مگر با رعایت مفاد مجوز. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE در توزیع منبع یا در دریافت نمایید.