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]"]

 

userLe nom d'utilisateur pour se connecter au site FTP
passwordLe mot de passe pour se connecter au site FTP.
serverLe nom du serveur FTP.
pathLe répertoire par défaut sur le serveur pour cette session.
portLe numéro de port.

 

/C(lose)

/Q(uiet)

/EP (extended passive)

/R(econnect)

/IPv6

/S(end)

/K (clé publique SSH)

/SSL

/N(o paths)

/T(cp keep-alive)

/O(verwrite)

/V(erbose)

/P(assive)

/V=nom d'hôte

/PR="n" (plage de ports)

/Zn (zlib)

 

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 :

 

/=Affiche la boîte de dialogue de commande IFTP pour vous aider à définir les options de la ligne de commande. L'option /= peut être placée n'importe où sur la ligne ; les options supplémentaires définiront les champs appropriés dans la boîte de dialogue de commande.

 

/CUtilisez ce commutateur, sans URL, pour fermer une session IFTP (voir l'exemple ci-dessus).

 

/EPUtilisez le mode passif étendu. (Fonctionne avec FTP et FTPS, mais pas avec SFTP).

 

/IPv6[=0|1|2]Par défaut, IFTP attend une adresse IPv4 pour l'hôte local et distant, et créera une socket IPv4. L'option /IPv6 indique à IFTP d'utiliser IPv6 à la place. (Fonctionne avec les connexions FTP, FTPS et SFTP.) Si elle vaut 0, IFTP utilisera exclusivement IPv4. Si elle vaut 1, IFTP utilisera exclusivement IPv6. Pour demander à IFTP de préférer les adresses IPv6, mais d'utiliser IPv4 si IPv6 n'est pas supporté par le système, ce paramètre doit être fixé à 2. Si vous ne spécifiez pas /IPV6, IFTP fixera cette valeur à 0. Si vous spécifiez /IPV6 sans valeur explicite, IFTP fixera la valeur à 1.

 

/K="..."La clé publique du client signée par un CA utilisée lors de l'authentification (SSH uniquement). Lors de l'authentification par clé publique, ce paramètre peut être défini sur la clé publique du client signée par l'autorité de certification. Ceci est utile lorsque le serveur a été configuré pour faire confiance aux clés du client signées par une autorité de certification particulière. Par exemple :

 

/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...

 

/NTransmettre les noms de la source et de la cible au serveur "tels quels", sans tenter d'étendre les chemins. Cette option doit être utilisée avec précaution et uniquement pour les serveurs "non standards" pour lesquels le traitement par défaut ne permet pas de construire un nom adéquat.

 

/OSpé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.

 

/P /P0 désactive le mode passif ; /P1 l'active.

 

/PR="n"En mode actif, IFTP utilise n'importe quel port disponible pour écouter les connexions entrantes du serveur. Vous pouvez modifier ce comportement en définissant /PR (PortRange) sur une valeur contenant la plage de ports sur lesquels la classe écoutera.  Laplage est fournie sous forme de début et de fin, par exemple : "1024-" correspond à tout ce qui est supérieur à 1024, "1024-2048" correspond aux ports compris entre 1024 et 2048 inclus, "4000-4010, 50000-50010" correspond aux ports compris entre 4000 et 4010 ou entre 50000 et 50010. (Fonctionne avec FTP et FTPS, mais pas avec SFTP).

 

/QDésactive l'affichage de la conversation avec le serveur FTP.

 

/RSe reconnecter automatiquement en cas de dépassement de délai du serveur FTP.

 

/SPermet d'envoyer des commandes directement à un serveur FTP. La connexion doit déjà avoir été ouverte par une commande IFTP précédente.

 

/SSL=nIndique 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é.

 

/T=n Si ce paramètre est défini, l'option keep-alive de la socket est activée et des paquets TCP keep-alive seront envoyés périodiquement pour maintenir la connexion. n est le temps d'inactivité en secondes avant l'envoi d'un paquet TCP keep-alive.

 

/VAffiche 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.

 

/V=nomd'hôte Envoiela commande HOST au serveur.La commande HOST permet aux processus FTP de spécifier l'hôte virtuel auquel se connecter pour un processus serveur-FTP qui traite des demandes pour plusieurs hôtes virtuels sur une même adresse IP. Lorsque cette option est activée, la commande HOST est envoyée au serveur avant l'authentification.

 

/ZnUtiliser la compression Zlib. Vous pouvez optionnellement définir le niveau de compression (0-9 ; la valeur par défaut est 7). La compression Zlib doit être activée sur le serveur et ne fonctionne qu'avec les connexions FTP et FTPS (pas SFTP).