image

Téléchargement : http://code.google.com/p/tclkit/downloads/list (http://tclkit.googlecode.com/files/sdx-20110317.kit au 02/08/2012)

L'utilitaire sdx sert à manipuler un starkit avec les 23 commandes que je vais décrire et expliquer ci-dessous. Elles sont listées par ordre d'importance et de fréquence d'utilisation.

Commandes relatives aux starkits :

help :

Syntaxe :

 sdx help ?commande?

Description : retourne l'aide (en anglais) sur la commande passée en argument. ?commande? doit être l'une des 23 commandes décrites ici. Sans argument sdx help retourne la même chose que sdx help help.

wrap :

Syntaxe :

 sdx wrap nom ?options?

Description : génère un starkit nom à partir du répertoire nom.vfs. Si nom existe déjà il sera mis à jour. Options :

-interp nom
pour utiliser nom comme interprêteur à la place de tclkit.
-nocomp
pour ne pas compresser les fichiers ajoutés au starkit.
-runtime nom
pour créer un starpack qui embarquera nom comme interprêteur.
-verbose
pour avoir plus d'informations lors de la création du starkit.
-writable
pour fabriquer un starkit dont le VFS sera modifiable (il est en lecture seule par défaut).

qwrap :

Syntaxe :

 sdx qwrap fichier ?nom?

Description : génère un starkit à partir de fichier. Si nom est précisé, le résultat sera nom.kit, sinon fichier.kit. La source fichier peut être un fichier local ou une URL (FTP ou HTTP).

unwrap :

Syntaxe :

 sdx unwrap nom

Description : extrait le contenu du starkit ou du starpack nom dans le répertoire nom.vfs (ce répertoire ne doit pas exister avant d'utiliser cette commande).

lsk :

Syntaxe :

 sdx lsk nom

Description : affiche le contenu du starkit ou du starpack nom.

update :

Syntaxe :

 sdx update ?-from url? ?-n? starkit

Description : met à jour starkit avec la version du serveur. Cette commande peut ajouter, modifier et enlever des fichiers dans starkit.

Options :

-from url
pour utiliser url comme serveur à la place du serveur par défaut (fixé "en dur" dans sdx.vfs/lib/app-sdx/update.tcl).
-n
pour afficher les différences sans mettre à jour.

tgz2kit :

Syntaxe :

 sdx tgz2kit ?-notop? source

Description : fabrique source.kit à partir de l'archive source.tgz (ou source.tar.gz). Si ?-notop? est précisé, le répertoire racine de l'archive est enlevé.

version :

Syntaxe :

 sdx version ?-fixtime? starkit

Description : calcule et affiche le numéro de version de starkit en fonction de son contenu. Si ?-fixtime? est précisé, sdx change la date de modification du starkit pour qu'elle corresponde au fichier le plus récent qu'il contient. Utilitaires généraux :

ls :

Syntaxe :

 sdx ls ?-l? ?fichiers/répertoire?

Description : une version en pur tcl de la commande ls d'unix

md5sum :

Syntaxe :

 sdx md5sum fichier ?...?

Description : calcule et affiche la somme MD5 des fichiers passés en argument.

addtoc :

Syntaxe :

sdx addtoc répertoire

Description : ajoute à la racine du répertoire une table des matières TOC contenant la liste des fichiers, leur date de modification et leur md5sum.

treetime :

Syntaxe :

 sdx treetime répertoire

Description : ajuste la date de modification de tous les fichiers du répertoire à la date du fichier le plus récent qu'il contient.

ratarx :

Syntaxe :

 sdx ratarx ?-n? fichiertargz

Description : efface dans le répertoire courant tous les fichiers ayant la même taille et date de modification que ceux contenus dans fichiertargz. Si ?-n? est précisé, la liste des fichiers concernés est affichée mais rien n'est effacé.

eval :

Syntaxe :

 sdx eval commande ?argument ...?

Description : évalue la commande Tcl et le(s) argument(s) passés et retourne le résultat.

fetch :

Syntaxe :

 sdx fetch url ?destination?

Description : récupère le fichier à l'url FTP ou HTTP spécifiée. Si la destination n'est pas spécifiée, le fichier récupéré est sauvegardé avec le même nom dans le répertoire courant.

Serveurs :

ftpd :

Syntaxe :

 ftpd ?options?

Description : lance un serveur FTP et créé le fichier ftpd.log avec une trace de toutes les actions du serveur.

Options :

-port num
pour définir le numéro de port à utiliser (8021 par défaut).
-root rép
pour définir le répertoire de base du serveur (/ftproot par défaut).
-debug n
pour fixer le niveau d'information de déverminage (1 par défaut).
-timeout sec
pour fixer le temps de latence du serveur (600 secondes par défaut).
-email adr
pour définir l'adresse de courriel de l'administrateur du serveur.

httpd :

Syntaxe :

httpd ?options?

Description : lance un serveur HTTP.

Options :

-port num
pour définir le numéro de port à utiliser (8080 par défaut).
-root rép
pour définir le répertoire de base du serveur (/wwwroot par défaut).
-default nom
nom à utiliser pour un répertoire (index.html par défaut).
-sockblock 0|1
utiliser des sockets bloquants (non par défaut).
-launch 0|1
lancer un navigateur sur la page d'accueil (non par défaut).
-bufsize n
taille du tampon de transfert (32768 par défaut).
-config fichier
lire la configuration depuis ce fichier (aucun par défaut).
-ipaddr adr
adresse IP du serveur (poste local par défaut).

rexecd :

Syntaxe :

 sdx rexecd ?options?

Description : lance un serveur de commandes Tcl déportées compatible rexec.

Options :

-port num
pour définir le numéro de port à utiliser (512 par défaut).
-ipaddr adr
adresse IP du serveur (poste local par défaut).

starsync :

Syntaxe :

 sdx starsync ?fichierlog?

Description : lance un serveur CGI starsync qui lit les requêtes starsync passées en entrée et retourne la réponse HTML adéquate. C'est suffisant pour créer un serveur starsync capable de partager tous les starkits *.kit trouvés dans le répertoire courant. Ce type de serveur n'altère aucune donnée excepté ajouter une ligne au fichier de trace optionnel ?fichierlog? pour chaque requête traitée. Une page sur la mise en place d'un tel serveur sera ajoutée dès que possible. Consultez, s'il vous plait, http://www.equi4.com/papers/skpaper7_3.html en attendant.

À écrire, ou à compléter :

mkinfo :

Syntaxe :

 sdx mkinfo fichier ?...?

Description : affiche l'offset de départ d'un Metakit et sa structure.

mkshow :

Syntaxe :

 sdx mkshow fichier vue ?propriété ...?

Description : Utilitaire d'affichage des données brutes d'un Metakit.

httpdist :

Syntaxe :

 httpdist @?url?
 httpdist pack ?...?
 httpdist send ftpurl ?arch?

Description : utilitaire de mise à jour selon le protocole http://www.mibsoftware.com/httpsync/. Voir sdx starsync.

sync :

Syntaxe :

 sdx sync ?options? source destination

Description : Utilitaire pour synchroniser le contenu de destination avec le contenu de source. Ces derniers peuvant être de n'importe quel type supporté par VFS

Voir également SDX dans le menu contextuel de Windows

Catégorie Tclkit