نام (NAME)

epic — کلاینت گفتگوی رله اینترنتی (IRC) برای سیستم‌های شبه‌یونیکس

خلاصه دستور (SYNOPSIS)

epic [-a] [-b] [-B] [-c chan] [-d] [-f] [-F] [-h] [-H hostname] [-l filename] [-L filename] [-n nickname] [-o] [-O] [-p port] [-q] [-v] [-x] [-z username] [nickname] [server description list]

توضیحات (DESCRIPTION)

برنامه ircII/EPIC یک عامل کاربر («کلاینت») مبتنی بر نویسه و تحت یونیکس برای گفتگوی رله اینترنتی (IRC) است. این برنامه یک کلاینت کاملاً کاربردی ircII به همراه قابلیت‌های افزوده و مفید متعددی است. این نسخه با تمام رده‌های مدرن سرورهای IRC در اوایل سال ۱۹۹۹ سازگار است.

گزینه‌ها (OPTIONS)

-a

فهرست توصیف سرور را به انتهای فهرست پیش‌فرض سرورها اضافه می‌کند. رفتار پیش‌فرض به این صورت است که فهرست توصیف سرور جایگزین فهرست پیش‌فرض سرورها می‌شود.

-b

در حالت اصطلاحاً “bot mode” (حالت ربات) کار می‌کند. این گزینه متضمن گزینه [-d] است. برنامه EPIC بی‌درنگ از طریق fork(2) منشعب می‌شود و فرآیند والد خارج خواهد شد و شما را به شل بازمی‌گرداند. برخی از مدیران سیستم به اجرای ربات‌ها توسط کاربران خود به دید خوبی نگاه نمی‌کنند و این گزینه را غیرفعال کرده‌اند. حتی اگر مدیر سیستم شما آن را غیرفعال نکرده باشد، نباید تصور کنید که این امر به منزله مجوز خودکار برای اجرای ربات است. اگر بدون مجوز ربات اجرا کنید، ممکن است مدیر سیستم از شما بسیار ناراحت شده و احتمالاً حسابتان را لغو کند. علاوه بر این، بیشتر گردانندگان IRC (اپراتورها) در شبکه‌های عمومی IRC مدارای بسیار کمی با افرادی دارند که ربات اجرا می‌کنند. بنابراین به عنوان یک هشدار، پیش از اجرای ربات اطمینان حاصل کنید که مدیر سیستم و مدیر IRC به شما اجازه داده‌اند.

-B

بارگذاری فایل راه‌اندازی (startup) را بلافاصله اجبار می‌کند، به جای آنکه تا زمان برقراری اتصال به سرور منتظر بماند.

-c chan

در اولین باری که با موفقیت به یک سرور متصل شدید، به کانال مشخص‌شده ملحق می‌شود.

-d

در “dumb mode” (حالت ساده و بدون نمایشگر تمام‌صفحه) کار می‌کند. کلاینت نمایش تمام‌صفحه ایجاد نخواهد کرد و از ورودی استاندارد خوانده و در خروجی استاندارد می‌نویسد. این حالت در صورتی مفید است که خروجی در حالت عادی ظاهر نامناسبی داشته باشد (زیرا از تنظیم نادرست TERM استفاده می‌کنید یا توصیف ترمینال شما به طرز چشمگیری خراب است)، یا صرفاً نمی‌خواهید از رابط کاربری گرافیکی یا تمام‌صفحه استفاده کنید. اگر مقدار فعلی TERM شما قادر به نمایش تمام‌صفحه نباشد، این گزینه به طور خودکار فعال خواهد شد.

-f

استفاده از کنترل جریان سخت‌افزاری را اجبار می‌کند. با این گزینه، کلیدهای control-S و control-Q احتمالاً برای انتساب به کارهای دیگر در دسترس نخواهند بود.

-F

استفاده از کنترل جریان سخت‌افزاری را غیرفعال می‌کند. با این گزینه، کلیدهای control-S و control-Q برای انتساب به کارهای دیگر در دسترس خواهند بود. با این حال، کنترل جریان سخت‌افزاری نخواهید داشت.

-h

پیام راهنمای نسبتاً مختصر را نمایش داده و بی‌درنگ خارج می‌شود.

-H hostname

از آدرس IP نام میزبان (hostname) مشخص‌شده به عنوان آدرس IP پیش‌فرض شما استفاده می‌کند. این گزینه در صورتی قابل استفاده است که چندین آدرس IP روی یک دستگاه داشته باشید و بخواهید از آدرسی غیر از آدرس پیش‌فرض استفاده کنید. همچنین در شرایطی که gethostname(3) نام میزبان را برنمی‌گرداند (در برخی محیط‌های NIS با پیکربندی نامناسب) ممکن است به استفاده از این گزینه نیاز پیدا کنید. استفاده از چندین آدرس IP روی یک سیستم منفرد معمولاً «میزبانی مجازی» (virtual hosting) نامیده می‌شود و هر آدرس IP یک «میزبان مجازی» است. لطفاً توجه داشته باشید که کلاینت IRC نمی‌تواند به سرور IRC اعلام کند که نام میزبان شما چه باشد؛ سرور به تنهایی این موضوع را تعیین می‌کند. سرورها معمولاً از نام میزبان رسمی (canonical hostname) مربوط به یک آدرس IP به عنوان نام میزبان شما استفاده می‌کنند. به همین دلیل، این گزینه به شما اجازه استفاده از یک CNAME (نام میزبان ثانویه برای یک آدرس IP) را نخواهد داد، چرا که سرور به جای آن از نام میزبان رسمی استفاده خواهد کرد. این گزینه بر متغیر محیطی IRCHOST ارجحیت دارد.

-l filename,[filename]

از نام فایل یا فایل‌های مشخص‌شده به عنوان فایل راه‌اندازی استفاده می‌کند. فایل راه‌اندازی در اولین باری که با موفقیت به سرور متصل شوید بارگذاری می‌شود، مگر اینکه گزینه [-B] را مشخص کرده باشید. این گزینه بر متغیر محیطی IRCRC ارجحیت دارد. اگر این گزینه مشخص نشده باشد و متغیر محیطی IRCRC نیز تنظیم نشده باشد، فایل ~/.ircrc فایل راه‌اندازی پیش‌فرض خواهد بود.

-n nickname

هنگام اتصال به هر سرور IRC، از نام مستعار مشخص‌شده به عنوان نام مستعار پیش‌فرض استفاده می‌کند. این گزینه بر متغیر محیطی IRCNICK ارجحیت دارد. در صورت مشخص کردن آرگومان nickname در خط فرمان، این گزینه لغو می‌شود (بخش زیر را ببینید).

-o

استفاده از کاراکترهای termios مربوط به IEXTEN را اجبار می‌کند. سیستم‌های پازیکس (POSIX) مجاز هستند زمانی که IEXTEN فعال است، نویسه‌های کنترلی اضافه‌ای را برای انجام کارهای ویژه رزرو کنند. در 4.4BSD، کلیدهای control-V و control-O توسط IEXTEN استفاده می‌شوند و بنابراین نمی‌توان از آن‌ها در انتساب‌های کلیدی (key bindings) درون EPIC استفاده کرد، چرا که ترمینال هرگز آن‌ها را به EPIC ارسال نمی‌کند.

-O

استفاده از کاراکترهای termios مربوط به IEXTEN را غیرفعال می‌کند. این کار تمامی کلیدهای رزروشده توسط گزینه termios مربوط به IEXTEN سیستم شما را برای استفاده در انتساب‌های کلیدی آزاد می‌کند. در 4.4BSD، اگر بخواهید از control-V و control-O در انتساب‌های کلیدی خود استفاده کنید، این فلگ ضروری است.

-p port

از پورت مشخص‌شده به عنوان پورت پیش‌فرض برای اتصالات جدید به سرور استفاده می‌کند. پورت پیش‌فرض معمولاً ۶۶۶۷ است. پیش از تلاش برای اتصال، اطمینان حاصل کنید سرورهایی که می‌خواهید به آن‌ها متصل شوید روی این پورت در حال شنود هستند.

-q

هنگام برقراری اولین اتصال به یک سرور IRC، از بارگذاری هرگونه فایلی جلوگیری می‌کند.

-v

اطلاعات شناسایی نسخه (VID) را چاپ کرده و خارج می‌شود.

-x

این قابلیت مستندنشده تمامی فلگ‌های XDEBUG را فعال می‌کند. اگر می‌خواهید بدانید در صورت استفاده از این گزینه چه اتفاقی می‌افتد، به فایل‌های راهنمای XDEBUG مراجعه کنید.

-z username

هنگام مذاکره برای اتصال به سرور جدید IRC، از نام کاربری مشخص‌شده استفاده می‌کند. این گزینه بر متغیر محیطی IRCUSER ارجحیت دارد. اگر این گزینه مشخص نشود، نام کاربری ثبت‌شده برای کاربر شما در فایل /etc/passwd مورد استفاده قرار می‌گیرد. این قابلیت در گذشته مستند نشده بود، اما با گسترش و محبوبیت استفاده از identd(8) این گزینه بسیار کمتر از گذشته کاربرد دارد. درخواست‌ها برای حذف این گزینه احتمالاً نادیده گرفته خواهند شد. اگر نمی‌خواهید کاربران شما نام‌های کاربری خود را جعل کنند، identd را نصب کرده و به همه افراد در IRC لطف کنید.

nickname

اولین کلمه ساده‌ای که یافت شود به عنوان نام مستعار پیش‌فرض برای استفاده در نظر گرفته می‌شود. این مورد بر تمامی گزینه‌های دیگر، از جمله گزینه -n و متغیر محیطی IRCNICK ارجحیت دارد. در صورت عدم دسترسی به گزینه‌های دیگر، کلاینت از نام کاربری ورود (login) شما به عنوان نام مستعار پیش‌فرض استفاده می‌کند.

server,[server]

پس از نام مستعار، فهرستی از یک یا چند مشخصه سرور می‌تواند درج شود. مگر اینکه گزینه -a را مشخص کنید، این فهرست جایگزین فهرست پیش‌فرض سرورهای شما خواهد شد! گزینه -a سرورهای فهرست‌شده در اینجا را وادار می‌کند تا به انتهای فهرست پیش‌فرض سرورها اضافه شوند. قالب مشخصات سرور به شرح زیر است:

hostname:port:password:nick

هر موردی می‌تواند با خالی گذاشتن فیلد حذف شود، و هر دو نقطه (:) انتهایی نیز می‌تواند حذف گردد.

توضیحات تفصیلی (DETAILED DESCRIPTION)

مثال‌های کاربردی (PRACTICAL EXAMPLES)

مسلماً هرگونه توضیحی درباره epic در این صفحه راهنما به شدت ناکافی خواهد بود، زیرا بیشتر ابهامات تازه پس از اتصال کلاینت به سرور آغاز می‌شود. اما اگر برای اتصال کلاینت به سرور با مشکل جدی مواجه شدید، برخی از این موارد را امتحان کنید:

epic

ابتدا این را امتحان کنید. این دستور تمامی پیش‌فرض‌ها را در نظر می‌گیرد. اگر شخصی که epic را در سایت شما نگهداری می‌کند کار خود را تا حدی درست انجام داده باشد، شما را به سروری متصل می‌کند که تا حدودی به شما نزدیک است.

epic nickname irc.domain.com

یا دستوری مشابه آن، تلاش خواهد کرد با نام مستعار «nickname» به سرور IRC در حال اجرا روی میزبان «irc.domain.com» (در اینجا یک سرور واقعی IRC وارد کنید) متصل شود. این رایج‌ترین روش برای تعیین یک سرور جایگزین است.

epic nickname irc.domain.com:6664

گاهی اوقات برخی سرورها بسیار شلوغ هستند و برقراری ارتباط با شما روی پورت پیش‌فرض (۶۶۶۷) زمان زیادی می‌برد. اکثر سرورهای بزرگ در شبکه‌های عمومی اتصالات را روی پورت‌های مختلفی می‌پذیرند که رایج‌ترین آن‌ها بیشتر یا تمام پورت‌های بین ۶۶۶۰ تا ۶۶۷۵ است. اگر سروری که به آن متصل می‌شوید از پورت جایگزین پشتیبانی کند، معمولاً با استفاده از پورتی غیر از ۶۶۶۷ می‌توانید بسیار سریع‌تر متصل شوید.

epic nickname irc.efnet.net

اگر کاملاً سردرگم شده‌اید و تلاش می‌کنید به efnet وارد شوید، این دستور را امتحان کنید.

epic nickname irc.undernet.org

اگر کاملاً سردرگم شده‌اید و می‌خواهید به undernet متصل شوید، این دستور را امتحان کنید.

epic nickname irc.dal.net

اگر کاملاً سردرگم شده‌اید و قصد دارید وارد dalnet شوید، این مورد را امتحان کنید.

فایل‌ها (FILES)

/usr/local/bin/epic

محل پیش‌فرض فایل اجرایی

~/.ircrc

فایل مقداردهی اولیه پیش‌فرض

~/.irc/

پوشه‌ای که می‌توانید اسکریپت‌های epic خود را در آن قرار دهید تا سپس با دستور /load بارگذاری شوند

/usr/local/share/epic

پوشه پیش‌فرض شامل پیام روز (message-of-the-day)، مقداردهی اولیه اصلی، فایل‌های راهنما و اسکریپت‌های epic

فایل‌های راهنما (THE HELP FILES)

راه‌اندازی کلاینت بخش آسان کار است. به محض اتصال، احتمالاً متوجه خواهید شد که نمی‌دانید چه کاری انجام می‌دهید. اینجاست که فایل‌های راهنما به کار می‌آیند. اگر شخصی که IRC را در سایت شما نگهداری می‌کند فایل‌های راهنما را نصب نکرده است، آن‌قدر پیگیری کنید تا نصب کند. پس از در دسترس قرار گرفتن فایل‌های راهنما، از دستور “/help” برای شروع استفاده کنید. هزاران دستور و نکات ظریف فراوانی وجود دارد که تسلط بر آن‌ها چند ماه طول خواهد کشید. اما وقتی مسلط شدید، چنان شدیداً به IRC وابسته خواهید شد که همسرتان از شما جدا می‌شود، فرزندانتان شما را ترک می‌کنند، سگتان فرار می‌کند، در تمام کلاس‌هایتان مردود می‌شوید و فقط می‌مانید تا غصه‌اش را بخورید!

منابع مفید وب (USEFUL WEB RESOURCES)

http://www.epicsol.org صفحه اصلی EPIC

http://help.epicsol.org صفحات برخط راهنمای EPIC

http://www.irchelp.org راهنماهای عالی فراوان برای کاربران تازه‌کار IRC.

سیگنال‌ها (SIGNALS)

epic سیگنال‌های زیر را به شکل مناسب مدیریت می‌کند:

SIGUSR1

تمامی اتصالات DCC و فرآیندهای اجراشده (EXEC) را می‌بندد.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

تعریف پیش‌فرض برخی متغیرها در فایل‌های ~/.cshrc ، ~/.profile یا ~/.login می‌تواند مفید باشد:

IRCNICK

نام مستعار پیش‌فرض IRC برای کاربر

IRCNAME

نام واقعی پیش‌فرض IRC برای کاربر (در غیر این صورت از /etc/passwd دریافت می‌شود)

IRCSERVER

فهرست پیش‌فرض سرورهای IRC کاربر (برای جزئیات به گزینه server مراجعه کنید)

HOME

دایرکتوری خانگی پیش‌فرض در /etc/passwd را بازنویسی می‌کند

TERM

نوع شبیه‌ساز ترمینال مورد استفاده

همچنین ببینید (SEE ALSO)

ircd(8)

اشکالات (BUGS)

هر نرم‌افزار غیرساده‌ای دارای باگ و اشکال است. برنامه ircII/EPIC نیز از این قاعده مستثنی نیست. می‌توانید به فایل KNOWNBUGS که همراه با کد منبع کلاینت توزیع شده است برای مشاهده فهرستی از مشکلاتی که وجود آن‌ها شناخته شده است و ممکن است روزی برطرف شوند یا نشوند، مراجعه کنید. اگر اشکالی پیدا کردید که در آنجا فهرست نشده است، می‌توانید به فایل BUG_FORM که آن نیز همراه با کد منبع توزیع شده است مراجعه نمایید. این فایل دستورالعمل‌هایی درباره نحوه پر کردن گزارش و محل ارسال آن در اختیارتان می‌گذارد.

نکات و اصلاحات (ERRATA)

مستندات برخط احتمالاً باید به جای قالب فعلی راهنما در قالب docbook می‌بود. کل سامانه راهنما سرهم‌بندی شده است.

این صفحه راهنما فقط گزینه‌های epic را توصیف می‌کند، اما به شما نمی‌گوید پس از اتصال چه کاری انجام دهید.

نویسندگان (AUTHORS)

برنامه توسط Michael Sandrof (ms5n+@andrew.cmu.edu) نوشته شده است. دارنده حق نشر Matthew Green (mrg@mame.mu.oz.au) است. این نرم‌افزار توسط Jeremy Nelson (jnelson@acronet.net) به نمایندگی از پروژه EPIC (list@epicsol.org) نگهداری می‌شود.

در زمان‌های مختلف، این صفحه راهنما توسط افراد زیر ویرایش شده است: Darren Reed، R.P.C. Rodgers، the lynX، Matthew Green و Jeremy Nelson.