Le transfert de fichiers : FTP et SFTP
Partie 2 sur 3
3Les commandes du protocole
Toutes les communications du canal de contrôle suivent les conventions de Telnet : les commandes FTP sont des chaînes de caractères en code ASCII (le code d’origine du texte anglais, voir les caractères), terminées par CR LF. Si la commande a un paramètre, il est séparé de la commande par une espace. Les commandes précisent le port utilisé, le mode de transfert, la structure des données et la nature de l’action (Retrieve pour récupérer, List pour lister, Store pour déposer...). On les range en trois familles, présentées dans les tableaux suivants.
| Commande | Rôle |
|---|---|
USER | Identifie l’utilisateur ; elle est nécessaire pour ouvrir un canal de données. |
PASS | Donne le mot de passe ; elle doit suivre immédiatement USER. C’est au client de masquer cette ligne à l’écran. |
ACCT | Précise un compte (account), rarement utile : si la réponse au mot de passe est 230, elle est inutile ; si c’est 332, elle est requise. |
CWD | Change Working Directory : change le répertoire courant ; le chemin est l’argument. |
CDUP | Change to Parent Directory : remonte au répertoire parent ; elle règle les différences de nom du « dossier parent » selon les systèmes (souvent ..). |
SMNT | Structure Mount : monte une autre structure de fichiers. |
REIN | Reinitialize : remet la session à zéro. |
QUIT | Termine la session ; le serveur attend la fin du transfert en cours, répond, puis ferme. |
| Commande | Rôle |
|---|---|
PORT | Précise le port à utiliser pour les données (mode actif). |
PASV | Demande au serveur d’attendre une connexion sur un port choisi parmi les ports libres ; la réponse donne l’adresse IP et le port (mode passif). |
TYPE | Précise le format des données (texte ou binaire). |
STRU | Structure du fichier : F pour fichier, R pour enregistrements, P pour pages. |
MODE | Mode de transmission : S flux (stream), B blocs, C compressé. |
| Commande | Rôle |
|---|---|
RETR | Retrieve : demande une copie du fichier désigné. |
STOR | Store : dépose le fichier envoyé ; il est créé s’il n’existe pas, écrasé sinon. |
STOU | Comme STOR, mais le serveur choisit un nom unique, qu’il renvoie dans sa réponse. |
APPE | Append : ajoute les données à la fin du fichier, ou le crée. |
ALLO | Allocate : demande au serveur de réserver la place nécessaire. |
REST | Restart : reprend un transfert interrompu à partir d’un repère de position ; elle précède immédiatement la commande de transfert. |
RNFR, RNTO | Rename from, rename to : renomment un fichier en deux temps, toujours dans cet ordre. |
ABOR | Abort : abandonne les transferts en cours ; le canal de contrôle reste ouvert. |
DELE | Delete : supprime un fichier, sans retour possible (seul le client peut demander confirmation). |
RMD, MKD | Supprime et crée un répertoire. |
PWD | Print working directory : donne le chemin complet du répertoire courant. |
LIST, NLST | Liste les fichiers et répertoires (NLST : les noms seuls), par le canal de données. |
SITE | Accède à des services propres à un serveur, non définis par le protocole. |
SYST, STAT | Informations sur le système du serveur ; état du serveur ou avancement d’un transfert. |
HELP | Donne la liste des commandes comprises par le serveur. |
NOOP | Ne fait rien, sauf recevoir « OK » : sert à ne pas être déconnecté pour inactivité. |
4Les réponses : des codes à trois chiffres
À chaque commande, le serveur répond. Les réponses assurent la synchronisation entre client et serveur. Chaque réponse commence par un code de trois chiffres, suivi d’un texte lisible. Les chiffres se lisent ainsi : le premier indique le résultat, le deuxième le thème, le troisième précise.
| Code | Signification |
|---|---|
1yz | Réponse préliminaire positive : l’action est en cours, une seconde réponse doit suivre avant la commande suivante. |
2yz | Réussite : l’action est faite, on peut envoyer une nouvelle commande. |
3yz | Réponse intermédiaire : action suspendue, le serveur attend d’autres informations du client. |
4yz | Échec temporaire : réessayez plus tard. |
5yz | Échec définitif : la commande n’a pas été acceptée, formulez une autre demande. |
Le deuxième chiffre précise le sujet : x0z une question de syntaxe (erreur ou commande inconnue), x1z une information (par exemple la réponse à STAT), x2z les connexions (canal de données), x3z l’authentification et les comptes (identifiant, mot de passe), x5z le système de fichiers distant. Le chiffre x4z n’est pas utilisé. Voici quelques codes courants :
220: service prêt pour un nouvel utilisateur (message de bienvenue) ;331: identifiant accepté, mot de passe demandé ;230: utilisateur connecté ;226: transfert terminé, canal de données fermé ;530: non connecté (identifiants refusés) ;550: fichier introuvable ou action non autorisée.
Pour s’exercer
Exercice 1 : lire une session
Un client reçoit successivement : « 220 prêt », puis « 331 mot de passe requis », puis « 530 non connecté ». Que s’est-il passé ? Et si la dernière réponse était « 230 » ?
Voir la réponse
Le serveur est prêt (220), a accepté l’identifiant et attend le mot de passe (331), puis a refusé la connexion (530 : échec définitif, de la famille 5yz) : le mot de passe est faux ou le compte n’existe pas. Avec « 230 », l’utilisateur serait connecté.
5Une session en ligne de commande
Sur la plupart des systèmes (Unix, Linux, Windows), la commande ftp était fournie en standard. Pour ouvrir une session, on tape ftp nom_du_serveur, où nom_du_serveur est le nom ou l’adresse IP de la machine distante, qui doit exécuter un service FTP. Sur les systèmes récents, ce client n’est plus toujours installé par défaut. Exemple (adresse réservée aux exemples) :
$ ftp 192.0.2.10 Connected to 192.0.2.10. 220 Bienvenue sur le serveur d'exemple Name: anonymous 331 Please specify the password. Password: (votre adresse de courriel, par politesse) 230 Login successful. ftp> ls ftp> binary ftp> get rapport.pdf 226 Transfer complete. ftp> bye
La première ligne annonce la connexion, les suivantes forment le message de bienvenue, qui indique parfois le type de site, l’organisme ou des recommandations. Chaque ligne commence par le code de réponse : 220 signifie « service prêt ». Le serveur demande le nom d’utilisateur (login) pour définir les droits (lecture, écriture) ; après validation, la ligne 331 invite à saisir le mot de passe, qui n’apparaît pas à l’écran. Un serveur public autorise l’accès anonyme : l’identifiant est anonymous et, par coutume, le mot de passe est l’adresse de courrier de l’utilisateur, mais n’importe quel texte convient. Un message d’erreur donne la raison d’un refus : par exemple No more user access allowed si le site a atteint sa limite d’utilisateurs.
Voici les commandes d’un client en ligne de commande. Elles diffèrent des commandes du protocole : le client les traduit.
| Commande | Effet |
|---|---|
help | Affiche les commandes disponibles. |
status | Affiche des paramètres du client. |
binary, ascii, type | Passent en mode binaire ou en mode texte ; type affiche le mode courant. Le mode texte est souvent présenté comme le mode par défaut. |
user | Rouvre une session avec un autre nom ; un nouveau mot de passe est demandé. |
ls, pwd, cd | Liste le répertoire (ls -l : détails), affiche le répertoire courant, change de répertoire (cd .. pour remonter). |
mkdir, rmdir | Créent et suppriment un répertoire (sous Windows md et rd), si l’on en a le droit. |
get | Récupère un fichier distant dans le répertoire local ; avec un second nom, il est enregistré sous ce nom. Un nom avec espaces se met entre guillemets. |
put | Envoie un fichier local vers le répertoire distant, avec les mêmes variantes. |
open, close | Ouvrent une session vers un autre serveur ; ferment la session en cours en gardant le client. |
bye, quit | Déconnectent et quittent le client. |
Une limite des clients en ligne de commande est qu’ils échangent un fichier à la fois, dans les deux sens, et qu’un répertoire ne peut être supprimé que s’il est vide. Les clients graphiques et des commandes comme mget et mput (transferts multiples) contournent cette contrainte.
5.1Texte ou binaire : un piège classique
Le mode texte (ascii) convertit les fins de ligne entre systèmes (Windows termine les lignes autrement qu’Unix). Appliqué à une image, une archive ou un programme, cette conversion abîme le fichier, qui devient inutilisable. Il faut donc passer en mode binary pour tout fichier qui n’est pas du texte pur. La plupart des clients graphiques choisissent automatiquement, mais l’erreur est fréquente avec les clients en ligne de commande. On indique souvent que le mode texte est celui par défaut : c’est resté vrai de beaucoup de clients, d’où l’habitude de taper binary avant de commencer.
Pour s’exercer
Exercice 2 : l’image abîmée
Vous envoyez une photo en FTP : elle arrive illisible. Quelle est la cause probable et comment l’éviter ?
Voir la réponse
Le transfert a été fait en mode texte (ascii), qui convertit les fins de ligne et altère les octets d’une image. Il faut passer en mode binary avant l’envoi (commande binary), ou utiliser un client qui choisit automatiquement. Comparer la taille du fichier avant et après aide à repérer le problème.