.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "kitten-transfer" 1 "Jul 30, 2026" "0.48.2" "kitty" .SH "نام (NAME)" kitten-transfer \- انتقال آسان فایل‌ها از طریق دستگاه TTY .SH "نمای کلی (OVERVIEW)" .sp افزوده شده در نسخه 0.30.0. .sp انتقال فایل‌ها به رایانه‌های دوردست و از آن‌ها از طریق خود دستگاه \fBTTY\fP\&. این بدان معناست که انتقال فایل در نشست‌های تو در توی SSH، پیوندهای سریال و غیره کار می‌کند\&. هر جا که یک دستگاه ترمینال داشته باشید، می‌توانید فایل‌ها را منتقل کنید\&. .sp این kitten از انتقال کل درخت دایرکتوری، حفظ پیوندهای نمادین و سخت، مجوزهای فایل، زمان‌ها و غیره پشتیبانی می‌کند\&. حتی از پروتکل rsync \% برای انتقال تنها تغییرات فایل‌های بزرگ پشتیبانی می‌نماید\&. .sp \fBهمچنین ببینید:\fP .INDENT 0.0 .INDENT 3.5 کیتن Remote files \%<> را ببینید\&. .UNINDENT .UNINDENT .SH "کاربرد اولیه (Basic usage)" .sp کافی است با استفاده از ssh kitten \%<> به یک رایانه راه دور متصل شوید و این kitten را اجرا نمایید (که ssh kitten آن را به صورت خودکار در رایانه راه دور برای شما فراهم می‌کند)\&. چند نمونه گویا در زیر آمده است\&. برای کپی کردن یک فایل از یک رایانه راه دور: .INDENT 0.0 .INDENT 3.5 .sp .EX $ kitten ssh my\-remote\-computer $ kitten transfer some\-file /path/on/local/computer .EE .UNINDENT .UNINDENT .sp این کار \fBsome\-file\fP را از رایانه‌ای که به آن SSH زده‌اید به رایانه محلی شما در مسیر \fB/path/on/local/computer\fP کپی می‌کند\&. kitty پیش از مجاز کردن انتقال از شما تاییدیه می‌خواهد تا از پروتکل انتقال فایل نتوان برای خواندن/نوشتن فایل‌ها روی رایانه شما سوءاستفاده کرد\&. .sp برای کپی کردن یک فایل از رایانه محلی به رایانه راه دور: .INDENT 0.0 .INDENT 3.5 .sp .EX $ kitten ssh my\-remote\-computer $ kitten transfer \-\-direction=upload /path/on/local/computer remote\-file .EE .UNINDENT .UNINDENT .sp برای نمونه‌های کاربردی با جزئیات بیشتر، بخش رابط خط فرمان در زیر را ببینید\&. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 اگر مایل به استفاده از ssh kitten نیستید، می‌توانید باینری kitten را خودتان روی رایانه راه دور نصب کنید؛ این یک باینری مستقل و ایستا کامپایل‌شده است که در صفحه انتشارهای kitty \% در دسترس است\&. یا می‌توانید اسکریپت/برنامه خودتان را بنویسید تا از پروتکل زیربنایی انتقال فایل \%<> استفاده کند\&. .UNINDENT .UNINDENT .SH "جلوگیری از اعلان تایید (Avoiding the confirmation prompt)" .sp به طور معمول، هنگامی که انتقال فایلی را آغاز می‌کنید kitty از شما درخواست تایید می‌کند\&. این کار برای اطمینان از این است که برنامه‌های متخاصم فعال روی رایانه دوردست نتوانند بدون اجازه شما فایل‌ها را روی رایانه شما بخوانند یا بنویسند\&. اگر رایانه دوردست قابل اعتماد است، می‌توانید اعلان تایید را به روش‌های زیر غیرفعال کنید: .INDENT 0.0 .IP 1. 3 تنظیم گزینه \fBfile_transfer_confirmation_bypass\fP \%<#\:opt-kitty\:.file_transfer_confirmation_bypass> روی یک گذرواژه مشخص\&. .IP 2. 3 هنگام فراخوانی kitten، استفاده از گزینه \fB\-\-permissions\-bypass\fP برای ارائه گذرواژه‌ای که در مرحله اول تنظیم کرده‌اید\&. .UNINDENT .sp \fBهشدار:\fP .INDENT 0.0 .INDENT 3.5 استفاده از گذرواژه برای دور زدن تایید به این معناست که هر نرم‌افزاری که روی رایانه دوردست اجرا می‌شود می‌تواند به طور بالقوه آن گذرواژه را بیاموزد و از آن برای به دست آوردن دسترسی کامل به رایانه شما استفاده کند\&. .UNINDENT .UNINDENT .SH "انتقال دلتا (Delta transfers)" .sp این kitten امکان استفاده از پروتکل rsync \% را دارد تا تنها تفاوت‌های میان فایل‌ها را منتقل کند\&. برای فعال کردن آن از گزینه \fB\-\-transmit\-deltas\fP استفاده کنید\&. توجه داشته باشید که به دلیل سربار رفت‌وبرگشت، این روش در انتقال فایل‌های کوچک یا در شبکه‌های بسیار سریع در عمل کندتر خواهد بود، بنابراین با احتیاط استفاده شود\&. .SH "کد منبع transfer" .sp کد منبع این kitten در گیت‌هاب در دسترس است: \%\&. .SH "رابط خط فرمان (Command line interface)" .INDENT 0.0 .INDENT 3.5 .sp .EX kitten transfer [options] source_files_or_directories destination_path .EE .UNINDENT .UNINDENT .sp انتقال فایل‌ها از طریق دستگاه TTY\&. به شرط وجود یک اتصال TTY میان دو رایانه (مانند بستر SSH)، می‌تواند برای ارسال فایل‌ها بین آن‌ها استفاده شود\&. از کپی فایل‌ها، دایرکتوری‌ها (به صورت بازگشتی)، پیوندهای نمادین و پیوندهای سخت پشتیبانی می‌کند\&. حتی می‌تواند از پروتکلی مشابه rsync برای کپی کردن تنها تغییرات میان فایل‌ها بهره ببرد\&. هنگام کپی چند فایل، از گزینه \-\-confirm\-paths استفاده کنید تا ببینید دقیقاً چه مواردی کپی خواهند شد\&. ساده‌ترین راه برای استفاده از این kitten این است که ابتدا با ssh kitten به رایانه دوردست متصل شوید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ kitten ssh my\-remote\-computer .EE .UNINDENT .UNINDENT .sp سپس در رایانه دوردست، transfer kitten را برای انجام عملیات کپی اجرا نمایید\&. برای کپی یک فایل از رایانه دوردست به رایانه محلی، اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ kitten transfer remote\-file /path/to/local\-file .EE .UNINDENT .UNINDENT .sp این دستور \fBremote\-file\fP را از رایانه دوردست به \fB/path/to/local\-file\fP در رایانه محلی کپی خواهد کرد\&. .sp به طور مشابه، برای کپی یک فایل از رایانه محلی به رایانه دوردست، اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ kitten transfer \-\-direction=upload /path/to/local\-file remote\-file .EE .UNINDENT .UNINDENT .sp این کار \fB/path/to/local\-file\fP را از رایانه محلی به \fBremote\-file\fP در رایانه دوردست کپی می‌کند\&. .sp چندین فایل را نیز می‌توان کپی کرد: .INDENT 0.0 .INDENT 3.5 .sp .EX $ kitten transfer file1 file2 /path/to/dir/ .EE .UNINDENT .UNINDENT .sp این دستور \fBfile1\fP و \fBfile2\fP را در دایرکتوری \fB/path/to/dir/\fP در رایانه محلی قرار می‌دهد\&. .sp دایرکتوری‌ها را نیز می‌توان به صورت بازگشتی کپی نمود: .INDENT 0.0 .INDENT 3.5 .sp .EX $ kitten transfer dir1 /path/to/dir/ .EE .UNINDENT .UNINDENT .sp این کار \fBdir1\fP و تمام محتویات آن را درون \fB/path/to/dir/\fP در رایانه محلی قرار می‌دهد\&. .sp توجه داشته باشید که هنگام کپی چندین فایل یا دایرکتوری، مقصد باید یک دایرکتوری موجود در رایانه گیرنده باشد\&. مسیرهای نسبی فایل نسبت به دایرکتوری جاری در رایانه اجراکننده kitten، و دایرکتوری خانگی (home) در رایانه دیگر حل‌وفصل می‌شوند\&. ایده خوبی است که از فلگ خط فرمان \fB\-\-confirm\-paths\fP استفاده کنید تا اطمینان یابید kitten همان فایل‌هایی را کپی می‌کند که مد نظر شماست\&. .SS "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \-\-direction , \-d تعیین ارسال یا دریافت فایل‌ها\&. مقادیر \fBsend\fP یا \fBdownload\fP فایل‌ها را از رایانه‌ای که kitten روی آن در حال اجراست (معمولاً رایانه راه دور) به رایانه محلی کپی می‌کنند\&. مقادیر \fBreceive\fP یا \fBupload\fP فایل‌ها را از رایانه محلی به رایانه راه دور کپی می‌نمایند\&. پیش‌فرض: \fBdownload\fP انتخاب‌ها: \fBdownload\fP, \fBreceive\fP, \fBsend\fP, \fBupload\fP .UNINDENT .INDENT 0.0 .TP .B \-\-mode , \-m نحوه تفسیر آرگومان‌های خط فرمان\&. در حالت \fBmirror\fP تمام آرگومان‌ها فایل‌ها/پوشه‌هایی در رایانه فرستنده در نظر گرفته می‌شوند و در رایانه گیرنده آینه‌سازی (همگام) می‌شوند\&. فایل‌های زیر دایرکتوری HOME در دایرکتوری HOME رایانه گیرنده کپی خواهند شد حتی اگر ساختار دایرکتوری HOME متفاوت باشد\&. در حالت \fBnormal\fP آرگومان پایانی مسیر مقصد در رایانه گیرنده در نظر گرفته می‌شود\&. آرگومان آخر باید یک دایرکتوری موجود باشد، مگر در صورتی که یک فایل تکی کپی شود\&. زمانی که یک دایرکتوری است، باید با یک اسلش پایانی خاتمه یابد\&. پیش‌فرض: \fBnormal\fP انتخاب‌ها: \fBmirror\fP, \fBnormal\fP .UNINDENT .INDENT 0.0 .TP .B \-\-compress تعیین فشرده‌سازی داده‌های در حال ارسال\&. به طور پیش‌فرض فشرده‌سازی بر پایه نوع فایل ارسالی فعال است\&. برای فایل‌هایی که از قبل فشرده شناخته شوند، فشرده‌سازی غیرفعال می‌شود تا از هدررفت چرخه‌های پردازنده جلوگیری شود\&. پیش‌فرض: \fBauto\fP انتخاب‌ها: \fBalways\fP, \fBauto\fP, \fBnever\fP .UNINDENT .INDENT 0.0 .TP .B \-\-permissions\-bypass , \-p گذرواژه مورد استفاده برای صرف‌نظر از پیام تایید انتقال در kitty\&. باید با گذرواژه تعیین‌شده برای گزینه \fBfile_transfer_confirmation_bypass\fP \%<#\:opt-kitty\:.file_transfer_confirmation_bypass> در \fBkitty.conf\fP تطابق داشته باشد\&. توجه داشته باشید که فاصله‌های ابتدا و انتهای گذرواژه حذف می‌شوند\&. گذرواژه‌ای که با نویسه‌های \fB\&.\fP، \fB/\fP یا \fB~\fP آغاز شود، نام فایلی در نظر گرفته می‌شود که گذرواژه از آن خوانده خواهد شد\&. مقدار \fB\-\fP به معنای خواندن گذرواژه از STDIN است\&. گذرواژه‌ای که صرفاً عددی کمتر از ۲۵۶ باشد، شماره یک توصیف‌گر فایل در نظر گرفته می‌شود که گذرواژه واقعی باید از آن خوانده شود\&. .UNINDENT .INDENT 0.0 .TP .B \-\-confirm\-paths [=no], \-c [=no] پیش از انتقال واقعی فایل‌ها، نگاشتی از نام فایل‌های محلی به نام فایل‌های دوردست نمایش داده شده و درخواست تایید شود\&. .UNINDENT .INDENT 0.0 .TP .B \-\-transmit\-deltas [=no], \-x [=no] در صورتی که فایل در سمت گیرنده از قبل موجود باشد، از الگوریتم rsync برای به‌روزرسانی آن جهت انطباق با فایل سمت فرستنده استفاده شود؛ این کار پهنای باند زیادی را ذخیره کرده و انتقال‌های ناتمام را به طور خودکار از سر می‌گیرد\&. توجه داشته باشید که این گزینه عملکرد را در پیوندهای پرسرعت یا فایل‌های کوچک کاهش می‌دهد، بنابراین با احتیاط استفاده شود\&. .UNINDENT .SH "نویسنده (AUTHOR)" Kovid Goyal .SH "حق نشر (COPYRIGHT)" 2026, Kovid Goyal .\" End of generated man page.