Affichage des informations à partir du fichier manifeste du package

La commande pkg contents affiche le contenu de système de fichiers des packages. Sans options ou opérandes, cette commande affiche les informations sur le chemin d'accès pour tous les packages installés sur l'image actuelle. Utilisez les options de commande pour indiquer le contenu d'un package particulier à afficher. Pour affiner les résultats de la recherche, vous devez fournir un ou plusieurs noms de package. Vous pouvez utiliser des caractères génériques dans les noms de package. Placez les caractères génériques entre apostrophes afin que l'argument soit directement transmis à la commande pkg et que le shell ne le développe pas.

/usr/bin/pkg contents [-Hmr] [-a attribute=pattern ...] [-g path_or_uri ...]
    [-o attribute ...] [-s sort_key] [-t action_name ...] [pkg_fmri_pattern ...]

Les sous-commandes contents et search interrogent le contenu des packages. La commande pkg contents affiche les actions et les attributs des packages. La commande pkg search répertorie les packages qui correspondent à la requête.

L'exemple suivant montre le comportement par défaut de pkg contents. Utilisez les options pour spécifier les actions et les attributs à afficher.

$ pkg contents zip
PATH
usr
usr/bin
usr/bin/zip
usr/bin/zipcloak
usr/bin/zipnote
usr/bin/zipsplit
usr/share
usr/share/man
usr/share/man/man1
usr/share/man/man1/zip.1
usr/share/man/man1/zipcloak.1
usr/share/man/man1/zipnote.1
usr/share/man/man1/zipsplit.1

L'option -m permet d'afficher l'intégralité du fichier manifeste du package.

L'option -r affiche les versions les plus récentes disponibles, en récupérant les informations pour tous les packages qui ne sont pas actuellement installés auprès des référentiels des éditeurs configurés.

Utilisez l'option -g pour spécifier le référentiel ou l'archive de package à utiliser en tant que source de données de package pour l'opération.

Etablissement de la liste des fichiers installés par un package

Utilisez l'option -t pour spécifier le type d'actions à afficher. Vous pouvez spécifier plusieurs types dans une liste de valeurs séparées par une virgule, ou vous pouvez spécifier l'option -t plusieurs fois.

Utilisez l'option -o pour spécifier les attributs à afficher dans la sortie. Vous pouvez spécifier plusieurs attributs dans une liste de valeurs séparées par une virgule, ou vous pouvez spécifier l'option -o plusieurs fois. Pour obtenir une liste des actions et attributs de packages, reportez-vous à la page de manuel pkg(5). Dans cet exemple, le pseudo-attribut pkg.size affiche la taille du fichier ; l'action file n'a pas d'attribut size. Pour obtenir une liste des pseudo-attributs, reportez-vous à la page de manuel pkg(1).

Utilisez l'option -s pour trier les actions suivant l'attribut d'action spécifié. Par défaut, la sortie est triée suivant les chemins d'accès ou en fonction du premier attribut spécifié par l'option -o. L'option -s peut être indiquée à plusieurs reprises.

$ pkg contents -t file -o owner,group,mode,pkg.size,path -s path zip
OWNER GROUP MODE PKG.SIZE PATH
root  bin   0555   228600 usr/bin/zip
root  bin   0555   107944 usr/bin/zipcloak
root  bin   0555   101856 usr/bin/zipnote
root  bin   0555   106252 usr/bin/zipsplit
root  bin   0444    86036 usr/share/man/man1/zip.1
root  bin   0444     2548 usr/share/man/man1/zipcloak.1
root  bin   0444     2239 usr/share/man/man1/zipnote.1
root  bin   0444     1680 usr/share/man/man1/zipsplit.1

Si vous affichez le manifeste du package, vous constatez que le package zip a douze actions de fichier. Les quatre fichiers ne figurant pas dans la sortie ci-dessus sont des fichiers qui ne peuvent pas être installés dans cette image. Cette image est une architecture x86. Les fichiers destinés à l'architecture SPARC ne sont pas affichés. Pour plus d'informations sur les variantes et les facettes, reportez-vous à la section Contrôle de l'installation des composants optionnels.

Etablissement de la liste de tous les packages installables dans un package de groupe

L'interface graphique d'installation d'Oracle Solaris 11 installe le package de groupe solaris-desktop. Le programme d'installation en mode texte et le manifeste AI par défaut dans une installation automatisée installent le package de groupe solaris-large-server. Le manifeste d'installation par défaut pour les zones non globales installe le package de groupe solaris-small-server. Comme solution de rechange, vous pouvez également utiliser le package de groupe solaris-small-server pour installer un ensemble de packages plus petit sur un serveur. Vous pouvez utiliser la commande suivante pour afficher l'ensemble de packages inclus dans chaque groupe.

$ pkg contents -Hro fmri -t depend -a type=group solaris-large-server
archiver/gnu-tar
compress/bzip2
...
text/texinfo
web/wget

L'option -t correspond aux actions depend dans le package. L'option -a correspond aux actions depend de type group. L'option -o affiche uniquement l'attribut fmri de l'action de groupe depend. Notez que les packages de groupe ne précisent pas le contenu des packages tels que les fichiers, mais qu'ils spécifient les autres packages faisant partie du groupe. Reportez-vous à la section Packages IPS pour plus d'informations sur les packages de groupe.

Pour afficher également le récapitulatif de chaque package, utilisez la commande pkg list -s :

$ pkg list -Has `pkg contents -Hro fmri -t depend -a type=group solaris-large-server`
archiver/gnu-tar    GNU version of the tar archiving utility
compress/bzip2      high-quality block-sorting file compressor - utilities
compress/gzip       GNU Zip (gzip)
...
text/texinfo        Documentation system for on-line information and printed output
web/wget            wget - GTNU wget

Affichage des conditions d'octroi de licence

Cet exemple affiche tous les packages d'incorporation qui nécessitent que vous acceptiez la licence de package.

$ pkg contents -rt license -a must-accept=true \
-o must-display,license,pkg.name '*incorporation'
MUST-DISPLAY LICENSE                           PKG.NAME
true         usr/src/pkg.license_files/lic_OTN consolidation/osnet/osnet-incorporation