pkg list コマンドは、現在のイメージにパッケージがインストールされているかどうか、および更新が使用可能かどうかを示します。オプションやオペランドを指定しない場合、pkg list コマンドによって、現在のイメージにインストールされているすべてのパッケージが一覧表示されます。結果を絞り込むには、パッケージ名を 1 つ以上指定します。パッケージ名にはワイルドカードを使用できます。引数が直接 pkg に渡され、シェルで展開されないようにするために、ワイルドカードは引用符で囲みます。
次の例に示すように、pkg list コマンドは、一致するパッケージごとに 1 行の情報を表示します。I 列内の「i」は、これらのパッケージがこのイメージにインストールされていることを示します。
$ pkg list '*toolkit' NAME (PUBLISHER) VERSION IFO isvtoolkit (isvpub) 1.0 i-- system/dtrace/dtrace-toolkit 0.99-0.175.2.0.0.34.0 i--
丸括弧で囲まれたパブリッシャー名は、isvpub のパブリッシャーが、このイメージのパブリッシャーの検索順序で先頭のパブリッシャーではないことを示します。このイメージにインストールされた dtrace-toolkit パッケージは、検索順序の先頭のパブリッシャーによって発行されています。
このイメージにインストールされているパッケージと、インストールされていないが、インストール可能なパッケージの最新バージョンを一覧表示するには、-a オプションを使用します。
$ pkg list -a '*toolkit' NAME (PUBLISHER) VERSION IFO image/nvidia/cg-toolkit 3.0.15-0.175.2.0.0.17.0 --- isvtoolkit (isvpub) 1.0 i-- system/dtrace/dtrace-toolkit 0.99-0.175.2.0.0.34.0 i--
この出力は、image/nvidia/cg-toolkit パッケージが使用可能であり、このイメージにインストールできることを示しています。
このイメージにインストールできないパッケージも含めて、一致するすべてのパッケージの最新バージョンを一覧表示するには、-n オプションを使用します。
$ pkg list -n '*toolkit' NAME (PUBLISHER) VERSION IFO developer/dtrace/toolkit 0.99-0.173.0.0.0.1.0 --r image/nvidia/cg-toolkit 3.0.15-0.175.2.0.0.17.0 --- isvtoolkit (isvpub) 1.0 i-- system/dtrace/dtrace-toolkit 0.99-0.175.2.0.0.35.0 ---
developer/dtrace/toolkit パッケージと system/dtrace/dtrace-toolkit パッケージは、このイメージにインストールできません。このことは、これらのパッケージが -a オプションでは一覧表示されなかったことからわかります。developer/dtrace/toolkit パッケージは名前が変更されています。詳細は、Renamed and Obsolete Packagesを参照してください。
このイメージに現在インストールされているバージョンよりも新しいバージョンの dtrace-toolkit パッケージが、構成済みのパブリッシャーに存在します。次の例の「Reason」行に示されているように、dtrace-toolkit パッケージが依存関係になっているほかのパッケージも更新した場合、新しいバージョンがインストール可能になることもあります。簡潔に示すために、次のコマンド出力ではタイムスタンプが省略されています。pkg update および pkg install コマンドについては、Installing and Updating Software Packagesで説明します。
$ pkg update -nv dtrace-toolkit No updates are available for this image. $ pkg install -nv dtrace-toolkit@0.99-0.175.2.0.0.35 pkg install: No matching version of system/dtrace/dtrace-toolkit can be installed: Reject: pkg://solaris/system/dtrace/dtrace-toolkit@0.99,5.11-0.175.2.0.0.35.0 Reason: This version is excluded by installed incorporation pkg://solaris/consolidation/osnet/osnet-incorporation@0.5.11,5.11-0.175.2.0.0.34.0
-u オプションは、新しいバージョンが使用可能な、インストール済みの一致するすべてのパッケージを一覧表示します。Newest Packagesに例示されているように、より新しいバージョンがあるパッケージの数が、このイメージ内で更新可能なパッケージの数より多い場合があります。パッケージは、イメージの制約で許可されたバージョンにのみ更新できます。この制約は、インストール済みパッケージの依存関係およびパブリッシャーの構成によってイメージに課せられるものです。
$ pkg list -u '*toolkit' NAME (PUBLISHER) VERSION IFO system/dtrace/dtrace-toolkit 0.99-0.175.2.0.0.34.0 i--
このイメージにインストールできないパッケージも含めて、一致するすべてのパッケージの使用可能なすべてのバージョンを一覧表示するには、-af オプションを使用します。-f オプションは、-a オプションを使用しないと使用できません。これらの結果を絞り込むために、バージョン文字列の一部を指定する場合もあります。特殊なバージョン文字列 @latest を指定すると、-n オプションで表示されるのと同じ結果が表示されます。
$ pkg list -af '*toolkit@0.99-0.175.2' $ pkg list -af '*toolkit@latest'
次の例で、O 列の「r」はパッケージの名前が変更されていることを示し、O 列の「o」はパッケージが廃止されたことを示します。
$ pkg list -n developer/dtrace/toolkit database/mysql-50 web/amp NAME (PUBLISHER) VERSION IFO database/mysql-50 5.0.91-0.171 --o developer/dtrace/toolkit 0.99-0.173.0.0.0.1.0 --r web/amp 0.5.11-0.174.0.0.0.0.0 --r
これらのパッケージはどれもインストール可能ではありません。廃止されたパッケージをインストールしようとすると、インストールは失敗し、このイメージに必要な更新が存在しないというメッセージが表示されます。名前が変更されたパッケージをインストールしようとすると、システムは、名前が変更されたパッケージの名前が変更された場所に、パッケージのインストールを試行します。
pkg info コマンドを使用して、名前が変更されたパッケージの新しい名前を判別します。パッケージはインストールされていないため、-r オプションを使用して、構成済みのパッケージリポジトリを照会します。次の例に示されている「Renamed to」行を参照してください。
$ pkg info -r web/amp
Name: web/amp
Summary:
State: Not installed (Renamed)
Renamed to: group/feature/amp@0.5.11-0.174.0.0.0.0.0
consolidation/ips/ips-incorporation
Publisher: solaris
Version: 0.5.11
Build Release: 5.11
Branch: 0.174.0.0.0.0.0
Packaging Date: September 21, 2011 07:15:02 PM
Size: 5.45 kB
FMRI: pkg://solaris/web/amp@0.5.11,5.11-0.174.0.0.0.0.0:20110921T191502Z
web/amp パッケージをインストールしようとすると、group/feature/amp パッケージが代わりにインストールされます (まだインストールされておらず、このイメージにインストール可能な場合)。
次の例で、「Renamed to」に示すパッケージはすでにインストールされているため、パッケージシステムから、必要な更新が存在しないという報告が出されます。
$ pkg info -r developer/dtrace/toolkit
Name: developer/dtrace/toolkit
Summary:
State: Not installed (Renamed)
Renamed to: pkg:/system/dtrace/dtrace-toolkit@0.99,5.11-0.173.0.0.0.0.0
consolidation/osnet/osnet-incorporation
Publisher: solaris
Version: 0.99
Build Release: 5.11
Branch: 0.173.0.0.0.1.0
Packaging Date: August 26, 2011 02:55:51 PM
Size: 5.45 kB
FMRI: pkg://solaris/developer/dtrace/toolkit@0.99,5.11-0.173.0.0.0.1.0:20110826T145551Z
$ pkg list dtrace-toolkit
NAME (PUBLISHER) VERSION IFO
system/dtrace/dtrace-toolkit 0.99-0.175.2.0.0.34.0 i--
$ pkg install developer/dtrace/toolkit
No updates necessary for this image.
F 列の「f」は、そのパッケージが凍結されていることを示します。パッケージが凍結されている場合は、凍結されたバージョンと一致するパッケージのみをインストールまたは更新できます。パッケージの凍結については、Locking Packages to a Specified Versionを参照してください。
$ pkg list openssl NAME (PUBLISHER) VERSION IFO library/security/openssl 1.0.1.6-0.175.2.0.0.34.0 if-