.Dd February 4, 2001 .Dt SFTP 1 .Os

Nom

.Nm sftp .Nd Secure file transfer program - Programme de transfert de fichiers sécurisé

Résumé

.Nm sftp .Op Fl vC1 .Op Fl b Ar batchfile .Op Fl o Ar ssh_option .Op Fl s Ar subsystem | sftp_server .Op Fl B Ar buffer_size .Op Fl F Ar ssh_config .Op Fl P Ar sftp_server path .Op Fl R Ar num_requests .Op Fl S Ar program .Ar host .Nm sftp .Op [user@]host[:file [file]] .Nm sftp .Op [user@]host[:dir[/]]

Description

.Nm est un programme interactif de transfert de fichiers, semblable à .Xr ftp 1 , mais qui réalise toutes ses opérations dans une transmission .Xr ssh 1 cryptée. Il peut également utiliser de nombreuses fonctionnalités de ssh, comme l'authentification par clef publique et la compression. .Nm se connecte à une machine .Ar 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 : .Bl -tag -width Ds .It Fl b Ar batchfile Lit une suite de commande depuis un fichier .Ar batchfile en entrée au lieu de l'entrée standard .Em 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. .Nm s'arrête si l'une des commandes suivantes échoue : .Ic get , put , rename , ln , .Ic rm , mkdir , chdir , lchdir ou .Ic lmkdir . .It Fl o Ar ssh_option Permet de passer des options dans le format utilisé par .Xr ssh_config 5 à .Nm ssh . C'est particulièrement utile pour spécifier des options pour lesquelles il n'y a pas d'équivalent en ligne de commande .Nm . Par exemple, pour préciser un port différent du port par défaut : .Ic sftp -oPort=24 . .It Fl s Ar 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 .Nm sshd distant n'a pas configuré de sous-système sftp. .It Fl v Augmente la verbosité. On peut aussi passer cette option à ssh. .It Fl B Ar buffer_size Spécifie à .Nm 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. .It Fl C Active la compression (à travers l'option .Fl C de ssh). .It Fl F Ar ssh_config Spécifie un fichier de configuration utilisateur différent pour .Nm ssh . Cette option est transmise directement à .Xr ssh 1 . .It Fl P Ar sftp_server path Se connecte directement à un serveur sftp .Nm sftp-server (plutôt qu'à travers ssh). Utile pour le débogage du client et du serveur. .It Fl R Ar 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. .It Fl S Ar program Nom du programme de substitution pour la connexion cryptée. Ce programme doit comprendre les options de .Xr ssh 1 . .It Fl 1 Force l'utilisation de la version 1 du protocole. .El

Commandes interactives

En mode interactif, .Nm utilise un jeu de commandes proches de celles de .Xr 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. .Bl -tag -width Ds .It Ic bye Quitte sftp. .It Ic cd Ar path Change le répertoire distant vers le chemin .Ar path . .It Ic lcd Ar path Change le répertoire local vers le chemin .Ar path . .It Ic chgrp Ar grp Ar path Change le groupe du fichier .Ar path vers .Ar grp . .Ar grp doit être un identifiant de groupe (GID) numérique. .It Ic chmod Ar mode Ar path Change les permissions du fichier .Ar path à .Ar mode . .It Ic chown Ar own Ar path Change le propriétaire du fichier .Ar path vers .Ar own . .Ar own doit être un identifiant d'utilisateur (UID) numérique. .It Ic exit Quitte sftp. .It Xo Ic get .Op Ar flags .Ar remote-path .Op Ar local-path .Xc Récupère le chemin distant .Ar 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 .Fl P est spécifiée, on copie intégralement les permissions et la date d'accès. .It Ic help Affiche un texte d'aide. .It Ic lls Op Ar ls-options Op Ar path Affiche un listage de répertoire local, soit du chemin .Ar path "," soit du répertoire courant, si le chemin .Ar path n'est pas précisé. .It Ic lmkdir Ar path Crée un répertoire local dont le chemin .Ar path est spécifié. .It Ic ln Ar oldpath Ar newpath Crée un lien symbolique de .Ar oldpath vers .Ar newpath "." .It Ic lpwd Affiche le répertoire local en cours. .It Ic ls Op Ar path Affiche un listage du répertoire distant, soit du chemin .Ar path , soit du répertoire courant si .Ar path n'est pas précisé. .It Ic lumask Ar umask Règle le masque local de création de fichier à .Ar umask . .It Ic mkdir Ar path Crée le répertoire distant spécifié par son chemin .Ar path . .It Xo Ic put .Op Ar flags .Ar local-path .Op Ar local-path .Xc envoie .Ar 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 .Fl P est spécifiée, on copie intégralement les permissions et la date d'accès. .It Ic pwd Affiche le répertoire distant en cours. .It Ic quit Quitte sftp. .It Ic rename Ar oldpath Ar newpath Renomme le fichier distant de .Ar oldpath vers .Ar newpath . .It Ic rmdir Ar path Supprime le répertoire distant spécifié par son chemin .Ar path . .It Ic rm Ar path Supprime le fichier distant spécifié par son chemin .Ar path . .It Ic symlink Ar oldpath Ar newpath Crée un lien symbolique de .Ar oldpath vers .Ar newpath . .It Ic ! Ar command Execute la commande .Ar command dans le shell local. .It Ic ! Bascule dans un shell local. .It Ic ? Synonyme pour help. .El

Auteurs

Damien Miller <djm@mindrot.org>

Voir aussi

.Xr scp 1 , .Xr ssh 1 , .Xr ssh-add 1 , .Xr ssh-keygen 1 , .Xr ssh_config 5 , .Xr sftp-server 8 , .Xr sshd 8

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