نام (NAME)

dict - کلاینت پروتکل DICT

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

dict word
dict [options] [word]
dict [options] dict://host:port/d:word:database
dict [options] dict://host:port/m:word:database:strategy

توضیحات (DESCRIPTION)

dict یک کلاینت برای پروتکل کارساز واژه‌نامه (DICT) است؛ یک پروتکل پرس‌وجو/پاسخ مبتنی بر تراکنش TCP که دسترسی به تعاریف واژه‌نامه‌ای را از مجموعه‌ای از پایگاه‌های داده واژه‌نامه زبان طبیعی فراهم می‌کند. وضعیت خروج در صورت موفقیت‌آمیز بودن عملیات 0 و در غیر این صورت مقداری غیر صفر است.
بخش وضعیت خروج (EXIT STATUS) را ببینید.

گزینه‌ها (OPTIONS)

-h server یا --host server: نام میزبان را برای کارساز DICT مشخص می‌کند. ترکیب‌های کارساز/درگاه می‌توانند در فایل پیکربندی تعیین شوند. اگر هیچ کارسازی در فایل پیکربندی یا در خط فرمان مشخص نشده باشد، dict با شکست مواجه خواهد شد. اگر جستجوی IP برای یک کارساز به فهرستی از نشانی‌های IP گسترش یابد (همان‌طور که در حال حاضر dict.org عمل می‌کند)، هر IP به ترتیب فهرست‌شده آزمایش خواهد شد.
-p service یا --port service: درگاه (مانند 2628) یا سرویس (مانند dict) را برای اتصال‌ها مشخص می‌کند. پیش‌فرض 2628 است، همان‌طور که در RFC پروتکل DICT مشخص شده است. ترکیب‌های کارساز/درگاه می‌توانند در فایل پیکربندی تعیین شوند.
-d dbname یا --database dbname: یک پایگاه داده خاص را برای جستجو تعیین می‌کند. حالت پیش‌فرض، جستجو در تمام پایگاه‌های داده است ("*" در پروتکل DICT). توجه داشته باشید که "!" در پروتکل DICT به معنای جستجو در تمام پایگاه‌های داده تا زمان یافتن یک تطابق و سپس توقف جستجو است.
-m یا --match: به جای چاپ یک تعریف، یک تطابق را با استفاده از راهبرد مشخص‌شده انجام می‌دهد.
-s strategy یا --strategy strategy: یک راهبرد تطابق را مشخص می‌کند. به‌طور پیش‌فرض از راهبرد تطابق پیش‌فرض کارساز استفاده می‌شود. این معمولاً برای تعاریف "exact" و برای تطابق‌ها نوعی راهبرد تصحیح املایی است ("." در پروتکل DICT). راهبردهای موجود به پیاده‌سازی کارساز بستگی دارند. برای دیدن فهرستی از راهبردهای در دسترس، گزینه -S یا --strats را ببینید.
-C یا --nocorrect: معمولاً اگر تعریفی درخواست شود و واژه یافت نشود، تصحیح املایی از کارساز درخواست شده و فهرستی از واژه‌های احتمالی ارائه می‌شود. این گزینه تولید این فهرست را غیرفعال می‌کند.
-c file یا --config file: فایل پیکربندی را مشخص می‌کند. حالت پیش‌فرض این است که ~/.dictrc و /etc/dict/dict.conf آزموده شوند و نخستین فایلی که وجود دارد استفاده شود. اگر یک فایل پیکربندی خاص تعیین شود، موارد پیش‌فرض آزموده نخواهند شد.
-D یا --dbs: از کارساز پرس‌وجو کرده و فهرستی از پایگاه‌های داده در دسترس را نمایش می‌دهد.
-S یا --strats: از کارساز پرس‌وجو کرده و فهرستی از راهبردهای جستجوی در دسترس را نمایش می‌دهد.
-H یا --serverhelp: از کارساز پرس‌وجو کرده و اطلاعات راهنمایی را که ارائه می‌دهد نمایش می‌دهد.
-i dbname یا --info dbname: اطلاعات مربوط به پایگاه داده مشخص‌شده را درخواست می‌کند (معمولاً کارساز اطلاعات منشأ، توصیفی یا اطلاعات دیگری را درباره پایگاه داده یا محتویات آن ارائه می‌دهد).
-I یا --serverinfo: از کارساز پرس‌وجو کرده و اطلاعات مربوط به کارساز را نمایش می‌دهد.
-M یا --mime: دستور OPTION MIME را به کارساز ارسال می‌کند.

نکته: قابلیت‌های کارساز بررسی نمی‌شوند.

-f یا --formatted: خروجی قالب‌بندی‌شده را فعال می‌کند، یعنی خروجی مناسب برای پردازش‌های بعدی توسط ابزارهای استاندارد UNIX. خیر، این خروجی XML نیست ;-) همچنین پیام‌های خطا و هشدار مانند " No matches...", " Invalid strategy..." و غیره به جای stdout به stderr ارسال می‌شوند.

قالب:
-I, -i, -H و موارد مشابه:
host<TAB>port
<SPC><SPC>line1
<SPC><SPC>line2
...
-S:
host<TAB>port<TAB>strategy1<TAB>short description1
host<TAB>port<TAB>strategy2<TAB>short description2
...
-D:
host<TAB>port<TAB>database1<TAB>database description1
host<TAB>port<TAB>database2<TAB>database description2
...
-m:
host<TAB>port<TAB>database1<TAB>match1
host<TAB>port<TAB>database2<TAB>match2
...

-a یا --noauth: احراز هویت را غیرفعال می‌کند (یعنی دستور AUTH ارسال نمی‌شود).
-u user یا --user user: نام کاربری را برای احراز هویت تعیین می‌کند.
-k key یا --key key: راز مشترک (shared secret) را برای احراز هویت تعیین می‌کند.
-V یا --version: اطلاعات نگارش را نمایش می‌دهد.
-L یا --license: اطلاعات کپی‌رایت و پروانه را نمایش می‌دهد.
-4: دستور dict را وادار می‌کند تا تنها از نشانی‌های IPv4 استفاده کند.
-6: دستور dict را وادار می‌کند تا تنها از نشانی‌های IPv6 استفاده کند.
--help: اطلاعات راهنما را نمایش می‌دهد.
-v یا --verbose: نمایش با جزئیات بیشتر.
-r یا --raw: بسیار با جزئیات: نمایش تعامل خام کلاینت/کارساز.
--pipesize: اندازه بافر را برای خط لوله‌سازی دستورها مشخص می‌کند. مقدار پیش‌فرض 256 است که باید برای کارهای عمومی کافی بوده و برای بیشتر رسانه‌های انتقال کمتر از MTU باشد. مقادیر بزرگ‌تر بسته به MTU ممکن است بازدهی سریع‌تر یا کندتری ارائه دهند. اگر بافر خیلی کوچک باشد، درخواست‌ها متوالی (serialized) خواهند شد. مقادیر کمتر از 0 و بزرگ‌تر از یک میلیون بدون هشدار به مقداری معقول‌تر تغییر می‌یابند.
--client text: متن اضافه‌ای را مشخص می‌کند که باید با دستور CLIENT ارسال شود.
--debug flag: یک پرچم اشکال‌زدایی را تنظیم می‌کند. پرچم‌های معتبر عبارتند از:

verbose: همانند -v یا --verbose.
raw: همانند -r یا --raw.
scan: اشکال‌زدایی پویشگر (scanner) فایل پیکربندی.
parse: اشکال‌زدایی تجزیه‌کننده (parser) فایل پیکربندی.
pipe: اشکال‌زدایی پشتیبانی از خط لوله TCP (به RFC پروتکل DICT و RFC1854 مراجعه کنید).
serial: غیرفعال کردن پشتیبانی از خط لوله‌سازی.
time: انجام زمان‌سنجی تراکنش‌ها.

پیکربندی (CONFIGURATION)

فایل پیکربندی در حال حاضر ساختار بسیار ساده‌ای دارد. خطوط برای تعیین کارسازها استفاده می‌شوند، برای مثال:

server dict.org

یا به همراه گزینه‌ها:

server dict.org { port 8080 }
server dict.org { user username secret }
server dict.org { port dict user username secret }

گزینه‌های port و user می‌توانند به هر ترتیبی مشخص شوند. گزینه port برای تعیین درگاه اختیاری (مانند 2628) یا سرویس (مانند dict) برای اتصال TCP/IP استفاده می‌شود. گزینه user برای تعیین نام کاربری و راز مشترک جهت استفاده در احراز هویت در این کارساز خاص به کار می‌رود.

کارسازها به ترتیب فهرست‌شده آزمایش می‌شوند تا زمانی که یک اتصال برقرار شود.

وضعیت خروج (EXIT STATUS)

0 پایان موفقیت‌آمیز

20 تطابقی یافت نشد
21 تطابق‌های تقریبی پیدا شد
22 هیچ پایگاه داده‌ای در دسترس نیست
23 هیچ راهبردی در دسترس نیست

30 کد پاسخ غیرمنتظره از کارساز
31 کارساز موقتاً در دسترس نیست
32 کارساز در حال خاموش شدن است
33 خطای نحوی، دستور ناشناخته است
34 خطای نحوی، پارامترهای نامعتبر
35 دستور پیاده‌سازی نشده است
36 پارامتر دستور پیاده‌سازی نشده است
37 دسترسی رد شد
38 احراز هویت ناموفق بود
39 پایگاه داده نامعتبر است
40 راهبرد نامعتبر است
41 اتصال به کارساز ناموفق بود

دست‌اندرکاران (CREDITS)

dict توسط Rik Faith (faith@cs.unc.edu) نوشته شده و تحت شرایط پروانه عمومی همگانی گنو (GPL) توزیع می‌شود. اگر نیاز دارید تحت شرایط دیگری آن را توزیع کنید، به نویسنده بنویسید.

کتابخانه‌های اصلی استفاده‌شده توسط این برنامه (zlib، regex، libmaa) تحت شرایط متفاوتی توزیع می‌شوند، بنابراین ممکن است بتوانید از این کتابخانه‌ها برای برنامه‌هایی که با GPL ناسازگار هستند استفاده کنید -- لطفاً برای اطلاعات بیشتر به اعلان‌های کپی‌رایت و اطلاعات پروانه همراه کتابخانه‌ها مراجعه کرده، و برای حل این مسائل با وکیل خود مشورت نمایید.

گزارش باگ‌ها (BUGS)

اگر یک نشانی وب dict: در خط فرمان داده شود، تنها اولین مورد استفاده خواهد شد. بقیه نادیده گرفته می‌شوند.

اگر یک نشانی وب dict: حاوی مشخص‌کننده‌ای برای n-امین تعریف یا تطابق یک واژه باشد، نادیده گرفته شده و تمام تعاریف یا تطابق‌ها ارائه می‌شوند. این رفتار ناقض RFC است و در انتشار‌های بعدی اصلاح خواهد شد.

اگر یک نشانی وب dict: شامل راز مشترک باشد، به‌درستی تجزیه نخواهد شد.

هنگامی که دستور OPTION MIME به کارساز ارسال می‌شود (گزینه -M) ، قابلیت‌های کارساز بررسی نمی‌شوند.

فایل‌ها (FILES)

~/.dictrc: فایل پیکربندی کاربر برای dict
/etc/dict/dict.conf: فایل پیکربندی سیستمی dict

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

dictd(8), dictzip(1), http://www.dict.org, RFC 2229