'\" t
.\"     Title: tor-gencert
.\"    Author: Tor Project, Inc.
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/25/2026
.\"    Manual: Tor Manual
.\"    Source: Tor
.\"  Language: Persian
.\"
.TH "TOR\-GENCERT" "1" "06/25/2026" "Tor" "Tor Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
tor\-gencert \- تولید گواهی‌ها و کلیدها برای مراجع دایرکتوری تور (Tor)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtor\-gencert\fR [\-h|\-\-help] [\-v] [\-r|\-\-reuse] [\-\-create\-identity\-key] [\-i \fIid_file\fR] [\-c \fIcert_file\fR] [\-m \fInum\fR] [\-a \fIaddress\fR:\fIport\fR]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور
\fBtor\-gencert\fR
گواهی‌ها و کلیدهای خصوصی را برای استفاده توسط مراجع دایرکتوری تور (Tor directory authorities) که از پروتکل دایرکتوری نسخه ۳ تور (مورد استفاده در Tor 0\&.2\&.0 و نسخه‌های بعدی) استفاده می‌کنند، تولید می‌کند\&. اگر یک مرجع دایرکتوری را اجرا نمی‌کنید، نیازی به استفاده از
\fBtor\-gencert\fR
ندارید\&.
.sp
هر مرجع دایرکتوری دارای یک «کلید هویت» (\fIidentity\fR \fIkey\fR) مرجع بلندمدت است (که متمایز از کلید هویتی است که به عنوان سرور تور استفاده می‌کند)؛ این کلید باید به صورت آفلاین در مکانی امن نگهداری شود\&. این کلید برای تایید و صدور «کلیدهای امضا» (\fIsigning\fR \fIkeys\fR) کوتاه‌مدت‌تر به کار می‌رود؛ کلیدهایی که به صورت آنلاین نگهداری شده و توسط مرجع دایرکتوری برای امضای رای‌ها و اسناد اجماع استفاده می‌شوند\&.
.sp
پس از استفاده از این برنامه برای تولید کلید امضا و گواهی، آن فایل‌ها را در زیرپوشه keys فرآیند تور خود کپی کرده و سیگنال SIGHUP را به تور ارسال کنید\&. کلید هویت را هرگز کپی نکنید (DO NOT COPY THE IDENTITY KEY)\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-v\fR
.RS 4
نمایش خروجی با جزئیات کامل (verbose)\&.
.RE
.PP
\fB\-h\fR یا \fB\-\-help\fR
.RS 4
نمایش متن راهنما و خروج\&.
.RE
.PP
\fB\-r\fR یا \fB\-\-reuse\fR
.RS 4
تولید یک گواهی جدید، بدون ایجاد کلید امضای جدید\&. این گزینه می‌تواند برای تغییر آدرس یا طول عمر مرتبط با یک کلید مشخص به کار رود\&.
.RE
.PP
\fB\-\-create\-identity\-key\fR
.RS 4
تولید یک کلید هویت جدید\&. این گزینه را تنها باید در اولین باری که
\fBtor\-gencert\fR
را اجرا می‌کنید به کار ببرید؛ در آینده، باید از همان کلید هویتی که از قبل موجود است استفاده کنید\&.
.RE
.PP
\fB\-i\fR \fIFILENAME\fR
.RS 4
خواندن کلید هویت از فایل مشخص‌شده\&. اگر فایل موجود نباشد و گزینه
\fB\-\-create\-identity\-key\fR
مشخص شده باشد، کلید هویت در این فایل ایجاد می‌شود\&. مقدار پیش‌فرض:
"\&./authority_identity_key"
.RE
.PP
\fB\-s\fR \fIFILENAME\fR
.RS 4
نوشتن کلید امضا در فایل مشخص‌شده\&. مقدار پیش‌فرض:
"\&./authority_signing_key"
.RE
.PP
\fB\-c\fR \fIFILENAME\fR
.RS 4
نوشتن گواهی در فایل مشخص‌شده\&. مقدار پیش‌فرض:
"\&./authority_certificate"
.RE
.PP
\fB\-m\fR \fINUM\fR
.RS 4
تعداد ماه‌هایی که گواهی باید معتبر باشد\&. مقدار پیش‌فرض: 12\&.
.RE
.PP
\fB\-\-passphrase\-fd\fR \fIFILEDES\fR
.RS 4
توصیف‌گر فایل (file descriptor) برای خواندن عبارت عبور (passphrase)\&. خواندن در اولین نویسه NUL یا خط جدید پایان می‌یابد\&. پیش‌فرض: خواندن از ترمینال\&.
.RE
.PP
\fB\-a\fR \fIaddress\fR:\fIport\fR
.RS 4
در صورت تعیین، ترکیب
.I address:port
به عنوان پورت دایرکتوری ترجیحی این مرجع در گواهی آن اعلان می‌شود\&. اگر آدرس یک نام هاست (hostname) باشد، نام هاست قبل از انتشار به یک آدرس IP تبدیل (resolve) می‌شود\&.
.RE
.SH "اشکالات (BUGS)"
.sp
این برنامه احتمالاً روی ویندوز اجرا نمی‌شود\&. این مسئله بزرگی نیست، زیرا به هر حال ترجیح داده نمی‌شود که مراجع دایرکتوری روی ویندوز اجرا شوند\&.
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBtor\fR(1)
.sp
همچنین فایل "dir\-spec\&.txt" را که همراه با تور توزیع شده است ببینید\&.
.SH "نویسنده (AUTHOR)"
.PP
\fBTor Project, Inc\&.\fR
.RS 4
نویسنده.
.RE