.\" -*- 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-NAMEDISPLAY-OPTIONS 1ssl" .TH OPENSSL-NAMEDISPLAY-OPTIONS 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\-namedisplay\-options \- گزینه‌های نمایش نام در OpenSSL .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBopenssl\fR \&\fIcommand\fR [ \fIoptions\fR ... ] [ \fIparameters\fR ... ] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" ابزار OpenSSL کنترل دقیقی بر نحوه نمایش DNهای موضوع (subject) و صادرکننده (issuer) فراهم می‌کند. این تنظیم با استفاده از گزینه \fB\-nameopt\fR مشخص می‌شود که فهرستی از گزینه‌ها را که با کاما از هم جدا شده‌اند، از مجموعه زیر دریافت می‌کند. می‌توان یک علامت منفی (\f(CW\*(C`\-\*(C'\fR) را قبل از یک گزینه قرار داد تا آن را غیرفعال کرد. چهار آرگومان گزینه اول پرکاربردترین‌ها هستند. .PP مقدار پیش‌فرض به شرح زیر است: \&\f(CW\*(C`esc_ctrl,utf8,dump_unknown,dump_der,sep_comma_plus_space,sname\*(C'\fR. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .SS "آرگومان‌های گزینه قالب نام (Name Format Option Arguments)" .IX Subsection "Name Format Option Arguments" قالب خروجی DN را می‌توان با پرچم‌های زیر به طور دقیق تنظیم کرد. .IP \fBcompat\fR 4 .IX Item "compat" نمایش نام با استفاده از قالب قدیمی مربوط به نسخه‌های قبلی OpenSSL. .IP \fBRFC2253\fR 4 .IX Item "RFC2253" نمایش نام با استفاده از قالب تعریف‌شده در RFC 2253. این گزینه معادل \fBesc_2253\fR، \fBesc_ctrl\fR، \fBesc_msb\fR، \fButf8\fR، \&\fBdump_nostr\fR، \fBdump_unknown\fR، \fBdump_der\fR، \fBsep_comma_plus\fR، \fBdn_rev\fR و \fBsname\fR است. .IP \fBoneline\fR 4 .IX Item "oneline" نمایش نام در یک خط، با استفاده از قالبی که خواناتر از RFC 2253 است. این گزینه معادل گزینه‌های \fBesc_2253\fR، \fBesc_ctrl\fR، \fBesc_msb\fR، \fButf8\fR، \&\fBdump_nostr\fR، \fBdump_der\fR، \fBuse_quote\fR، \fBsep_comma_plus_space\fR، \&\fBspace_eq\fR و \fBsname\fR است. .IP \fBmultiline\fR 4 .IX Item "multiline" نمایش نام با استفاده از چندین خط. این گزینه معادل \fBesc_ctrl\fR، \fBesc_msb\fR، \fBsep_multiline\fR، \fBspace_eq\fR، \&\fBlname\fR و \fBalign\fR است. .IP \fBesc_2253\fR 4 .IX Item "esc_2253" گریز دادن کاراکترهای "خاص" در یک فیلد، همان‌گونه که توسط RFC 2253 الزامی شده است. یعنی هر یک از کاراکترهای \f(CW\*(C`,+"<>;\*(C'\fR، کاراکتر \f(CW\*(C`#\*(C'\fR در ابتدای یک رشته و فاصله‌های ابتدایی یا انتهایی. .IP \fBesc_2254\fR 4 .IX Item "esc_2254" گریز دادن کاراکترهای "خاص" در یک فیلد همان‌گونه که توسط RFC 2254 الزامی شده است. یعنی کاراکتر \fBNUL\fR و کاراکترهای \f(CW\*(C`()*\*(C'\fR. .IP \fBesc_ctrl\fR 4 .IX Item "esc_ctrl" گریز دادن کاراکترهای غیرقابل چاپ ASCII، کدهای کمتر از 0x20 (فاصله) یا بیشتر از 0x7F (DELETE). این کاراکترها با استفاده از نمادگذاری \f(CW\*(C`\eXX\*(C'\fR در RFC 2253 نمایش داده می‌شوند که در آن \fBXX\fR دو رقم هگزادسیمال نشان‌دهنده مقدار کاراکتر است. .IP \fBesc_msb\fR 4 .IX Item "esc_msb" گریز دادن هر کاراکتری که باارزش‌ترین بیت (MSB) آن فعال است، یعنی با مقادیر بزرگتر از ۱۲۷، همان‌طور که در \fBesc_ctrl\fR شرح داده شده است. .IP \fBuse_quote\fR 4 .IX Item "use_quote" گریز دادن برخی کاراکترها با قرار دادن کل رشته درون علامت‌های نقل قول، \f(CW\*(C`"\*(C'\fR. بدون این گزینه، قبل از تک‌تک کاراکترهای خاص یک کاراکتر بک‌اسلش، \f(CW\*(C`\e\*(C'\fR قرار می‌گیرد. .IP \fButf8\fR 4 .IX Item "utf8" ابتدا تمام رشته‌ها را مطابق با الزامات RFC 2253 به قالب UTF\-8 تبدیل می‌کند. اگر دستگاه خروجی با UTF\-8 سازگار باشد، استفاده از این گزینه (و تنظیم نکردن \fBesc_msb\fR) می‌تواند نمایش صحیحی از کاراکترهای چندبایتی ارائه دهد. اگر این گزینه تنظیم نشود، کاراکترهای چندبایتی بزرگتر از 0xFF به صورت \f(CW\*(C`\eUXXXX\*(C'\fR برای ۱۶ بیت یا \f(CW\*(C`\eWXXXXXXXX\*(C'\fR برای ۳۲ بیت در خروجی نمایش داده می‌شوند. علاوه بر این، هر نوع رشته UTF8String ابتدا به شکل کاراکتری خود تبدیل خواهد شد. .IP \fBignore_type\fR 4 .IX Item "ignore_type" این گزینه به هیچ وجه تلاشی برای تفسیر کاراکترهای چندبایتی نمی‌کند. به این صورت که اکتت‌های محتوا صرفاً به گونه‌ای تخلیه (dump) می‌شوند که گویی یک اکتت نشان‌دهنده هر کاراکتر است. این گزینه برای اهداف تشخیصی مفید است اما خروجی نسبتاً عجیبی ایجاد خواهد کرد. .IP \fBshow_type\fR 4 .IX Item "show_type" نمایش نوع رشته کاراکتری ASN1 پیش از مقدار، مانند \f(CW\*(C`BMPSTRING: Hello World\*(C'\fR. .IP \fBdump_der\fR 4 .IX Item "dump_der" هر فیلدی که قرار باشد با قالب هگز خروجی داده شود، با استفاده از کدگذاری DER آن فیلد نمایش داده می‌شود. در صورت عدم تنظیم، تنها اکتت‌های محتوا نمایش داده می‌شوند. در هر دو حالت، قالب \fB#XXXX...\fR مربوط به RFC 2253 به کار می‌رود. .IP \fBdump_nostr\fR 4 .IX Item "dump_nostr" تخلیه (dump) رشته‌های غیرکاراکتری، مانند \fBOCTET STRING\fR در ASN.1. اگر این گزینه تنظیم نشود، انواع رشته‌های غیرکاراکتری به گونه‌ای نمایش داده می‌شوند که گویی هر اکتت محتوا نشان‌دهنده یک کاراکتر منفرد است. .IP \fBdump_all\fR 4 .IX Item "dump_all" تخلیه (dump) تمام فیلدها. هنگامی که این گزینه به همراه \fBdump_der\fR استفاده شود، امکان تعیین کدگذاری DER ساختار بدون هیچ‌گونه ابهامی فراهم می‌شود. .IP \fBdump_unknown\fR 4 .IX Item "dump_unknown" تخلیه (dump) هر فیلدی که OID آن توسط OpenSSL شناخته نشده باشد. .IP "\fBsep_comma_plus\fR, \fBsep_comma_plus_space\fR, \fBsep_semi_plus_space\fR, \fBsep_multiline\fR" 4 .IX Item "sep_comma_plus, sep_comma_plus_space, sep_semi_plus_space, sep_multiline" جداکننده‌های فیلد را مشخص می‌کند. کلمه اول بین نام‌های متمایز نسبی (RDNها) و کلمه دوم بین چندین ادعای مقدار ویژگی (AVAها) استفاده می‌شود. استفاده از چندین AVA بسیار نادر است و به کار بردن آن‌ها توصیه نمی‌شود. گزینه‌هایی که به "space" ختم می‌شوند، علاوه بر این، یک فاصله پس از جداکننده قرار می‌دهند تا خواناتر شوند. گزینه \fBsep_multiline\fR هر فیلد را در یک خط جداگانه شروع می‌کند و از "plus space" به عنوان جداکننده AVA استفاده می‌نماید. این گزینه همچنین فیلدها را به اندازه چهار کاراکتر دارای تورفتگی می‌کند. مقدار پیش‌فرض \fBsep_comma_plus_space\fR است. .IP \fBdn_rev\fR 4 .IX Item "dn_rev" معکوس کردن فیلدهای DN طبق الزامات RFC 2253. این کار ترتیب چندین AVA را نیز در یک فیلد معکوس می‌کند، اما این امر مجاز است زیرا ترتیبی برای مقادیر تعریف نشده است. .IP "\fBnofname\fR, \fBsname\fR, \fBlname\fR, \fBoid\fR" 4 .IX Item "nofname, sname, lname, oid" مشخص کردن نحوه نمایش نام فیلد. \&\fBnofname\fR فیلد را به هیچ وجه نمایش نمی‌دهد. \&\fBsname\fR از فرمت "نام کوتاه" استفاده می‌کند (برای مثال CN برای commonName). \&\fBlname\fR از فرمت طولانی استفاده می‌کند. \&\fBoid\fR شناسه OID را در قالب عددی نشان می‌دهد و برای اهداف تشخیصی مفید است. .IP \fBalign\fR 4 .IX Item "align" تراز کردن مقادیر فیلدها برای خروجی خواناتر. فقط همراه با \&\fBsep_multiline\fR قابل استفاده است. .IP \fBspace_eq\fR 4 .IX Item "space_eq" قرار دادن فاصله در دو طرف کاراکتر علامت مساوی، \f(CW\*(C`=\*(C'\fR، که پس از نام فیلد می‌آید. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBopenssl\fR\|(1), \&\fBopenssl\-x509\fR\|(1), \&\fBopenssl\-crl\fR\|(1), \&\fBopenssl\-req\fR\|(1) .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر 2000\-2025 نویسندگان پروژه OpenSSL. تمام حقوق محفوظ است. .PP تحت مجوز آپاچی، نسخه 2.0 ("مجوز") مجوزدهی شده است. شما نمی‌توانید از این فایل استفاده کنید مگر با رعایت مجوز. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE در توزیع مبدا یا در دریافت کنید.