نام (NAME)

openssl-namedisplay-options - گزینه‌های نمایش نام در OpenSSL

خلاصه دستور (SYNOPSIS)

openssl command [ options ... ] [ parameters ... ]

توضیحات (DESCRIPTION)

ابزار OpenSSL کنترل دقیقی بر نحوه نمایش DNهای موضوع (subject) و صادرکننده (issuer) فراهم می‌کند. این تنظیم با استفاده از گزینه -nameopt مشخص می‌شود که فهرستی از گزینه‌ها را که با کاما از هم جدا شده‌اند، از مجموعه زیر دریافت می‌کند. می‌توان یک علامت منفی ("-") را قبل از یک گزینه قرار داد تا آن را غیرفعال کرد. چهار آرگومان گزینه اول پرکاربردترین‌ها هستند.

مقدار پیش‌فرض به شرح زیر است: "esc_ctrl,utf8,dump_unknown,dump_der,sep_comma_plus_space,sname".

گزینه‌ها (OPTIONS)

آرگومان‌های گزینه قالب نام (Name Format Option Arguments)

قالب خروجی DN را می‌توان با پرچم‌های زیر به طور دقیق تنظیم کرد.

compat: نمایش نام با استفاده از قالب قدیمی مربوط به نسخه‌های قبلی OpenSSL.
RFC2253: نمایش نام با استفاده از قالب تعریف‌شده در RFC 2253. این گزینه معادل esc_2253، esc_ctrl، esc_msb، utf8، dump_nostr، dump_unknown، dump_der، sep_comma_plus، dn_rev و sname است.
oneline: نمایش نام در یک خط، با استفاده از قالبی که خواناتر از RFC 2253 است. این گزینه معادل گزینه‌های esc_2253، esc_ctrl، esc_msb، utf8، dump_nostr، dump_der، use_quote، sep_comma_plus_space، space_eq و sname است.
multiline: نمایش نام با استفاده از چندین خط. این گزینه معادل esc_ctrl، esc_msb، sep_multiline، space_eq، lname و align است.
esc_2253: گریز دادن کاراکترهای "خاص" در یک فیلد، همان‌گونه که توسط RFC 2253 الزامی شده است. یعنی هر یک از کاراکترهای ",+"<>;"، کاراکتر "#" در ابتدای یک رشته و فاصله‌های ابتدایی یا انتهایی.
esc_2254: گریز دادن کاراکترهای "خاص" در یک فیلد همان‌گونه که توسط RFC 2254 الزامی شده است. یعنی کاراکتر NUL و کاراکترهای "()*".
esc_ctrl: گریز دادن کاراکترهای غیرقابل چاپ ASCII، کدهای کمتر از 0x20 (فاصله) یا بیشتر از 0x7F (DELETE). این کاراکترها با استفاده از نمادگذاری "\XX" در RFC 2253 نمایش داده می‌شوند که در آن XX دو رقم هگزادسیمال نشان‌دهنده مقدار کاراکتر است.
esc_msb: گریز دادن هر کاراکتری که باارزش‌ترین بیت (MSB) آن فعال است، یعنی با مقادیر بزرگتر از ۱۲۷، همان‌طور که در esc_ctrl شرح داده شده است.
use_quote: گریز دادن برخی کاراکترها با قرار دادن کل رشته درون علامت‌های نقل قول، """. بدون این گزینه، قبل از تک‌تک کاراکترهای خاص یک کاراکتر بک‌اسلش، "\" قرار می‌گیرد.
utf8: ابتدا تمام رشته‌ها را مطابق با الزامات RFC 2253 به قالب UTF-8 تبدیل می‌کند. اگر دستگاه خروجی با UTF-8 سازگار باشد، استفاده از این گزینه (و تنظیم نکردن esc_msb) می‌تواند نمایش صحیحی از کاراکترهای چندبایتی ارائه دهد. اگر این گزینه تنظیم نشود، کاراکترهای چندبایتی بزرگتر از 0xFF به صورت "\UXXXX" برای ۱۶ بیت یا "\WXXXXXXXX" برای ۳۲ بیت در خروجی نمایش داده می‌شوند. علاوه بر این، هر نوع رشته UTF8String ابتدا به شکل کاراکتری خود تبدیل خواهد شد.
ignore_type: این گزینه به هیچ وجه تلاشی برای تفسیر کاراکترهای چندبایتی نمی‌کند. به این صورت که اکتت‌های محتوا صرفاً به گونه‌ای تخلیه (dump) می‌شوند که گویی یک اکتت نشان‌دهنده هر کاراکتر است. این گزینه برای اهداف تشخیصی مفید است اما خروجی نسبتاً عجیبی ایجاد خواهد کرد.
show_type: نمایش نوع رشته کاراکتری ASN1 پیش از مقدار، مانند "BMPSTRING: Hello World".
dump_der: هر فیلدی که قرار باشد با قالب هگز خروجی داده شود، با استفاده از کدگذاری DER آن فیلد نمایش داده می‌شود. در صورت عدم تنظیم، تنها اکتت‌های محتوا نمایش داده می‌شوند. در هر دو حالت، قالب #XXXX... مربوط به RFC 2253 به کار می‌رود.
dump_nostr: تخلیه (dump) رشته‌های غیرکاراکتری، مانند OCTET STRING در ASN.1. اگر این گزینه تنظیم نشود، انواع رشته‌های غیرکاراکتری به گونه‌ای نمایش داده می‌شوند که گویی هر اکتت محتوا نشان‌دهنده یک کاراکتر منفرد است.
dump_all: تخلیه (dump) تمام فیلدها. هنگامی که این گزینه به همراه dump_der استفاده شود، امکان تعیین کدگذاری DER ساختار بدون هیچ‌گونه ابهامی فراهم می‌شود.
dump_unknown: تخلیه (dump) هر فیلدی که OID آن توسط OpenSSL شناخته نشده باشد.
sep_comma_plus, sep_comma_plus_space, sep_semi_plus_space, sep_multiline: جداکننده‌های فیلد را مشخص می‌کند. کلمه اول بین نام‌های متمایز نسبی (RDNها) و کلمه دوم بین چندین ادعای مقدار ویژگی (AVAها) استفاده می‌شود. استفاده از چندین AVA بسیار نادر است و به کار بردن آن‌ها توصیه نمی‌شود. گزینه‌هایی که به "space" ختم می‌شوند، علاوه بر این، یک فاصله پس از جداکننده قرار می‌دهند تا خواناتر شوند. گزینه sep_multiline هر فیلد را در یک خط جداگانه شروع می‌کند و از "plus space" به عنوان جداکننده AVA استفاده می‌نماید. این گزینه همچنین فیلدها را به اندازه چهار کاراکتر دارای تورفتگی می‌کند. مقدار پیش‌فرض sep_comma_plus_space است.
dn_rev: معکوس کردن فیلدهای DN طبق الزامات RFC 2253. این کار ترتیب چندین AVA را نیز در یک فیلد معکوس می‌کند، اما این امر مجاز است زیرا ترتیبی برای مقادیر تعریف نشده است.
nofname, sname, lname, oid: مشخص کردن نحوه نمایش نام فیلد. nofname فیلد را به هیچ وجه نمایش نمی‌دهد. sname از فرمت "نام کوتاه" استفاده می‌کند (برای مثال CN برای commonName). lname از فرمت طولانی استفاده می‌کند. oid شناسه OID را در قالب عددی نشان می‌دهد و برای اهداف تشخیصی مفید است.
align: تراز کردن مقادیر فیلدها برای خروجی خواناتر. فقط همراه با sep_multiline قابل استفاده است.
space_eq: قرار دادن فاصله در دو طرف کاراکتر علامت مساوی، "="، که پس از نام فیلد می‌آید.

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

openssl(1), openssl-x509(1), openssl-crl(1), openssl-req(1)

حق نشر (COPYRIGHT)

حق نشر 2000-2025 نویسندگان پروژه OpenSSL. تمام حقوق محفوظ است.

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