.\" -*- nroff -*- .\" .\" zssh.1 .\" .\" Author: Matthieu Lucotte .\" .\" Copyright (c) 2000 Matthieu Lucotte France .\" All rights reserved .\" .\" Created: Mon Jun 26 23:18:13 2000 .TH ZSSH 1 "June 26, 2000" "ZSSH" "ZSSH" .SH "نام (NAME)" zssh \- پوشش تعاملی انتقال فایل برای ssh .SH "خلاصه دستور (SYNOPSIS)" .B zssh [گزینه‌های zssh] [--] [گزینه‌های ssh] .br .B ztelnet [گزینه‌های zssh] [--] [گزینه‌های telnet] .SH "توضیحات (DESCRIPTION)" .LP .B zssh (Zmodem SSH) برنامه‌ای برای انتقال تعاملی فایل‌ها به یک ماشین دوردست همگام با استفاده از پوستهٔ امن ( .B ssh ) است. این ابزار به عنوان جایگزینی راحت برای .B scp در نظر گرفته شده است که امکان انتقال فایل‌ها را بدون نیاز به باز کردن نشستی دیگر و احراز هویت مجدد فراهم می‌کند. برنامهٔ zssh یک پوشش تعاملی برای ssh است که جهت جابه‌جایی اتصال ssh میان پوستهٔ دوردست و انتقال فایل استفاده می‌شود. این کار با استفاده از یک جفت tty/pty دیگر میان کاربر و فرایند محلی ssh انجام می‌گیرد تا tty کاربر (حالت پوستهٔ دوردست) یا فرایندی دیگر (حالت انتقال فایل) را به اتصال ssh متصل کند. عملکرد ztelnet مشابه zssh است، با این تفاوت که به جای ssh از telnet استفاده می‌شود. این دستور معادل 'zssh -s "telnet -8 -E"' است. فایل‌ها از طریق پروتکل .I zmodem و با استفاده از دستورهای .B rz و .B sz منتقل می‌شوند. برنامهٔ zssh مانند یک نشست معمولی ssh رفتار می‌کند تا زمانی که توالی گریز (escape sequence) فشرده شود (پیش‌فرض .B ^@ است که می‌تواند با فشردن C-space، یا C-2، یا C-` ایجاد شود)، که حالت انتقال فایل را فعال می‌کند. سپس یک خط فرمان جدید نمایش داده می‌شود و می‌توان دستورها را به‌طور محلی برای آغاز انتقال فایل (در میان کارهای دیگر) اجرا کرد. رفتار آن تقریباً شبیه به یک پوستهٔ محلی با امکان ویرایش خط، تاریخچه و تکمیل خودکار (به لطف libreadline)، بسط الگو (globbing) و نویسه‌های گریز ( " و ' و \\ ) است. دستورهای توکار زیر توسط خود zssh مدیریت می‌شوند: .B ? , .B cd , .B disconnect , .B escape , .B exit , .B help , .B hook , .B quit , .B repeat , .B rz , .B suspend , .B sz , .B version .PP .PD 0 .TP 20 .B cd تغییر دایرکتوری جاری .TP 20 .B disconnect قطع اتصال و خروج .TP 20 .B escape [^X] تغییر کلید گریز به ^X. بدون آرگومان، کلید گریز فعلی را چاپ می‌کند .TP 20 .B exit خروج از حالت انتقال فایل. کلید ^D نیز می‌تواند برای این منظور استفاده شود. .TP 20 .B help چاپ راهنما و نکات .TP .B ? .TP 20 .B hook prg [args] قلاب کردن برنامهٔ 'prg' روی pty. ورودی و خروجی استاندارد آن از کانال ssh عبور خواهد کرد. .br تایپ کردن 'sz'/'rz' در واقع معادل 'hook sz'/'hook rz' است .br داشتن تخیلی غریب برای بهره‌گیری کامل از این ویژگی بسیار مفید است. .TP 20 .B quit مشابه exit. .TP 20 .B repeat دستور cmd را برای همیشه تکرار می‌کند (^C برای متوقف کردن). به عنوان مثال زمانی مفید است که از یک اسکریپت دوردست فراخوانندهٔ "sz" استفاده می‌کنید و نمی‌خواهید هر بار "rz" را تایپ کنید... با این حال به یاد داشته باشید که چندین فایل را می‌توان با یک جفت sz/rz منتقل کرد، بنابراین معمولاً نیازی به استفاده از repeat نیست. .TP 20 .B rz دریافت فایل‌ها از ماشین دوردست. rz را اجرا کرده و فرایند را به اتصال ssh متصل می‌کند. اجرای sz روی ماشین دوردست (REMOTE) الزامی است: .TP 25 .B \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 1) اجرای `sz ...' از پوستهٔ ماشین دوردست .TP .B \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 2) فشردن توالی گریز (C-space) برای ورود به حالت انتقال فایل .TP .B \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ 3) اجرای دستور توکار `rz' .TP 20 .B suspend معلق کردن zssh (بازگشت به پوستهٔ ماشین محلی) .TP 20 .B sz ... ارسال فایل‌ها به ماشین دوردست. sz را اجرا کرده و فرایند را به اتصال ssh متصل می‌کند. نیازی به اجرای دستی rz در سمت دوردست نیست. .TP 20 .B version چاپ اطلاعات نسخه .PD .PP دستورهای توکار .B rz , .B sz , .B hook و .B exit پس از اتمام به حالت پوسته بازمی‌گردند. .SH "گزینه‌ها (OPTIONS)" .LP .PP .PD 0 .TP 20 .B -f .TP .B --force هیچ سؤالی از کاربر پرسیده نشود .TP .B -h .TP .B --help نمایش راهنمای پایه .TP .B -s cmd .TP .B --shell cmd اجرای cmd به عنوان پوستهٔ دوردست به جای پیش‌فرض "ssh -e none" (در zssh) یا "telnet -8 -E" (در ztelnet) .br مثال: zssh -s "rsh -x" .TP .B -V .TP .B --version نمایش نسخه .TP .B -z ^X .TP .B --zssh-escape ^X تنظیم توالی گریز روی ^X .PD .PP .B -- می‌تواند برای جداسازی گزینه‌های zssh از گزینه‌های ssh استفاده شود .br سایر آرگومان‌ها عیناً به ssh/telnet/غیره ارسال می‌شوند. .SH "محیط (ENVIRONMENT)" .LP .PP .PD 0 .TP 10 .B ZSSHESCAPE تنظیم متغیر محیطی ZSSHESCAPE امکان بازنویسی توالی گریز پیش‌فرض را فراهم می‌کند. ZSSHESCAPE باید تنها شامل دو نویسه به صورت `^X' باشد، به این معنی که ^X توالی گریز جدید خواهد بود. .PD .PP .SH "نیازمندی‌ها (REQUIREMENTS)" .LP برای کارکرد صحیح zssh باید باینری‌های زیر به درستی نصب شده باشند: .TP 10 .B ssh/telnet/... پوستهٔ دوردستی که باید اجرا شود (ماشین محلی) .TP .B sz rz برنامه‌های ارسال و دریافت zmodem. باید هم در ماشین محلی و هم در ماشین دوردست موجود باشند و (ترجیحاً) نسخه‌های سازگاری داشته باشند. .LP .SH "نکات (TIPS)" .LP اگر انتقال فایل آغاز شود اما هرگز پایان نیابد .br ( یعنی خطی مانند: Bytes Sent: 38144/4610624 BPS:3424 ETA 22:15 یا Bytes Sent: 0/ 513 BPS:0 ETA 00:00 Retry 0: Got ZCAN دیده شود، ولی انتقال هرگز به اتمام نرسد .br ) .br به احتمال زیاد pty/tty در یکی از سیستم‌ها ۸ بیتی تمیز (8-bit clean) نیست. (لینوکس 8-bit clean است، NetBSD نیست). .br استفاده از گزینهٔ -e (escape) در rz باید این مشکل را حل کند. انتقال‌ها را می‌توان با ^C متوقف کرد (تا حدی تجربی است =) اگر در rz/sz گیر افتادید (برای مثال rz را اجرا کردید، اما سپس تصمیم گرفتید چیزی ارسال نکنید)، حدود ده بار ^X (کلید Ctrl-X، نه گریز zssh!) را فشار دهید تا متوقف شود از `sz -y ' برای بازنویسی فایل‌ها در سمت دیگر استفاده کنید .SH "گزارش باگ‌ها (BUGS)" .LP گاهی اوقات ممکن است پس از اتمام انتقال فایل لازم باشد ۲ یا ۳ بار کلید Return را فشار دهید تا به پوسته برگردید. معمولاً چند رقم نمایش داده می‌شود؛ نگران نباشید آسیبی نمی‌زند (به شما یا ترمینال شما) ... گاهی ممکن است tty پس از یک انتقال قطع‌شده (با استفاده از ^C) دچار به‌هم‌ریختگی شود. در این صورت تایپ کردن `reset' باید کمک کند. پشتیبانی از لوله (pipe)، بازهدایت (redirection) و موارد دیگر در این پوسته وجود ندارد... اما به هر حال پوسته‌های فوق‌العاده‌ای از قبل وجود دارند =) .SH "قدردانی‌ها (CREDITS)" نویسندهٔ ttssh \- رابرت اوکالاهان (Robert O'Callahan) \- برای ایدهٔ اصلی تیم SourceForge. .SH "نویسندگان (AUTHORS)" Matthieu Lucotte وبگاه zssh: .SH "همچنین ببینید (SEE ALSO)" .BR ssh (1), .BR telnet (1), .BR scp (1), .BR sz (1), .BR rz (1), .BR readline (3)