pkg - マニュアルページセクション 1: ユーザーコマンド

言語:

pkg(1)

名前

pkg - 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]...
    [-r [[-z zonename]... | [-Z zonename]... ]]
    [--accept] [--licenses] [--no-index] [--no-refresh]
    [--no-be-activate]
    [--no-backup-be | --require-backup-be]
    [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name]
    [--reject pkg_fmri_pattern]...
    [--sync-actuators | --sync-actuators-timeout timeout]
    pkg_fmri_pattern ...

/usr/bin/pkg exact-install [-nvq] [-C n] [-g path_or_uri]...
    [--accept] [--licenses] [--no-index] [--no-refresh]
    [--no-be-activate]
    [--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]
    [-r [[-z zonename]... | [-Z zonename]... ]]
    [--ignore-missing] [--no-index] [--no-be-activate]
    [--no-backup-be | --require-backup-be]
    [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name]
    [--sync-actuators | --sync-actuators-timeout timeout]
    pkg_fmri_pattern ...

/usr/bin/pkg update [-fnvq] [-C n] [-g path_or_uri]...
    [-r [[-z zonename]... | [-Z zonename]... ]]
    [--accept] [--ignore-missing] [--licenses]
    [--no-index] [--no-refresh] [--no-be-activate]
    [--no-backup-be | --require-backup-be]
    [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name]
    [--reject pkg_fmri_pattern]...
    [--sync-actuators | --sync-actuators-timeout timeout]
    [pkg_fmri_pattern ...]

/usr/bin/pkg list [-Hafnqsuv] [-g path_or_uri]...
    [--no-refresh] [pkg_fmri_pattern ...]

/usr/bin/pkg info [-lqr] [-g path_or_uri]... [--license]
    [pkg_fmri_pattern ...]

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

/usr/bin/pkg search [-HIaflpr]
    [-o attribute[,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 [-Haiv] [-F format] [variant_pattern ...]

/usr/bin/pkg change-variant [-nvq] [-C n] [-g path_or_uri]...
    [-r [[-z zonename]... | [-Z zonename]... ]]
    [--accept] [--licenses] [--no-be-activate]
    [--no-backup-be | --require-backup-be]
    [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name]
    [--sync-actuators | --sync-actuators-timeout timeout]
    variant_name=value ...

/usr/bin/pkg facet [-Haim] [-F format] [facet_pattern ...]

/usr/bin/pkg change-facet [-nvq] [-C n] [-g path_or_uri]...
    [-r [[-z zonename]... | [-Z zonename]... ]]
    [--accept] [--licenses] [--no-be-activate]
    [--no-backup-be | --require-backup-be]
    [--backup-be-name name]
    [--deny-new-be | --require-new-be] [--be-name name]
    [--sync-actuators | --sync-actuators-timeout timeout]
    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] [-c ssl_cert] [-k ssl_key]
    [-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]...
    [--disable] [--enable] [--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]
    [-c ssl_cert] [-k ssl_key] [--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]
    [-n number] [-o column[,column]...]...
    [-t time | time-time[,time | time-time]...]...

/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]
    [-c ssl_cert] [-k ssl_key]
    [-g path_or_uri | --origin path_or_uri]...
    [-m uri | --mirror uri]...
    [--facet facet_name=(True|False)]... [--no-refresh]
    [--set-property name_of_property=value]
    [--variant variant_name=value]...
    [(-p | --publisher) [name=]repo_uri] dir

説明

pkg は Image Packaging System 用の取得クライアントです。有効な構成では、pkg を呼び出すことにより、パッケージをインストールする場所を作成し、イメージを呼び出し、パッケージをイメージにインストールすることができます。パッケージはパブリッシャーによって公開され、パブリッシャーはそれらのパッケージを 1 つ以上のリポジトリまたはパッケージアーカイブで利用可能にすることができます。pkg はパブリッシャーのリポジトリまたはパッケージアーカイブからパッケージを取得し、パッケージをイメージにインストールします。

パッケージは、BE の一部であるファイルシステムにのみインストールできます。たとえば、デフォルトの Oracle Solaris 11 インストール環境では、パッケージ操作がサポートされるのは、rpool/ROOT/BEname/ の下のデータセットのみです。

パブリッシャーの名前によって、人、人のグループ、または組織が 1 つ以上のパッケージのソースとして識別されます。パブリッシャーの名前の競合を避け、パブリッシャーを識別しやすくするために、パッケージを公開するエンティティーを表すドメイン名をパブリッシャーの名前として使用することがベストプラクティスです。

リポジトリは、クライアントがパッケージの内容 (プログラムやドキュメントなど、パッケージの内部に含まれるファイル) とメタデータ (パッケージの名前や説明など、パッケージについての情報) を公開および取得できる場所です。たとえば、example.org という名前のパブリッシャーは、http://example.org/repository という URI にリポジトリを配置することができます。

pkg では、パッケージをアンインストールしたり、(利用可能なパッケージの一覧などの) パブリッシャーメタデータをリフレッシュしたり、イメージにインストールされたパッケージを検証したり、イメージからさまざまなトークンを照会したりすることもできます。これらのクエリーは pkg(5) リポジトリで構成することもできます。

イメージには 3 つの種類があります。完全なシステムを提供できるフルイメージ、フルイメージ (親イメージ) にリンクされるがそれ自身では完全なシステムを提供しない部分イメージ、およびユーザーイメージです。

オプション

サポートしているオプションは、次のとおりです。

–?
–-help: 使用方法に関するメッセージを表示します。
–R dir: dir をルートとするイメージを操作します。ディレクトリが指定されなかったか、または環境に基づいて決定される場合、デフォルトは / です。詳細は、「環境変数」のセクションを参照してください。

サブコマンド

サポートされているサブコマンドは次のとおりです。

pkg refresh [–q] [– -full] [publisher ...]

クライアントの利用可能パッケージの一覧およびすべてのパブリッシャーのパブリッシャーメタデータを更新します。

publisher: クライアントの利用可能パッケージの一覧、および指定されたパブリッシャーのパブリッシャーメタデータのみを更新します。
–q: リクエストされた操作の実行中、進捗状況メッセージを表示しません。
–-full: 増分更新を試みる代わりにすべての発行元メタデータを強制的に完全取得し、操作中に使用されるすべてのプロキシでキャッシュデータを無視するようにリクエストします。このオプションはトラブルシューティング目的に用意されており、通常時は使用しないでください。

pkg install [–nvq] [–C n] [–g path_or_uri]... [–r [[–z zonename]... | [–Z zonename]... ]] [–-accept] [–-licenses] [–-no-index] [–-no-refresh] [–-no-be-activate] [–-no-backup-be | –-require-backup-be] [–-backup-be-name name] [–-deny-new-be | –-require-new-be] [–-be-name name] [–-reject pkg_fmri_pattern]... [–-sync-actuators | –-sync-actuators-timeout timeout] pkg_fmri_pattern ...

指定されたパッケージをインストールし、イメージにインストールされたパッケージで許容されている pkg_fmri_pattern と一致する最新バージョンにパッケージを更新します。パッケージの最新バージョンを明示的に要求するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。pkg_fmri_pattern パターンには、glob(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する ? および * 文字を含めることができます。

パッケージは、発行元検索順およびスティッキネスに基づいて選択されます。検索順およびスティッキネスについては、pkg publisher および pkg set-publisher コマンドを参照してください。pkg_fmri_pattern が発行元を指定しない場合、一致するパッケージを提供する最初の発行元がインストール元として使用されます。該当する発行元がこのイメージ内にインストール可能なパッケージのバージョンを提供しない場合、インストール操作は失敗します。このイメージにインストール可能なパッケージのバージョンを提供する発行元を確認するには、pkg list -a コマンドを使用します。

複数の pkg_fmri_pattern が指定され、かつ指定されたパッケージのいずれかをこのイメージにインストールできない場合、指定されたパッケージは一切インストールされません。

インストールプロセスの間に、一部の構成ファイルの名前変更または置換が行われる場合があります。どのファイルを保持するかをパッケージシステムが決定する方法と、パッケージ操作中にファイルが保持されるしくみについては、pkg(5) のマニュアルページのファイルアクションに関する項目を参照してください。

パッケージが回避リストにある場合は、インストールすると回避リストから削除されます。

–C n

同時に更新する子イメージの数を指定します。子イメージ (通常はインストールされている solaris ブランドの非大域ゾーン) 内への再帰時に、最大 n 個の子イメージを同時に更新します。更新する子イメージのデフォルト数は、1 です。n が 0 または負数の場合は、すべての子イメージが同時に更新されます。「環境変数」セクションの「PKG_CONCURRENCY」も参照してください。

–g path_or_uri

指定されたパッケージリポジトリまたはアーカイブを、パッケージデータの取得元になるイメージ内のソースリストに一時的に追加します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。

どのバージョンのパッケージを使用するかを決定するときは、イメージ内に構成されているが、指定された path_or_uri ソースに見つからない発行元が優先されます。インストールするパッケージのバージョンが、イメージ内で構成されている発行元および path_or_uri ソースから提供されている場合、クライアントはそのパッケージの内容を path_or_uri ソースから取得します。インストールまたは更新のあとに、発行元によって提供され、イメージ内で構成されていないパッケージがある場合は、起点なしでイメージ構成に追加されます。イメージ内で構成されている発行元を表示するには、pkg publisher コマンドを使用します。

–n

パッケージの変更は行わずに試しに操作を実行します。

–q

リクエストされた操作の実行中、進捗状況メッセージを表示しません。

–r

大域ゾーンおよびインストールされているすべての solaris ブランドの非大域ゾーンで、この操作を実行します。非大域ゾーンへの影響は、各非大域ゾーンにログインして、コマンドを直接実行した場合と似ています。このオプションを指定しないと、大域ゾーンで pkg コマンドを実行した場合、非大域ゾーンは大域ゾーンと互換性を保つために必要な程度でのみ変更されます。このオプションを指定すると、pkg 操作は、–z および –Z オプションで制限されているものを除く、インストールされているすべての非大域ゾーンに適用されます。–z および –Z オプションによって除外されたゾーンは、大域ゾーンと同期を保つために更新が必要な場合、変更される可能性があります。

–z zonename

指定された非大域ゾーンでのみこの操作を実行します。–z オプションは複数回指定できます。–z オプションは、–r オプションと同時に指定した場合のみ使用できます。–z オプションは –Z オプションと一緒に使用できません。

–Z zonename

指定されたゾーンを除くすべての非大域ゾーンでこの操作を実行します。–Z オプションは複数回指定できます。–Z オプションは、–r オプションと同時に指定した場合のみ使用できます。–Z オプションは –z オプションと一緒に使用できません。

–v

リクエストされた操作の実行中に詳細な進捗状況メッセージを出力し、詳細な計画情報 (ファセット、メディエータ、バリアントの変更など) を表示します。このオプションを複数回指定して、表示される計画情報の量を増やすことができます。

–-accept

更新またはインストールされるパッケージのライセンス条項に同意することを示します。このオプションを指定しないと、パッケージのライセンスに同意が必要になった場合、インストール操作は失敗します。

–-licenses

この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示します。更新されるパッケージの場合、ライセンスが変更された場合のみライセンスを表示します。

–-no-index

操作が正常に完了したあとに検索インデックスを更新しません。

–-no-refresh

入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。

–-no-be-activate

ブート環境が作成される場合に、それを次回ブート時にアクティブなブート環境として設定しません。詳細は、beadm(1M) のマニュアルページを参照してください。

–-no-backup-be

バックアップブート環境を作成しません。

–-require-backup-be

新しいブート環境が作成されない場合に、常にバックアップブート環境を作成します。このオプションを指定しないと、イメージポリシーに基づいてバックアップブート環境が作成されます。バックアップブート環境がいつ自動的に作成されるかについての説明は、次の「イメージプロパティー」の be-policy を参照してください。

–-backup-be-name name

指定された引数を使って、作成されたバックアップブート環境に名前を付けます。–-backup-be-name を使用すると –-require-backup-be が暗黙的に指定されます。beadm(1M) のマニュアルページも参照してください。

–-deny-new-be

新しいブート環境を作成しません。新しいブート環境が必要な場合、この操作は実行されません。

–-require-new-be

常に新しいブート環境を作成します。このオプションを指定しないと、イメージポリシーに基づいてブート環境が作成されます。ブート環境がいつ自動的に作成されるかについての説明は、次の「イメージプロパティー」の be-policy を参照してください。このオプションを –-require-backup-be と組み合わせることはできません。

–-be-name name

新たに作成されたブート環境の名前を、指定された引数になるように変更します。–-be-name の使用は、暗黙的に –-require-new-be を示します。beadm(1M) のマニュアルページも参照してください。

–-reject pkg_fmri_pattern

指定されたパターンと一致する名前を持つパッケージはインストールされません。一致するパッケージがすでにインストールされている場合、それらはこの操作の一環として削除されます。グループ依存関係のターゲットである拒否対象パッケージは回避リストに登録されます。このオプションは複数回指定できます。

–-sync-actuators

SMF アクチュエータを同期的に実行します。pkg(1) コマンドは、pkg が呼び出されたゾーン (大域ゾーンまたは非大域ゾーン) ですべての SMF アクチュエータが完了するまで戻りません。

–-sync-actuators-timeout timeout

SMF アクチュエータを同期的に実行します。アクチュエータが指定された timeout (秒単位) までに完了しない場合、pkg(1) は操作を継続し、リターンコード 8 で終了します。

pkg exact-install [–nvq] [–C n] [–g path_or_uri]... [–-accept] [–-licenses] [–-no-index] [–-no-refresh] [–-no-be-activate] [–-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 ...

指定されたパッケージを、空のシステムにインストールする場合と同じようにインストールまたは更新します。以前にインストールされたパッケージのうち、コマンド行で指定されず、指定されたパッケージの依存関係でもないものは、削除されます。このコマンドは、回避リストに含まれるパッケージのインストールや凍結リストに含まれるパッケージの更新を行わないようにする制約を無視します。それ以外については、この exact-install サブコマンドは install サブコマンドと同じように動作します。パッケージの最新バージョンを明示的に要求するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。

パッケージは、発行元検索順およびスティッキネスに基づいて選択されます。検索順およびスティッキネスについては、pkg publisher および pkg set-publisher コマンドを参照してください。pkg_fmri_pattern でパブリッシャーを指定しない場合は、一致するパッケージを提供する最初のパブリッシャーがインストール元として使用されます。該当する発行元がこのイメージ内にインストール可能なパッケージのバージョンを提供しない場合、インストール操作は失敗します。このイメージにインストール可能なパッケージのバージョンを提供する発行元を確認するには、pkg list -a コマンドを使用します。

パッケージが回避リストにある場合は、インストールすると回避リストから削除されます。

オプションの説明については、前述の install コマンドを参照してください。

pkg uninstall [–nvq] [–C n] [–r [[–z zonename]... | [–Z zonename]... ]] [–-ignore-missing] [–-no-index] [–-no-be-activate] [–-no-backup-be | –-require-backup-be] [–-backup-be-name name] [–-deny-new-be | –-require-new-be] [–-be-name name] [–-sync-actuators | –-sync-actuators-timeout timeout] pkg_fmri_pattern ...

pkg_fmri_pattern に一致するインストール済みパッケージを削除します。

パッケージがグループ依存関係の対象である場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。後述する avoid サブコマンドを参照してください。

コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、それが次回リブート時のデフォルトのブート環境になります。ブート環境の管理については、beadm(1M) のマニュアルページを参照してください。

–-ignore-missing: インストールされていないパッケージを無視します。このオプションを使用すると、pkg uninstall で現在インストールされていないパッケージをアンインストールしようとしたときに、失敗しなくなります。

その他のすべてのオプションについては、前述の install コマンドを参照してください。

pkg update [–fnvq] [–C n] [–g path_or_uri]... [–r [[–z zonename]... | [–Z zonename]... ]] [–-accept] [–-ignore-missing] [–-licenses] [–-no-index] [–-no-refresh] [–-no-be-activate] [–-no-backup-be | –-require-backup-be] [–-backup-be-name name] [–-deny-new-be | –-require-new-be] [–-be-name name] [–-reject pkg_fmri_pattern]... [–-sync-actuators | –-sync-actuators-timeout timeout] [pkg_fmri_pattern ...]

現在のイメージ内のすべてのインストール済みパッケージを、インストール済みパッケージと発行元構成によりシステムに適用される制約で許可される最新のバージョンに更新します。

コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、それが次回、–-no-be-activate オプションを指定しない場合のリブート時のデフォルトブート環境になります。ブート環境の管理については、beadm(1M) のマニュアルページを参照してください。

pkg_fmri_pattern

現在のイメージにインストール済みの、指定されたパッケージのみを更新します。指定された pkg_fmri_pattern パターンの 1 つがアスタリスク (*) である場合は、pkg_fmri_pattern を指定しなかった場合と同じ方法で現在のイメージ内のすべてのインストール済みパッケージを更新します。

パッケージの最新バージョンを明示的に要求するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。

すでにインストールされているものより古い、または新しいバージョンを指定することで、特定のパッケージのインプレースダウングレードまたはアップグレードを実行できます。パッケージの名前変更または廃止の境界をまたがった特定パッケージの更新はサポートされていません。

保持される構成ファイルのうち、ダウングレードされるパッケージの一部であり、元のバージョンがインストールされたあとに変更されたファイルは、拡張子 .update を使用して名前が変更されます。どのファイルを保持するかをパッケージシステムが決定する方法と、パッケージアップグレード中にファイルが保持されるしくみについては、pkg(5) のマニュアルページのファイルアクションに関する項目を参照してください。

複数の pkg_fmri_pattern が指定され、かつ指定されたパッケージのいずれかをこのイメージに更新できない場合、指定されたパッケージは一切更新されません。

–f

すべてのインストール済みパッケージを更新するときにクライアントに対する最新状態チェックを実行しません。

–-ignore-missing

インストールされていないパッケージを無視します。このオプションを使用すると、pkg update で現在インストールされていないパッケージを更新しようとしたときに、失敗しなくなります。

その他のすべてのオプションについては、前述の install コマンドを参照してください。

pkg list [–Hafnqsuv] [–g path_or_uri]... [–-no-refresh] [pkg_fmri_pattern ...]

バージョンやインストール状態などの情報を含む、現在のイメージ内のインストール済みの全パッケージのリストを表示します。デフォルトでは、異なるアーキテクチャーまたはゾーンタイプのパッケージバリアントは除外されます。通常の出力は 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 つです)。

pkg_fmri_pattern: 指定したパッケージのみを一覧表示します。
–H: 一覧からヘッダーを省略します。
–a: このイメージにインストールされているパッケージと、インストールされていないが、インストール可能なパッケージの最新バージョンを一覧表示します。パッケージがインストール済みの incorporation およびイメージのバリアントによって許可されている場合は、それらをインストールできます。1 つ以上のパターンを指定した場合、指定されたパターンに一致し、インストール済みの incorporation およびイメージのバリアントによって許可されている最新バージョンが一覧表示されます。–a を指定しない場合、インストール済みパッケージのみを一覧表示します。
–af: incorporation の制約またはインストール状態に関係なく、すべてのバリアントについてすべてのパッケージのすべてのバージョンを一覧表示します。これらのオプションを使用するとき、パッケージの最新バージョンを明示的に一覧表示するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。
–g path_or_uri: 指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。–n を指定しない場合、–g を使用すると –a が暗黙的に指定されます。
–n: インストール状態に関係なく、すべての既知のパッケージの最新バージョンを表示します。
–q: パッケージを一覧表示しませんが、致命的エラーが発生した場合は失敗を返します。
–s: パッケージ名とサマリーを示す 1 行の短縮形式を表示します。このオプションは –a、–n、または –u とともに使用できます。
–u: 新しいバージョンが入手可能なインストール済みパッケージを一覧表示します。このオプションは –g とともに使用できません。
–v: 発行元と完全バージョンを含む、フルパッケージ FMRI をすべて最初の列に表示します (VERSION 列は消えます)。このオプションは –a、–n、または –u とともに使用できます。
–-no-refresh: 入手可能パッケージの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。

pkg info [–lqr] [–g path_or_uri]... [–-license] [pkg_fmri_pattern ...]

現在のイメージにインストールされているすべてのパッケージについての情報を、人間が判読できる形式で表示します。

pkg_fmri_pattern: 指定したパッケージの情報のみを表示します。
–g path_or_uri: 指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。–g を使用すると –r が暗黙的に指定されます。
–l: インストール済みのパッケージの情報だけを表示します。これはデフォルトです。
–q: パッケージ情報を表示しませんが、致命的エラーが発生した場合は失敗を返します。
–r: 最新の入手可能バージョンに基づいてパッケージを照合し、イメージの構成済みパブリッシャーのリポジトリから、現在インストールされていないパッケージの情報を取得します (必要な場合)。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。–r を指定しない場合、デフォルトでインストール済みパッケージのみが表示されます。
–-license: パッケージのライセンステキストを表示します。このオプションは、–l、–q、または –r と組み合わせることができます。すべての pkg_fmri_pattern パターンが既知の問題のパッケージと一致し、ライセンスを持つ場合、成功を返します。1 つ以上のパターンが一致しないか、ライセンスを持たないパッケージと一致した場合、失敗を返します。

pkg contents [–Hmr] [–a attribute=pattern]... [–g path_or_uri]... [–o attribute[,attribute]...]... [–s sort_key] [–t action_name[, action_name]...]... [pkg_fmri_pattern ...]

イメージ内のすべてのインストール済みパッケージの内容 (アクション属性) を表示します。オプションが指定されていない場合、現在のイメージにインストールされているアクションの path 属性の値をアルファベット順で並べ替えて表示します。アクションとそれらの属性については、pkg(5) のマニュアルページのアクションに関する項目を参照してください。下の疑似属性名のリストも参照してください。

pkg_fmri_pattern: 指定したパッケージの内容のみを表示します。
–H: 出力からヘッダーを省略します。
–a attribute= pattern: 名前がオプション引数で指定され、値がオプション引数の (glob) pattern に一致する attribute を持つアクションに出力を限定します。このオプションは複数回指定できます。複数の –a オプションを指定した場合、それらのいずれかに一致するアクションが表示されます。
–g path_or_uri: 指定されたパッケージリポジトリまたはアーカイブからこのイメージにインストール可能なパッケージの情報を表示します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションは複数回指定できます。–g を使用すると –r が暗黙的に指定されます。
–m: このイメージにインストールできないアクションを含めて、指定されたパッケージのすべてのアクションのすべての属性を表示します。
–o attribute: 指定された属性を、リストの先頭属性の値に従って並べ替えて表示します。–o オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの –o オプションの引数として複数の属性を指定できます。要求された属性を持つアクションのみが表示されます。
–r: このイメージ内で構成された発行元のリポジトリからこのイメージにインストール可能なパッケージの最新バージョンの情報を表示します。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。
–s sort_key: 指定されたアクション属性で、アクションをソートします。このオプションを指定しない場合、デフォルトではパスによって、または –o オプションで最初に指定された属性によってソートします。–s オプションは複数回指定できます。
–t action_name: 指定されたアクションのみを一覧表示します。–t オプションは複数回指定できます。または、アクション名をコンマで区切ることにより、1 つの –t オプションの引数として複数のアクションを指定できます。action_name の値は、pkg(5) のマニュアルページの「アクション」内に一覧表示されているアクションのいずれかで、file、directory、driver、depend、set などです。

利便性のために、いくつかの特殊な疑似属性名を使用できます。

action.hash: アクションがペイロードを伝送する場合、アクションのハッシュの値です。
action.key: アクションのキー属性の値です。たとえば、file アクションの場合、鍵属性はファイルのパスです。キー属性のないアクションもあります。
action.name: アクションの名前です。たとえば、ファイルアクションの場合、これは file です。
action.raw: 一致するアクションのすべての属性。
pkg.fmri: アクションを包含しているパッケージのフル形式 FMRI (たとえば、pkg://solaris/group/feature/amp@0.5.11,5.11-0.175.0.0.0.2.1:20120705T153434Z) です。
pkg.name: アクションを包含しているパッケージの名前 (たとえば、web/amp) です。
pkg.publisher: アクションを包含しているパッケージの発行元 (たとえば、solaris) です。
pkg.shortfmri: アクションを包含しているパッケージのショート形式 FMRI (pkg://solaris/group/feature/amp@0.5.11,5.11-0.175 など) です。

関連するサブコマンドは contents および search であり、どちらもパッケージの内容についてシステムをクエリーします。contents サブコマンドは、1 つまたは複数のインストールされているか、インストール可能なパッケージ内のアクションを、指定されたオプションに基づいて出力をフィルタ処理して表示します。search サブコマンドは逆方向からクエリーを行い、ユーザーが指定したトークンを含むすべてのパッケージの名前を表示します。

各サブコマンドで実行できるクエリーの一部は、他方でも実行できます。サブコマンドの選択は慎重に行ってください。クエリーによっては、もう一方のほうがより自然に実行できる場合があります。

pkg search [–HIaflpr] [–o attribute[,attribute]...]... [–s repo_uri] query

query と一致するアクションを検索し、一致した検索インデックス、アクション名、アクション値、およびパッケージ名を表示します。次の query の説明を参照してください。場合によっては、検索結果が重複して生成されることがあります。

–H

出力からヘッダーを省略します。

–I

大文字/小文字を区別する検索を使用します。

–a

検索を実行して、一致するアクションに関する情報を表示します。これはデフォルトです。

–f

パッケージのバージョンに関係なく、すべての結果を表示します。search はデフォルトで、現在インストールされているバージョンよりも古いパッケージ、および現在の incorporation によって除外されているパッケージバージョンからの結果を取り除きます。

–l

イメージのインストール済みパッケージを検索します。

–l と –r (または –s) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。

–o attribute

出力に含める列を指定します。–o オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの –o オプションの引数として複数の属性を指定できます。前述した疑似属性に加えて、検索結果用の次の属性が定義されています。これらの属性は、特定の結果が一致する理由をわかりやすく示しています。

search.match: 検索クエリーに一致した文字列。
search.match_type: 検索クエリーに一致した文字列を含む属性。

–p

一部のアクションが各クエリー条件に一致するパッケージを表示します。このオプションを使用することは、クエリーの各条件を山括弧 (<>) で囲むことと等価です。<> 演算子の詳細は、次の query を参照してください。

–r

イメージのパブリッシャーに対応するリポジトリを検索します。これはデフォルトです。

–l と –r (または –s) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。

–s repo_uri

指定された URI に位置する pkg(5) リポジトリを検索します。これは複数回指定できます。パッケージアーカイブはサポートされていません。

query

デフォルトでは、query は完全一致する一連の条件として解釈され、複数の条件は AND でつながれます。

AND と OR がサポートされています。

? および * 文字を glob(3C) 形式のワイルドカードとして使用でき、より柔軟なクエリー一致が可能になります。

単純なトークン一致およびワイルドカード検索に加えて、より複雑なクエリー言語がサポートされています。単一引用符または二重引用符 (' または ") を使用することにより、語句を検索できます。pkg が実際に ' または " を認識するように、必ずシェルを考慮に入れてください。

どのトークンがインデックス化されるかはアクションに依存しますが、コンテンツハッシュとパス名を含めることができます。アクションとそれらの属性については、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 に一致するアクションを包含しているパッケージの一覧です。

pkg verify [–Hqv] [ pkg_fmri_pattern ...]

現在のイメージ内で、インストールされているすべてのパッケージのインストールを検証します。関連する発行元の現在の署名ポリシーが ignore でない場合、各パッケージの署名がポリシーに基づいて検証されます。署名ポリシーが適用されるしくみについては、後述する「イメージプロパティー」の signature-policy で説明します。

pkg_fmri_pattern: 現在のイメージ内で、指定されたインストール済みパッケージのインストールのみを検証します。
–H: 検証の出力からヘッダーを省略します。
–q: リクエストされた操作の実行中、進捗状況メッセージおよびその他すべての出力を抑止します。
–v: パッケージに関する情報メッセージを含めます。

pkg fix [–-accept] [–-licenses] [pkg_fmri_pattern ...]

pkg verify で報告されたエラーをすべて修正します。インストール済みパッケージの内容は、独自の内容解析に基づいて検証されるため、ほかのプログラムの場合とは異なる結果が返されることがあります。

pkg_fmri_pattern: 現在のイメージ内で、指定されたインストール済みパッケージに対する pkg verify により報告されたエラーを修正します。
–-accept: 更新またはインストールされるパッケージのライセンス条項に同意することを示します。このオプションを指定しないと、パッケージのライセンスに同意が必要になった場合、操作は失敗します。
–-licenses: この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示します。更新されるパッケージの場合、ライセンスが変更された場合のみライセンスを表示します。

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 ...)

pkg(5) パッケージにより配布されたパッケージを、配布時の状態に戻します。ファイルの所有権および保護も復元されます。

注意 - 一部の編集可能ファイルをデフォルト値に戻すと、システムがブート不可になったり、その他の異常動作の原因になったりする可能性があります。

–-tagged tag-name: tag-name でタグ付けされたすべてのファイルを元に戻し、このタグが付けられているディレクトリの下に pattern と一致するパッケージ解除されたファイルまたはディレクトリがある場合は削除します。tag-name および pattern の詳細については、pkg(5) のマニュアルページの「ファイルアクション」および「ディレクトリアクション」で revert-tag 属性の説明を参照してください。
path-to-file: 指定されたファイルを元に戻します。

その他のすべてのオプションについては、前述の install コマンドを参照してください。

pkg mediator [–aH] [–F format] [mediator ...]

現在選択されているバージョンやすべてのメディエータの実装を表示します。

mediator: 現在選択されているバージョンや指定されたメディエータの実装のみを表示します。
–F format: 代替出力形式を指定します。format の値は、tsv (Tab Separated Values)、json (単一行としての JavaScript Object Notation)、または json-formatted (読みやすい形式にされた JavaScript Object Notation) にできます。
–H: 一覧からヘッダーを省略します。
–a: 現在インストールされているパッケージに設定可能なメディエーションを一覧表示します。

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 ...

現在のイメージ内の指定されたメディエータのバージョンと実装を設定します。

–I implementation: 使用するメディエート対象インタフェースの実装を設定します。デフォルトでは、バージョンが指定されない場合、すべての実装バージョンが許可されます。バージョンなしで実装を指定するには、アット記号 (@) を付加します。
–V version: 使用するメディエート対象インタフェースのバージョンを設定します。

指定されたメディエータのバージョンと実装のどちらかまたは両方が現在入手できない場合、指定されたメディエータを使用するリンクはすべて削除されます。

その他のすべてのオプションについては、前述の install コマンドを参照してください。

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 ...

指定されたメディエータのバージョンと実装をシステムデフォルトに戻します。

–I: メディエート対象インタフェースの実装のみを元に戻します。
–V: メディエート対象インタフェースのバージョンのみを元に戻します。

その他のすべてのオプションについては、前述の install コマンドを参照してください。

pkg variant [–Haiv] [–F format] [variant_pattern ...]

このイメージに設定されているすべてのバリアントの現在値を表示します。バリアントの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。

variant_pattern: このイメージで設定されている、指定されたバリアントのみの現在値を表示します。
–F format: 代替出力形式を指定します。詳細は、pkg mediator コマンドを参照してください。
–H: 一覧からヘッダーを省略します。
–a: イメージに明示的に設定されたすべてのバリアントとインストール済みパッケージに指定されたすべてのバリアントを表示します。–a オプションを –i オプションと組み合わせることはできません。
–i: インストール済みパッケージに指定されたすべてのバリアントを表示します。–i オプションを –a オプションと組み合わせることはできません。
–v: インストール済みパッケージに設定できるバリアント値を表示します。–v オプションは、–a または –i オプションと組み合わせることができます。

pkg change-variant [–nvq] [–C n] [–g path_or_uri]... [–r [[–z zonename]... | [–Z zonename]... ]] [–-accept] [–-licenses] [–-no-be-activate] [–-no-backup-be | –-require-backup-be] [–-backup-be-name name] [–-deny-new-be | –-require-new-be] [–-be-name name] [–-sync-actuators | –-sync-actuators-timeout timeout] variant_name=value ...

現在のイメージに設定され、指定されているバリアントの値を変更します。

バリアントの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。バリアントの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。バリアントの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。

オプションの説明については、前述の install コマンドを参照してください。

pkg facet [–Haim] [–F format] [facet_pattern ...]

pkg change-facet コマンドを使用してこのイメージにローカルで設定されたか、(大域ゾーンからファセット設定を継承する非大域ゾーンなどで) 親イメージから継承されたすべてのファセットの現在の値とソースを表示します。ファセットの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。

facet_pattern: このイメージに設定されている、指定されたファセットのみの現在値を表示します。
–F format: 代替出力形式を指定します。詳細は、pkg mediator コマンドを参照してください。
–H: 一覧からヘッダーを省略します。
–a: イメージに明示的に設定されたすべてのファセットとインストール済みパッケージに指定されたすべてのファセットを表示します。–a オプションを –i オプションと組み合わせることはできません。
–i: インストール済みパッケージに指定されたすべてのファセットを表示します。–i オプションを –a オプションと組み合わせることはできません。
–m: マスクされたファセットを出力に含めます。ファセットが (あれば) マスクされているかどうかを示す列を表示します。マスクされたファセットは、(pkg change-facet コマンドを使用して) イメージにローカルで設定されたファセットのうち、同じ名前を持つ継承されたファセットによって隠されるものです。

pkg change-facet [–nvq] [–C n] [–g path_or_uri]... [–r [[–z zonename]... | [–Z zonename]... ]] [–-accept] [–-licenses] [–-no-be-activate] [–-no-backup-be | –-require-backup-be] [–-backup-be-name name] [–-deny-new-be | –-require-new-be] [–-be-name name] [–-sync-actuators | –-sync-actuators-timeout timeout] facet_name=(True|False|None) ...

現在のイメージに設定され、指定されたファセットの値を変更します。これらの変更は、これらのファセットを継承するイメージ (非大域ゾーンなど) にも現れます。

ファセットは True または False に設定できます。ファセットを None に設定すると、デフォルト値の True がそのファセットに適用されるため、ファセットに依存するすべてのアクションがインストールされます。アクションについては、pkg(5) のマニュアルページのアクションに関する項目を参照してください。

ファセットの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。ファセットの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。ファセットの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。

オプションの説明については、前述の install コマンドを参照してください。

pkg avoid [pkg_fmri_pattern ...]

回避対象の各パッケージを、そのパッケージにグループ依存関係を持つパッケージとともに表示します。

回避リストに登録されているパッケージは、要求された依存関係を満たすために必要であればインストールされます。その依存関係が削除された場合、パッケージはアンインストールされます。

pkg_fmri_pattern: 指定されたパターンに現在一致するパッケージ名を回避リストに登録することにより、それらがグループ依存関係のターゲットである場合にそれらを回避します。現在インストールされていないパッケージのみを回避できます。パッケージが現在グループ依存関係のターゲットである場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。

pkg unavoid [pkg_fmri_pattern ...]

回避対象のパッケージのリストを表示します。

pkg_fmri_pattern: 指定されたパッケージを回避リストから削除します。回避リストに登録されており、インストール済みパッケージのグループ依存関係に一致するパッケージは、このサブコマンドを使用して削除できません。グループ依存性に一致するパッケージを回避リストから削除するには、パッケージをインストールします。

pkg freeze [–n] [–c reason] [pkg_fmri_pattern ...]

現在凍結されているパッケージについての情報 (パッケージ名、バージョン、パッケージがいつ凍結されたか、パッケージの凍結に関連付けられた理由があればその理由) が表示されます。

パッケージを凍結しても、そのパッケージを削除できなくなるわけではありません。パッケージが削除される場合に警告は表示されません。

pkg_fmri_pattern

指定されたパッケージを指定されたバージョンに凍結します。バージョンを指定しない場合、パッケージがインストールされている必要があり、そのインストール済みバージョンで凍結されます。すでに凍結されているパッケージを凍結すると、新しく指定されたバージョンによって凍結バージョンが置き換えられます。

凍結されているパッケージをインストールまたは更新するときは、凍結された時点のバージョンと一致するバージョンである必要があります。たとえば、パッケージが 1.2 で凍結された場合、1.2.1、1.2.9、1.2.0.0.1 などのバージョンに更新することはできます。そのパッケージは 1.3 または 1.1 で終了することはできません。pkg_fmri_pattern で提供されるパブリッシャーは、一致するパッケージを検索するために使用されます。ただし、パブリッシャー情報は凍結の一環として記録されません。パッケージは発行元ではなくバージョンのみに関して凍結されます。

–c reason

凍結されるパッケージとともに理由を記録します。凍結が原因でインストールまたは更新に失敗する場合、その理由が示されます。

–n

凍結操作を試しに実行し、凍結されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結しません。

pkg unfreeze [–n] [ pkg_name_pattern ...]

pkg_fmri_pattern: 凍結によって適用される制約を、指定されたパッケージから削除します。バージョンを提供しても無視されます。
–n: 凍結解除操作を試しに実行し、凍結解除されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結解除しません。

pkg property [–H] [ propname ...]

すべてのイメージプロパティーの名前と値を表示します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。

propname: 指定されたプロパティーのみの名前と値を表示します。
–H: 一覧からヘッダーを省略します。

pkg set-property propname propvalue

既存のイメージプロパティーを更新するか、または新しいイメージプロパティーを追加します。

pkg add-property-value propname propvalue

既存のイメージプロパティーに値を追加するか、または新しいイメージプロパティーを追加します。

pkg remove-property-value propname propvalue

既存のイメージプロパティーから値を削除します。

pkg unset-property propname ...

既存のイメージプロパティーを削除します。

pkg publisher [–HPn] [–F format] [publisher ...]

すべてのパブリッシャーの一覧を、検索の優先順に従って表示します。パブリッシャーごとに次の情報が表示されます。名前、非固定的や無効などの属性、種類 (起点またはミラー)、オンラインステータス、プロキシ、場所の URI。プロキシ情報は、P というラベルが付いた列に T (true) または F (false) と表示されるだけです。P 列が T のパブリッシャーのプロキシ値を表示するには、-F tsv オプションを使用するか、パブリッシャー名の引数を使用します。pkg publisher コマンドによって表示されるプロキシは、pkg set-publisher コマンドの –-proxy オプションを使用して設定されました。http_proxy 環境変数を使用して設定されるプロキシは、pkg publisher コマンドによって表示されません。

publisher: 指定された発行元のみの詳細な構成を表示します。表示される追加情報には、プロキシ URI、各起点またはミラー URI 用の鍵および証明書、クライアント UUID、カタログが最後に更新された時間などがあります。
–F format: 代替出力形式を指定します。詳細は、pkg mediator コマンドを参照してください。
–H: 一覧からヘッダーを省略します。
–P: 発行元検索順の先頭の発行元のみを表示します。
–n: 有効な発行元のみを表示します。

pkg set-publisher [-Ped] [–c ssl_cert] [–k ssl_key] [–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]... [–-disable] [–-enable] [–-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

既存の発行元を更新するか、発行元を追加します。検索順に影響するオプションを指定しない場合、新しいパブリッシャーは検索順の末尾に付加され、最後に検索されます。

–G origin_to_remove

–-remove-origin origin_to_remove

指定された発行元の起点のリストから URI またはパスを削除します。特殊値 * を使用して、すべての起点を削除することができます。

–M mirror_to_remove

–-remove-mirror mirror_to_remove

指定された発行元のミラーのリストから URI を削除します。特殊値 * を使用して、すべてのミラーを削除することができます。

–P

–-search-first

指定された発行元を、検索順の先頭に設定します。新しいパッケージをインストールするとき、このパブリッシャーが最初に検索されます。インストール済みパッケージの更新は、そのパブリッシャーが sticky であるかぎり、そのパッケージを最初に提供した同じパブリッシャーから取得されます。

–c ssl_cert

クライアント SSL 証明書を指定します。

–d

–-disable

発行元を無効にします。無効にされたパブリッシャーは、パッケージリストの生成時に、または特定のパッケージ操作 (インストール、アンインストール、および更新) で使用されません。ただし、無効なパブリッシャーのプロパティーを設定または表示することはできます。発行元が 1 つだけの場合は、無効にすることはできません。

–e

–-enable

発行元を有効にします。

–g origin_to_add

–-add-origin origin_to_add

指定された URI またはパスを、特定の発行元の起点として追加します。これはパッケージのリポジトリまたはアーカイブの場所にしてください。

–k ssl_key

クライアント SSL 鍵を指定します。

–m mirror_to_add

–-add-mirror mirror_to_add

URI を指定された発行元のミラーとして追加します。

–-add-property-value name_of_property =value_to_add

既存の発行元プロパティーに値を追加するか、または新しい発行元プロパティーを追加します。

–-approve-ca-cert path_to_CA

署名付きパッケージを検証するために、信頼できる CA 証明書として指定された証明書を追加します。ユーザーが承認した CA 証明書の PEM 表現のハッシュは、pkg publisher コマンドの詳細出力に一覧表示されます。

–-no-refresh

入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。

–-non-sticky

この発行元よりも上位にランクされる発行元が、この発行元から最初にインストールされたパッケージに更新を提供できます。

–-proxy proxy_to_use

指定したプロキシ URI を使用して、指定した起点 (–g) またはミラー (–m) のコンテンツを取得します。プロキシ値は、パブリッシャーの構成の一部として格納されます。つまり、子イメージが使用するシステムリポジトリは自動的に更新されます。このオプションを使用して認証済みプロキシを設定することはできません。proxy_to_use の値を protocol://user:password@host の形式にすることはできません。

実行時には、$http_proxy または関連する環境変数がこのプロキシ設定をオーバーライドします。受け入れられる環境変数名のリストについては、curl(1) のマニュアルページの「環境」セクションを参照してください。環境変数を使用してプロキシ URI を設定する場合は、svc:/application/pkg/system-repository SMF サービスの該当するプロキシプロパティーも同じ値に設定する必要があります。Oracle Solaris 11.2 でのソフトウェアの追加と更新に関するドキュメントの、プロキシの指定に関する説明を参照してください。

–-remove-property-value name_of_property =value_to_remove

既存の発行元プロパティーから値を削除します。

–-reset-uuid

このイメージをその発行元に対して識別する新しい一意識別子を選択します。

–-revoke-ca-cert hash_of_CA_to_remove

署名付きパッケージを検証するために、指定された PEM 表現のハッシュを持つ証明書を失効済みとして扱います。ユーザーが失効させた CA 証明書のハッシュは、pkg publisher コマンドの詳細出力に一覧表示されます。

–-search-after publisher

追加または変更される発行元が、このオプションで指定された発行元のあとに検索されるように、発行元検索順序を変えます。

–-search-before publisher

追加または変更される発行元が、このオプションで指定された発行元の前に検索されるように、発行元検索順序を変えます。

–-set-property name_of_property= value

既存の発行元プロパティーを更新するか、または新しい発行元プロパティーを追加します。

–-sticky

この発行元からインストールされたパッケージへの更新も、この発行元から取得する必要があります。これはデフォルトの動作です。

–-unset-ca-cert hash_of_CA_to_remove

署名付きパッケージを検証するために、指定されたハッシュを持つ証明書を、承認済み証明書のリストおよび失効済み証明書のリストから削除します。

–-unset-property name_of_property_to_delete

既存の発行元プロパティーを削除します。

pkg set-publisher –p repo_uri [-Ped] [–c ssl_cert] [–k ssl_key] [–-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]

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 オプションと組み合わせることはできません。

pkg unset-publisher publisher ...

指定された発行元に関連付けられた構成を削除します。

pkg history [–HNl] [–n number] [–o column[,column]...]... [–t time | time-time[,time | time-time]...]...

該当するイメージのコマンド履歴を表示します。操作の開始時間、操作の名前 (install など)、クライアント (pkg など)、および操作の結果 (成功または失敗) が表示されます。

–H

一覧からヘッダーを省略します。

–l

イメージの長形式のコマンド履歴を表示します。表示される追加情報は、クライアントのバージョン、操作を実行したユーザーの名前、新しいブート環境が作成されたかどうか、操作が完了した時間および費やした合計時間、発行された完全なコマンド、およびコマンドの実行中に発生したすべてのエラーなどがあります。update などの操作では、変更されたパッケージの完全な FMRI が表示されます。

–N

リリースノートのテキストを表示します。

–n number

最新のものから順に指定された数のエントリのみを表示します。

–o column

指定された列名を使用して出力を表示します。–o オプションは複数回指定できます。または、列名をコンマで区切ることにより、1 つの –o オプションの引数として複数の列名を指定できます。有効な列名は次のとおりです。

be: この操作が開始されたブート環境の名前。
be_uuid: この操作が開始されたブート環境の UUID。
client: クライアントの名前。
client_ver: クライアントのバージョン。
command: この操作のために使用されたコマンド行。
finish: この操作が完了した日時。
id: この操作を開始したユーザー ID。
new_be: この操作によって作成された新しいブート環境。
new_be_uuid: この操作によって作成された新しいブート環境の UUID。
operation: 操作の名前。
outcome: この操作の結果のサマリー。
reason: この操作の結果に関する追加情報。
release_note: この操作によってリリースノートが生成されたかどうかを示します。
snapshot: この操作中に作成されたスナップショット。これは、操作が正常に完了したあとにスナップショットが自動削除されなかった場合にのみ記録されます。
start: この操作が開始した日時。
time: この操作の実行にかかった合計時間。1 秒未満の操作については 0:00:00 と表示されます。
user: この操作を開始したユーザー名。

command または reason 列を指定する場合、出力フィールドの区切りを維持するためには、それらの列が –o リストの最終項目である必要があります。同じ history コマンドでこれら 2 つの列を表示することはできません。

ブート環境がシステムに存在しなくなった場合、be または new_be の値のあとにアスタリスク (*) が表示されます。

be および new_be の値は、be_uuid または new_be_uuid フィールドを使用して現在のブート環境名を検索することによって取得されます。その後、ブート環境の名前が変更されたあとにその環境が削除された場合、be および new_be に表示される値は、pkg 操作の時点で記録された値です。

–t time

–t time-time

%Y-%m-%dT%H:%M:%S 形式のタイムスタンプのコンマ区切りリストでログレコードを表示します (strftime(3C) マニュアルページを参照)。日時の範囲を指定するには、開始と終了のタイムスタンプの間にハイフン (-) を使用します。キーワード now は、現在の日時の別名として使用できます。このオプションは複数回指定できます。指定されたタイムスタンプに、重複したタイムスタンプまたは重複する日付範囲が含まれる場合、重複した各履歴イベントは表示されません。各履歴イベントの 1 つのインスタンスのみが表示されます。

pkg purge-history

既存の履歴情報をすべて削除します。

pkg rebuild-index

pkg search によって使用されるインデックスを再構築します。これは復旧操作であり、一般的に使用することは想定されていません。

pkg update-format

イメージの形式を現在のバージョンに更新します。この操作が完了したあとは、古いバージョンの pkg(5) システムと組み合わせてイメージを使用することはできなくなります。

pkg version

pkg のバージョンを識別する一意な文字列を表示します。この文字列は、バージョン間で何らかの方法で比較可能であることは保証されていません。

pkg help

使用方法に関するメッセージを表示します。

pkg image-create [–FPUfz] [–-force] [–-full | –-partial | –-user] [–-zone] [–c ssl_cert] [–k ssl_key] [–g path_or_uri | –-origin path_or_uri]... [–m uri | –-mirror uri]... [–-facet facet_name=(True|False)]... [–-no-refresh] [–-set-property name_of_property=value] [–-variant variant_name=value]... [(–p | –-publisher) [name=]repo_uri] dir

dir によって指定された場所に、パッケージ操作に適したイメージを作成します。image-create サブコマンドを使用して作成されたイメージは、ブート可能ではありません。ほとんどのユーザーは、–-be-name または –-require-new-be オプションを pkg コマンドで使用したり、beadm コマンドまたは zoneadm コマンドを使用してイメージを作成したりする必要があります。pkg image-create コマンドは、パッケージおよびオペレーティングシステムのディストリビューションを維持するといったタスク向けに使用されています。

デフォルトのイメージタイプは user で、–U オプションまたは –-user オプションを使用して指定できます。あるいは、イメージタイプはフルイメージ (–-F または –-full)、または指定された dir パスを包含するフルイメージにリンクされた部分イメージ (–P または –-partial) に設定できます。

–g または –-origin を使用して追加の起点を指定できます。–m または –-mirror を使用して追加のミラーを指定できます。

パッケージリポジトリの URI は、–p または –-publisher オプションを使用して提供する必要があります。パブリッシャーの名前も提供した場合、イメージの作成時にそのパブリッシャーのみが追加されます。パブリッシャーの名前を提供しない場合、指定されたリポジトリによって認識されているすべてのパブリッシャーがイメージに追加されます。このパブリッシャーに関連付けられたカタログは、初期作成操作に続いて取得が試みられます。

クライアント SSL 認証を使用するパブリッシャーの場合、クライアント鍵およびクライアント証明書は –c および –k オプションを通して登録できます。この鍵と証明書は、イメージ作成中に追加されるすべてのパブリッシャーのために使用されます。

イメージが非大域ゾーンコンテキストの内部で実行される予定の場合、–z (–-zone) オプションを使用して適切なバリアントを設定できます。

–f
–-force: 既存のイメージ上にイメージを強制的に作成します。このオプションは慎重に使用してください。
–-facet facet_name=( True|False): 指定されたファセットを指定された値に設定します。ファセットの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
–-no-refresh: 入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
–-set-property name_of_property= value: 指定されたイメージプロパティーを指定された値に設定します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。
–-variant variant_name= value: 指定されたバリアントを指定された値に設定します。バリアントの詳細については、pkg(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。

イメージプロパティー

次のプロパティーはイメージの特性を定義します。これらのプロパティーは、イメージの目的、内容、および動作に関する情報を格納します。イメージ内のこれらのプロパティーの現在の値を表示するには、pkg property コマンドを使用します。これらのプロパティーの値を変更するには、pkg set-property コマンドおよび pkg unset-property コマンドを使用します。

be-policy

(文字列) パッケージ操作中にいつブート環境が作成されるかを指定します。次の値が許可されます。

default

デフォルトブート環境作成ポリシー create-backup を適用します。

always-new

次のブート時にアクティブに設定されている新しいブート環境でパッケージ操作を実行するため、すべてのパッケージ操作に対してリブートを必要とします。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。

このポリシーはもっとも安全ですが、リブートしないとパッケージを追加できないため、ほとんどのサイトの要求よりも厳格です。

create-backup

リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。パッケージが変更されるか、カーネルに影響を及ぼす可能性のある内容がインストールされて、ライブブート環境がこの操作の影響を受ける場合、バックアップブート環境は作成されますが、アクティブには設定されません。バックアップブート環境を明示的にリクエストすることもできます。

このポリシーは、新しくインストールされたソフトウェアによりシステムが不安定になっている場合にのみ潜在的に危険です。この可能性はありますが、比較的まれです。

when-required

リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。

ライブブート環境へのパッケージ変更によりそれ以上の変更が不可能になる場合、フォールバック可能な最近のブート環境が存在しない可能性があるため、このポリシーには最大の危険が伴います。

ca-path

(文字列) SSL 操作用の CA 証明書が格納されたディレクトリを指すパス名。このディレクトリの形式は、ベースとなる SSL 実装に固有です。信頼できる CA 証明書のために別の場所を使用するには、別のディレクトリを指すようにこの値を変更します。CA ディレクトリの要件については、SSL_CTX_load_verify_locations(3openssl) の CApath に関する項目を参照してください。

デフォルト値: /etc/openssl/certs

check-certificate-revocation

(ブール型) True に設定されている場合、パッケージクライアントは、署名検証のために使用される証明書の CRL 配布ポイントへのアクセスを試み、発行時よりもあとに証明書が失効していないかどうかを調べます。

デフォルト値: False

content-update-policy

(文字列) パッケージング操作中に、パッケージシステムが、編集できないファイルを更新するときに指定します。次の値が許可されます。

default: デフォルトの内容更新ポリシーを常に適用します。
always: 変更された編集できないファイルを常にダウンロードおよび更新します。
when-required: パッケージシステムで更新が必要であると判断された場合にのみ、変更された編集できないファイルをダウンロードおよび更新します。

デフォルト値: always

flush-content-cache-on-success

(ブール型) これが True に設定されている場合、パッケージクライアントはイメージ変更操作が正常に完了したときに内容キャッシュ内のファイルを削除します。ブート環境を作成する操作の場合は、ソースと出力先の両方のブート環境から内容が削除されます。

このプロパティーを使用して、ディスク容量の限られたシステムで内容キャッシュを小さく保つことができます。このプロパティーを使用すると、操作が完了するまでの時間が長くなる可能性があります。

デフォルト値: True

mirror-discovery

(ブール型) このプロパティーは、mDNS および DNS-SD を使用してリンクローカル内容ミラーを検出するようにクライアントに命令します。このプロパティーを True に設定すると、クライアントはミラーを動的に検出し、そのミラーからパッケージ内容のダウンロードを試みます。mDNS を介してその内容を通知するミラーの実行方法については、pkg.depotd(1M) のマニュアルページを参照してください。

デフォルト値: False

send-uuid

(ブール型) ネットワーク操作の実行時にイメージの汎用一意識別子 (UUID) を送信します。ユーザーはこのオプションを無効にできますが、一部のネットワークリポジトリは UUID を供給しないクライアントとのやり取りを拒否する場合があります。

デフォルト値: True

signature-policy

(文字列) イメージ内のパッケージのインストール、更新、修正、または検証時にマニフェストに対してどのチェックが実行されるかを決定します。パッケージに適用される最終的なポリシーは、イメージポリシーと発行元ポリシーの組み合わせに依存します。この組み合わせの厳格さは、少なくとも、この 2 つのポリシーが個別に適用された場合の厳格な方と同じです。デフォルトでは、パッケージクライアントは証明書が失効済みかどうかをチェックしません。そのようなチェック (クライアントから外部インターネットサイトへのアクセスが必要な場合がある) を有効にするには、check-certificate-revocation イメージプロパティーを True に設定します。次の値が許可されます。

ignore: すべてのマニフェストの署名を無視します。
verify: 署名が含まれているすべてのマニフェストが有効に署名されていることを確認しますが、インストール済みパッケージがすべて署名されている必要はありません。これがデフォルト値です。
require-signatures: 新しくインストールされたすべてのパッケージに、有効な署名が少なくとも 1 つ含まれている必要があります。インストール済みパッケージに有効な署名が含まれていない場合は、pkg fix および pkg verify コマンドでも警告が表示されます。
require-names: require-signatures と同じ要件に従いますが、signature-required-names プロパティーで一覧表示される文字列が、署名の信頼のチェーンを検証するために使用される証明書の共通名としても表示される必要があります。

signature-required-names

(文字列のリスト) パッケージの署名の検証中に、証明書の共通名として表示される必要のある名前の一覧です。

trust-anchor-directory

(文字列) イメージの信頼アンカーを格納するディレクトリのパス名です。このパスはイメージに対して相対的です。デフォルト値は ignore です。

use-system-repo

(ブール型) このプロパティーではシステムリポジトリを、イメージおよびパブリッシャー構成のソースとして、および提供されたパブリッシャーと通信するためのプロキシとしてイメージで使用するべきかどうかを指定します。デフォルト値は False です。システムリポジトリについては、pkg.sysrepo(1M) のマニュアルページを参照してください。

パブリッシャープロパティー

次のプロパティーは、特定の発行元の署名ポリシーを定義します。同じ名前のイメージプロパティーはイメージの署名ポリシーを定義します。特定の発行元のこれらのプロパティーの現在の値を表示するには、pkg publisher publisher_name コマンドを使用します。これらの発行元の署名ポリシープロパティーの値を変更するには、pkg set-publisher コマンドの –-set-property オプションと –-unset-property オプションを使用します。

signature-policy: (文字列) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。
signature-required-names: (文字列のリスト) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。

例

使用例 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

環境変数

PKG_IMAGE

パッケージ操作に使用するイメージが含まれるディレクトリ。–R を指定した場合は無視されます。

PKG_CLIENT_CONNECT_TIMEOUT

トランスポート操作中に接続しようとするのを待機する秒数 (試行ごと)。これが経過するとクライアントは操作を中止します。値 0 は無制限に待機することを意味します。

デフォルト値: 60

PKG_CLIENT_LOWSPEED_TIMEOUT

クライアントが操作を中止するまでの、トランスポート操作中に lowspeed 制限 (1024 バイト/秒) を下回っていられる秒数。値 0 は、操作を中止しないことを意味します。

デフォルト値: 30

PKG_CLIENT_MAX_CONSECUTIVE_ERROR

一時的なトランスポートエラーの最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。

デフォルト値: 4

PKG_CLIENT_MAX_REDIRECT

トランスポート操作中に許可される HTTP または HTTPS リダイレクトの最大数。これを上回ると接続が中止されます。値 0 は、操作を中止しないことを意味します。

デフォルト値: 5

PKG_CONCURRENCY

同時に更新する子イメージの数。–C オプションが指定されている場合には、無視されます。

子イメージ (通常はインストールされている solaris ブランドの非大域ゾーン) 内への再帰時に、最大 $PKG_CONCURRENCY 個の子イメージを同時に更新します。$PKG_CONCURRENCY が 0 または負数の場合は、すべての子イメージが同時に更新されます。

デフォルト値: 1

PKG_CLIENT_MAX_TIMEOUT

ホストあたりのトランスポート試行の最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。

デフォルト値: 4

http_proxy、https_proxy

HTTP または HTTPS プロキシサーバー。

終了ステータス

次の終了ステータスが返されます。

0: コマンドが成功しました。
1: エラーが発生した。
2: 無効なコマンド行オプションが指定された。
3: 複数の操作が要求されましたが、それらの一部のみが成功しました。
4: 変更が行われませんでした - 何もしません。
5: 要求された操作はライブイメージでは実行できません。
6: インストールまたは更新中のパッケージのライセンスが受け入れられなかったため、要求された操作を完了できません。
7: イメージは現在別のプロセスによって使用されているため、変更できません。
8: 1 つ以上の SMF アクチュエータがタイムアウトしました。
99: 予期しない例外が発生しました。

ファイル

pkg(5) イメージは、より大きなファイルシステム内の任意の場所に置くことができます。次のファイル説明で、トークン $IMAGE_ROOT は相対パスを区別するために使用されています。一般的なシステムインストールでは、 $IMAGE_ROOT は / と等価です。

$IMAGE_ROOT/var/pkg: 完全または部分的なイメージのメタデータディレクトリ。
$IMAGE_ROOT/.org.opensolaris,pkg: ユーザーイメージのメタデータディレクトリ。

特定のイメージのメタデータ内のファイルやディレクトリによっては、修復および復旧中に役立つ情報が含まれている可能性があります。トークン $IMAGE_META は、メタデータが含まれる最上位ディレクトリを参照します。$IMAGE_META は通常、上に示した 2 つのパスのいずれかです。

$IMAGE_META/lost+found: パッケージ操作中に移動された、競合するディレクトリおよびファイルの場所。削除されたディレクトリのパッケージ化されない内容の場所。
$IMAGE_META/publisher: パブリッシャーごとに 1 つのディレクトリが含まれます。各ディレクトリにはパブリッシャー固有のメタデータが格納されます。

$IMAGE_META ディレクトリ階層内のほかのパスは非公開であり、変更される可能性があります。

属性

次の属性については、attributes(5) を参照してください。

属性タイプ	属性値
使用条件	`package/pkg`
インタフェースの安定性	不確実

pkg(1)

名前

形式

説明

オプション

サブコマンド

イメージプロパティー

パブリッシャープロパティー

例

環境変数

終了ステータス

ファイル

属性

関連項目