sftp − Secure file transfer program - Programme de transfert de fichiers sécurisé

sftp [−vC1] [−b batchfile] [−o ssh_option] [−s subsystem | sftp_server] [−B buffer_size] [−F ssh_config] [−P sftp_server path] [−R num_requests] [−S program] host

sftp [[user@]host[:file [file]]]

sftp [[user@]host[:dir[/]]]

DESCRIPTION

sftp est un programme interactif de transfert de fichiers, semblable à ftp(1), mais qui réalise toutes ses opérations dans une transmission ssh(1) cryptée. Il peut également utiliser de nombreuses fonctionnalités de ssh, comme l’authentification par clef publique et la compression. sftp se connecte à une machine host, puis bascule dans un mode interactif.

La seconde méthode permet de récupérer automatiquement des fichiers si on utilise une méthode d’authentification non interactive ; sinon on procède normalement, après s’être authentifié de manière interactive avec succès.

La dernière méthode permet de démarrer le client sftp dans un répertoire distant.

Les options sont les suivantes :

Lit une suite de commande depuis un fichier batchfile en entrée au lieu de l’entrée standard stdin, en mode traitement par lot (batch). Comme il n’y a pas d’interaction avec un utilisateur, il est souhaitable de l’utiliser avec une authentification non interactive. sftp s’arrête si l’une des commandes suivantes échoue : get, put, rename, ln, rm, mkdir, chdir, lchdir ou lmkdir.

−o ssh_option
Permet de passer des options dans le format utilisé par ssh_config(5) à ssh. C’est particulièrement utile pour spécifier des options pour lesquelles il n’y a pas d’équivalent en ligne de commande sftp. Par exemple, pour préciser un port différent du port par défaut : sftp -oPort=24.

−s subsystem | sftp_server
Spécifie un sous-système (subsystem) SSH2, ou le chemin vers un serveur sftp sur la machine distante. L’utilisation d’un chemin pour un serveur sftp est bien utile pour utiliser sftp en version 1 (Note du traducteur : C’est une nouvelle fonctionnalité de OpenSSH 2), ou si le sshd distant n’a pas configuré de sous-système sftp.

−v’ Augmente la verbosité. On peut aussi passer cette option à ssh.

−B buffer_size
Spécifie à sftp la taille du tampon à utiliser lors des transferts de fichiers. De grand tampons nécessitent moins d’allers-retours, mais consomment davantage de mémoire. Par défaut 32768 octets.

−C’ Active la compression (Ã travers l’option −C de ssh).

−F ssh_config
Spécifie un fichier de configuration utilisateur différent pour ssh. Cette option est transmise directement à ssh(1).

−P sftp_server path
Se connecte directement à un serveur sftp sftp-server (plutôt qu’à travers ssh). Utile pour le débogage du client et du serveur.

−R num_requests
Spécifie un nombre de demandes en suspens à tout instant. Ceci peut améliorer la vitesse de transfert, mais consomme davantage de mémoire. Par défaut 16 demandes en attente.

−S program
Nom du programme de substitution pour la connexion cryptée. Ce programme doit comprendre les options de ssh(1).

−1’ Force l’utilisation de la version 1 du protocole.

COMMANDES INTERACTIVES

En mode interactif, sftp utilise un jeu de commandes proches de celles de ftp(1). Les commandes ne sont pas sensibles à la casse, et les chemins de fichiers ou de répertoires doivent être protégés par des guillements s’ils contiennent des espaces.

cd path
Change le répertoire distant vers le chemin path.

lcd path
Change le répertoire local vers le chemin path.

chgrp grp path
Change le groupe du fichier path vers grp. grp doit être un identifiant de groupe (GID) numérique.

chmod mode path
Change les permissions du fichier path à mode.

chown own path
Change le propriétaire du fichier path vers own. own doit être un identifiant d’utilisateur (UID) numérique.

exit’ Quitte sftp.

get [flags] remote-path [local-path]
Récupère le chemin distant remote-path et le stocke sur la machine locale. Si le chemin local n’est pas précisé, il aura le même nom que sur la machine distante. Si l’option −P est spécifiée, on copie intégralement les permissions et la date d’accès.

help’ Affiche un texte d’aide.

lls [ls-options [path]]
Affiche un listage de répertoire local, soit du chemin path, soit du répertoire courant, si le chemin path n’est pas précisé.

lmkdir path
Crée un répertoire local dont le chemin path est spécifié.

ln oldpath newpath
Crée un lien symbolique de oldpath vers newpath.

lpwd’ Affiche le répertoire local en cours.

ls [path]
Affiche un listage du répertoire distant, soit du chemin path, soit du répertoire courant si path n’est pas précisé.

lumask umask
Règle le masque local de création de fichier à umask.

mkdir path
Crée le répertoire distant spécifié par son chemin path.

put [flags] local-path [local-path]
envoie local-path et le stocke sur la machine distante. Si le chemin sur la machine distante n’est pas précisé, il aura le même nom que sur la machine locale. Si l’option −P est spécifiée, on copie intégralement les permissions et la date d’accès.

pwd’ Affiche le répertoire distant en cours.

quit’ Quitte sftp.

rename oldpath newpath
Renomme le fichier distant de oldpath vers newpath.

rmdir path
Supprime le répertoire distant spécifié par son chemin path.

rm path
Supprime le fichier distant spécifié par son chemin path.

symlink oldpath newpath
Crée un lien symbolique de oldpath vers newpath.

! command
Execute la commande command dans le shell local.

!’ Bascule dans un shell local.

?’ Synonyme pour help.

AUTEURS

Damien Miller <djm@mindrot.org>

scp(1), ssh(1), ssh-add(1), ssh-keygen(1), ssh_config(5), sftp-server(8), sshd(8)