.\" dict.1 -- .\" Created: Tue Jul 8 11:36:19 1997 by faith@acm.org .\" Copyright 1997, 1998, 1999, 2002 Rickard E. Faith (faith@acm.org) .\" Copyright 2002-2008 Aleksey Cheusov (vle@gmx.net) .\" .\" Permission is granted to make and distribute verbatim copies of this .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" .\" Permission is granted to copy and distribute modified versions of this .\" manual under the conditions for verbatim copying, provided that the .\" entire resulting derived work is distributed under the terms of a .\" permission notice identical to this one .\" .\" Since the Linux kernel and libraries are constantly changing, this .\" manual page may be incorrect or out-of-date. The author(s) assume no .\" responsibility for errors or omissions, or for damages resulting from .\" the use of the information contained herein. The author(s) may not .\" have taken the same level of care in the production of this manual, .\" which is licensed free of charge, as they might when working .\" professionally. .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. .\" .TH DICT 1 "15 February 1998" "" "" .SH "نام (NAME)" dict \- کلاینت پروتکل DICT .SH "خلاصه دستور (SYNOPSIS)" .nf .BI dict " word" .br .BI dict " [options] [word]" .br .BI dict " [options] dict://host:port/d:word:database" .br .BI dict " [options] dict://host:port/m:word:database:strategy" .fi .SH "توضیحات (DESCRIPTION)" .B dict یک کلاینت برای پروتکل کارساز واژه‌نامه (DICT) است؛ یک پروتکل پرس‌وجو/پاسخ مبتنی بر تراکنش TCP که دسترسی به تعاریف واژه‌نامه‌ای را از مجموعه‌ای از پایگاه‌های داده واژه‌نامه زبان طبیعی فراهم می‌کند. وضعیت خروج در صورت موفقیت‌آمیز بودن عملیات 0 و در غیر این صورت مقداری غیر صفر است. .br بخش .B "وضعیت خروج (EXIT STATUS)" را ببینید. .SH "گزینه‌ها (OPTIONS)" .TP .BI \-h " server\fR یا " \-\-host " server" نام میزبان را برای کارساز DICT مشخص می‌کند. ترکیب‌های کارساز/درگاه می‌توانند در فایل پیکربندی تعیین شوند. اگر هیچ کارسازی در فایل پیکربندی یا در خط فرمان مشخص نشده باشد، .B dict با شکست مواجه خواهد شد. اگر جستجوی IP برای یک کارساز به فهرستی از نشانی‌های IP گسترش یابد (همان‌طور که در حال حاضر dict.org عمل می‌کند)، هر IP به ترتیب فهرست‌شده آزمایش خواهد شد. .TP .BI \-p " service\fR یا " \-\-port " service" درگاه (مانند 2628) یا سرویس (مانند dict) را برای اتصال‌ها مشخص می‌کند. پیش‌فرض 2628 است، همان‌طور که در RFC پروتکل DICT مشخص شده است. ترکیب‌های کارساز/درگاه می‌توانند در فایل پیکربندی تعیین شوند. .TP .BI \-d " dbname\fR یا " \-\-database " dbname" یک پایگاه داده خاص را برای جستجو تعیین می‌کند. حالت پیش‌فرض، جستجو در تمام پایگاه‌های داده است ("*" در پروتکل DICT). توجه داشته باشید که "!" در پروتکل DICT به معنای جستجو در تمام پایگاه‌های داده تا زمان یافتن یک تطابق و سپس توقف جستجو است. .TP .BR \-m " یا " \-\-match به جای چاپ یک تعریف، یک تطابق را با استفاده از راهبرد مشخص‌شده انجام می‌دهد. .TP .BI \-s " strategy\fR یا " \-\-strategy " strategy" یک راهبرد تطابق را مشخص می‌کند. به‌طور پیش‌فرض از راهبرد تطابق پیش‌فرض کارساز استفاده می‌شود. این معمولاً برای تعاریف "exact" و برای تطابق‌ها نوعی راهبرد تصحیح املایی است ("." در پروتکل DICT). راهبردهای موجود به پیاده‌سازی کارساز بستگی دارند. برای دیدن فهرستی از راهبردهای در دسترس، گزینه \-S یا \-\-strats را ببینید. .TP .BR \-C " یا " \-\-nocorrect معمولاً اگر تعریفی درخواست شود و واژه یافت نشود، تصحیح املایی از کارساز درخواست شده و فهرستی از واژه‌های احتمالی ارائه می‌شود. این گزینه تولید این فهرست را غیرفعال می‌کند. .TP .BI \-c " file\fR یا " \-\-config " file" فایل پیکربندی را مشخص می‌کند. حالت پیش‌فرض این است که .I ~/.dictrc و .IR /etc/dict/dict.conf آزموده شوند و نخستین فایلی که وجود دارد استفاده شود. اگر یک فایل پیکربندی خاص تعیین شود، موارد پیش‌فرض آزموده نخواهند شد. .TP .BR \-D " یا " \-\-dbs از کارساز پرس‌وجو کرده و فهرستی از پایگاه‌های داده در دسترس را نمایش می‌دهد. .TP .BR \-S " یا " \-\-strats از کارساز پرس‌وجو کرده و فهرستی از راهبردهای جستجوی در دسترس را نمایش می‌دهد. .TP .BR \-H " یا " \-\-serverhelp از کارساز پرس‌وجو کرده و اطلاعات راهنمایی را که ارائه می‌دهد نمایش می‌دهد. .TP .BI \-i " dbname\fR یا " \-\-info " dbname" اطلاعات مربوط به پایگاه داده مشخص‌شده را درخواست می‌کند (معمولاً کارساز اطلاعات منشأ، توصیفی یا اطلاعات دیگری را درباره پایگاه داده یا محتویات آن ارائه می‌دهد). .TP .BR \-I " یا " \-\-serverinfo از کارساز پرس‌وجو کرده و اطلاعات مربوط به کارساز را نمایش می‌دهد. .TP .BR \-M " یا " \-\-mime دستور .I OPTION MIME را به کارساز ارسال می‌کند. .RS .B نکته: قابلیت‌های کارساز بررسی نمی‌شوند. .RE .TP .BR \-f " یا " \-\-formatted خروجی قالب‌بندی‌شده را فعال می‌کند، یعنی خروجی مناسب برای پردازش‌های بعدی توسط ابزارهای استاندارد UNIX. خیر، این خروجی XML نیست ;\-) همچنین پیام‌های خطا و هشدار مانند " No matches...", " Invalid strategy..." و غیره به جای stdout به stderr ارسال می‌شوند. .RS .B قالب: \-I, \-i, \-H و موارد مشابه: .br hostport .br line1 .br line2 .br ... \-S: .br hostportstrategy1short description1 .br hostportstrategy2short description2 .br ... \-D: .br hostportdatabase1database description1 .br hostportdatabase2database description2 .br ... .br \-m: .br hostportdatabase1match1 .br hostportdatabase2match2 .br ... .RE .TP .BR \-a " یا " \-\-noauth احراز هویت را غیرفعال می‌کند (یعنی دستور AUTH ارسال نمی‌شود). .TP .BI \-u " user\fR یا " \-\-user " user" نام کاربری را برای احراز هویت تعیین می‌کند. .TP .BI \-k " key\fR یا " \-\-key " key" راز مشترک (shared secret) را برای احراز هویت تعیین می‌کند. .TP .BR \-V " یا " \-\-version اطلاعات نگارش را نمایش می‌دهد. .TP .BR \-L " یا " \-\-license اطلاعات کپی‌رایت و پروانه را نمایش می‌دهد. .TP .BR \-4 دستور dict را وادار می‌کند تا تنها از نشانی‌های IPv4 استفاده کند. .TP .BR \-6 دستور dict را وادار می‌کند تا تنها از نشانی‌های IPv6 استفاده کند. .TP .B \-\-help اطلاعات راهنما را نمایش می‌دهد. .TP .BR -v " یا " \-\-verbose نمایش با جزئیات بیشتر. .TP .BR -r " یا " \-\-raw بسیار با جزئیات: نمایش تعامل خام کلاینت/کارساز. .TP .B \-\-pipesize اندازه بافر را برای خط لوله‌سازی دستورها مشخص می‌کند. مقدار پیش‌فرض 256 است که باید برای کارهای عمومی کافی بوده و برای بیشتر رسانه‌های انتقال کمتر از MTU باشد. مقادیر بزرگ‌تر بسته به MTU ممکن است بازدهی سریع‌تر یا کندتری ارائه دهند. اگر بافر خیلی کوچک باشد، درخواست‌ها متوالی (serialized) خواهند شد. مقادیر کمتر از 0 و بزرگ‌تر از یک میلیون بدون هشدار به مقداری معقول‌تر تغییر می‌یابند. .TP .BI \-\-client " text" متن اضافه‌ای را مشخص می‌کند که باید با دستور CLIENT ارسال شود. .TP .BI \-\-debug " flag" یک پرچم اشکال‌زدایی را تنظیم می‌کند. پرچم‌های معتبر عبارتند از: .RS .TP .B verbose همانند .BR \-v " یا " \-\-verbose . .TP .B raw همانند .BR \-r " یا " \-\-raw . .TP .B scan اشکال‌زدایی پویشگر (scanner) فایل پیکربندی. .TP .B parse اشکال‌زدایی تجزیه‌کننده (parser) فایل پیکربندی. .TP .B pipe اشکال‌زدایی پشتیبانی از خط لوله TCP (به RFC پروتکل DICT و RFC1854 مراجعه کنید). .TP .B serial غیرفعال کردن پشتیبانی از خط لوله‌سازی. .TP .B time انجام زمان‌سنجی تراکنش‌ها. .SH "پیکربندی (CONFIGURATION)" فایل پیکربندی در حال حاضر ساختار بسیار ساده‌ای دارد. خطوط برای تعیین کارسازها استفاده می‌شوند، برای مثال: .RS server dict.org .RE یا به همراه گزینه‌ها: .RS server dict.org { port 8080 } .br server dict.org { user username secret } .br server dict.org { port dict user username secret } .RE گزینه‌های .B port و .B user می‌توانند به هر ترتیبی مشخص شوند. گزینه .B port برای تعیین درگاه اختیاری (مانند 2628) یا سرویس (مانند dict) برای اتصال TCP/IP استفاده می‌شود. گزینه .B user برای تعیین نام کاربری و راز مشترک جهت استفاده در احراز هویت در این کارساز خاص به کار می‌رود. .P کارسازها به ترتیب فهرست‌شده آزمایش می‌شوند تا زمانی که یک اتصال برقرار شود. .SH "وضعیت خروج (EXIT STATUS)" .br 0 پایان موفقیت‌آمیز .P 20 تطابقی یافت نشد .br 21 تطابق‌های تقریبی پیدا شد .br 22 هیچ پایگاه داده‌ای در دسترس نیست .br 23 هیچ راهبردی در دسترس نیست .P 30 کد پاسخ غیرمنتظره از کارساز .br 31 کارساز موقتاً در دسترس نیست .br 32 کارساز در حال خاموش شدن است .br 33 خطای نحوی، دستور ناشناخته است .br 34 خطای نحوی، پارامترهای نامعتبر .br 35 دستور پیاده‌سازی نشده است .br 36 پارامتر دستور پیاده‌سازی نشده است .br 37 دسترسی رد شد .br 38 احراز هویت ناموفق بود .br 39 پایگاه داده نامعتبر است .br 40 راهبرد نامعتبر است .br 41 اتصال به کارساز ناموفق بود .SH "دست‌اندرکاران (CREDITS)" .B dict توسط Rik Faith (faith@cs.unc.edu) نوشته شده و تحت شرایط پروانه عمومی همگانی گنو (GPL) توزیع می‌شود. اگر نیاز دارید تحت شرایط دیگری آن را توزیع کنید، به نویسنده بنویسید. .P کتابخانه‌های اصلی استفاده‌شده توسط این برنامه (zlib، regex، libmaa) تحت شرایط متفاوتی توزیع می‌شوند، بنابراین ممکن است بتوانید از این کتابخانه‌ها برای برنامه‌هایی که با GPL ناسازگار هستند استفاده کنید \-\- لطفاً برای اطلاعات بیشتر به اعلان‌های کپی‌رایت و اطلاعات پروانه همراه کتابخانه‌ها مراجعه کرده، و برای حل این مسائل با وکیل خود مشورت نمایید. .SH "گزارش باگ‌ها (BUGS)" اگر یک نشانی وب .B dict: در خط فرمان داده شود، تنها اولین مورد استفاده خواهد شد. بقیه نادیده گرفته می‌شوند. .P اگر یک نشانی وب .B dict: حاوی مشخص‌کننده‌ای برای n-امین تعریف یا تطابق یک واژه باشد، نادیده گرفته شده و تمام تعاریف یا تطابق‌ها ارائه می‌شوند. این رفتار ناقض RFC است و در انتشار‌های بعدی اصلاح خواهد شد. .P اگر یک نشانی وب .B dict: شامل راز مشترک باشد، به‌درستی تجزیه نخواهد شد. .P هنگامی که دستور .I OPTION MIME به کارساز ارسال می‌شود .RI "(گزینه " \-M ")" ، قابلیت‌های کارساز بررسی نمی‌شوند. .SH "فایل‌ها (FILES)" .TP .I ~/.dictrc فایل پیکربندی کاربر برای .B dict .TP .I /etc/dict/dict.conf فایل پیکربندی سیستمی .B dict .SH "همچنین ببینید (SEE ALSO)" .BR dictd (8), .BR dictzip (1), .BR http://www.dict.org , .B RFC 2229