ナビゲーションリンクをスキップ | |
印刷ビューの終了 | |
マニュアルページセクション 1: ユーザーコマンド Oracle Solaris 11.1 Information Library (日本語) |
- Image Packaging System 取得クライアント
/usr/bin/pkg [options] command [cmd_options] [operands]
/usr/bin/pkg refresh [-q] [--full] [publisher ...]
/usr/bin/pkg install [-nvq] [-C n] [-g path_or_uri ...] [--accept] [--licenses] [--no-be-activate] [--no-index] [--no-refresh] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] [--reject pkg_fmri_pattern ...] pkg_fmri_pattern ...
/usr/bin/pkg uninstall [-nvq] [-C n] [--no-be-activate] [--no-index] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] pkg_fmri_pattern ...
/usr/bin/pkg update [-fnvq] [-C n] [-g path_or_uri ...] [--accept] [--licenses] [--no-be-activate] [--no-index] [--no-refresh] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] [--reject pkg_fmri_pattern ...] [pkg_fmri_pattern ...]
/usr/bin/pkg list [-Hafnsuv] [-g path_or_uri ...] [--no-refresh] [pkg_fmri_pattern ...]
/usr/bin/pkg info [-lr] [-g path_or_uri ...] [--license] [pkg_fmri_pattern ...]
/usr/bin/pkg contents [-Hmr] [-a attribute=pattern ...] [-g path_or_uri ...] [-o attribute ...] [-s sort_key] [-t action_name ...] [pkg_fmri_pattern ...]
/usr/bin/pkg search [-HIaflpr] [-o attribute ...] [-s repo_uri] query
/usr/bin/pkg verify [-Hqv] [pkg_fmri_pattern ...]
/usr/bin/pkg fix [--accept] [--licenses] [pkg_fmri_pattern ...]
/usr/bin/pkg revert [-nv] [--no-be-activate] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] (--tagged tag-name ... | path-to-file ...)
/usr/bin/pkg mediator [-aH] [-F format] [mediator ...]
usr/bin/pkg set-mediator [-nv] [-I implementation] [-V version] [--no-be-activate] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] mediator ...
/usr/bin/pkg unset-mediator [-nvIV] [--no-be-activate] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] mediator ...
/usr/bin/pkg variant [-H] [variant.variant_name ...]
/usr/bin/pkg change-variant [-nvq] [-C n] [-g path_or_uri ...] [--accept] [--licenses] [--no-be-activate] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] variant_name=value ...
/usr/bin/pkg facet [-H] [facet_name ...]
/usr/bin/pkg change-facet [-nvq] [-C n] [-g path_or_uri ...] [--accept] [--licenses] [--no-be-activate] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] facet_name=[True|False|None] ...
/usr/bin/pkg avoid [pkg_fmri_pattern ...]
/usr/bin/pkg unavoid [pkg_fmri_pattern ...]
/usr/bin/pkg freeze [-n] [-c reason] [pkg_fmri_pattern] ...
/usr/bin/pkg unfreeze [-n] [pkg_name_pattern] ...
/usr/bin/pkg property [-H] [propname ...]
/usr/bin/pkg set-property propname propvalue
/usr/bin/pkg add-property-value propname propvalue
/usr/bin/pkg remove-property-value propname propvalue
/usr/bin/pkg unset-property propname ...
/usr/bin/pkg publisher [-HPn] [-F format] [publisher ...]
/usr/bin/pkg set-publisher [-Ped] [-k ssl_key] [-c ssl_cert] [-g origin_to_add | --add-origin origin_to_add ...] [-G origin_to_remove | --remove-origin origin_to_remove ...] [-m mirror_to_add | --add-mirror mirror_to_add ...] [-M mirror_to_remove | --remove-mirror mirror_to_remove ...] [--enable] [--disable] [--no-refresh] [--reset-uuid] [--non-sticky] [--sticky] [--search-after publisher] [--search-before publisher] [--search-first] [--approve-ca-cert path_to_CA] [--revoke-ca-cert hash_of_CA_to_remove] [--unset-ca-cert hash_of_CA_to_remove] [--set-property name_of_property=value] [--add-property-value name_of_property=value_to_add] [--remove-property-value name_of_property=value_to_remove] [--unset-property name_of_property_to_delete] [--proxy proxy_to_use] publisher
/usr/bin/pkg set-publisher -p repo_uri [-Ped] [-k ssl_key] [-c ssl_cert] [--non-sticky] [--sticky] [--search-after publisher] [--search-before publisher [--search-first] [--approve-ca-cert path_to_CA] [--revoke-ca-cert hash_of_CA_to_remove] [--unset-ca-cert hash_of_CA_to_remove] [--set-property name_of_property=value] [--add-property-value name_of_property=value_to_add] [--remove-property-value name_of_property=value_to_remove] [--unset-property name_of_property_to_delete] [--proxy proxy_to_use] [publisher]
/usr/bin/pkg unset-publisher publisher ...
/usr/bin/pkg history [-HNl] [-t [time | time-time],...] [-o column,...] [-n number]
/usr/bin/pkg purge-history
/usr/bin/pkg rebuild-index
/usr/bin/pkg update-format
/usr/bin/pkg version
/usr/bin/pkg help
/usr/bin/pkg image-create [-FPUfz] [--force] [--full | --partial | --user] [--zone] [-k ssl_key] [-c ssl_cert] [--no-refresh] [--variant variant_name=value ...] [-g path_or_uri | --origin path_or_uri ...] [-m uri | --mirror uri ...] [--set-property name_of_property=value] [--facet facet_name=(True|False) ...] [(-p | --publisher) [name=]repo_uri] dir
pkg は Image Packaging System 用の取得クライアントです。有効な構成では、pkg を呼び出すことにより、パッケージをインストールする場所を作成し、イメージを呼び出し、パッケージをイメージにインストールすることができます。パッケージはパブリッシャーによって公開され、パブリッシャーはそれらのパッケージを 1 つ以上のリポジトリで、またはパッケージアーカイブで入手可能にすることができます。pkg はパブリッシャーのリポジトリまたはパッケージアーカイブからパッケージを取得し、パッケージをイメージにインストールします。
パブリッシャーの名前によって、人、人のグループ、または組織が 1 つ以上のパッケージのソースとして識別されます。パブリッシャーの名前の競合を避け、パブリッシャーを識別しやすくするために、パッケージを公開するエンティティーを表すドメイン名をパブリッシャーの名前として使用することがベストプラクティスです。
リポジトリは、クライアントがパッケージの内容 (プログラムやドキュメントなど、パッケージの内部に含まれるファイル) とメタデータ (パッケージの名前や説明など、パッケージについての情報) を公開および取得できる場所です。たとえば、example.org という名前のパブリッシャーは、http://example.org/repository という URI にリポジトリを配置することができます。
pkg では、パッケージをアンインストールしたり、(利用可能なパッケージの一覧などの) パブリッシャーメタデータをリフレッシュしたり、イメージにインストールされたパッケージを検証したり、イメージからさまざまなトークンを照会したりすることもできます。これらのクエリーは pkg(5) リポジトリで構成することもできます。
イメージには 3 つの種類があります。完全なシステムを提供できるフルイメージ、フルイメージ (親イメージ) にリンクされるがそれ自身では完全なシステムを提供しない部分イメージ、およびユーザーイメージです。
サポートしているオプションは、次のとおりです。
使用方法に関するメッセージを表示します。
dir をルートとするイメージを操作します。ディレクトリが指定されなかったか、または環境に基づいて決定される場合、デフォルトは / です。詳細は、「環境変数」のセクションを参照してください。
サポートされているサブコマンドは次のとおりです。
クライアントの利用可能パッケージの一覧およびすべての発行元の発行元メタデータを更新します。
クライアントの利用可能パッケージの一覧、および指定された発行元の発行元メタデータのみを更新します。
リクエストされた操作の実行中、進捗状況メッセージを表示しません。
増分更新を試みる代わりにすべての発行元メタデータを強制的に完全取得し、操作中に使用されるすべてのプロキシでキャッシュデータを無視するようにリクエストします。このオプションはトラブルシューティング目的に用意されており、通常時は使用しないでください。
指定されたパッケージをインストールし、イメージにインストールされたパッケージで許容されている pkg_fmri_pattern と一致する最新バージョンにパッケージを更新します。パッケージの最新バージョンを明示的に要求するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。
パッケージは、発行元検索順およびスティッキネスに基づいて選択されます。検索順およびスティッキネスについては、pkg publisher および pkg set-publisher コマンドを参照してください。pkg_fmri_pattern が発行元を指定しない場合、一致するパッケージを提供する最初の発行元がインストール元として使用されます。該当する発行元がこのイメージ内にインストール可能なパッケージのバージョンを提供しない場合、インストール操作は失敗します。このイメージにインストール可能なパッケージのバージョンを提供する発行元を確認するには、pkg list -a コマンドを使用します。
複数の pkg_fmri_pattern が指定され、かつ指定されたパッケージのいずれかをこのイメージにインストールできない場合、指定されたパッケージは一切インストールされません。
インストールプロセスの間に、一部の設定ファイルの名前変更または置換が行われる場合があります。どのファイルを保持するかをパッケージシステムが決定する方法と、パッケージ操作中にファイルが保持されるしくみについては、pkg(5) のマニュアルページのファイルアクションに関する項目を参照してください。
パッケージが回避リストにある場合は、インストールすると回避リストから削除されます。
指定されたパッケージリポジトリまたはアーカイブを、パッケージデータの取得元になるイメージ内のソースリストに一時的に追加します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。
どのバージョンのパッケージを使用するかを決定するときは、イメージ内に構成されているが、指定された path_or_uri ソースに見つからない発行元が優先されます。インストールするパッケージのバージョンが、イメージ内で構成されている発行元および path_or_uri ソースから提供されている場合、クライアントはそのパッケージの内容を path_or_uri ソースから取得します。インストールまたは更新のあとに、発行元によって提供され、イメージ内で構成されていないパッケージがある場合は、起点なしでイメージ構成に追加されます。イメージ内で構成されている発行元を表示するには、pkg publisher コマンドを使用します。
パッケージの変更は行わずに試しに操作を実行します。
リクエストされた操作の実行中に詳細な進捗状況メッセージを出力し、詳細な計画情報 (ファセット、メディエータ、バリアントの変更など) を表示します。このオプションを複数回指定して、表示される計画情報の量を増やすことができます。
リクエストされた操作の実行中、進捗状況メッセージを表示しません。
同時に更新する子イメージの数を指定します。子イメージ (通常はゾーン) 内への再帰時に、最大 n 個の子イメージを同時に更新します。更新する子イメージのデフォルト数は、1 です。n が 0 または負数の場合は、すべての子イメージが同時に更新されます。「環境変数」セクションの「PKG_CONCURRENCY」も参照してください。
更新またはインストールされるパッケージのライセンス条項に同意することを示します。このオプションを指定しないと、パッケージのライセンスに同意が必要になった場合、インストール操作は失敗します。
この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示します。
バックアップブート環境を作成しません。
ブート環境が作成される場合に、それを次回ブート時にアクティブなブート環境として設定しません。詳細は、beadm(1M) のマニュアルページを参照してください。
操作が正常に完了したあとに検索インデックスを更新しません。
入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージの発行元用のリポジトリへのアクセスを試みません。
指定された引数を使って、作成されたバックアップブート環境に名前を付けます。--backup-be-name を使用すると --require-backup-be が暗黙的に指定されます。beadm(1M) のマニュアルページも参照してください。
新たに作成されたブート環境の名前を、指定された引数になるように変更します。--be-name の使用は、暗黙的に --require-new-be を示します。beadm(1M) のマニュアルページも参照してください。
新しいブート環境が作成されない場合に、常にバックアップブート環境を作成します。このオプションを指定しないと、イメージポリシーに基づいてバックアップブート環境が作成されます。バックアップブート環境がいつ自動的に作成されるかについての説明は、次の「イメージプロパティー」の be-policy を参照してください。
常に新しいブート環境を作成します。このオプションを指定しないと、イメージポリシーに基づいてブート環境が作成されます。ブート環境がいつ自動的に作成されるかについての説明は、次の「イメージプロパティー」の be-policy を参照してください。このオプションを --require-backup-be と組み合わせることはできません。
新しいブート環境を作成しません。新しいブート環境が必要な場合、この操作は実行されません。
指定されたパターンと一致する名前を持つパッケージはインストールされません。一致するパッケージがすでにインストールされている場合、それらはこの操作の一環として削除されます。グループ依存関係のターゲットである拒否対象パッケージは回避リストに登録されます。
pkg_fmri_pattern に一致するインストール済みパッケージを削除します。
パッケージがグループ依存関係の対象である場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。後述する avoid サブコマンドを参照してください。
オプションの説明については、前述の install コマンドを参照してください。
コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、それが次回リブート時のデフォルトのブート環境になります。ブート環境の管理については、 beadm(1M) のマニュアルページを参照してください。
現在のイメージ内のすべてのインストール済みパッケージを、インストール済みパッケージと発行元構成によりシステムに適用される制約で許可される最新のバージョンに更新します。
現在のイメージにインストール済みの、指定されたパッケージのみを更新します。指定された pkg_fmri_pattern パターンの 1 つがアスタリスク (*) である場合、現在のイメージ内のすべてのインストール済みパッケージを前述のとおりに更新します。
パッケージの最新バージョンを明示的に要求するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。
すでにインストールされているものより古い、または新しいバージョンを指定することで、特定のパッケージのインプレースダウングレードまたはアップグレードを実行できます。パッケージの名前変更または廃止の境界をまたがった特定パッケージの更新はサポートされていません。
保持される構成ファイルのうち、ダウングレードされるパッケージの一部であり、元のバージョンがインストールされたあとに変更されたファイルは、拡張子 .update を使用して名前が変更されます。どのファイルを保持するかをパッケージシステムが決定する方法と、パッケージアップグレード中にファイルが保持されるしくみについては、pkg(5) のマニュアルページのファイルアクションに関する項目を参照してください。
複数の pkg_fmri_pattern が指定され、かつ指定されたパッケージのいずれかをこのイメージに更新できない場合、指定されたパッケージは一切更新されません。
すべてのインストール済みパッケージを更新するときにクライアントに対する最新状態チェックを実行しません。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、それが次回、--no-be-activate オプションを指定しない場合のリブート時のデフォルトブート環境になります。ブート環境の管理については、beadm(1M) のマニュアルページを参照してください。
バージョンやインストール状態などの情報を含む、現在のイメージ内のインストール済みの全パッケージのリストを表示します。デフォルトでは、異なるアーキテクチャーまたはゾーンタイプのパッケージバリアントは除外されます。通常の出力は 3 列形式です。
NAME (PUBLISHER) VERSION IFO system/core-os 0.5.11-0.175.0.0.0.2.1 i-- x11/wm/fvwm (fvwm.org) 2.6.5 i--
最初の列にはパッケージの名前が表示されます。パッケージのインストール元 (または、インストールされていない場合は提供元) であるパブリッシャーがパブリッシャー検索順で先頭でない場合、パッケージ名のあとに一覧表示されるパブリッシャー名は括弧で囲まれています。2 番目の列にはパッケージのリリースバージョンとブランチバージョンが表示されます。リリースバージョンとブランチバージョンについて、およびバリアントについては、pkg(5) のマニュアルページを参照してください。
最後の列には、パッケージのステータスを示す一連のフラグが表示されます。
I 列の i は、パッケージがインストールされていることを示します。
F 列の f は、パッケージが凍結されていることを示します。
O 列の o は、パッケージが廃止されていることを示します。O 列の r は、パッケージの名前が変更されたことを示します (廃止の形態の 1 つです)。
指定したパッケージのみを一覧表示します。
一覧からヘッダーを省略します。
インストール済みパッケージと、インストールのために入手可能なパッケージの最新バージョンを一覧表示します。インストール済みの incorporation によって、またイメージのバリアントによって許可されている場合、そのパッケージはインストールのために入手可能であるとみなされます。1 つ以上のパターンを指定した場合、指定されたパターンに一致し、インストール済みの incorporation およびイメージのバリアントによって許可されている最新バージョンが一覧表示されます。-a を指定しない場合、インストール済みパッケージのみを一覧表示します。
incorporation の制約またはインストール状態に関係なく、すべてのバリアントについてすべてのパッケージのすべてのバージョンを一覧表示します。これらのオプションを使用するとき、パッケージの最新バージョンを明示的に一覧表示するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。
指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。-n を指定しない場合、-g を使用すると -a が暗黙的に指定されます。
インストール状態に関係なく、すべての既知のパッケージの最新バージョンを表示します。
パッケージ名とサマリーを示す 1 行の短縮形式を表示します。このオプションは -a、-n、-u、または -v とともに使用できます。
新しいバージョンが入手可能なパッケージのみを一覧表示します。このオプションは -g とともに使用できません。
発行元と完全バージョンを含む、フルパッケージ FMRI をすべて最初の列に表示します (VERSION 列は消えます)。このオプションは -a、-n、または -u とともに使用できます。
入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージの発行元用のリポジトリへのアクセスを試みません。
現在のイメージにインストールされているすべてのパッケージについての情報を、人間が判読できる形式で表示します。
指定したパッケージの情報のみを表示します。
指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。-g を使用すると -r が暗黙的に指定されます。
インストール済みのパッケージの情報だけを表示します。これはデフォルトです。
最新の入手可能バージョンに基づいてパッケージを照合し、イメージの構成済み発行元のリポジトリから、現在インストールされていないパッケージの情報を取得します (必要な場合)。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。-r を指定しない場合、デフォルトでインストール済みパッケージのみが表示されます。
パッケージのライセンステキストを表示します。このオプションは -l または -r と組み合わせることができます。
イメージ内のすべてのインストール済みパッケージの内容 (アクション属性) を表示します。オプションが指定されていない場合、現在のイメージにインストールされているアクションの path 属性の値をアルファベット順で並べ替えて表示します。アクションとそれらの属性については、pkg(5) のマニュアルページのアクションに関する項目を参照してください。下の疑似属性名のリストも参照してください。
指定したパッケージの内容のみを表示します。
出力からヘッダーを省略します。
名前がオプション引数で指定され、値がオプション引数 (属性名と等号に続く部分) の (glob) パターンに一致する属性を持つアクションに出力を限定します。複数の -a オプションを指定した場合、それらのいずれかに一致するアクションが表示されます。
指定されたパッケージリポジトリまたはアーカイブからこのイメージにインストール可能なパッケージの情報を表示します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションは複数回指定できます。-g を使用すると -r が暗黙的に指定されます。
このイメージにインストールできないアクションを含めて、指定されたパッケージのすべてのアクションのすべての属性を表示します。
指定された属性を、リストの先頭属性の値に従って並べ替えて表示します。-o オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの -o オプションの引数として複数の属性を指定できます。要求された属性を持つアクションのみが表示されます。
このイメージ内で構成された発行元のリポジトリからこのイメージにインストール可能なパッケージの最新バージョンの情報を表示します。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。
指定されたアクション属性で、アクションをソートします。このオプションを指定しない場合、デフォルトではパスによって、または -o オプションで最初に指定された属性によってソートします。-s オプションは複数回指定できます。
指定されたアクションのみを一覧表示します。複数のアクションをコンマ区切りリストで指定できます。action_name の値は、pkg(5) のマニュアルページの「アクション」内に一覧表示されているアクションのいずれかで、file、directory、driver、depend、set などです。このオプションは複数回指定できます。
利便性のために、いくつかの特殊な疑似属性名を使用できます。
アクションがペイロードを伝送する場合、アクションのハッシュの値です。
アクションのキー属性の値です。たとえば、file アクションの場合、鍵属性はファイルのパスです。キー属性のないアクションもあります。
アクションの名前です。たとえば、ファイルアクションの場合、これは file です。
一致するアクションのすべての属性。
アクションを包含しているパッケージのフル形式 FMRI (たとえば、 pkg://solaris/group/feature/amp@0.5.11,5.11-0.175.0.0.0.2.1:20120705T153434Z) です。
アクションを包含しているパッケージの名前 (たとえば、web/amp) です。
アクションを包含しているパッケージの発行元 (たとえば、solaris) です。
アクションを包含しているパッケージのショート形式 FMRI (pkg://solaris/group/feature/amp@0.5.11,5.11-0.175 など) です。
関連するサブコマンドは contents および search であり、どちらもパッケージの内容についてシステムをクエリーします。contents サブコマンドは、1 つまたは複数のインストールされているか、インストール可能なパッケージ内のアクションを、指定されたオプションに基づいて出力をフィルタ処理して表示します。search サブコマンドは逆方向からクエリーを行い、ユーザーが指定したトークンを含むすべてのパッケージの名前を表示します。
各サブコマンドで実行できるクエリーの一部は、他方でも実行できます。サブコマンドの選択は慎重に行ってください。クエリーによっては、もう一方のほうがより自然に実行できる場合があります。
query の一致を検索し、結果を表示します。次の query の説明を参照してください。
出力からヘッダーを省略します。
大文字/小文字を区別する検索を使用します。
検索を実行して、一致するアクションに関する情報を表示します。これはデフォルトです。
パッケージのバージョンに関係なく、すべての結果を表示します。search はデフォルトで、現在インストールされているバージョンよりも古いパッケージ、および現在の incorporation によって除外されているパッケージバージョンからの結果を取り除きます。
イメージのインストール済みパッケージを検索します。
-l と -r (または -s) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。
一部のアクションが各クエリー条件に一致するパッケージを表示します。このオプションを使用することは、クエリーの各条件を山括弧 (<>) で囲むことと等価です。<> 演算子の詳細は、次の query を参照してください。
イメージの発行元に対応するリポジトリを検索します。これはデフォルトです。
-l と -r (または -s) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。
結果の列を制御します。-o オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの -o オプションの引数として複数の属性を指定できます。前述した疑似属性に加えて、検索結果用の次の属性が定義されています。
検索クエリーに一致した文字列。
検索クエリーに一致した文字列を含む属性。
指定された URI に位置する pkg(5) リポジトリを検索します。これは複数回指定できます。パッケージアーカイブはサポートされていません。
デフォルトでは、query は完全一致する一連の条件として解釈されます。? および * 文字を glob(3C) 形式のワイルドカードとして使用でき、より柔軟なクエリー一致が可能になります。
単純なトークン一致およびワイルドカード検索に加えて、より複雑なクエリー言語がサポートされています。単一引用符または二重引用符 (' または ") を使用することにより、語句を検索できます。pkg が実際に ' または " を認識するように、必ずシェルを考慮に入れてください。
AND と OR を使用する論理検索がサポートされています。
どのトークンがインデックス化されるかはアクションに依存しますが、コンテンツハッシュとパス名を含めることができます。アクションとそれらの属性については、pkg(5) のマニュアルページのアクションに関する項目を参照してください。前述の pkg contents および - o 内の擬似属性名のリストも参照してください。
構造化されたクエリーは、次の構文でサポートされます:
pkg_name:action_name:index:token
action_name の値は、pkg(5) マニュアルページの「アクション」に一覧表示されているアクションのいずれかです。index は、アクションの属性です。index の値は、token と一致している必要があります。
すべてのアクション属性が検索可能なわけではありません。たとえば、mode は file アクションの属性ですが、mode は index の有効な値ではありません。
index の一部の値は、アクション属性ではなく、ほかの属性から派生した値です。たとえば、パスの最後のコンポーネントを取ることにより、index を、どのアクションの属性でもないが、file または dir アクションの path 属性から派生した basename にできます。
アクションタイプが異なると、有効な index 値も異なります。このドキュメントには、使用可能な値がすべて含まれているわけではありません。より有用な index 値には、ファイルシステムアクションの basename および path、depend アクションの依存性タイプ (たとえば、require、 optional、group)、および driver アクションの driver_name および alias などがあります。
特殊な index 値の 1 つに、set アクションの name 属性の値があります。この場合、token が、指定された name 属性に対応する value 属性の値と照合されます。たとえば、次の検索により、Development/Databases または System/Databases のいずれかに分類されるパッケージを検索します。「使用例」セクションで、SMF サービスを検索する例を参照してください。
$ pkg search info.classification:databases
構造化クエリー内の欠落したフィールドは、暗黙的にワイルドカード化されます。basename:pkg の検索は、basename の index を持ち、次の部分出力に示すような token pkg に一致するすべてのパッケージ内のすべてのアクションに一致します:
$ pkg search basename:pkg INDEX ACTION VALUE PACKAGE basename dir usr/share/pkg pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 basename dir var/sadm/pkg pkg:/package/svr4@0.5.11-0.175.0.0.0.2.1 basename dir var/spool/pkg pkg:/package/svr4@0.5.11-0.175.0.0.0.2.1 basename file usr/bin/pkg pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1
次の完全な出力に示すように、別のフィールドを追加すると検索が絞り込まれます:
$ pkg search file:basename:pkg INDEX ACTION VALUE PACKAGE basename file usr/bin/pkg pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1
pkg_name および token フィールドでは明示的ワイルドカードがサポートされます。action_name および index は、正確に一致する必要があります。
ファイルと依存関係の検索例については、「使用例」セクションを参照してください。
アクションをこれらのアクションを含むパッケージに変換するには、次の部分出力に示すように、 <> を使用します:
$ pkg search \<pkg\> PACKAGE PUBLISHER pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 solaris pkg:/package/svr4@0.5.11-0.175.0.0.0.2.1 solaris
-a オプションを使用する場合 (デフォルト)、token を検索した結果は token に一致するアクションについての情報である一方で、<token> を検索した結果は、token に一致するアクションを包含しているパッケージの一覧です。
現在のイメージ内で、インストールされているすべてのパッケージのインストールを検証します。関連する発行元の現在の署名ポリシーが ignore でない場合、各パッケージの署名がポリシーに基づいて検証されます。署名ポリシーが適用されるしくみについては、後述する「イメージプロパティー」の signature-policy で説明します。
現在のイメージ内で、指定されたインストール済みパッケージのインストールのみを検証します。
検証の出力からヘッダーを省略します。
何も出力しませんが、致命的なエラーがある場合はエラーを返します。
パッケージに関する情報メッセージを含めます。
pkg verify で報告されたエラーをすべて修正します。インストール済みパッケージの内容は、独自の内容解析に基づいて検証されるため、ほかのプログラムの場合とは異なる結果が返されることがあります。
現在のイメージ内で、指定されたインストール済みパッケージに対する pkg verify により報告されたエラーを修正します。
更新またはインストールされるパッケージのライセンス条項に同意することを示します。このオプションを指定しないと、パッケージのライセンスに同意が必要になった場合、操作は失敗します。
この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示します。
pkg(5) パッケージにより配布されたパッケージを、配布時の状態に戻します。ファイルの所有権および保護も復元されます。
注意 - 一部の編集可能ファイルをデフォルト値に戻すと、システムがブート不可になったり、その他の異常動作の原因になったりする可能性があります。 |
tag-name でタグ付けされたすべてのファイルを元に戻します。
指定されたファイルを元に戻します。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
現在選択されているバージョンやすべてのメディエータの実装を表示します。
現在選択されているバージョンや指定されたメディエータの実装のみを表示します。
現在インストールされているパッケージに設定可能なメディエーションを一覧表示します。
代替出力形式を指定します。現時点では tsv (タブ区切り値) のみが有効です。
一覧からヘッダーを省略します。
現在のイメージ内の指定されたメディエータのバージョンと実装を設定します。
使用するメディエート対象インタフェースの実装を設定します。デフォルトでは、バージョンが指定されない場合、すべての実装バージョンが許可されます。バージョンなしで実装を指定するには、アット記号 (@) を付加します。
使用するメディエート対象インタフェースのバージョンを設定します。
指定されたメディエータのバージョンと実装のどちらかまたは両方が現在入手できない場合、指定されたメディエータを使用するリンクはすべて削除されます。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
指定されたメディエータのバージョンと実装をシステムデフォルトに戻します。
メディエート対象インタフェースの実装のみを元に戻します。
メディエート対象インタフェースのバージョンのみを元に戻します。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
このイメージに設定されているすべてのバリアントの現在値を表示します。バリアントの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
このイメージで設定されている、指定されたバリアントのみの現在値を表示します。
一覧からヘッダーを省略します。
現在のイメージに設定され、指定されているバリアントの値を変更します。
バリアントの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。バリアントの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。バリアントの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
オプションの説明については、前述の install コマンドを参照してください。
pkg change-facet コマンドを使用してこのイメージに明示的に設定されているすべてのファセットの現在の値を表示します。ファセットの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
このイメージに設定されている、指定されたファセットのみの現在値を表示します。
一覧からヘッダーを省略します。
現在のイメージに設定され、指定されたファセットの値を変更します。
ファセットは True または False に設定できます。ファセットを None に設定すると、True のデフォルト値がそのファセットに適用されるため、ファセットに依存するすべてのアクションがインストールされます。アクションについては、pkg(5) のマニュアルページのアクションに関する項目を参照してください。
ファセットの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。ファセットの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。ファセットの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
オプションの説明については、前述の install コマンドを参照してください。
回避対象の各パッケージを、そのパッケージにグループ依存関係を持つパッケージとともに表示します。
回避リストに登録されているパッケージは、要求された依存関係を満たすために必要であればインストールされます。その依存関係が削除された場合、パッケージはアンインストールされます。
指定されたパターンに現在一致するパッケージ名を回避リストに登録することにより、それらがグループ依存関係のターゲットである場合にそれらを回避します。現在インストールされていないパッケージのみを回避できます。パッケージが現在グループ依存関係のターゲットである場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。
回避対象のパッケージのリストを表示します。
指定されたパッケージを回避リストから削除します。回避リストに登録されており、インストール済みパッケージのグループ依存関係に一致するパッケージは、このサブコマンドを使用して削除できません。グループ依存性に一致するパッケージを回避リストから削除するには、パッケージをインストールします。
現在凍結されているパッケージについての情報 (パッケージ名、バージョン、パッケージがいつ凍結されたか、パッケージの凍結に関連付けられた理由があればその理由) が表示されます。
パッケージを凍結しても、そのパッケージを削除できなくなるわけではありません。パッケージが削除される場合に警告は表示されません。
指定されたパッケージを指定されたバージョンに凍結します。バージョンを指定しない場合、パッケージがインストールされている必要があり、そのインストール済みバージョンで凍結されます。すでに凍結されているパッケージを凍結すると、新しく指定されたバージョンによって凍結バージョンが置き換えられます。
凍結されているパッケージをインストールまたは更新するときは、凍結された時点のバージョンと一致するバージョンである必要があります。たとえば、パッケージが 1.2 で凍結された場合、1.2.1、1.2.9、1.2.0.0.1 などのバージョンに更新することはできます。そのパッケージは 1.3 または 1.1 で終了することはできません。pkg_fmri_pattern で提供されるパブリッシャーは、一致するパッケージを検索するために使用されます。ただし、パブリッシャー情報は凍結の一環として記録されません。パッケージは発行元ではなくバージョンのみに関して凍結されます。
凍結されるパッケージとともに理由を記録します。凍結が原因でインストールまたは更新に失敗する場合、その理由が示されます。
凍結操作を試しに実行し、凍結されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結しません。
現在凍結されているパッケージについての情報 (パッケージ名、バージョン、パッケージがいつ凍結されたか、パッケージの凍結に関連付けられた理由があればその理由) が表示されます。
凍結によって適用される制約を、指定されたパッケージから削除します。バージョンを提供しても無視されます。
凍結解除操作を試しに実行し、凍結解除されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結解除しません。
すべてのイメージプロパティーの名前と値を表示します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。
指定されたプロパティーのみの名前と値を表示します。
一覧からヘッダーを省略します。
既存のイメージプロパティーを更新するか、または新しいイメージプロパティーを追加します。
既存のイメージプロパティーに値を追加するか、または新しいイメージプロパティーを追加します。
既存のイメージプロパティーから値を削除します。
既存のイメージプロパティーを削除します。
すべての発行元、それらの起点 URI、およびミラーの一覧を、検索の優先順に従って表示します。
指定された発行元のみの詳細な構成を表示します。
一覧からヘッダーを省略します。
発行元検索順の先頭の発行元のみを表示します。
有効な発行元のみを表示します。
代替出力形式を指定します。現時点では tsv (タブ区切り値) のみが有効です。
既存の発行元を更新するか、発行元を追加します。検索順に影響するオプションを指定しない場合、新しいパブリッシャーは検索順の末尾に付加され、最後に検索されます。
指定された発行元を、検索順の先頭に設定します。新しいパッケージをインストールするとき、このパブリッシャーが最初に検索されます。インストール済みパッケージの更新は、そのパブリッシャーが sticky であるかぎり、そのパッケージを最初に提供した同じパブリッシャーから取得されます。
この発行元よりも上位にランクされる発行元が、この発行元から最初にインストールされたパッケージに更新を提供できます。
この発行元からインストールされたパッケージへの更新も、この発行元から取得する必要があります。これはデフォルトの動作です。
追加または変更される発行元が、このオプションで指定された発行元の前に検索されるように、発行元検索順序を変えます。
追加または変更される発行元が、このオプションで指定された発行元のあとに検索されるように、発行元検索順序を変えます。
指定された証明書を信頼できる CA 証明書として追加します。ユーザーが承認した CA 証明書の PEM 表現のハッシュは、pkg publisher コマンドの詳細出力に一覧表示されます。
指定された PEM 表現のハッシュを持つ証明書を失効済みとして扱います。ユーザーが失効させた CA 証明書のハッシュは、pkg publisher コマンドの詳細出力に一覧表示されます。
指定されたハッシュを持つ証明書を、承認済み証明書のリストおよび失効済み証明書のリストから削除します。
既存の発行元プロパティーを更新するか、または新しい発行元プロパティーを追加します。
既存の発行元プロパティーに値を追加するか、または新しい発行元プロパティーを追加します。
既存の発行元プロパティーから値を削除します。
既存の発行元プロパティーを削除します。
クライアント SSL 鍵を指定します。
クライアント SSL 証明書を指定します。
指定された URI またはパスを、特定の発行元の起点として追加します。これはパッケージのリポジトリまたはアーカイブの場所にしてください。
指定された発行元の起点のリストから URI またはパスを削除します。特殊値 * を使用して、すべての起点を削除することができます。
入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージの発行元用のリポジトリへのアクセスを試みません。
このイメージをその発行元に対して識別する新しい一意識別子を選択します。
URI を指定された発行元のミラーとして追加します。
指定された発行元のミラーのリストから URI を削除します。特殊値 * を使用して、すべてのミラーを削除することができます。
発行元を有効にします。
発行元を無効にします。無効にされたパブリッシャーは、パッケージリストの生成時に、または特定のパッケージ操作 (インストール、アンインストール、および更新) で使用されません。ただし、無効なパブリッシャーのプロパティーを設定または表示することはできます。発行元が 1 つだけの場合は、無効にすることはできません。
指定した Web プロキシ URI を使用して、指定した起点 (-g) またはミラー(-m) のコンテンツを取得します。プロキシ値は、発行元の構成の一部として格納されます。実行時に、$http_proxy または関連する環境変数は、このプロキシ設定をオーバーライドします。受け入れられる環境変数名のリストについては、curl(1) のマニュアルページを参照してください。
repo_uri リポジトリ URI から発行元構成情報を取得します。
発行元オペランドがこの set-publisher サブコマンドに指定されている場合、その発行元のみが追加または更新されます。発行元を指定しない場合、repo_uri 内のすべての発行元が必要に応じて追加または更新されます。
オプションの説明については、前述の set-publisher コマンドを参照してください。-p と同時に使用する場合、-P、--search-first 、--search-before、および --search-after オプションは追加された発行元のみに適用され、更新された発行元には適用されません。
-p オプションは、-g、--add-origin、-G、--remove-origin、-m、--add-mirror、-M、--remove-mirror、--disable、--enable、--no-refresh、または --reset-uuid オプションと組み合わせることはできません。
指定された発行元に関連付けられた構成を削除します。
該当するイメージのコマンド履歴を表示します。
一覧からヘッダーを省略します。
%Y-%m-%dT%H:%M:%S 形式のタイムスタンプのコンマ区切りリストでログレコードを表示します ( strftime(3C) を参照)。日時の範囲を指定するには、開始と終了のタイムスタンプの間にハイフン (-) を使用します。キーワード now は、現在の日時の別名として使用できます。指定されたタイムスタンプに、重複したタイムスタンプまたは重複する日付範囲が含まれる場合、重複した各履歴イベントの 1 つのインスタンスのみが出力されます。
長い形式でログレコードを表示します。これには標準形式に加えて、コマンドの結果、コマンドが完了した日時、使用されたクライアントのバージョンと名前、操作を実行したユーザーの名前、およびコマンドの実行中に発生したすべてのエラーが含まれます。
リリースノートのテキストを表示します。
最新のものから順に指定された数のエントリのみを表示します。
列名を指定するコンマ区切りリストを使用して出力を表示します。有効な列名は次のとおりです。
この操作が開始されたブート環境の名前。
この操作が開始されたブート環境の UUID。
クライアントの名前。
クライアントのバージョン。
この操作のために使用されたコマンド行。
この操作が完了した日時。
この操作を開始したユーザー ID。
この操作によって作成された新しいブート環境。
この操作によって作成された新しいブート環境の UUID。
操作の名前。
この操作の結果のサマリー。
この操作の結果に関する追加情報。
この操作によってリリースノートが生成されたかどうかを示します。
この操作中に作成されたスナップショット。これは、操作が正常に完了したあとにスナップショットが自動削除されなかった場合にのみ記録されます。
この操作が開始した日時。
この操作の実行にかかった合計時間。1 秒未満の操作については 0:00:00 と表示されます。
この操作を開始したユーザー名。
command または reason 列を指定する場合、出力フィールドの区切りを維持するためには、それらの列が -o リストの最終項目である必要があります。同じ history コマンドでこれら 2 つの列を表示することはできません。
ブート環境がシステムに存在しなくなった場合、be または new_be の値のあとにアスタリスク (*) が表示されます。
be および new_be の値は、be_uuid または new_be_uuid フィールドを使用して現在のブート環境名を検索することによって取得されます。その後、ブート環境の名前が変更されたあとにその環境が削除された場合、be および new_be に表示される値は、pkg 操作の時点で記録された値です。
既存の履歴情報をすべて削除します。
pkg search によって使用されるインデックスを再構築します。これは復旧操作であり、一般的に使用することは想定されていません。
イメージの形式を現在のバージョンに更新します。この操作が完了したあとは、古いバージョンの pkg(5) システムと組み合わせてイメージを使用することはできなくなります。
pkg のバージョンを識別する一意な文字列を表示します。この文字列は、バージョン間で何らかの方法で比較可能であることは保証されていません。
使用方法に関するメッセージを表示します。
dir によって指定された場所に、パッケージ操作に適したイメージを作成します。デフォルトのイメージタイプはユーザーであり、-U (--user) オプションによって指定されます。イメージタイプはフルイメージ (--F または --full)、または指定された dir パスを包含するフルイメージにリンクされた部分イメージ (-P または --partial) に設定できます。-g または --origin を使用して追加の起点を指定できます。-m または --mirror を使用して追加のミラーを指定できます。
パッケージリポジトリの URI は、-p または --publisher オプションを使用して提供する必要があります。パブリッシャーの名前も提供した場合、イメージの作成時にそのパブリッシャーのみが追加されます。パブリッシャーの名前を提供しない場合、指定されたリポジトリによって認識されているすべてのパブリッシャーがイメージに追加されます。このパブリッシャーに関連付けられたカタログは、初期作成操作に続いて取得が試みられます。
クライアント SSL 認証を使用するパブリッシャーの場合、クライアント鍵およびクライアント証明書は -c および -k オプションを通して登録できます。この鍵と証明書は、イメージ作成中に追加されるすべてのパブリッシャーのために使用されます。
イメージが非大域ゾーンコンテキストの内部で実行される予定の場合、-z (--zone) オプションを使用して適切なバリアントを設定できます。
既存のイメージ上にイメージを強制的に作成します。このオプションは慎重に使用してください。
入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージの発行元用のリポジトリへのアクセスを試みません。
指定されたバリアントを指定された値に設定します。バリアントの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
指定されたファセットを指定された値に設定します。ファセットの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
指定されたイメージプロパティーを指定された値に設定します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。
次のプロパティーはイメージの特性を定義します。これらのプロパティーは、イメージの目的、内容、および動作に関する情報を格納します。イメージ内のこれらのプロパティーの現在の値を表示するには、pkg property コマンドを使用します。これらのプロパティーの値を変更するには、pkg set-property コマンドおよび pkg unset-property コマンドを使用します。
(文字列) パッケージ操作中にいつブート環境が作成されるかを指定します。次の値が許可されます。
デフォルトブート環境作成ポリシー create-backup を適用します。
次のブート時にアクティブに設定されている新しいブート環境でパッケージ操作を実行するため、すべてのパッケージ操作に対してリブートを必要とします。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。
このポリシーはもっとも安全ですが、リブートしないとパッケージを追加できないため、ほとんどのサイトの要求よりも厳格です。
リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。パッケージが変更されるか、カーネルに影響を及ぼす可能性のある内容がインストールされて、ライブブート環境がこの操作の影響を受ける場合、バックアップブート環境は作成されますが、アクティブには設定されません。バックアップブート環境を明示的にリクエストすることもできます。
このポリシーは、新しくインストールされたソフトウェアによりシステムが不安定になっている場合にのみ潜在的に危険です。この可能性はありますが、比較的まれです。
リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。
ライブブート環境へのパッケージ変更によりそれ以上の変更が不可能になる場合、フォールバック可能な最近のブート環境が存在しない可能性があるため、このポリシーには最大の危険が伴います。
(文字列) SSL 操作用の CA 証明書が格納されたディレクトリを指すパス名。このディレクトリの形式は、ベースとなる SSL 実装に固有です。信頼できる CA 証明書のために別の場所を使用するには、別のディレクトリを指すようにこの値を変更します。CA ディレクトリの要件については、SSL_CTX_load_verify_locations(3openssl) の CApath に関する項目を参照してください。
デフォルト値: /etc/openssl/certs
(ブール型) True に設定されている場合、パッケージクライアントは、署名検証のために使用される証明書の CRL 配布ポイントへのアクセスを試み、発行時よりもあとに証明書が失効していないかどうかを調べます。
デフォルト値: False
(ブール型) True に設定されている場合、パッケージクライアントは、インストールまたは更新操作の完了時にその内容キャッシュ内のファイルを削除します。更新操作の場合、内容はソースブート環境からのみ削除されます。出力先ブート環境でパッケージ操作が次に発生したとき、このオプションが変更されていなければ、パッケージクライアントはその内容キャッシュをフラッシュします。
このプロパティーを使用して、ディスク容量の限られたシステムで内容キャッシュを小さく保つことができます。このプロパティーを使用すると、操作が完了するまでの時間が長くなる可能性があります。
デフォルト値: True
(ブール型) このプロパティーは、mDNS および DNS-SD を使用してリンクローカル内容ミラーを検出するようにクライアントに命令します。このプロパティーを True に設定すると、クライアントはミラーを動的に検出し、そのミラーからパッケージ内容のダウンロードを試みます。mDNS を介してその内容を通知するミラーの実行方法については、pkg.depotd(1M) のマニュアルページを参照してください。
デフォルト値: False
(ブール型) ネットワーク操作の実行時にイメージの汎用一意識別子 (UUID) を送信します。ユーザーはこのオプションを無効にできますが、一部のネットワークリポジトリは UUID を供給しないクライアントとのやり取りを拒否する場合があります。
デフォルト値: True
(文字列) イメージ内のパッケージのインストール、更新、修正、または検証時にマニフェストに対してどのチェックが実行されるかを決定します。パッケージに適用される最終的なポリシーは、イメージポリシーと発行元ポリシーの組み合わせに依存します。この組み合わせの厳格さは、少なくとも、この 2 つのポリシーが個別に適用された場合の厳格な方と同じです。デフォルトでは、パッケージクライアントは証明書が失効済みかどうかをチェックしません。そのようなチェック (クライアントから外部 Web サイトへのアクセスが必要な場合がある) を有効にするには、check-certificate-revocation イメージプロパティーを True に設定します。次の値が許可されます。
すべてのマニフェストの署名を無視します。
署名が含まれているすべてのマニフェストが有効に署名されていることを確認しますが、インストール済みパッケージがすべて署名されている必要はありません。これがデフォルト値です。
新しくインストールされたすべてのパッケージに、有効な署名が少なくとも 1 つ含まれている必要があります。インストール済みパッケージに有効な署名が含まれていない場合は、pkg fix および pkg verify コマンドでも警告が表示されます。
require-signatures と同じ要件に従いますが、signature-required-names プロパティーで一覧表示される文字列が、署名の信頼のチェーンを検証するために使用される証明書の共通名としても表示される必要があります。
(文字列のリスト) パッケージの署名の検証中に、証明書の共通名として表示される必要のある名前の一覧です。
(文字列) イメージの信頼アンカーを格納するディレクトリのパス名です。このパスはイメージに対して相対的です。デフォルト値は ignore です。
(ブール型) このプロパティーではシステムリポジトリを、イメージおよびパブリッシャー構成のソースとして、および提供されたパブリッシャーと通信するためのプロキシとしてイメージで使用するべきかどうかを指定します。デフォルト値は False です。システムリポジトリについては、pkg.sysrepo(1M) のマニュアルページを参照してください。
次のプロパティーは、特定の発行元の署名ポリシーを定義します。同じ名前のイメージプロパティーはイメージの署名ポリシーを定義します。特定の発行元のこれらのプロパティーの現在の値を表示するには、pkg publisher publisher_name コマンドを使用します。これらの発行元の署名ポリシープロパティーの値を変更するには、pkg set-publisher コマンドの --set-property オプションと --unset-property オプションを使用します。
(文字列) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。
(文字列のリスト) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。
例 1 パブリッシャーを構成してイメージを作成する
パブリッシャーを example.com として新しいフルイメージを作成し、/aux0/example_root に格納します。
$ pkg image-create -F -p example.com=http://pkg.example.com:10000 \ /aux0/example_root
例 2 追加の起点とミラーを指定してイメージを作成する
パブリッシャーを example.com として新しいフルイメージを作成し、1 つのミラーと 2 つの起点を追加し、/aux0/example_root に格納します。
$ pkg image-create -F -p example.com=http://pkg.example.com:10000 \ -g http://alternate1.example.com:10000/ \ -g http://alternate2.example.com:10000/ \ -m http://mirror.example.com:10000/ \ /aux0/example_root
例 3 パブリッシャーを構成せずにイメージを作成する
パブリッシャーを構成せずに、新しいフルイメージを /aux0/example_root に作成します。
$ pkg image-create -F /aux0/example_root
例 4 パッケージのインストール
widget パッケージの最新バージョンを現在のイメージにインストールします。
$ pkg install application/widget
例 5 パッケージの指定された内容を一覧表示する
system/file-system/zfs パッケージの内容を一覧表示します。アクション名、ファイルのモード (定義されている場合)、サイズ (定義されている場合)、パス、およびターゲット (リンクの場合) を表示します。すべてのアクションで利用可能な action.name 属性を指定するとすべてのアクションの行が表示されますが、ここでは望ましくないため、dir、file、link、および hardlink の各タイプにアクションを限定します。
$ pkg contents -t dir,file,link,hardlink \ -o action.name,mode,pkg.size,path,target system/file-system/zfs ACTION.NAME MODE PKG.SIZE PATH TARGET dir 0755 etc dir 0755 etc/fs dir 0755 etc/fs/zfs link etc/fs/zfs/mount ../../../usr/sbin/zfs link etc/fs/zfs/umount ../../../usr/sbin/zfs dir 0755 etc/zfs dir 0755 kernel dir 0755 kernel/drv dir 0755 kernel/drv/amd64 file 0755 1706744 kernel/drv/amd64/zfs file 0644 980 kernel/drv/zfs.conf dir 0755 kernel/fs dir 0755 kernel/fs/amd64 hardlink kernel/fs/amd64/zfs ../../../kernel/drv/amd64/zfs ...
例 6 2 つのパッケージの指定された内容を一覧表示する
web/browser/firefox および mail/thunderbird の内容を一覧表示します。path 属性の末尾が .desktop または .png であるアクションのパッケージ名属性およびパス属性のみに表示を限定します。
$ pkg contents -o pkg.name,path -a path=\*.desktop \ -a path=\*.png web/browser/firefox mail/thunderbird PKG.NAME PATH web/browser/firefox usr/share/applications/firefox.desktop mail/thunderbird usr/share/applications/thunderbird.desktop web/browser/firefox usr/share/pixmaps/firefox-icon.png mail/thunderbird usr/share/pixmaps/thunderbird-icon.png ...
例 7 パッケージを検索する
パッケージデータベースからトークン bge を検索します。
$ pkg search bge INDEX ACTION VALUE PACKAGE driver_name driver bge pkg:/driver/network/ethernet/bge@0.5.11-0.175.0.0.0.2.1 basename file kernel/drv/sparcv9/bge pkg:/driver/network/ethernet/bge@0.5.11-0.175.0.0.0.2.1 basename file kernel/drv/amd64/bge pkg:/driver/network/ethernet/bge@0.5.11-0.175.0.0.0.2.1 basename file platform/sun4v/kernel/drv/sparcv9/bge pkg:/system/kernel/platform@0.5.11-0.175.0.0.0.2.1 pkg.fmri set solaris/driver/network/bge pkg:/driver/network/bge@0.5.11-0.173.0.0.0.1.0 pkg.fmri set solaris/driver/network/ethernet/bge pkg:/driver/network/ethernet/bge@0.5.11-0.175.0.0.0.2.1
このトークンはパッケージ driver/network/bge 内に、/kernel/drv/ arch/bge を表すファイルアクションのベース名として、およびドライバ名として存在します。
例 8 ファイルの検索
先頭のスラッシュ文字を含むファイルのフルパス名を指定して、ファイルを提供するパッケージを検索します。
$ pkg search -o path,pkg.name -l /usr/bin/vim PATH PKG.NAME usr/bin/vim editor/vim/vim-core
action_name に file を指定し、index に path または basename を指定し、token に完全または部分的なファイル名を指定することにより、ファイルおよびそのファイルを提供するパッケージを検索します。
$ pkg search -o path,pkg.name -l file:basename:vim PATH PKG.NAME usr/bin/vim editor/vim/vim-core
例 9 ファイルとディレクトリの検索
index に path または basename を、token に完全または部分的なファイル名を指定することにより、ファイルとディレクトリ、およびそれらを提供するパッケージを検索します。使用するシェルによっては、ワイルドカードをエスケープする必要があります。
$ pkg search -o path,pkg.name -l path:*/vim PATH PKG.NAME usr/bin/vim editor/vim/vim-core usr/share/vim editor/vim usr/share/vim editor/vim/vim-core $ pkg search -o path,pkg.name -l basename:vim PATH PKG.NAME usr/share/vim editor/vim usr/share/vim editor/vim/vim-core usr/bin/vim editor/vim/vim-core
例 10 どのパッケージがどの SMF サービスを提供するかを表示する
構造化された検索内で index に値 org.opensolaris.smf.fmri を指定し、 token に検索対象のサービスの名前を指定することにより、特定の SMF サービスを提供するのはどのパッケージかを表示します。値 org.opensolaris.smf.fmri は、set アクションの属性の名前です。サービスの名前では、「:」を確実にエスケープしてください。
たとえば、使用可能な HTTP サーバーを表示するには、token に値 svc:/network/http を指定します。
$ pkg search 'org.opensolaris.smf.fmri:svc\:/network/http*' INDEX ACTION VALUE PACKAGE org.opensolaris.smf.fmri set svc:/network/http pkg:/web/server/lighttpd-14@1.4.23-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http pkg:/web/proxy/privoxy@3.0.17-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http pkg:/web/proxy/squid@3.1.18-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http pkg:/web/java-servlet/tomcat@6.0.35-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http pkg:/web/server/apache-22@2.2.22-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http:apache22 pkg:/web/server/apache-22@2.2.22-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http:lighttpd14 pkg:/web/server/lighttpd-14@1.4.23-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http:privoxy pkg:/web/proxy/privoxy@3.0.17-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http:squid pkg:/web/proxy/squid@3.1.18-0.175.0.0.0.2.1 org.opensolaris.smf.fmri set svc:/network/http:tomcat6 pkg:/web/java-servlet/tomcat@6.0.35-0.175.0.0.0.2.1
例 11 指定されたパッケージに依存するパッケージを検索する
package/pkg に依存するインストール済みパッケージを検索します。
$ pkg search -l depend::package/pkg INDEX ACTION VALUE PACKAGE incorporate depend package/pkg@0.5.11-0.175.0.0.0.2.1 pkg:/consolidation/ips/ips-incorporation@0.5.11-0.175.0.0.0.2.1 require depend pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 pkg:/package/pkg/package-manager@0.5.11-0.175.0.0.0.2.1 require depend pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 pkg:/system/library/install@0.5.11-0.175.0.0.0.2.1 require depend pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 pkg:/package/pkg/update-manager@0.5.11-0.175.0.0.0.2.1 require depend pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 pkg:/system/library/boot-management@0.5.11-0.175.0.0.0.2.1 require depend package/pkg pkg:/system/zones/brand/brand-solaris@0.5.11-0.175.0.0.0.2.1 require depend pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 pkg:/install/distribution-constructor@0.5.11-0.175.0.0.0.2.1 require depend pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 pkg:/system/boot-environment-utilities@0.5.11-0.175.0.0.0.2.1 require depend pkg:/package/pkg@0.5.11-0.175.0.0.0.2.1 pkg:/package/pkg/system-repository@0.5.11-0.175.0.0.0.2.1
例 12 依存関係を検索する
インストール済みパッケージ内のすべての incorporate 依存関係を検索します。
$ pkg search -l depend:incorporate: INDEX ACTION VALUE PACKAGE incorporate depend pkg:/BRCMbnx@0.5.11-0.175.0.0.0.2.1 pkg:/consolidation/osnet/osnet-incorporation@0.5.11-0.175.0.0.0.2.1 incorporate depend pkg:/BRCMbnxe@0.5.11-0.175.0.0.0.2.1 pkg:/consolidation/osnet/osnet-incorporation@0.5.11-0.175.0.0.0.2.1 ...
例 13 発行元を追加
新しいパブリッシャー example.com を追加し、リポジトリの場所を http://www.example.com/repo に設定します。
$ pkg set-publisher -g http://www.example.com/repo example.com
例 14 鍵と証明書を指定してパブリッシャーを追加する
新しいパブリッシャー example.com を追加し、セキュリティー保護されたリポジトリの場所を https://secure.example.com/repo に設定し、鍵および証明書をディレクトリ /root/creds に格納します。
$ pkg set-publisher -k /root/creds/example.key \ -c /root/creds/example.cert -g https://secure.example.com/repo \ example.com
例 15 パブリッシャーを追加して自動構成する
自動設定を使用して新しいパブリッシャーを追加し、リポジトリの場所を /export/repo に設定します。
$ pkg set-publisher -p /export/repo
例 16 パブリッシャーを追加して手動構成する
手動設定を使用して新しいパブリッシャー example.com を追加し、リポジトリの場所を /export/repo/example.com に設定します。
$ pkg set-publisher -g /export/repo example.com
例 17 発行元を追加してプロキシを構成する
起点 http://server/repo とプロキシ http://webcache:8080 を使用して新しい発行元 mypub を追加します。
$ pkg set-publisher -g http://server/repo \ --proxy http://webcache:8080 mypub
例 18 すべての署名付きパッケージを検証する
すべての署名付きパッケージを検証するようにイメージを構成します。
$ pkg set-property signature-policy verify
例 19 すべてのパッケージで署名を必須にする
すべてのパッケージで署名を必須とするように、また、いずれかの証明書で文字列 example.com が共通名として信頼チェーンに出現することを必須とするようにイメージを構成します。
$ pkg set-property signature-policy require-names example.com
例 20 指定したパブリッシャーからのすべてのパッケージで署名を必須にする
パブリッシャー example.com からインストールされるすべてのパッケージで署名を必須とするようにイメージを構成します。
$ pkg set-publisher --set-property signature-policy=require-signatures \ example.com
例 21 信頼チェーンで指定された文字列を必須にする
有効とみなされるために署名の信頼チェーンに存在する必要がある文字列 foo をイメージの共通名の一覧に追加します。
$ pkg add-property-value signature-require-names foo
例 22 指定されたパブリッシャーの信頼チェーンから文字列を削除する
パブリッシャー example.com の署名を検証するために存在する必要がある文字列 foo を共通名の一覧から削除します。
$ pkg set-publisher --remove-property-value signature-require-names=foo \ example.com
例 23 信頼できる CA 証明書を追加する
/tmp/example_file.pem に格納された証明書を、パブリッシャー example.com の信頼できる CA 証明書として追加します。
$ pkg set-publisher --approve-ca-cert /tmp/example_file.pem \ example.com
例 24 証明書を失効させる
a12345 というハッシュを持つ、パブリッシャー example.com 用の証明書を失効させ、example.com からのパッケージの署名をその証明書で検証しないようにします。
$ pkg set-publisher --revoke-ca-cert a12345 example.com
例 25 証明書を抹消する
証明書 a12345 がユーザーによって追加または失効させられたことを pkg から抹消します。
$ pkg set-publisher --unset-ca-cert a12345 example.com
例 26 パッケージをダウングレードする
インストール済みパッケージ foo@1.1 を古いバージョンにダウングレードします。
$ pkg update foo@1.0
例 27 競合するパッケージインストールを切り替える
2 つのパッケージが競合している場合に、どちらのパッケージがインストールされるかを切り替えます。パッケージ A がパッケージ B または C のどちらかに依存し、B および C は相互排他であるとします。A と B がインストールされる場合に、次のコマンドを使用して、A をアンインストールせずに B の代わりに C を使用するように切り替えます。
$ pkg install --reject B C
例 28 パッケージアーカイブ内のパッケージを一覧表示する
パッケージアーカイブ内のすべてのパッケージのすべてのバージョンを一覧表示します。
$ pkg list -f -g /my/archive.p5p
例 29 パッケージリポジトリ内のパッケージを一覧表示する
リポジトリ内のすべてのパッケージのすべてのバージョンを一覧表示します。
$ pkg list -f -g http://example.com:10000
例 30 パッケージアーカイブ内のパッケージについての情報を表示する
パッケージアーカイブ内のパッケージの最新バージョンのパッケージ情報を表示します。パッケージが現在インストールされていてもいなくてもかまいません。
$ pkg info -g /my/archive.p5p pkg_name
例 31 パッケージアーカイブ内のパッケージの内容を表示する
パッケージアーカイブ内のパッケージの内容を表示します。パッケージは現在インストールされていません。
$ pkg contents -g /my/archive.p5p pkg_name
例 32 パブリッシャーの起点とミラーをすべて削除する
パブリッシャーのすべての起点およびミラーを削除し、新しい起点を追加します。
$ pkg set-publisher -G '*' -M '*' -g http://example.com:10000 \ example.com
パッケージ操作に使用するイメージが含まれるディレクトリ。-R を指定した場合は無視されます。
トランスポート操作中に接続しようとするのを待機する秒数 (試行ごと)。これが経過するとクライアントは操作を中止します。値 0 は無制限に待機することを意味します。
デフォルト値: 60
トランスポート操作中に lowspeed 制限 (1024 バイト/秒) を下回っていられる秒数。これが経過するとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。
デフォルト値: 30
一時的なトランスポートエラーの最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。
デフォルト値: 4
トランスポート操作中に許可される HTTP または HTTPS リダイレクトの最大数。これを上回ると接続が中止されます。値 0 は、操作を中止しないことを意味します。
デフォルト値: 5
同時に更新する子イメージの数。-C オプションが指定されている場合には、無視されます。
子イメージ (通常はゾーン) 内への再帰時に、最大 $PKG_CONCURRENCY 個の子イメージを同時に更新します。$PKG_CONCURRENCY が 0 または負数の場合は、すべての子イメージが同時に更新されます。
デフォルト値: 1
ホストあたりのトランスポート試行の最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。
デフォルト値: 4
HTTP または HTTPS プロキシサーバー。
次の終了ステータスが返されます。
コマンドが成功しました。
エラーが発生した。
無効なコマンド行オプションが指定された。
複数の操作が要求されましたが、それらの一部のみが成功しました。
変更が行われませんでした - 何もしません。
要求された操作はライブイメージでは実行できません。
インストールまたは更新中のパッケージのライセンスが受け入れられなかったため、要求された操作を完了できません。
イメージは現在別のプロセスによって使用されているため、変更できません。
予期しない例外が発生しました。
pkg(5) イメージは、より大きなファイルシステム内の任意の場所に置くことができます。次のファイル説明で、トークン $IMAGE_ROOT は相対パスを区別するために使用されています。一般的なシステムインストールでは、 $IMAGE_ROOT は / と等価です。
完全または部分的なイメージのメタデータディレクトリ。
ユーザーイメージのメタデータディレクトリ。
特定のイメージのメタデータ内のファイルやディレクトリによっては、修復および復旧中に使用される情報が含まれている可能性があります。トークン $IMAGE_META は、メタデータが含まれる最上位ディレクトリを参照します。$IMAGE_META は通常、上に示した 2 つのパスのいずれかです。
パッケージ操作中に移動された、競合するディレクトリおよびファイルの場所。削除されたディレクトリのパッケージ化されない内容の場所。
パブリッシャーごとに 1 つのディレクトリが含まれます。各ディレクトリにはパブリッシャー固有のメタデータが格納されます。
$IMAGE_META ディレクトリ階層内のほかのパスは非公開であり、変更される可能性があります。
次の属性については、attributes(5) を参照してください。
|
pkgsend(1), pkg.depotd(1M), glob(3C), pkg(5), beadm(1M)
http://hub.opensolaris.org/bin/view/Project+pkg/