30 lines
1.0 KiB
ReStructuredText
30 lines
1.0 KiB
ReStructuredText
Transfer files
|
|
================
|
|
|
|
.. warning::
|
|
This kitten is currently experimental, use with care.
|
|
|
|
Transfer files to and from remote computers over the ``TTY`` device itself.
|
|
This means that file transfer works over nested SSH sessions, serial links,
|
|
etc. Anywhere you have a terminal device, you can transfer files.
|
|
|
|
.. image:: ../screenshots/transfer.png
|
|
:alt: The transfer kitten at work
|
|
|
|
This kitten supports transferring entire directory trees, preserving soft and
|
|
hard links, file permissions, times, etc. It even supports the `rsync
|
|
<https://en.wikipedia.org/wiki/Rsync>`_ protocol to transfer only changes to
|
|
large files and to automatically resume interrupted transfers.
|
|
|
|
.. seealso:: See the :doc:`remote_file` kitten
|
|
|
|
.. note::
|
|
This kitten (which practically means kitty) must be installed on the remote
|
|
machine. If that is not possible you can use the :doc:`remote_file` kitten
|
|
instead. Or write your own script to use the underlying file transfer
|
|
protocol.
|
|
|
|
.. versionadded:: 0.24.0
|
|
|
|
.. include:: ../generated/cli-kitten-transfer.rst
|