Paramètres d'Up ! Archive

Up ! Archive est l'outil permettant d'archiver des fichiers, des répertoires et des autres ressources telles des courriers électroniques dans un fichier binaire via exploité un système de fichiers indépendant de la plate-forme d'exploitation.

Quel que soit son mode d'invocation, Up ! Archive possède les mêmes paramètres cités dans la section suivante. La commande est, selon les plates-formes, upsarc, upsarc.exe ou upsarc.com.

Certains paramètres font référence à des fichiers ou à des chemins d'accès. En ce cas, il est possible d'employer des variables environnement dans l'expression des chemins d'accès. Exemple :

Tmp=${UPS_HOME}/demo/tmp/${UPS_USER}

D'autre part, le séparateur de répertoire est le caractère division / et les noms de fichiers ou de répertoires peuvent utiliser les partitions montées automatiquement par Up ! System.

Les paramètres sont lus successivement dans :

Les valeurs des paramètres comportant des caractères espace doivent être mises entre caractères guillemet " ou entre caractères apostrophe ' .

Pour connaître le source d'Up ! Archive, merci de se référer à la fiche Source d'Up ! Archive.

Paramètres d'exécution

Up ! Archive étant un programme Up ! Application System particulier, les paramètres de lancement de Up ! Virtual Technical Machine et celles d'exécution de Up ! Kernel s'appliquent. En revanche, la configuration de Up ! Object Management System est imposée. Elle correspond au fichier ${UPS_HOME}/ini/upssdk.ini.

Action

Action permet de spécifier l'action que l'automate d'archivage doit exécuter. Il n'y a pas de valeur par défaut et cette option est obligatoire.

Voici la liste des valeurs possibles :

ActionValeur de l'option
Création d'un nouvelle archive.Archiver
Compacte une archive par défragmentation et tronquage.Compacter
Désarchive le contenu d'une archive.Desarchiver
Liste le contenu d'une archive.Lister
Mise à jour d'une archive existante.MettreAJour
Répare la structure d'une archive.Reparer
Vérifie l'intégrité de la structure d'une archive.Verifier

Une archive porte l'extension upa.

Action=Archiver

Compression

Compression précise le mode de compression utilisé pour une nouvelle archive.

Voici la liste des valeurs possibles :

Mode de compressionValeur de l'option
Pas de compression.ModeCompressionAucun
Mode Huffman.ModeCompressionHuffman
Mode Lw.ModeCompressionLzw
Mode Rle.ModeCompressionRle

Ce paramètre n'est utilisé qu'avec l'action Archiver.

Compression=ModeCompressionLzw

Detail

Detail permet d'afficher le détail des opérations effectuées par Up ! Archive. Par défaut, le détail n'est pas affiché.

Detail=Oui

Entete

Entete permet d'afficher l'en-tête d'archivage précisant la date. Par défaut, l'en-tête n'est pas affiché.

Entete=Oui

FiltreArchive

FiltreArchive permet de spécifier :

Le filtre comporte un ou plusieurs jokers dont la sémantique est identique à l'instruction Comme.

FiltreArchive=*.upl|*.upi

MotDePasse

MotDePasse permet de spécifier le mot de passe protégeant l'archive contre la lecture ou l'écriture. Par défaut, il n'y a pas de mot de passe.

MotDePasse=tiger

NomArchive

NomArchive permet de spécifier le fichier contenant l'archive. Ce paramètre est obligatoire.

NomArchive=${UPS_HOME}/demo/tmp/${UPS_USER}/monarchive.uar

ReparerAutomatiquement

ReparerAutomatiquement permet de réparer automatiquement une archive endommagée avant son usage. Ceci est le comportement par défaut.

ReparerAutomatiquement=Non

RepertoireArchive

RepertoireArchive permet de spécifier :

L'archivage ou le désarchivage est récursif i.e. tous les fichiers correspondant au filtre sont archivés ou désarchivés.

RepertoireArchive=/tmp/archive

TracerArchive

TracerArchive permet de tracer chaque opérations sur une archive. Par défaut, il n'y a pas de trace.

Cette trace est inscrite dans le fichier ${UPS_HOME}/log/${UPS_LANGUAGE}/${UPS_APPLICATION}-upsarc-${NomArchive}-${UPS_SESSION}.log en mode mono-utilisateur ou dans le fichier ${UPS_HOME}/log/${UPS_USER}/${UPS_APPLICATION}-upsarc-${NomArchive}-${UPS_SESSION}.log en mode multi-utilisateur.

Cette trace permet de s'assurer que les opérations sur une archive sont correctes.

TracerArchive=Oui

Optimisation du cycle de vie des objets

TypeConservation possibleTaille par défaut
du segment
ArchiveUpsArcOui.2.
IArchiveOui.2.

ConserverObjets, quand le paramètre est possible, spécifie qu'au plus TailleSegment objets du type sont conservés pré-construits en anté-mémoire au lieu d'être détruits.

Quand un nouvel objet du type est demandé, il est prélevé de l'anté-moire s'il en existe un pré-construit. Cela évite de réaliser des enchaînements de destruction / libération / ... / allocation / création d'objets de ce type trop fréquents.

Par défaut, les objets ne sont pas conservés en anté-mémoire.

ConserverObjetsArchiveUpsArc=Oui
ConserverObjetsIArchive=Non

TailleSegment spécifie la taille d'un segment de mémoire dédié à un objet du type concerné en spécifiant le nombre d'objets de ce dernier par segment de mémoire. Ce nombre ne peut excéder la capacité du ramasse-miettes définie par TailleBloc*NbBlocs.

La valeur est 0 signifie que le type n'a pas ses propres buffers et que les objets du type sont alloués dans le tas commun.

TailleSegmentArchiveUpsArc=4
TailleSegmentIArchive=4

Exemple de configuration d'Up ! Archive

; -------------------------------------------------------------------
; Fichier : upsaps.ini
; Objet : Initialisation d'Up ! Virtual Technical Machine.
;
; Module : Up ! Application System.
; Auteur-Date : DUVAL Jean-Pierre - Novembre 2003.
; -------------------------------------------------------------------
; Observations
;
;
; -------------------------------------------------------------------

[UpsArc]
Action=Archiver
Compression=Oui
ConserverObjetsArchiveUpsArc=Oui
ConserverObjetsIArchive=Non
Detail=Oui
Entete=Oui
FiltreArchive=*.upl|*.upi
MotDePasse=tiger
NomArchive=${UPS_HOME}/demo/tmp/${UPS_USER}/monarchive.uar
ReparerAutomatiquement=Non
RepertoireArchive=/tmp/archive
TailleSegmentArchiveUpsArc=4
TailleSegmentIArchive=4
TracerArchive=Oui