| IFTP |
| Objet: | Ouvrir ou fermer une session FTP / FTPS / SFTP |
| Format: | IFTP [/= /S command /C /EP /IPv6 /K="key" /N /O=n /Pn /PR="n" /Q /R /SSL=n /V /V=hostname] /Z[n]] ["ftp://[user[:password]@]server[/path][:port]"] |
| user | Le nom d'utilisateur pour se connecter au site FTP |
| password | Le mot de passe pour se connecter au site FTP. |
| server | Le nom du serveur FTP. |
| path | Le répertoire par défaut sur le serveur pour cette session. |
| port | Le numéro de port. |
Utilisation :
La plupart des commandes et fonctions de traitement de fichiers dans TCC peuvent accéder aux fichiers des serveurs FTP de la même manière qu'aux fichiers des disques durs locaux et d'un réseau local. Normalement, chaque fois que vous utilisez la fonction FTP de l'une de ces commandes ou fonctions, celle-ci démarre une session FTP, effectue une opération individuelle et ferme la session FTP, jusqu'à ce que la commande ou la fonction soit terminée.
IFTP démarre une session FTP qui reste ouverte jusqu'à ce que vous la fermiez ou qu'elle soit fermée par le serveur distant. L'utilisation d'IFTP présente plusieurs avantages : la connexion FTP reste ouverte et les commandes s'exécutent donc plus rapidement, la syntaxe d'accès aux fichiers sur le serveur est plus courte et vous pouvez spécifier un répertoire par défaut sur le serveur pour les opérations sur les fichiers.
Par exemple, pour ouvrir une connexion FTP à l'aide d'IFTP :
iftp ftp://user:[email protected]/dir1
Pour une connexion FTPS, utilisez quelque chose comme :
iftp ftps://user:[email protected]/dir1
Cette commande indique à IFTP d'ouvrir une session FTP/FTPS avec le serveur myserver.com, d' envoyer user comme nom d'utilisateur et password comme mot de passe, et d'établir le répertoire/dir1 comme répertoire par défaut pour cette session. Le nom d'utilisateur et le mot de passe sont facultatifs ; s'ils ne sont pas utilisés, IFTP tentera de se connecter de manière anonyme. Les guillemets doubles sont nécessaires si le nom de fichier contient des espaces ou des caractères spéciaux. Si vous spécifiez un mot de passe de *, vous serez invité à saisir le mot de passe (qui apparaîtra à l'écran sous forme d'astérisques).
Notez que dans l'exemple ci-dessus, dir1 est un sous-répertoire du répertoire FTP "root", c'est-à-dire le répertoire personnel de l'utilisateur FTP désigné. Dans la plupart des configurations de serveur, ce répertoire n'est pas le même que le répertoire racine physique du serveur FTP.
Remarque : Si vous entrez dans IFTP sans aucun paramètre alors qu'une connexion est active, le nom et le répertoire du serveur en cours s'affichent.
Si vous entrez dans IFTP en utilisant uniquement le commutateur /Q ou /V, vous modifiez la quantité d'informations affichées sans perturber la connexion existante (le cas échéant).
Une fois que vous avez établi une session FTP avec IFTP, vous pouvez faire référence aux fichiers du serveur en utilisant ftp: (ou ftps:) mais en omettant le nom d'utilisateur, le mot de passe et l'URL du serveur. Sur la plupart des serveurs, les noms de fichiers et de chemins qui commencent par ftp: sont relatifs au répertoire par défaut, le cas échéant, que vous avez spécifié lorsque vous avez ouvert la session IFTP ; les noms de fichiers et de chemins qui commencent par ftp:/ sont relatifs au répertoire racine du nom de connexion.
Ladifférence est visible dans ces quatre commandes DIR, en supposant que la session IFTP démarre ci-dessus :
1. dir "ftp:*.txt"
2. dir "ftp:dir2/*.txt"
3. dir "ftp:/*.txt"
4. dir "ftp:/dir2/*.txt"
La première commande répertorie les fichiers .TXT dans le répertoire par défaut de la session, dir1. La deuxième commande répert orie les fichiers .TXT dans /dir1/dir2 car elle interprète le chemin dir2/*.txt comme étant relatif au répertoire par défaut. Les guillemets peuvent être omis dans l'exemple 1 car il ne contient pas de barre oblique qui pourrait être prise pour un commutateur d'options. Lestroisième et quatrième commandes ci-dessus, parce qu'elles incluent un / immédiatement après le désignateur ftp :, sont relatives au répertoire racine . La commande 3 énumère les fichiers .TXT du répertoire racine et la commande 4 énumère les fichiers du sous-répertoiredir2 du répertoire racine.
Remarque : si un fichier ftp ou un chemin d'accès commence par un~ (tilde) , TCC n'essaiera pas de construire un nom de répertoire complet, mais transmettra la chaîne entière au serveur distant.
Vous ne pouvez avoir qu 'une seule connexion IFTP ouverte à la fois dans une fenêtre d'onglet TCC dans une fenêtre d'onglet. Cependant, lorsqu'une connexion IFTP est ouverte, vous pouvez toujours utiliser une URL FTP complète pour effectuer une opération sur un autre serveur. Par exemple, lorsque la session ci-dessus est ouverte, vous pouvez utiliser cette commande pour afficher tous les fichiers du répertoire racine de microsoft.com:
dir "ftp://ftp.microsoft.com/*"
Une session IFTP reste ouverte jusqu'à ce que vous la fermiez explicitement à l'aide de cette commande :
iftp /c
La plupart des serveurs FTP expirent après une période d'inactivité. TCC La commande iftp /c tentera de détecter si la connexion a été fermée par le serveur et se reconnectera si vous faites à nouveau référence à la session IFTP. Vous ne devez pas supposer qu'une connexion IFTP continuera à fonctionner si vous la laissez ouverte mais inutilisée pendant une longue période. Vous pouvez déterminer si la connexion est toujours active à l'aide des variables_iftp, _iftps et _isftp.
IFTP et les autres fonctionnalités FTP de TCC dépendent de la conformité du serveur aux normes FTP Internet. Si votre serveur n'est pas totalement conforme ou ne fonctionne pas de la manière attendue, les commandes risquent de ne pas fonctionner. TCC Si votre serveur n'est pas totalement conforme ou ne fonctionne pas de la manière attendue par l'ICANN, les commandes peuvent ne pas fonctionner comme vous le souhaitez. Nous vous conseillons vivement de tester chaque serveur que vous utilisez avec des commandes non destructives comme DIR avant d'essayer de copier ou de supprimer des fichiers, de créer ou de supprimer des répertoires, etc.
IFTP s'efforce de préserver l'horodatage lors du transfert de fichiers. La commande MDTM est utilisée pour le téléchargement et la commande MFTM pour le chargement. Si le serveur FTP ne prend pas en charge ces commandes, la date et l'heure actuelles seront utilisées pour l'horodatage.
Avant d'utiliser IFTP, vous devez établir la connexion nécessaire à Internet.
Si vous n'entrez aucun argument, IFTP affichera sa boîte de dialogue de commande.
Voir Serveurs FTP pour plus d'informations sur le formatage et l'utilisation des références FTP et FTPS.
Options :
/K="[email protected] AAAAB3NzaC1yc2EAAAADAQABAAAB..."
L'algorithme tel que [email protected] dans la chaîne ci-dessus est utilisé dans le cadre du processus d'authentification. Pour utiliser un autre algorithme, il suffit de modifier cette valeur. Par exemple, tous les algorithmes suivants sont acceptables avec la même clé publique signée :
•[email protected] AAAAB3NzaC1yc2EAAAADAQABAAAB...
•[email protected] AAAAB3NzaC1yc2EAAAADAQABAAAB...
•[email protected] AAAAB3NzaC1yc2EAAAADAQABAAAB...
| /O | Spécifie si IFTP doit ou non écraser les fichiers téléchargés. Si /O=1, une erreur sera levée si le fichier local existe avant une opération de téléchargement. |
| /S | Permet d'envoyer des commandes directement à un serveur FTP. La connexion doit déjà avoir été ouverte par une commande IFTP précédente. |
| /SSL=n | Indique si TLS/SSL est activé dans IFTP. Avec 0 (valeur par défaut), la classe fonctionne en mode texte. Avec 1, TLS/SSL est activé. |
| /V | Affiche la boîte de dialogue avec le serveur FTP lors de l'ouverture de la connexion. Cela peut être utile pour déboguer les problèmes de connexion. |