NOM

sftp — Transfert de fichier sécurisé par OpenSSH

SYNOPSIS

sftp [-46AaCfNpqrv] [-B taille_tampon] [-b fichier_batch] [-c algo_chiffrement] [-D commande_serveur_sftp] [-F configuration_ssh] [-i fichier_identité] [-J destination] [-l limite] [-o option_ssh] [-P port] [-R nombre_requêtes] [-S programme] [-s sous_système | serveur_sftp] [-X option_sftp] destination

DESCRIPTION

sftp est un programme de transfert de fichier similaire à ftp(1) qui effectue toutes ses opérations sur un transport chiffré ssh(1). Il peut aussi utiliser de nombreuses fonctionnalités de ssh comme l’authentification par clé publique et la compression.

La destination peut être spécifiée sous la forme [utilisateur@]hôte[:chemin] ou à l’aide de l’URI sftp://[utilisateur@]hôte[:port][/chemin].

Si la destination comporte un chemin et s’il ne s’agit pas d’un répertoire, sftp retrouvera automatiquement les fichiers si une méthode d’authentification non interactive est utilisée ; dans le cas contraire, il le fera après une authentification interactive réussie.

Si aucun chemin n’est spécifié ou si chemin est un répertoire, sftp se connectera à l’ hôte spécifié et entrera en mode commande interactif, en se plaçant dans le répertoire distant s’il est indiqué. Il est possible d’ajouter un barre oblique en fin de chemin pour forcer l’interprétation de chemin comme répertoire.

Comme les formats de la destination utilisent des caractères deux-points (« : ») pour séparer les noms d’hôte des noms de chemin ou des numéros de port, les adresses IPv6 doivent être entourées de crochets (« [] ») pour éviter toute ambiguïté.

Les options sont les suivantes :

-4

Forcer sftp à n’utiliser que des adresses IPv4.

-6

Forcer sftp à n’utiliser que des adresses IPv6.

-A

Autoriser la redirection de ssh-agent(1) vers le système distant. Par défaut, la redirection d’un agent d’authentification n’est pas autorisée.

-a

Essayer de reprendre les transferts interrompus au lieu d’écraser les copies de fichiers existantes partielles ou complètes. Si le contenu partiel diffère de celui qui est en cours de transfert, le fichier résultant sera probablement corrompu.

-B taille_tampon

Cette option permet de spécifier la taille du tampon utilisé par sftp lors d’un transfert de fichiers. Une taille de tampon plus grande nécessitera moins d’allers-retours au prix d’une consommation de mémoire plus importante. La valeur par défaut est 32768 octets.

-b fichier_batch

Le mode de traitement par lot lit une suite de commandes depuis un fichier d’entrée fichier_batch au lieu de stdin. Comme il n'y a pas d'interaction avec l'utilisateur, ce mode doit être utilisé avec une authentification non interactive pour éviter d’avoir à fournir un mot de passe lors de la connexion (voir sshd(8) et ssh-keygen(1) pour les détails).

Utiliser « - » comme fichier_batch permet d’indiquer l'entrée standard. sftp s'interrompra si l'une des commandes suivantes échoue : get, put, reget, reput, rename, ln, rm, mkdir, chdir, ls, lchdir, copy, cp, chmod, chown, chgrp, lpwd, df, symlink et lmkdir.

La sortie sur erreur peut être supprimée commande par commande en préfixant la commande par un caractère « - » (par exemple, -rm /tmp/blah*). L’écho de la commande peut être supprimé en préfixant la commande par un caractère « @ ». Ces deux préfixes peuvent être combinés entre eux dans n’importe quel ordre (par exemple -@ls /bsd).

-C

Activer la compression (à l’aide de l'option -C de ssh).

-c algorithme_chiffrement

Cette option permet de sélectionner l’algorithme de chiffrement à utiliser pour le chiffrement des transferts de données. Cette option est passée directement à ssh(1).

-D commande_serveur_sftp

Cette option permet d’indiquer un serveur sftp local auquel se connecter directement (plutôt que par ssh(1)). Il est possible de spécifier une commande et ses arguments (par exemple « /chemin/serveur_sftp -el debug3 »). Cette option peut s’avérer utile pour le débogage du client et du serveur.

-F configuration_ssh

Cette option permet de spécifier un fichier de configuration par utilisateur de remplacement pour ssh(1). Elle est passée directement à ssh(1).

-f

Forcer l’écriture des fichiers sur disque immédiatement après leur transfert. Lors d’un téléversement de fichier, cette fonctionnalité n’est activée que si le serveur prend en charge l’extension « fsync@openssh.com ».

-i fichier_identité

Cette option permet de sélectionner le fichier à partir duquel l’identité (la clé privée) sera lue pour l'authentification par clé publique. Elle est passée directement à ssh(1).

-J destination

Se connecter à l’hôte cible en établissant tout d’abord une connexion sftp vers la machine de saut indiquée par destination, puis en effectuant une redirection TCP vers la destination finale depuis la machine de saut. Il est possible de spécifier plusieurs sauts successifs en les séparant par des virgules. Cette option est un raccourci pour définir une directive de configuration ProxyJump. Cette option est passée directement à ssh(1).

-l limite

Cette option permet de limiter la bande passante utilisée en spécifiant sa valeur maximale en kbit/s.

-N

Désactiver le mode silencieux, par exemple pour outrepasser le mode silencieux implicite défini par l’option -b.

-o option_ssh

Cette option permet de passer des options à ssh au format utilisé dans ssh_config(5). Elle s’avère utile pour spécifier des options pour lesquelles il n'y a pas d'option dédiée pour la ligne de commande de sftp. Par exemple, pour spécifier un port de remplacement : sftp -oPort=24. Pour plus de détails sur les options énumérées ci-après et leurs valeurs possibles, voir ssh_config(5).

AddKeysToAgent
AddressFamily
BatchMode
BindAddress
BindInterface
CASignatureAlgorithms
CanonicalDomains
CanonicalizeFallbackLocal
CanonicalizeHostname
CanonicalizeMaxDots
CanonicalizePermittedCNAMEs
CertificateFile
ChannelTimeout
CheckHostIP
Ciphers
ClearAllForwardings
Compression
ConnectTimeout
ConnectionAttempts
ControlMaster
ControlPath
ControlPersist
DynamicForward
EnableEscapeCommandline
EnableSSHKeysign
EscapeChar
ExitOnForwardFailure
FingerprintHash
ForkAfterAuthentication
ForwardAgent
ForwardX11
ForwardX11Timeout
ForwardX11Trusted
GSSAPIAuthentication
GSSAPIDelegateCredentials
GatewayPorts
GlobalKnownHostsFile
HashKnownHosts
Host
HostKeyAlgorithms
HostKeyAlias
HostbasedAcceptedAlgorithms
HostbasedAuthentication
Hostname
IPQoS
IdentitiesOnly
IdentityAgent
IdentityFile
IgnoreUnknown
Include
KbdInteractiveAuthentication
KbdInteractiveDevices
KexAlgorithms
KnownHostsCommand
LocalCommand
LocalForward
LogLevel
LogVerbose
MACs
NoHostAuthenticationForLocalhost
NumberOfPasswordPrompts
ObscureKeystrokeTiming
PKCS11Provider
PasswordAuthentication
PermitLocalCommand
PermitRemoteOpen
Port
PreferredAuthentications
ProxyCommand
ProxyJump
ProxyUseFdpass
PubkeyAcceptedAlgorithms
PubkeyAuthentication
RekeyLimit
RemoteCommand
RemoteForward
RequestTTY
RequiredRSASize
RevokedHostKeys
SecurityKeyProvider
SendEnv
ServerAliveCountMax
ServerAliveInterval
SessionType
SetEnv
StdinNull
StreamLocalBindMask
StreamLocalBindUnlink
StrictHostKeyChecking
SyslogFacility
TCPKeepAlive
Tag
Tunnel
TunnelDevice
UpdateHostKeys
User
UserKnownHostsFile
VerifyHostKeyDNS
VisualHostKey
XAuthLocation

-P port

Cette option permet de spécifier le port auquel se connecter sur l'hôte distant.

-p

Préserver les dates de modifications, d'accès et les modes des fichiers transférés.

-q

Mode silencieux : la barre de progression ainsi que les messages d’avertissement et de diagnostic en provenance de ssh(1) sont désactivés.

-R nombre_requêtes

Cette option permet de spécifier le nombre de requêtes pouvant être en attente à un instant donné. Augmenter ce nombre améliorera légèrement la vitesse de transfert des fichiers, mais augmentera la consommation de mémoire. La valeur par défaut est de 64 requêtes en attente.

-r

Copier récursivement les répertoires complets lors d’un téléversement ou d’un téléchargement. Notez que sftp ne suit pas les liens symboliques rencontrés lors du parcours de l'arborescence.

-S programme

Cette option permet de spécifier le nom du programme à utiliser pour la connexion chiffrée. Ce programme doit prendre en charge les options de ssh(1).

-s sous_système | serveur_sftp

Cette option permet de spécifier le sous-sytème SSH2 ou le chemin d'un serveur sftp sur l'hôte distant. Un tel chemin s’avère utile lorsque que le démon sshd(8) distant n'a pas de sous-système sftp configuré.

-v

Augmenter le niveau de journalisation. Cette option est aussi passée à ssh(1).

-X option_sftp

Cette option permet de spécifier une option qui contrôle certains aspects du comportement du protocole SFTP. Les options disponibles sont :

nrequests=valeur: Cette option permet de définir le nombre de requêtes SFTP de lecture ou d’écriture qui peuvent être traitées simultanément au cours d’un téléchargement ou d’un téléversement. Par défaut, 64 requêtes peuvent être traitées simultanément.
buffer=valeur: Cette option permet de définir la taille maximale du tampon utilisé lors d’un téléchargement ou d’un téléversement pour une seule opération SFTP de lecture/écriture. La valeur par défaut est de 32 ko.

COMMANDES INTERACTIVES

En mode interactif, sftp prend en charge un jeu de commandes similaires à celles de ftp(1). Les commandes sont insensibles à la casse. Les noms des chemins contenant des espaces doivent être entourés de guillemets droits simples (« ' »). Tout caractère spécial contenu dans un nom de chemin et reconnu par glob(3) doit être protégé par une barre oblique inverse (« \[u00A0]»).

bye

Quitter sftp.

cd [chemin]

Changer le répertoire distant pour chemin. Si chemin n’est pas spécifié, changer le répertoire pour celui sous lequel la session a démarré.

chgrp [-h] grp chemin

Changer le groupe du fichier chemin à grp. chemin peut contenir des caractères glob(7) et peut correspondre à plusieurs fichiers. grp doit être un GID numérique.

Si l’option -h est spécifiée, les liens symboliques ne seront pas suivis. Notez que cette fonctionnalité n’est prise en charge que par les serveurs qui implémentent l’extension « lsetstat@openssh.com ».

chmod [-h] mode chemin

Changer les permissions du fichier path à mode. chemin peut contenir des caractères glob(7) et peut correspondre à plusieurs fichiers.

Si l’option -h est spécifiée, les liens symboliques ne seront pas suivis. Notez que cette fonctionnalité n’est prise en charge que par les serveurs qui implémentent l’extension « lsetstat@openssh.com ».

chown [-h] propriétaire chemin

Changer le propriétaire du fichier chemin à propriétaire. chemin peut contenir des caractères glob(7) et peut correspondre à plusieurs fichiers. propriétaire doit être un UID numérique.

Si l’option -h est spécifiée, les liens symboliques ne seront pas suivis. Notez que cette fonctionnalité n’est prise en charge que par les serveurs qui implémentent l’extension « lsetstat@openssh.com ».

copy ancien_chemin nouveau_chemin

Copier le fichier distant de ancien_chemin vers nouveau_chemin.

Notez que cette fonctionnalité n’est prise en charge que par les serveurs qui implémentent l’extension « copy-data ».

cp ancien_chemin nouveau_chemin

Alias de la commande copy.

df [-hi] [chemin]

Afficher les informations d’utilisation du système de fichiers contenant le répertoire actuel (ou chemin si spécifié). Si l’option -h est spécifiée, les informations d’utilisation seront affichées avec des suffixes « lisibles par les humains ». Le drapeau -i demande l'affichage des numéros d'inodes en plus des informations d’utilisation. Cette commande n’est prise en charge que par les serveurs qui implémentent l'extension « statvfs@openssh.com ».

exit

Quitter sftp.

get [-afpR] chemin_distant [chemin_local]

Récupérer l'emplacement chemin_distant et le stocker sur la machine locale. Si le nom d'emplacement local n'est pas spécifié, il adoptera le même nom que sur l’hôte distant. chemin_distant peut contenir des caractères glob(7) et peut correspondre à plusieurs fichiers. Si c'est le cas et si un chemin_local est spécifié, chemin_local doit correspondre à un répertoire.

Si l’option -a est spécifiée, tenter de reprendre les transferts partiels des fichiers existants. Notez que la reprise suppose que toute copie partielle du fichier local correspond à la copie distante. Si le contenu du fichier distant diffère de celui de la copie partielle locale, le fichier résultant sera probablement corrompu.

Si l’option -f est spécifiée, fsync(2) sera appelé après le transfert complet du fichier pour enregistrer ce dernier sur disque.

Si l’option -p est spécifiée, les permissions complètes du fichier et les heures d'accès seront aussi conservées.

Si l’option -R est spécifiée, les répertoires seront copiés récursivement. Notez que sftp ne suit pas les liens symboliques lors de transferts récursifs.

help

Afficher le texte de l'aide.

lcd [chemin]

Changer le répertoire local en chemin. Si chemin n’est pas spécifié, changer le répertoire pour le répertoire personnel de l’utilisateur local.

lls [options_ls [chemin]]

Afficher la liste des fichiers du répertoire local chemin ou du répertoire local actuel si chemin n'est pas spécifié. options_ls peut contenir n'importe quelle option prise en charge par la commande ls(1) du système local. chemin peut contenir des caractères glob(7) et peut correspondre à plusieurs fichiers.

lmkdir chemin

Créer le répertoire local spécifié par chemin.

ln [-s] ancien_chemin nouveau_chemin

Créer un lien de ancien_chemin à nouveau_chemin. Si l’option -s est spécifiée, le lien créé sera un lien symbolique, sinon ce sera un lien physique.

lpwd

Afficher le répertoire de travail local.

ls [-1afhlnrSt] [chemin]

Afficher la liste des fichiers du répertoire distant chemin ou du répertoire actuel si chemin n'est pas spécifié. chemin peut contenir des caractères glob(7) et peut correspondre à plusieurs fichiers.

Les options suivantes sont reconnues et modifient le comportement de ls en conséquence :

-1: Produire une sortie sur une seule colonne.
-a: Lister les fichiers dont le nom commence par un point « . ».
-f: Ne pas trier la liste. L’ordre de tri par défaut est lexicographique.
-h: Avec l'option de format long, utiliser les suffixes d'unité : Octet, Kilooctet, Megaoctet, Gigaoctet, Teraoctet, Petaoctet et Exaoctet pour réduire le nombre de chiffres à quatre ou moins à l'aide de puissances de 2 pour les tailles (K=1024, M=1048576, etc.).
-l: Afficher des informations supplémentaires dont les permissions et le propriétaire.
-n: Produire une longue liste avec les informations sur le propriétaire et le groupe présentées de manière numérique.
-r: Inverser l'ordre de tri de la liste.
-S: Trier la liste par taille de fichier.
-t: Trier la liste par date de dernière modification.

lumask umask

Définir l'umask (mode de création de fichier) local à umask.

mkdir chemin

Créer le répertoire distant spécifié par chemin.

progress

Activer l'affichage de la barre de progression.

put [-afpR] chemin_local [chemin_distant]

Téléverser l'emplacement chemin_local et le stocker sur l’hôte distant. Si le chemin distant n'est pas spécifié, il adoptera le même nom que sur la machine locale. chemin_local peut contenir des caractères glob(7) et peut correspondre à plusieurs fichiers. Si c'est le cas et si un chemin_distant est spécifié, ce dernier doit correspondre à un répertoire.

Si l’option -a est spécifiée, tenter de reprendre les transferts partiels des fichiers existants. Notez que la reprise suppose que toute copie partielle du fichier distant correspond à la copie locale. Si le contenu du fichier local diffère de celui de la copie partielle distante, le fichier résultant sera probablement corrompu.

Si l’option -f est spécifiée, il sera demandé au serveur d’appeler fsync(2) une fois le transfert du fichier terminé. Notez que cette fonctionnalité n’est prise en charge que par les serveurs qui implémentent l’extension « fsync@openssh.com ».

Si l’option -p est spécifiée, les permissions complètes du fichier et les heures d'accès seront aussi conservées.

Si l’option -R est spécifiée, les répertoires seront copiés récursivement. Notez que sftp ne suit pas les liens symboliques lors de transferts récursifs.

pwd

Affiche le répertoire de travail distant.

quit

Quitter sftp.

reget [-fpR] chemin_distant [chemin_local]

Reprendre le téléchargement de chemin_distant. Équivalent à get avec le drapeau -a défini.

reput [-fpR] chemin_local [chemin_distant]

Reprendre le téléversement de chemin_local. Équivalent à put avec le drapeau -a défini.

rename ancien_chemin nouveau_chemin

Renommer le fichier distant ancien_chemin en nouveau_chemin.

rm chemin

Supprimer le fichier distant spécifié par l'emplacement chemin.

rmdir chemin

Supprimer le répertoire distant spécifié par l'emplacement chemin.

symlink ancien_chemin nouveau_chemin

Créer un lien symbolique de ancien_chemin vers nouveau_chemin.

version

Afficher la version du protocole de sftp.

!commande

Exécuter la commande dans l’interpréteur de commande local.

!

Basculer dans l’interpréteur de commande local.

?

Synonyme pour aide.

VOIR AUSSI

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, janvier 2001, travail en cours.

TRADUCTION

La traduction française de cette page de manuel a été créée par Lucien Gentis <lucien.gentis@univ-lorraine.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org