SFTP(1) General Commands Manual SFTP(1) NUME sftp - transfer securizat de fiiere OpenSSH SINOPSIS sftp [-46AaCfNpqrv] [-B dimensiune-memorie-tampon] [-b fiier-loturi] [-c cifrarea] [-D comanda-server-sftp] [-F ssh_config] [-i fiier-identificare] [-J destinaia] [-l limita] [-o opiun-ssh] [-P port] [-R numar-cereri] [-S program] [-s subsistem | server-sftp] [-X opiune-sftp] destinaia DESCRIERE sftp este un program de transfer de fiiere, similar cu ftp(1), care efectueaza toate operaiile prin intermediul unui transport criptat ssh(1). De asemenea, poate utiliza multe caracteristici ale ssh, cum ar fi autentificarea cu cheie publica i comprimarea. destinaia poate fi specificata fie ca [utilizator@]gazda[:ruta], fie ca adresa URI sub forma sftp://[utilizator@]gazda[:port][/ruta]. In cazul in care destinaia include o ruta i aceasta nu este un director, sftp va prelua automat fiierele daca se utilizeaza o metoda de autentificare non-interactiva; in caz contrar, va face acest lucru dupa o autentificare interactiva reuita. Daca nu este specificata nici o ruta sau daca ruta este un director, sftp se va conecta la gazda file ... specificata i va intra in modul de comanda interactiv, trecand la directorul de la distana daca a fost specificat unul. O bara oblica finala opionala poate fi utilizata pentru a fora interpretarea rutei ca fiind un director. Deoarece formatele de destinaie utilizeaza caracterele doua puncte pentru a delimita numele de gazda de numele rutelor sau de numerele de port, adresele IPv6 trebuie sa fie incluse intre paranteze drepte pentru a evita ambiguitaile. Opiunile sunt urmatoarele: -4 Foreaza sftp sa utilizeze numai adrese IPv4. -6 Foreaza sftp sa utilizeze numai adrese IPv6. -A Permite redirecionarea de ssh-agent(1) catre sistemul la distana. Opiunea implicita este de a nu transmite un agent de autentificare. -a Incearca sa continue transferurile intrerupte in loc sa suprascrie copiile pariale sau complete ale fiierelor existente. In cazul in care coninutul parial difera de cel transferat, este posibil ca fiierul rezultat sa fie corupt. -B dimensiune-memorie-tampon Specifica dimensiunea memoriei tampon pe care sftp o utilizeaza la transferul de fiiere. Memoriile tampon mai mari necesita mai puine calatorii dus-intors, cu preul unui consum mai mare de memorie. Valoarea implicita este de 32768 octei. -b fiier-loturi Modul pe loturi ,,batch" citete o serie de comenzi de la o intrare fiier-loturi in loc de la intrarea standard. Deoarece nu exista interaciune cu utilizatorul, ar trebui utilizat impreuna cu autentificarea non-interactiva pentru a evita necesitatea introducerii unei parole in momentul conectarii (a se vedea sshd(8) i ssh-keygen(1) pentru detalii). Un fiier-loturi de ,,-" poate fi utilizat pentru a indica intrarea standard. sftp va abandona daca una dintre urmatoarele comenzi eueaza: get, put, reget, reput, rename, ln, rm, mkdir, chdir, ls, lchdir, copy, cp, chmod, chown, chgrp, lpwd, df, symlink, i lmkdir. Terminarea la eroare poate fi suprimata pentru fiecare comanda in parte prin prefixarea comenzii cu un caracter `-' (de exemplu, -rm /tmp/blah*). Ecoul comenzii poate fi suprimat prin prefixarea comenzii cu un caracter `@'. Aceste doua prefixe pot fi combinate in orice ordine, de exemplu -@ls /bsd. -C Activeaza comprimarea (prin intermediul fanionului -C din ssh). -c cifrare Selecteaza cifrarea care urmeaza sa fie utilizata pentru criptarea transferurilor de date. Aceasta opiune este transmisa direct catre ssh(1). -D comanda-server-sftp Se conecteaza direct la un server sftp local (mai degraba decat prin ssh(1)). Se pot specifica o comanda i argumente, de exemplu "/ruta/la/sftp-server -el debug3". Aceasta opiune poate fi utila pentru depanarea clientului i a serverului. -F configurare-ssh Specifica un fiier alternativ de configurare per utilizator pentru ssh(1). Aceasta opiune este transmisa direct catre ssh(1). -f Solicita ca fiierele sa fie descarcate pe disc imediat dupa transfer. La incarcarea fiierelor, aceasta funcie este activata numai daca serverul implementeaza extensia ,,fsync@openssh.com". -i fiier-identitate Selecteaza fiierul din care se citete identitatea (cheia privata) pentru autentificarea cu cheie publica. Aceasta opiune este pasata direct catre ssh(1). -J destinaie Se conecteaza la gazda inta facand mai intai o conexiune sftp la gazda de salt descrisa de destinaie i apoi stabilind de acolo o redirecionare TCP catre destinaia finala. Se pot specifica mai multe salturi de conectare separate prin virgula. Aceasta este o prescurtare pentru a specifica o directiva de configurare ProxyJump. Aceasta opiune este pasata direct catre ssh(1). -l limita Limiteaza laimea de banda utilizata, specificata in Kbit/s. -N Dezactiveaza modul silenios, de exemplu, pentru a anula modul silenios implicit stabilit de fanionul -b. -o opiune-ssh Poate fi utilizata pentru a transmite opiuni catre ssh in formatul utilizat in ssh_config(5). Acest lucru este util pentru specificarea opiunilor pentru care nu exista o opiune separata in linia de comanda sftp. De exemplu, pentru a specifica un port alternativ, utilizai: sftp -oPort=24. Pentru detalii complete despre opiunile enumerate mai jos i despre valorile lor posibile, consultai ssh_config(5). AddressFamily BatchMode BindAddress BindInterface CanonicalDomains CanonicalizeFallbackLocal CanonicalizeHostname CanonicalizeMaxDots CanonicalizePermittedCNAMEs CASignatureAlgorithms CertificateFile CheckHostIP Ciphers Comprimare ConnectionAttempts ConnectTimeout ControlMaster ControlPath ControlPersist GlobalKnownHostsFile GSSAPIAuthentication GSSAPIDelegateCredentials HashKnownHosts Host HostbasedAcceptedAlgorithms HostbasedAuthentication HostKeyAlgorithms HostKeyAlias Hostname IdentitiesOnly IdentityAgent IdentityFile IPQoS KbdInteractiveAuthentication KbdInteractiveDevices KexAlgorithms KnownHostsCommand LogLevel MACs NoHostAuthenticationForLocalhost NumberOfPasswordPrompts PasswordAuthentication PKCS11Provider Port PreferredAuthentications ProxyCommand ProxyJump PubkeyAcceptedAlgorithms PubkeyAuthentication RekeyLimit RequiredRSASize SendEnv ServerAliveInterval ServerAliveCountMax SetEnv StrictHostKeyChecking TCPKeepAlive UpdateHostKeys User UserKnownHostsFile VerifyHostKeyDNS -P port Specifica portul la care trebuie sa se conecteze pe gazda la distana. -p Pastreaza timpii de modificare, timpii de acces i modurile din fiierele originale transferate. -q Modul silenios: dezactiveaza contorul de progres, precum i mesajele de avertizare i de diagnosticare de la ssh(1). -R numar-cereri Specifica cate cereri pot fi in curs de soluionare la un moment dat. Creterea acestei valori poate imbunatai uor viteza de transfer a fiierelor, dar va crete utilizarea memoriei. Valoarea implicita este de 64 de solicitari restante. -r Copiaza in mod recursiv directoare intregi la incarcarea i descarcarea de fiiere. Reinei ca sftp nu urmarete legaturile simbolice intalnite in parcurgerea arborelui. -S program Numele programului programului care urmeaza sa fie utilizat pentru conexiunea criptata. Programul trebuie sa ineleaga opiunile ssh(1). -s subsistem | server-sftp Specifica subsistemul SSH2 sau ruta pentru un server sftp pe gazda de la distana. O ruta este utila atunci cand sshd(8) de la distana nu are configurat un subsistem sftp. -v Crete nivelul de jurnalizare. Aceasta opiune este transmisa i la ssh. -X opiune-sftp Specifica o opiune care controleaza aspecte ale comportamentului protocolului SFTP. Opiunile valabile sunt: nrequests=valoare Controleaza numarul de solicitari simultane de citire sau scriere SFTP care pot fi in desfaurare in orice moment in timpul unei descarcari sau incarcari. In mod implicit, 64 de cereri pot fi active simultan. buffer=valoare Controleaza dimensiunea maxima a memoriei tampon pentru o singura operaie SFTP de citire/scriere utilizata in timpul descarcarii sau incarcarii. In mod implicit, se utilizeaza o memorie tampon de 32 Ko. COMENZI INTERACTIVE Odata intrat in modul interactiv, sftp inelege un set de comenzi similare cu cele ale ftp(1). Comenzile sunt insensibile la majuscule i minuscule. Numele de rute care conin spaii trebuie sa fie incluse intre ghilimele. Toate caracterele speciale coninute in numele de ruta care sunt recunoscute de glob(3) trebuie sa fie eludate cu bare inclinate invers (`\'). bye Quit sftp. cd [ruta] Schimba directorul la distana in ruta. Daca ruta nu este specificata, atunci schimba directorul la cel in care a inceput sesiunea. chgrp [--h] grp ruta Schimba grupul fiierelor ruta in grp. ruta poate conine caractere glob(7) i se poate potrivi cu mai multe fiiere. grp trebuie sa fie un GID numeric. Daca este specificat fanionul -h, atunci legaturile simbolice nu vor fi urmate. Reinei ca acest lucru este acceptat numai de serverele care implementeaza extensia ,,lsetstat@openssh.com". chmod [--h] mod ruta Schimba permisiunile fiierului ruta in mod. ruta poate conine caractere glob(7) i poate corespunde mai multor fiiere. Daca este specificat fanionul -h, atunci legaturile simbolice nu vor fi urmate. Reinei ca acest lucru este acceptat numai de serverele care implementeaza extensia ,,lsetstat@openssh.com". chown [--h] proprietar ruta Schimba proprietarul fiierului ruta in proprietar. ruta poate conine caractere glob(7) i poate corespunde mai multor fiiere. proprietar trebuie sa fie un UID numeric. Daca este specificat fanionul -h, atunci legaturile simbolice nu vor fi urmate. Reinei ca acest lucru este acceptat numai de serverele care implementeaza extensia ,,lsetstat@openssh.com". copy ruta-veche ruta-noua Copiaza fiierul de la distana din ruta-veche in ruta-noua. Reinei ca acest lucru este acceptat numai de serverele care implementeaza extensia ,,copy-data". cp ruta-veche ruta-noua Alias pentru comanda copy. df [-hi] [ruta] Afieaza informaii de utilizare pentru sistemul de fiiere care conine directorul curent (sau ruta daca este specificata). Daca se specifica fanionul -h, informaiile privind capacitatea vor fi afiate folosind sufixe "uor de citit de catre om". Fanionul -i solicita afiarea informaiilor despre noduri-i in plus faa de informaiile despre capacitate. Aceasta comanda este acceptata numai pe serverele care implementeaza extensia "statvfs@openssh.com". exit Quit sftp. get [-afpR] ruta-la-distana [ruta-locala] Preia ruta-la-distana i o stocheaza pe maina locala. Daca nu este specificat numele rutei locale, aceasta primete acelai nume pe care il are pe maina la distana. ruta-la-distana poate conine caractere glob(7) i poate corespunde mai multor fiiere. In acest caz, daca ruta-locala este specificata, atunci ruta-locala trebuie sa specifice un director. Daca se specifica fanionul -a, atunci se incearca reluarea transferurilor pariale ale fiierelor existente. Reinei ca reluarea presupune ca orice copie pariala a fiierului local coincide cu copia de la distana. In cazul in care coninutul fiierului la distana difera de cel al copiei locale pariale, atunci este probabil ca fiierul rezultat sa fie corupt. In cazul in care se specifica fanionul -f, atunci fsync(2) va fi apelat dupa finalizarea transferului de fiiere pentru a spala fiierul pe disc. Daca se specifica fanionul -p, atunci se copiaza i permisiunile complete ale fiierelor i timpii de acces. Daca se specifica fanionul -R, atunci directoarele vor fi copiate recursiv. Reinei ca sftp nu urmarete legaturile simbolice atunci cand efectueaza transferuri recursive. help Afieaza textul de ajutor. lcd [ruta] Schimba directorul local in ruta. Daca nu se specifica ruta, atunci schimba directorul in directorul de origine al utilizatorului local. lls [opiuni-ls [ruta]] Afieaza lista directoarelor locale fie din ruta, fie din directorul curent, daca nu este specificata ruta. ls-options poate conine orice opiuni acceptate de comanda ls(1) a sistemului local. ruta poate conine caractere glob(7) i poate corespunde mai multor fiiere. lmkdir ruta Creeaza directorul local specificat de ruta. ln [-s] ruta-veche ruta-noua Creeaza o legatura de la ruta-veche la ruta-noua. Daca se specifica fanionul -s, legatura creata este o legatura simbolica, in caz contrar este o legatura dura. lpwd Afieaza directorul de lucru local. ls [-1afhlnrSt] [ruta] Afieaza o lista de directoare la distana, fie din ruta, fie din directorul curent, daca ruta nu este specificata. ruta poate conine caractere glob(7) i poate corespunde mai multor fiiere. Urmatoarele opiuni sunt recunoscute i modifica comportamentul lui ls in consecina: -1 Produce o singura coloana la ieire. -a Listeaza fiierele care incep cu un punct (`.'). -f Nu sorteaza lista. Ordinea de sortare implicita este lexicografica. -h Atunci cand se utilizeaza cu o opiune de format lung, se folosesc sufixe de unitate: Octet, Kilooctei, Megaoctei, Gigaoctei, Teraoctei, Petaoctei i Exoctei pentru a reduce numarul de cifre la patru sau mai puine, folosind puteri de 2 pentru dimensiuni (K=1024, M=1048576 etc.). -l Afieaza detalii suplimentare, inclusiv informaii privind permisiunile i proprietatea. -n Produce o lista lunga cu informaii despre utilizatori i grupuri prezentate sub forma numerica. -r Inverseaza ordinea de sortare a listei. -S Sorteaza lista in funcie de dimensiunea fiierului. -t Sorteaza lista dupa ultima ora de modificare. lumask umask Stabilete valoarea umask locala la umask. mkdir ruta Creeaza directorul la distana specificat de ruta. progress Activeaza afiarea indicatorului de progres. put [-afpR] ruta-locala [ruta-la-distana] Incarca ruta-locala i il stocheaza pe maina de la distana. Daca nu este specificat numele rutei la distana, i se atribuie acelai nume pe care il are pe maina locala. ruta-locala poate conine caractere glob(7) i poate corespunde mai multor fiiere. In acest caz, daca ruta-la-distana este specificata, atunci ruta-la-distana trebuie sa specifice un director. Daca se specifica fanionul -a, atunci se incearca reluarea transferurilor pariale ale fiierelor existente. Reinei ca reluarea presupune ca orice copie pariala a fiierului de la distana coincide cu copia locala. In cazul in care coninutul fiierului local difera de cel al copiei locale de la distana, atunci este probabil ca fiierul rezultat sa fie corupt. Daca este specificat fanionul -f, atunci se va trimite o cerere catre server pentru a apela fsync(2) dupa ce fiierul a fost transferat. Reinei ca acest lucru este acceptat numai de serverele care implementeaza extensia ,,fsync@openssh.com". Daca se specifica fanionul -p, atunci se copiaza i permisiunile complete ale fiierelor i timpii de acces. Daca se specifica fanionul -R, atunci directoarele vor fi copiate recursiv. Reinei ca sftp nu urmarete legaturile simbolice atunci cand efectueaza transferuri recursive. pwd Afieaza directorul de lucru de la distana. quit Quit sftp. reget [-fpR] ruta-la-distana [ruta-locala] Reia descarcarea lui ruta-la-distana. Echivalent cu get cu fanionul -a activat. reput [-fpR] ruta-locala [ruta-la-distana] Reia descarcarea lui ruta-locala. Echivalent cu get cu fanionul -a activat. rename ruta-veche ruta-noua Redenumete fiierul la distana din ruta-veche in ruta-noua. rm ruta terge fiierul de la distana specificat de ruta. rmdir ruta Elimina directorul la distana specificat de ruta. symlink ruta-veche ruta-noua Creeaza o legatura simbolica de la ruta-veche la ruta-noua. version Afieaza versiunea protocolului sftp. !comanda Executa comanda in shell-ul local. ! Eludeaza in shell-ul local. ? Snonim pentru ,,help". CONSULTAI I ftp(1), ls(1), scp(1), ssh(1), ssh-add(1), ssh-keygen(1), ssh_config(5), glob(7), sftp-server(8), sshd(8) T. Ylonen and S. Lehtinen, SSH File Transfer Protocol, draft-ietf-secsh-filexfer-00.txt, ianuarie 2001, material in curs de elaborare. TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3: https://www.gnu.org/licenses/gpl-3.0.html sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la translation-team-ro@lists.sourceforge.net Linux 6.10.10-arch1-1 $Mdocdate: 16 decembrie 2022 $ Linux 6.10.10-arch1-1