.\" -*- 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-REHASH 1ssl" .TH OPENSSL-REHASH 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\-rehash \- ایجاد پیوندهای نمادین بر اساس هش گواهی‌ها و CRLها .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBopenssl\fR \&\fBrehash\fR [\fB\-h\fR] [\fB\-help\fR] [\fB\-old\fR] [\fB\-compat\fR] [\fB\-n\fR] [\fB\-v\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] [\fIdirectory\fR] ... .PP \&\fBc_rehash\fR [\fB\-h\fR] [\fB\-help\fR] [\fB\-old\fR] [\fB\-n\fR] [\fB\-v\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] [\fIdirectory\fR] ... .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این دستور به‌طور کلی معادل اسکریپت خارجی .B c_rehash است، به‌جز تفاوت‌های جزئی که در ادامه ذکر شده است. .PP دستور .B "openssl rehash" دایرکتوری‌ها را پیمایش کرده و مقدار هش هر فایل با پسوند \fI.pem\fR، \fI.crt\fR، \fI.cer\fR یا \fI.crl\fR را در فهرست دایرکتوری‌های مشخص‌شده محاسبه می‌کند و برای هر فایل پیوندهای نمادینی می‌سازد که نام هر پیوند همان مقدار هش است. (اگر پلتفرم از پیوندهای نمادین پشتیبانی نکند، یک رونوشت تهیه می‌شود.) این دستور از آنجا کاربرد دارد که بسیاری از برنامه‌های استفاده‌کننده از OpenSSL، برای یافتن گواهی‌ها به چنین ساختاری در دایرکتوری‌ها نیاز دارند. .PP اگر دایرکتوری‌هایی در خط فرمان نام برده شوند، آن دایرکتوری‌ها به نوبت پردازش می‌شوند. در غیر این صورت، متغیر محیطی .B SSL_CERT_DIR بررسی می‌شود؛ این متغیر باید مانند متغیر .B PATH فهرستی از دایرکتوری‌های جداشده با دونقطه (یا نقطه\-ویرگول در ویندوز) باشد. اگر آن متغیر نیز تنظیم نشده باشد، دایرکتوری پیش‌فرض (که وابسته به نوع نصب است اما اغلب \fI/usr/local/ssl/certs\fR می‌باشد) پردازش خواهد شد. .PP برای اینکه یک دایرکتوری پردازش شود، کاربر باید مجوزهای نوشتن روی آن دایرکتوری را داشته باشد، در غیر این صورت خطا ایجاد خواهد شد. .PP پیوندهای ایجادشده به شکل \fIHHHHHHHH.D\fR هستند، که در آن هر \fIH\fR یک نویسه شانزده‌شانزدهی (هگزادسیمال) و \fID\fR یک رقم ده‌دهی تکی است. هنگامی که یک دایرکتوری پردازش می‌شود، تمام پیوندهای درون آن که نامی با این ساختار دارند ابتدا حذف می‌شوند، حتی اگر برای اهداف دیگری استفاده شده باشند. برای صرف‌نظر کردن از مرحله حذف، از گزینه .B \-n استفاده کنید. هش‌های مربوط به CRLها مشابه به نظر می‌رسند، با این تفاوت که حرف \fBr\fR پس از نقطه ظاهر می‌شود، مانند این: \fIHHHHHHHH.\fR\fBr\fR\fID\fR. .PP ممکن است چندین شیء دارای هش یکسان باشند؛ این موارد با افزایش مقدار \fID\fR مشخص می‌شوند. موارد تکراری از طریق مقایسه اثر انگشت کامل SHA\-1 شناسایی می‌شوند. در صورت یافتن مورد تکراری، یک هشدار نمایش داده خواهد شد. .PP همچنین در صورتی که فایل‌هایی وجود داشته باشند که نتوان آن‌ها را به عنوان یک گواهی یا CRL تجزیه کرد، یا اگر بیش از یک شیء از این نوع در فایل ظاهر شود، هشداری نمایش داده خواهد شد. .SS "پیکربندی اسکریپت (Script Configuration)" .IX Subsection "Script Configuration" اسکریپت .B c_rehash از برنامه .B openssl برای محاسبه هش‌ها و اثر انگشت‌ها استفاده می‌کند. اگر این برنامه در .B PATH کاربر یافت نشد، متغیر محیطی .B OPENSSL را روی مسیر کامل آن تنظیم کنید. هر برنامه‌ای را می‌توان استفاده کرد، این برنامه برای گواهی یا CRL به صورت زیر فراخوانی خواهد شد: .PP .Vb 2 \& $OPENSSL x509 \-hash \-fingerprint \-noout \-in FILENAME \& $OPENSSL crl \-hash \-fingerprint \-noout \-in FILENAME .Ve .PP که در آن \fIFILENAME\fR نام فایل است. این برنامه باید هش فایل را در خط اول و اثر انگشت را در خط دوم خروجی دهد، که به صورت اختیاری می‌تواند پیشوندی از مقداری متن و علامت مساوی داشته باشد. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-help\fR \fB\-h\fR" 4 .IX Item "-help -h" نمایش پیام کوتاه راهنمای استفاده از دستور. .IP \fB\-old\fR 4 .IX Item "-old" استفاده از روش هشینگ سبک قدیم (MD5 در برابر SHA\-1) برای تولید پیوندهایی که در نگارش‌های قبل از 1.0.0 استفاده می‌شدند. توجه داشته باشید که نسخه‌های فعلی از سبک قدیم استفاده نخواهند کرد. .IP \fB\-n\fR 4 .IX Item "-n" پیوندهای موجود را حذف نکن. این گزینه هنگامی که پیوندهای سبک قدیم و جدید را در یک دایرکتوری یکسان نگه می‌دارید مورد نیاز است. .IP \fB\-compat\fR 4 .IX Item "-compat" تولید پیوندها برای هر دو روش هش سبک قدیم (MD5) و سبک جدید (SHA1). این کار به نگارش‌های قبل از 1.0.0 اجازه می‌دهد تا از این پیوندها در کنار نگارش‌های جدیدتر استفاده کنند. .IP \fB\-v\fR 4 .IX Item "-v" چاپ پیام‌ها در مورد پیوندهای قدیمی حذف‌شده و پیوندهای جدید ایجادشده. به طور پیش‌فرض، این دستور فقط نام هر دایرکتوری را در حین پردازش فهرست می‌کند. .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 "محیط (ENVIRONMENT)" .IX Header "ENVIRONMENT" .IP \fBOPENSSL\fR 4 .IX Item "OPENSSL" مسیر یک فایل اجرایی که برای تولید هش‌ها و اثر انگشت‌ها استفاده می‌شود (به بالا مراجعه کنید). .IP \fBPATH\fR 4 .IX Item "PATH" فهرستی از مسیرها، جداشده با دونقطه (یا نقطه\-ویرگول در پلتفرم‌های ویندوز)، که در آن‌ها در صورتی که مسیر فایل اجرایی تولیدکننده هش در متغیر محیطی .B OPENSSL ارائه نشده باشد یا قابل استفاده نباشد (یعنی وجود نداشته باشد یا قابل اجرا نباشد)، به دنبال فایل اجرایی .B openssl گشته می‌شود. .IP \fBSSL_CERT_DIR\fR 4 .IX Item "SSL_CERT_DIR" فهرستی از دایرکتوری‌های جداشده با دونقطه برای پردازش روی آن‌ها. در صورتی که دایرکتوری‌ها در خط فرمان ذکر شده باشند، نادیده گرفته می‌شود. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBopenssl\fR\|(1), \&\fBopenssl\-crl\fR\|(1), \&\fBopenssl\-x509\fR\|(1) .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر 2015\-2026 نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است. .PP تحت مجوز آپاچی نسخه 2.0 («مجوز») ارائه شده است. شما مجاز به استفاده از این فایل نیستید مگر با رعایت کامل شرایط مجوز. می‌توانید یک نسخه از مجوز را در فایل LICENSE در بسته توزیع منبع یا در دریافت کنید.