.TH ZNC 1 2010\-05\-10 ZNC
.SH "نام (NAME)"
znc \- یک بانسِر (bouncer) پیشرفته برای IRC
.SH "خلاصه دستور (SYNOPSIS)"
.B znc \-\-help
.br
.B znc \-\-version
.br
.B znc \-\-makepass
.br
.B znc
.RB [ \-n ]
.RB [ \-d
.IR datadir ]
.RB [ \-D ]
.RB [ \-f ]
.br
.B znc
.RB [ \-n ]
.RB [ \-d
.IR datadir ]
.RB [ \-D ]
.RB [ \-f ]
.B \-\-makeconf
.br
.B znc
.RB [ \-n ]
.RB [ \-d
.IR datadir ]
.RB [ \-D ]
.RB [ \-f ]
.B \-\-makepem
.SH "توضیحات (DESCRIPTION)"
.B znc
یک پروکسی IRC است.
این برنامه به عنوان یک دیمن (daemon) اجرا شده و به سرور IRC متصل می‌شود، سپس به شما اجازه می‌دهد تا از یک ایستگاه کاری متصل شوید و به عنوان کاربری که به سرور IRC وارد شده است فعالیت کنید.
پس از قطع اتصال شما، این برنامه ارتباط با سرور را حفظ می‌کند.
این برنامه مانند یک سرور عادی IRC عمل می‌کند، بنابراین می‌توانید از هر کلاینت IRC برای اتصال به آن استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-h ", " \-\-help
نمایش یک پیام راهنمای کوتاه.
.TP
.BR \-v ", " \-\-version
نمایش شمارهٔ کامل نسخه.
.TP
.BR \-n ", " \-\-no-color
عدم استفاده از توالی‌های گریز رنگی.
.TP
.BR \-f ", " \-\-foreground
فرآیند ZNC را به پس‌زمینه فورک (fork) نمی‌کند.
.TP
.BR \-D ", " \-\-debug
چاپ خروجی اشکال‌زدایی در کنسول. مستلزم
.BR \-\-foreground
است.
.TP
.BI \-d " DATADIR" "\fR,\fP \-\-datadir=" DATADIR
مشخص کردن یک datadir دیگر.
اینجاست که
.B znc
همه‌چیز را ذخیره می‌کند.
.TP
.BR \-c ", " \-\-makeconf
ایجاد تعاملی یک پیکربندی جدید.
.TP
.BR \-s ", " \-\-makepass
درهم‌سازی (هش کردن) یک گذرواژه برای استفاده در
.IR znc.conf .
.TP
.BR \-p ", " \-\-makepem
تولید
.IR znc.pem .
این گواهی سروری است که
.B znc
استفاده می‌کند.
برای SSL به این گواهی نیاز دارید.
.TP
.BR \-r ", " \-\-allow-root
در صورتی که ZNC با دسترسی‌های ریشه (root) اجرا شود، هشداری داده نشود.
.SH "سیگنال‌ها (SIGNALS)"
این بخش نحوهٔ واکنش
.B znc
به سیگنال‌های مختلف را توضیح می‌دهد:
.TP
.B SIGINT
خروج از ZNC. این معادل با
.I /znc shutdown
است.
.TP
.B SIGHUP
بارگذاری مجدد znc.conf. این معادل با
.I /znc rehash
است.
.B این کار را
به‌طور مکرر انجام ندهید، ممکن است اوضاع به شدت خراب شود!
.TP
.B SIGUSR1
بازنویسی znc.conf. این معادل با
.I /znc saveconfig
است.
.SH "فایل‌ها (FILES)"
.TP
.I /usr/local/share/znc/
داده‌های ایستا ماژول مانند پوسته‌های webadmin.
.TP
.I /usr/local/lib/znc/
.B znc
ماژول‌های خود را در این دایرکتوری نصب می‌کند.
.TP
.I /usr/local/include/znc/
این‌ها سرآیندهای مورد نیاز برای کامپایل ماژول‌های اختصاصی هستند.
.TP
.I ~/.znc
این datadir پیش‌فرض است. مسیرهای زیر با فرض استفاده از این مسیر ذکر شده‌اند.
اگر این دایرکتوری را با
.I \-\-datadir
تغییر دهید، مسیرهای زیر نسبت به آن دایرکتوری خواهند بود.
.TP
.I ~/.znc/znc.pem
این گواهی سروری است که
.B znc
برای گوش دادن روی پورت‌های SSL استفاده می‌کند.
می‌توانید آن را از طریق
.I \-\-makepem
تولید کنید و در صورت تمایل، می‌توانید آن را با گواهی خود جایگزین نمایید.
.TP
.I ~/.znc/modules/
اگر ماژول‌های خودتان را کامپایل کنید، می‌توانید آن‌ها را اینجا ذخیره کنید.
.TP
.I ~/.znc/configs/znc.conf
این مسیر فایل
.IR znc.conf
است. برای روشی آسان جهت تولید آن از
.I \-\-makeconf
استفاده کنید.
.TP
.IB ~/.znc/users/ USERNAME /
داده‌های هر کاربر در این دایرکتوری ذخیره می‌شود.
.B USERNAME
به نام کاربری آن کاربر اشاره دارد.
.TP
.IB ~/.znc/users/ USERNAME /moddata/ MODULENAME /
اینجا جایی است که هر ماژول می‌تواند برخی داده‌ها را ذخیره کند. این بخش عمدتاً برای به خاطر سپردن تنظیمات ماژول که بخشی از
.IR znc.conf
نیستند استفاده می‌شود.
.TP
.IB ~/.znc/moddata/ MODULENAME /
اینجا جایی است که ماژول‌های سراسری (global) می‌توانند تنظیمات خود را ذخیره کنند.
.SH "همچنین ببینید (SEE ALSO)"
.BR znc-buildmod (1)
.PP
مستندات کامل در:
.I https://znc.in