.\"
.\" YATE - Yet Another Telephony Engine
.\"
.\" This software is distributed under multiple licenses;
.\" see the COPYING file in the main directory for licensing
.\" information for this specific distribution.
.\"
.\" This use of this software may be subject to additional restrictions.
.\" See the LEGAL file in the main directory for details.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.\"
.\"
.TH YATE 8 "September 2007" "YATE" "Telephony Engine"
.SH "نام (NAME)"
\fByate\fP \- راه\zwnjاندازی موتور تلفنی YATE
.SH "خلاصه دستور (SYNOPSIS)"
.B yate
.RI [گزینه‌ها]
.RI [دستورات]
.SH "توضیحات (DESCRIPTION)"
دستور
.B yate
یک موتور تلفنی است که از قابلیت\zwnjهای کلاینت، PBX و سامانه پاسخ صوتی تعاملی (IVR) از طریق پلاگین\zwnjها پشتیبانی می\zwnjکند.
.SH "گزینه‌ها (OPTIONS)"
.SS "عمومی (General)"
.TP
.B \-h, \-\-help
نمایش پیام راهنمای کوتاه و خروج
.TP
.B \-V, \-\-version
نمایش نسخه برنامه و خروج
.TP
.B \-v
ثبت وقایع با جزئیات بیشتر (می\zwnjتوان چندین بار استفاده کرد)
.TP
.B \-q
ثبت وقایع بی\zwnjصداتر و کمتر (می\zwnjتوان چندین بار استفاده کرد)
.TP
.B \-d
تبدیل به دیمن، عدم نمایش خروجی مگر اینکه در گزارش ثبت شود
.TP
.B \-s[=msec]
حالت تحت نظارت (supervised)، راه\zwnjاندازی مجدد در صورت کرش یا قفل شدن، به\zwnjصورت اختیاری در ابتدا مکث می\zwnjکند
.TP
.B \-r
فعال\zwnjسازی چرخش فایل گزارش (نیازمند -s و -l)
.TP
.B \-l \fIfilename\fR
ثبت وقایع در فایل \- باید هنگام اجرا در حالت دیمن استفاده شود
.TP
.B \-p \fIfilename\fR
نوشتن شناسه فرایند (PID) ناظر یا ریسه اصلی در فایل
.TP
.B \-n \fIconfigname\fR
استفاده از نام پیکربندی مشخص\zwnjشده، بازنویسی مقدار پیش\zwnjفرض "yate"
.TP
.B \-c \fIpathname\fR
مسیر پوشه فایل\zwnjهای پیکربندی، بازنویسی مقدار کامپایل\zwnjشده
.TP
.B \-u \fIpathname\fR
مسیر پوشه فایل\zwnjهای داده\zwnjهای کاربری، بازنویسی مقدار کامپایل\zwnjشده
.TP
.B \-m \fIpathname\fR
مسیر پوشه ماژول\zwnjها، بازنویسی مقدار کامپایل\zwnjشده
.TP
.B \-e \fIpathname\fR
مسیر پوشه مشترک (shared)، بازنویسی مقدار کامپایل\zwnjشده
.TP
.B \-x \fIdirpath\fR
مسیر مطلق یا نسبی به پوشه ماژول\zwnjهای اضافه (می\zwnjتواند تکرار شود)
.TP
.B \-w \fIdirectory\fR
تغییر دایرکتوری کاری
.TP
.B \-N \fInodename\fR
تنظیم نام گره در یک کلاستر
.SS "گزینه‌های اشکال‌زدایی (Debugging options - ممکن است کامپایل نشده باشند)"
.TP
.B \-C
فعال\zwnjسازی رونوشت حافظه (core dumps) در صورت پشتیبانی سیستم\zwnjعامل
.TP
.B \-F
افزایش حداکثر دستگیره فایل به مقدار کامپایل\zwnjشده
.TP
.B \-S
تنظیم اندازه استخر نقاط بررسی صحت نظارت\zwnjشده
.TP
.B \-t
کوتاه کردن و بازنویسی فایل گزارش به جای الحاق به آن
.TP
.B \-D[options]
گزینه\zwnjهای ویژه اشکال\zwnjزدایی
.TP
.B \-Da
لغو و خروج اضطراری (همراه با coredump در صورت مجاز بودن) در صورت برخورد با باگ
.TP
.B \-Dm
تلاش برای اشکال\zwnjزدایی بن\zwnjبست\zwnjهای قفل متقابل (mutex deadlocks) با تعیین محدودیت حداکثر ۱۰ ثانیه، در صورت تکرار محدودیت نصف می\zwnjشود
.TP
.B \-Dd
فعال\zwnjسازی برخی قابلیت\zwnjهای ایمنی و اشکال\zwnjزدایی قفل\zwnjگذاری، که کارایی را کاهش می\zwnjدهد
.TP
.B \-Dl
تلاش برای بارگذاری ماژول\zwnjها بدون اینکه نمادهای آن\zwnjها به\zwnjطور سراسری قابل مشاهده باشند
.TP
.B \-Dc
فراخوانی
.I dlclose()
تا زمانی که با خطا مواجه شود
.TP
.B \-Du
عدم تخلیه ماژول\zwnjها از حافظه، تنها تلاش برای فراخوانی کد نهایی\zwnjسازی آن\zwnjها
.TP
.B \-Di
مقداردهی اولیه مجدد پس از نخستین مقداردهی
.TP
.B \-Dx
خروج فوری پس از مقداردهی اولیه
.TP
.B \-Dw
تاخیر یک ثانیه\zwnjای در ایجاد نخستین ریسه کاری (worker thread)
.TP
.B \-Do
رنگی کردن خروجی با استفاده از دنباله نویسه\zwnjهای کنترلی ANSI
.TP
.B \-Ds
خروج اضطراری در صورت برخورد با باگ حتی در زمان خاموش شدن برنامه
.TP
.B \-DO
تلاش برای اشکال\zwnjزدایی تخصیص اشیاء با شمارش اشیاء به ازای هر پلاگین، که کارایی را کاهش می\zwnjدهد
.TP
.B \-Dn
عدم افزودن برچسب زمان به پیام\zwnjهای اشکال\zwnjزدایی
.TP
.B \-Dt
افزودن برچسب زمان نسبی نسبت به زمان شروع به پیام\zwnjهای اشکال\zwnjزدایی
.TP
.B \-De
افزودن برچسب زمان بر پایه مبدأ زمان (EPOCH یعنی 1970-01-01 GMT) به پیام\zwnjهای اشکال\zwnjزدایی
.TP
.B \-Df
افزودن برچسب زمان بر پایه GMT به پیام\zwnjهای اشکال\zwnjزدایی در قالب YYYYMMDDhhmmss.uuuuuu
.TP
.B \-DF
افزودن برچسب زمان بر پایه GMT به پیام\zwnjهای اشکال\zwnjزدایی در قالب YYYY-MM-DD_hh:mm:ss.uuuuuu
.TP
.B \-Dz
افزودن برچسب زمان منطقه زمانی محلی به پیام\zwnjهای اشکال\zwnjزدایی در قالب YYYYMMDDhhmmss.uuuuuu
.TP
.B \-DZ
افزودن برچسب زمان منطقه زمانی محلی به پیام\zwnjهای اشکال\zwnjزدایی در قالب YYYY-MM-DD_hh:mm:ss.uuuuuu
.SH "دستورات (COMMANDS)"
هر دستور بلافاصله پس از مقداردهی اولیه به ماژول\zwnjهای YATE ارسال می\zwnjشود.
ماژول\zwnjها نحو دستور را تعریف می\zwnjکنند، بنابراین در اینجا شرح داده نشده است. لطفاً به مستندات هر ماژول مراجعه کنید.
.SH "سیگنال‌ها (SIGNALS)"
.TP
\- سیگنال SIGTERM و SIGINT (Ctrl\-C) موتور را به\zwnjصورت تمیز متوقف می\zwnjکنند
.TP
\- سیگنال SIGQUIT (Ctrl\-\\) ماژول\zwnjها را دوباره مقداردهی اولیه می\zwnjکند
.TP
\- سیگنال SIGHUP در صورت اجرا در حالت دیمن (\-d) ماژول\zwnjها را دوباره مقداردهی اولیه می\zwnjکند
.TP
\- سیگنال SIGUSR1 یک راه\zwnjاندازی مجدد آرام و ملایم (زمانی که هیچ پلاگینی مشغول نیست) را آغاز می\zwnjکند
.TP
\- سیگنال SIGUSR2 یک راه\zwnjاندازی مجدد فوری را آغاز می\zwnjکند
.SH "اشکالات (BUGS)"
در پیاده\zwnjسازی\zwnjهای مختلف
.B *BSD
تابع
.I dlclose()
معیوب است و ممکن است هنگام خروج خطای حافظه (segfault) ایجاد کند.
.PP
برخی پیاده\zwnjسازی\zwnjهای
.B libpthread
معیوب هستند و ممکن است در شروع ریسه\zwnjها با شکست مواجه شوند یا هنگام پایان یافتن ریسه، پاک\zwnjسازی را انجام ندهند.
.SH "نویسندگان (AUTHORS)"
Paul Chitescu <paulc@voip.null.ro>
.br
Diana Cionoiu <diana@voip.null.ro>
.SH "همچنین ببینید (SEE ALSO)"
.BR yate-config (8)