.TH git-annex-p2p 1
.SH "نام (NAME)"
git-annex-p2p \- پیکربندی شبکه‌های همتا‌به‌همتا
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex p2p [\fIگزینه‌ها\fR]
.PP
.SH "توضیحات (DESCRIPTION)"
این دستور می‌تواند برای پیوند دادن مخازن git-annex از طریق شبکه‌های همتا‌به‌همتا (P2P) استفاده شود.
.PP
ابزار git-annex شامل پشتیبانی داخلی برای استفاده از سرویس‌های مخفی Tor به‌عنوان یک شبکه P2P است. (این مورد نیازمند نصب بودن Tor است.)
.PP
همچنین git-annex می‌تواند با استفاده از یک برنامه کمکی که نصب می‌کنید، از سایر شبکه‌های P2P نیز پشتیبانی کند. این برنامه‌ها نام‌هایی به فرم
\fBgit-annex\-p2p\-<netname>\fP
دارند. برای جزئیات بیشتر پیوند زیر را ببینید:
<https://git-annex.branchable.com/special_remotes/p2p>
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-enable <netname>\fP"
.IP
استفاده از شبکه P2P با نام مشخص‌شده را فعال می‌کند.
.IP
برای شبکه‌هایی غیر از tor، لازم است برنامه کمکی
\fBgit-annex\-p2p\-<netname>\fP
نصب شده باشد.
.IP
پس از اجرای این دستور، می‌توان
\fBgit annex remotedaemon\fP
را برای پاسخ‌گویی به اتصال‌های ورودی از سوی همتاها (peers) اجرا کرد، و دستورات
\fBgit-annex p2p \-\-pair\fP
یا
\fBgit-annex p2p \-\-gen\-addresses\fP
را اجرا نمود تا به سایر کاربران امکان دسترسی به مخزن شما از طریق شبکه P2P داده شود.
.IP
.IP "\fB\-\-pair\fP"
این گزینه را در دو مخزن اجرا کنید تا آن‌ها را از طریق شبکه P2P با یکدیگر جفت (pair) کند.
.IP
این دستور یک عبارت رمزی مانند "3\-mango\-elephant" را چاپ می‌کند و از شما می‌خواهد که عبارت رمزی دریافت شده از مخزن دیگر را وارد کنید.
.IP
پس از تبادل عبارات رمزی، دو مخزن با یکدیگر جفت خواهند شد. یک ریموت گیت (git remote) با نامی مانند "peer1" برای مخزن دیگر ایجاد می‌شود.
.IP
این قابلیت از Magic Wormhole به نشانی:
<https://github.com/warner/magic-wormhole>
برای تایید عبارات رمزی و برقراری ارتباط امن آدرس‌های P2P مخازن استفاده می‌کند، بنابراین باید روی هر دو رایانه‌ای که قرار است با هم جفت شوند نصب شده باشد.
.IP
این ویژگی در نسخه‌های git-annex پیش از نسخه 6.20180705 به‌صورت معیوب وجود داشت. اطمینان حاصل کنید که یک نسخه به اندازه کافی جدید از git-annex روی هر دو رایانه جفت‌شونده نصب شده باشد.
.IP
.IP "\fB\-\-gen\-addresses\fP"
آدرس‌هایی را تولید می‌کند که می‌توان از آن‌ها برای دسترسی به این مخزن git-annex از طریق شبکه‌های P2P موجود استفاده کرد. آدرس یا آدرس‌ها در خروجی استاندارد (stdout) نمایش داده می‌شوند.
.IP
توجه داشته باشید هر کسی که این آدرس‌ها را بداند می‌تواند از طریق شبکه‌های P2P به مخزن شما دسترسی پیدا کند.
.IP
این دستور را می‌توان چندین بار اجرا کرد تا آدرس‌های مختلفی را به افراد مختلف اختصاص داد.
.IP
.IP "\fB\-\-link\fP"
یک ریموت گیت را پیکربندی می‌کند که از طریق شبکه P2P در دسترس قرار می‌گیرد.
.IP
این گزینه از شما می‌خواهد آدرسی را وارد کنید؛ باید آدرسی را که توسط
\fB\-\-gen\-addresses\fP
در مخزن راه دور تولید شده است الصاق کنید.
.IP
به‌طور پیش‌فرض نام ریموت گیت برابر با "peer1" یا "peer2" و مانند آن قرار می‌گیرد. این مقدار را می‌توان با گزینه
\fB\-\-name\fP
تغییر داد.
.IP
.IP "\fB\-\-name\fP"
نامی را برای استفاده هنگام راه‌اندازی ریموت گیت با
\fB\-\-link\fP
یا
\fB\-\-pair\fP
مشخص می‌کند.
.IP
.IP "همچنین گزینه‌های \fBgit-annex\-common\-options\fP(1) نیز قابل استفاده هستند."
.SH "همچنین ببینید (SEE ALSO)"
git-annex(1)
.PP
git-annex\-enable\-tor(1)
.PP
git-annex\-remotedaemon(1)
.PP
wormhole(1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>
.PP