.Dd 2014-05-11
.Dt TINCD 8
.\" Manual page created by:
.\" Ivo Timmermans
.\" Guus Sliepen <guus@tinc-vpn.org>
.Sh "نام (NAME)"
.Nm tincd
.Nd دیمن شبکه خصوصی مجازی (VPN) تینک
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl cdDkKnoLRU
.Op Fl -config Ns = Ns Ar DIR
.Op Fl -no-detach
.Op Fl -debug Ns Op = Ns Ar LEVEL
.Op Fl -kill Ns Op = Ns Ar SIGNAL
.Op Fl -net Ns = Ns Ar NETNAME
.Op Fl -generate-keys Ns Op = Ns Ar BITS
.Op Fl -option Ns = Ns Ar [HOST.]KEY=VALUE
.Op Fl -mlock
.Op Fl -logfile Ns Op = Ns Ar FILE
.Op Fl -pidfile Ns = Ns Ar FILE
.Op Fl -bypass-security
.Op Fl -chroot
.Op Fl -user Ns = Ns Ar USER
.Op Fl -help
.Op Fl -version
.Sh "توضیحات (DESCRIPTION)"
این دیمنِ tinc، یک پروژه شبکه خصوصی مجازی امن
.Pq VPN
است.
هنگام راه‌اندازی،
.Nm
فایل پیکربندی خود را می‌خواند تا مشخص کند به کدام زیرشبکه‌های مجازی باید سرویس‌دهی کند
و به کدام دیمن‌های tinc دیگر باید متصل شود.
این دیمن به دستگاه ethertap یا tun/tap متصل می‌شود
و یک سوکت برای اتصالات ورودی برپا می‌کند.
به‌صورت اختیاری، یک اسکریپت برای پیکربندی بیشتر دستگاه مجازی اجرا خواهد شد.
اگر این کار با موفقیت انجام شود،
از ترمینال کنترلی جدا شده و در پس‌زمینه به کار خود ادامه می‌دهد،
و اتصال‌ها به دیمن‌های tinc دیگر را که بخشی از شبکه خصوصی مجازی هستند پذیرفته و برقرار می‌سازد.
در ویندوز (غیر از Cygwin)، tinc خود را به‌صورت یک سرویس نصب می‌کند
که پس از راه‌اندازی مجدد سیستم به‌طور خودکار اجرا خواهد شد.
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width indent
.It Fl c, -config Ns = Ns Ar DIR
خواندن فایل‌های پیکربندی از
.Ar DIR
به‌جای
.Pa /etc/tinc/ .
.It Fl D, -no-detach
انشعاب نیافتن (عدم fork) و جدا نشدن از ترمینال.
این گزینه همچنین سازوکار راه‌اندازی مجدد خودکار را برای خطاهای مهلک غیرفعال می‌کند.
در صورت عدم تعیین خلاف آن، پیام‌های لاگ روی خروجی خطای استاندارد نمایش داده می‌شوند.
.It Fl d, -debug Ns Op = Ns Ar LEVEL
افزایش سطح اشکال‌زدایی یا تنظیم آن روی
.Ar LEVEL
(بخش زیر را ببینید).
.It Fl k, -kill Ns Op = Ns Ar SIGNAL
تلاش برای خاتمه دادن به یک پردازش در حال اجرای
.Nm
(به‌صورت اختیاری با
.Ar SIGNAL
مشخص‌شده به‌جای SIGTERM) و سپس خروج.
در ویندوز (غیر از Cygwin) آرگومان اختیاری نادیده گرفته شده و سرویس همیشه متوقف و حذف می‌شود.
.It Fl n, -net Ns = Ns Ar NETNAME
اتصال به شبکه
.Ar NETNAME .
این گزینه باعث می‌شود tinc تمام فایل‌های پیکربندی را از
.Pa /etc/tinc/ Ar NETNAME
بخواند.
مشخص کردن
.Li .
برای
.Ar NETNAME
همانند مشخص نکردن هیچ
.Ar NETNAME
است.
.It Fl K, -generate-keys Ns Op = Ns Ar BITS
تولید جفت‌کلید عمومی/خصوصی RSA و خروج.
اگر
.Ar BITS
مشخص نشود، طول پیش‌فرض ۲۰۴۸ بیت خواهد بود.
هنگام ذخیره کلیدها در فایل‌های موجود، tinc کلیدهای قدیمی را حذف نخواهد کرد و باید آن‌ها را به‌صورت دستی پاک کنید.
.It Fl o, -option Ns = Ns Ar [HOST.]KEY=VALUE
بدون مشخص کردن
.Ar HOST ،
این گزینه متغیر پیکربندی سرور
.Ar KEY
را روی
.Ar VALUE
تنظیم می‌کند.
اگر به‌صورت
.Ar HOST.KEY=VALUE
مشخص شود، متغیر پیکربندی میزبان
.Ar KEY
از میزبانی با نام
.Ar HOST
را روی
.Ar VALUE
تنظیم می‌نماید.
این گزینه می‌تواند بیش از یک بار برای تعیین چندین متغیر پیکربندی استفاده شود.
.It Fl L, -mlock
قفل کردن tinc در حافظه اصلی (RAM).
این کار از نوشتن داده‌های حساس مانند کلیدهای خصوصی مشترک در فایل‌ها یا پارتیشن‌های مبادله (swap) سیستم جلوگیری می‌کند.
.It Fl -logfile Ns Op = Ns Ar FILE
نوشتن لاگ‌ها در یک فایل به‌جای ارسال به سرویس لاگ‌گیری سیستم (syslog).
اگر
.Ar FILE
مشخص نشود، مقدار پیش‌فرض
.Pa /var/log/tinc. Ns Ar NETNAME Ns Pa .log
خواهد بود.
.It Fl -pidfile Ns = Ns Ar FILE
نوشتن شناسه پردازش (PID) در
.Ar FILE
به‌جای
.Pa /var/run/tinc. Ns Ar NETNAME Ns Pa .pid.
در ویندوز این گزینه نادیده گرفته می‌شود.
.It Fl -bypass-security
غیرفعال‌سازی رمزنگاری و احراز هویت پروتکل متا (meta protocol).
فقط برای اشکال‌زدایی کاربرد دارد.
.It Fl R, -chroot
با این گزینه، tinc پس از مقداردهی اولیه به دایرکتوری محل قرارگیری پیکربندی شبکه
(/etc/tinc/NETNAME در صورت استفاده از گزینه -n، یا دایرکتوری مشخص‌شده با گزینه -c)
تغییر ریشه (chroot) می‌دهد.
.It Fl U, -user Ns = Ns Ar USER
تغییر شناسه کاربری (setuid) به
.Ar USER
مشخص‌شده پس از مقداردهی اولیه.
.It Fl -help
نمایش فهرست کوتاهی از گزینه‌ها.
.It Fl -version
نمایش اطلاعات نسخه و خروج.
.El
.Sh "سیگنال‌ها (SIGNALS)"
.Bl -tag -width indent
.It ALRM
اجبار
.Nm
به تلاش فوری برای اتصال به تمام آپ‌لینک‌ها (uplinks).
معمولاً
.Nm
خودش سعی در انجام این کار دارد،
اما با هر بار شکست، زمان انتظار بین تلاش‌ها را افزایش می‌دهد،
و اگر
.Nm
در اولین بار پس از راه‌اندازی موفق به اتصال به یک آپ‌لینک نشود،
به‌طور پیش‌فرض حداکثر زمان ۱۵ دقیقه را در نظر می‌گیرد.
.It HUP
بازخوانی جزئی فایل‌های پیکربندی.
اتصال‌ها به میزبان‌هایی که فایل پیکربندی میزبان آن‌ها حذف شده است، بسته می‌شوند.
اتصالات خروجی جدید مشخص‌شده در
.Pa tinc.conf
برقرار خواهند شد.
در صورت استفاده از گزینه
.Fl -logfile ،
این سیگنال همچنین فایل لاگ را بسته و دوباره باز می‌کند که هنگام چرخش لاگ‌ها (log rotation) کاربردی است.
.It INT
افزایش موقت سطح اشکال‌زدایی به ۵.
ارسال مجدد این سیگنال، سطح اشکال‌زدایی را به مقدار اولیه بازمی‌گرداند.
.It USR1
تخلیه فهرست اتصالات در syslog.
.It USR2
تخلیه آمار دستگاه شبکه مجازی و تمام گره‌ها، یال‌ها و زیرشبکه‌های شناخته‌شده در syslog.
.It WINCH
پاکسازی تمام اطلاعات ثبت‌شده درباره گره‌های غیرقابل دسترس.
.El
.Sh "سطوح اشکال‌زدایی (DEBUG LEVELS)"
دیمن tinc می‌تواند پیام‌های زیادی به syslog ارسال کند.
هرچه سطح اشکال‌زدایی بالاتر باشد،
پیام‌های بیشتری ثبت خواهند شد.
هر سطح شامل تمام پیام‌های سطوح قبل از خود نیز می‌شود:
.Bl -tag -width indent
.It 0
پیامی مبنی بر شروع به کار
.Nm
همراه با شماره نسخه ثبت می‌شود.
همچنین هرگونه خطای جدی ثبت خواهد شد.
.It 1
ثبت تمام اتصالاتی که با سایر دیمن‌های tinc برقرار می‌شود.
.It 2
ثبت پیام‌های وضعیت و خطای اسکریپت‌ها و سایر دیمن‌های tinc.
.It 3
ثبت تمام درخواست‌های مبادله‌شده با سایر دیمن‌های tinc. این موارد شامل
احراز هویت، تبادل کلید و به‌روزرسانی فهرست اتصالات است.
.It 4
ثبت یک رونوشت از تمام داده‌های دریافت شده روی سوکت متا (meta socket).
.It 5
ثبت تمام ترافیک شبکه روی شبکه خصوصی مجازی.
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width indent
.It Pa /etc/tinc/
دایرکتوری حاوی فایل‌های پیکربندی مورد استفاده tinc.
برای اطلاعات بیشتر، ببینید:
.Xr tinc.conf 5 .
.It Pa /var/run/tinc. Ns Ar NETNAME Ns Pa .pid
شناسه پردازش (PID) پردازش در حال اجرای
.Nm
در این فایل ذخیره می‌شود.
.El
.Sh "اشکالات (BUGS)"
گزینه
.Va BindToInterface
ممکن است به‌درستی کار نکند.
.Pp
.Sy رمزنگاری در tinc هنوز به‌خوبی آزمایش نشده است. با مسئولیت خود از آن استفاده کنید!
.Pp
در صورت یافتن هرگونه باگ، آن‌ها را به tinc@tinc-vpn.org گزارش دهید.
.Sh "کارهای آینده (TODO)"
موارد بسیار، به‌ویژه ممیزی امنیتی.
.Sh "همچنین ببینید (SEE ALSO)"
.Xr tinc.conf 5 ,
.Pa https://www.tinc-vpn.org ,
.Pa http://www.cabal.org .
.Pp
مستندات کامل tinc به‌صورت یک کتابچه راهنمای Texinfo نگهداری می‌شود.
اگر برنامه‌های info و tinc به‌درستی در سیستم شما نصب شده باشند،
دستور
.Ic info tinc
دسترسی به راهنمای کامل را برای شما فراهم خواهد کرد.
.Pp
نرم‌افزار tinc کاملاً بدون هیچ‌گونه ضمانتی ارائه می‌شود.
این یک نرم‌افزار آزاد است و شما مجاز هستید تحت شرایط خاصی آن را مجدداً توزیع کنید؛
برای جزئیات بیشتر به فایل COPYING مراجعه نمایید.
.Sh "نویسندگان (AUTHORS)"
.An "Ivo Timmermans"
.An "Guus Sliepen" Aq guus@tinc-vpn.org
.Pp
و با تشکر از بسیاری افراد دیگر برای مشارکت‌هایشان در tinc!