NÁZOV
sftp – program na bezpečný prenos súborov
SYNTAX
sftp [-1246Cpqrv] [-B veľkosť_zásobníka] [-b dávkový_súbor] [-c šifra]
[-D cesta_na_sftp_server] [-F konfiguračný_súbor] [-i súbor_s_identitou]
[-o voľby_pre_ssh] [-P port] [-R počet_požiadaviek] [-S program]
[-s podsystém | sftp_server] hostiteľ
sftp [používateľ@]hostiteľ[:súbor ...]
sftp [používateľ@]hostiteľ[:priečinok[/]]
sftp -b dávkový_súbor [používateľ@]hostiteľ
POPIS
sftp je interaktívny program na prenos súborov podobný programu ftp, ktorý
všetky operácie vykonáva cez zašifrovaný ssh(1) prenos. Dokáže tiež použiť
mnoho funkcií ssh, ako overenie totožnosti verejným kľúčom a kompresiu.
sftp sa pripojí a prihlási k zadanej stanici, a potom vstúpi
do interaktívneho príkazového režimu.
Druhý spôsob využitia je automatické sťahovanie súborov ak nie je použité
interaktívna spôsob overenia totožnosti; v opačnom prípade sa operácia
vykoná až po interaktívnom prihlásení.
Tretie využitie sftp je spúšťanie vo vzdialenom priečinku.
Posledný spôsob využitia umožňuje automatizáciu relácie pomocou voľby -b.
V tomto prípade, je nutné nastaviť neinteraktívny režim overenia
totožnosti aby používateľ nemusel zadávať heslo pri každom pripojení
(podrobnosti sa nachádzajú na man stránkach sshd(8) a ssh-keygen(1)).
Voľby príkazu sú nasledovné:
-1 Prinúti scp použiť protokol 1.
-2 Prinúti scp použiť protokol 2.
-4 Prinúti scp použiť iba adresy IPv4.
-6 Prinúti scp použiť iba adresy IPv6.
-B veľkosť_zásobníka
Určuje veľkosť zásobníka, ktorý použije sftp pri prenose súborov.
Pri použití väčšieho zásobníka bude potrebných menej odoslaní
za cenu vyššej spotreby pamäte. Predvolená hodnota je 32768 bajtov.
-b dávkový_súbor
Dávkový režim číta sériu príkazov zo vstupného súboru
dávkový_súbor namiesto zo štandardného vstupu stdin. Pretože
nevyžaduje interakciu s používateľom, môže sa využiť spolu
neinteraktívnym overením totožnosti. Ak je ďávkový_súbor znak
`-', použije sa štandardný vstup. sftp sa preruší ak niektorý
z nasledujúcich príkazov zlyhá: get, put, rename, ln, rm, mkdir,
chdir, ls, lchdir, chmod, chown, chgrp, lpwd, df a lmkdir.
Ukončenie pri chybe sa dá pre jednotlivé príkazy potlačiť tak,
že pred príkaz dáme znak `-' (napr. -rm /tmp/blah*).
-C Zapne kompresiu (prostredníctvom voľby -C príkazu ssh).
-c šifra
Nastaví šifru, ktorá sa má použiť na zašifrovanie prenášaných
údajov. Táto voľba sa priamo predáva programu ssh(1).
-D cesta_na_sftp_server
Pripojí sa priamo na lokálny sftp server (miesto použitia ssh(1)).
Táto voľba môže byť užitočný pri ladení klienta a servera.
-F konfiguračný_súbor
Nastaví alternatívny používateľský konfiguračný súbor pre ssh(1).
Táto voľba sa priamo predáva programu ssh(1).
-i súbor_s_identitou
Nastavuje súbor, z ktorého sa má načítať identita (súkromný kľúč)
pre overenie totožnosti verejným kľúčom. Táto voľba sa priamo
predáva programu ssh(1).
-o voľby_pre_ssh
Môže byť použité na predanie volieb programu ssh vo formáte súboru
ssh_config(5). Toto je užitočné na určenie volieb, ktoré sa nedajú
nastaviť priamo cez príkaz scp. Všetky podrobnosti o voľbách
zobrazených nižšie, sa nachádzajú na man stránke ssh_config(5).
AddressFamily
BatchMode
BindAddress
ChallengeResponseAuthentication
CheckHostIP
Cipher
Ciphers
Compression
CompressionLevel
ConnectionAttempts
ConnectTimeout
ControlMaster
ControlPath
GlobalKnownHostsFile
GSSAPIAuthentication
GSSAPIDelegateCredentials
HashKnownHosts
Host
HostbasedAuthentication
HostKeyAlgorithms
HostKeyAlias
HostName
IdentityFile
IdentitiesOnly
KbdInteractiveDevices
LogLevel
MACs
NoHostAuthenticationForLocalhost
NumberOfPasswordPrompts
PasswordAuthentication
PKCS11Provider
Port
PreferredAuthentications
Protocol
ProxyCommand
PubkeyAuthentication
RekeyLimit
RhostsRSAAuthentication
RSAAuthentication
SendEnv
ServerAliveInterval
ServerAliveCountMax
StrictHostKeyChecking
TCPKeepAlive
UsePrivilegedPort
User
UserKnownHostsFile
VerifyHostKeyDNS
-P port
Určuje port, cez ktorý sa má program pripojiť na vzdialenú stanicu.
-p Zachová čas zmeny, čas posledného prístupu a práva kopírovaného
súboru.
-q Tichý režim: vypne zobrazovanie priebehu kopírovania, všetky
varovania a diagnostické správy z príkazu ssh(1).
-R počet_požiadaviek
Určuje počet požiadaviek, ktoré môžu byť naraz spracované. Môže to
zvýšiť rýchlosť prenosu súborov, no zvýši to spotrebu pamäte.
Predvolená hodnota je 64 požiadaviek.
-r Rekurzívne skopíruje obsah celého priečinka. Program scp nasleduje
symbolické odkazy, na ktoré pri kopírovaní narazí.
-S program
Názov programu, ktorý sa ma použiť na šifrované spojenie. Program
musí rozumieť voľbám ssh(1).
-s podsystém | sftp_server
Určuje podsystém SSH2 alebo cestu pre sftp server na vzdialenej
stanici. Cestu je vhodné použiť pri sftp cez SSH protokol
verzie 1 alebo ak vzdialený démon sshd(8) nemá nastavený
podsystém sftp.
-v Výrečný režim. Táto voľba sa tiež predá príkazu ssh.
INTERAKTÍVNE PRÍKAZY
Po prihlásení do interaktívneho režimu, sftp rozumie podobnej sade
príkazov ako ftp. Príkazy rozlišujú veľkosť písmen. Cesty k súborom,
ktoré obsahujú medzery, musia byť uzatvorené do úvodzoviek. Každý
špeciálny znak v ceste, ktorý rozpozná glob(3) musí byť vyznačený
spätnou lomkou (`\').
bye Ukončí sftp.
cd cesta
Zmení vzdialený priečinok na "cesta".
chgrp skupina cesta
Zmení skupinu vlastníkov zadanej "cesty" na "skupina". "cesta"
musí obsahovať znaky glob(3) a môže zodpovedať viacerým súborom.
"skupina" musí byť číselným kódom GID.
chmod práva cesta
Zmení oprávnenia zadanej "cesty" na "práva". "cesta" môže obsahovať
znaky glob(3) a môže zodpovedať viacerým súborom.
chown vlastník cesta
Zmení vlastníka zadanej "cesty" na "vlastníka". "cesta" môže obsahovať
znaky glob(3) a môže zodpovedať viacerým súborom. "vlastník" musí byť
číselným kódom UID.
df [-hi] [cesta]
Zobrazí informácie využití miesta súborového systému aktulnym
priečinkom (alebo priečinkom na zadanej ceste). Ak je zadaný príznak -h
informácia o kapacite sa zobrazí v tvare zrozumiteľnom pre človeka.
Príznak -i vynúti zobrazenie inode informácií spolu s informáciami
o kapacite. Tento príkaz je podporovaný iba na serveroch, ktoré majú
implementované rozšírenie ``statvfs@openssh.com''.
exit Ukončí sftp.
get [-Ppr] vzdialená-cesta [lokálna-cesta]
Prevezme vzdialená-cesta a uloží ju do lokálneho stroja. Ak
nie je zadaná lokálna-cesta, uloží sa s rovnakým názvom ako
mala na vzdialenom stroji. vzdialená-cesta môže obsahovať
znaky glob(3) a môže zodpovedať viacerým súborom. Ak je to tak
a je zadaná lokálna-cesta, potom lokálna-cesta musí určovať
priečinok.
Ak je zadaný príznak -P alebo -p, potom sa skopírujú aj všetky
oprávnenia a časy prístupov.
Ak je zadaný príznak -r, potom sa priečinky budú kopírovať
rekurzívne. Príkaz sftp pri rekurzívnom prenose nebude nasledovať
symbolické prepojenia.
help Zobrazí text pomocníka.
lcd cesta
Zmení lokálny priečinok na zadanú cestu.
lls [ls-voľby [cesta]]
Zobrazí výpis lokálneho priečinka zadanej "cesty" alebo aktuálneho
priečinka (ak cesta nie je zadaná. "ls-voľby" môžu obsahovať ľubovoľné
príznaky, ktoré na lokálnom systéme podporuje príkaz ls(1). "cesta"
môže obsahovať znaky glob(3) a môže zodpovedať viacerým súborom.
lmkdir cesta
Vytvorí lokálny priečinok na zadanej ceste.
ln starácesta novácesta
Vytvorí symbolické prepojenie zo starácesta do novácesta.
lpwd Vypíše lokálny pracovný priečinok.
ls [-1afhlnrSt] [cesta]
Zobrazí výpis vzdialeného priečinka na zadanej ceste alebo aktuálneho
priečinka, ak cesta nie je zadaná. "cesta" môže obsahovať znaky glob(3)
a môže zodpovedať viacerým súborom.
Je možné použiť nasledujúce príznaky, ktoré upravujú správanie ls
nasledovným spôsobom:
-1 Vytvorí jednoduchý stĺpcový výstup.
-a Vypíše súbory začínajúce bodkou (`.').
-f Netriedi výpis. Predvolené poradie je lexikografické.
-h Pri použití s voľbou dlhého formátu, použije prípony
jednotiek: Byte, Kilobyte, Megabyte, Gigabyte, Terabyte,
Petabyte,a Exabyte aby sa zmenšil počet potrebných
číslic na štyri a menej použitím mocnín 2 (K=1024,
M=1048576, atď.).
-l Zobrazí ďalšie podrobnosti vrátane informácií o právach
a vlastníctve.
-n Vytvorí dlhý výpis s informáciami o používateľoch a skupinách
prezentovaných číselne.
-r Prevráti poradie triedenia výpisu.
-S Utriedi výpis podľa veľkosti súborov.
-t Utriedi výpis podla času poslednej zmeny.
lumask umask
Nastaví lokálny umask do umask.
mkdir cesta
Vytvorí vzdialený priečinok na zadanej ceste.
progress
Prepína zobrazenie priebehu.
put [-Ppr] lokálna-cesta [vzdialená-cesta]
Odošle lokálnu-cestu a uloží ju do vzdialeného stroja. Ak
vzdialená cesta nie je zadaná, použije sa rovnaký názov
ako na lokálnom stroji. "lokálna-cesta" môže obsahovať
znaky glob(3) a môže zodpovedať viacerým súborom. Ak je to
tak a je zadaná vzdialená-cesta, potom vzdialená-cesta musí
určovať priečinok.
Ak je zadaný príznak -P alebo -p, potom sa skopírujú aj všetky
oprávnenia a časy prístupov.
Ak je zadaný príznak -r, potom sa priečinky budú kopírovať
rekurzívne. Príkaz sftp pri rekurzívnom prenose nebude nasledovať
symbolické prepojenia.
pwd Zobrazí vzdialený pracovný priečinok.
quit Ukončí sftp.
rename starácesta novácesta
Premenuje vzdialený súbor zo starácesta na novácesta.
rm cesta
Odstráni vzdialený súbor na zadanej ceste.
rmdir cesta
Odstráni vzdialený priečinok na zadanej ceste.
symlink starácesta novácestaVytvorí symbolické prepojenie zo starácesta do novácesta.
version
Zobrazí verziu sftp protokolu.
!command
Vykoná príkaz v lokálnom shelli.
! Návrat do lokálneho shellu.
? To isté ako help.
POZRITE AJ
ftp(1), ls(1), scp(1), ssh(1), ssh-add(1), ssh-keygen(1), glob(3),
ssh_config(5), sftp-server(8), sshd(8)
T. Ylonen, S. Lehtinen, SSH File Transfer Protocol,
draft-ietf-secsh-filexfer-00.txt, January 2001, work in progress
material.
