.\" $OpenBSD: sftp.1,v 1.144 2024/12/06 15:12:56 djm Exp $
.\"
.\" Copyright (c) 2001 Damien Miller.  All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd $Mdocdate: December 6 2024 $
.Dt SFTP 1
.Os
.Sh "نام (NAME)"
.Nm sftp
.Nd برنامه امن انتقال پرونده
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm sftp
.Op Fl 46AaCfNpqrv
.Op Fl B Ar buffer_size
.Op Fl b Ar batchfile
.Op Fl c Ar cipher
.Op Fl D Ar sftp_server_command
.Op Fl F Ar ssh_config
.Op Fl i Ar identity_file
.Op Fl J Ar destination
.Op Fl l Ar limit
.Op Fl o Ar ssh_option
.Op Fl P Ar port
.Op Fl R Ar num_requests
.Op Fl S Ar program
.Op Fl s Ar subsystem | sftp_server
.Op Fl X Ar sftp_option
.Ar destination
.Sh "توضیحات (DESCRIPTION)"
.Nm
یک برنامه انتقال پرونده شبیه به
.Xr ftp 1
است که تمام عملیات‌ها را روی یک بستر انتقال رمزگذاری‌شدهٔ
.Xr ssh 1
انجام می‌دهد.
این برنامه همچنین می‌تواند از بسیاری از ویژگی‌های ssh مانند احراز هویت با کلید عمومی و فشرده‌سازی استفاده کند.
.Pp
مقصد یا
.Ar destination
می‌تواند به صورت
.Sm off
.Oo user @ Oc host Op : path
.Sm on
یا به صورت یک نشانی وب (URI) به شکل
.Sm off
.No sftp:// Oo user @ Oc host Oo : port Oc Op / path
.Sm on
مشخص شود.
.Pp
اگر
.Ar destination
شامل یک
.Ar path
(مسیر) باشد و آن مسیر یک دایرکتوری نباشد،
.Nm
در صورت استفاده از یک روش احراز هویت غیرتعاملی، پرونده‌ها را به صورت خودکار دریافت خواهد کرد؛ در غیر این صورت، این کار را پس از احراز هویت تعاملی موفقیت‌آمیز انجام خواهد داد.
.Pp
اگر هیچ
.Ar path
مشخص نشده باشد، یا اگر مسیر تعیین‌شده یک دایرکتوری باشد،
.Nm
به میزبان
.Pq Ar host
مشخص‌شده وارد می‌شود و به حالت دستورات تعاملی می‌رود و در صورتی که دایرکتوری راه دوری مشخص شده باشد، به آن تغییر مسیر می‌دهد.
می‌توان از یک اسلش اختیاری در انتهای مسیر برای اجبار به تفسیر
.Ar path
به‌عنوان دایرکتوری استفاده کرد.
.Pp
از آنجا که در قالب‌های مقصد از نویسهٔ دو نقطه (:) برای جداسازی نام میزبان از نام مسیر یا شماره درگاه استفاده می‌شود، نشانی‌های IPv6 باید در براکت‌های مربع [ ] قرار گیرند تا از بروز ابهام جلوگیری شود.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl 4
اجبار
.Nm
به استفاده انحصاری از نشانی‌های IPv4.
.It Fl 6
اجبار
.Nm
به استفاده انحصاری از نشانی‌های IPv6.
.It Fl A
اجازه به بازفرستادن (forwarding)
.Xr ssh-agent 1
به سیستم راه دور.
حالت پیش‌فرض عدم بازفرستادن عامل احراز هویت است.
.It Fl a
تلاش برای ادامه دادن انتقال‌های متوقف‌شده به‌جای رونویسی بر روی پرونده‌های ناقص یا کاملِ موجود.
اگر محتوای ناقص با داده‌های در حال انتقال تفاوت داشته باشد، پرونده حاصل احتمالاً خراب خواهد شد.
.It Fl B Ar buffer_size
تعیین اندازه بافری که
.Nm
هنگام انتقال پرونده‌ها استفاده می‌کند.
بافرهای بزرگ‌تر به تعداد تبادلات رفت‌وبرگشتی (round trips) کمتری نیاز دارند اما حافظه بیشتری مصرف می‌کنند.
مقدار پیش‌فرض ۳۲۷۶۸ بایت است.
.It Fl b Ar batchfile
حالت دسته‌ای (Batch mode) مجموعه‌ای از دستورات را به‌جای ورودی استاندارد
.Pq Em stdin
از یک پرونده ورودی
.Ar batchfile
می‌خواند.
از آنجا که این حالت فاقد تعامل کاربر است، باید به همراه احراز هویت غیرتعاملی استفاده شود تا نیاز به وارد کردن گذرواژه در هنگام اتصال برطرف گردد (برای جزئیات به
.Xr sshd 8
و
.Xr ssh-keygen 1
مراجعه کنید).
.Pp
مقدار
.Sq \-
برای
.Ar batchfile
می‌تواند برای نشان دادن ورودی استاندارد استفاده شود.
اگر هر یک از دستورات زیر ناموفق باشد،
.Nm
متوقف خواهد شد:
.Ic get , put , reget , reput , rename , ln ,
.Ic rm , mkdir , chdir , ls ,
.Ic lchdir , copy , cp , chmod , chown ,
.Ic chgrp , lpwd , df , symlink ,
و
.Ic lmkdir .
.Pp
توقف در اثر بروز خطا را می‌توان برای هر دستور به صورت جداگانه با افزودن پیشوند
.Sq \-
به ابتدای دستور غیرفعال کرد (برای مثال،
.Ic -rm /tmp/blah* ) .
نمایش بازگشتی (Echo) دستور را نیز می‌توان با افزودن پیشوند
.Sq @
به ابتدای دستور غیرفعال کرد.
این دو پیشوند را می‌توان به هر ترتیبی با یکدیگر ترکیب کرد، برای مثال
.Ic -@ls /bsd .
.It Fl C
فعال‌سازی فشرده‌سازی (از طریق پرچم
.Fl C
در ssh).
.It Fl c Ar cipher
انتخاب الگوریتم رمزنگاری مورد استفاده برای رمزگذاری داده‌های در حال انتقال.
این گزینه مستقیماً به
.Xr ssh 1
پاس داده می‌شود.
.It Fl D Ar sftp_server_command
اتصال مستقیم به یک سرور محلی sftp
(به‌جای اتصال از طریق
.Xr ssh 1 ) .
می‌توان یک دستور و آرگومان‌های آن را مشخص کرد، برای مثال
.Qq /path/sftp-server -el debug3 .
این گزینه می‌تواند در اشکال‌زدایی کلاینت و سرور مفید باشد.
.It Fl F Ar ssh_config
تعیین یک پرونده پیکربندی سفارشی برای هر کاربر در
.Xr ssh 1 .
این گزینه مستقیماً به
.Xr ssh 1
پاس داده می‌شود.
.It Fl f
درخواست تخلیه فوری پرونده‌ها بر روی دیسک (flush) بلافاصله پس از انتقال.
هنگام بارگذاری پرونده‌ها، این ویژگی تنها در صورتی فعال است که سرور از افزونهٔ "fsync@openssh.com" پشتیبانی کند.
.It Fl i Ar identity_file
انتخاب پرونده‌ای که شناسه (کلید خصوصی) برای احراز هویت با کلید عمومی از آن خوانده می‌شود.
این گزینه مستقیماً به
.Xr ssh 1
پاس داده می‌شود.
.It Fl J Ar destination
اتصال به میزبان هدف از طریق برقراری اتصال اولیهٔ
.Nm
به میزبان جهش (jump host) توصیف‌شده توسط
.Ar destination
و سپس ایجاد بازفرستادن TCP به مقصد نهایی از آنجا.
می‌توان چند میزبان جهش را با نویسه ویرگول از هم جدا کرد.
این گزینه یک میانبر برای تعیین دستورالعمل پیکربندی
.Cm ProxyJump
است.
این گزینه مستقیماً به
.Xr ssh 1
پاس داده می‌شود.
.It Fl l Ar limit
محدود کردن پهنای باند مصرفی، بر حسب Kbit/s.
.It Fl N
غیرفعال کردن حالت بی‌صدا، به عنوان مثال برای لغو حالت بی‌صدای ضمنی تنظیم‌شده با پرچم
.Fl b .
.It Fl o Ar ssh_option
می‌تواند برای ارسال گزینه‌ها به
.Nm ssh
با قالبی که در
.Xr ssh_config 5
استفاده می‌شود، به کار رود.
این برای مشخص کردن گزینه‌هایی کاربرد دارد که برای آن‌ها پرچم جداگانه‌ای در خط فرمان
.Nm sftp
وجود ندارد.
برای مثال، جهت تعیین یک درگاه جایگزین استفاده کنید از:
.Ic sftp -oPort=24 .
برای جزئیات کامل گزینه‌های فهرست‌شده در زیر و مقادیر مجاز آن‌ها، به
.Xr ssh_config 5
مراجعه فرمایید.
.Pp
.Bl -tag -width Ds -offset indent -compact
.It AddKeysToAgent
.It AddressFamily
.It BatchMode
.It BindAddress
.It BindInterface
.It CASignatureAlgorithms
.It CanonicalDomains
.It CanonicalizeFallbackLocal
.It CanonicalizeHostname
.It CanonicalizeMaxDots
.It CanonicalizePermittedCNAMEs
.It CertificateFile
.It ChannelTimeout
.It CheckHostIP
.It Ciphers
.It ClearAllForwardings
.It Compression
.It ConnectTimeout
.It ConnectionAttempts
.It ControlMaster
.It ControlPath
.It ControlPersist
.It DynamicForward
.It EnableEscapeCommandline
.It EnableSSHKeysign
.It EscapeChar
.It ExitOnForwardFailure
.It FingerprintHash
.It ForkAfterAuthentication
.It ForwardAgent
.It ForwardX11
.It ForwardX11Timeout
.It ForwardX11Trusted
.It GSSAPIAuthentication
.It GSSAPIDelegateCredentials
.It GatewayPorts
.It GlobalKnownHostsFile
.It HashKnownHosts
.It Host
.It HostKeyAlgorithms
.It HostKeyAlias
.It HostbasedAcceptedAlgorithms
.It HostbasedAuthentication
.It Hostname
.It IPQoS
.It IdentitiesOnly
.It IdentityAgent
.It IdentityFile
.It IgnoreUnknown
.It Include
.It KbdInteractiveAuthentication
.It KbdInteractiveDevices
.It KexAlgorithms
.It KnownHostsCommand
.It LocalCommand
.It LocalForward
.It LogLevel
.It LogVerbose
.It MACs
.It NoHostAuthenticationForLocalhost
.It NumberOfPasswordPrompts
.It ObscureKeystrokeTiming
.It PKCS11Provider
.It PasswordAuthentication
.It PermitLocalCommand
.It PermitRemoteOpen
.It Port
.It PreferredAuthentications
.It ProxyCommand
.It ProxyJump
.It ProxyUseFdpass
.It PubkeyAcceptedAlgorithms
.It PubkeyAuthentication
.It RekeyLimit
.It RemoteCommand
.It RemoteForward
.It RequestTTY
.It RequiredRSASize
.It RevokedHostKeys
.It SecurityKeyProvider
.It SendEnv
.It ServerAliveCountMax
.It ServerAliveInterval
.It SessionType
.It SetEnv
.It StdinNull
.It StreamLocalBindMask
.It StreamLocalBindUnlink
.It StrictHostKeyChecking
.It SyslogFacility
.It TCPKeepAlive
.It Tag
.It Tunnel
.It TunnelDevice
.It UpdateHostKeys
.It User
.It UserKnownHostsFile
.It VerifyHostKeyDNS
.It VisualHostKey
.It XAuthLocation
.El
.It Fl P Ar port
تعیین درگاه برای اتصال به میزبان راه دور.
.It Fl p
حفظ زمان‌های اصلاح، زمان‌های دسترسی و مجوزهای پرونده‌های اصلی منتقل‌شده.
.It Fl q
حالت بی‌صدا: نوار پیشرفت و همچنین پیام‌های هشدار و تشخیصی از سوی
.Xr ssh 1
را غیرفعال می‌کند.
.It Fl R Ar num_requests
تعیین تعداد درخواست‌هایی که می‌توانند در هر لحظه در انتظار پاسخ باشند.
افزایش این مقدار ممکن است سرعت انتقال پرونده را اندکی بهبود بخشد اما مصرف حافظه را افزایش می‌دهد.
مقدار پیش‌فرض ۶۴ درخواست در انتظار است.
.It Fl r
رونوشت‌برداری بازگشتی (recursive) از تمام پوشه‌ها هنگام بارگذاری و بارگیری.
توجه داشته باشید که
.Nm
پیوندهای نمادین موجود در مسیر پیمایش درخت پوشه‌ها را دنبال نمی‌کند.
.It Fl S Ar program
نام
.Ar program
مورد استفاده برای اتصال رمزگذاری‌شده.
این برنامه باید گزینه‌های
.Xr ssh 1
را بفهمد و پشتیبانی کند.
.It Fl s Ar subsystem | sftp_server
تعیین زیرسیستم SSH2 یا مسیر مربوط به یک کارگزار sftp بر روی میزبان راه دور.
تعیین مسیر زمانی مفید است که
.Xr sshd 8
روی میزبان راه دور فاقد یک زیرسیستم sftp پیکربندی‌شده باشد.
.It Fl v
افزایش سطح گزارش‌گیری (logging level).
این گزینه به ssh نیز ارسال می‌شود.
.It Fl X Ar sftp_option
تعیین گزینه‌ای که جنبه‌هایی از رفتار پروتکل SFTP را کنترل می‌کند.
گزینه‌های معتبر عبارتند از:
.Bl -tag -width Ds
.It Cm nrequests Ns = Ns Ar value
کنترل تعداد درخواست‌های هم‌زمان خواندن یا نوشتن SFTP که در هر لحظه از بارگیری یا بارگذاری می‌توانند در حال پردازش باشند.
به‌طور پیش‌فرض ۶۴ درخواست می‌توانند به صورت هم‌زمان فعال باشند.
.It Cm buffer Ns = Ns Ar value
کنترل حداکثر اندازه بافر برای یک عملیات منفرد خواندن/نوشتن SFTP که در حین بارگیری یا بارگذاری استفاده می‌شود.
به‌طور پیش‌فرض از یک بافر ۳۲ کیلوبایتی استفاده می‌شود.
.El
.El
.Sh "دستورات تعاملی (INTERACTIVE COMMANDS)"
پس از ورود به حالت تعاملی،
.Nm
مجموعه‌ای از دستورات را مشابه با
.Xr ftp 1
پشتیبانی می‌کند.
دستورات به بزرگی و کوچکی حروف حساس نیستند.
نام مسیرهایی که شامل فاصله هستند باید در کوتیشن قرار گیرند.
هرگونه نویسهٔ ویژه‌ای در نام مسیرها که توسط
.Xr glob 3
شناخته می‌شود باید با استفاده از بک‌اسلش
.Pq Sq \e
اسکیپ شود.
.Bl -tag -width Ds
.It Ic bye
خروج از
.Nm sftp .
.It Ic cd Op Ar path
تغییر دایرکتوری راه دور به
.Ar path .
اگر
.Ar path
مشخص نشده باشد، دایرکتوری به همان دایرکتوری که نشست در آن آغاز شده بود تغییر می‌یابد.
.It Xo Ic chgrp
.Op Fl h
.Ar grp
.Ar path
.Xc
تغییر گروه پروندهٔ
.Ar path
به
.Ar grp .
مسیر
.Ar path
می‌تواند شامل نویسه‌های الگوی
.Xr glob 7
باشد و ممکن است با چند پرونده مطابقت داشته باشد.
شناسهٔ
.Ar grp
باید یک GID عددی باشد.
.Pp
اگر پرچم
.Fl h
مشخص شده باشد، پیوندهای نمادین دنبال نمی‌شوند.
توجه داشته باشید که این ویژگی تنها توسط سرورهایی پشتیبانی می‌شود که افزونهٔ "lsetstat@openssh.com" را پیاده‌سازی کرده باشند.
.It Xo Ic chmod
.Op Fl h
.Ar mode
.Ar path
.Xc
تغییر مجوزهای پروندهٔ
.Ar path
به
.Ar mode .
مسیر
.Ar path
می‌تواند شامل نویسه‌های الگوی
.Xr glob 7
باشد و ممکن است با چند پرونده مطابقت داشته باشد.
.Pp
اگر پرچم
.Fl h
مشخص شده باشد، پیوندهای نمادین دنبال نمی‌شوند.
توجه داشته باشید که این ویژگی تنها توسط سرورهایی پشتیبانی می‌شود که افزونهٔ "lsetstat@openssh.com" را پیاده‌سازی کرده باشند.
.It Xo Ic chown
.Op Fl h
.Ar own
.Ar path
.Xc
تغییر مالک پروندهٔ
.Ar path
به
.Ar own .
مسیر
.Ar path
می‌تواند شامل نویسه‌های الگوی
.Xr glob 7
باشد و ممکن است با چند پرونده تطابق یابد.
شناسهٔ
.Ar own
باید یک UID عددی باشد.
.Pp
اگر پرچم
.Fl h
مشخص شده باشد، پیوندهای نمادین دنبال نمی‌شوند.
توجه داشته باشید که این ویژگی تنها توسط سرورهایی پشتیبانی می‌شود که افزونهٔ "lsetstat@openssh.com" را پیاده‌سازی کرده باشند.
.It Ic copy Ar oldpath Ar newpath
رونوشت‌برداری از پرونده راه دور از
.Ar oldpath
به
.Ar newpath .
.Pp
توجه داشته باشید که این دستور تنها توسط سرورهایی پشتیبانی می‌شود که افزونهٔ "copy-data" را پیاده‌سازی کرده باشند.
.It Ic cp Ar oldpath Ar newpath
نام مستعار برای دستور
.Ic copy .
.It Xo Ic df
.Op Fl hi
.Op Ar path
.Xc
نمایش اطلاعات استفاده برای سیستم پرونده‌ای که دایرکتوری کنونی
(یا
.Ar path
در صورت مشخص شدن)
در آن قرار دارد.
اگر پرچم
.Fl h
مشخص شده باشد، اطلاعات ظرفیت با استفاده از پسوندهای «خوانا برای انسان» نمایش داده می‌شود.
پرچم
.Fl i
علاوه بر اطلاعات ظرفیت، درخواست نمایش اطلاعات inode را نیز می‌دهد.
این دستور تنها در سرورهایی پشتیبانی می‌شود که افزونهٔ
.Dq statvfs@openssh.com
را پیاده‌سازی کرده باشند.
.It Ic exit
خروج از
.Nm sftp .
.It Xo Ic get
.Op Fl afpR
.Ar remote-path
.Op Ar local-path
.Xc
دریافت پروندهٔ
.Ar remote-path
و ذخیره آن روی رایانه محلی.
اگر نام مسیر محلی مشخص نشده باشد، همان نامی را می‌گیرد که در رایانه راه دور دارد.
مسیر
.Ar remote-path
می‌تواند شامل نویسه‌های
.Xr glob 7
باشد و ممکن است با چند پرونده تطابق یابد.
در این حالت اگر
.Ar local-path
مشخص شده باشد، آنگاه
.Ar local-path
باید یک دایرکتوری را مشخص کند.
.Pp
اگر پرچم
.Fl a
مشخص شده باشد، تلاش می‌شود تا انتقال ناقص پرونده‌های موجود از سر گرفته شود.
توجه داشته باشید که ازسرگیری فرض می‌کند هرگونه رونوشت ناقص از پرونده محلی با رونوشت راه دور همخوانی دارد.
اگر محتوای پرونده راه دور با نسخه ناقص محلی تفاوت داشته باشد، پرونده نهایی احتمالاً خراب خواهد شد.
.Pp
اگر پرچم
.Fl f
مشخص شده باشد، تابع
.Xr fsync 2
پس از اتمام انتقال پرونده فراخوانی می‌شود تا داده‌ها را بر روی دیسک تخلیه کند.
.Pp
اگر پرچم
.Fl p
مشخص شده باشد، تمام مجوزها و زمان‌های دسترسی پرونده نیز رونوشت‌برداری می‌شوند.
.Pp
اگر پرچم
.Fl R
مشخص شده باشد، دایرکتوری‌ها به صورت بازگشتی رونوشت‌برداری خواهند شد.
توجه داشته باشید که
.Nm
هنگام انجام انتقال‌های بازگشتی، پیوندهای نمادین را دنبال نمی‌کند.
.It Ic help
نمایش متن راهنما.
.It Ic lcd Op Ar path
تغییر دایرکتوری محلی به
.Ar path .
اگر
.Ar path
مشخص نشده باشد، دایرکتوری به پوشهٔ خانگی کاربر محلی تغییر می‌کند.
.It Ic lls Op Ar ls-options Op Ar path
نمایش فهرست دایرکتوری محلی برای
.Ar path
یا دایرکتوری کنونی در صورتی که
.Ar path
مشخص نشده باشد.
آرگومان
.Ar ls-options
می‌تواند شامل هر پرچمی باشد که توسط دستور
.Xr ls 1
در سیستم محلی پشتیبانی می‌شود.
مسیر
.Ar path
می‌تواند شامل نویسه‌های الگوی
.Xr glob 7
باشد و ممکن است با چند پرونده تطابق یابد.
.It Ic lmkdir Ar path
ایجاد دایرکتوری محلی مشخص‌شده توسط
.Ar path .
.It Xo Ic ln
.Op Fl s
.Ar oldpath
.Ar newpath
.Xc
ایجاد یک پیوند از
.Ar oldpath
به
.Ar newpath .
اگر پرچم
.Fl s
مشخص شده باشد، پیوند ایجادشده یک پیوند نمادین (symbolic link) خواهد بود؛ در غیر این صورت یک پیوند سخت (hard link) است.
.It Ic lpwd
چاپ مسیر دایرکتوری کاری محلی.
.It Xo Ic ls
.Op Fl 1afhlnrSt
.Op Ar path
.Xc
نمایش فهرست دایرکتوری راه دور برای
.Ar path
یا دایرکتوری کنونی در صورتی که
.Ar path
مشخص نشده باشد.
مسیر
.Ar path
می‌تواند شامل نویسه‌های الگوی
.Xr glob 7
باشد و ممکن است با چند پرونده مطابقت پیدا کند.
.Pp
پرچم‌های زیر پشتیبانی می‌شوند و رفتار
.Ic ls
را بر این اساس تغییر می‌دهند:
.Bl -tag -width Ds
.It Fl 1
تولید خروجی تک‌ستونی.
.It Fl a
فهرست کردن پرونده‌هایی که با یک نقطه
.Pq Sq \&.
آغاز می‌شوند.
.It Fl f
مرتب نکردن فهرست.
ترتیب مرتب‌سازی پیش‌فرض بر اساس الفبا (lexicographical) است.
.It Fl h
در صورت استفاده با گزینه قالب‌بندی طولانی، از پسوندهای واحد استفاده می‌کند: بایت، کیلوبایت، مگابایت، گیگابایت، ترابایت، پتابایت و اگزابایت تا با استفاده از توان‌های ۲ برای اندازه‌ها (K=1024, M=1048576 و غیره) تعداد ارقام را به چهار رقم یا کمتر کاهش دهد.
.It Fl l
نمایش جزئیات بیشتر شامل اطلاعات مجوزها و مالکیت.
.It Fl n
تولید یک فهرست طولانی با نمایش عددی اطلاعات کاربر و گروه.
.It Fl r
معکوس کردن ترتیب مرتب‌سازی فهرست.
.It Fl S
مرتب‌سازی فهرست بر اساس اندازه پرونده.
.It Fl t
مرتب‌سازی فهرست بر اساس زمان آخرین تغییر.
.El
.It Ic lumask Ar umask
تنظیم umask محلی به
.Ar umask .
.It Ic mkdir Ar path
ایجاد دایرکتوری راه دور مشخص‌شده توسط
.Ar path .
.It Ic progress
تغییر وضعیت نمایش نوار سنجش پیشرفت.
.It Xo Ic put
.Op Fl afpR
.Ar local-path
.Op Ar remote-path
.Xc
بارگذاری
.Ar local-path
و ذخیره آن روی رایانه راه دور.
اگر نام مسیر راه دور مشخص نشده باشد، همان نامی را می‌گیرد که در رایانه محلی دارد.
مسیر
.Ar local-path
می‌تواند شامل نویسه‌های
.Xr glob 7
باشد و ممکن است با چند پرونده مطابقت یابد.
اگر چنین باشد و
.Ar remote-path
مشخص شده باشد، آنگاه
.Ar remote-path
باید یک پوشه را مشخص کند.
.Pp
اگر پرچم
.Fl a
مشخص شده باشد، تلاش می‌شود تا انتقال‌های ناقص پرونده‌های موجود از سر گرفته شود.
توجه داشته باشید که ازسرگیری فرض می‌کند هرگونه رونوشت ناقص از پرونده راه دور با نسخه محلی همخوانی دارد.
اگر محتوای پرونده محلی با نسخه ناقص راه دور مغایرت داشته باشد، پرونده نهایی احتمالاً خراب خواهد شد.
.Pp
اگر پرچم
.Fl f
مشخص شده باشد، درخواستی به سرور ارسال می‌شود تا پس از انتقال پرونده،
.Xr fsync 2
را فراخوانی کند.
توجه داشته باشید که این ویژگی تنها توسط سرورهایی پشتیبانی می‌شود که افزونهٔ "fsync@openssh.com" را پیاده‌سازی کرده باشند.
.Pp
اگر پرچم
.Fl p
مشخص شده باشد، تمام مجوزها و زمان‌های دسترسی پرونده نیز رونوشت‌برداری می‌شوند.
.Pp
اگر پرچم
.Fl R
مشخص شده باشد، دایرکتوری‌ها به صورت بازگشتی رونوشت‌برداری خواهند شد.
توجه داشته باشید که
.Nm
هنگام انجام انتقال‌های بازگشتی، پیوندهای نمادین را دنبال نمی‌کند.
.It Ic pwd
نمایش مسیر دایرکتوری کاری راه دور.
.It Ic quit
خروج از
.Nm sftp .
.It Xo Ic reget
.Op Fl fpR
.Ar remote-path
.Op Ar local-path
.Xc
ازسرگیری بارگیری پروندهٔ
.Ar remote-path .
معادل با
.Ic get
با تنظیم بودن پرچم
.Fl a .
.It Xo Ic reput
.Op Fl fpR
.Ar local-path
.Op Ar remote-path
.Xc
ازسرگیری بارگذاری پروندهٔ
.Ar local-path .
معادل با
.Ic put
با تنظیم بودن پرچم
.Fl a .
.It Ic rename Ar oldpath newpath
تغییر نام پرونده راه دور از
.Ar oldpath
به
.Ar newpath .
.It Ic rm Ar path
حذف پرونده راه دور مشخص‌شده توسط
.Ar path .
.It Ic rmdir Ar path
حذف دایرکتوری راه دور مشخص‌شده توسط
.Ar path .
.It Ic symlink Ar oldpath newpath
ایجاد یک پیوند نمادین از
.Ar oldpath
به
.Ar newpath .
.It Ic version
نمایش نگارش پروتکل
.Nm .
.It Ic \&! Ns Ar command
اجرای
.Ar command
در پوستهٔ محلی.
.It Ic \&!
ورود به پوستهٔ محلی.
.It Ic \&?
مترادف برای راهنما (help).
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr ftp 1 ,
.Xr ls 1 ,
.Xr scp 1 ,
.Xr ssh 1 ,
.Xr ssh-add 1 ,
.Xr ssh-keygen 1 ,
.Xr ssh_config 5 ,
.Xr glob 7 ,
.Xr sftp-server 8 ,
.Xr sshd 8
.Rs
.%A T. Ylonen
.%A S. Lehtinen
.%T "SSH File Transfer Protocol"
.%N draft-ietf-secsh-filexfer-00.txt
.%D January 2001
.%O work in progress material
.Re