Enregistrement d’un logiciel (swreg)

Comme pour les autres commandes SD-UX, vous devez, pour exécuter swreg, spécifier une série d’options, de cibles et de valeurs par défaut sous forme d’une ligne de commande, ou encore utiliser des options de commande qui “pointent vers” des fichiers contenant des cibles, des options autres que les options par défaut et d’autres variables.

La commande swreg fait uniquement appel à l’interface ligne de commande, et n’offre donc aucune interface utilisateur graphique.

Syntaxe

La syntaxe de la commande swreg est la suivante :

swreg -l niveau [-u] [-v][ -C fichier_session][-f fichier_objet]
[-S fichier_session][-t fichier_cible][-x option=valeur]
[-X fichier_objet] [objets_à_(dés)enregistrer]
[@ sélections_cibles]

Exemples

Pour créer un nouveau dépôt avec swpackage, puis l’enregistrer avec swreg :

swpackage -s psf -d /var/spool/sw
swreg -l depot /var/spool/sw

Pour désenregistrer un dépôt spécifique sur l’hôte local :

swreg -u -l depot/cdrom

Pour désenregistrer un dépôt CD-ROM monté sur /mnt/cd, tapez :

swreg -l depot -u @ /mnt/cd

Pour enregistrer le même dépôt (monté sur /mnt/cd sur l’hôte local) et le rendre accessible sur le réseau, tapez :

swreg -l depot @ /mnt/cd

(Le signe @ est facultatif sur l’hôte local.)

Options de la commande

La commande swreg supporte les options suivantes :

Option

Action

-l niveau (obligatoire)

Donne la liste de tous les objets au niveau spécifié. Un seul niveau peut être précisé. Les niveaux supportés sont les suivants :

root		Affiche le niveau racine (c’est-à-dire, tous les répertoires racines sur l’hôte).
shroot		Affiche les répertoires racines partagés sur l’hôte local.
prroot		Affiche les répertoires racines privés sur l’hôte local.
depot		Affiche les dépôts sur l’hôte local.

-u

Désenregistre le dépôt.

-v

Active la consignation en mode prolixe sur la sortie standard.

-C fichier_ session

Exécute la commande swreg et sauvegarde dans un fichier les valeurs courantes d’option et d’opérande pour une réutilisation lors d’une session ultérieure.

-f fichier_objet

Extrait une liste d’objets à partir d’un fichier pour l’enregistrement ou l’annulation de l’enregistrement.

-S fichier_ session

Exécute swreg en fonction d’une session précédente.

-t fichier_cible

Lit la liste des hôtes cible sur lesquels enregistrer le dépôt ou les objets racine du fichier_cible au lieu de (ou en plus de) ceux de la ligne de commande.

-x option=valeur

Positionne une option à la valeur spécifique. Il est possible de spécifier plusieurs options -x.

-X fichier_objet

Lit une liste d’options et de comportements dans un fichier distinct.

Opérandes de la commande

La commande swverify supporte la syntaxe standard de sélection de logiciel. Pour de plus amples détails sur la syntaxe des sélections_logiciels, voir « Opérandes des commandes ».

Les opérandes sélections_logiciels et sélection_cible sont :

Opérande		Action
`objets_à_(dés)enregistrer`
		Définit le chemin de l’objet à enregistrer ou à désenregistrer.
`sélections_cible`		Définit le chemin d’accès absolu du dépôt à traiter en utilisant la syntaxe du `hôte:chemin_d’accès`.

Modification des options et des valeurs par défaut

Outre les options de ligne de commande énumérées précédemment swreg, vous pouvez également changer plusieurs comportements et options avancées, en modifiant les valeurs contenues dans le fichier des valeurs par défaut /var/adm/sw/defaults du système tout entier.

ou dans le fichier spécifique à l’utilisateur :

$HOME/.swdefaults.

Le Tableau 4-1, « Options d’enregistrement par défaut » représente les options par défaut supportées par la commande swreg. Pour la liste complète et la description de ces valeurs par défaut, consultez l’Annexe A, « Options et mots clés par défaut ».

Tableau 4-1 Options d’enregistrement par défaut

distribution_target_directory=/var/spool/sw

level=

logfile=/var/adm/sw/swreg.log

logdetail=false

loglevel=1

log_msgid=0

objects_to_register

rpc_binding_info=ncacn_ip_tcp:2121 ncadg_ip_udp:[2121]

rpc_timeout=5

select_local=true

targets=

verbose=1

Utilisation des fichiers session

Chaque appel à la commande swreg définit une session d’enregistrement. Les options d’appel, la source d’informations, les sélections de logiciels et les hôtes cibles de cette session sont sauvegardés avant le démarrage de la tâche d’installation ou de copie. Ceci vous permet d’exécuter de nouveau la commande lorsque la session est interrompue avant la fin.

Chaque configuration de session est automatiquement sauvegardée dans le fichier : $HOME/.sw/sessions/swconfig.last. Ce fichier est écrasé à chaque appel de swreg.

Vous pouvez sauvegarder une configuration de session dans un fichier donné en exécutant swreg avec l’option -C fichier_session.

Si vous ne précisez pas de chemin particulier pour le fichier session, son emplacement par défaut sera $HOME/.sw/sessions/.

Pour exécuter à nouveau un fichier session, désignez-le comme argument de l’option -S fichier_session de swreg.

Notez que lorsque vous exécutez de nouveau un fichier session, les valeurs du fichier session ont préséance sur les valeurs du fichier des valeurs par défaut du système. De la même manière, toutes les options ou les paramètres de la ligne de commande que vous avez donnés en appelant swreg ont préséance sur les valeurs figurant dans le fichier session

Variables d’environnement

Les programmes SD sont affectés par les variables d’environnement extérieures et celles définies à l’usage des scripts de commande. Pour une description des variables d’environnement externes, voir le Chapitre 11, « Utilisation des scripts de commande ».

Enregistrement de dépôts

L’enregistrement de dépôts (et de répertoires racines) détermine quels hôtes sont disponibles pour les tâches de gestion de logiciels (c’est-à-dire quels hôtes exécutent un démon/agent). Il permet au système de contrôle d’extraire et de présenter (par le biais de swlist) la liste des dépôts ou des répertoires racines existants à partir desquels vous pouvez faire des sélections. Les informations d’enregistrement consistent en l’identificateur du dépôt ou du répertoire racine (son chemin dans le système de fichiers de l’hôte).

L’enregistrement n’est pas lié au contrôle des droits d’accès. Cette fonction relève de la sécurité (voir le Chapitre 9, « Contrôle de l’accès aux objets logiciels »).

Autorisation

Pour enregistrer un nouveau dépôt, ou encore pour enregistrer un dépôt existant ou en annuler l’enregistrement, swreg doit avoir l’autorisation de lecture (read) sur le dépôt ainsi que l’autorisation d’écriture (write) sur l’hôte. Pour annuler l’enregistrement d’un dépôt, la commande swreg doit avoir l’autorisation d’écriture (write) sur le dépôt. Pour plus de détails sur les autorisations, voir le Chapitre 9, « Contrôle de l’accès aux objets logiciels ».