''' $Id: cu.1,v 1.10 2002/03/05 22:13:33 ian Rel $
.TH cu 1 "Taylor UUCP 1.07"
.SH "نام (NAME)"
cu \- برقراری ارتباط با سامانه‌ای دیگر
.SH "خلاصه دستور (SYNOPSIS)"
.B cu
[ options ] [ system | phone | "dir" ]
.SH "توضیحات (DESCRIPTION)"
دستور
.I cu
برای تماس با سامانه‌ای دیگر و عمل کردن به عنوان یک پایانهٔ شماره‌گیری (dial-in) استفاده می‌شود. این دستور همچنین می‌تواند انتقال سادهٔ فایل‌ها را بدون بررسی خطا انجام دهد.

.I cu
به جز گزینه‌ها، تنها یک آرگومان دریافت می‌کند. اگر آرگومان رشتهٔ "dir" باشد، cu یک اتصال مستقیم به درگاه برقرار می‌کند. این حالت تنها توسط کاربرانی که دسترسی نوشتن به درگاه را دارند قابل استفاده است، چرا که اجازهٔ برنامه‌ریزی مجدد مودم را می‌دهد.

در غیر این صورت، اگر آرگومان با یک رقم آغاز شود، به عنوان یک شماره تلفن برای تماس در نظر گرفته می‌شود. در غیر این صورت، به عنوان نام سامانه‌ای برای تماس در نظر گرفته خواهد شد. برای نام‌گذاری سامانه‌ای که نام آن با رقم شروع می‌شود می‌توان از گزینهٔ
.B \-z
یا
.B \-\-system
استفاده کرد، و برای مشخص کردن شماره تلفنی که با رقم شروع نمی‌شود می‌توان از گزینهٔ
.B \-c
یا
.B \-\-phone
بهره برد.

.I cu
درگاه مورد استفاده را در فایل‌های پیکربندی UUCP پیدا می‌کند. اگر یک نام سامانه‌ی ساده داده شود، درگاهی مناسب برای آن سامانه انتخاب خواهد شد. از گزینه‌های
.B \-p, \-\-port, \-l, \-\-line, \-s
و
.B \-\-speed
می‌توان برای کنترل انتخاب درگاه استفاده کرد.

هنگامی که اتصال به سامانهٔ دوردست برقرار شود،
.I cu
به دو فرایند منشعب (fork) می‌شود. یکی از درگاه می‌خواند و در پایانه می‌نویسد، در حالی که دیگری از پایانه می‌خواند و در درگاه می‌نویسد.

.I cu
چندین دستور ارائه می‌دهد که می‌توان حین گفتگو از آن‌ها استفاده کرد. تمامی دستورها با یک نویسهٔ گریز (escape character) آغاز می‌شوند که در ابتدا
.B ~
(تیلدا) است. نویسهٔ گریز تنها در ابتدای خط شناسایی می‌شود. برای ارسال یک نویسهٔ گریز به سامانهٔ دوردست در آغاز خط، باید آن را دو بار وارد کرد. همهٔ دستورها یا یک تک‌نویسه هستند یا واژه‌ای که با
.B %
(علامت درصد) آغاز می‌شود.

.I cu
دستورهای زیر را می‌شناسد:

.TP 5
.B ~.
پایان دادن به گفتگو.
.TP 5
.B ~! command
اجرای command در یک پوسته. اگر command خالی باشد، یک پوسته اجرا می‌کند.
.TP 5
.B ~$ command
اجرای command و ارسال خروجی استاندارد به سامانهٔ دوردست.
.TP 5
.B ~| command
اجرای command با دریافت ورودی استاندارد از سامانهٔ دوردست.
.TP 5
.B ~+ command
اجرای command با دریافت ورودی استاندارد از سامانهٔ دوردست و ارسال خروجی استاندارد به سامانهٔ دوردست.
.TP 5
.B ~#, ~%break
ارسال سیگنال break، در صورت امکان.
.TP 5
.B ~c directory, ~%cd directory
تغییر دایرکتوری محلی.
.TP 5
.B ~> file
ارسال یک فایل به سامانهٔ دوردست. این دستور صرفاً فایل را روی خط ارتباطی می‌ریزد (dump می‌کند). فرض بر این است که سامانهٔ دوردست منتظر آن است.
.TP 5
.B ~<
دریافت یک فایل از سامانهٔ دوردست. این دستور نام فایل محلی و دستور دوردست را برای اجرا جهت شروع انتقال فایل درخواست می‌کند. پذیرش داده‌ها تا زمانی که محتویات متغیر
.B eofread
دیده شود ادامه می‌یابد.
.TP 5
.B ~p from to, ~%put from to
ارسال یک فایل به سامانهٔ دوردست Unix. این دستور فرامین مناسب را در سامانهٔ دوردست اجرا می‌کند.
.TP 5
.B ~t from to, ~%take from to
دریافت یک فایل از سامانهٔ دوردست Unix. این دستور فرامین مناسب را در سامانهٔ دوردست اجرا می‌کند.
.TP 5
.B ~s variable value
تنظیم مقدار یک متغیر
.I cu
به مقدار داده‌شده. اگر مقداری داده نشود، متغیر روی
.B true
تنظیم می‌شود.
.TP 5
.B ~! variable
تنظیم مقدار یک متغیر
.I cu
به
.B false.
.TP 5
.B ~z
تعلیق نشست cu. این ویژگی فقط روی برخی سامانه‌ها پشتیبانی می‌شود. در سامانه‌هایی که از ^Z برای تعلیق یک کار استفاده می‌شود،
.B ~^Z
نیز نشست را تعلیق خواهد کرد.
.TP 5
.B ~%nostop
غیرفعال کردن مدیریت XON/XOFF.
.TP 5
.B ~%stop
فعال کردن مدیریت XON/XOFF.
.TP 5
.B ~v
فهرست کردن تمام متغیرها و مقادیر آن‌ها.
.TP 5
.B ~?
فهرست کردن تمام دستورها.

.I cu
همچنین از چندین متغیر پشتیبانی می‌کند. این متغیرها را می‌توان با دستور
.B ~v
فهرست کرد، و با دستورهای
.B ~s
یا
.B ~!
تنظیم نمود.

.TP 5
.B escape
نویسهٔ گریز. در ابتدا
.B ~
(تیلدا) است.
.TP 5
.B delay
اگر این متغیر true باشد،
.I cu
پس از تشخیص نویسهٔ گریز، یک ثانیه پیش از چاپ نام سامانهٔ محلی درنگ می‌کند. مقدار پیش‌فرض true است.
.TP 5
.B eol
فهرست نویسه‌هایی که پایان خط در نظر گرفته می‌شوند. نویسهٔ گریز تنها پس از مشاهدهٔ یکی از این موارد تشخیص داده می‌شود. مقدار پیش‌فرض شامل carriage return و ^U، ^C، ^O، ^D، ^S، ^Q، ^R است.
.TP 5
.B binary
مشخص می‌کند که آیا داده‌های باینری هنگام ارسال فایل منتقل شوند یا خیر. اگر این مقدار false باشد، خط‌های جدید در فایل ارسالی به carriage return تبدیل می‌شوند. مقدار پیش‌فرض false است.
.TP 5
.B binary-prefix
رشته‌ای که در صورت true بودن متغیر
.B binary ،
پیش از ارسال یک نویسهٔ باینری در انتقال فایل استفاده می‌شود. مقدار پیش‌فرض ^V است.
.TP 5
.B echo-check
بررسی انتقال فایل با بررسی بازتابی که سامانهٔ دوردست برمی‌گرداند. این قابلیت احتمالاً چندان خوب کار نمی‌کند. مقدار پیش‌فرض false است.
.TP 5
.B echonl
نویسه‌ای که پس از ارسال هر خط از یک فایل، برنامه منتظر آن می‌ماند. مقدار پیش‌فرض carriage return است.
.TP 5
.B timeout
مهلت زمانی مورد استفاده، بر حسب ثانیه، هنگام انتظار برای دریافت یک نویسه، چه در بررسی بازتاب (echo) و چه هنگام انتظار برای نویسهٔ
.B echonl .
مقدار پیش‌فرض ۳۰ است.
.TP 5
.B kill
نویسه‌ای که در صورت شکست بررسی بازتاب، برای حذف خط استفاده می‌شود. مقدار پیش‌فرض ^U است.
.TP 5
.B resend
تعداد دفعات ارسال مجدد یک خط، در صورتی که بررسی بازتاب همچنان با شکست مواجه شود. مقدار پیش‌فرض ۱۰ است.
.TP 5
.B eofwrite
رشته‌ای که پس از ارسال یک فایل با دستور
.B ~>
نوشته می‌شود. مقدار پیش‌فرض ^D است.
.TP 5
.B eofread
رشته‌ای که هنگام دریافت فایل با دستور
.B ~<
برنامه منتظر آن می‌ماند. مقدار پیش‌فرض $ است که به عنوان اعلان معمول پوسته در نظر گرفته شده است.
.TP 5
.B verbose
مشخص می‌کند که آیا اطلاعات انباشته‌شده حین انتقال فایل چاپ شود یا خیر. مقدار پیش‌فرض true است.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های زیر را می‌توان به
.I cu
داد:
.TP 5
.B \-e, \-\-parity=even
استفاده از توازن زوج (even parity).
.TP 5
.B \-o, \-\-parity=odd
استفاده از توازن فرد (odd parity).
.TP 5
.B \-\-parity=none
عدم استفاده از توازن. همچنین اگر هر دو گزینهٔ
.B \-e
و
.B \-o
داده شوند، هیچ توازنی استفاده نخواهد شد.
.TP 5
.B \-h, \-\-halfduplex
بازتاب محلی نویسه‌ها (حالت نیمه‌دوطرفه یا half-duplex).
.TP 5
.B \-\-nostop
غیرفعال کردن مدیریت XON/XOFF (به طور پیش‌فرض فعال است).
.TP 5
.B \-E char, \-\-escape char
تنظیم نویسهٔ گریز. در ابتدا
.B ~
(تیلدا) است. برای حذف نویسهٔ گریز، از
.B -E ''
استفاده کنید.
.TP 5
.B \-z system, \-\-system system
سامانه‌ای که باید با آن تماس گرفته شود.
.TP 5
.B \-c phone-number, \-\-phone phone-number
شماره تلفنی که باید با آن تماس گرفته شود.
.TP 5
.B \-p port, \-\-port port
مشخص کردن نام درگاه مورد استفاده.
.TP 5
.B \-a port
معادل با
.B \-\-port port.
.TP 5
.B \-l line, \-\-line line
مشخص کردن خط مورد استفاده با دادن نام دستگاه. از این گزینه می‌توان برای برقراری تماس روی درگاه‌هایی که در فایل‌های پیکربندی UUCP فهرست نشده‌اند استفاده کرد. دسترسی نوشتن به دستگاه الزامی است.
.TP 5
.B \-s speed, \-\-speed speed
سرعت (baud rate) مورد استفاده.
.TP 5
.B \-#
در صورتی که # یک عدد باشد، معادل با
.B \-\-speed #
است.
.TP 5
.B \-n, \-\-prompt
درخواست دریافت شماره تلفن مورد استفاده.
.TP 5
.B \-d
ورود به حالت اشکال‌زدایی. معادل با
.B \-\-debug all.
.TP 5
.B \-x type, \-\-debug type
فعال کردن انواع خاصی از اشکال‌زدایی. انواع زیر شناخته شده‌اند: abnormal، chat، handshake، uucp-proto، proto، port، config، spooldir، execute، incoming، outgoing. تنها انواع abnormal، chat، handshake، port، config، incoming و outgoing برای
.I cu
معنادار هستند.

می‌توان چندین نوع را با کاما جدا کرد، و گزینهٔ
.B \-\-debug
می‌تواند چندین بار تکرار شود. همچنین می‌توان یک عدد مشخص کرد که به همان تعداد نوع از فهرست بالا را فعال می‌کند؛ برای مثال،
.B \-\-debug 2
معادل است با
.B \-\-debug abnormal,chat.
از
.B \-\-debug all
می‌توان برای فعال کردن تمام گزینه‌های اشکال‌زدایی استفاده کرد.
.TP 5
.B \-I file, \-\-config file
تعیین فایل پیکربندی مورد استفاده. بسته به نحوهٔ کامپایل شدن
.I cu ،
ممکن است این گزینه در دسترس نباشد.
.TP 5
.B \-v, \-\-version
گزارش نسخه و خروج.
.TP 5
.B \-\-help
چاپ پیام راهنما و خروج.
.SH "گزارش باگ‌ها (BUGS)"
این برنامه چندان خوب کار نمی‌کند.
.SH "نویسندگان (AUTHORS)"
Ian Lance Taylor
<ian@airs.com>