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[/]]]

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 :

-b batchfile

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_config5 à ssh C'est particulièrement utile pour spécifier des options pour lesquelles il n'y a pas d'équivalent en ligne de commande . 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.

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.

bye

Quitte sftp.

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.

Damien Miller <djm@mindrot.org>

scp(1), ssh(1), ssh-add1, ssh-keygen1, ssh_config5, sftp-server8, sshd(8)

T. Ylonen S. Lehtinen "SSH File Transfer Protocol" draft-ietf-secsh-filexfer-00.txt January 2001 work in progress material