OPENSSL-STOREUTL(1ssl)              OpenSSL             OPENSSL-STOREUTL(1ssl)


نام (NAME)
       openssl-storeutl - دستور STORE برای واکشی و مدیریت اشیای رمزنگاری

خلاصه دستور (SYNOPSIS)
       openssl storeutl [-help] [-out file] [-noout] [-passin arg] [-text arg]
       [-r] [-certs] [-keys] [-crls] [-subject arg] [-issuer arg] [-serial
       arg] [-alias arg] [-fingerprint arg] [-digest] [-engine id] [-provider
       name] [-provider-path path] [-provparam [name:]key=value] [-propquery
       propq] uri

توضیحات (DESCRIPTION)
       از این دستور می‌توان برای نمایش محتویات واکشی‌شده از URI داده‌شده (در صورت
       لزوم پس از رمزگشایی) استفاده کرد.

گزینه‌ها (OPTIONS)
       -help
           چاپ پیام راهنمای نحوه استفاده از دستور.

       -out filename
           فایل خروجی را برای نوشتن مشخص می‌کند.  در صورت عدم استفاده از این
           گزینه، از خروجی استاندارد استفاده می‌شود.  فایل خروجی می‌تواند همان
           فایل ورودی باشد که در این صورت محتوای فایل جایگزین خواهد شد.  توجه
           داشته باشید که ورودی/خروجی فایل اتمیک (atomic) نیست؛ فایل خروجی
           ابتدا خالی و سپس در آن نوشته می‌شود.

       -noout
           این گزینه از چاپ داده‌های PEM در خروجی جلوگیری می‌کند.

       -passin arg
           منبع گذرواژه کلید. برای اطلاعات بیشتر درباره قالب arg به
           openssl-passphrase-options(1) مراجعه کنید.

       -text
           اشیای مورد نظر را به شکل متنی، مشابه با خروجی -text در
           openssl-x509(1)، openssl-pkey(1) و غیره، چاپ می‌کند.

       -r  در صورت امکان، اشیا را به صورت بازگشتی واکشی می‌کند.

       -certs
       -keys
       -crls
           تنها گواهی‌ها، کلیدها یا CRLها را از URI داده‌شده انتخاب می‌کند.  با
           این حال، اگر این URI مجموعه‌ای از نام‌ها (URIها) را بازگرداند، آن
           نام‌ها همیشه بازگردانده می‌شوند.

           توجه داشته باشید که تمامی گزینه‌ها باید پیش از آرگومان uri ارائه
           شوند.

           توجه داشته باشید که -keys منحصراً کلیدهای خصوصی را انتخاب می‌کند؛ هیچ
           انتخاب‌گری فقط برای کلیدهای عمومی وجود ندارد.

       -subject arg
           جستجو برای شیئی که نام موضوع (subject) آن برابر با arg باشد.

           آرگومان باید در قالب "/type0=value0/type1=value1/type2=..."
           قالب‌بندی شود.  کاراکترهای خاص را می‌توان با "\" (بک‌اسلش) اسکیپ کرد؛
           فاصله‌های خالی حفظ می‌شوند.  مقادیر خالی مجاز هستند اما در جستجو
           نادیده گرفته می‌شوند؛ یعنی جستجو با یک مقدار خالی همانند عدم مشخص
           کردن نوع مربوطه خواهد بود.  ارائه یک "/" تکی منجر به یک توالی خالی
           از RDNها (یک NULL-DN) می‌شود.  RDNهای چندمقداره را می‌توان با قرار
           دادن یک کاراکتر "+" به جای "/" بین گزاره‌های انتساب مقدار صفت (AVAs)
           که اعضای مجموعه را مشخص می‌کنند، تشکیل داد.

           مثال:

           "/DC=org/DC=OpenSSL/DC=users/UID=123456+CN=John Doe"

       -issuer arg
       -serial arg
           جستجو برای شیئی با نام صادرکننده (issuer) و شماره سریال داده‌شده.
           این دو گزینه باید با یکدیگر استفاده شوند.  آرگومان issuer باید به
           قالب "/type0=value0/type1=value1/type2=..." قالب‌بندی شود، کاراکترها
           را می‌توان با \ (بک‌اسلش) اسکیپ کرد و هیچ فاصله‌ای نادیده گرفته
           نمی‌شود.  آرگومان serial می‌تواند به صورت یک مقدار ده‌دهی یا در صورت
           همراه بودن با پیشوند "0x" به صورت یک مقدار هگزادسیمال مشخص شود.

       -alias arg
           جستجو برای شیئی که نام مستعار (alias) داده‌شده را دارد.

       -fingerprint arg
           جستجو برای شیئی که دارای اثر انگشت (fingerprint) مشخص‌شده است.

       -digest
           خلاصه پیامی (digest) که برای محاسبه اثر انگشت ارائه‌شده با
           -fingerprint استفاده شده است.

       -engine id
           به «گزینه‌های موتور» (Engine Options) در openssl(1) مراجعه کنید.
           این گزینه منسوخ شده است.

       -provider name
       -provider-path path
       -provparam [name:]key=value
       -propquery propq
           به «گزینه‌های فراهم‌کننده» (Provider Options) در openssl(1)،
           provider(7) و property(7) مراجعه کنید.

همچنین ببینید (SEE ALSO)
       openssl(1)

تاریخچه (HISTORY)
       این دستور در OpenSSL 1.1.1 اضافه شد.

       گزینه -engine در OpenSSL 3.0 منسوخ شد.

حق نشر (COPYRIGHT)
       حق نشر 2016-2024 نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است.

       تحت مجوز آپاچی، نسخه 2.0 ("مجوز") مجوزدهی شده است. شما نمی‌توانید از این
       فایل استفاده کنید مگر با رعایت مفاد مجوز. می‌توانید نسخه‌ای از مجوز را در
       فایل LICENSE در توزیع منبع یا در
       <https://www.openssl.org/source/license.html> دریافت نمایید.

3.6.4                             2026-08-25            OPENSSL-STOREUTL(1ssl)