.Dd April 22, 1999 .Dt EPIC 1 .Sh "نام (NAME)" .Nm epic .Nd کلاینت گفتگوی رله اینترنتی (IRC) برای سیستم‌های شبه‌یونیکس .Sh "خلاصه دستور (SYNOPSIS)" .Nm epic .Op Ar \-a .Op Ar \-b .Op Ar \-B .Op Ar \-c chan .Op Ar \-d .Op Ar \-f .Op Ar \-F .Op Ar \-h .Op Ar \-H hostname .Op Ar \-l filename .Op Ar \-L filename .Op Ar \-n nickname .Op Ar \-o .Op Ar \-O .Op Ar \-p port .Op Ar \-q .Op Ar \-v .Op Ar \-x .Op Ar \-z username .Op Ar nickname .Op Ar server description list .Sh "توضیحات (DESCRIPTION)" برنامه .Nm ircII/EPIC یک عامل کاربر («کلاینت») مبتنی بر نویسه و تحت یونیکس برای گفتگوی رله اینترنتی (IRC) است. این برنامه یک کلاینت کاملاً کاربردی ircII به همراه قابلیت‌های افزوده و مفید متعددی است. این نسخه با تمام رده‌های مدرن سرورهای IRC در اوایل سال ۱۹۹۹ سازگار است. .Pp .Sh "گزینه‌ها (OPTIONS)" .Bl -tag -width flag .It Fl a فهرست توصیف سرور را به انتهای فهرست پیش‌فرض سرورها اضافه می‌کند. رفتار پیش‌فرض به این صورت است که فهرست توصیف سرور جایگزین فهرست پیش‌فرض سرورها می‌شود. .It Fl b در حالت اصطلاحاً .Dq bot mode (حالت ربات) کار می‌کند. این گزینه متضمن گزینه .Op Ar \-d است. برنامه EPIC بی‌درنگ از طریق .Xr fork 2 منشعب می‌شود و فرآیند والد خارج خواهد شد و شما را به شل بازمی‌گرداند. برخی از مدیران سیستم به اجرای ربات‌ها توسط کاربران خود به دید خوبی نگاه نمی‌کنند و این گزینه را غیرفعال کرده‌اند. حتی اگر مدیر سیستم شما آن را غیرفعال نکرده باشد، نباید تصور کنید که این امر به منزله مجوز خودکار برای اجرای ربات است. اگر بدون مجوز ربات اجرا کنید، ممکن است مدیر سیستم از شما بسیار ناراحت شده و احتمالاً حسابتان را لغو کند. علاوه بر این، بیشتر گردانندگان IRC (اپراتورها) در شبکه‌های عمومی IRC مدارای بسیار کمی با افرادی دارند که ربات اجرا می‌کنند. بنابراین به عنوان یک هشدار، پیش از اجرای ربات اطمینان حاصل کنید که مدیر سیستم و مدیر IRC به شما اجازه داده‌اند. .It Fl B بارگذاری فایل راه‌اندازی (startup) را بلافاصله اجبار می‌کند، به جای آنکه تا زمان برقراری اتصال به سرور منتظر بماند. .It Fl c Ar chan در اولین باری که با موفقیت به یک سرور متصل شدید، به کانال مشخص‌شده ملحق می‌شود. .It Fl d در .Dq dumb mode (حالت ساده و بدون نمایشگر تمام‌صفحه) کار می‌کند. کلاینت نمایش تمام‌صفحه ایجاد نخواهد کرد و از ورودی استاندارد خوانده و در خروجی استاندارد می‌نویسد. این حالت در صورتی مفید است که خروجی در حالت عادی ظاهر نامناسبی داشته باشد (زیرا از تنظیم نادرست .Ev TERM استفاده می‌کنید یا توصیف ترمینال شما به طرز چشمگیری خراب است)، یا صرفاً نمی‌خواهید از رابط کاربری گرافیکی یا تمام‌صفحه استفاده کنید. اگر مقدار فعلی .Ev TERM شما قادر به نمایش تمام‌صفحه نباشد، این گزینه به طور خودکار فعال خواهد شد. .It Fl f استفاده از کنترل جریان سخت‌افزاری را اجبار می‌کند. با این گزینه، کلیدهای control-S و control-Q احتمالاً برای انتساب به کارهای دیگر در دسترس نخواهند بود. .It Fl F استفاده از کنترل جریان سخت‌افزاری را غیرفعال می‌کند. با این گزینه، کلیدهای control-S و control-Q برای انتساب به کارهای دیگر در دسترس خواهند بود. با این حال، کنترل جریان سخت‌افزاری نخواهید داشت. .It Fl h پیام راهنمای نسبتاً مختصر را نمایش داده و بی‌درنگ خارج می‌شود. .It Fl H Ar hostname از آدرس IP نام میزبان (hostname) مشخص‌شده به عنوان آدرس IP پیش‌فرض شما استفاده می‌کند. این گزینه در صورتی قابل استفاده است که چندین آدرس IP روی یک دستگاه داشته باشید و بخواهید از آدرسی غیر از آدرس پیش‌فرض استفاده کنید. همچنین در شرایطی که .Xr gethostname 3 نام میزبان را برنمی‌گرداند (در برخی محیط‌های NIS با پیکربندی نامناسب) ممکن است به استفاده از این گزینه نیاز پیدا کنید. استفاده از چندین آدرس IP روی یک سیستم منفرد معمولاً «میزبانی مجازی» (virtual hosting) نامیده می‌شود و هر آدرس IP یک «میزبان مجازی» است. لطفاً توجه داشته باشید که کلاینت IRC نمی‌تواند به سرور IRC اعلام کند که نام میزبان شما چه باشد؛ سرور به تنهایی این موضوع را تعیین می‌کند. سرورها معمولاً از نام میزبان رسمی (canonical hostname) مربوط به یک آدرس IP به عنوان نام میزبان شما استفاده می‌کنند. به همین دلیل، این گزینه به شما اجازه استفاده از یک CNAME (نام میزبان ثانویه برای یک آدرس IP) را نخواهد داد، چرا که سرور به جای آن از نام میزبان رسمی استفاده خواهد کرد. این گزینه بر متغیر محیطی .Ev IRCHOST ارجحیت دارد. .It Fl l Ar filename,[filename] از نام فایل یا فایل‌های مشخص‌شده به عنوان فایل راه‌اندازی استفاده می‌کند. فایل راه‌اندازی در اولین باری که با موفقیت به سرور متصل شوید بارگذاری می‌شود، مگر اینکه گزینه .Op Ar \-B را مشخص کرده باشید. این گزینه بر متغیر محیطی .Ev IRCRC ارجحیت دارد. اگر این گزینه مشخص نشده باشد و متغیر محیطی .Ev IRCRC نیز تنظیم نشده باشد، فایل .Pa ~/.ircrc فایل راه‌اندازی پیش‌فرض خواهد بود. .It Fl n Ar nickname هنگام اتصال به هر سرور IRC، از نام مستعار مشخص‌شده به عنوان نام مستعار پیش‌فرض استفاده می‌کند. این گزینه بر متغیر محیطی .Ev IRCNICK ارجحیت دارد. در صورت مشخص کردن آرگومان nickname در خط فرمان، این گزینه لغو می‌شود (بخش زیر را ببینید). .It Fl o استفاده از کاراکترهای termios مربوط به IEXTEN را اجبار می‌کند. سیستم‌های پازیکس (POSIX) مجاز هستند زمانی که IEXTEN فعال است، نویسه‌های کنترلی اضافه‌ای را برای انجام کارهای ویژه رزرو کنند. در 4.4BSD، کلیدهای control-V و control-O توسط IEXTEN استفاده می‌شوند و بنابراین نمی‌توان از آن‌ها در انتساب‌های کلیدی (key bindings) درون EPIC استفاده کرد، چرا که ترمینال هرگز آن‌ها را به EPIC ارسال نمی‌کند. .It Fl O استفاده از کاراکترهای termios مربوط به IEXTEN را غیرفعال می‌کند. این کار تمامی کلیدهای رزروشده توسط گزینه termios مربوط به IEXTEN سیستم شما را برای استفاده در انتساب‌های کلیدی آزاد می‌کند. در 4.4BSD، اگر بخواهید از control-V و control-O در انتساب‌های کلیدی خود استفاده کنید، این فلگ ضروری است. .It Fl p Ar port از پورت مشخص‌شده به عنوان پورت پیش‌فرض برای اتصالات جدید به سرور استفاده می‌کند. پورت پیش‌فرض معمولاً ۶۶۶۷ است. پیش از تلاش برای اتصال، اطمینان حاصل کنید سرورهایی که می‌خواهید به آن‌ها متصل شوید روی این پورت در حال شنود هستند. .It Fl q هنگام برقراری اولین اتصال به یک سرور IRC، از بارگذاری هرگونه فایلی جلوگیری می‌کند. .It Fl v اطلاعات شناسایی نسخه (VID) را چاپ کرده و خارج می‌شود. .It Fl x این قابلیت مستندنشده تمامی فلگ‌های XDEBUG را فعال می‌کند. اگر می‌خواهید بدانید در صورت استفاده از این گزینه چه اتفاقی می‌افتد، به فایل‌های راهنمای XDEBUG مراجعه کنید. .It Fl z Ar username هنگام مذاکره برای اتصال به سرور جدید IRC، از نام کاربری مشخص‌شده استفاده می‌کند. این گزینه بر متغیر محیطی .Ev IRCUSER ارجحیت دارد. اگر این گزینه مشخص نشود، نام کاربری ثبت‌شده برای کاربر شما در فایل .Pa /etc/passwd مورد استفاده قرار می‌گیرد. این قابلیت در گذشته مستند نشده بود، اما با گسترش و محبوبیت استفاده از .Xr identd 8 این گزینه بسیار کمتر از گذشته کاربرد دارد. درخواست‌ها برای حذف این گزینه احتمالاً نادیده گرفته خواهند شد. اگر نمی‌خواهید کاربران شما نام‌های کاربری خود را جعل کنند، identd را نصب کرده و به همه افراد در IRC لطف کنید. .It nickname اولین کلمه ساده‌ای که یافت شود به عنوان نام مستعار پیش‌فرض برای استفاده در نظر گرفته می‌شود. این مورد بر تمامی گزینه‌های دیگر، از جمله گزینه \-n و متغیر محیطی .Ev IRCNICK ارجحیت دارد. در صورت عدم دسترسی به گزینه‌های دیگر، کلاینت از نام کاربری ورود (login) شما به عنوان نام مستعار پیش‌فرض استفاده می‌کند. .It server,[server] پس از نام مستعار، فهرستی از یک یا چند مشخصه سرور می‌تواند درج شود. مگر اینکه گزینه \-a را مشخص کنید، این فهرست جایگزین فهرست پیش‌فرض سرورهای شما خواهد شد! گزینه \-a سرورهای فهرست‌شده در اینجا را وادار می‌کند تا به انتهای فهرست پیش‌فرض سرورها اضافه شوند. قالب مشخصات سرور به شرح زیر است: .sp .Dl hostname:port:password:nick .sp هر موردی می‌تواند با خالی گذاشتن فیلد حذف شود، و هر دو نقطه (:) انتهایی نیز می‌تواند حذف گردد. .El .Sh "توضیحات تفصیلی (DETAILED DESCRIPTION)" .Ss "صفحه نمایش (The Screen):" صفحه نمایش به دو بخش تقسیم می‌شود که با یک خط وضعیت با ویدئوی معکوس (در صورت پشتیبانی) از یکدیگر جدا شده‌اند. بخش بالایی (بزرگ‌تر) صفحه نمایش، پاسخ‌های دریافتی از سرور .Xr ircd 8 را نمایش می‌دهد. بخش پایینی صفحه نمایش (یک سطر منفرد) ورودی صفحه‌کلید را دریافت می‌کند. .sp برخی ترمینال‌ها از قابلیت‌های خاصی که توسط .Nm epic مورد نیاز است پشتیبانی نمی‌کنند، که در این صورت پیامی مبنی بر این موضوع دریافت خواهید کرد. اگر چنین شد، نوع ترمینال را تغییر دهید یا .Nm epic را با گزینه \-d اجرا کنید. .Ss "دستورات IRC (Irc Commands):" هر سطری که با نویسه اسلش .Dq / آغاز شود به عنوان یک دستور .Nm epic در نظر گرفته می‌شود (کاراکتر دستور قابل تغییر است). هر سطری که با این نویسه آغاز نشود به عنوان پیامی برای ارسال به کانال فعلی در نظر گرفته خواهد شد. این کلاینت دارای یک سامانه راهنمای داخلی است. فایل‌های راهنما را نصب کنید (این فایل‌ها باید در همان محلی که کلاینت را دریافت کرده‌اید در دسترس باشند) و سپس عبارت .Dq /help را برای باز کردن سامانه راهنما وارد نمایید. .Ss "فایل .ircrc (The .ircrc File):" هنگامی که .Nm epic اجرا می‌شود، پوشه خانگی کاربر را برای یافتن فایل .Pa ~/.ircrc بررسی کرده و دستورات موجود در آن فایل را اجرا می‌کند. دستورات موجود در این فایل نیازی به داشتن نویسه اسلش ابتدایی .Dq / ندارند؛ این امر امکان تعریف پیش‌فرض نام‌های مستعار (alias) و قابلیت‌های دیگر را فراهم می‌سازد. .Sh "مثال‌های کاربردی (PRACTICAL EXAMPLES)" مسلماً هرگونه توضیحی درباره .Nm epic در این صفحه راهنما به شدت ناکافی خواهد بود، زیرا بیشتر ابهامات تازه پس از اتصال کلاینت به سرور آغاز می‌شود. اما اگر برای اتصال کلاینت به سرور با مشکل جدی مواجه شدید، برخی از این موارد را امتحان کنید: .Bl -tag -width "epic" .It Nm epic ابتدا این را امتحان کنید. این دستور تمامی پیش‌فرض‌ها را در نظر می‌گیرد. اگر شخصی که epic را در سایت شما نگهداری می‌کند کار خود را تا حدی درست انجام داده باشد، شما را به سروری متصل می‌کند که تا حدودی به شما نزدیک است. .It Nm "epic nickname irc.domain.com" یا دستوری مشابه آن، تلاش خواهد کرد با نام مستعار «nickname» به سرور IRC در حال اجرا روی میزبان «irc.domain.com» (در اینجا یک سرور واقعی IRC وارد کنید) متصل شود. این رایج‌ترین روش برای تعیین یک سرور جایگزین است. .It Nm "epic nickname irc.domain.com:6664" گاهی اوقات برخی سرورها بسیار شلوغ هستند و برقراری ارتباط با شما روی پورت پیش‌فرض (۶۶۶۷) زمان زیادی می‌برد. اکثر سرورهای بزرگ در شبکه‌های عمومی اتصالات را روی پورت‌های مختلفی می‌پذیرند که رایج‌ترین آن‌ها بیشتر یا تمام پورت‌های بین ۶۶۶۰ تا ۶۶۷۵ است. اگر سروری که به آن متصل می‌شوید از پورت جایگزین پشتیبانی کند، معمولاً با استفاده از پورتی غیر از ۶۶۶۷ می‌توانید بسیار سریع‌تر متصل شوید. .It Nm "epic nickname irc.efnet.net" اگر کاملاً سردرگم شده‌اید و تلاش می‌کنید به efnet وارد شوید، این دستور را امتحان کنید. .It Nm "epic nickname irc.undernet.org" اگر کاملاً سردرگم شده‌اید و می‌خواهید به undernet متصل شوید، این دستور را امتحان کنید. .It Nm "epic nickname irc.dal.net" اگر کاملاً سردرگم شده‌اید و قصد دارید وارد dalnet شوید، این مورد را امتحان کنید. .El .Sh "فایل‌ها (FILES)" .Bl -tag -width "/usr/local/share/epic" .It Nm /usr/local/bin/epic محل پیش‌فرض فایل اجرایی .It Nm ~/.ircrc فایل مقداردهی اولیه پیش‌فرض .It Nm ~/.irc/ پوشه‌ای که می‌توانید اسکریپت‌های .Nm epic خود را در آن قرار دهید تا سپس با دستور /load بارگذاری شوند .It Nm /usr/local/share/epic پوشه پیش‌فرض شامل پیام روز (message-of-the-day)، مقداردهی اولیه اصلی، فایل‌های راهنما و اسکریپت‌های .Nm epic .El .Sh "فایل‌های راهنما (THE HELP FILES)" راه‌اندازی کلاینت بخش آسان کار است. به محض اتصال، احتمالاً متوجه خواهید شد که نمی‌دانید چه کاری انجام می‌دهید. اینجاست که فایل‌های راهنما به کار می‌آیند. اگر شخصی که IRC را در سایت شما نگهداری می‌کند فایل‌های راهنما را نصب نکرده است، آن‌قدر پیگیری کنید تا نصب کند. پس از در دسترس قرار گرفتن فایل‌های راهنما، از دستور .Dq /help برای شروع استفاده کنید. هزاران دستور و نکات ظریف فراوانی وجود دارد که تسلط بر آن‌ها چند ماه طول خواهد کشید. اما وقتی مسلط شدید، چنان شدیداً به IRC وابسته خواهید شد که همسرتان از شما جدا می‌شود، فرزندانتان شما را ترک می‌کنند، سگتان فرار می‌کند، در تمام کلاس‌هایتان مردود می‌شوید و فقط می‌مانید تا غصه‌اش را بخورید! .Sh "منابع مفید وب (USEFUL WEB RESOURCES)" .Tp .Pp .Pa صفحه اصلی EPIC .Tp .Pp .Pa صفحات برخط راهنمای EPIC .Tp .Pp .Pa راهنماهای عالی فراوان برای کاربران تازه‌کار IRC. .Sh "سیگنال‌ها (SIGNALS)" .Nm epic سیگنال‌های زیر را به شکل مناسب مدیریت می‌کند: .Pp .TP .Bl -tag -width "IRCSERVER" .It SIGUSR1 تمامی اتصالات DCC و فرآیندهای اجراشده (EXEC) را می‌بندد. .Pp .El .Sh "متغیرهای محیطی (ENVIRONMENT VARIABLES)" تعریف پیش‌فرض برخی متغیرها در فایل‌های .Pa ~/.cshrc ، .Pa ~/.profile یا .Pa ~/.login می‌تواند مفید باشد: .Bl -tag -width "IRCSERVER" .It Ev IRCNICK نام مستعار پیش‌فرض IRC برای کاربر .It Ev IRCNAME نام واقعی پیش‌فرض IRC برای کاربر (در غیر این صورت از .Pa /etc/passwd دریافت می‌شود) .It Ev IRCSERVER فهرست پیش‌فرض سرورهای IRC کاربر (برای جزئیات به گزینه server مراجعه کنید) .It Ev HOME دایرکتوری خانگی پیش‌فرض در .Pa /etc/passwd را بازنویسی می‌کند .It Ev TERM نوع شبیه‌ساز ترمینال مورد استفاده .El .Sh "همچنین ببینید (SEE ALSO)" .Xr ircd 8 .Sh "اشکالات (BUGS)" هر نرم‌افزار غیرساده‌ای دارای باگ و اشکال است. برنامه ircII/EPIC نیز از این قاعده مستثنی نیست. می‌توانید به فایل .Pa KNOWNBUGS که همراه با کد منبع کلاینت توزیع شده است برای مشاهده فهرستی از مشکلاتی که وجود آن‌ها شناخته شده است و ممکن است روزی برطرف شوند یا نشوند، مراجعه کنید. اگر اشکالی پیدا کردید که در آنجا فهرست نشده است، می‌توانید به فایل .Pa BUG_FORM که آن نیز همراه با کد منبع توزیع شده است مراجعه نمایید. این فایل دستورالعمل‌هایی درباره نحوه پر کردن گزارش و محل ارسال آن در اختیارتان می‌گذارد. .Sh "نکات و اصلاحات (ERRATA)" مستندات برخط احتمالاً باید به جای قالب فعلی راهنما در قالب docbook می‌بود. کل سامانه راهنما سرهم‌بندی شده است. .Pp این صفحه راهنما فقط گزینه‌های epic را توصیف می‌کند، اما به شما نمی‌گوید پس از اتصال چه کاری انجام دهید. .Sh "نویسندگان (AUTHORS)" برنامه توسط Michael Sandrof (ms5n+@andrew.cmu.edu) نوشته شده است. دارنده حق نشر Matthew Green (mrg@mame.mu.oz.au) است. این نرم‌افزار توسط Jeremy Nelson (jnelson@acronet.net) به نمایندگی از پروژه EPIC (list@epicsol.org) نگهداری می‌شود. .Pp در زمان‌های مختلف، این صفحه راهنما توسط افراد زیر ویرایش شده است: Darren Reed، R.P.C. Rodgers، the lynX، Matthew Green و Jeremy Nelson. .\" end of man page