Les premiers pas

Évaluation des performances des archiveurs

Ces informations s'adressent aux personnes prévoyant de publier des résultats de tests comparatifs entre ARJ et d'autres logiciels d'archivage de fichiers.

La compression ARJ -jm est destinée à démontrer ce qu'ARJ peut offrir de mieux en matière de réduction de taille. Toutefois, la compression ARJ -jm1 donne des résultats presque équivalents en termes de réduction de taille. La compression ARJ -m2 est conçue pour concurrencer LHA 2.12. La compression ARJ -m3 est destinée à concurrencer PKZIP 1.10.

L'option ARJ -e est nécessaire lors des tests de taille des archives, car ARJ enregistre par défaut le chemin d'accès complet spécifié dans l'archive, contrairement à d'autres archiveurs qui suppriment les informations de chemin.

La taille même du fichier exécutable d'ARJ augmente de façon significative les temps de compression et d'extraction lors des essais effectués sur de petites archives.

Notes de version

L'utilisation d'ARJ dans un environnement professionnel, commercial, institutionnel ou gouvernemental nécessite une licence. Toutefois, les utilisateurs provenant d'entreprises, d'organisations commerciales, d'institutions ou d'administrations gouvernementales peuvent utiliser ARJ à des fins d'évaluation pendant une période de 30 jours. Consultez le fichier LICENSE.DOC pour obtenir tous les détails.

L'inclusion de l'un des logiciels ARJ (ARJ, ARJR, DEARJ, ARJSFX, ARJSFXJR, REARJ) avec des logiciels et/ou du matériel destinés à la distribution nécessite également une licence.

Pendant la période d'évaluation d'ARJ, il est recommandé d'utiliser l'option «-jt» (test d'archive) afin de vérifier les nouvelles archives ARJ contenant vos données.

Cette version a été testée sous DOS 2.11, 3.3, 4.01 ainsi que DOS 5.0. Elle fonctionne également dans les fenêtres DOS de Windows 3.x et sous OS/2 2.0.

Voici une commande suggérée permettant de tester ARJ sur l'ensemble de vos fichiers :

Notes techniques

Une description technique détaillée du format des archives ARJ est disponible dans l'archive de distribution UNARJ. Cette archive contient une description des formats d'entête des archives ainsi que le code source en langage C d'un programme d'extraction et d'affichage du contenu des archives ARJ. Ce code source a été rendu portable sur plusieurs plateformes, notamment UNIX, NEXT, DOS et AMIGA.

Programmes ARJR, DEARJ et REARJ

Les nouveaux programmes ARJR et DEARJ sont disponibles pour les utilisateurs enregistrés et détenteurs d'une licence ARJ. ARJR correspond au programme ARJ sans l'écran d'aide ni les modules SFX. DEARJ correspond au programme ARJR sans les fonctions de création et de modification d'archives, sans la commande «w», ainsi que sans les options « -jt1 » et « -jt2 ».

Il existe deux versions de REARJ : la version partagicielle (shareware) et la version enregistrée. La version enregistrée contient plusieurs améliorations supplémentaires, notamment la prise en charge des variables d'environnement, la capacité « !listfile » et la sélection des fichiers selon leur date et heure.

UNARJ et DEARJ ne sont PAS le même programme.

Comment créer une archive arj auto-extractible exécutable

La commande « ARJ y -je archive » permet de créer une archive auto-extractible complète à partir d'une archive déjà existante.

La commande « ARJ y -je1 archive » permet de créer une archive auto-extractible plus compacte.

Syntaxe :

Cette commande produit le fichier archive.exe.

Sous les systèmes DOS autres que les versions 2.11, 3.2, 3.3, 4.0 et 5.0, il peut être nécessaire de renommer le module d'auto-extraction en ARJSFX.EXE afin d'effectuer l'extraction.

Consultez l'option «-je» pour obtenir davantage d'informations.

Conversion d'autres formats d'archives vers le format ARJ

Le programme REARJ est inclus avec ce logiciel. Ce programme peut être utilisé pour convertir individuellement ou collectivement des fichiers d'archives provenant d'autres formats vers le format ARJ.

La commande suivante :

convertira toutes les archives ZIP, ARC et LZH du répertoire courant vers le format ARJ.

Consultez le fichier REARJ.DOC pour obtenir davantage d'informations concernant REARJ.

Comment utiliser ARJ

Si vous tapez :

puis appuyez sur Enter, un écran d'aide simplifié s'affichera.

Si vous tapez :

puis appuyez sur Enter, des informations d'aide plus détaillées seront affichées.

Limitations d'ARJ

ARJ accepte au maximum :

• 64 noms de fichiers ou caractères génériques sur la ligne de commande ;
• 16 000 noms de fichiers résultant de caractères génériques ;
• 8 000 noms de fichiers ou caractères génériques à exclure ;
• 8 000 noms de fichiers ARJ résultant de caractères génériques ;
• des commentaires de 2 048 caractères (jusqu'à 25 lignes ou un fichier).

Pour la compression, ARJ nécessite environ 300 000 octets de mémoire, plus la mémoire nécessaire pour stocker tous les chemins d'accès des fichiers à archiver lorsque la méthode de compression par défaut (-m1) est utilisée.

Pour l'extraction, ARJ nécessite environ 175 000 octets de mémoire ou davantage. Le programme DEARJ (disponible pour les utilisateurs enregistrés) nécessite environ 125 000 octets de mémoire ou davantage.

Il n'existe aucune limite quant au nombre de fichiers pouvant être stockés dans une archive. Toutefois, chaque commande d'ajout ne peut ajouter qu'un maximum de 16 000 fichiers à la fois, selon la mémoire disponible. L'auteur estime qu'un maximum normal de 5 000 à 10 000 noms de fichiers peut être traité sans manquer de mémoire pendant la phase de compression.

Si vous ne disposez pas de suffisamment de mémoire, vous devriez utiliser l'option « -l » afin de sauvegarder les noms de fichiers dans un fichier de liste. Vous pourrez ensuite diviser ce fichier de liste en plusieurs fichiers plus petits et utiliser plusieurs commandes ARJ pour archiver l'ensemble des fichiers.

Exemple :

Si la commande ci-dessus échoue par manque de mémoire, divisez le fichier name.lst en plusieurs morceaux plus petits nommés name1.lst, name2.lst,... Ensuite, exécutez :

ARJ ne reconnaît actuellement pas que des caractères génériques comme « C:. » et « C:*.* » peuvent en réalité représenter la même chose. ARJ développera chacun de ces deux modèles génériques en une liste pouvant être jusqu'à deux fois plus longue que nécessaire.

Lors de la mise à jour d'une archive, ARJ crée un fichier temporaire nommé ARJTEMP.$nn dans le répertoire courant ou dans le répertoire de travail.

Pendant qu'ARJ analyse un modèle générique de fichiers, le programme renomme l'archive cible en ARJTEMP.$nn durant l'analyse afin d'éviter que l'archive elle-même soit incluse dans une commande d'ajout ou de déplacement. Par conséquent, vous ne pouvez pas ajouter un fichier nommé ARJTEMP.$nn dans une archive ARJ.

Veuillez noter que le nom de ce fichier temporaire pourrait changer dans une future version d'ARJ.

Différences importantes entre ARJ et LHARC

• Par défaut, ARJ enregistre le chemin d'accès complet spécifié des fichiers archivés, à l'exception de la lettre du lecteur et du symbole racine.
• Les commandes «e» et «x» extraient par défaut tous les fichiers de l'archive sans utiliser les dates et heures pour sélectionner les fichiers. Vous devez spécifier les options « -u -y » afin de reproduire le comportement de LHARC.
• La commande «f» d'ARJ nécessite l'option -r afin d'être fonctionnellement identique à la commande f de LHARC si l'archive originale a été créée avec l'option -r.

ARJ utilise le symbole « ! » comme préfixe pour indiquer les fichiers de liste.

Notes importantes

• Lors de l'utilisation de l'option de répertoire de travail « -w », ARJ ne vérifie pas l'espace disque disponible avant d'écraser l'archive originale si celle-ci existe déjà. Assurez-vous de disposer de suffisamment d'espace disque pour la nouvelle archive avant d'utiliser l'option « -w ». Si ARJ interrompt l'opération dans cette situation à cause d'un manque d'espace disque, l'archive temporaire sera conservée.
• Par défaut, ARJ ne traite pas les fichiers cachés ni les fichiers système. ARJ traitera les fichiers système et cachés lorsque vous spécifiez l'option « -a ».
• Comme LHARC et PKZIP, ARJ nécessite un espace disque supplémentaire pour METTRE À JOUR une archive existante. ARJ effectue une sauvegarde de l'archive originale pendant qu'il crée la nouvelle archive ; il doit donc y avoir suffisamment d'espace disponible pour contenir les deux archives simultanément.
• Contrairement à PKZIP, ARJ ne nécessite pas d'espace de travail supplémentaire lors de la CRÉATION d'une nouvelle archive.
• Actuellement, ARJ n'écrasera pas un fichier en lecture seule lors de l'extraction, sauf si l'option « -ha » est spécifiée.

Conseils pour utiliser ARJ efficacement

Lors de l'archivage sur disquettes, vous devriez utiliser l'option « -w » afin de définir un répertoire de travail sur votre RAMDRIVE ou votre disque dur, ce qui accélérera la création de l'archive.

Vous devriez utiliser l'option « -jt » lors de l'archivage sur disquettes ou lorsque vous souhaitez réellement être certain qu'ARJ pourra extraire correctement les données archivées. Il existe des cas où votre matériel ou des logiciels résidents en mémoire peuvent corrompre vos données ; l'option « -jt » constitue donc une excellente sécurité. Si vos disquettes contiennent des secteurs défectueux et que la vérification est désactivée, DOS ne signalera les erreurs de disquette qu'une fois qu'il sera trop tard. Ces erreurs ne sont pas récupérables.

L'utilisation de l'option « -js » permet de gagner du temps en évitant la compression des archives.

Vous devriez utiliser l'option « -e » chaque fois que vous n'avez pas besoin d'enregistrer les chemins d'accès dans une archive en cours de création. Cela permet d'économiser de l'espace.

Vous pouvez convertir une archive ARJ en archive auto-extractible avec une commande semblable à la suivante :

Pour extraire un commentaire contenu dans une archive ARJ, utilisez la commande suivante :

(le « ... » est important).

ARJ propose plusieurs méthodes de compression offrant différents compromis entre la taille et la vitesse. La méthode 4 «-m4» est environ deux fois plus rapide que la méthode 1. Les options « -jm1 » et « -jm » modifient les options « -m1 » et « -m2 » afin d'obtenir une compression encore plus élevée, au prix d'un temps de traitement plus long.

Utilisation d'ARJ à l'intérieur d'autres programmes

Comme ARJ utilise plus de 300 000 octets de mémoire pendant la compression, il est difficile d'utiliser ARJ dans une application volumineuse à moins que cette application ne se retire temporairement de la mémoire lorsqu'elle exécute des commandes DOS comme ARJ.

Cependant, il existe au moins un programme partagiciel permettant de retirer automatiquement une grande application de la mémoire chaque fois qu'elle retourne vers DOS pour exécuter une commande. Le programme SHROOM, développé par Davis Augustine, devrait pouvoir résoudre ce problème de mémoire.

La version la plus récente au 11/03/1992 se nomme SHROM19C.ZIP sur le BBS Channel One. Selon la documentation de SHROOM, vous pouviez contacter l'auteur à l'adresse suivante :

Ceci ne constitue pas une recommandation officielle du produit SHROOM.

La manière la plus simple d'utiliser ce produit est de taper :

La commande :

vous permettra d'observer SHROOM en fonctionnement lorsqu'un programme retourne vers DOS pour exécuter une commande.

Programme ARJMENU

Un programme nommé ARJMENU, développé par Michael McCombs, étant aussi disponible. Il s'agit du seul programme à interface par menus prenant en charge TOUTES les fonctionnalités d'ARJ. Ce programme est destiné aux utilisateurs qui n'apprécient pas les interfaces en ligne de commande.

ARJMENU permet à l'utilisateur de sélectionner facilement les options d'ARJ sans avoir à mémoriser la syntaxe des paramètres du programme. La version la plus récente du logiciel prend en charge ARJ version 2.30.

Vous pouvez contacter l'auteur à l'adresse suivante :

Programme d'aide hypertexte ARJ

ARJ-Help est un livre électronique (commercialisé sous le nom Window Book (TM)) permettant à l'utilisateur de découvrir facilement comment utiliser ARJ. Il fonctionne sous DOS et peut être utilisé soit comme programme autonome, soit comme programme résident de type TSR (« popup »).

Ce programme est très rapide et possède un ensemble riche de fonctionnalités incluant :

• une recherche plein texte ;
• des liens hypertextes ;
• une table des matières réorganisable selon les besoins de l'utilisateur ;
• un index complet ;
• et bien d'autres fonctions.

La version se trouvait sur certains BBS sous le nom ARJHLP23.EXE.

Utilitaires d'archivage prenant en charge le format ARJ

Les utilitaires suivants facilitent également l'utilisation d'ARJ. Cette liste n'est pas exhaustive et ne constitue pas une recommandation personnelle :

Utilisation d'ARJ comme programme de sauvegarde

ARJ peut être utilisé comme substitut à un programme de sauvegarde. Toutefois, il ne possède pas les fonctions de gestion des erreurs critiques de disquettes ni les mécanismes de récupération de données présents dans des logiciels comme FASTBACK, etc. Vous devez donc vous assurer de la fiabilité de vos disquettes. La cause la plus fréquente d'échec provient des disquettes défectueuses. Il est recommandé de laisser ARJ tester les archives directement SUR les disquettes. Tester les archives avant de les copier sur les disquettes n'est pas suffisant. Les données critiques devraient toujours être sauvegardées au moins deux fois. Veuillez garder à l'esprit que les dommages causés à des données compressées sont beaucoup plus graves que ceux affectant des données non compressées.

Avertissement : Vous ne devriez jamais mettre à jour des archives ARJ multi-volumes, particulièrement des archives de sauvegarde. Utilisez plutôt un ensemble distinct de disquettes pour effectuer une sauvegarde incrémentielle.

Les lignes de commande partielles suivantes illustrent :

• une commande de sauvegarde complète ;
• une commande de sauvegarde incrémentielle ;
• une commande de restauration.

Les seuls éléments manquants sont les noms des fichiers à sauvegarder ou à restaurer.

Vous devriez vous familiariser avec les options ci-dessus afin de pouvoir modifier ces lignes de commande selon vos besoins.

Si vous possédez un RAMDRIVE suffisamment grand, vous devriez modifier l'option « -w » afin qu'elle pointe vers ce RAMDRIVE.

Si vous disposez de suffisamment d'espace libre sur le disque dur, vous pouvez créer tous les volumes destinés aux disquettes directement sur le disque dur pour ensuite les copier sur les disquettes. Dans ce cas, vous devrez modifier le nom de l'archive en « C:backup » ou un nom similaire. L'option « -vvas » devra être remplacée par « -v360 », « -v720 » ou toute autre valeur adaptée à la taille de vos disquettes.

Veuillez noter que :

• 360 ;
• 720 ;
• 1200 ;
• 1440 ;

sont des abréviations correspondant aux tailles standards de disquettes. Les autres tailles nécessitent la saisie du nombre complet.

Une autre modification consiste à ajouter l'option « -y », qui désactive l'invite « Ok to proceed ... ». Enfin, si l'option « -w » pointe vers le disque dur, vous devriez supprimer complètement cette option.

IMPORTANT - Un maximum de 100 volumes peut être créé sur disque à la fois, car le suffixe des volumes passe de *.A99 à *.A00 lorsque la convention de nommage par défaut est utilisée. Toutefois, si vous spécifiez un nom d'archive commençant par le suffixe «.000» ou «.001», ARJ pourra créer jusqu'à 1000 ou 999 volumes portant des noms uniques.

Les deux commandes de sauvegarde effectueront une pause pour permettre l'exécution d'une « commande système ». Vous pourrez alors exécuter des commandes DOS. C'est un bon moment pour lancer une commande comme :

afin de vérifier que la disquette est formatée et dispose de suffisamment d'espace libre.

Vous pourriez également avoir besoin d'exécuter :

ou :

Une commande très utile pourrait être :

QDR est un utilitaire de Vernon Buerg. Vous devrez ensuite taper :

pour permettre à ARJ de continuer.

Si la sauvegarde échoue après avoir complété une ou plusieurs disquettes, vous pouvez reprendre l'opération à partir de l'archive suivant le dernier volume créé avec succès.

Il existe deux méthodes pour effectuer cette reprise.

Si vous avez spécifié un fichier d'index avec l'option « -ji » lors de la sauvegarde ayant échoué, vous pouvez reprendre simplement en retapant exactement la même ligne de commande qu'auparavant et en ajoutant l'option « -jn ». ARJ analysera alors le fichier d'index précédemment créé afin de retrouver les informations de reprise correctes. Le programme définira automatiquement le nom de volume approprié.

Exemple :

La seconde méthode est plus complexe. Consultez les descriptions des options « -jn » et « -jx » pour davantage de détails.

Par exemple, si la commande de sauvegarde complète ci-dessus a échoué pendant la deuxième disquette sur le fichier :

à partir de l'octet 125, la commande correcte serait :

L'étape la plus sujette aux erreurs consiste à déterminer correctement l'option « -jn ». Une erreur fréquente concerne l'utilisation du symbole de répertoire racine « \ » avec cette option. Vérifiez attentivement la présence ou l'absence de ce symbole dans le fichier d'index de sauvegarde.

Si la restauration échoue après une ou plusieurs disquettes, retapez simplement la même commande qu'auparavant en ajoutant le suffixe «.Ann» approprié au nom de l'archive. Si ARJ s'est interrompu à cause d'un disque plein sur un fichier réparti entre plusieurs volumes, vous devrez reprendre à partir du premier volume contenant ce fichier.

Archives de type sauvegarde et fichiers de sauvegarde

La version 2.30 d'ARJ introduit le concept d'archives de type «sauvegarde». Normalement, lorsqu'un fichier portant le même nom qu'un fichier déjà présent dans une archive ARJ est ajouté, ARJ écrase l'ancien fichier. Cependant, avec une archive de type sauvegarde sous ARJ 2.30, ARJ conserve l'ancien fichier en le marquant comme fichier de sauvegarde, puis ajoute le nouveau fichier. Cela entraîne des archives plus volumineuses que la normale.

Il est possible d'avoir plusieurs fichiers de sauvegarde dupliqués. Vous pouvez transformer une archive en archive de type sauvegarde en utilisant l'option « -jb » lors de l'ajout ou en tapant :

Tout ajout ultérieur d'un fichier déjà existant produira de nouveaux fichiers marqués comme sauvegardes. Vous pouvez réinitialiser cet indicateur de sauvegarde en utilisant l'option « -jb1 » comme dans :

Cette fonctionnalité est particulièrement utile pour sauvegarder des fichiers fréquemment modifiés. Une seule archive peut ainsi contenir plusieurs jours de sauvegardes successives.

La présence de fichiers de sauvegarde ou l'activation du mode archive de sauvegarde est indiquée lors de l'exécution des commandes «l» ou «v». Un message apparaîtra à la fin de l'affichage. Les fichiers de sauvegarde eux-mêmes peuvent être affichés en utilisant les options « -jg » ou « -jg1 » avec les commandes «l» ou «v».

Pour extraire un fichier de sauvegarde spécifique, plusieurs méthodes sont possibles :

Vous pouvez exécuter :

puis répondre « yes » à l'occurrence précise que vous souhaitez extraire.

Vous pouvez spécifier exactement la date et l'heure de modification désirées :

Vous pouvez également spécifier le numéro de séquence du fichier dans l'archive. Pour extraire le cinquième fichier de l'archive :

Le numéro de séquence est disponible dans l'affichage de la commande « v ».

Vous pouvez aussi extraire toutes les occurrences du fichier avec :

Les doublons seront renommés avec des extensions numériques comme «.000».

La commande :

peut être utilisée afin de purger une archive de tous les fichiers de sauvegarde.

Vous pouvez retirer le marquage de sauvegarde des fichiers avec :

Vous pouvez également retirer ce marquage pour des fichiers spécifiques, par exemple le cinquième fichier de l'archive :

Vous ne devriez pas utiliser l'option «-e» lors de l'ajout de fichiers dans une archive de type sauvegarde, car ARJ ne pourrait plus distinguer les fichiers possédant le même nom mais des chemins différents. Vous pourriez alors obtenir plusieurs fichiers dupliqués dans l'archive au lieu d'un fichier récent accompagné de plusieurs versions de sauvegarde.

La spécification de fichier « ... »

À plusieurs reprises dans cette section, il est fait mention de la spécification de fichier « ... ». Cette spécification a été choisie de manière à ne correspondre à aucun nom de fichier existant.

ARJ ne générera PAS d'erreur ni d'avertissement lorsqu'aucun fichier ne correspond spécifiquement à « ... ».

Situations d'erreur d'ARJ

AJOUT (ADD)

Si un fichier spécifié par l'utilisateur n'est pas trouvé lors d'un ajout, ARJ poursuivra le traitement, conservera l'archive et terminera avec un état d'erreur.

En cas de disque plein ou de toute autre erreur d'entrée/sortie de fichier, ARJ interrompra immédiatement l'opération avec un état d'erreur et supprimera le fichier d'archive temporaire, sauf si l'utilisateur a spécifié l'option « -jk ».

DÉPLACEMENT (MOVE)

ARJ supprimera uniquement les fichiers ayant été ajoutés avec succès à l'archive.

Si vous avez spécifié l'option « -jt » (test), ARJ interrompra l'opération à la moindre erreur.

Si vous utilisez l'option « -jk », ARJ ne supprimera pas l'archive temporaire en cas d'interruption.

EXTRACTION (EXTRACT)

En cas de disque plein ou de toute autre erreur d'entrée/sortie, ARJ interrompra immédiatement l'opération avec un état d'erreur et supprimera le fichier de sortie en cours de création.

Erreurs CRC ou données de fichier corrompues

Lorsqu'une archive ARJ est corrompue, ARJ signalera une erreur CRC ou une erreur de type « Bad file data ».

Ces corruptions peuvent être causées par :

• une disquette défectueuse ;
• un problème de mémoire de l'ordinateur ;
• une erreur lors d'un transfert de fichier ;
• un logiciel de mise en cache incompatible.

La majorité de ces erreurs provient de problèmes de transfert de fichiers et de mauvaises disquettes. Certaines erreurs sont dues à une interaction incompatible avec le support avancé de disquettes de SUPER PCKWIK 3.3 ou avec Windows 3.0.

gestionnaire d'erreurs critiques

Par défaut, ARJ installe un gestionnaire interactif d'erreurs critiques afin de traiter les erreurs DOS telles que :

Lorsqu'une erreur critique survient, ARJ affiche le message :

L'utilisateur peut relancer l'opération ayant échoué en appuyant sur Y.

En appuyant sur N, l'opération échouera ou le programme retournera vers DOS selon la version du système DOS utilisée.

L'utilisateur peut également appuyer sur Ctrl+BREAK afin d'interrompre l'exécution et revenir à DOS.

Codes ERRORLEVEL DOS d'ARJ

Invites d'action utilisateur d'ARJ

ARJ demande parfois une action de la part de l'utilisateur. Il existe plusieurs types d'invites :

• demandes de confirmation oui/non ;
• demande d'un nouveau nom de fichier ;
• saisie de commentaires d'archive ;
• saisie de chaînes de recherche.

Les invites oui/non acceptent également :

• « quit » pour terminer le programme ;
• « always » pour ignorer les demandes ultérieures.

Comme ARJ utilise STDIN pour les entrées utilisateur, il faut éviter de taper des réponses à l'avance en anticipant les questions. ARJ pourrait demander une action inattendue et utiliser accidentellement une entrée saisie précédemment.

L'option « -jy » permet de modifier le mode des invites afin d'utiliser des réponses à un seul caractère. Consultez la section concernant « -jy » pour plus d'informations.

Variable d'environnement ARJ

ARJ recherche d'abord une variable d'environnement nommée ARJ_SW et utilise sa valeur comme options de paramètres pour ARJ.

Si ARJ trouve cette variable d'environnement, il affichera un message l'indiquant.

Vous pouvez empêcher ARJ d'utiliser cette variable en spécifiant l'option « -+ ».

Vous pouvez également modifier le nom de la variable d'environnement avec cette option, par exemple :

Définition de la variable :

Exemple :

N'ajoutez PAS d'espace après le nom de variable ARJ_SW.

Comme avec LHARC, les options de la ligne de commande peuvent être utilisées afin d'écraser les paramètres définis dans ARJ_SW.

ARJ vous permet d'utiliser un caractère différent pour les options, soit « - » ou « / », dans la variable ARJ_SW ainsi que sur la ligne de commande, sauf lors de l'utilisation de l'option « -ju » (mode UNIX).

Si la variable d'environnement ARJ_SW contient un nom de fichier (du texte ne commençant pas par un caractère d'option), ARJ ouvrira ce fichier et analysera son contenu afin de rechercher une ligne de texte commençant en colonne 1 par la même lettre que la commande ARJ exécutée. Le texte suivant cette lettre sera alors traité comme les options ARJ_SW. Cela permet à chaque commande ARJ d'avoir son propre ensemble d'options par défaut.

De plus, ARJ recherchera également le symbole « + » en colonne 1 afin de l'utiliser comme chaîne d'options diverses. Cette chaîne sera ajoutée à toute chaîne d'options trouvée pour une commande spécifique. Si aucune chaîne d'options correspondant à la commande n'est trouvée, ARJ utilisera alors la chaîne d'options diverses comme paramètres ARJ_SW.

Veuillez noter que les options définies avec le symbole « + » ne seront PAS utilisées si cette ligne apparaît après la ligne spécifique à la commande.

Exemple :

Le fichier :

contient :

Ce qui équivaut à :

Dans l'exemple ci-dessus, toutes les commandes ARJ utilisant la commande « a » emploieront automatiquement les options « -jm1 -jt -i1 » comme paramètres ARJ_SW.

La variable ARJ_SW ou les paramètres contenus dans le fichier de configuration ARJ_SW ne peuvent PAS contenir d'options entre guillemets comme :

Syntaxe de la ligne de commande ARJ

Les commandes et les options peuvent être saisies en majuscules ou en minuscules.

Les options peuvent être placées n'importe où après la commande ARJ.

ARJ prend en charge l'utilisation de « - » ou « / » comme caractère d'option. La première occurrence de « - » ou « / » rencontrée par ARJ dans la variable ARJ_SW déterminera le symbole utilisé pour interpréter les options d'ARJ_SW.

De même, la première occurrence de « - » ou « / » rencontrée sur la ligne de commande déterminera le symbole utilisé pour interpréter les options de cette ligne de commande, sauf si l'option « -ju » (mode UNIX) a été spécifiée dans ARJ_SW.

Vous ne pouvez PAS mélanger les symboles d'options.

Dans tout ce document, le symbole « / » peut être substitué à « - » lors de l'utilisation des options.

Exemples :

est correct.

constitue une UTILISATION INCORRECTE.

Les options spécifiées sur la ligne de commande peuvent soit activer/désactiver, soit remplacer les options définies dans la variable d'environnement ARJ_SW.

L'utilisation des options est identique à celle de LHARC.

• « -s+ » ? active l'option « s »
• « -s- » ? désactive l'option « s »
• « -s » ? inverse l'état de l'option « s »
• « -sname » ? fournit l'argument « name » à l'option « -s »
• « -- » ? arrête l'analyse des options suivantes

Les options peuvent être combinées afin de réduire la longueur de la ligne de commande.

Cependant, certaines options acceptent des arguments de type chaîne de caractères et doivent donc être placées en dernier dans une combinaison d'options, car ARJ considère le reste de l'argument comme faisant partie de cette chaîne.

Par exemple :

vous pouvez combiner « -r » et « -i » pour obtenir :

vous pouvez également combiner :

en :

car l'option prenant un argument texte est placée à la fin.

Veuillez noter que les options acceptant UNIQUEMENT les modificateurs :

• « + »
• « - »
• « 0 »
• « 1 »
• « 2 »

peuvent être combinées dans n'importe quel ordre.

Les options suivantes doivent obligatoirement être placées à la fin d'un groupe combiné d'options :

• -g, -l, -m, -o, -t, -v, -w, -x, -z, -!,
• -$, -jc, -jd, -jh, -ji, -jn, -jp,
• -js, -jw, -jx, -jy, -jz

AVERTISSEMENT : Le « j » des options de type « -jX » agit comme un symbole de décalage (SHIFT). Ainsi, une combinaison comme :

équivaut à :

car le « j » modifie la signification des caractères suivants dans la chaîne d'options.

L'utilisation de plus d'UN symbole de décalage « j » par chaîne d'arguments n'est PAS prise en charge dans les versions futures.

Exemples :

équivaut à :

et :

équivaut à :

ARJ accepte un caractère « - » final sur la plupart des options, comme :

L'option « -x » constitue une exception.

La principale restriction est que, pour les options acceptant une chaîne de caractères facultative comme :

cette option ne doit PAS être suivie d'une autre option concaténée telle que :

Une chaîne comme :

est acceptable parce que l'option « -w » est la dernière de la combinaison.

Une combinaison spéciale est :

Vous pouvez désactiver les modificateurs « y » et « r » avec :

L'option :

indique à ARJ qu'il ne doit plus analyser d'autres options sur la ligne de commande courante. Cela est utile lorsque vous devez saisir des noms de fichiers commençant par « - ».

Exemple :

L'extension standard des fichiers ARJ est «.ARJ».

Les archives multi-volumes suivantes utilisent les suffixes :

• «.A01»
• «.A02»
• etc.

jusqu'à :

• «.A99»
• «.A00»
• «.A01»

Il est également possible de créer des volumes commençant à :

• «.001»

et allant jusqu'à :

• «.999»

La commande ARJ doit être le premier argument ne correspondant pas à une option après le mot ARJ.

Le nom de l'archive ARJ doit être le premier nom de fichier sur la ligne de commande.

Le répertoire de base, s'il existe, doit être le second argument de type nom de fichier.

Les options et les autres noms de fichiers peuvent être placés dans n'importe quel ordre.

Le nom du répertoire de base devrait se terminer par :

• « \ » (barre oblique inversée) ;
• ou « : » (deux-points).

Cependant, ARJ acceptera également les noms de répertoires sans le caractère « \ » si le répertoire existe déjà. Cette fonctionnalité est limitée aux commandes de type ajout et extraction.

Les noms génériques (wild_names) suivent les conventions MS-DOS :

• « . » signifie tous les fichiers ;
• *« .DOC » signifie tous les fichiers ayant l'extension « .DOC » ;
• « ?B. »** signifie tous les fichiers dont le deuxième caractère est « B ».

La valeur par défaut de <wild_name> pour toutes les commandes sauf « d » est :

Pour les commandes d'ajout, déplacement, mise à jour partielle (freshen) et mise à jour complète (update), la correspondance des fichiers dans l'archive exige une correspondance exacte du chemin selon l'utilisation de l'option « -e ».

Pour les commandes autres que les mises à jour, les noms de fichiers spécifiés avec des chemins forceront une correspondance complète du chemin.

Vous pouvez fournir un ou plusieurs noms de fichiers contenant des listes de fichiers à ajouter à une archive.

Ces fichiers de liste doivent :

• contenir un nom de fichier par ligne ;
• ne pas contenir d'espaces au début ou à la fin des lignes.

Les noms de fichiers de liste doivent être précédés du caractère :

Si vous souhaitez archiver un fichier dont le nom commence par « ! », vous devez utiliser l'option « -! » afin de définir un nouveau caractère pour les fichiers de liste.

Vous pouvez exclure des noms de fichiers ou des modèles génériques de la liste des fichiers à traiter par ARJ.

Exemple :

Cette commande ajoute tous les fichiers du répertoire courant sauf les fichiers .EXE et .OBJ.

Génériques dans les noms d'archives

Vous pouvez spécifier un caractère générique pour le nom de l'archive, comme :

pour toutes les commandes ARJ sauf les commandes d'ajout :

• a
• f
• j
• m
• u

Si vous spécifiez également l'option « -r », ARJ recherchera aussi les archives ARJ (*.ARJ) dans les sous-répertoires.

Exemples :

affichera toutes vos archives .ARJ.

ajoutera un commentaire à toutes vos archives.

Commandes ARJ

a : Ajouter des fichiers à une archive

Il s'agit de la commande de base permettant d'ajouter des fichiers disque dans une archive ARJ.

Vous pouvez spécifier de 0 à 64 arguments de noms de fichiers (dont l'un peut être un répertoire de destination). Les arguments peuvent être des noms génériques.

Si vous utilisez l'option « -r » (récursion dans les sous-répertoires), ARJ ajoutera tous les fichiers des sous-répertoires correspondant au modèle générique spécifié.

Exemple :

Archive tous les fichiers du répertoire « subdir ».

Pour obtenir la compression maximale, utilisez l'option :

b : Exécuter une commande de traitement par lots ou DOS

La commande ARJ b permet à l'utilisateur d'exécuter une commande DOS sur des fichiers sélectionnés dans une archive.

ARJ demandera une chaîne de commande DOS à exécuter pour chaque fichier sélectionné.

Par défaut, ARJ extrait les fichiers sélectionnés sous le nom :

Ce nom peut être modifié avec l'option :

L'option de répertoire de base est ignorée par la commande ARJ b.

Le fichier temporaire sera supprimé par ARJ après l'exécution de la commande DOS.

Exemples :

Cette option peut remplacer une simple commande d'extraction suivie d'une exécution lorsque le fichier extrait est exécutable.

Vous pouvez spécifier un nom temporaire pour l'exécutable de sortie puis utiliser ce nom comme commande DOS à exécuter.

Exemple :

Vous pouvez également fournir directement la chaîne de commande DOS sur la ligne de commande avec l'option :

Les options contenant des espaces doivent être placées entre guillemets doubles.

Exemples :

c : Ajouter des commentaires aux archives

Cette commande permet d'ajouter des commentaires à l'entête de l'archive ainsi qu'aux fichiers individuels.

ARJ demandera un commentaire pour chaque élément.

L'utilisateur peut saisir jusqu'à 25 lignes pour chaque commentaire.

Une ligne contenant uniquement :

mettra fin à la saisie du commentaire.

L'utilisateur peut choisir de lire les commentaires à partir d'un fichier en saisissant le nom du fichier précédé du caractère :

comme dans :

au début de la première ligne du commentaire.

Ce fichier est lu comme un fichier texte.

Les lignes du texte peuvent atteindre jusqu'à 2048 octets.

Seuls les 2048 premiers octets du fichier seront acceptés par ARJ.

Pour effacer un commentaire d'une archive :

• tapez Barre d'espacement Enter sur la première ligne du commentaire ;
• puis [Entrée] sur la seconde ligne.

Pour supprimer les commentaires d'archive ou de fichiers d'une archive, vous pouvez utiliser la fonctionnalité du fichier NUL de MS-DOS.

Exemples :

supprime le commentaire de l'archive.

supprime le commentaire du fichier « name ».

supprime tous les commentaires des fichiers.

supprime tous les commentaires.

Pour ajouter uniquement un commentaire à l'archive et non aux fichiers, utilisez :

Pour ajouter uniquement un commentaire d'archive directement depuis la ligne de commande :

Vous pouvez également ajouter des commentaires à une archive avec les commandes :

• a
• f
• m
• u

Exemple :

d : Supprimer des fichiers d'une archive

Cette commande permet de supprimer des fichiers d'une archive.

Lorsque la sélection par caractères génériques n'est pas appropriée, vous pouvez utiliser l'option :

afin de demander à ARJ de confirmer chaque suppression individuellement.

Les fichiers supprimés sont physiquement retirés de l'archive.

Exemples :

Supprime tous les fichiers de l'archive se terminant par «.c» :

Demande une confirmation avant de supprimer chaque fichier se terminant par «.c».

Actuellement, ARJ ne supprime jamais l'archive elle-même, même lorsqu'elle devient vide.

e : Extraire des fichiers d'une archive

Cette commande extrait un ou plusieurs fichiers de l'archive vers le répertoire courant ou vers le répertoire de base s'il est spécifié.

ARJ demandera confirmation avant d'écraser des fichiers existants, sauf si l'utilisateur spécifie l'option :

Si l'utilisateur répond :

ARJ demandera un nouveau nom de fichier.

Si l'utilisateur appuie simplement sur Enter au lieu de saisir un nom de fichier, ARJ ignorera l'extraction du fichier courant.

Exemple :

Extrait tous les fichiers se terminant par «.c» dans le sous-répertoire :

Lors de l'extraction d'un fichier réparti sur plusieurs volumes, ARJ peut afficher l'invite :

Cela se produit généralement lorsque les fichiers sont fractionnés entre plusieurs volumes.

Vous devrez également spécifier l'option :

afin de permettre à ARJ de continuer automatiquement vers le volume suivant d'une série.

Lors de l'extraction depuis une série de volumes multiples sur disquette, il est plus simple d'utiliser le caractère générique :

pour spécifier l'archive, comme dans :

Si vous souhaitez extraire uniquement une partie d'une archive et que cette partie correspond à un répertoire contenant lui-même des sous-répertoires, vous devriez utiliser l'option :

Consultez la description de l'option :

pour plus d'informations.

Les commandes :

acceptent désormais l'option :

qui permet d'extraire puis de supprimer les fichiers extraits.

Cette fonctionnalité exige que vous spécifiiez explicitement les fichiers à extraire et supprimer.

ARJ n'utilisera PAS automatiquement :

avec cette option.

Cette fonctionnalité consomme en réalité davantage d'espace disque qu'une simple extraction en raison de la création d'une archive temporaire durant le processus.

Exemple :

Si ARJ rencontre une erreur de disque plein durant l'extraction, le programme interrompra l'opération avec une erreur.

Vous pouvez empêcher cette interruption avec l'option :

Consultez la description de l'option :

pour davantage d'informations.

Si ARJ rencontre une erreur CRC ou une erreur de type :

pendant l'extraction, ARJ supprimera le fichier extrait corrompu, sauf si l'option :

est utilisée.

f : Actualiser les fichiers dans une archive

Met à jour les fichiers correspondants dans l'archive lorsque ceux présents sur le disque sont plus récents que ceux contenus dans l'archive.

Exemple :

Lors de l'actualisation d'archives, vous devriez utiliser les mêmes spécifications de noms de fichiers que celles utilisées lors de la création de l'archive.

Exemple :

Si aucun fichier ni commentaire n'a été ajouté à l'archive, ARJ ne réécrira pas l'archive à partir de la version 2.20 et ultérieure.

g : Chiffrer les fichiers d'une archive

La commande :

permet à l'utilisateur de chiffrer une archive ARJ déjà existante.

Veuillez noter que seuls les fichiers non chiffrés seront chiffrés par cette commande.

Exemple :

i : Vérifier l'intégrité de ARJ.EXE

La commande :

permet à l'utilisateur de vérifier l'intégrité du programme «ARJ.EXE». ARJ affichera :

si le programme testé échoue à la vérification d'intégrité.

Cela indique probablement que le programme est corrompu.

Veuillez noter que la commande :

ne doit pas être utilisée sur un exécutable ARJ compressé avec des utilitaires comme :

• DIET ;
• LZEXE ;
• etc.

car dans ce cas la commande signalera TOUJOURS une erreur CRC.

Si aucun nom de programme n'est spécifié, ARJ vérifiera le programme actuellement exécuté.

Syntaxe :

(sous DOS 3.0 et versions ultérieures)

j : Fusionner des archives dans une archive

La commande :

permet à l'utilisateur de fusionner plusieurs archives ARJ.

Syntaxe :

Certaines options ne sont PAS prises en charge par la commande :

notamment :

• -o
• -ob
• -f
• -u
• -c
• -v

Veuillez noter qu'ARJ n'affiche aucun message d'erreur lorsqu'une option non prise en charge est utilisée avec la commande :

L'option :

est prise en charge par cette commande.

Veuillez également noter que les options fonctionnelles comme :

sélectionnent les archives à fusionner et NON le contenu des archives.

Cette commande peut être utilisée pour convertir un module auto-extractible SFX en archive ARJ classique.

Exemple :

k : Compacter les fichiers de sauvegarde d'une archive

La commande :

fonctionne de manière similaire à la commande :

à la différence que la commande :

supprime uniquement les fichiers marqués comme fichiers de sauvegarde.

La commande :

nécessite un nom générique ou une spécification de fichier comme critère de sélection.

Exemples :

l : Afficher le contenu d'une archive

Cette commande affiche le contenu de l'archive vers la sortie standard.

L'affichage peut être interrompu après chaque écran à l'aide de l'option :

Les fichiers sont affichés dans leur ordre d'entreposage.

Il n'existe actuellement aucune option de tri.

Le dernier champ affiché :

signifie :

Exemple :

Un signe :

• +

placé devant le champ date/heure indique que la date appartient au XXI^e siècle :

Pour la compression en mode texte, la taille originale du fichier indiquée par les commandes :

• l
• v

correspond au nombre réel d'octets lus en entrée.

Cette taille correspond généralement à la taille du fichier MS-DOS moins le nombre de retours chariot présents dans le fichier, car le mode texte du langage C supprime les caractères de retour chariot.

Lorsque ARJ détecte qu'une archive possède l'indicateur de sauvegarde activé, il affiche le message :

Lorsque ARJ détecte des fichiers de sauvegarde dans une archive, il affiche le message :

Afin d'indiquer qu'un fichier est marqué comme sauvegarde, ARJ affiche un caractère :

dans la colonne située juste après les attributs du fichier.

L'option :

est nécessaire afin que les commandes :

• l
• v

affichent les noms des fichiers de sauvegarde.

Exemple :

m : Déplacer des fichiers vers une archive

Cette commande est similaire à l'utilisation de la commande :

avec l'option :

La commande :

ajoute les fichiers sélectionnés à l'archive.

Si l'ajout réussit, les fichiers ajoutés sont ensuite supprimés.

La commande de déplacement ne demande pas de confirmation avant la suppression des fichiers.

Utilisez plutôt la commande :

si vous souhaitez cette fonctionnalité.

Exemple :

Lorsque la commande :

est utilisée avec les options :

• -f
• -u

ARJ supprimera :

• les fichiers ajoutés avec succès ;
• ainsi que les fichiers déjà à jour dans l'archive.

Il est fortement recommandé d'utiliser systématiquement l'option :

avec les commandes de déplacement afin que ARJ vérifie l'archive avant de supprimer les fichiers source.

Depuis ARJ 2.30, ARJ tente également de supprimer les répertoires ajoutés à l'archive.

Les répertoires peuvent UNIQUEMENT être sélectionnés avec l'option :

Les répertoires contenant des fichiers NON sélectionnés ne seront pas supprimés.

Exemples :

supprime le répertoire «soft» :

ne supprime pas le répertoire «soft».

n : Renommer des fichiers dans une archive

Cette commande permet de modifier les noms des fichiers entreposés dans une archive ARJ.

ARJ demandera un nouveau nom pour chaque fichier sélectionné.

Vous pouvez ignorer le changement de nom d'un fichier particulier en saisissant simplement une ligne vide.

Exemple :

Dans cet exemple, ARJ demandera de nouveaux noms pour tous les fichiers «*.c».

o : Ordonner les fichiers dans une archive

Cette commande permet de réorganiser l'ordre des fichiers à l'intérieur d'une archive.

Vous pouvez spécifier l'ordre des fichiers directement sur la ligne de commande ou utiliser un ou plusieurs fichiers de liste.

Tous les fichiers présents dans l'archive mais non spécifiés sur la ligne de commande ou dans un fichier de liste seront placés à la fin de l'archive dans le même ordre relatif qu'à l'origine.

Aucun caractère générique ne peut être utilisé comme spécification d'ordre.

Les noms de fichiers dans le fichier de liste doivent être inscrits un par ligne.

Exemple :

Dans cet exemple, les fichiers :

seront placés en premier dans l'archive.

Tous les autres fichiers seront ajoutés après ceux-ci.

Exemple :

Dans cet exemple, l'archive sera réorganisée selon l'ordre des noms présents dans le fichier «list».

IMPORTANT

Pour la commande «o» l'option de fichier de liste possède une fonctionnalité spéciale.

Si le fichier de liste se nomme :

ARJ s'attendra à ce que ce fichier ait été créé avec la commande :

Le fichier «ARJSORT.$$$» peut également être spécifié avec un chemin d'accès.

Consultez le fichier de traitement par lots «ARJSORT.BAT» pour un exemple de cette fonctionnalité spéciale.

Création de fichiers de liste

Afin de faciliter la création de fichiers de liste, la commande «v» d'ARJ peut produire des sorties spéciales avec les options :

L'option :

affiche uniquement les chemins d'accès stockés dans l'archive.

Aucune autre information de liste n'est affichée.

Cette sortie peut être redirigée vers un fichier afin d'être triée manuellement pour créer un fichier de liste.

L'option :

affiche la liste détaillée standard avec quelques modifications :

• aucun numéro séquentiel n'est affiché ;
• aucun champ de commentaire n'est affiché ;
• le chemin d'accès est ajouté aux données descriptives du fichier au lieu d'être placé sur une ligne séparée.

Juste avant le champ du chemin d'accès sont affichés :

• l'extension du fichier ;
• le nom du fichier.

Ces champs permettent à l'utilisateur de trier les lignes de texte selon :

• la date et l'heure ;
• l'extension ;
• la valeur CRC ;
• etc.

Des éditeurs de texte comme :

• Qedit ;
• SLED ;

permettent de trier les lignes de texte à partir d'un champ de texte intégré.

À partir d'ARJ 2.20 et versions ultérieures, vous ne pouvez pas - et ne devriez pas - réorganiser une archive multi-volumes avec la commande :

p : Afficher les fichiers vers la sortie standard

Cette commande envoie les fichiers vers la sortie standard.

Cette fonctionnalité fonctionne de manière à ce que le fichier de sortie contienne uniquement les données extraites du fichier.

Cela est particulièrement important pour une utilisation de type UNIX.

Exemple :

Dans cet exemple, le fichier «output.fil» sera une copie exacte du fichier «manual.doc».

Aucune information d'en-tête supplémentaire ne sera ajoutée dans :

Toutes les informations relatives à la phase d'extraction sont envoyées vers le périphérique «STDERR» correspondant normalement à l'écran d'affichage.

Exemple :

Dans cet exemple, la sortie standard est redirigée vers l'imprimante.

Aucun fichier intermédiaire sur disque n'est utilisé.

Cependant, lors de la redirection vers une imprimante, ARJ convertira les fichiers binaires en texte, ce qui peut entraîner une perte de données.

La commande :

permettra d'envoyer un fichier binaire vers l'imprimante sans perte de données.

ARJ applique également la date et l'heure du fichier au flux de sortie.

Ainsi, une consultation de fichier comme :

affichera correctement la date et l'heure du fichier.

L'option :

peut être utilisée afin d'interrompre l'affichage écran comme avec la commande :

L'option :

permettra l'affichage des caractères graphiques IBM avec l'option :

NOTE

En raison d'un problème lié à l'utilisation de fwrite() et de STDOUT les erreurs survenant lors de la redirection vers des ports série ou des imprimantes peuvent ne pas être détectées.

En revanche, les erreurs lors d'une redirection vers des fichiers disque seront détectées.

r : Retirer les chemins des noms de fichiers

Cette commande configure ARJ afin de supprimer la partie chemin des noms de fichiers entreposés dans l'archive.

Par défaut, cette opération s'applique à tous les fichiers présents dans l'archive.

Cette commande est utile si vous avez oublié de spécifier l'option :

afin d'exclure les chemins d'accès.

s : Afficher un aperçu des fichiers à l'écran avec pause

Cette commande est similaire à la commande p à la différence qu'un écran complet de données est affiché à l'utilisateur avant qu'une action soit demandée.

L'invite d'action peut être supprimée avec l'option :

La commande s filtre le texte affiché :

• en limitant chaque ligne à 79 caractères ;
• en affichant le caractère «?» à la place des caractères de contrôle.

L'option :

permet l'affichage des caractères graphiques IBM.

t : Tester l'intégrité d'une archive

Cette commande vérifie le contenu des fichiers sélectionnés afin de confirmer la validité de leur valeur CRC.

ARJ utilise un CRC 32 bits pour valider le contenu des fichiers.

L'utilisation d'un CRC 32 bits est beaucoup plus efficace que celle d'un CRC 16 bits pour la détection des erreurs.

Utilisez cette commande afin de tester complètement l'enveloppe de sécurité d'une archive protégée «ARJ-SECURED».

u : Mettre à jour des fichiers dans une archive

Cette commande :

• met à jour les fichiers plus anciens présents dans l'archive ;
• ajoute les fichiers nouveaux absents de l'archive.

Exemple :

v : Afficher en détail le contenu d'une archive

Cette commande affiche :

• le chemin complet ;
• les commentaires des fichiers de l'archive ;
• ainsi que les mêmes informations que la commande «l».

La commande v affiche désormais un numéro de séquence devant chaque chemin de fichier.

Ce numéro peut être utilisé avec l'option :

afin d'accéder à des fichiers spécifiques dans une archive.

Exemple :

Utilisez l'option :

afin d'interrompre l'affichage après chaque écran.

L'option :

affichera uniquement les chemins d'accès à l'écran.

L'option :

affichera les données de l'archive dans un format adapté au tri selon différents champs afin d'être utilisé avec la commande :

w : Rechercher des chaînes de texte dans une archive

Cette commande permet à l'utilisateur de rechercher des chaînes de texte à l'intérieur des archives.

ARJ demandera à l'utilisateur si la recherche doit ignorer la casse.

Cette option de recherche prend en compte les pages de codes MS-DOS afin que la gestion des majuscules et minuscules des caractères accentués ou comportant des trémas soit effectuée correctement.

ARJ demandera également le nombre de lignes de contexte à afficher autour d'une correspondance trouvée.

Si un nombre supérieur à zéro est choisi, ARJ affichera :

• la chaîne trouvée ;
• ainsi que le texte environnant.

Tous les caractères non imprimables, y compris les retours à la ligne, seront remplacés par des points d'interrogation :

Les lignes de contexte affichées auront une longueur de 78 caractères.

Lorsque l'option d'affichage du contexte est utilisée, ARJ désactive l'indicateur de progression.

Si l'option :

est activée, les caractères graphiques IBM (codes 128 à 255) seront affichés.

Ensuite, cette commande demandera à l'utilisateur jusqu'à 20 chaînes de texte à rechercher dans l'archive.

Le nombre total de correspondances trouvées sera affiché après l'analyse de chaque fichier individuel.

Les chaînes de recherche sont limitées à 79 caractères.

Les correspondances traversant plusieurs volumes d'archives ne seront pas détectées par cette fonction de recherche.

Vous pouvez rechercher dans plusieurs archives ARJ avec une commande comme :

Vous pouvez interrompre l'affichage écran par page avec l'option :

L'option :

peut être utilisée afin de fournir directement les paramètres nécessaires à la commande :

La chaîne d'options sera interprétée comme suit :

• le premier caractère doit être :
• « + » pour oui ;
• ou « - » pour non ;
• les caractères suivants représentent le nombre de lignes de contexte à afficher ;
• le caractère suivant représente un séparateur non numérique ;
• les caractères suivants représentent le texte à rechercher.

Exemples :

• recherche sans tenir compte de la casse ;
• affiche 3 lignes de contexte ;
• recherche le texte :

total

• recherche sensible à la casse ;
• affiche 2 lignes de contexte ;
• recherche le texte :

to be

x : Extraire les fichiers avec leur chemin complet

Cette commande extrait un ou plusieurs fichiers de l'archive en conservant leur chemin complet dans le répertoire courant ou dans le répertoire de base s'il est spécifié.

ARJ enregistre normalement les chemins d'accès comme s'ils étaient des sous-répertoires du répertoire cible.

Toute indication de lecteur ou de répertoire racine est supprimée avant l'extraction, sauf si l'option :

est utilisée avec la commande :

Exemple :

Si vous souhaitez extraire uniquement une partie d'une archive et que cette partie correspond à un répertoire contenant lui-même des sous-répertoires, vous devriez utiliser l'option :

Consultez la description de l'option :

pour plus d'informations.

Les commandes :

acceptent désormais l'option :

afin de permettre l'extraction suivie de la suppression des fichiers.

Cette fonctionnalité exige que vous spécifiiez explicitement les fichiers à extraire et supprimer.

ARJ n'utilisera PAS automatiquement :

avec cette option.

Consultez la description de la commande :

pour davantage d'informations concernant l'extraction.

y : Copier une archive avec de nouvelles options

La commande :

fournit une interface simple pour les options :

• -je
• -je1
• -jb
• -jb1
• -jb2

Exemples :

convertit une archive en archive auto-extractible (SFX).

transforme une archive en archive de type sauvegarde.

réinitialise l'indicateur de sauvegarde.

retire le marquage de sauvegarde de tous les fichiers.

Options d'ARJ

? : Afficher les écrans d'aide complets

La commande :

affiche plusieurs écrans d'aide avec des pauses entre chaque page.

La commande :

affiche les écrans d'aide sans pause entre les pages.

Vous pouvez également rediriger la sortie vers un fichier, comme dans l'exemple suivant :

ARJ peut ne pas détecter correctement une redirection de fichier réseau et effectuer malgré tout des pauses à chaque écran.

- : Ignorer les options suivantes

L'option -- indique à ARJ d'arrêter l'analyse des options présentes sur la ligne de commande.

Cette fonctionnalité est utile pour spécifier des noms de fichiers commençant par «-».

Exemple :

+ : Désactiver l'utilisation de ARJ_SW

L'option -+ empêche ARJ d'utiliser la valeur de la variable d'environnement ARJ_SW lors du traitement des options.

Exemple :

L'option -+ peut également être utilisée pour spécifier un autre nom de variable d'environnement à utiliser à la place du nom par défaut ARJ_SW.

Cette option ne peut être utilisée que sur la ligne de commande.

Exemple :

& : Installer un gestionnaire d'erreurs critiques

Par défaut, ARJ installe un gestionnaire interactif d'erreurs critiques afin de gérer des erreurs telles que :

L'utilisateur peut alors choisir de relancer l'opération ayant échoué.

L'utilisateur peut également appuyer sur Ctrl+BREAK afin de revenir à DOS.

L'option -& configure ARJ afin d'installer un gestionnaire d'erreurs critiques non interactif.

Cette fonctionnalité est conçue pour une utilisation d'ARJ sans surveillance.

Ce gestionnaire interceptera les erreurs produisant des messages comme :

par exemple :

• les erreurs de secteurs défectueux ;
• les violations de partage de fichiers.

Cette option peut être spécifiée :

• sur la ligne de commande ;
• ou via une variable d'environnement.

Veuillez noter que :

si vous spécifiez :

sur la ligne de commande, le gestionnaire sera installé immédiatement avant le traitement des fichiers ;

si vous spécifiez cette option dans la variable d'environnement, ARJ n'installera le gestionnaire qu'après le traitement complet des options.

! : Définir le caractère des fichiers de liste

Cette option permet à l'utilisateur de définir le caractère utilisé pour les fichiers de liste.

L'option :

sans caractère spécifié inverse l'état (désactive) du caractère courant des fichiers de liste (par défaut «!» ).

Syntaxe :

Le premier exemple ci-dessus définit le caractère de fichier de liste sur celui utilisé par LHA ; PKZIP.

$ : Ajouter ou extraire une étiquette de volume

Cette option permet à l'utilisateur d'entreposer ou d'extraire des étiquettes de volume DOS dans les archives ARJ.

Il est possible d'avoir plusieurs étiquettes de volume dans une même archive.

À partir d'ARJ 2.10, l'ajout ou l'extraction d'étiquettes de volume n'est possible qu'à partir de DOS 2.0 et versions ultérieures.

L'option :

peut être utilisée avec ou sans spécification d'unité de disque.

Le lecteur peut être indiqué en ajoutant la lettre du lecteur et éventuellement le caractère «:» à l'option :

Si aucun lecteur n'est spécifié, ARJ utilise le lecteur courant, sauf si le répertoire de base cible possède déjà une spécification de lecteur.

AVERTISSEMENT

Actuellement, ARJ autorise plusieurs étiquettes de volume identiques dans une même archive.

Vous pouvez supprimer une ou plusieurs étiquettes dupliquées avec la commande :

ARJ demandera une confirmation pour chaque occurrence de label.

Ce mécanisme « imparfait » permet d'ajouter à la fois :

• un fichier ;
• et une étiquette de volume ;

portant le même nom dans une archive.

La possibilité d'avoir des étiquettes de volume dupliquées pourrait NE PLUS être présente dans les futures versions d'ARJ.

Les modules SFX ; SFXJR ; ne prennent PAS en charge l'extraction des étiquettes de volume.

Dans l'écran de liste, les étiquettes de volume sont indiquées par la lettre V dans la colonne T.

Syntaxe

Ajoute tous les fichiers ainsi que l'étiquette du lecteur courant.

Ajoute uniquement l'étiquette du lecteur B.

Ajoute uniquement l'étiquette du lecteur B:.

Ajoute uniquement l'étiquette du lecteur B:.

Extraction des étiquettes de volume

Pour extraire des étiquettes de volume, vous devez sélectionner l'étiquette en utilisant l'option :

et en spécifiant un nom ou modèle correspondant.

Syntaxe :

Extrait l'étiquette nommée doslabel vers le lecteur courant.

Extrait tous les fichiers vers le lecteur courant et extrait l'étiquette vers l'unité de disque D:

Extrait tous les fichiers vers B:\ et l'étiquette vers l'unité de disque B.

ARJ affichera toutes les étiquettes dépassant 8 caractères avec un point «.» comme un nom de fichier DOS normal.

Cependant, ARJ ne restaurera PAS ce point supplémentaire lors de l'extraction.

ARJ créera uniquement des étiquettes de volume DOS standard en majuscules.

Les étiquettes de volume créées par des utilitaires autres que les commandes DOS standard comme :

• LABEL ;
• FORMAT ;

peuvent provoquer des problèmes d'accès aux étiquettes pour ARJ.

Par exemple, l'utilitaire :

de Norton peut créer des étiquettes contenant des lettres minuscules.

Vous devrez utiliser :

afin de supprimer ces étiquettes pour permettre à ARJ de définir une nouvelle étiquette.

Les programmes supprimant des étiquettes inhabituelles doivent :

• soit effectuer des écritures directes absolues sur le disque ;
• soit utiliser une suppression générique *.*

des fichiers possédant l'attribut d'étiquette dans le répertoire racine.

Une simple corruption d'un bit dans le programme peut entraîner la suppression de TOUS les fichiers du répertoire racine.

ARJ préfère actuellement ne pas prendre ce risque.

L'option -# permet à l'utilisateur de sélectionner des fichiers dans une archive selon leur numéro d'ordre dans l'archive.

Par exemple, le numéro :

sélectionne le premier fichier de l'archive.

Cette option est utile pour sélectionner des fichiers lorsqu'il existe des doublons dans l'archive.

Elle est également utile pour les utilitaires de traitement par lots nécessitant l'extraction séquentielle de fichiers depuis une archive afin de les traiter.

Les programmes de menus d'archives devraient trouver cette option particulièrement utile pour gérer les archives contenant des noms de fichiers dupliqués.

Vous pouvez spécifier une série de fichiers en utilisant une syntaxe du type :

Aucun espace interne n'est autorisé.

Exemple :

Veuillez noter que le numéro d'ordre recommence à :

pour chaque archive individuelle, y compris les archives multi-volumes.

Autrement dit, le premier fichier de archive.a04 porte également le numéro 1. Ne mélangez PAS des noms de fichiers avec les numéros, sauf pour le répertoire de base.

Exemple :

a : Autoriser tous les attributs de fichiers

Par défaut, ARJ ne sélectionne pas les fichiers système ni les fichiers cachés lors de l'utilisation de caractères génériques, sauf si l'option -a est spécifiée. L'option -a1 configure ARJ afin d'ajouter tous les répertoires présents dans l'ensemble des spécifications de fichiers correspondantes à l'archive en cours de création.

Cette option sélectionne également :

• les fichiers cachés ;
• les fichiers système ;

comme le fait l'option :

Même les répertoires vides seront ajoutés.

La commande l affichera ces répertoires avec la lettre D dans la colonne T (type de fichier).

Les anciennes versions d'ARJ ignoraient les entrées correspondant à des répertoires vides.

Les modules :

• ARJSFX ;
• ARJSFXJR ;

peuvent traiter les entrées de répertoires vides.

Cette option est utile pour sauvegarder des répertoires logiciels nécessitant la conservation de répertoires vides.

b : Sauvegarder les fichiers modifiés

L'option -b sélectionne uniquement les fichiers dont le bit d'archive est activé.

Si vous utilisez l'option -b1 les fichiers possédant le bit d'archive activé seront sélectionnés et les bits d'archive de tous les fichiers archivés seront réinitialisés après la création réussie de l'archive.

Exemple :

Cette commande simule la commande DOS BACKUP.

L'option -b2 ne sélectionne PAS de fichiers. Elle configure ARJ afin de réinitialiser les bits d'archive des fichiers ajoutés.

Si les options -f ou -u sont utilisées, ARJ réinitialisera également les bits d'archive des fichiers déjà présents en double dans l'archive.

Exemple :

archive tous les fichiers de l'unité de disque C: et réinitialise tous les bits d'archive.

L'option -b3 sert à réinitialiser les bits d'archive des fichiers extraits.

Cette option est utile pour définir correctement l'état des bits d'archive afin qu'une sauvegarde incrémentielle ultérieure n'inclue pas ces fichiers extraits.

c : Ignorer la vérification des dates et heures

Normalement, avec les commandes u ou f ARJ met à jour uniquement les fichiers plus récents dans l'archive.

L'option -c configure ARJ afin de mettre à jour l'archive sans tenir compte des dates et heures de modification.

Lors de l'extraction de fichiers depuis une archive avec les options -y et -f ARJ ignore normalement les fichiers plus anciens.

L'option -c force ARJ à extraire également ces fichiers plus anciens.

d : Avec suppression (déplacement)

Cette option fournit le comportement standard de la commande MOVE.

Les fichiers ajoutés avec succès seront supprimés.

Lorsqu'elle est utilisée avec les options -f ou -u ARJ supprimera également les fichiers déjà présents en double dans l'archive.

ARJ demandera une confirmation avant la suppression des fichiers, sauf si l'option -y est spécifiée.

Vous pouvez également utiliser la commande m ne demandant aucune confirmation avant la suppression des fichiers.

À partir d'ARJ 2.30, lorsque l'option -a1 est utilisée afin de sélectionner des répertoires, ARJ supprimera également les répertoires sélectionnés.

La commande :

équivaut à :

et également à :

Les commandes :

acceptent désormais l'option -d afin de fournir une fonction d'extraction suivie de suppression.

Cette fonctionnalité exige que vous spécifiiez explicitement les fichiers à extraire et supprimer.

Exemple :

e : Exclure les chemins des noms de fichiers

Par défaut, ARJ enregistre toujours le chemin complet du fichier archivé.

Cette option configure ARJ afin de stocker uniquement le nom du fichier.

L'option -e1 configure ARJ afin de NE PAS enregistrer le nom du répertoire de base avec les noms de fichiers dans l'archive.

Exemple :

Dans cet exemple, ARJ n'enregistrera pas C:\SOFTWARE\ARJ\ comme partie des noms de fichiers.

Mise à jour des fichiers dans une archive

Lors de la mise à jour des fichiers d'une archive, ARJ utilise le chemin complet afin d'effectuer la correspondance avec les noms complets des fichiers sélectionnés.

Les options -e et -e1 modifient cette correspondance exacte.

Si l'option -e est spécifiée, seules les spécifications de fichiers des fichiers sélectionnés seront comparées aux chemins complets des fichiers contenus dans l'archive.

Si l'option -e1 est spécifiée, le chemin complet des fichiers sélectionnés - excluant le répertoire de base - sera utilisé pour effectuer la correspondance avec le chemin complet des fichiers présents dans l'archive.

Autrement dit, ARJ ne mettra à jour un fichier dans une archive que si le nom du nouveau fichier, tel qu'il serait enregistré dans l'archive, est identique au nom du fichier original déjà entreposé dans cette archive.

f : Actualiser les fichiers existants

Cette option, utilisée avec les commandes e ou x configure ARJ afin d'extraire uniquement les fichiers plus récents depuis l'archive.

Cette option, utilisée avec la commande m configure ARJ afin de mettre à jour uniquement les fichiers source dont la date est plus récente que celle des fichiers présents dans l'archive.

Une fois l'archive mise à jour :

• tous les fichiers sélectionnés ayant été mis à jour ;
• ainsi que tous les fichiers sélectionnés déjà à jour ;

seront supprimés.

La commande :

est très similaire à la commande :

g : Chiffrer avec un mot de passe

Cette option, suivie d'un mot de passe sous la forme :

permet de chiffrer ou déchiffrer un fichier archivé.

Lors d'une commande l ou v un fichier chiffré affichera la lettre G après le numéro de méthode de compression.

Exemple :

Si l'option -g est suivie d'un point d'interrogation «?» ARJ demandera le mot de passe à l'utilisateur sans afficher les caractères saisis à l'écran.

La touche Backspace peut être utilisée afin d'effacer des caractères.

Exemple :

L'utilisation d'un mauvais mot de passe lors de l'extraction provoquera un message d'erreur du type :

i : Sans indicateur de progression

Cette option désactive l'affichage de l'indicateur de progression en pourcentage.

L'indicateur de progression apparaît pendant :

• les opérations d'ajout ;
• les opérations d'extraction ;
• les recherches ;
• les tests.

L'option -i1 fournit un indicateur de progression graphique de type barre pour les commandes de :

• compression ;
• extraction ;
• test ;

d'ARJ.

Cela constitue une alternative à l'indicateur numérique classique de progression en pourcentage croissant.

L'option -i2 fournit un affichage combinant :

• un pourcentage ;
• et une barre de progression graphique.

j : Sélectionner un ensemble alternatif de caractères d'options

Cette option inverse l'ensemble des caractères d'options utilisés.

L'inversion est réinitialisée à la fin de chaque séquence distincte d'options afin de revenir à l'ensemble principal des caractères d'options.

Par exemple :

n'effectue pas la même fonction que :

Cependant :

équivaut à :

en raison du double basculement.

De plus :

n'est PAS équivalent à :

La séquence d'options :

équivaut à :

k : Conserver une copie .BAK de l'archive ARJ

Cette option crée une copie de sauvegarde .BAK de l'archive originale lors d'une mise à jour.

L'archive originale recevra l'extension .BAK.

Tout fichier .BAK déjà existant sera écrasé.

Cette fonctionnalité n'a aucun lien avec les archives ARJ de type sauvegarde (backup type archives).

l : Créer un fichier de liste (List_name)

Cette option configure ARJ afin d'écrire dans le fichier spécifié après l'option -l tous les noms de fichiers qui seront traités par cette commande ARJ.

Pour les commandes de type ajout, cette liste contient tous les fichiers correspondant aux modèles génériques spécifiés sur la ligne de commande.

Pour les autres commandes, le fichier contiendra uniquement :

• les noms de fichiers originaux ;
• et/ou les noms génériques.

Les autres options n'affectent PAS la génération des noms de fichiers dans ce fichier de liste.

Si vous souhaitez créer un fichier d'index destiné aux sauvegardes, utilisez plutôt l'option -ji.

Ce fichier de liste peut ensuite être utilisé comme fichier de liste sur la ligne de commande.

Exemple :

Cet exemple créera un fichier nommé name.lst contenant tous les fichiers *.exe.

m : Utiliser les méthodes 0, 1, 2, 3 ou 4

Méthodes de compression :

Exemple :

L'option -jm améliore généralement le taux de compression des méthodes 1 et 2 au prix :

• d'une vitesse plus faible ;
• et d'une consommation mémoire plus élevée.

Le comportement de -jm avec les méthodes -m3 et -m4 est INDÉFINI.

La méthode 4 utilise un décodeur différent des méthodes 1 et 2.

La méthode 4 est presque deux fois plus rapide que la méthode 1.

Lors de l'extraction, ARJ utilise moins de mémoire que pendant la compression.

n : Uniquement les nouveaux fichiers (non existants)

Avec les commandes e ou x cette option extrait uniquement les fichiers qui n'existent pas déjà dans le répertoire cible.

Avec les commandes a ou m cette option archive uniquement les fichiers qui n'existent pas déjà dans l'archive cible.

o : À partir de la date YYMMDDHHMMSS

L'option -o utilisée seule signifie : sélectionner les fichiers modifiés aujourd'hui.

Si l'option -o est suivie d'une date et éventuellement d'une heure, ARJ sélectionnera uniquement les fichiers modifiés à cette date ou après celle-ci.

Exemple :

signifie : sélectionner les fichiers modifiés le 2 janvier 1990 à 17 h 00 ou après.

Les années inférieures à 80 seront considérées comme appartenant au XXIe siècle.

Il n'existe aucune option permettant d'utiliser d'autres formats de date et d'heure.

L'option -ob sélectionne les fichiers modifiés avant aujourd'hui.

Si -ob est suivi d'une date et éventuellement d'une heure, ARJ sélectionnera uniquement les fichiers modifiés avant cette date et heure.

ARJ accepte désormais l'utilisation simultanée des options -o et/ou -ob afin de spécifier une plage de dates à sélectionner.

Cette fonctionnalité est utile pour sélectionner des fichiers modifiés à une date précise.

Exemple :

Les options -o et/ou -ob utilisées sans date utilisent par défaut la date du jour à minuit 0000.

L'option -od configure ARJ afin de sélectionner les fichiers n'étant pas plus anciens que le nombre de jours spécifié.

Le calcul des jours est effectué à partir de minuit.

Exemples :

sélectionne les fichiers modifiés aujourd'hui.

sélectionne les fichiers modifiés hier et aujourd'hui.

p : Correspondance utilisant les chemins complets

Lorsque l'option -p est spécifiée, ARJ recherche une correspondance exacte du chemin d'accès.

Ce comportement peut être modifié avec l'option -e.

Pour les commandes autres que les commandes de mise à jour, ainsi que pour les noms de fichiers spécifiés avec des chemins, ARJ effectuera une correspondance sur le chemin complet avec ou sans l'option -p.

Correspondance de répertoires contenant des sous-répertoires

Pour effectuer une correspondance avec des chemins de répertoires contenant eux-mêmes des sous-répertoires, vous devriez utiliser l'option :

Cette option configure ARJ afin de comparer uniquement la partie initiale des chemins avec les noms génériques spécifiés.

Par exemple, si votre archive contient le répertoire TC du compilateur TURBOC++, et que vous souhaitez extraire le sous-répertoire INCLUDE ainsi que le sous-répertoire INCLUDE\SYS vous pouvez utiliser la commande suivante :

Si vous souhaitez extraire tous les fichiers INCLUDE\S*.* y compris le contenu du sous-répertoire SYS vous pouvez utiliser la commande suivante :

q : Demander confirmation pour chaque fichier

Cette option configure ARJ afin de demander une confirmation à l'utilisateur avant d'agir sur chaque fichier archivé pour toutes les commandes, sauf j, l, t, v et w. Cela permet de sélectionner manuellement les fichiers à :

• supprimer ;
• ajouter ;
• ou traiter de toute autre manière.

r : Parcourir récursivement les sous-répertoires

Cette option configure ARJ afin d'explorer récursivement tous les sous-répertoires pour les caractères génériques spécifiés sur la ligne de commande, y compris les noms d'archives ARJ.

ARJ parcourra tous les sous-répertoires afin de rechercher les fichiers correspondants.

ARJ effectuera également une recherche récursive pour les noms de fichiers sans caractères génériques, comme dans l'exemple suivant :

s : Définir l'horodatage de l'archive

Cette option configure ARJ afin de définir la date et l'heure de l'archive à celles du fichier le plus récent contenu dans l'archive.

Cette option fonctionne également avec des commandes autres que les commandes de mise à jour, comme dans l'exemple suivant :

L'option -s1 permet de conserver l'horodatage original de l'archive.

La nouvelle archive possédera ainsi la même date et heure que l'archive originale.

L'option -s2 fonctionne comme l'option -s mais uniquement pour les commandes modifiant une archive.

Cela la rend plus appropriée pour une utilisation dans la variable d'environnement ARJ_SW.

t : Définir le type de fichier

Cette option configure ARJ afin d'ouvrir et de lire le fichier à archiver en mode binaire ou en mode texte.

Le mode par défaut est le mode binaire :

Pour archiver en mode texte, utilisez l'option :

L'option :

équivaut à :

Si vous spécifiez :

ARJ utilisera toujours le mode binaire, même lors de l'actualisation de fichiers texte déjà présents dans l'archive.

Le type de fichier texte est principalement destiné aux futurs transferts multiplateformes des archives ARJ.

Il permet à ARJ d'extraire les fichiers texte avec la séquence de fin de ligne appropriée au système d'exploitation cible.

Cependant, ce mode peut également produire un taux de compression légèrement supérieur.

L'option -t1 combinée avec -jh65000 peut produire certains des meilleurs taux de compression.

L'extraction de fichiers compressés en mode texte est plus lente que celle des fichiers binaires.

Vous ne devriez PAS utiliser -t1 lors d'un archivage en mode multi-volumes.

AVERTISSEMENT

N'utilisez PAS le mode texte sur des fichiers non textuels.

Sur des fichiers non textuels, ARJ arrêtera prématurément la lecture s'il rencontre un caractère EOF intégré Ctrl+Z.

Cela provoquera une PERTE de données sur les fichiers binaires.

À partir d'ARJ 2.30 et d'UNARJ 2.30, ARJ extrait les données compressées en mode texte au format 8 bits lorsqu'elles sont restaurées sur la même plateforme d'origine.

Ce n'est que lors d'une extraction vers une plateforme différente que le texte 8 bits sera converti en texte 7 bits.

Détection automatique du mode texte

En mode texte -t1 ARJ analyse les 4096 premiers octets du fichier d'entrée afin de rechercher des caractères non textuels.

En mode texte avec graphiques -t1g ARJ vérifie les 4096 premiers octets afin de détecter un nombre excessif de valeurs supérieures à 7Fh.

Si ARJ détecte l'une de ces situations, il reviendra automatiquement au mode binaire -t0 pour ce fichier particulier.

De plus, à la fin de la compression du fichier, si ARJ constate que la taille du fichier compressé n'est pas inférieure à 80 % de la taille binaire originale (taille disque), ARJ recommencera l'archivage en mode binaire.

Cela aide à éviter la compression accidentelle de fichiers exécutables avec -t1 qui provoquerait une perte de données.

Ces tests ne sont toutefois pas infaillibles.

Taille des fichiers en mode texte

La taille originale affichée par les commandes l ou v correspond au nombre réel d'octets lus lors de la compression en mode texte.

Cette taille correspond généralement à :

• la taille MS-DOS du fichier ;
• moins le nombre de retours chariot.

En effet, le mode texte du langage C supprime les caractères de retour chariot.

Des problèmes peuvent apparaître avec la taille des fichiers, car la compression en mode texte peut être destructive (lossy) certains caractères inutiles peuvent être supprimés. Cela peut provoquer des problèmes avec certains programmes de conversion d'archives vérifiant les tailles de fichiers.

Définition du type par extension

L'option -t a été modifiée afin de permettre la définition du type de fichier selon son extension, de manière similaire à l'option «-js».

Si vous souhaitez définir les fichiers :

• .ASM
• .C

comme fichiers texte, utilisez :

Exemples :

Si vous souhaitez spécifier des types binaires par extension, vous devez d'abord définir le type par défaut en mode texte puis spécifier les extensions binaires, car le type par défaut est normalement binaire.

Exemple :

Forcer le mode texte

En raison de la manière dont ARJ vérifie les fichiers en mode texte, certains véritables fichiers texte peuvent échouer au test.

Dans ce cas, vous pouvez utiliser le modificateur f afin de forcer le mode texte.

Ce modificateur peut être combiné avec l'option de suffixe -t1.

Le modificateur f doit suivre le modificateur g s'il est utilisé.

Exemples :

Conversion de fichiers texte UNIX vers MS-DOS

Une utilisation intéressante de l'option -t1 consiste à convertir des fichiers texte UNIX en fichiers texte MS-DOS.

Si vous avez extrait des fichiers depuis une archive ZOO 2.10 et que vous devez convertir les sauts de ligne UNIX en séquences :

• retour chariot ;
• saut de ligne ;

vous pouvez utiliser les commandes suivantes :

u : Mettre à jour les fichiers (nouveaux et plus récents)

Cette option, utilisée avec les commandes e ou x configure ARJ afin d'extraire :

• les fichiers plus récents ;
• ainsi que les fichiers inexistants.

Cette option, utilisée avec la commande m configure ARJ afin :

• de mettre à jour uniquement les fichiers source possédant une date plus récente que celle des fichiers présents dans l'archive ;
• et d'ajouter les nouveaux fichiers à l'archive.

Une fois l'archive mise à jour :

• tous les fichiers ajoutés ;
• tous les fichiers sélectionnés ayant été mis à jour ;
• ainsi que tous les fichiers sélectionnés déjà à jour ;

seront supprimés.

v : Activer le mode multi-volumes

Cette option est nécessaire afin de placer ARJ en mode multi-volumes.

Cette option permet la création de plusieurs volumes lors des opérations d'ajout.

La commande :

permet de sauvegarder tous les fichiers modifiés depuis la dernière sauvegarde sur plusieurs disquettes.

ARJ effectuera une pause entre chaque volume afin de permettre le changement de disquette.

Les volumes suivants recevront automatiquement les extensions :

• .A01 ;
• .A02 ;
• .A03 ;
• ... ;
• .A99 ;
• .A00 ;
• .A01 ;
• etc.

Vous pouvez commencer la série à .A01 en spécifiant le nom complet de l'archive de départ, par exemple :

Vérification du changement de disquette

Après la pause destinée au changement de disquette, ARJ vérifie que la disquette a bien été remplacée.

Cependant, cette vérification est limitée à 3 tentatives pour le même volume.

Numérotation des volumes

ARJ crée normalement des volumes jusqu'à .A99 ce qui correspond à 100 volumes uniques.

Ensuite, la numérotation recommence à .A00.

Si le nom de l'archive se termine par .000 ARJ créera des volumes jusqu'à .999 ce qui permet jusqu'à 1000 volumes uniques.

Vous pouvez également commencer la série à .001.

Exemple :

Fractionnement des fichiers

Les fichiers archivés peuvent être répartis sur plusieurs volumes.

ARJ tentera de remplir chaque volume à environ :

• 200 à 1000 octets près ;
• de la taille maximale spécifiée.

Le modificateur w indique à ARJ de NE PAS fractionner les fichiers entre plusieurs volumes, sauf dans un cas :

• lorsque le fichier archivé ne peut pas tenir dans un seul volume complet.

Cette fonctionnalité n'optimise pas l'espace disque.

Avec cette option, un volume peut contenir seulement 100 octets ou moins.

Avantages du mode «w»

Les volumes créés avec le modificateur w peuvent être mis à jour avec la commande f et d'autres commandes ne rajoutant pas de nouveaux fichiers.

Vous pouvez ajouter des fichiers à ces volumes uniquement si vous ne limitez PAS la taille du volume.

Extraction multi-volumes

La commande :

restaure les fichiers à partir de arjvol.arj

Vous devez spécifier le nom complet du volume ARJ, y compris le suffixe .Ann si vous commencez au milieu d'une série de volumes ou si la série débute par :

• .A01 ;
• .000 ;
• etc.

Suppression des invites

Vous pouvez désactiver l'invite du volume suivant avec l'option -jyv.

Lorsque les volumes ARJ se trouvent sur des supports amovibles :

• lecteurs de disquettes ;
• supports similaires ;

ARJ demandera TOUJOURS la disquette suivante, même si l'option -y est utilisée.

Sous les versions DOS antérieures à 3.0, seuls les lecteurs A ; B ; sont considérés comme amovibles.

Exemple :

Cette commande extrait les fichiers en mode multi-volumes et supprime les confirmations concernant :

• la création des répertoires ;
• l'écrasement des fichiers existants.

ARJ supposera automatiquement la réponse :

Fichiers fractionnés de taille nulle

En raison du mécanisme de fractionnement, certains fichiers fractionnés archivés peuvent avoir une taille de 0 octet.

Cela ne constitue PAS une erreur.

Commentaires d'archives

Si vous ajoutez de longs commentaires à vos archives, vous devriez en tenir compte lors du choix de la taille des volumes.

Il est conseillé de spécifier une taille de volume légèrement plus petite lors de la commande a avant l'ajout des commentaires.

Abréviations des tailles de volumes

L'option -v accepte les abréviations suivantes :

• 360 ;
• 720 ;
• 1200 ;
• 1440

Elles correspondent respectivement à :

• 362 000 octets ;
• 730 000 octets ;
• 1 213 000 octets ;
• 1 457 000 octets.

Si l'espace disque disponible est inférieur à la taille demandée, ARJ demandera une confirmation avant de continuer.

Utilisation du suffixe «K»

Vous pouvez utiliser le modificateur K comme raccourci pour 000.

Par exemple 100K signifie 100000.

Le suffixe K ne signifie PAS 1024.

Signal sonore du volume suivant

L'option -vv active un signal sonore avant le volume suivant.

Détection automatique de l'espace disque

L'option -va active la détection automatique de l'espace disque disponible.

ARJ vérifiera l'espace libre du répertoire cible et tentera d'utiliser la totalité ou la majeure partie de celui-ci.

Cette option est principalement destinée aux disquettes.

Veuillez noter que cette option détecte :

• l'espace libre ;
• mais PAS la capacité formatée réelle.

Si l'espace disponible est inférieur à 10000 octets, ARJ demandera une confirmation.

ARJ peut également fonctionner avec des disquettes formatées à des capacités supérieures à la normale, par exemple des disquettes 3,5 pouces HD formatées à 1,6 Mo.

Exemples :

Réservation d'espace disque

Le modificateur r permet de réserver de l'espace disque sur le premier volume.

Le nombre suivant r indique la quantité d'espace à réserver.

Cette option est utile pour les volumes d'installation logicielle.

Exemple :

rend le premier volume 50000 octets plus petit qu'un volume de 360K.

Exécution de commandes système

Le modificateur s permet à ARJ :

• soit d'exécuter une commande système avant chaque volume ;
• soit d'effectuer une pause pour permettre une exécution manuelle.

Cela est utile pour nettoyer les disquettes avant écriture.

Le modificateur z fonctionne comme s mais sans afficher la commande à l'écran.

Vous pouvez spécifier une commande système ou un fichier de traitement par lot après s.

Si la commande contient des espaces, toute l'option doit être placée entre guillemets.

La commande système est exécutée avant la détection automatique de l'espace disque.

Exemples :

Veuillez noter que le dernier exemple contient un espace avant le dernier guillemet.

Sans cet espace, l'analyseur interne inclurait le guillemet dans la commande DIR.

Ordre des modificateurs

Les modificateurs de -v peuvent désormais être utilisés dans n'importe quel ordre.

Les modificateurs s ou z doivent être placés en dernier, car tout texte suivant est considéré comme une commande système.

Exemples :

active :

• le bip sonore ;
• la détection automatique de taille ;
• les fichiers entiers.

active :

• le bip sonore ;
• la détection automatique ;
• l'exécution de la commande DIR.
• Archives multi-volumes autonomes

Les archives multi-volumes peuvent être utilisées comme archives autonomes pour les commandes ne modifiant pas les archives, sauf pour les fichiers fractionnés entre plusieurs volumes.

Il est recommandé d'utiliser l'option -jt avec -v afin de garantir la création correcte des volumes.

Tester les volumes après leur création peut être fastidieux.

Gestion des erreurs d'ouverture

Pendant l'utilisation des commandes sans mise à jour, ARJ n'abandonnera pas immédiatement s'il ne peut pas ouvrir le bon volume séquentiel.

ARJ signalera l'erreur puis affichera l'invite :

Cela permet de remplacer la disquette par le bon volume.

Cette fonctionnalité est désactivée si l'invite du volume suivant a été supprimée.

Sauvegardes sur disque dur

Si vous disposez d'assez d'espace libre sur disque dur, l'option -v peut faciliter les sauvegardes.

ARJ peut créer des volumes de taille disquette directement sur le disque dur afin qu'ils soient copiés ultérieurement sur disquettes.

Ainsi, même si ARJ est lent, vous pouvez lancer la sauvegarde puis copier rapidement les volumes plus tard.

Exemples :

Sauvegarde complète.

Sauvegarde incrémentielle.

Consultez les options -jn et -jx afin de voir comment récupérer une sauvegarde interrompue au milieu d'une opération.

AVERTISSEMENT

La mise à jour des archives multi-volumes avec l'option -v activée n'est PAS prise en charge et n'est PAS recommandée.

Par défaut, ARJ interdit la mise à jour des archives multi-volumes.

Vous pouvez utiliser l'option -hu afin de contourner cette protection.

Exemple :

CONSEIL

Pour déterminer à l'avance le nombre de disquettes nécessaires à l'archivage d'un ensemble de données, vous pouvez utiliser l'option s de l'option -v.

L'option s permet d'exécuter une commande DOS avant chaque volume.

Vous pouvez spécifier une commande supprimant le volume d'archive précédemment créé.

Cela vous permet d'utiliser la même disquette ou le même espace disque pour créer successivement les différents volumes.

Exemple :

w : Définir un répertoire de travail

Cette option est FORTEMENT recommandée si vous archivez directement vers des disquettes ou si vous disposez d'un espace suffisant sur un disque RAM (RAMDISK).

Par défaut, ARJ crée la nouvelle archive temporaire dans le même répertoire que l'archive originale.

En spécifiant l'option -w vous pouvez définir un répertoire de travail dans lequel l'archive temporaire sera créée.

Une fois l'archive temporaire construite, elle est copiée par-dessus l'archive originale puis supprimée.

Gestion de l'espace disque

Normalement, ARJ nécessite suffisamment d'espace disque pour :

• l'archive originale ;
• et la nouvelle archive temporaire.

L'utilisation de l'option -w permet de déplacer une partie de cette exigence d'espace disque vers un autre répertoire.

Lors de l'utilisation de -w avec l'archivage multi-volumes, ARJ vérifie l'espace disponible dans le répertoire de travail.

S'il n'y a pas assez d'espace disponible, ARJ demandera une confirmation avant de continuer.

Cette invite peut être supprimée avec les options -y ou -jyk.

Erreurs de copie

Si la copie de l'archive temporaire vers l'archive originale échoue en raison d'une erreur d'entrée/sortie (I/O error), vous devrez effectuer la copie manuellement.

Dans cette situation, ARJ ne supprimera PAS l'archive temporaire.

Si vous utilisez Ctrl+BREAK pendant le processus de copie, ARJ supprimera :

• l'archive temporaire ;
• ainsi que l'archive originale.

Exemples

Pour des raisons de performances, vous devriez toujours utiliser l'option -w lors de la création ou de la modification d'archives sur disquettes.

Il est recommandé de spécifier un répertoire de travail situé :

• sur un disque dur ;
• ou sur un disque RAM.

Exemple :

x : Exclure des noms de fichiers

Cette option est utilisée afin d'exclure des noms de fichiers ou des modèles génériques (wildnames) de la liste des fichiers à traiter.

Exemple :

Cet exemple archive tous les fichiers du répertoire soft et de ses sous-répertoires, à l'exception :

• des fichiers nommés : test
• des fichiers se terminant par : .exe
• et : .obj

Utilisation d'un fichier de liste d'exclusion

Vous pouvez également spécifier un fichier de liste d'exclusion en faisant précéder son nom par le caractère de liste :

Le fichier de liste d'exclusion doit contenir :

• un nom de fichier ;
• ou un modèle générique ;

par ligne, sans espaces au début ni à la fin.

Exemple :

Exclusion par chemin d'accès

Vous pouvez également spécifier un chemin à exclure, comme dans l'exemple suivant :

Dans cet exemple, ARJ exclura tous les fichiers du répertoire \dir mais PAS les sous-répertoires de \dir.

Exclusion complète d'un répertoire

L'option -x permet également d'exclure un chemin complet, y compris tous ses sous-répertoires.

Syntaxe :

Le caractère \ après C:\TEMP indique à ARJ que tout ce qui se trouve sous C:\TEMP\ doit être exclu.

Veuillez noter que l'exclusion d'un répertoire exige que celui-ci soit spécifié avec le même chemin relatif que celui utilisé pour les fichiers sélectionnés.

Exemple :

utilisation correcte.

utilisation INCORRECTE à cause du C:

Utilisation avec d'autres commandes

L'option -x fonctionne également avec des commandes ne modifiant pas les archives, comme :

• e (extract) ;
• l (list).

Exemples :

extrait tous les fichiers sauf les fichiers *.exe :

affiche tous les fichiers sauf les fichiers :

• *.exe
• *.obj

Un maximum de 8000 noms de fichiers ou modèles génériques peut être exclu.

Veuillez noter que l'option -x n'est pas affectée par l'option -p.

y : Répondre « Oui » à toutes les demandes

Utilisez cette option pour les traitements automatisés ou les fichiers de traitement par lot utilisant ARJ.

Cette option désactive la plupart des demandes de confirmation normalement affichées pendant l'exécution d'ARJ.

L'option -y permet notamment :

• de supprimer les confirmations d'écrasement dans les commandes e et x
• de supprimer la demande de création de nouveaux répertoires dans les commandes e et x
• de supprimer la demande d'un nouveau nom de fichier lorsqu'une opération d'ouverture échoue dans e et x
• de supprimer les pauses pendant la commande s
• de supprimer la pause du volume suivant lors de l'utilisation de -v

pour créer des volumes sur disque dur.

Limitation avec les supports amovibles : L'option -y ne supprimera PAS l'invite du volume suivant lorsque l'archive se trouve sur un périphérique amovible, par exemple un lecteur de disquettes.

Avertissement : Utilisez cette option avec prudence, particulièrement lors de l'extraction, car ARJ écrasera automatiquement les fichiers existants.

Cependant, vous pouvez utiliser l'option -n afin d'éviter tout écrasement de fichiers.

Alternative : Comme alternative, vous pouvez utiliser l'option -jy permettant de supprimer uniquement certains types spécifiques de confirmations utilisateur.

z : Fournir un fichier de commentaire pour l'archive

L'option -z a été ajoutée afin de faciliter l'ajout automatisé de commentaires aux archives ARJ avec la commande c.

Lorsque l'option -z est spécifiée, avec ou sans fichier de commentaire, ARJ traitera uniquement le commentaire principal de l'entête de l'archive et ignorera les commentaires des fichiers individuels, sauf si l'option -jz est également spécifiée.

Suppression des commentaires : Un fichier de commentaire contenant uniquement un espace vide peut être utilisé afin d'effacer les commentaires d'une archive ARJ.

Syntaxe :

Extraction du commentaire d'archive : L'option -z permet également d'extraire le commentaire principal d'une archive ARJ vers un fichier.

Cette opération extrait uniquement le commentaire principal de l'archive et NON les commentaires individuels des fichiers.

Syntaxe :

extrait uniquement le commentaire.

extrait le commentaire ainsi que les fichiers.

ja : Afficher les commentaires ANSI

Cette option permet d'afficher les séquences d'échappement ANSI sans modification.

Par défaut, les caractères d'échappement présents dans les commentaires ne sont PAS affichés.

L'affichage des commandes ANSI est désactivé par défaut en raison des risques liés aux «ANSI BOMBS».

À l'aide des commandes ANSI, il est possible de redéfinir les touches du clavier des utilisateurs utilisant certains pilotes ANSI.

Par exemple, une touche pourrait être redéfinie pour exécuter la commande suivante :

Ce type de commande pourrait provoquer la suppression automatique de fichiers.

ja1 : Empêcher l'affichage du commentaire de l'archive

L'option -ja1 supprime l'affichage du commentaire principal de l'archive.

jb : Définir une archive de type sauvegarde (Backup type)

Lorsque vous modifiez une archive avec l'option -jb, ARJ active l'indicateur de sauvegarde (backup flag) dans l'archive.

Lorsqu'un fichier est :

• ajouté ;
• mis à jour ;
• ou déplacé ;

dans une archive de type sauvegarde contenant déjà un fichier du même nom, ARJ :

• marque l'ancien fichier comme sauvegarde ;
• puis ajoute une nouvelle copie du fichier.

L'indicateur de sauvegarde reste actif jusqu'à ce qu'il soit réinitialisé avec l'option -jb1.

Occupation d'espace : Ces fichiers de sauvegarde occupent de l'espace dans l'archive.

Ils peuvent être supprimés avec la commande ARJ k.

Exemples :

Dans ce dernier exemple, ARJ active simplement le drapeau de sauvegarde.

Affichage des fichiers de sauvegarde : Par défaut, les fichiers de sauvegarde ne sont PAS sélectionnés par les commandes ARJ.

Par exemple :

n'affichera pas les fichiers marqués comme sauvegardes.

Cependant, l'option -jg permet d'inclure les fichiers de sauvegarde dans le processus de sélection.

Exemple :

affichera tous les fichiers, y compris les fichiers de sauvegarde.

Utilité : Cette option est particulièrement utile pour les sauvegardes de fichiers.

Elle permet de conserver plusieurs générations du même fichier dans une seule archive.

jb1 : Réinitialiser une archive de type sauvegarde

Cette option permet de réinitialiser le drapeau de sauvegarde (backup flag) d'une archive de type sauvegarde.

Après l'utilisation de l'option -jb1, l'ajout de fichiers dans cette archive ne provoquera plus le marquage des anciennes versions comme fichiers de sauvegarde.

Cependant, cette option ne supprime PAS les fichiers de sauvegarde déjà présents dans l'archive.

Exemples :

jb2 : Retirer le marquage d'un fichier de sauvegarde

L'option -jb2 est utilisée avec la commande y afin de retirer le marquage des fichiers identifiés comme fichiers de sauvegarde.

Veuillez noter que cette opération peut produire des fichiers dupliqués dans l'archive.

Exemples :

retire le marquage de tous les fichiers de sauvegarde.

retire le marquage de tous les fichiers *.doc :

retire le marquage du cinquième fichier de l'archive.

jb3 : Marquer un fichier comme fichier de sauvegarde

L'option -jb3 est utilisée avec la commande y afin de marquer des fichiers comme fichiers de sauvegarde.

Exemples :

marque tous les fichiers comme fichiers de sauvegarde.

marque tous les fichiers *.doc comme fichiers de sauvegarde.

marque le cinquième fichier de l'archive comme fichier de sauvegarde.

jc : Quitter après un certain nombre de fichiers

L'option -jc configure ARJ afin d'arrêter prématurément l'analyse d'une archive lorsqu'un nombre spécifié de fichiers a été extrait ; affiché ; imprimé ; ou traité.

Si aucun nombre n'est spécifié, ARJ utilisera automatiquement : le nombre d'arguments de fichiers présents sur la ligne de commande.

Exemples :

Dans cet exemple, ARJ s'arrêtera après le traitement des trois fichiers spécifiés.

Dans cet exemple, ARJ quittera après avoir traité 5 fichiers correspondant au motif *.bat

Remarque : Le modèle générique *.* est considéré comme UN seul argument.

Limitation : Cette option ne fonctionne PAS lors de la modification d'une archive.

jd : Garantir un espace disque libre

En mode extraction, cette option configure ARJ afin de toujours conserver une quantité minimale d'espace disque libre spécifiée par l'utilisateur.

ARJ ignorera les fichiers dont l'extraction ferait dépasser la limite d'espace disque disponible.

Chaque fichier ignoré sera comptabilisé comme une erreur.

Par défaut, l'espace libre minimal est fixé à 0 octet.

Exemple :

Dans cet exemple, ARJ n'extraira aucun fichier qui ferait descendre l'espace disque libre sous 100000 octets.

Le suffixe K est un synonyme de 000.

Par exemple 100K signifie 100000.

Utilisation avec les commandes «l» et «v» en mode :

• l (list) ;
• v (verbose list) ;

cette option effectue une vérification à la fin de l'affichage en se basant sur la taille totale originale des fichiers sélectionnés.

Si la taille totale dépasse la limite d'espace libre spécifiée par l'utilisateur, ARJ signalera une erreur à la fin de l'affichage.

Exemple :

Dans cet exemple, ARJ signalera une erreur si : l'espace disque actuellement disponible ; moins la taille totale des fichiers *.doc est inférieur à 10000 octets.

Exemple supplémentaire :

Dans cet exemple, ARJ ignorera l'extraction de tout fichier pouvant provoquer une erreur de disque plein (disk full error).

je : Créer une archive auto-extractible

Cette option configure ARJ afin de créer un fichier auto-extractible .EXE au lieu d'un fichier .ARJ

Le module auto-extractible ARJSFX occupe environ 15000 octets et prend en charge l'extraction avec chemins complets.

L'option -je1 crée un fichier auto-extractible plus petit.

Le module ARJSFXJR occupe environ 5800 octets.

Les deux modules prennent en charge l'affichage du commentaire de l'archive.

Le module ARJSFX propose également une demande de confirmation avant de poursuivre l'extraction.

Limitations des modules SFX : Les modules SFX ne prennent PAS en charge les archives multi-volumes.

Cela serait peu utile puisque plusieurs fichiers devraient malgré tout être distribués.

Dans ce cas, le programme DEARJ (disponible pour les utilisateurs enregistrés) constitue une solution adéquate.

DEARJ prend en charge toutes les fonctionnalités d'extraction d'ARJ, y compris :

• les archives multi-volumes.
• Licence de distribution

Veuillez noter que l'inclusion des modules :

• ARJSFX ;
• ARJSFXJR ;
• DEARJ ;
• ARJ ;

dans un produit matériel ou logiciel nécessite TOUJOURS une licence de distribution ARJ.

Compression LZEXE : Depuis ARJ 2.10, les modules exécutables SFX sont précompressés avec LZEXE.

Cela peut provoquer de faux résultats avec certains outils d'analyse EXE indiquant qu'une archive SFX ARJ est un exécutable compressé par LZEXE.

En réalité :

• seul l'entête exécutable est compressé avec LZEXE ;
• l'archive elle-même reste compressée au format ARJ.

L'entête LZEXE a été modifié afin d'éviter son extraction par des outils comme UNLZEXE.

Sinon, UNLZEXE pourrait tronquer l'archive auto-extractible ARJ.

Chaîne d'identification : Les deux modules SFX contiennent une chaîne d'identification située dans les 1000 premiers caractères de l'exécutable.

Cette chaîne est aRJsfX avec exactement cette casse.

Commandes prises en charge par ARJSFX

Syntaxe :

Commandes :

Important : ARJSFX utilise le caractère - devant toutes les commandes et options.

Cela permet l'extraction de fichiers portant des noms comme e ; l ; etc.

La commande par défaut d'ARJSFX est -x c'est-à-dire l'extraction avec chemins d'accès.

Au démarrage, l'archive auto-extractible affiche : le commentaire principal de l'archive ; puis une demande :

Cette demande peut être supprimée avec les options :

• -e
• -x
• -y

Création automatique des répertoires : Lors de l'extraction avec chemins d'accès, ARJSFX demandera l'autorisation de créer les nouveaux répertoires, sauf si -y est spécifié.

ARJSFX créera des chemins absolus ou relatifs selon les informations stockées dans l'archive.

La conservation du répertoire racine est réalisée avec -jf

Extraction sans chemins : Pour éviter l'extraction avec chemins d'accès, le créateur de l'archive doit utiliser -e afin d'exclure les chemins.

L'utilisateur peut ensuite employer -e pour extraire les fichiers dans le répertoire courant.

Restrictions supplémentaires : ARJSFX ne prend PAS en charge la méthode de compression 4.

Le module ARJSFX prend également en charge la fonctionnalité ARJ-SECURITY

Cette fonctionnalité est disponible uniquement sous licence et est destinée principalement aux développeurs logiciels.

L'option -s permet d'ignorer le test de l'enveloppe de sécurité ARJ-SECURITY.

Création directe d'un module SFX : ARJ peut créer un module auto-extractible sans archive intermédiaire.

Exemple :

Pour transformer une archive ARJ existante en module auto-extractible, utilisez la commande y.

Exemple :

Important : mode RAW

Lorsqu'un module ARJSFX est exécuté sur un système dont le périphérique CONSOLE est configuré en mode RAW.

ARJSFX interrompra l'exécution lors d'une saisie utilisateur afin d'éviter le blocage du système.

L'utilisation de -y permet d'éviter ce problème.

Exemple :

Module ARJSFXJR : Le module ARJSFXJR créé avec -je1 est une version allégée d'ARJSFX.

ARJSFXJR ne prend PAS en charge la méthode 4, le mode texte -t1, les archives chiffrées -g.

Les modules contenant des chemins d'accès seront extraits avec leurs chemins.

ARJSFXJR créera automatiquement les répertoires nécessaires.

Exemple :

Commandes prises en charge par ARJSFXJR : Syntaxe :

Vous pouvez spécifier un lecteur ; un répertoire ; ou les deux.

Cependant, vous devez terminer par \ ou :

Exemple :

extrait automatiquement dans C:\SOFT\ en mode écrasement.

Exemples supplémentaires : Créer un module SFX avec chemins absolus :

L'utilisateur n'aura qu'à taper :

pour recréer automatiquement le répertoire product sur le lecteur courant.

Créer un module SFX avec chemins relatifs :

L'utilisateur pourra recréer automatiquement le sous-répertoire product dans le répertoire courant.

Il pourra également l'extraire ailleurs avec :

Créer un module SFX avec chemins relatifs sans répertoire de base :

Cette commande recrée les fichiers et les sous-répertoires du répertoire product dans le répertoire courant.

Créer un module SFXJR sans chemins :

L'utilisateur n'aura qu'à taper :

pour extraire automatiquement tout le contenu de DISTRIB.EXE dans le répertoire courant.

jf : Conserver/utiliser le chemin complet spécifié

Normalement, ARJ supprime la lettre du lecteur ainsi que le symbole racine des chemins d'accès enregistrés.

L'option -jf désactive ce comportement.

Lors de l'extraction avec la commande x depuis une archive créée avec cette option, ARJ supprimera normalement la lettre du lecteur et le symbole racine à moins que l'option -jf ne soit spécifiée de nouveau pendant l'extraction.

L'option -jf1 supprime uniquement la lettre du lecteur mais conserve le symbole racine. Vous pouvez utiliser -jf ou -jf1 pendant l'extraction afin de forcer l'utilisation du répertoire racine.

jg : Sélectionner les fichiers de sauvegarde

L'option -jg permet d'inclure dans la sélection les fichiers d'archive marqués comme fichiers de sauvegarde par l'option -jb.

Par défaut, les fichiers de sauvegarde ne sont pas traités par les commandes ARJ, sauf les commandes k et y.

Exemples :

affiche également les fichiers de sauvegarde.

extrait de façon interactive les fichiers de sauvegarde correspondant à name.c :

supprime également les fichiers de sauvegarde de l'archive.

jh : Définir la taille du tampon Huffman

ARJ utilise par défaut un tampon Huffman statique de 16384 octets.

Cette taille de tampon est mieux adaptée à la compression des fichiers exécutables.

Anciennes versions d'ARJ : Dans ARJ 0.15 et les versions antérieures, la taille du tampon était fixée à 65500 octets.

Cette taille est plus efficace pour les fichiers texte volumineux.

Vous pouvez spécifier une taille de tampon comprise entre 2048 octets et 65535 octets.

Exemple :

Lorsque vous spécifiez une taille de tampon Huffman, ARJ utilisera cette taille pour tous les types de fichiers traités par la commande d'archivage.

ji : Définir le nom du fichier d'index

L'option -ji est utilisée afin de créer un fichier d'index contenant les noms des fichiers archivés ou les fichiers correspondant à certains critères.

Cette fonctionnalité est particulièrement utile lors de l'utilisation d'ARJ avec des archives multi-disquettes.

Le fichier d'index ne devrait PAS être créé sur la disquette elle-même si celle-ci est remplacée pendant le processus d'archivage.

Fonctionnement du fichier d'index : Si le fichier d'index existe déjà, ARJ ajoutera les nouvelles données à la suite du fichier existant.

Le fichier d'index contient trois types de lignes texte :

• Enregistrement de volume contient : la date ; l'heure ; la position de départ du fichier ; le nom de l'archive.
• Enregistrement de fichier contient uniquement le nom du fichier.
• Enregistrement de test apparaît uniquement lors d'un archivage avec -jt contient une ligne commençant par Testing suivie du nom de l'archive.

Utilisation avec les archives multi-volumes : Ces informations sont également utiles pour reprendre une archive multi-volumes utilisant -v Vous aurez besoin du nom du fichier et de la position de départ du fichier.

Événements enregistrés par -ji : L'option -ji journalise les événements suivants :

Utilité : Cette fonction de journalisation est particulièrement utile pour :

• tester des archives ;
• rechercher du texte dans des archives ;
• suivre les opérations effectuées ;
• reprendre des sauvegardes interrompues.
• Option supplémentaire

L'option -hi configure ARJ afin d'écrire davantage de détails dans le fichier d'index.

jk : Conserver l'archive temporaire en cas d'erreur

Lorsque l'option -jk est spécifiée, ARJ conservera l'archive temporaire lors d'une interruption ou d'un échec de création ou de mise à jour d'une archive.

Fonctionnement : Pendant une opération de création ou de mise à jour échouée :

• ARJ ne supprimera pas l'archive temporaire ;
• ce qui permet éventuellement de récupérer les données déjà archivées.

Lorsqu'une construction d'archive échoue, ARJ modifiera automatiquement l'archive temporaire afin de la rendre utilisable en supprimant :

• la portion endommagée ;
• ou incomplète.

Ainsi, la partie valide de l'archive pourra souvent être conservée et utilisée malgré l'échec de l'opération.

jl : Afficher uniquement les spécifications de fichiers

L'option -jl configure ARJ afin d'afficher uniquement le nom de fichier (filespec) pendant les affichages de progression.

Cette option permet :

• de simplifier l'affichage ;
• de réduire la quantité d'informations visibles à l'écran ;
• d'obtenir une sortie plus concise et plus lisible.

jm : Définir la compression maximale

L'option -jm active le mode de compression maximale.

Ce mode est utilisé avec la méthode -m1 afin d'augmenter davantage le taux de compression.

Cependant, cela peut augmenter considérablement le temps de compression.

Gain de compression : L'utilisation de :

peut offrir une amélioration de compression d'environ 1 % à 5 %.

L'option -jm1 offre une compression légèrement inférieure à -jm mais avec une vitesse plus élevée.

Selon les fichiers traités, cette différence de vitesse peut être :

• légèrement plus rapide ;
• ou beaucoup plus rapide.

Limitation : L'utilisation de -jm avec les méthodes -m2, -m3 ou -m4 n'est PAS prise en charge.

jn : Définir le nom de reprise

L'option -jn est utilisée afin de reprendre une archive multi-volumes interrompue en combinaison avec l'option -jx.

Tous les fichiers sélectionnés sont ignorés jusqu'au fichier spécifié, sans inclure ce dernier.

Exemple :

Dans cet exemple : tous les fichiers analysés avant \BIN\TREE.COM sont ignorés ; l'archivage reprendra à la position 1230 du fichier \BIN\TREE.COM

Important : Le nom exact du fichier de reprise doit être spécifié conformément :

• aux modèles génériques (wildnames) ;
• ou aux spécifications de fichiers (filespecs) ;

utilisés dans la commande.

Ce nom correspond exactement :

• au nom affiché pendant :
• l'ajout des fichiers ;

ainsi qu'au nom inscrit dans le fichier d'index -ji

Veuillez noter que \DOS\TREE.COM n'est PAS considéré identique à DOS\TREE.COM avec cette option.

Fonctionnalité ajoutée dans ARJ 2.39 : Depuis ARJ 2.39, ARJ peut automatiquement analyser le fichier d'index précédemment créé avec -ji afin de récupérer les informations nécessaires à la reprise.

Il suffit alors d'ajouter -jn à la ligne de commande originale de sauvegarde.

Cette fonctionnalité ne fonctionne PAS sans fichier d'index.

ARJ définira automatiquement le nom correct du volume ainsi que les informations nécessaires à la reprise.

Exemple :

jo : Demander confirmation lors de la mise à jour d'un fichier d'archive

L'option -jo possède deux variantes de fonctionnement.

Utilisation avec les commandes « a » et « m » : L'option -jo est utilisée avec les commandes ARJ a ou m afin de demander une confirmation avant de remplacer un fichier déjà présent dans l'archive.

Avant qu'ARJ n'écrase un fichier interne existant dans l'archive, ARJ affichera la question :

Sans cette option, ARJ remplacera automatiquement le fichier de l'archive sans demander de confirmation.

jo : Extraire vers des noms de sortie uniques

Pendant une extraction, l'option -jo permet la gestion automatique des fichiers portant des noms identiques.

Si le fichier de sortie existe déjà dans le répertoire cible, ARJ tentera de générer automatiquement un nom unique en modifiant l'extension du fichier avec un numéro à trois chiffres allant de .000 à .999.

Si ARJ ne parvient pas à générer un nom unique, le fichier ne sera pas extrait.

jp : Pause après chaque écran

Cette option configure ARJ afin d'effectuer une pause après l'affichage de chaque écran de données pour les commandes l, p, v, w.

L'utilisateur doit appuyer sur la touche ENTER pour poursuivre l'affichage.

Il est également possible de saisir :

afin de quitter ARJ.

Cas particulier : Dans le cas spécial :

l'utilisation de -jp désactive les pauses par page, car en mode aide :

• les pauses sont activées par défaut.
• Définition de la taille des pages

Vous pouvez spécifier la taille des pages avec -jp50

Dans cet exemple chaque page affichera 50 lignes et le mode pause sera automatiquement activé.

Utilisation avec ARJ_SW : Si vous souhaitez utiliser cette option dans la variable d'environnement ARJ_SW il est recommandé d'utiliser :

afin de définir la taille des pages à 50 lignes tout en désactivant le mode pause.

jq : Définir un paramètre de chaîne

L'option -jq est utilisée afin de fournir des paramètres supplémentaires aux commandes ARJ w et b.

Si les paramètres contiennent des espaces, l'ensemble de l'option -jq doit être placé entre guillemets doubles.

Exemple général :

Consultez la documentation des commandes w et b afin d'obtenir la syntaxe exacte de l'option -jq.

jr : Récupérer des fichiers d'archive endommagés

Cette option est utilisée afin d'accéder :

• aux en-têtes ;
• et aux fichiers ;

contenus dans une archive corrompue par :

• des données invalides ;
• ou des données manquantes.

L'option -jr permet à ARJ de rechercher le prochain en-tête valide afin de poursuivre :

• l'affichage ;
• l'extraction ;
• ou le test de l'archive.

ARJ continuera à rechercher des entêtes valides jusqu'à ce qu'il atteigne la marque de fin d'archive.

Si l'archive est endommagée, ARJ peut afficher un message indiquant qu'une fin de fichier inattendue a été rencontrée.

Extraction malgré les erreurs CRC : Cette option permet également l'extraction des fichiers contenant :

• des erreurs CRC ;
• ou des erreurs : Bad file data

Normalement, ARJ supprime automatiquement ces fichiers extraits endommagés.

Limitation : Si les données de l'entête du fichier sont corrompues, ARJ ne pourra pas récupérer les données associées à cet en-tête.

Depuis ARJ 2.30, les erreurs :

n'interrompent plus le processus de récupération.

Exemple :

La variante -jr1 permet le traitement des archives ARJ endommagées contenant une marque de fin d'archive située au milieu de l'archive.

Cependant, l'utilisation de cette option provoquera toujours l'affichage d'un message :

ainsi qu'un code d'erreur (errorlevel) non nul.

js : Entreposer les archives selon leur extension

Cette option configure ARJ afin d'entreposer les fichiers sans les compresser lorsque leurs extensions sont : .ARJ, .ZIP, .LZH, .PAK, .ARC

Définition personnalisée des extensions : Les extensions de fichiers peuvent être spécifiées manuellement.

Exemple :

Dans cet exemple, ARJ entreposera sans compression les fichiers ayant les extensions .ZOO, .ICE, .GIF

Cette configuration remplace les extensions par défaut.

Utilisation avec la variable d'environnement ARJ_SW : Vous pouvez définir vos propres extensions par défaut à l'aide de la variable d'environnement ARJ_SW

Exemple :

Dans cet exemple : les fichiers .ARJ, .ZIP, .LZH seront entreposés sans compression ; tandis que -js- désactive l'option par défaut.

Ainsi, lorsque vous utiliserez -js sur la ligne de commande, ARJ connaîtra déjà les extensions devant être entreposées sans compression.

jt : Tester l'archive temporaire

L'option -jt permet de configurer ARJ afin d'effectuer une vérification d'intégrité de l'archive temporaire intermédiaire avant d'écraser une archive originale déjà existante.

Si une erreur survient ARJ n'écrasera PAS l'archive originale.

Lorsque cette option est utilisée avec -w, ARJ testera également l'archive finale ainsi que l'archive temporaire avant de supprimer les fichiers d'entrée.

Exemple :

Vérification avant extraction : L'option -jt peut aussi être utilisée avec les commandes d'extraction afin de vérifier l'intégrité de l'archive avant toute extraction.

Si la vérification échoue, l'extraction ne sera PAS effectuée.

Cette fonctionnalité est particulièrement utile pour les paquets de courrier électronique (MAIL packets) où les corruptions d'archives causées par des transferts défectueux sont fréquentes.

Exemple :

L'option -jt1 effectue la vérification CRC habituelle ainsi qu'une comparaison réelle du contenu des fichiers.

Cette option peut également être utilisée avec la commande t.

Fonctionnement avec la commande « t »&nbnsp;: Avec :

ARJ utilisera le répertoire de base ainsi que le nom enregistré dans l'archive afin de localiser le fichier original.

Fonctionnement avec les commandes d'ajout/mise à jour : Avec les commandes :

• ajout ;
• déplacement ;
• mise à jour ;

ARJ utilisera uniquement :

• le nom enregistré dans l'archive ;
• afin de retrouver le fichier original.

Par conséquent, l'option -jt1 ne fonctionne PAS avec -e ou lorsque le nom original contient :

• une lettre de lecteur ;
• ou un répertoire racine ;

sans utilisation de -jf

Exemples :

L'option -jt2 offre les mêmes fonctionnalités que -jt1 mais les comparaisons de fichiers ne sont effectuées que pour les fichiers nouvellement ajoutés ou mis à jour.

Cela évite les problèmes lorsque certains fichiers originaux ont disparu ou ont été modifiés.

Remarque importante : Un problème peut survenir avec les commandes f ou u lorsque les fichiers présents dans l'archive sont PLUS RÉCENTS que ceux ajoutés.

Dans ce cas, ARJ considérera le fichier comme déjà à jour et effectuera malgré tout une comparaison de fichiers.

Exemple :

ju : Traduire les chemins de style UNIX

Cette option configure ARJ afin de convertir tous les chemins rencontrés ultérieurement du format UNIX vers le format MS-DOS.

L'option -ju effectue également la conversion des noms de fichiers saisis à la suite des invites ARJ, comme les noms de fichiers de commentaires.

Exemple :

jv : Définir l'affichage détaillé

Cette option configure ARJ afin d'afficher davantage d'informations pendant les commandes t, l, e et x.

Exemple :

Fonctionnement avec la commande «v».

L'option -jv configure la commande v afin d'afficher uniquement : les chemins d'accès des fichiers.

L'option -jv1 configure la commande v afin d'afficher les données de l'archive dans un format adapté au tri selon différents champs.

Affichage des caractères graphiques IBM : L'option -jv configure également les commandes p, s et w afin d'afficher les caractères graphiques IBM de 128 à 255.

jw : Définir le nom du fichier de sortie d'extraction

L'option -jw permet de spécifier le nom du fichier de sortie utilisé pendant l'extraction.

Il est recommandé de n'extraire qu'un seul fichier lors de l'utilisation de cette option.

Différence avec la redirection DOS : Cette option ressemble à l'utilisation de la commande p avec une redirection DOS, mais son fonctionnement diffère.

Avec la redirection DOS : toute la sortie de l'extraction est redirigée vers le fichier cible.

Avec -jw, ARJ demandera une confirmation d'écrasement pour chaque fichier extrait vers le fichier de sortie.

Cette option peut être nécessaire lors de l'envoi de données binaires vers une imprimante.

Exemple :

jx : Commencer à une position étendue

Cette option est utilisée afin de poursuivre manuellement un fichier dans une nouvelle archive.

L'option -jx est principalement destinée aux cas où une commande multi-volumes a a été interrompue.

Exemple :

Dans cet exemple le fichier manual.doc est archivé à partir de la position 100000 octets et au-delà.

Utilisation en mode extraction : En mode extraction, cette option configure ARJ afin d'extraire un fichier vers un fichier de sortie à partir d'une position de départ spécifiée.

Exemple :

Dans cet exemple le fichier file1 est extrait dans file1 à partir de la position 2000000 octets, ou à partir de la fin du fichier existant.

Équivalence avec une redirection DOS : Cette fonctionnalité est similaire à l'utilisation de la commande :

Pour reproduire ce comportement avec ARJ, il faudrait utiliser :

L'option -jx ne fonctionne PAS lors de l'ajout d'un fichier dans une archive contenant déjà un ou plusieurs fichiers.

jy : Supprimer les questions en supposant la réponse OUI

Cette option est utilisée afin de supprimer individuellement certaines demandes de confirmation affichées par ARJ.

Syntaxe :

où <flags> correspond à un ou plusieurs des caractères suivants a, c, d, k, n, o, s, v.

Pour chaque indicateur sélectionné, ARJ se comportera comme si l'utilisateur avait répondu YES à la question supprimée.

Signification des indicateurs :

Exemple

Dans cet exemple, ARJ supprimera :

• les demandes d'ajout (append) ;
• les demandes de création de répertoire ;
• ainsi que les confirmations d'écrasement.
• Utilisation séparée des options « jy »

ARJ permet de spécifier les options jy dans plusieurs groupes distincts.

Exemple :

Désactivation d'un indicateur : Vous pouvez désactiver un indicateur avec -jyr-

Fonctionnement par bascule : Comme les autres options ARJ, les options jy fonctionnent par bascule (toggle).

Exemple :

Dans ce cas, l'option est activée puis désactivée.

jz : Fournir un fichier pour les commentaires de fichiers

L'option -jz a été ajoutée afin de faciliter l'ajout automatisé de commentaires à un ou plusieurs fichiers contenus dans une archive ARJ.

Un seul fichier de commentaires peut être spécifié.

Ce fichier sera utilisé pour commenter chaque fichier indiqué sur la ligne de commande.

Suppression des commentaires : Un fichier de commentaires contenant uniquement; un seul espace ; peut être utilisé afin d'effacer les commentaires présents dans une archive ARJ.

Syntaxe :

Dans le second exemple -zheader.cmt définit le commentaire de l'en-tête de l'archive tandis que -jzfile.cmt définit le commentaire associé aux fichiers sélectionnés.

ha : Ignorer l'attribut lecture seule

L'option -ha configure ARJ afin de réinitialiser les attributs d'un fichier devant être : écrasé ; ou supprimé.

Cela permet : l'écrasement ; ou la suppression ; même si le fichier possède l'attribut : lecture seule.

L'utilisation de cette option peut entraîner : une légère diminution des performances.

Exemples :

hc : Exécuter une commande DOS au démarrage d'ARJ

L'option -hc configure ARJ afin d'exécuter une commande DOS :

• immédiatement après le traitement des options de ligne de commande ;
• mais avant le début de la recherche des fichiers génériques (wildcards).

Cette option peut être utilisée afin :

• d'effacer l'écran pour masquer la ligne de commande ;
• ou d'ajouter une pause permettant le changement de disquettes.

Exemples :

Dans cet exemple la commande DOS :

efface l'écran avant l'exécution d'ARJ.

Dans cet exemple la commande :

provoque une pause avant le traitement des fichiers.

he : Ignorer le test de l'enveloppe de sécurité

L'option -he configure ARJ afin d'ignorer l'étape de vérification lors de l'accès à une archive ARJ sécurisée (ARJ-SECURED).

Si une archive ARJ possède une enveloppe de sécurité ARJ endommagée vous devrez utiliser l'option -he afin de pouvoir extraire l'archive.

he1 : Définir une erreur sur les enveloppes de sécurité

L'option -he1 configure ARJ afin d'interrompre le traitement avec un code d'erreur 4 lorsqu'une archive potentiellement sécurisée (ARJ-SECURED) est détectée.

Cette option est particulièrement utile comme option REARJ.CFG pour ARJ.

Elle empêche :

• REARJ ;
• de convertir une archive sécurisée ARJ ;
• vers le même format ;
• ou vers un autre format.

Exemple :

hi : Affichage détaillé complet dans les fichiers d'index

L'option -hi utilisée avec -ji configure ARJ afin d'inclure dans le fichier d'index :

• la date et l'heure du fichier ;
• la taille originale du fichier ;
• la taille compressée ;
• le taux de compression ;
• ainsi que le nom du fichier.

Exemple :

hs : Désactiver le partage de fichiers

L'option -hs configure ARJ afin de désactiver sa fonctionnalité de partage de fichiers.

Cette option peut être nécessaire pour certaines applications inhabituelles ou certains environnements particuliers.

hu : Autoriser la mise à jour des archives multi-volumes

L'option -hu configure ARJ afin d'autoriser la mise à jour des archives multi-volumes.

Dans cette version d'ARJ la mise à jour des archives multi-volumes est interdite par défaut en raison du risque de perte de données.

Exemple :

hw : Modifier l'affichage des noms de fichiers pendant la recherche

L'option -hw configure la commande :

afin d'afficher les messages :

dans un format économisant le défilement de l'écran.

Les noms des fichiers ne contenant aucune correspondance de texte seront réécrits directement à l'écran.

L'option -hw1 configure la commande :

afin d'afficher les messages :

uniquement pour les fichiers contenant des correspondances de chaînes de texte.

hx : Spécifier les extensions de fichiers d'archives

L'option -hx permet à l'utilisateur de spécifier : l'extension ou les extensions que ARJ doit utiliser par défaut lorsqu'un nom d'archive est fourni sans extension.

ARJ considérera : la première extension spécifiée comme étant l'extension principale par défaut.

Exemples :

Dans cet exemple, ARJ supposera par défaut l'extension .SDN pour le fichier d'archive.

Dans cet exemple, ARJ recherchera d'abord archive.SDN puis, si ce fichier n'est pas trouvé : archive.ARJ

Options des commandes ARJ

Certaines des options suivantes possèdent plusieurs variantes, comme :

• -s
• -s1
• -s2

Les options suivantes fonctionnent avec toutes les commandes ARJ :

• !names.lst
• -o
• -ob
• -od
• --
• -+
• -&
• -!
• -i
• -l
• -r

Cette option affecte également les noms d'archives contenant des caractères génériques (wildcards).

• -s
• -x
• -y
• -ja
• -jl
• -jt
• -ju
• -jy
• -hc
• -he
• -he1
• -hs
• -hx

Les options suivantes fonctionnent avec toutes les commandes ARJ modifiant des archives ARJ :

• -k
• -s
• -w
• -z
• -jb
• -je
• -jk
• -jz
• -hu

De plus, les options suivantes fonctionnent avec les commandes ARJ :

• a
• f
• m
• u

Options compatibles :

• -a
• -b
• -m
• -r
• -t
• -jh
• -ji
• -jm
• -jn
• -js
• -hi

Les options suivantes fonctionnent avec la commande ARJ y

Options compatibles :

• -jb
• -je

Les options suivantes fonctionnent avec toutes les commandes SAUF :

• a
• f
• m
• u

Le nom de l'archive peut être une spécification générique (wildspec).

Options compatibles :

• -#
• -d
• -e
• -p
• -jg
• -jr

Les options suivantes fonctionnent avec les commandes ARJ :

• a
• f
• m
• u
• e
• x

Options compatibles :

• -$
• -c
• -f
• -g
• -n
• -u
• -jf
• -ji
• -jx
• -hi

Les options suivantes fonctionnent avec les commandes ARJ :

• e
• x

Options compatibles :

• -d
• -jc
• -jw

Les options suivantes fonctionnent avec les commandes ARJ :

• l
• v

Options compatibles :

• -n
• -jp

Les options suivantes ont une utilisation limitée :

• -q

Fonctionne avec toutes les commandes sauf :

• j
• l
• n
• o
• t
• v
• w
• y

Option :

• -v

Fonctionne avec les commandes :

• l
• v
• w

Option :

• -jc

Fonctionne avec les commandes :

• e
• x
• l
• v

Option :

• -jp

Fonctionne avec les commandes :

• l
• v
• w

Option :

• -jq

Fonctionne avec les commandes :

• b
• w

Option :

• -jv

Fonctionne avec la plupart des commandes.

Option :

• -hw

Fonctionne avec la commande :

• w

Exemples de commandes ARJ

a : Ajouter des fichiers à une archive

Créer une archive nommée archive :

Ajouter uniquement les nouveaux fichiers inexistants dans l'archive :

Mettre à jour uniquement les fichiers plus récents.

Tester l'intégrité de l'archive temporaire avant remplacement.

Effectuer une comparaison complète des fichiers en plus du test CRC.

Comparer uniquement les fichiers nouvellement ajoutés ou mis à jour.

Demander confirmation pour chaque fichier traité.

Ajouter récursivement les fichiers des sous-répertoires.

Ajouter les fichiers modifiés à partir d'une date donnée.

Ajouter les fichiers du répertoire dir\ :

Ajouter les fichiers .DOC et .EXE du répertoire dir\ :

Ajouter les fichiers listés dans names.lst :

Ajouter un fichier commençant par - dans son nom.

Ajouter plusieurs fichiers nommés explicitement.

Créer une archive multi-volumes sur A: avec un répertoire de travail E:\, détection automatique d'espace disque, archivage récursif et réinitialisation des bits d'archive :

Créer une archive multi-volumes commençant à .001 avec volumes de 360K, signal sonore, fichiers non fractionnés et sauvegarde incrémentale :

Créer une archive multi-volumes de 360K sans demandes de confirmation :

Ajouter tous les fichiers du disque C:\ avec récursivité, test complet et conservation des chemins absolus.

b : Exécuter une commande Batch ou DOS

Extraire temporairement name.txt et exécuter une commande DOS dessus.

Définir le fichier de sortie temporaire OUT.NAM

Extraire SHEZ.EXE comme fichier temporaire exécutable.

Extraire chaque fichier .EXE dans TEMP.EXE puis exécuter :

c : Commenter les fichiers d'une archive

Ajouter ou modifier les commentaires de l'archive et des fichiers.

Ajouter uniquement un commentaire d'en-tête d'archive.

Utiliser le fichier comment.txt comme commentaire d'archive.

Supprimer le commentaire de l'archive.

Ajouter le contenu de comment.txt comme commentaire au fichier file1 :

Supprimer les commentaires de tous les fichiers *.DOC

d : Supprimer des fichiers d'une archive

Supprimer tous les fichiers *.DOC de l'archive.

Supprimer tous les fichiers, y compris les fichiers marqués comme sauvegardes.

Supprimer uniquement les fichiers inexistants dans le répertoire cible.

Supprimer les fichiers sans demander de confirmation.

Supprimer les fichiers listés dans names.lst

e : Extraire des fichiers d'une archive

Extraire tous les fichiers *.DOC :

Extraire puis supprimer les fichiers *.DOC de l'archive :

Extraire les fichiers uniquement si au moins 50000 octets libres restent disponibles sur le disque :

Extraire les fichiers avec génération automatique de noms uniques en cas de doublons :

Extraire les fichiers sans tenir compte des dates de modification :

Tester l'intégrité de l'archive avant extraction des fichiers *.DOC dans : dir\ :

Extraire les fichiers *.DOC sans demandes de confirmation :

Extraire les fichiers portant les numéros 10 et 15 de 20 à 40.

f : Rafraîchir les fichiers dans l'archive

Mettre à jour les fichiers de l'archive uniquement si les fichiers sur disque sont plus récents.

Rafraîchir récursivement les fichiers dans tous les sous-répertoires.

Mettre à jour récursivement les fichiers du répertoire dir\ :

Mettre à jour récursivement tous les fichiers *.DOC du répertoire dir\ :

Rafraîchir récursivement les fichiers du répertoire dir\ avec vérification des fichiers ajoutés ou mis à jour.

g : Chiffrer les fichiers dans l'archive

Chiffrer les fichiers de l'archive avec le mot de passe password :

Chiffrer uniquement les fichiers *.DOC avec le mot de passe spécifié.

Demander le mot de passe à l'utilisateur sans l'afficher à l'écran.

i : Vérifier l'intégrité de ARJ.EXE

Vérifier l'intégrité du programme ARJ actuellement exécuté.

Vérifier l'intégrité du fichier c:\bin\arj.exe

j : Fusionner des archives dans une archive

Fusionner les archives name1.arj, name2.arj et name3.arj dans l'archive archive :

Fusionner toutes les archives *.ARJ dans une seule archive.

Convertir un module auto-extractible ARJSFX.EXE en archive ARJ classique.

Fusionner uniquement les archives modifiées à partir du 1er décembre 1991 :

Fusionner récursivement toutes les archives trouvées dans les sous-répertoires.

k : Supprimer les fichiers de sauvegarde dans une archive

Supprimer tous les fichiers marqués comme sauvegardes.

Supprimer tous les fichiers de sauvegarde sans demander de confirmation.

Supprimer uniquement les fichiers *.DOC marqués comme sauvegardes et inexistants dans le répertoire cible.

l : Lister le contenu d'une archive

Afficher le contenu complet de l'archive.

Afficher uniquement les fichiers *.DOC contenus dans l'archive.

Afficher les fichiers modifiés à partir du 1er décembre 1991 :

Afficher les fichiers modifiés après le 1er décembre 1991 et avant le 31 décembre 1991 :

Afficher uniquement les nouveaux fichiers.

Afficher également les fichiers marqués comme sauvegardes.

Faire une pause après chaque écran d'affichage.

m : Déplacer des fichiers vers une archive

Ajouter des fichiers à l'archive puis supprimer les fichiers originaux après archivage réussi.

Déplacer tous les fichiers *.DOC dans l'archive.

Déplacer les fichiers *.DOC du répertoire dir\ vers l'archive :

Déplacer les fichiers *.DOC modifiés à partir d'une date donnée.

Créer une archive multi-volumes sur A: avec récursivité, signal sonore avant changement de volume, fichiers complets non fractionnés, détection automatique d'espace disque, exécution de commande système, vérification des fichiers ajoutés ou mis à jour.

n : Renommer des fichiers dans une archive

Renommer interactivement les fichiers de l'archive.

Renommer uniquement les fichiers *.DOC ARJ n archive !names.lst.

Renommer les fichiers listés dans names.lst :

Renommer les fichiers modifiés à partir du 1er décembre 1991.

o : Réordonner les fichiers dans une archive

Réordonner les fichiers de l'archive selon l'ordre défini dans names.lst :

Placer d'abord dans l'archive les fichiers *.BAT, *.EXE, *.DOC dans cet ordre.

Réordonner explicitement les fichiers file1, file2, file3

p : Afficher les fichiers vers la sortie standard

Afficher le contenu des fichiers de l'archive vers la sortie standard.

Afficher les fichiers avec pause après chaque écran.

Afficher uniquement les fichiers *.DOC :

Afficher les fichiers modifiés à partir du 1er décembre 1991

Envoyer le contenu du fichier name.txt vers l'imprimante PRN.

r : Supprimer les chemins des noms de fichiers

Supprimer les informations de chemin des fichiers contenus dans l'archive.

Supprimer les chemins uniquement pour les fichiers *.DOC.

Supprimer les chemins des fichiers modifiés après le 1er décembre 1991 et avant le 31 décembre 1991

s : Afficher les fichiers écran par écran avec pause

Afficher le contenu des fichiers de l'archive écran par écran.

Afficher automatiquement les fichiers *.DOC sans demander de confirmation entre les écrans.

Afficher le contenu de toutes les archives *.ARJ de manière récursive sans confirmation.

t : Tester l'intégrité d'une archive

Tester l'intégrité complète de l'archive.

Tester uniquement les fichiers *.EXE contenus dans l'archive.

Tester les fichiers listés dans names.lst

Effectuer un test avancé incluant une comparaison réelle des fichiers.

u : Mettre à jour les fichiers dans une archive

Mettre à jour les fichiers *.DOC et ajouter ceux qui n'existent pas encore dans l'archive.

Mettre à jour les fichiers *.DOC avec demande de confirmation avant remplacement des fichiers existants dans l'archive.

v : Afficher en détail le contenu d'une archive

Afficher le contenu détaillé complet de l'archive.

Afficher en détail uniquement les fichiers *.DOC :

Afficher uniquement les chemins des fichiers contenus dans l'archive.

Afficher les informations de l'archive dans un format adapté au tri des données.

Faire une pause après chaque écran d'affichage.

Afficher également les fichiers marqués comme sauvegardes.

w : Rechercher des chaînes de texte dans une archive

Rechercher des chaînes de texte dans l'archive.

Afficher les recherches dans un mode économisant le défilement de l'écran.

Faire une pause après chaque écran de résultats.

Rechercher dans toutes les archives *.ARJ avec pause après chaque écran.

Rechercher dans toutes les archives *.ARJ les chaînes présentes dans les fichiers *.DOC

Effectuer une recherche insensible à la casse avec affichage de 5 lignes de contexte, recherche de la chaîne string.

Effectuer une recherche sensible à la casse avec affichage de 3 lignes de contexte, recherche du texte to be or not.

x : Extraire des fichiers avec le chemin complet

Extraire les fichiers *.DOC en conservant leurs chemins.

Extraire puis supprimer les fichiers *.DOC de l'archive.

Extraire les fichiers uniquement si 50000 octets libres restent disponibles sur le disque.

Extraire les fichiers avec génération automatique de noms uniques en cas de doublons.

Extraire les fichiers sans tenir compte des dates de modification.

Extraire les fichiers *.DOC dans dir\ :

Extraire les fichiers en conservant les chemins absolus complets.

Extraire les fichiers *.DOC sans demander confirmation pour la création des répertoires.

y : Copier une archive avec de nouvelles options

Convertir l'archive en archive auto-extractible complète.

Convertir l'archive en archive auto-extractible compacte.

Définir l'archive comme archive de type sauvegarde.

Réinitialiser le mode archive de sauvegarde.

Retirer le marquage « sauvegarde » de tous les fichiers.

Retirer le marquage « sauvegarde » des fichiers *.BAT

Enveloppe de sécurité ARJ_SECURITY

La fonctionnalité ARJ-SECURITY ENVELOPE fournit un mécanisme comparable à ceux présents dans certains autres logiciels d'archivage.

Cette fonctionnalité interdit toute modification d'une archive sécurisée ARJ (ARJ-SECURED) par ARJ, y compris l'ajout de commentaires ou toute autre altération de l'archive.

De plus, des vérifications internes supplémentaires permettent de déterminer si l'archive sécurisée a été modifiée de quelque manière que ce soit.

Cette fonctionnalité avancée, disponible en option payante supplémentaire, est destinée principalement :

• aux développeurs de logiciels ;
• distribuant leurs programmes sous forme d'archives.

Cependant, aucune garantie absolue ne peut être donnée quant à l'impossibilité de contourner ce mécanisme de sécurité.

Vérification de l'enveloppe de sécurité

Lors de l'accès à une archive sécurisée ARJ (ARJ-SECURED), ARJ affichera un message indiquant qu'il vérifie l'enveloppe de sécurité. Si l'enveloppe est endommagée, un message d'avertissement sera affiché. Si l'enveloppe est intacte, la signature ARJ-SECURITY de l'utilisateur ayant verrouillé l'archive sera affichée.

Détection d'altération ou de corruption

Si l'enveloppe de sécurité a été modifiée frauduleusement ou si l'archive a subi une corruption de données, ARJ affichera un message indiquant que l'enveloppe de sécurité est endommagée.

Les causes les plus probables sont :

• une corruption du fichier pendant la transmission ;
• ou une tentative de modification non autorisée de l'archive.

Problèmes et limitations connus d'ARJ

Sous MS-DOS 4.01, ARJ peut ne pas extraire correctement les fichiers de grande taille supérieurs à 32 Mo à partir d'archives multi-volumes.

La taille affichée par la commande :

peut être incorrecte.

Une simple commande :

corrigera la taille du fichier.

Ce problème est dû à un bogue de MS-DOS 4.01.

Microsoft fournit des correctifs pour plusieurs bogues de DOS 4.01, y compris celui-ci.

Problèmes de mémoire avec Turbo C++

En raison du fonctionnement interne de Turbo C++, ARJ peut manquer de mémoire si l'ordinateur possède :

• plusieurs milliers d'octets de variables d'environnement.
• Problème d'espace disque avec le répertoire de travail

Lorsqu'un répertoire de travail est utilisé avec -w

ARJ ne vérifie pas l'espace disque disponible avant d'écraser l'archive originale.

Il est donc important de s'assurer qu'il reste suffisamment d'espace disque avant de mettre à jour une archive avec cette option.

Bogues liés aux entêtes étendus

En raison d'un bogue dans le traitement des entêtes étendus d'archive, il est recommandé de migrer vers ARJ 2.10 ou une version supérieure dès que possible.

Ce problème n'est toutefois pas critique actuellement, car aucune version d'ARJ ne prend réellement en charge les en-têtes étendus.

Problème avec les archives chiffrées créées par ARJ 2.21

Si vous possédez des archives chiffrées -g créées avec ARJ 2.21 et que les fichiers ont été stockés sans compression avec -m0 vous pourriez devoir utiliser ARJ 2.30 afin d'extraire ces fichiers sans obtenir une erreur CRC.

Problèmes avec les TSR et touches rapides

Les programmes résidents mémoire (TSR) activés par les touches rapides (hot keys) peuvent être bloqués par ARJ pendant la saisie clavier utilisateur.

Ce comportement est lié à une «fonctionnalité» de la fonction getc() de Turbo C++.

Une solution partielle consiste à utiliser l'option -jyry afin d'activer le mode de requêtes à touche unique.

Problème similaire avec HYPERDISK

Un problème similaire survient avec HYPERDISK et les écritures différées (staged writes).

Le délai temporisé de HYPERDISK semble être bloqué pendant les saisies clavier dans ARJ, par exemple lors du message :

Cela peut provoquer une erreur lors du changement de disquette.

La solution consiste également à utiliser -jyry pour activer le mode de réponse à touche unique.

Problème avec SUPER PCKWIK 3.30

Un problème a été signalé lors de l'utilisation d'ARJ avec des lecteurs de disquettes en présence du programme de cache disque SUPER PCKWIK 3.30 avec le support avancé des disquettes /D+

Le système peut parfois se bloquer lors des lectures ou écritures sur disquette effectuées par ARJ.

Des erreurs CRC ou :

peuvent également apparaître.

La désactivation de cette fonctionnalité avec /D- semble éliminer le problème.

D'autres programmes présentent également des problèmes similaires avec cette fonctionnalité de SUPER PCKWIK.

Brève biographie de l'auteur d'ARJ

Robert Jung a grandi à Catonsville ainsi qu'à Baltimore. Il a obtenu son diplôme de l'University of Maryland en 1970. Après un court passage dans l'armée américaine, il a enseigné la chimie pendant six ans. Par la suite, il s'est orienté vers la programmation informatique, où il a travaillé comme analyste programmeur, analyste réseau, puis ingénieur logiciel principal. À la fin de l'année 1990, il développa le format d'archive ARJ, ainsi que le programme ARJ afin de répondre à un besoin personnel en matière d'archivage.

En février 1991, il publia ARJ 1.00 en tant que logiciel shareware.