Recherche de packages

Utilisez la commande pkg search pour rechercher des packages dont les données correspondent au modèle spécifié.

/usr/bin/pkg search [-HIaflpr] [-o attribute ...] [-s  repo_uri] query

Tout comme la commande pkg contents, la commande pkg search examine le contenu des paquets. Alors que la commande pkg contents renvoie le contenu, la commande pkg search renvoie les noms des packages qui correspondent à la requête.

Par défaut, query est interprété comme une série de termes à faire correspondre exactement, en ne tenant pas compte de la casse. Utilisez l'option -I pour spécifier une recherche qui respecte la casse. Vous pouvez utiliser les caractères génériques ? et * dans les termes de la requête. Vous pouvez utiliser des délimiteurs tels que des apostrophes ou des guillemets pour rechercher des expressions. Veillez à tenir compte du shell utilisé lorsque vous saisissez des caractères génériques, des apostrophes ou des guillemets.

Vous pouvez spécifier plusieurs termes de recherche. Par défaut, plusieurs termes sont joints par AND. Vous pouvez explicitement joindre deux termes avec OR.

Les requêtes peuvent s'exprimer sous la structure suivante :

pkg_name:action_name:index:token

Les champs manquants sont implicitement considérés comme des caractères génériques. Les champs pkg_name et token peuvent contenir des caractères génériques explicites. Les valeurs action_name et index doivent correspondre exactement. La valeur action_name correspond au nom de l'action. La valeur index correspond au nom d'un attribut de l'action. Pour consulter la liste des actions de package et des attributs, reportez-vous à la rubrique “Actions” de la page de manuel pkg(5). Certains attributs ne peuvent pas faire l'objet de recherches. Par exemple, mode est un attribut de l'action file, mais mode n'est pas une valeur valide pour index. Certaines valeurs index sont des valeurs dérivées d'autres attributs. Par exemple, index peut être basename, qui est le dernier composant de l'attribut path d'une action file ou dir. Constituent par exemple des valeurs utiles pour index les valeurs basename et path pour les actions file et dir, le type de dépendance (par exemple require ou group) pour les actions depend et driver_name et alias pour les actions de pilote.

En général, la valeur token est comparée à la valeur de l'attribut spécifié par index. Par exemple, dans l'action driver partielle suivante, alias est un nom d'attribut qui peut être spécifié pour index et pci108e peut être spécifié pour token.

driver alias=pci108e,1647 alias=pci108e,16a7

La syntaxe d'une action set est légèrement différente. Les deux attributs d'une action set sont name et value. Dans ce cas, la valeur index est la valeur de l'attribut name et la valeur token est comparée à la valeur de l'attribut value correspondant. Par exemple, dans l'action set partielle suivante, pkg.summary peut être spécifié pour index et Broadcom peut être spécifié pour token.

set name=pkg.summary value="Broadcom 57xx 1GbE NIC Driver"

pkg.fmri, info.classification, pkg.description et pkg.summary sont des exemples de valeurs d'attributs name de l'action set bien définies. Pour plus d'informations, reportez-vous à la rubrique “Set Actions” de la page de manuel pkg(5).

Par défaut, la recherche est effectuée sur les référentiels associés à tous les éditeurs configurés pour cette image. Utilisez l'option -l pour rechercher uniquement les packages installés dans cette image. Utilisez l'option -s pour spécifier l'URI du référentiel dans lequel effectuer la recherche.

Par défaut, les correspondances s'affichent uniquement pour les versions installées ou les plus récentes des packages. Utilisez l'option -f pour afficher toutes les versions correspondantes.

Par défaut, les résultats sont affichés pour toutes les actions correspondantes, ce qui signifie qu'il peut y avoir plusieurs lignes de résultats pour un package. Utilisez l'option -p pour que chaque package correspondant ne soit affiché qu'une seule fois.

Identification du package fournissant un fichier spécifique

Les exemples suivants montrent que la bibliothèque libpower provient du package system/kernel/power.

$ pkg search -Hlo pkg.name /lib/libpower.so.1
system/kernel/power
$ pkg search -lo path,pkg.name libpower.so.1
PATH              PKG.NAME
lib/libpower.so.1 system/kernel/power
$ pkg search -Hlo path,pkg.name basename:libpower.so.1
lib/libpower.so.1 system/kernel/power
$ pkg search -Hlo path,pkg.name 'path:*libpower.so.1'
lib/libpower.so.1 system/kernel/power

Affichage des services SMF fournis par les packages

Pour afficher les packages qui fournissent un service SMF particulier, effectuez une recherche en indiquant le nom du service en tant que valeur de l'attribut org.opensolaris.smf.fmri.

$ pkg search -o value,pkg.name 'org.opensolaris.smf.fmri:*network/http*'
VALUE                                                 PKG.NAME
['svc:/network/http', 'svc:/network/http:apache22']   web/server/apache-22
['svc:/network/http', 'svc:/network/http:tomcat6']    web/java-servlet/tomcat
['svc:/network/http', 'svc:/network/http:squid']      web/proxy/squid
['svc:/network/http', 'svc:/network/http:lighttpd14'] web/server/lighttpd-14

Dans ce cas, chaque attribut a deux valeurs : le nom du service avec le nom d'instance, et le nom du service sans le nom d'instance. L'exemple suivant illustre la manière dont cet attribut est spécifié dans le manifeste du package :

set name=org.opensolaris.smf.fmri value=svc:/network/http value=svc:/network/http:apache22

Etablissement de la liste des packages par catégorie

L'exemple suivant identifie tous les packages ayant "Source Code Management" dans la valeur de leur attribut info.classification.

$ pkg search 'info.classification:source code management'
INDEX               ACTION VALUE                              PACKAGE
info.classification set    Development/Source Code Management pkg:/developer/versioning/sccs@0.5.11-0.175
info.classification set    Development/Source Code Management pkg:/developer/xopen/xcu4@0.5.11-0.175.1.0.
info.classification set    Development/Source Code Management pkg:/developer/versioning/git@1.7.9.2-0.175
info.classification set    Development/Source Code Management pkg:/developer/versioning/mercurial-27@2.2.
info.classification set    Development/Source Code Management pkg:/library/python-2/subversion@1.7.5-0.17
info.classification set    Development/Source Code Management pkg:/developer/versioning/mercurial-26@2.2.
info.classification set    Development/Source Code Management pkg:/library/java/subversion@1.7.5-0.175.1.
info.classification set    Development/Source Code Management pkg:/developer/quilt@0.60-0.175.1.0.0.21.0
info.classification set    Development/Source Code Management pkg:/developer/versioning/cvs@1.12.13-0.175
info.classification set    Development/Source Code Management pkg:/developer/versioning/subversion@1.7.5-
info.classification set    Development/Source Code Management pkg:/developer/versioning/mercurial@2.2.1-0
info.classification set    Development/Source Code Management pkg:/library/perl-5/subversion@1.7.5-0.175.

Cet exemple montre une grande quantité d'informations répétées qui "noient" les informations réellement recherchées.

L'exemple suivant utilise l'option -o pour afficher uniquement les noms des packages et utilise l'option -H pour omettre l'en-tête de colonne.

$ pkg search -Ho pkg.name 'info.classification:source code management'
developer/versioning/sccs
developer/xopen/xcu4
developer/versioning/git
developer/versioning/mercurial-27
library/python-2/subversion
developer/versioning/mercurial-26
library/java/subversion
developer/quilt
developer/versioning/cvs
developer/versioning/subversion
developer/versioning/mercurial
library/perl-5/subversion

Affichage des packages dépendants

Ces exemples permettent d'afficher les packages qui présentent des dépendances vis-à-vis du package spécifié.

L'exemple suivant montre les packages qui ont une dépendance de type require par rapport au package system/kernel/power. Si vous avez utilisé la commande pkg contents pour afficher les actions depend de type require pour les packages i86pc et system/hal , vous verrez que system/kernel/power figure dans la liste pour les deux packages.

$ pkg search -Hlo pkg.name require:system/kernel/power
system/kernel/dynamic-reconfiguration/i86pc
system/hal

L'exemple suivant montre que de nombreux packages ont une dépendance de typeexclude par rapport à pkg:/x11/server/xorg@1.12.99.

$ pkg search -lo pkg.name,fmri 'depend:exclude:*xorg*'
PKG.NAME                                     FMRI
x11/server/xvnc                              pkg:/x11/server/xorg@1.12.99
x11/server/xorg                              pkg:/x11/server/xorg@1.12.99
x11/server/xorg/driver/xorg-video-mga        pkg:/x11/server/xorg@1.12.99
x11/server/xorg/driver/xorg-video-vesa       pkg:/x11/server/xorg@1.12.99
x11/server/xorg/driver/xorg-input-vmmouse    pkg:/x11/server/xorg@1.12.99 
...

Etablissement de la liste des packages compris 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 recherche suivante pour afficher l'ensemble de packages inclus dans chaque groupe.

$ pkg search -Hfo fmri '*/solaris-large-server:depend:group:*'
archiver/gnu-tar
compress/bzip2
...
text/texinfo
web/wget

Dans cet exemple, -o pkg.name renvoie uniquement le nom du package spécifié dans le champ pkg_name de la requête :

group/system/solaris-desktop

L'option -o fmri renvoie la chaîne FMRI des packages spécifiés dans le package solaris-large-server en tant que dépendances de type group.

Par défaut, la recherche renvoie uniquement les packages qui sont installables dans cette image. Dans cet exemple, la recherche ne renvoie pas les packages correspondants, mais renvoie plutôt la valeur de l'attribut d'une action dans un package spécifié. Dans cet exemple, il se trouve que cette valeur d'attribut est un nom de package. Le nombre de résultats obtenu à l'aide de cette commande est plus important que celui obtenu avec la commande pkg contents car les résultats incluent les noms de tous les packages spécifiés dans les actions de type group depend dans le package spécifié, pas seulement ceux des packages installables. Par exemple, des variantes de package qui ne sont pas installables dans cette image peuvent être incluses. Comparez le résultat de cette recherche au résultat de la commande pkg contents illustré à la section Etablissement de la liste de tous les packages installables dans un package de groupe.