.\" -*- coding: UTF-8 -*- .\" $OpenBSD: sftp.1,v 1.143 2022/12/16 03:40:03 djm Exp $ .\" .\" Copyright (c) 2001 Damien Miller. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .Dd $Mdocdate: 16 décembre 2022 $ .Dt SFTP 1 .Os .Sh NOM .Nm sftp .Nd Transfert de fichier sécurisé par OpenSSH .Sh SYNOPSIS .Nm sftp .Op Fl 46AaCfNpqrv .Op Fl B Ar taille_tampon .Op Fl b Ar fichier_batch .Op Fl c Ar algo_chiffrement .Op Fl D Ar commande_serveur_sftp .Op Fl F Ar configuration_ssh .Op Fl i Ar fichier_identité .Op Fl J Ar destination .Op Fl l Ar limite .Op Fl o Ar option_ssh .Op Fl P Ar port .Op Fl R Ar nombre_requêtes .Op Fl S Ar programme .Op Fl s Ar sous_système | serveur_sftp .Op Fl X Ar option_sftp .Ar destination .Sh DESCRIPTION .Nm sftp est un programme de transfert de fichier similaire à .Xr ftp 1 qui effectue toutes ses opérations sur un transport chiffré .Xr ssh 1 . Il peut aussi utiliser de nombreuses fonctionnalités de ssh comme l’authentification par clé publique et la compression. .Pp La .Ar destination peut être spécifiée sous la forme .Sm off .Oo utilisateur @ Oc hôte Op : chemin .Sm on ou à l’aide de l’URI .Sm off .No sftp:// Oo utilisateur @ Oc hôte Oo : port Oc Op / chemin . .Sm on .Pp Si la .Ar destination comporte un .Ar chemin et s’il ne s’agit pas d’un répertoire, .Nm 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. .Pp Si aucun .Ar chemin n’est spécifié ou si .Ar chemin est un répertoire, .Nm sftp se connectera à l’ .Ar 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 .Ar chemin comme répertoire. .Pp 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é. .Pp Les options sont les suivantes : .Bl -tag -width Ds .It Fl 4 Forcer .Nm sftp à n’utiliser que des adresses IPv4. .It Fl 6 Forcer .Nm sftp à n’utiliser que des adresses IPv6. .It Fl A Autoriser la redirection de .Xr ssh-agent 1 vers le système distant. Par défaut, la redirection d’un agent d’authentification n’est pas autorisée. .It Fl 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. .It Fl B Ar taille_tampon Cette option permet de spécifier la taille du tampon utilisé par .Nm 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. .It Fl b Ar fichier_batch Le mode de traitement par lot lit une suite de commandes depuis un fichier d’entrée .Ar fichier_batch au lieu de .Em 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 .Xr sshd 8 et .Xr ssh-keygen 1 pour les détails). .Pp Utiliser « - » comme .Ar fichier_batch permet d’indiquer l'entrée standard. .Nm sftp s'interrompra si l'une des commandes suivantes échoue : .Ic get, put, reget, reput, rename, ln , .Ic rm, mkdir, chdir, ls , .Ic lchdir, copy, cp, chmod, chown , .Ic chgrp, lpwd, df, symlink et .Ic lmkdir . .Pp La sortie sur erreur peut être supprimée commande par commande en préfixant la commande par un caractère « - » (par exemple, .Ic -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 .Ic -@ls /bsd ) . .It Fl C Activer la compression (à l’aide de l'option .Fl C de ssh). .It Fl c Ar 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 à .Xr ssh 1 . .It Fl D Ar commande_serveur_sftp Cette option permet d’indiquer un serveur sftp local auquel se connecter directement (plutôt que par .Xr 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. .It Fl F Ar configuration_ssh Cette option permet de spécifier un fichier de configuration par utilisateur de remplacement pour .Xr ssh 1 . Elle est passée directement à .Xr ssh 1 . .It Fl 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 ». .It Fl i Ar 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 à .Xr ssh 1 . .It Fl J Ar destination Se connecter à l’hôte cible en établissant tout d’abord une connexion .Nm sftp vers la machine de saut indiquée par .Ar 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 .Cm ProxyJump . Cette option est passée directement à .Xr ssh 1 . .It Fl l Ar limite Cette option permet de limiter la bande passante utilisée en spécifiant sa valeur maximale en kbit/s. .It Fl N Désactiver le mode silencieux, par exemple pour outrepasser le mode silencieux implicite défini par l’option .Fl b . .It Fl o Ar option_ssh Cette option permet de passer des options à .Nm ssh au format utilisé dans .Xr 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 .Nm sftp . Par exemple, pour spécifier un port de remplacement : .Ic sftp -oPort=24 . Pour plus de détails sur les options énumérées ci-après et leurs valeurs possibles, voir .Xr ssh_config 5 . .Pp .Bl -tag -width Ds -offset indent -compact .It AddressFamily .It BatchMode .It BindAddress .It BindInterface .It CanonicalDomains .It CanonicalizeFallbackLocal .It CanonicalizeHostname .It CanonicalizeMaxDots .It CanonicalizePermittedCNAMEs .It CASignatureAlgorithms .It CertificateFile .It CheckHostIP .It Ciphers .It Compression .It ConnectionAttempts .It ConnectTimeout .It ControlMaster .It ControlPath .It ControlPersist .It GlobalKnownHostsFile .It GSSAPIAuthentication .It GSSAPIDelegateCredentials .It HashKnownHosts .It Host .It HostbasedAcceptedAlgorithms .It HostbasedAuthentication .It HostKeyAlgorithms .It HostKeyAlias .It Hostname .It IdentitiesOnly .It IdentityAgent .It IdentityFile .It IPQoS .It KbdInteractiveAuthentication .It KbdInteractiveDevices .It KexAlgorithms .It KnownHostsCommand .It LogLevel .It MACs .It NoHostAuthenticationForLocalhost .It NumberOfPasswordPrompts .It PasswordAuthentication .It PKCS11Provider .It Port .It PreferredAuthentications .It ProxyCommand .It ProxyJump .It PubkeyAcceptedAlgorithms .It PubkeyAuthentication .It RekeyLimit .It RequiredRSASize .It SendEnv .It ServerAliveInterval .It ServerAliveCountMax .It SetEnv .It StrictHostKeyChecking .It TCPKeepAlive .It UpdateHostKeys .It User .It UserKnownHostsFile .It VerifyHostKeyDNS .El .It Fl P Ar port Cette option permet de spécifier le port auquel se connecter sur l'hôte distant. .It Fl p Préserver les dates de modifications, d'accès et les modes des fichiers transférés. .It Fl q Mode silencieux : la barre de progression ainsi que les messages d’avertissement et de diagnostic en provenance de .Xr ssh 1 sont désactivés. .It Fl R Ar 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. .It Fl r Copier récursivement les répertoires complets lors d’un téléversement ou d’un téléchargement. Notez que .Nm sftp ne suit pas les liens symboliques rencontrés lors du parcours de l'arborescence. .It Fl S Ar programme Cette option permet de spécifier le nom du .Ar programme à utiliser pour la connexion chiffrée. Ce programme doit prendre en charge les options de .Xr ssh 1 . .It Fl s Ar 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 .Xr sshd 8 distant n'a pas de sous-système sftp configuré. .It Fl v Augmenter le niveau de journalisation. Cette option est aussi passée à .Xr ssh 1 . .It Fl X Ar option_sftp Cette option permet de spécifier une option qui contrôle certains aspects du comportement du protocole SFTP. Les options disponibles sont : .Bl -tag -width Ds .It Cm nrequests Ns = Ns Ar 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. .It Cm buffer Ns = Ns Ar 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. .El .El .Sh COMMANDES INTERACTIVES En mode interactif, .Nm sftp prend en charge un jeu de commandes similaires à celles de .Xr 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 .Xr glob 3 doit être protégé par une barre oblique inverse (« \ »). .Bl -tag -width Ds .It Ic bye Quitter .Nm sftp . .It Ic cd Op Ar chemin Changer le répertoire distant pour .Ar chemin . Si .Ar chemin n’est pas spécifié, changer le répertoire pour celui sous lequel la session a démarré. .It Xo Ic chgrp .Op Fl h .Ar grp .Ar chemin .Xc Changer le groupe du fichier .Ar chemin à .Ar grp . .Ar chemin peut contenir des caractères .Xr glob 7 et peut correspondre à plusieurs fichiers. .Ar grp doit être un GID numérique. .Pp Si l’option .Fl 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 ». .It Xo Ic chmod .Op Fl h .Ar mode .Ar chemin .Xc Changer les permissions du fichier .Ar path à .Ar mode . .Ar chemin peut contenir des caractères .Xr glob 7 et peut correspondre à plusieurs fichiers. .Pp Si l’option .Fl 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 ». .It Xo Ic chown .Op Fl h .Ar propriétaire .Ar chemin .Xc Changer le propriétaire du fichier .Ar chemin à .Ar propriétaire . .Ar chemin peut contenir des caractères .Xr glob 7 et peut correspondre à plusieurs fichiers. .Ar propriétaire doit être un UID numérique. .Pp Si l’option .Fl 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 ». .It Ic copy Ar ancien_chemin Ar nouveau_chemin Copier le fichier distant de .Ar ancien_chemin vers .Ar nouveau_chemin . .Pp Notez que cette fonctionnalité n’est prise en charge que par les serveurs qui implémentent l’extension « copy-data ». .It Ic cp Ar ancien_chemin Ar nouveau_chemin Alias de la commande .Ic copy . .It Xo Ic df .Op Fl hi .Op Ar chemin .Xc Afficher les informations d’utilisation du système de fichiers contenant le répertoire actuel (ou .Ar chemin si spécifié). Si l’option .Fl h est spécifiée, les informations d’utilisation seront affichées avec des suffixes « lisibles par les humains ». Le drapeau .Fl 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 ». .It Ic exit Quitter .Nm sftp . .It Xo Ic get .Op Fl afpR .Ar chemin_distant .Op Ar chemin_local .Xc Récupérer l'emplacement .Ar 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. .Ar chemin_distant peut contenir des caractères .Xr glob 7 et peut correspondre à plusieurs fichiers. Si c'est le cas et si un .Ar chemin_local est spécifié, .Ar chemin_local doit correspondre à un répertoire. .Pp Si l’option .Fl 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. .Pp Si l’option .Fl f est spécifiée, .Xr fsync 2 sera appelé après le transfert complet du fichier pour enregistrer ce dernier sur disque. .Pp .\" undocumented redundant alias .\" or .\" .Fl P Si l’option .Fl p est spécifiée, les permissions complètes du fichier et les heures d'accès seront aussi conservées. .Pp .\" undocumented redundant alias .\" or .\" .Fl r Si l’option .Fl R est spécifiée, les répertoires seront copiés récursivement. Notez que .Nm sftp ne suit pas les liens symboliques lors de transferts récursifs. .It Ic help Afficher le texte de l'aide. .It Ic lcd Op Ar chemin Changer le répertoire local en .Ar chemin . Si .Ar chemin n’est pas spécifié, changer le répertoire pour le répertoire personnel de l’utilisateur local. .It Ic lls Op Ar options_ls Op Ar chemin Afficher la liste des fichiers du répertoire local .Ar chemin ou du répertoire local actuel si .Ar chemin n'est pas spécifié. .Ar options_ls peut contenir n'importe quelle option prise en charge par la commande .Xr ls 1 du système local. .Ar chemin peut contenir des caractères .Xr glob 7 et peut correspondre à plusieurs fichiers. .It Ic lmkdir Ar chemin Créer le répertoire local spécifié par .Ar chemin . .It Xo Ic ln .Op Fl s .Ar ancien_chemin .Ar nouveau_chemin .Xc Créer un lien de .Ar ancien_chemin à .Ar nouveau_chemin . Si l’option .Fl s est spécifiée, le lien créé sera un lien symbolique, sinon ce sera un lien physique. .It Ic lpwd Afficher le répertoire de travail local. .It Xo Ic ls .Op Fl 1afhlnrSt .Op Ar chemin .Xc Afficher la liste des fichiers du répertoire distant .Ar chemin ou du répertoire actuel si .Ar chemin n'est pas spécifié. .Ar chemin peut contenir des caractères .Xr glob 7 et peut correspondre à plusieurs fichiers. .Pp Les options suivantes sont reconnues et modifient le comportement de .Ic ls en conséquence : .Bl -tag -width Ds .It Fl 1 Produire une sortie sur une seule colonne. .It Fl a Lister les fichiers dont le nom commence par un point « . ». .It Fl f Ne pas trier la liste. L’ordre de tri par défaut est lexicographique. .It Fl 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.). .It Fl l Afficher des informations supplémentaires dont les permissions et le propriétaire. .It Fl n Produire une longue liste avec les informations sur le propriétaire et le groupe présentées de manière numérique. .It Fl r Inverser l'ordre de tri de la liste. .It Fl S Trier la liste par taille de fichier. .It Fl t Trier la liste par date de dernière modification. .El .It Ic lumask Ar umask Définir l'umask (mode de création de fichier) local à .Ar umask . .It Ic mkdir Ar chemin Créer le répertoire distant spécifié par .Ar chemin . .It Ic progress Activer l'affichage de la barre de progression. .It Xo Ic put .Op Fl afpR .Ar chemin_local .Op Ar chemin_distant .Xc Téléverser l'emplacement .Ar 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. .Ar chemin_local peut contenir des caractères .Xr glob 7 et peut correspondre à plusieurs fichiers. Si c'est le cas et si un .Ar chemin_distant est spécifié, ce dernier doit correspondre à un répertoire. .Pp Si l’option .Fl 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. .Pp Si l’option .Fl f est spécifiée, il sera demandé au serveur d’appeler .Xr 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 ». .Pp .\" undocumented redundant alias .\" or .\" .Fl P Si l’option .Fl p est spécifiée, les permissions complètes du fichier et les heures d'accès seront aussi conservées. .Pp .\" undocumented redundant alias .\" or .\" .Fl r Si l’option .Fl R est spécifiée, les répertoires seront copiés récursivement. Notez que .Nm sftp ne suit pas les liens symboliques lors de transferts récursifs. .It Ic pwd Affiche le répertoire de travail distant. .It Ic quit Quitter .Nm sftp . .It Xo Ic reget .Op Fl fpR .Ar chemin_distant .Op Ar chemin_local .Xc Reprendre le téléchargement de .Ar chemin_distant . Équivalent à .Ic get avec le drapeau .Fl a défini. .It Xo Ic reput .Op Fl fpR .Ar chemin_local .Op Ar chemin_distant .Xc Reprendre le téléversement de .Ar chemin_local . Équivalent à .Ic put avec le drapeau .Fl a défini. .It Ic rename Ar ancien_chemin nouveau_chemin Renommer le fichier distant .Ar ancien_chemin en .Ar nouveau_chemin . .It Ic rm Ar chemin Supprimer le fichier distant spécifié par l'emplacement .Ar chemin . .It Ic rmdir Ar chemin Supprimer le répertoire distant spécifié par l'emplacement .Ar chemin . .It Ic symlink Ar ancien_chemin nouveau_chemin Créer un lien symbolique de .Ar ancien_chemin vers .Ar nouveau_chemin . .It Ic version Afficher la version du protocole de .Nm . .It Ic \&! Ns Ar commande Exécuter la .Ar commande dans l’interpréteur de commande local. .It Ic \&! Basculer dans l’interpréteur de commande local. .It Ic \&? Synonyme pour aide. .El .Sh VOIR AUSSI .Xr ftp 1 , .Xr ls 1 , .Xr scp 1 , .Xr ssh 1 , .Xr ssh-add 1 , .Xr ssh-keygen 1 , .Xr ssh_config 5 , .Xr glob 7 , .Xr sftp-server 8 , .Xr sshd 8 .Rs .%A T. Ylonen .%A S. Lehtinen .%T « SSH File Transfer Protocol » .%N draft-ietf-secsh-filexfer-00.txt .%D janvier 2001 .%O travail en cours .Re .Pp .Sh TRADUCTION La traduction française de cette page de manuel a été créée par Lucien Gentis . .Pp Cette traduction est une documentation libre ; veuillez vous reporter à la .Lk https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .Pp Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .Mt debian-l10n-french@lists.debian.org .Me .