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] [-p path]... [--parsable version] [--unpackaged] [--unpackaged-only] [pkg_fmri_pattern ...]
/usr/bin/pkg fix [-Hnvq] [--no-be-activate] [--no-backup-be | --require-backup-be] [--backup-be-name name] [--deny-new-be | --require-new-be] [--be-name name] [--accept] [--licenses] [--parsable version] [--unpackaged] [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 [-v]
/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
/usr/bin/pkg -R dir dehydrate [-nvq] [-p publisher]...
/usr/bin/pkg -R dir rehydrate [-nvq] [-p publisher]...
pkg は Image Packaging System 用の取得クライアントです。有効な構成では、pkg を呼び出すことにより、パッケージをインストールする場所を作成し、イメージを呼び出し、パッケージをイメージにインストールすることができます。パッケージはパブリッシャーによって公開され、パブリッシャーはそれらのパッケージを 1 つ以上のリポジトリまたはパッケージアーカイブで利用可能にすることができます。pkg はパブリッシャーのリポジトリまたはパッケージアーカイブからパッケージを取得し、パッケージをイメージにインストールします。
パッケージは、BE の一部であるファイルシステムにのみインストールできます。たとえば、デフォルトの Oracle Solaris 11 インストール環境では、パッケージ操作がサポートされるのは、rpool/ROOT/BEname/ の下のデータセットのみです。
パブリッシャーの名前によって、人、人のグループ、または組織が 1 つ以上のパッケージのソースとして識別されます。パブリッシャーの名前の競合を避け、パブリッシャーを識別しやすくするために、パッケージを公開するエンティティーを表すドメイン名をパブリッシャーの名前として使用することがベストプラクティスです。
リポジトリは、クライアントがパッケージの内容 (プログラムやドキュメントなど、パッケージの内部に含まれるファイル) とメタデータ (パッケージの名前や説明など、パッケージについての情報) を公開および取得できる場所です。たとえば、example.org という名前のパブリッシャーは、http://example.org/repository という URI にリポジトリを配置することができます。
pkg では、パッケージをアンインストールしたり、(利用可能なパッケージの一覧などの) パブリッシャーメタデータをリフレッシュしたり、イメージにインストールされたパッケージを検証したり、イメージからさまざまなトークンを照会したりすることもできます。These queries can also be made of pkg(7) repositories.
イメージには 3 つの種類があります。完全なシステムを提供できるフルイメージ、フルイメージ (親イメージ) にリンクされるがそれ自身では完全なシステムを提供しない部分イメージ、およびユーザーイメージです。
サポートしているオプションは、次のとおりです。
使用方法に関するメッセージを表示します。
dir をルートとするイメージを操作します。ディレクトリが指定されなかったか、または環境に基づいて決定される場合、デフォルトは /、つまり現在アクティブなイメージです。下記の「環境変数」の PKG_IMAGE も参照してください。
dir または PKG_IMAGE が現在アクティブなイメージに設定されていない場合、--require-new-be や --require-backup-be などの BE オプションは無視され、新規またはバックアップ BE をいつ作成するかに関するイメージポリシー設定 (下記の「イメージプロパティー」の be-policy を参照) は無視されます。現在アクティブなイメージではないイメージを操作する場合、変更は直接そのイメージに対して行われます。新規またはバックアップ BE は作成されません。
–R オプションはグローバルオプションです。どの pkg サブコマンドでも使用できますが、一部のサブコマンド (help や version など) では無視されます。–R オプションは dehydrate および rehydrate サブコマンドでは必須です。
操作中に使用されるプロキシなどのネットワークサーバーがキャッシュされたデータを無視するように要求します。このオプションを使用して、パッケージクライアントとネットワークベースのパッケージリポジトリ間のプロキシのキャッシュによって発生する可能性がある問題のトラブルシューティングを行います。
サポートされているサブコマンドは次のとおりです。
クライアントの利用可能パッケージの一覧およびすべてのパブリッシャーのパブリッシャーメタデータを更新します。
クライアントの利用可能パッケージの一覧、および指定されたパブリッシャーのパブリッシャーメタデータのみを更新します。
リクエストされた操作の実行中、進捗状況メッセージを表示しません。
増分更新を試みる代わりにすべての発行元メタデータを強制的に完全取得し、操作中に使用されるすべてのプロキシでキャッシュデータを無視するようにリクエストします。このオプションはトラブルシューティング目的に用意されており、通常時は使用しないでください。
指定されたパッケージをインストールし、イメージにインストールされたパッケージで許容されている pkg_fmri_pattern と一致する最新バージョンにパッケージを更新します。パッケージの最新バージョンを明示的に要求するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。The pkg_fmri_pattern pattern can include the ? and * characters as glob(3C)-style wildcards to match one or more packages.
すでにインストールされているものより古い、または新しいバージョンを指定することで、特定のパッケージのインプレースダウングレードまたはアップグレードを実行できます。パッケージの名前変更または廃止の境界をまたがった特定パッケージの更新はサポートされていません。
保持される構成ファイルのうち、ダウングレードされるパッケージの一部であり、元のバージョンがインストールされたあとに変更されたファイルは、拡張子 .update を使用して名前が変更されます。For more information about how the package system determines which files to preserve, and how these files are preserved during package upgrades, see “File Actions” in the pkg(7) man page.
パッケージは、発行元検索順およびスティッキネスに基づいて選択されます。検索順およびスティッキネスについては、pkg publisher および pkg set-publisher コマンドを参照してください。pkg_fmri_pattern が発行元を指定しない場合、一致するパッケージを提供する最初の発行元がインストール元として使用されます。該当する発行元がこのイメージ内にインストール可能なパッケージのバージョンを提供しない場合、インストール操作は失敗します。このイメージにインストール可能なパッケージのバージョンを提供する発行元を確認するには、pkg list -a コマンドを使用します。
複数の pkg_fmri_pattern が指定され、かつ指定されたパッケージのいずれかをこのイメージにインストールできない場合、指定されたパッケージは一切インストールされません。
インストールプロセスの間に、一部の構成ファイルの名前変更または置換が行われる場合があります。For more information about how the package system determines which files to preserve, and how they are preserved during package operations, see “File Actions” in the pkg(7) man page.
パッケージが回避リストにある場合は、インストールすると回避リストから削除されます。
同時に更新する子イメージの数を指定します。子イメージ (通常はインストールされている solaris ブランドの非大域ゾーン) 内への再帰時に、最大 n 個の子イメージを同時に更新します。更新する子イメージのデフォルト数は、1 です。n が 0 または負数の場合は、すべての子イメージが同時に更新されます。「環境変数」セクションの「PKG_CONCURRENCY」も参照してください。
指定されたパッケージリポジトリまたはアーカイブを、パッケージデータの取得元になるイメージ内のソースリストに一時的に追加します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。
どのバージョンのパッケージを使用するかを決定するときは、イメージ内に構成されているが、指定された path_or_uri ソースに見つからない発行元が優先されます。インストールするパッケージのバージョンが、イメージ内で構成されている発行元および path_or_uri ソースから提供されている場合、クライアントはそのパッケージの内容を path_or_uri ソースから取得します。インストールまたは更新のあとに、発行元によって提供され、イメージ内で構成されていないパッケージがある場合は、起点なしでイメージ構成に追加されます。イメージ内で構成されている発行元を表示するには、pkg publisher コマンドを使用します。
パッケージの変更は行わずに試しに操作を実行します。
リクエストされた操作の実行中、進捗状況メッセージを表示しません。
大域ゾーンおよびインストールされているすべての solaris ブランドの非大域ゾーンで、この操作を実行します。非大域ゾーンへの影響は、各非大域ゾーンにログインして、コマンドを直接実行した場合と似ています。このオプションを指定しないと、大域ゾーンで pkg コマンドを実行した場合、非大域ゾーンは大域ゾーンと互換性を保つために必要な程度でのみ変更されます。このオプションを指定すると、pkg 操作は、–z および –Z オプションで制限されているものを除く、インストールされているすべての非大域ゾーンに適用されます。–z および –Z オプションによって除外されたゾーンは、大域ゾーンと同期を保つために更新が必要な場合、変更される可能性があります。
指定された非大域ゾーンでのみこの操作を実行します。–z オプションは複数回指定できます。–z オプションは、–r オプションと同時に指定した場合のみ使用できます。–z オプションは –Z オプションと一緒に使用できません。
指定されたゾーンを除くすべての非大域ゾーンでこの操作を実行します。–Z オプションは複数回指定できます。–Z オプションは、–r オプションと同時に指定した場合のみ使用できます。–Z オプションは –z オプションと一緒に使用できません。
リクエストされた操作の実行中に詳細な進捗状況メッセージを出力し、詳細な計画情報 (ファセット、メディエータ、バリアントの変更など) を表示します。このオプションを複数回指定して、表示される計画情報の量を増やすことができます。
更新またはインストールされるパッケージのライセンス条項に同意することを示します。このオプションを指定しないと、パッケージのライセンスに同意が必要になった場合、インストール操作は失敗します。
この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示します。更新されるパッケージの場合、ライセンスが変更された場合のみライセンスを表示します。
操作が正常に完了したあとに検索インデックスを更新しません。
入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
ブート環境が作成される場合に、それを次回ブート時にアクティブなブート環境として設定しません。See the beadm(8) man page for more information.
バックアップブート環境を作成しません。
新しいブート環境が作成されない場合に、常にバックアップブート環境を作成します。このオプションを指定しないと、イメージポリシーに基づいてバックアップブート環境が作成されます。バックアップブート環境がいつ自動的に作成されるかについての説明は、次の「イメージプロパティー」の be-policy を参照してください。
指定された引数を使って、作成されたバックアップブート環境に名前を付けます。–-backup-be-name を使用すると –-require-backup-be が暗黙的に指定されます。See also the beadm(8) man page.
新しいブート環境を作成しません。新しいブート環境が必要な場合、この操作は実行されません。
常に新しいブート環境を作成します。このオプションを指定しないと、イメージポリシーに基づいてブート環境が作成されます。ブート環境がいつ自動的に作成されるかについての説明は、次の「イメージプロパティー」の be-policy を参照してください。このオプションを –-require-backup-be と組み合わせることはできません。
新たに作成されたブート環境の名前を、指定された引数になるように変更します。–-be-name の使用は、暗黙的に –-require-new-be を示します。See also the beadm(8) man page.
指定されたパターンと一致する名前を持つパッケージはインストールされません。一致するパッケージがすでにインストールされている場合、それらはこの操作の一環として削除されます。グループ依存関係のターゲットである拒否対象パッケージは回避リストに登録されます。このオプションは複数回指定できます。
SMF アクチュエータを同期的に実行します。The pkg(1) command will not return until all SMF actuators have finished in the zone in which pkg was invoked (the global zone or a non-global zone).
SMF アクチュエータを同期的に実行します。If the actuators do not finish within the given timeout in seconds, pkg(1) will continue operation and exit with return code 8.
指定されたパッケージを、空のシステムにインストールする場合と同じようにインストールまたは更新します。以前にインストールされたパッケージのうち、コマンド行で指定されず、指定されたパッケージの依存関係でもないものは、削除されます。このコマンドは、回避リストに含まれるパッケージのインストールや凍結リストに含まれるパッケージの更新を行わないようにする制約を無視します。それ以外については、この exact-install サブコマンドは install サブコマンドと同じように動作します。パッケージの最新バージョンを明示的に要求するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。
パッケージは、発行元検索順およびスティッキネスに基づいて選択されます。検索順およびスティッキネスについては、pkg publisher および pkg set-publisher コマンドを参照してください。pkg_fmri_pattern でパブリッシャーを指定しない場合は、一致するパッケージを提供する最初のパブリッシャーがインストール元として使用されます。該当する発行元がこのイメージ内にインストール可能なパッケージのバージョンを提供しない場合、インストール操作は失敗します。このイメージにインストール可能なパッケージのバージョンを提供する発行元を確認するには、pkg list -a コマンドを使用します。
複数の pkg_fmri_pattern が指定され、かつ指定されたパッケージのいずれかをこのイメージにインストールできない場合、指定されたパッケージは一切インストールされません。
インストールプロセスの間に、一部の構成ファイルの名前変更または置換が行われる場合があります。For more information about how the package system determines which files to preserve, and how they are preserved during package operations, see “File Actions” in the pkg(7) man page.
パッケージが回避リストにある場合は、インストールすると回避リストから削除されます。
オプションの説明については、前述の install コマンドを参照してください。
pkg_fmri_pattern に一致するインストール済みパッケージを削除します。
パッケージがグループ依存関係の対象である場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。後述する avoid サブコマンドを参照してください。
コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、それが次回リブート時のデフォルトのブート環境になります。See the beadm(8) man page for information about managing boot environments.
インストールされていないパッケージを無視します。このオプションを使用すると、pkg uninstall で現在インストールされていないパッケージをアンインストールしようとしたときに、失敗しなくなります。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
現在のイメージ内のすべてのインストール済みパッケージを、インストール済みパッケージと発行元構成によりシステムに適用される制約で許可される最新のバージョンに更新します。
コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、それが次回、–-no-be-activate オプションを指定しない場合のリブート時のデフォルトブート環境になります。See the beadm(8) man page for information about managing boot environments.
現在のイメージにインストール済みの、指定されたパッケージのみを更新します。指定された pkg_fmri_pattern パターンの 1 つがアスタリスク (*) である場合は、pkg_fmri_pattern を指定しなかった場合と同じ方法で現在のイメージ内のすべてのインストール済みパッケージを更新します。
パッケージの最新バージョンを明示的に要求するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。
すでにインストールされているものより古い、または新しいバージョンを指定することで、特定のパッケージのインプレースダウングレードまたはアップグレードを実行できます。パッケージの名前変更または廃止の境界をまたがった特定パッケージの更新はサポートされていません。
保持される構成ファイルのうち、ダウングレードされるパッケージの一部であり、元のバージョンがインストールされたあとに変更されたファイルは、拡張子 .update を使用して名前が変更されます。For more information about how the package system determines which files to preserve, and how these files are preserved during package upgrades, see “File Actions” in the pkg(7) man page.
複数の pkg_fmri_pattern が指定され、かつ指定されたパッケージのいずれかをこのイメージに更新できない場合、指定されたパッケージは一切更新されません。
すべてのインストール済みパッケージを更新するときにクライアントに対する最新状態チェックを実行しません。
インストールされていないパッケージを無視します。このオプションを使用すると、pkg update で現在インストールされていないパッケージを更新しようとしたときに、失敗しなくなります。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
バージョンやインストール状態などの情報を含む、現在のイメージ内のインストール済みの全パッケージのリストを表示します。デフォルトでは、異なるアーキテクチャーまたはゾーンタイプのパッケージバリアントは除外されます。通常の出力は 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 番目の列にはパッケージのリリースバージョンとブランチバージョンが表示されます。See the pkg(7) man page for information about release and branch versions and about variants.
最後の列には、パッケージのステータスを示す一連のフラグが表示されます。
I 列の i は、パッケージがインストールされていることを示します。
F 列の f は、パッケージが凍結されていることを示します。
O 列の o は、パッケージが廃止されていることを示します。O 列の r は、パッケージの名前が変更されたことを示します (廃止の形態の 1 つです)。
An l in the O column shows that the package is legacy, meaning that it will be removed in the future.指定したパッケージのみを一覧表示します。
一覧からヘッダーを省略します。
このイメージにインストールされているパッケージと、インストールされていないが、インストール可能なパッケージの最新バージョンを一覧表示します。パッケージがインストール済みの incorporation およびイメージのバリアントによって許可されている場合は、それらをインストールできます。1 つ以上のパターンを指定した場合、指定されたパターンに一致し、インストール済みの incorporation およびイメージのバリアントによって許可されている最新バージョンが一覧表示されます。–a を指定しない場合、インストール済みパッケージのみを一覧表示します。
incorporation の制約またはインストール状態に関係なく、すべてのバリアントについてすべてのパッケージのすべてのバージョンを一覧表示します。これらのオプションを使用するとき、パッケージの最新バージョンを明示的に一覧表示するには、pkg_fmri_pattern のバージョン部分に latest を使用します。たとえば、vim@latest のように指定します。
指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。–n を指定しない場合、–g を使用すると –a が暗黙的に指定されます。
インストール状態に関係なく、すべての既知のパッケージの最新バージョンを表示します。
パッケージを一覧表示しませんが、致命的エラーが発生した場合は失敗を返します。
パッケージ名とサマリーを示す 1 行の短縮形式を表示します。このオプションは –a、–n、または –u とともに使用できます。
新しいバージョンが入手可能なインストール済みパッケージを一覧表示します。このオプションは –g とともに使用できません。
発行元と完全バージョンを含む、フルパッケージ FMRI をすべて最初の列に表示します (VERSION 列は消えます)。このオプションは –a、–n、または –u とともに使用できます。
入手可能パッケージの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
現在のイメージにインストールされているすべてのパッケージについての情報を、人間が判読できる形式で表示します。
指定したパッケージの情報のみを表示します。
指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。–g を使用すると –r が暗黙的に指定されます。
インストール済みのパッケージの情報だけを表示します。これはデフォルトです。
パッケージ情報を表示しませんが、致命的エラーが発生した場合は失敗を返します。
最新の入手可能バージョンに基づいてパッケージを照合し、イメージの構成済みパブリッシャーのリポジトリから、現在インストールされていないパッケージの情報を取得します (必要な場合)。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。–r を指定しない場合、デフォルトでインストール済みパッケージのみが表示されます。
パッケージのライセンステキストを表示します。このオプションは、–l、–q、または –r と組み合わせることができます。すべての pkg_fmri_pattern パターンが既知の問題のパッケージと一致し、ライセンスを持つ場合、成功を返します。1 つ以上のパターンが一致しないか、ライセンスを持たないパッケージと一致した場合、失敗を返します。
イメージ内のすべてのインストール済みパッケージの内容 (アクション属性) を表示します。オプションが指定されていない場合、現在のイメージにインストールされているアクションの path 属性の値をアルファベット順で並べ替えて表示します。If the –o option is not specified, the key attributes, as described in pkg(7), of the related action name will be displayed instead.さらに、「depend」アクションには「type」属性も含められ、「set」アクションには「value」属性が含められます。
複数のアクション名が指定されている場合、デフォルトの属性は、前述のように、指定されたすべてのアクションのすべての属性セットです。For information about actions and their attributes, see “Actions” in the pkg(7) man page.下の疑似属性名のリストも参照してください。
指定したパッケージの内容のみを表示します。
出力からヘッダーを省略します。
名前がオプション引数で指定され、値がオプション引数の (glob) pattern に一致する attribute を持つアクションに出力を限定します。このオプションは複数回指定できます。複数の –a オプションを指定した場合、それらのいずれかに一致するアクションが表示されます。
指定されたパッケージリポジトリまたはアーカイブからこのイメージにインストール可能なパッケージの情報を表示します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションは複数回指定できます。–g を使用すると –r が暗黙的に指定されます。
このイメージにインストールできないアクションを含めて、指定されたパッケージのすべてのアクションのすべての属性を表示します。
指定された属性を、リストの先頭属性の値に従って並べ替えて表示します。–o オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの –o オプションの引数として複数の属性を指定できます。要求された属性を持つアクションのみが表示されます。
このイメージ内で構成された発行元のリポジトリからこのイメージにインストール可能なパッケージの最新バージョンの情報を表示します。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。
指定されたアクション属性で、アクションをソートします。このオプションを指定しない場合、デフォルトではパスによって、または –o オプションで最初に指定された属性によってソートします。–s オプションは複数回指定できます。
指定されたアクションのみを一覧表示します。–t オプションは複数回指定できます。または、アクション名をコンマで区切ることにより、1 つの –t オプションの引数として複数のアクションを指定できます。The value of action_name is one of the actions listed in “Actions” in the pkg(7) man page, such as 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) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。
出力に含める列を指定します。–o オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの –o オプションの引数として複数の属性を指定できます。前述した疑似属性に加えて、検索結果用の次の属性が定義されています。これらの属性は、特定の結果が一致する理由をわかりやすく示しています。
検索クエリーに一致した文字列。
検索クエリーに一致した文字列を含む属性。
一部のアクションが各クエリー条件に一致するパッケージを表示します。このオプションを使用することは、クエリーの各条件を山括弧 (<>) で囲むことと等価です。<> 演算子の詳細は、次の query を参照してください。
イメージのパブリッシャーに対応するリポジトリを検索します。これはデフォルトです。
–l と –r (または –s) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。
Search the pkg(7) repository located at the given URI.これは複数回指定できます。パッケージアーカイブはサポートされていません。
デフォルトでは、query は完全一致する一連の条件として解釈され、複数の条件は AND でつながれます。
AND と OR がサポートされています。
The ? and * characters can be used as glob(3C)-style wildcards, allowing more flexible query matches.
単純なトークン一致およびワイルドカード検索に加えて、より複雑なクエリー言語がサポートされています。単一引用符または二重引用符 (' または ") を使用することにより、語句を検索できます。pkg が実際に ' または " を認識するように、必ずシェルを考慮に入れてください。
どのトークンがインデックス化されるかはアクションに依存しますが、コンテンツハッシュとパス名を含めることができます。For information about actions and their attributes, see “Actions” in the pkg(7) man page.前述の pkg contents および – o 内の擬似属性名のリストも参照してください。
構造化されたクエリーは、次の構文でサポートされます:
pkg_name:action_name: index:token
The value of action_name is one of the actions listed in “Actions” in the pkg(7) man page.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 で説明します。
現在のイメージ内で、指定されたインストール済みパッケージのインストールのみを検証します。–p とともに使用する場合、指定されたパッケージからの一致するアクションのみが検証されます。
検証の出力からヘッダーを省略します。
パッケージに関する情報メッセージを含めます。前述の install コマンドの –v オプションの説明も参照してください。
パスを指定して、個々のファイル、リンク、またはディレクトリを検証します。指定されたパスは、検証が実行されるイメージの / の相対パスであると見なされます。ディレクトリまたはリンクが指定されている場合、そのディレクトリまたはリンクの一致するアクションのみが検証されます。
パスの指定時に pkg_fmri_pattern を指定しないと、イメージにインストールされているパッケージから一致するすべてのアクションが検証されます。このオプションを –-unpackaged または –-unpackaged-only と組み合わせることはできません。
解析可能な出力。サポートされるバージョンは 0 です。このオプションを使用すると、–q が暗黙的に指定されます。
一般的な検証の出力に加えて展開されたパッケージ内容が報告されます。現在展開されたパッケージ内容には、パッケージ解除されたファイルおよびパッケージ解除されたディレクトリが含まれます。このオプションは –-parsable と組み合わせることができます。
展開されたパッケージ内容のみを報告します。このオプションは、一般的な検証の出力を除外し、パッケージ解除されたファイルおよびディレクトリのみを報告します。このオプションは –-parsable と組み合わせることができます。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
pkg verify で報告されたエラーをすべて修正します。インストール済みパッケージの内容は、独自の内容解析に基づいて検証されるため、ほかのプログラムの場合とは異なる結果が返されることがあります。
現在のイメージ内で、指定されたインストール済みパッケージに対する pkg verify により報告されたエラーを修正します。
検証の出力からヘッダーを省略します。
パッケージに関する情報メッセージを含めます。前述の install コマンドの –v オプションの説明も参照してください。
更新またはインストールされるパッケージのライセンス条項に同意することを示します。このオプションを指定しないと、パッケージのライセンスに同意が必要になった場合、操作は失敗します。
この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示します。更新されるパッケージの場合、ライセンスが変更された場合のみライセンスを表示します。
解析可能な出力。サポートされるバージョンは 0 です。このオプションを使用すると、–q が暗黙的に指定されます。
一般的な出力に加えて展開されたパッケージ内容が報告されます。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
Revert files delivered by pkg(7) packages to their as-delivered condition.ファイルの所有権および保護も復元されます。
注意 - 一部の編集可能ファイルをデフォルト値に戻すと、システムがブート不可になったり、その他の異常動作の原因になったりする可能性があります。 |
tag-name でタグ付けされたすべてのファイルを元に戻し、このタグが付けられているディレクトリの下に pattern と一致するパッケージ解除されたファイルまたはディレクトリがある場合は削除します。See the description of the revert-tag attribute in “File Actions” and “Directory Actions” in the pkg(7) man page for more information about tag-name and pattern.
指定されたファイルを元に戻します。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
現在選択されているバージョンやすべてのメディエータの実装を表示します。
現在選択されているバージョンや指定されたメディエータの実装のみを表示します。
代替出力形式を指定します。format の値は、tsv (Tab Separated Values)、json (単一行としての JavaScript Object Notation)、または json-formatted (読みやすい形式にされた JavaScript Object Notation) にできます。
一覧からヘッダーを省略します。
現在インストールされているパッケージに設定可能なメディエーションを一覧表示します。
現在のイメージ内の指定されたメディエータのバージョンと実装を設定します。
使用するメディエート対象インタフェースの実装を設定します。デフォルトでは、バージョンが指定されない場合、すべての実装バージョンが許可されます。バージョンなしで実装を指定するには、アット記号 (@) を付加します。
使用するメディエート対象インタフェースのバージョンを設定します。
指定されたメディエータのバージョンと実装のどちらかまたは両方が現在入手できない場合、指定されたメディエータを使用するリンクはすべて削除されます。
If, during an update, the mediated link target is removed a warning will be produced indicating this. If the update had created a new boot environment, the boot environment will be left mounted and not activated.
その他のすべてのオプションについては、前述の install コマンドを参照してください。
指定されたメディエータのバージョンと実装をシステムデフォルトに戻します。
メディエート対象インタフェースの実装のみを元に戻します。
メディエート対象インタフェースのバージョンのみを元に戻します。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
このイメージに設定されているすべてのバリアントの現在値を表示します。See “Facets and Variants” in the pkg(7) man page for more information about variants.
このイメージで設定されている、指定されたバリアントのみの現在値を表示します。
代替出力形式を指定します。詳細は、pkg mediator コマンドを参照してください。
一覧からヘッダーを省略します。
イメージに明示的に設定されたすべてのバリアントとインストール済みパッケージに指定されたすべてのバリアントを表示します。–a オプションを –i オプションと組み合わせることはできません。
インストール済みパッケージに指定されたすべてのバリアントを表示します。–i オプションを –a オプションと組み合わせることはできません。
インストール済みパッケージに設定できるバリアント値を表示します。–v オプションは、–a または –i オプションと組み合わせることができます。
現在のイメージに設定され、指定されているバリアントの値を変更します。
バリアントの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。バリアントの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。See “Facets and Variants” in the pkg(7) man page for more information about variants.
オプションの説明については、前述の install コマンドを参照してください。
pkg change-facet コマンドを使用してこのイメージにローカルで設定されたか、(大域ゾーンからファセット設定を継承する非大域ゾーンなどで) 親イメージから継承されたすべてのファセットの現在の値とソースを表示します。See “Facets and Variants” in the pkg(7) man page for more information about facets.
このイメージに設定されている、指定されたファセットのみの現在値を表示します。
代替出力形式を指定します。詳細は、pkg mediator コマンドを参照してください。
一覧からヘッダーを省略します。
イメージに明示的に設定されたすべてのファセットとインストール済みパッケージに指定されたすべてのファセットを表示します。–a オプションを –i オプションと組み合わせることはできません。
インストール済みパッケージに指定されたすべてのファセットを表示します。–i オプションを –a オプションと組み合わせることはできません。
マスクされたファセットを出力に含めます。ファセットが (あれば) マスクされているかどうかを示す列を表示します。マスクされたファセットは、(pkg change-facet コマンドを使用して) イメージにローカルで設定されたファセットのうち、同じ名前を持つ継承されたファセットによって隠されるものです。
現在のイメージに設定され、指定されたファセットの値を変更します。これらの変更は、これらのファセットを継承するイメージ (非大域ゾーンなど) にも現れます。
ファセットは True または False に設定できます。ファセットを None に設定すると、デフォルト値の True がそのファセットに適用されるため、ファセットに依存するすべてのアクションがインストールされます。See “Actions” in the pkg(7) man page for information about actions.
ファセットの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。ファセットの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。See “Facets and Variants” in the pkg(7) man page for more information about facets.
オプションの説明については、前述の install コマンドを参照してください。
回避対象の各パッケージを、そのパッケージにグループ依存関係を持つパッケージとともに表示します。
回避リストに登録されているパッケージは、要求された依存関係を満たすために必要であればインストールされます。その依存関係が削除された場合、パッケージはアンインストールされます。
指定されたパターンに現在一致するパッケージ名を回避リストに登録することにより、それらがグループ依存関係のターゲットである場合にそれらを回避します。現在インストールされていないパッケージのみを回避できます。パッケージが現在グループ依存関係のターゲットである場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。
回避対象のパッケージのリストを表示します。
指定されたパッケージを回避リストから削除します。回避リストに登録されており、インストール済みパッケージのグループ依存関係に一致するパッケージは、このサブコマンドを使用して削除できません。グループ依存性に一致するパッケージを回避リストから削除するには、パッケージをインストールします。
現在凍結されているパッケージについての情報 (パッケージ名、バージョン、パッケージがいつ凍結されたか、パッケージの凍結に関連付けられた理由があればその理由) が表示されます。
パッケージを凍結しても、そのパッケージを削除できなくなるわけではありません。パッケージが削除される場合に警告は表示されません。
指定されたパッケージを指定されたバージョンに凍結します。バージョンを指定しない場合、パッケージがインストールされている必要があり、そのインストール済みバージョンで凍結されます。すでに凍結されているパッケージを凍結すると、新しく指定されたバージョンによって凍結バージョンが置き換えられます。
凍結されているパッケージをインストールまたは更新するときは、凍結された時点のバージョンと一致するバージョンである必要があります。たとえば、パッケージが 1.2 で凍結された場合、1.2.1、1.2.9、1.2.0.0.1 などのバージョンに更新することはできます。そのパッケージは 1.3 または 1.1 で終了することはできません。pkg_fmri_pattern で提供されるパブリッシャーは、一致するパッケージを検索するために使用されます。ただし、パブリッシャー情報は凍結の一環として記録されません。パッケージは発行元ではなくバージョンのみに関して凍結されます。
凍結されるパッケージとともに理由を記録します。凍結が原因でインストールまたは更新に失敗する場合、その理由が示されます。
凍結操作を試しに実行し、凍結されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結しません。
現在凍結されているパッケージについての情報 (パッケージ名、バージョン、パッケージがいつ凍結されたか、パッケージの凍結に関連付けられた理由があればその理由) が表示されます。
凍結によって適用される制約を、指定されたパッケージから削除します。バージョンを提供しても無視されます。
凍結解除操作を試しに実行し、凍結解除されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結解除しません。
すべてのイメージプロパティーの名前と値を表示します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。
指定されたプロパティーのみの名前と値を表示します。
一覧からヘッダーを省略します。
既存のイメージプロパティーを更新するか、または新しいイメージプロパティーを追加します。
既存のイメージプロパティーに値を追加するか、または新しいイメージプロパティーを追加します。
既存のイメージプロパティーから値を削除します。
既存のイメージプロパティーを削除します。
すべてのパブリッシャーの一覧を、検索の優先順に従って表示します。パブリッシャーごとに次の情報が表示されます。名前、非固定的や無効などの属性、種類 (起点またはミラー)、ステータス、プロキシ、場所の URI。プロキシ情報は、P というラベルが付いた列に T (true) または F (false) と表示されるだけです。P 列が T のパブリッシャーのプロキシ値を表示するには、-F tsv オプションを使用するか、パブリッシャー名の引数を使用します。pkg publisher コマンドによって表示されるプロキシは、pkg set-publisher コマンドの –-proxy オプションを使用して設定されました。http_proxy 環境変数を使用して設定されるプロキシは、pkg publisher コマンドによって表示されません。
指定された発行元のみの詳細な構成を表示します。表示される追加情報には、プロキシ URI、各起点またはミラー URI 用の鍵および証明書、クライアント UUID、カタログが最後に更新された時間などがあります。
代替出力形式を指定します。format の値には、tsv (タブ区切り値) のみを指定できます。
一覧からヘッダーを省略します。
発行元検索順の先頭の発行元のみを表示します。
有効な発行元のみを表示します。
既存の発行元を更新するか、発行元を追加します。検索順に影響するオプションを指定しない場合、新しいパブリッシャーは検索順の末尾に付加され、最後に検索されます。
指定された発行元の起点のリストから URI またはパスを削除します。特殊値 * を使用して、すべての起点を削除することができます。
指定された発行元のミラーのリストから URI を削除します。特殊値 * を使用して、すべてのミラーを削除することができます。
指定された発行元を、検索順の先頭に設定します。新しいパッケージをインストールするとき、このパブリッシャーが最初に検索されます。インストール済みパッケージの更新は、そのパブリッシャーが sticky であるかぎり、そのパッケージを最初に提供した同じパブリッシャーから取得されます。
クライアント SSL 証明書を指定します。
発行元を無効にします。無効にされたパブリッシャーは、パッケージリストの生成時に、または特定のパッケージ操作 (インストール、アンインストール、および更新) で使用されません。ただし、無効なパブリッシャーのプロパティーを設定または表示することはできます。発行元が 1 つだけの場合は、無効にすることはできません。
発行元を有効にします。
指定された URI またはパスを、特定の発行元の起点として追加します。これはパッケージのリポジトリまたはアーカイブの場所にしてください。–-enable または –-disable と組み合わせた場合、指定されたされたとおりに起点が有効または無効にされます。この場合、すべての起点を有効または無効にするために * を使用できます。
クライアント SSL 鍵を指定します。
URI を指定された発行元のミラーとして追加します。
既存の発行元プロパティーに値を追加するか、または新しい発行元プロパティーを追加します。
署名付きパッケージを検証するために、信頼できる CA 証明書として指定された証明書を追加します。ユーザーが承認した CA 証明書の PEM 表現のハッシュは、pkg publisher コマンドの詳細出力に一覧表示されます。
入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
この発行元よりも上位にランクされる発行元が、この発行元から最初にインストールされたパッケージに更新を提供できます。このパブリッシャーまたは兄弟に隣接するすべての非固定パブリッシャーが、ランクに関係なく、更新を提供して、このパブリッシャーによって提供されるパッケージの依存関係を満たすことができます。
指定したプロキシ URI を使用して、指定した起点 (–g) またはミラー (–m) のコンテンツを取得します。プロキシ値は、パブリッシャーの構成の一部として格納されます。つまり、子イメージが使用するシステムリポジトリは自動的に更新されます。このオプションを使用して認証済みプロキシを設定することはできません。proxy_to_use の値を protocol://user:password@host の形式にすることはできません。
実行時には、$http_proxy または関連する環境変数がこのプロキシ設定をオーバーライドします。See the “Environment” section of the curl(1) man page for the list of accepted environment variable names.環境変数を使用してプロキシ URI を設定する場合は、svc:/application/pkg/system-repository SMF サービスの該当するプロキシプロパティーも同じ値に設定する必要があります。Updating Systems and Adding Software in Oracle Solaris 11.4の、プロキシの指定に関する説明を参照してください
既存の発行元プロパティーから値を削除します。
このイメージをその発行元に対して識別する新しい一意識別子を選択します。
署名付きパッケージを検証するために、指定された PEM 表現のハッシュを持つ証明書を失効済みとして扱います。ユーザーが失効させた CA 証明書のハッシュは、pkg 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 オプションと組み合わせることはできません。
指定された発行元に関連付けられた構成を削除します。
該当するイメージのコマンド履歴を表示します。操作の開始時間、操作の名前 (install など)、クライアント (pkg など)、および操作の結果 (成功または失敗) が表示されます。
一覧からヘッダーを省略します。
イメージの長形式のコマンド履歴を表示します。表示される追加情報は、クライアントのバージョン、操作を実行したユーザーの名前、新しいブート環境が作成されたかどうか、操作が完了した時間および費やした合計時間、発行された完全なコマンド、およびコマンドの実行中に発生したすべてのエラーなどがあります。update などの操作では、変更されたパッケージの完全な FMRI が表示されます。
リリースノートのテキストを表示します。
最新のものから順に指定された数のエントリのみを表示します。
指定された列名を使用して出力を表示します。–o オプションは複数回指定できます。または、列名をコンマで区切ることにより、1 つの –o オプションの引数として複数の列名を指定できます。有効な列名は次のとおりです。
この操作が開始されたブート環境の名前。
この操作が開始されたブート環境の 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 操作の時点で記録された値です。
Display log records for a comma-separated list of timestamps, formatted with %Y-%m-%dT%H:%M:%S (see the strftime(3C) man page).日時の範囲を指定するには、開始と終了のタイムスタンプの間にハイフン (-) を使用します。キーワード now は、現在の日時の別名として使用できます。このオプションは複数回指定できます。指定されたタイムスタンプに、重複したタイムスタンプまたは重複する日付範囲が含まれる場合、重複した各履歴イベントは表示されません。各履歴イベントの 1 つのインスタンスのみが表示されます。
既存の履歴情報をすべて削除します。
pkg search によって使用されるインデックスを再構築します。これは復旧操作であり、一般的に使用することは想定されていません。
イメージの形式を現在のバージョンに更新します。Once this operation has completed, the image can no longer be used with older versions of the pkg(7) system.
pkg のバージョンを識別する一意な文字列を表示します。この文字列は、バージョン間で何らかの方法で比較可能であることは保証されていません。
サブコマンドの完全なリストを表示します。
サブコマンドの詳細な使用法のメッセージを表示します。
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) オプションを使用して適切なバリアントを設定できます。
既存のイメージ上にイメージを強制的に作成します。このオプションは慎重に使用してください。
指定されたファセットを指定された値に設定します。See “Facets and Variants” in the pkg(7) man page for more information about facets.
入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
指定されたイメージプロパティーを指定された値に設定します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。
指定されたバリアントを指定された値に設定します。See “Facets and Variants” in the pkg(7) man page for more information about variants.
–R オプションで指定されたイメージから、編集できないパッケージされたファイルおよびパッケージされたハードリンクをすべて削除して、完全にデハイドレートされたイメージを作成します。パッケージされたファイルおよびパッケージされたハードリンクは、現在インストールされているパッケージのバージョンによって提供されたファイルおよびハードリンクです。編集できないファイルは、preserve または overlay 属性を持つことはできず、値が false に設定された dehydrate 属性を持つこともできません。
pkg dehydrate コマンドは、代替ルートに対してのみ処理を実行します。代替ルートを指定するには、–R オプションを使用します。代替ルートがブート環境に属している場合、デハイドレーションによってブート不可になります。
pkg dehydrate コマンドが成功すると、–R オプションで指定された dir イメージに dehydrated というプロパティーが設定されます。dehydrated プロパティーの値は、構成済みのパッケージリポジトリを持っている、dir イメージ内に設定されたパブリッシャーのリストです。
デハイドレートされたパブリッシャーからのパッケージに対するパッケージインストール操作は、自動的にデハイドレートされます。デハイドレートされたイメージにパッケージをインストールする場合、パッケージの内容はインストールされたあとでデハイドレートされます。パッケージインストール操作には、install だけでなく、update や change-facet などの操作も含まれます。
指定されたパブリッシャーから提供された、編集できないファイルおよびハードリンクだけを削除して、部分的にデハイドレートされたイメージを作成します。イメージ内の構成済みパブリッシャーがすべて指定された場合は、前述の完全にデハイドレートされたイメージが作成されます。
1 つ以上のパブリッシャーが指定された場合で、そのいずれかがイメージ内に構成されていないときは、イメージからは何も削除されません。
pkg dehydrate コマンドが成功すると、–R オプションで指定された dir イメージに dehydrated というプロパティーが設定されます。dehydrated プロパティーの値は、–p オプションで指定されたすべてのパブリッシャーのリストです。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
pkg dehydrate コマンドで削除されたすべてのファイルおよびハードリンクを再インストールします。
pkg rehydrate コマンドは、代替ルートに対してのみ処理を実行します。代替ルートを指定するには、–R オプションを使用します。
pkg rehydrate コマンドが成功すると、イメージの dehydrated プロパティーの値は空になります。
指定されたパブリッシャーに関して pkg dehydrate コマンドで削除されたすべてのファイルおよびハードリンクを再インストールします。
1 つ以上のパブリッシャーが指定された場合で、そのいずれかがイメージ内に構成されていないときは、何もインストールされません。
pkg rehydrate コマンドが成功すると、イメージに設定されている dehydrated プロパティーの値から、指定されたパブリッシャーの名前が削除されます。rehydrate コマンドで指定されていないパブリッシャーは dehydrated プロパティーのリストに残り、それらのパブリッシャーからインストールされた内容はデハイドレートされたままになります。
その他のすべてのオプションについては、前述の install コマンドを参照してください。
イメージが最後に変更された時間を知る必要があるデーモンまたはほかのプログラムは、ファイル /var/pkg/modified のタイムスタンプを参照できます。/var/pkg/modified のタイムスタンプは、イメージを変更する操作が発生するたびに更新されます。その時点の変更に関する情報を表示するには、pkg history コマンドを使用します。
次のプロパティーはイメージの特性を定義します。これらのプロパティーは、イメージの目的、内容、および動作に関する情報を格納します。イメージ内のこれらのプロパティーの現在の値を表示するには、pkg property コマンドを使用します。これらのプロパティーの値を変更するには、pkg set-property コマンドおよび pkg unset-property コマンドを使用します。
(文字列) パッケージ操作中にいつブート環境が作成されるかを指定します。次の値が許可されます。
Apply the default boot environment creation policy, create-backup.
次のブート時にアクティブに設定されている新しいブート環境でパッケージ操作を実行するため、すべてのパッケージ操作に対してリブートを必要とします。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。
このポリシーはもっとも安全ですが、リブートしないとパッケージを追加できないため、ほとんどのサイトの要求よりも厳格です。
リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。パッケージが変更されるか、カーネルに影響を及ぼす可能性のある内容がインストールされて、ライブブート環境がこの操作の影響を受ける場合、バックアップブート環境は作成されますが、アクティブには設定されません。バックアップブート環境を明示的にリクエストすることもできます。
このポリシーは、新しくインストールされたソフトウェアによりシステムが不安定になっている場合にのみ潜在的に危険です。この可能性はありますが、比較的まれです。
リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。
ライブブート環境へのパッケージ変更によりそれ以上の変更が不可能になる場合、フォールバック可能な最近のブート環境が存在しない可能性があるため、このポリシーには最大の危険が伴います。
(文字列) SSL 操作用の CA 証明書が格納されたディレクトリを指すパス名。このディレクトリの形式は、ベースとなる SSL 実装に固有です。信頼できる CA 証明書のために別の場所を使用するには、別のディレクトリを指すようにこの値を変更します。See the CApath portions of SSL_CTX_load_verify_locations(3openssl) for requirements for the CA directory.
デフォルト値: /etc/openssl/certs
(ブール型) True に設定されている場合、パッケージクライアントは、署名検証のために使用される証明書の CRL 配布ポイントへのアクセスを試み、発行時よりもあとに証明書が失効していないかどうかを調べます。
デフォルト値: False
(文字列) パッケージング操作中に、パッケージシステムが、編集できないファイルを更新するときに指定します。次の値が許可されます。
デフォルトの内容更新ポリシーを常に適用します。
変更された編集できないファイルを常にダウンロードおよび更新します。
パッケージシステムで更新が必要であると判断された場合にのみ、変更された編集できないファイルをダウンロードおよび更新します。
デフォルト値: always
(ブール型) これが True に設定されている場合、パッケージクライアントはイメージ変更操作が正常に完了したときに内容キャッシュ内のファイルを削除します。ブート環境を作成する操作の場合は、ソースと出力先の両方のブート環境から内容が削除されます。
このプロパティーを使用して、ディスク容量の限られたシステムで内容キャッシュを小さく保つことができます。このプロパティーを使用すると、操作が完了するまでの時間が長くなる可能性があります。
Default value: True
(ブール型) このプロパティーは、mDNS および DNS-SD を使用してリンクローカル内容ミラーを検出するようにクライアントに命令します。このプロパティーを True に設定すると、クライアントはミラーを動的に検出し、そのミラーからパッケージ内容のダウンロードを試みます。To run a mirror that advertises its content via mDNS, see the pkg.depotd(8) man page.
デフォルト値: False
(ブール型) ネットワーク操作の実行時にイメージの汎用一意識別子 (UUID) を送信します。ユーザーはこのオプションを無効にできますが、一部のネットワークリポジトリは UUID を供給しないクライアントとのやり取りを拒否する場合があります。
Default value: True
(boolean) Use the suggested Boot Environment name from pkg:/release/name when updates where a new BE is created and --be-name has not been supplied.
Default value: True
(文字列) イメージ内のパッケージのインストール、更新、修正、または検証時にマニフェストに対してどのチェックが実行されるかを決定します。パッケージに適用される最終的なポリシーは、イメージポリシーと発行元ポリシーの組み合わせに依存します。この組み合わせの厳格さは、少なくとも、この 2 つのポリシーが個別に適用された場合の厳格な方と同じです。デフォルトでは、パッケージクライアントは証明書が失効済みかどうかをチェックしません。そのようなチェック (クライアントから外部インターネットサイトへのアクセスが必要な場合がある) を有効にするには、check-certificate-revocation イメージプロパティーを True に設定します。次の値が許可されます。
すべてのマニフェストの署名を無視します。
署名が含まれているすべてのマニフェストが有効に署名されていることを確認しますが、インストール済みパッケージがすべて署名されている必要はありません。これがデフォルト値です。
新しくインストールされたすべてのパッケージに、有効な署名が少なくとも 1 つ含まれている必要があります。インストール済みパッケージに有効な署名が含まれていない場合は、pkg fix および pkg verify コマンドでも警告が表示されます。
require-signatures と同じ要件に従いますが、signature-required-names プロパティーで一覧表示される文字列が、署名の信頼のチェーンを検証するために使用される証明書の共通名としても表示される必要があります。
(文字列のリスト) パッケージの署名の検証中に、証明書の共通名として表示される必要のある名前の一覧です。
(文字列) イメージの信頼アンカーを格納するディレクトリのパス名です。このパスはイメージに対して相対的です。デフォルト値は ignore です。
(ブール型) このプロパティーではシステムリポジトリを、イメージおよびパブリッシャー構成のソースとして、および提供されたパブリッシャーと通信するためのプロキシとしてイメージで使用するべきかどうかを指定します。デフォルト値は False です。See the pkg.sysrepo(8) man page for information about system repositories.
次のプロパティーは、特定の発行元の署名ポリシーを定義します。同じ名前のイメージプロパティーはイメージの署名ポリシーを定義します。特定の発行元のこれらのプロパティーの現在の値を表示するには、pkg publisher publisher_name コマンドを使用します。これらの発行元の署名ポリシープロパティーの値を変更するには、pkg set-publisher コマンドの –-set-property オプションと –-unset-property オプションを使用します。
(文字列) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。
(文字列のリスト) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。
The SMF service svc:/system/auto-update:default provides a mechanism to automatically update and reboot the system on an administrator defined schedule.This is particularly useful when the system is deployed with an immutable root filesystem profile.
Automatically reboot if updates are performed, defaults to true.
Automatically activate the new boot environment, default to true.
Create a new BE for any updates rather than using the live BE.The BE is automatically named by pkg(1), where possible, using metadata stored in pkg:/release/name.
List of packages to explicitly update.Defaults to empty, which instructs pkg to update all packages to newest within the constraints allowed.
The default configuration is to attempt the update and reboot weekly at midnight on a Sunday.An alternative schedule can be configured by setting the appropriate properties in the scheduled property group, see svc.periodicd(8).
The SMF service svc:/system/auto-update:cleanup manages the boot environments created by the automatic update service.To opt an auto-update boot environment out of automatic removal and allow it to be preserved and managed manually use 'beadm set-policy -nstatic bename'.
The maximum number of boot environments created by the auto update service to keep.
パブリッシャーを 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:/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:/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使用例 33 イメージをデハイドレートおよびリハイドレートする
次の例で、/tmp/test_image はデハイドレートおよびリハイドレートしようとしているイメージです。
パブリッシャーが指定されていないため、次のコマンドは /tmp/test_image イメージ内で有効になっているすべてのパブリッシャーに対して処理を実行し、/tmp/test_image イメージを完全にデハイドレートします。
$ pkg -R /tmp/test_image dehydrate
パブリッシャーが指定されていないため、次のコマンドは /tmp/test_image イメージ内に構成されているすべてのパブリッシャーに対して処理を実行し、/tmp/test_image イメージを完全に復元します。
$ pkg -R /tmp/test_image rehydrate使用例 34 パブリッシャーを指定してイメージをデハイドレートおよびリハイドレートする
次の例で、/tmp/test_image はデハイドレートおよびリハイドレートしようとしているイメージです。test1 および test2 は /tmp/test_image イメージ内で有効になっているパブリッシャーで、その起点からは必要な内容が提供されます。
次のコマンドは、test1 パブリッシャーから提供されたファイルおよびハードリンクに対してのみ処理を実行します。
$ pkg -R /tmp/test_image dehydrate -p test1
次のコマンドは、test1 パブリッシャーから提供されたファイルおよびハードリンクだけをリハイドレートします。
$ pkg -R /tmp/test_image rehydrate -p test1使用例 35 イメージ内の個々のパスの検証
パス /tmp/test_image/usr/bin/ls にある個々のファイルを検証して、冗長結果を表示します。
$ pkg -R /tmp/test_image verify -v -p /usr/bin/ls
次の環境変数がサポートされています。
トランスポート操作中に接続しようとするのを待機する秒数 (試行ごと)。これが経過するとクライアントは操作を中止します。値 0 は無制限に待機することを意味します。
デフォルト値: 60
クライアントが操作を中止するまでの、トランスポート操作中に lowspeed 制限 (1024 バイト/秒) を下回っていられる秒数。値 0 は、操作を中止しないことを意味します。
デフォルト値: 30
一時的なトランスポートエラーの最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。
デフォルト値: 4
トランスポート操作中に許可される HTTP または HTTPS リダイレクトの最大数。これを上回ると接続が中止されます。値 0 は、操作を中止しないことを意味します。
デフォルト値: 5
ホストあたりのトランスポート試行の最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。
デフォルト値: 4
同時に更新する子イメージの数。–C オプションが指定されている場合には、無視されます。
子イメージ (通常はインストールされている solaris ブランドの非大域ゾーン) 内への再帰時に、最大 $PKG_CONCURRENCY 個の子イメージを同時に更新します。$PKG_CONCURRENCY が 0 または負数の場合は、すべての子イメージが同時に更新されます。
デフォルト値: 1
パッケージ操作に使用するイメージが含まれるディレクトリ。–R を指定した場合は無視されます。
HTTP または HTTPS プロキシサーバー。http_proxy または https_proxy を設定するには、次の構文を使用します。
http_proxy [protocol://]host[:port]
Updating Systems and Adding Software in Oracle Solaris 11.4の、プロキシの指定に関する説明を参照してください。
プロキシ経由にするべきでないホストの名前のリスト。アスタリスク (*) のみに設定すると、すべてのホストが一致するため、どのホストもプロキシ経由になりません。no_proxy を設定するには、次の構文を使用します。
no_proxy [* | host[,host]...]
次の終了ステータスが返されます。
コマンドが成功しました。
エラーが発生した。
無効なコマンド行オプションが指定された。
複数の操作が要求されましたが、それらの一部のみが成功しました。
変更が行われませんでした - 何もしません。
要求された操作はライブイメージでは実行できません。
インストールまたは更新中のパッケージのライセンスが受け入れられなかったため、要求された操作を完了できません。
イメージは現在別のプロセスによって使用されているため、変更できません。
1 つ以上の SMF アクチュエータがタイムアウトしました。
予期しない例外が発生しました。
A pkg(7) image can be located arbitrarily within a larger file system.次のファイル説明で、トークン $IMAGE_ROOT は相対パスを区別するために使用されています。一般的なシステムインストールでは、 $IMAGE_ROOT は / と等価です。
完全または部分的なイメージのメタデータディレクトリ。
ユーザーイメージのメタデータディレクトリ。
特定のイメージのメタデータ内のファイルやディレクトリによっては、修復および復旧中に役立つ情報が含まれている可能性があります。トークン $IMAGE_META は、メタデータが含まれる最上位ディレクトリを参照します。$IMAGE_META は通常、上に示した 2 つのパスのいずれかです。
パッケージ操作中に移動された、競合するディレクトリおよびファイルの場所。削除されたディレクトリのパッケージ化されない内容の場所。
パブリッシャーごとに 1 つのディレクトリが含まれます。各ディレクトリにはパブリッシャー固有のメタデータが格納されます。
$IMAGE_META ディレクトリ階層内のほかのパスは非公開であり、変更される可能性があります。
属性についての詳細は、マニュアルページの attributes(7) を参照してください。
|
pkgsend(1), beadm(8), pkg.depotd(8), pkg.sysrepo(8), glob(3C), pkg(7), svc.periodicd(8)
Updating Systems and Adding Software in Oracle Solaris 11.4
https://github.com/oracle/solaris-ips