.TH "ZEROTIER\-IDTOOL" "1" "December 2016" "" ""
.SH "نام (NAME)"
zerotier\-idtool \- ابزاری برای ایجاد و دستکاری شناسه‌های ZeroTier
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBzerotier\-idtool\fP <command> [args]
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBzerotier\-idtool\fR یک ابزار خط فرمان برای کار با شناسه‌های ZeroTier است\. یک شناسه ZeroTier شامل یک جفت کلید عمومی/خصوصی (یا تنها کلید عمومی در صورتی که فقط identity\.public باشد) و یک نشانی ۱۰ رقمی هگزادسیمال ZeroTier است که از کلید عمومی از طریق یک تابع درهم‌ساز مبتنی بر اثبات کار مشتق می‌شود\.
.SH "دستورات (COMMANDS)"
.P
هنگامی که آرگومان‌های دستور نیازمند یک شناسه عمومی یا محرمانه (کامل) باشند، شناسه می‌تواند به‌صورت مسیر یک فایل یا مستقیماً در خط فرمان مشخص شود\.
.RS 0
.IP \(bu 2
\fBhelp\fP:
نمایش راهنما\. (اجرای بدون دستور نیز این کار را انجام می‌دهد\.)
.IP \(bu 2
\fBgenerate\fP [secret file] [public file] [vanity]:
تولید یک شناسه جدید ZeroTier\. اگر یک فایل محرمانه مشخص شود، شناسه کامل شامل کلید خصوصی درون این فایل نوشته خواهد شد\. اگر فایل عمومی مشخص شود، بخش عمومی در آنجا نوشته می‌شود\. اگر هیچ مسیر فایلی مشخص نشود، شناسه محرمانه کامل به STDOUT ارسال می‌شود\. پیشوند سفارشی (vanity) رشته‌ای از ارقام هگزادسیمال است که نشانی شناسه تولیدشده باید با آن آغاز شود\. معمولاً از این ویژگی استفاده نمی‌شود، و در صورت مشخص شدن آن، فرآیند تولید به دلیل هزینه ذاتی ایجاد شناسه‌ها با تابع اثبات کار ممکن است زمان بسیار زیادی ببرد\. تولید یک شناسه با یک پیشوند مشخص ۱۶ بیتی (۴ رقم) روی یک پردازنده 2\.8ghz Core i5 (با استفاده از یک هسته) به طور میانگین دو ساعت طول می‌کشد\.
.IP \(bu 2
\fBvalidate\fP <identity, only public part required>:
اعتبارسنجی محلی کلید شناسه و انطباق تابع اثبات کار آن\.
.IP \(bu 2
\fBgetpublic\fP <full identity with secret>:
استخراج بخش عمومی از یک identity\.secret و چاپ آن در STDOUT\.
.IP \(bu 2
\fBsign\fP <full identity with secret> <file to sign>:
امضای محتوای یک فایل با الگوریتم SHA512+ECC\-256 (ed25519)\. امضا در قالب هگزادسیمال به STDOUT ارسال می‌شود\.
.IP \(bu 2
\fBverify\fP <identity, only public part required> <file to check> <signature in hex>:
اعتبارسنجی امضای ایجادشده با \fBsign\fP\|\.
.IP \(bu 2
\fBmkcom\fP <full identity with secret> [id,value,maxdelta] [\|\.\.\.]:
ایجاد و امضای یک گواهی عضویت شبکه\. این قابلیت معمولاً کاربرد عمومی ندارد زیرا کنترل‌کننده‌های شبکه این کار را به صورت خودکار انجام می‌دهند و بیشتر برای اهداف آزمایشی قرار داده شده است\.

.RE
.SH "مثال‌ها (EXAMPLES)"
.P
تولید و نمایش یک شناسه جدید:
.P
.RS 2
.nf
$ zerotier\-idtool generate
.fi
.RE
.P
تولید و نوشتن یک شناسه جدید، شامل هر دو بخش محرمانه و عمومی:
.P
.RS 2
.nf
$ zerotier\-idtool generate identity\.secret identity\.public
.fi
.RE
.P
تولید یک نشانی سفارشی که با ارقام هگزادسیمال "beef" آغاز می‌شود (این عملیات مدتی طول خواهد کشید!):
.P
.RS 2
.nf
$ zerotier\-idtool generate beef\.secret beef\.public beef
.fi
.RE
.P
امضای یک فایل با کلید محرمانه یک شناسه:
.P
.RS 2
.nf
$ zerotier\-idtool sign identity\.secret last_will_and_testament\.txt
.fi
.RE
.P
اعتبارسنجی امضای یک فایل با یک کلید عمومی:
.P
.RS 2
.nf
$ zerotier\-idtool verify identity\.public last_will_and_testament\.txt
.fi
.RE
.SH "حق نشر (COPYRIGHT)"
.P
(c)2011\-2016 ZeroTier, Inc\. \-\- https://www\.zerotier\.com \-\- https://github\.com/zerotier
.SH "همچنین ببینید (SEE ALSO)"
.P
zerotier\-one(8), zerotier\-cli(1)