<?xml version="1.0" encoding="utf-8"?>

<!--Arbortext, Inc., 1988-2008, v.4002-->

<!DOCTYPE refentry PUBLIC "-//Sun Microsystems//DTD SolBook-XML 3.7//EN" "xsolbook.dtd" [

<!ENTITY % ent SYSTEM "entities.ent">

%ent;

]>

<refentry lang="ja" id="pkg-1">

</refmeta>

<refnamediv>

<refname>pkg</refname><refpurpose>Image Packaging System 取得クライアント</refpurpose>

</refnamediv>

<refsynopsisdiv><title></title>

<synopsis>/usr/bin/pkg [<replaceable>options</replaceable>] command [<replaceable>

cmd_options</replaceable>] [<replaceable>operands</replaceable>]</synopsis>

<synopsis>/usr/bin/pkg refresh [-q] [--full] [<replaceable>publisher</replaceable> ...]

</synopsis>

<synopsis>/usr/bin/pkg install [-nvq] [-C <replaceable>n</replaceable>] [-g <replaceable>path_or_uri</replaceable>]...

    [-r [[-z <replaceable>zonename</replaceable>]... | [-Z <replaceable>zonename</replaceable>]... ]]

    [--accept] [--licenses] [--no-index] [--no-refresh]

    [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    [--reject <replaceable>pkg_fmri_pattern</replaceable>]...

    [--sync-actuators | --sync-actuators-timeout <replaceable>timeout</replaceable>]

    <replaceable>pkg_fmri_pattern</replaceable> ...</synopsis>

<synopsis>/usr/bin/pkg exact-install [-nvq] [-C <replaceable>n</replaceable>] [-g <replaceable>path_or_uri</replaceable>]...

    [--accept] [--licenses] [--no-index] [--no-refresh]

    [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    [--reject <replaceable>pkg_fmri_pattern</replaceable>]...  <replaceable>pkg_fmri_pattern</replaceable> ...</synopsis>

<synopsis>/usr/bin/pkg uninstall [-nvq] [-C <replaceable>n</replaceable>]

    [-r [[-z <replaceable>zonename</replaceable>]... | [-Z <replaceable>zonename</replaceable>]... ]]

    [--ignore-missing] [--no-index] [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    [--sync-actuators | --sync-actuators-timeout <replaceable>timeout</replaceable>]

    <replaceable>pkg_fmri_pattern</replaceable> ...</synopsis>

<synopsis>/usr/bin/pkg update [-fnvq] [-C <replaceable>n</replaceable>] [-g <replaceable>path_or_uri</replaceable>]...

    [-r [[-z <replaceable>zonename</replaceable>]... | [-Z <replaceable>zonename</replaceable>]... ]]

    [--accept] [--ignore-missing] [--licenses]

    [--no-index] [--no-refresh] [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    [--reject <replaceable>pkg_fmri_pattern</replaceable>]...

    [--sync-actuators | --sync-actuators-timeout <replaceable>timeout</replaceable>]

    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg list [-Hafnqsuv] [-g <replaceable>path_or_uri</replaceable>]...

    [--no-refresh] [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg info [-lqr] [-g <replaceable>path_or_uri</replaceable>]... [--license]

    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg contents [-Hmr] [-a <replaceable>attribute</replaceable>=<replaceable>pattern</replaceable>]...

    [-g <replaceable>path_or_uri</replaceable>]... [-o <replaceable>attribute</replaceable>[,<replaceable>attribute</replaceable>]...]...

    [-s <replaceable>sort_key</replaceable>] [-t <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]...

    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg search [-HIaflpr]

    [-o <replaceable>attribute</replaceable>[,<replaceable>attribute</replaceable>]...]... [-s <replaceable>repo_uri</replaceable>] <replaceable>query</replaceable></synopsis>

<synopsis>/usr/bin/pkg fix [-Hnvq] [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    [--accept] [--licenses] [--parsable <replaceable>version</replaceable>] [--unpackaged] [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg revert [-nv] [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    (--tagged <replaceable>tag-name</replaceable> ... | <replaceable>path-to-file</replaceable> ...)</synopsis>

<synopsis>/usr/bin/pkg mediator [-aH] [-F <replaceable>format</replaceable>] [<replaceable>mediator</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg set-mediator [-nv] [-I <replaceable>implementation</replaceable>]

    [-V <replaceable>version</replaceable>] [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    <replaceable>mediator</replaceable> ...</synopsis>

<synopsis>/usr/bin/pkg unset-mediator [-nvIV] [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    <replaceable>mediator</replaceable> ...</synopsis>

<synopsis>/usr/bin/pkg variant [-Haiv] [-F <replaceable>format</replaceable>] [<replaceable>variant_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg change-variant [-nvq] [-C <replaceable>n</replaceable>] [-g <replaceable>path_or_uri</replaceable>]...

    [-r [[-z <replaceable>zonename</replaceable>]... | [-Z <replaceable>zonename</replaceable>]... ]]

    [--accept] [--licenses] [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    [--sync-actuators | --sync-actuators-timeout <replaceable>timeout</replaceable>]

    <replaceable>variant_name</replaceable>=<replaceable>value</replaceable> ...</synopsis>

<synopsis>/usr/bin/pkg facet [-Haim] [-F <replaceable>format</replaceable>] [<replaceable>facet_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg change-facet [-nvq] [-C <replaceable>n</replaceable>] [-g <replaceable>path_or_uri</replaceable>]...

    [-r [[-z <replaceable>zonename</replaceable>]... | [-Z <replaceable>zonename</replaceable>]... ]]

    [--accept] [--licenses] [--no-be-activate]

    [--no-backup-be | --require-backup-be]

    [--backup-be-name <replaceable>name</replaceable>]

    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]

    [--sync-actuators | --sync-actuators-timeout <replaceable>timeout</replaceable>]

    <replaceable>facet_name</replaceable>=(True|False|None) ...</synopsis>

<synopsis>/usr/bin/pkg avoid [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg unavoid [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg freeze [-n] [-c <replaceable>reason</replaceable>] [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg unfreeze [-n] [<replaceable>pkg_name_pattern</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg property [-H] [<replaceable>propname</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg set-property <replaceable>propname</replaceable> <replaceable>propvalue</replaceable></synopsis>

<synopsis>/usr/bin/pkg add-property-value <replaceable>propname</replaceable> <replaceable>propvalue</replaceable></synopsis>

<synopsis>/usr/bin/pkg remove-property-value <replaceable>propname</replaceable> <replaceable>propvalue</replaceable></synopsis>

<synopsis>/usr/bin/pkg unset-property <replaceable>propname</replaceable> ...</synopsis>

<synopsis>/usr/bin/pkg publisher [-HPn] [-F <replaceable>format</replaceable>] [<replaceable>publisher</replaceable> ...]</synopsis>

<synopsis>/usr/bin/pkg set-publisher [-Ped] [-c <replaceable>ssl_cert</replaceable>] [-k <replaceable>ssl_key</replaceable>]

    [-g <replaceable>origin_to_add</replaceable> | --add-origin <replaceable>origin_to_add</replaceable>]...

    [-G <replaceable>origin_to_remove</replaceable> | --remove-origin <replaceable>origin_to_remove</replaceable>]...

    [-m <replaceable>mirror_to_add</replaceable> | --add-mirror <replaceable>mirror_to_add</replaceable>]...

    [-M <replaceable>mirror_to_remove</replaceable> | --remove-mirror <replaceable>mirror_to_remove</replaceable>]...

    [--disable] [--enable] [--no-refresh] [--reset-uuid]

    [--non-sticky] [--sticky] [--search-after <replaceable>publisher</replaceable>]

    [--search-before <replaceable>publisher</replaceable>] [--search-first]

    [--approve-ca-cert <replaceable>path_to_CA</replaceable>]

    [--revoke-ca-cert <replaceable>hash_of_CA_to_remove</replaceable>]

    [--unset-ca-cert <replaceable>hash_of_CA_to_remove</replaceable>]

    [--set-property <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>]

    [--add-property-value <replaceable>name_of_property</replaceable>=<replaceable>value_to_add</replaceable>]

    [--remove-property-value <replaceable>name_of_property</replaceable>=<replaceable>value_to_remove</replaceable>]

    [--unset-property <replaceable>name_of_property_to_delete</replaceable>]

    [--proxy <replaceable>proxy_to_use</replaceable>] <replaceable>publisher</replaceable></synopsis>

<synopsis>/usr/bin/pkg set-publisher -p <replaceable>repo_uri</replaceable> [-Ped]

    [-c <replaceable>ssl_cert</replaceable>] [-k <replaceable>ssl_key</replaceable>] [--non-sticky] [--sticky]

    [--search-after <replaceable>publisher</replaceable>] [--search-before <replaceable>publisher</replaceable>]

    [--search-first] [--approve-ca-cert <replaceable>path_to_CA</replaceable>]

    [--revoke-ca-cert <replaceable>hash_of_CA_to_remove</replaceable>]

    [--unset-ca-cert <replaceable>hash_of_CA_to_remove</replaceable>]

    [--set-property <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>]

    [--add-property-value <replaceable>name_of_property</replaceable>=<replaceable>value_to_add</replaceable>]

    [--remove-property-value <replaceable>name_of_property</replaceable>=<replaceable>value_to_remove</replaceable>]

    [--unset-property <replaceable>name_of_property_to_delete</replaceable>]

    [--proxy <replaceable>proxy_to_use</replaceable>] [<replaceable>publisher</replaceable>]</synopsis>

<synopsis>/usr/bin/pkg unset-publisher <replaceable>publisher</replaceable> ...</synopsis>

<synopsis>/usr/bin/pkg history [-HNl]

    [-n <replaceable>number</replaceable>] [-o <replaceable>column</replaceable>[,<replaceable>column</replaceable>]...]...

    [-t <replaceable>time</replaceable> | <replaceable>time</replaceable>-<replaceable>time</replaceable>[,<replaceable>time</replaceable> | <replaceable>time</replaceable>-<replaceable>time</replaceable>]...]...</synopsis>

<synopsis>/usr/bin/pkg purge-history</synopsis>

<synopsis>/usr/bin/pkg rebuild-index</synopsis>

<synopsis>/usr/bin/pkg update-format</synopsis>

<synopsis>/usr/bin/pkg version</synopsis>

<synopsis>/usr/bin/pkg help [-v]</synopsis>

<synopsis>/usr/bin/pkg image-create [-FPUfz] [--force]

    [--full | --partial | --user] [--zone]

    [-c <replaceable>ssl_cert</replaceable>] [-k <replaceable>ssl_key</replaceable>]

    [-g <replaceable>path_or_uri</replaceable> | --origin <replaceable>path_or_uri</replaceable>]...

    [-m <replaceable>uri</replaceable> | --mirror <replaceable>uri</replaceable>]...

    [--facet <replaceable>facet_name</replaceable>=(True|False)]... [--no-refresh]

    [--set-property <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>]

    [--variant <replaceable>variant_name</replaceable>=<replaceable>value</replaceable>]...

    [(-p | --publisher) [<replaceable>name</replaceable>=]<replaceable>repo_uri</replaceable>] <replaceable>dir</replaceable></synopsis>

<synopsis>/usr/bin/pkg -R <replaceable>dir</replaceable> dehydrate [-nvq] [-p <replaceable>publisher</replaceable>]...</synopsis>

<synopsis>/usr/bin/pkg -R <replaceable>dir</replaceable> rehydrate [-nvq] [-p <replaceable>publisher</replaceable>]...</synopsis>

</refsynopsisdiv>

<refsect1 id="pkg-1-desc" role="description"><title></title>

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

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

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

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

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

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

</refsect1>

<refsect1 role="options"><title></title>

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

<variablelist termlength="wholeline">

<varlistentry><term><option>?</option></term><term><option>-help</option></term>

<listitem><para>使用方法に関するメッセージを表示します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term>

<listitem><para><replaceable>dir</replaceable> をルートとするイメージを操作します。ディレクトリが指定されなかったか、または環境に基づいて決定される場合、デフォルトは / です。詳細は、「環境変数」のセクションを参照してください。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>-no-network-cache</option></term>

<listitem><para>操作中に使用されるプロキシなどのネットワークサーバーがキャッシュされたデータを無視するように要求します。このオプションを使用して、パッケージクライアントとネットワークベースのパッケージリポジトリ間のプロキシのキャッシュによって発生する可能性がある問題のトラブルシューティングを行います。</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 role="subcommands"><title></title>

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

<variablelist termlength="wholeline">

<varlistentry><term><command>pkg refresh</command> [<option>q</option>] [<option> -full</option>] [<replaceable>publisher</replaceable> ...]</term>

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

<variablelist termlength="wholeline">

<varlistentry><term><replaceable>publisher</replaceable></term>

<listitem><para>クライアントの利用可能パッケージの一覧、および指定されたパブリッシャーのパブリッシャーメタデータのみを更新します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>q</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-full</option></term>

<listitem><para>増分更新を試みる代わりにすべての発行元メタデータを強制的に完全取得し、操作中に使用されるすべてのプロキシでキャッシュデータを無視するようにリクエストします。このオプションはトラブルシューティング目的に用意されており、通常時は使用しないでください。</para>

</listitem>

</varlistentry>

</variablelist>

</listitem>

</varlistentry>

<varlistentry><term><command>pkg install</command> [<option>nvq</option>] [<option>C</option> <replaceable>n</replaceable>] [<option>g</option> <replaceable>path_or_uri</replaceable>]... [<option>r</option> [[<option>z</option> <replaceable>zonename</replaceable>]... | [<option>Z</option> <replaceable>zonename</replaceable>]... ]] [<option>-accept</option>] [<option>-licenses</option>] [<option>-no-index</option>] [<option>-no-refresh</option>] [<option>-no-be-activate</option>] [<option>-no-backup-be</option> | <option>-require-backup-be</option>] [<option>-backup-be-name</option> <replaceable>name</replaceable>] [<option>-deny-new-be</option> | <option>-require-new-be</option>] [<option>-be-name</option> <replaceable>name</replaceable>] [<option>-reject</option> <replaceable>pkg_fmri_pattern</replaceable>]... [<option>-sync-actuators</option> | <option>-sync-actuators-timeout</option> <replaceable>timeout</replaceable>] <replaceable>pkg_fmri_pattern</replaceable> ...</term>

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

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

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

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

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

<variablelist termlength="wholeline">

<varlistentry><term><option>C</option> <replaceable>n</replaceable></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>g</option> <replaceable>path_or_uri</replaceable></term>

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

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

</listitem>

</varlistentry>

<varlistentry><term><option>n</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>q</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>r</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>z</option> <replaceable>zonename</replaceable></term>

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

</varlistentry>

<varlistentry><term><option>Z</option> <replaceable>zonename</replaceable></term>

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

</varlistentry>

<varlistentry><term><option>v</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-accept</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-licenses</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-no-index</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-no-refresh</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-no-be-activate</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-no-backup-be</option></term>

<listitem><para>バックアップブート環境を作成しません。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>-require-backup-be</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-backup-be-name</option> <replaceable>name</replaceable></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-deny-new-be</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-require-new-be</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-be-name</option> <replaceable>name</replaceable></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-reject</option> <replaceable>pkg_fmri_pattern</replaceable></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-sync-actuators</option></term>

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

</varlistentry>

<varlistentry><term><option>-sync-actuators-timeout</option> <replaceable>timeout</replaceable></term>

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

</varlistentry>

</variablelist>

</listitem>

</varlistentry>

<varlistentry><term><command>pkg exact-install</command> [<option>nvq</option>] [<option>C</option> <replaceable>n</replaceable>] [<option>g</option> <replaceable>path_or_uri</replaceable>]... [<option>-accept</option>] [<option>-licenses</option>] [<option>-no-index</option>] [<option>-no-refresh</option>] [<option>-no-be-activate</option>] [<option>-no-backup-be</option> | <option>-require-backup-be</option>] [<option>-backup-be-name</option> <replaceable>name</replaceable>] [<option>-deny-new-be</option> | <option>-require-new-be</option>] [<option>-be-name</option> <replaceable>name</replaceable>] [<option>-reject</option> <replaceable>pkg_fmri_pattern</replaceable>]... <replaceable>pkg_fmri_pattern</replaceable> ...</term>

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

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

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

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

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

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

</listitem>

</varlistentry>

<varlistentry><term><command>pkg uninstall</command> [<option>nvq</option>] [<option>C</option> <replaceable>n</replaceable>] [<option>r</option> [[<option>z</option> <replaceable>zonename</replaceable>]... | [<option>Z</option> <replaceable>zonename</replaceable>]... ]] [<option>-ignore-missing</option>] [<option>-no-index</option>] [<option>-no-be-activate</option>] [<option>-no-backup-be</option> | <option>-require-backup-be</option>] [<option>-backup-be-name</option> <replaceable>name</replaceable>] [<option>-deny-new-be</option> | <option>-require-new-be</option>] [<option>-be-name</option> <replaceable>name</replaceable>] [<option>-sync-actuators</option> | <option>-sync-actuators-timeout</option> <replaceable>timeout</replaceable>] <replaceable>pkg_fmri_pattern</replaceable> ...</term>

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

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

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

<variablelist termlength="wholeline">

<varlistentry><term><option>-ignore-missing</option></term>

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

</listitem>

</varlistentry>

</variablelist>

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

</listitem>

</varlistentry>

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

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

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

<variablelist termlength="wholeline">

<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>

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

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

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

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

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

</listitem>

</varlistentry>

<varlistentry><term><option>f</option></term>

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

</listitem>

</varlistentry>

<varlistentry><term><option>-ignore-missing</option></term>

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

</listitem>

</varlistentry>

</variablelist>

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

</listitem>

</varlistentry>

<varlistentry><term><command>pkg list</command> [<option>Hafnqsuv</option>] [<option>g</option> <replaceable>path_or_uri</replaceable>]... [<option>-no-refresh</option>] [<replaceable>pkg_fmri_pattern</replaceable> ...]</term>

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

<programlisting>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--</programlisting>

<para>最初の列にはパッケージの名前が表示されます。パッケージのインストール元 (または、インストールされていない場合は提供元) であるパブリッシャーがパブリッシャー検索順で先頭でない場合、パッケージ名のあとに一覧表示されるパブリッシャー名は括弧で囲まれています。2 番目の列にはパッケージのリリースバージョンとブランチバージョンが表示されます。リリースバージョンとブランチバージョンについて、およびバリアントについては、<literal>pkg</literal>(7) のマニュアルページを参照してください。</para>

<itemizedlist>

<para>最後の列には、パッケージのステータスを示す一連のフラグが表示されます。</para>

<listitem><para><literal>I</literal> 列の <literal>i</literal> は、パッケージがインストールされていることを示します。</para></listitem>

<listitem><para><literal>F</literal> 列の <literal>f</literal> は、パッケージが凍結されていることを示します。</para></listitem>

<listitem><para><literal>O</literal> 列の <literal>o</literal> は、パッケージが廃止されていることを示します。<literal>O</literal> 列の <literal>r</literal> は、パッケージの名前が変更されたことを示します (廃止の形態の 1 つです)。</para>

</listitem>

</itemizedlist>

<variablelist termlength="wholeline">

<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>

<listitem><para>指定したパッケージのみを一覧表示します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>H</option> </term>

<listitem><para>一覧からヘッダーを省略します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>a</option></term>

<listitem><para>このイメージにインストールされているパッケージと、インストールされていないが、インストール可能なパッケージの最新バージョンを一覧表示します。パッケージがインストール済みの incorporation およびイメージのバリアントによって許可されている場合は、それらをインストールできます。1 つ以上のパターンを指定した場合、指定されたパターンに一致し、インストール済みの incorporation およびイメージのバリアントによって許可されている最新バージョンが一覧表示されます。<option>a</option> を指定しない場合、インストール済みパッケージのみを一覧表示します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>af</option></term>

<listitem><para>incorporation の制約またはインストール状態に関係なく、すべてのバリアントについてすべてのパッケージのすべてのバージョンを一覧表示します。これらのオプションを使用するとき、パッケージの最新バージョンを明示的に一覧表示するには、<replaceable>pkg_fmri_pattern</replaceable> のバージョン部分に <literal>latest</literal> を使用します。たとえば、<literal>vim@latest</literal> のように指定します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>g</option> <replaceable>path_or_uri</replaceable></term>

<listitem><para>指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。<option>n</option> を指定しない場合、<option>g</option> を使用すると <option>a</option> が暗黙的に指定されます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>n</option></term>

<listitem><para>インストール状態に関係なく、すべての既知のパッケージの最新バージョンを表示します。</para>

</listitem>

</varlistentry>

<varlistentry>

<term><option>q</option></term>

<listitem>

<para>パッケージを一覧表示しませんが、致命的エラーが発生した場合は失敗を返します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>s</option></term>

<listitem><para>パッケージ名とサマリーを示す 1 行の短縮形式を表示します。このオプションは <option>a</option>、<option>n</option>、または <option>u</option> とともに使用できます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>u</option></term>

<listitem><para>新しいバージョンが入手可能なインストール済みパッケージを一覧表示します。このオプションは <option>g</option> とともに使用できません。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>v</option></term>

<listitem><para>発行元と完全バージョンを含む、フルパッケージ FMRI をすべて最初の列に表示します (VERSION 列は消えます)。このオプションは <option>a</option>、<option>n</option>、または <option>u</option> とともに使用できます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>-no-refresh</option></term>

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

</listitem>

</varlistentry>

</variablelist>

</listitem>

</varlistentry>

<varlistentry><term><command>pkg info</command> [<option>lqr</option>] [<option>g</option> <replaceable>path_or_uri</replaceable>]... [<option>-license</option>] [<replaceable>pkg_fmri_pattern</replaceable> ...]</term>

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

<variablelist termlength="wholeline">

<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>

<listitem><para>指定したパッケージの情報のみを表示します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>g</option> <replaceable>path_or_uri</replaceable></term>

<listitem><para>指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。<option>g</option> を使用すると <option>r</option> が暗黙的に指定されます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>l</option></term>

<listitem><para>インストール済みのパッケージの情報だけを表示します。これはデフォルトです。</para>

</listitem>

</varlistentry>

<varlistentry>

<term><option>q</option></term>

<listitem>

<para>パッケージ情報を表示しませんが、致命的エラーが発生した場合は失敗を返します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>r</option></term>

<listitem><para>最新の入手可能バージョンに基づいてパッケージを照合し、イメージの構成済みパブリッシャーのリポジトリから、現在インストールされていないパッケージの情報を取得します (必要な場合)。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。<option>r</option> を指定しない場合、デフォルトでインストール済みパッケージのみが表示されます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>-license</option></term>

<listitem><para>パッケージのライセンステキストを表示します。このオプションは、<option>l</option>、<option>q</option>、または <option>r</option> と組み合わせることができます。すべての <replaceable>pkg_fmri_pattern</replaceable> パターンが既知の問題のパッケージと一致し、ライセンスを持つ場合、成功を返します。1 つ以上のパターンが一致しないか、ライセンスを持たないパッケージと一致した場合、失敗を返します。</para>

</listitem>

</varlistentry>

</variablelist>

</listitem>

</varlistentry>

<varlistentry><term><command>pkg contents</command> [<option>Hmr</option>] [<option>a</option> <replaceable>attribute</replaceable>=<replaceable>pattern</replaceable>]... [<option>g</option> <replaceable>path_or_uri</replaceable>]... [<option>o</option> <replaceable> attribute</replaceable>[,<replaceable>attribute</replaceable>]...]... [<option>s</option> <replaceable> sort_key</replaceable>] [<option>t</option> <replaceable>action_name</replaceable>[,<replaceable> action_name</replaceable>]...]... [<replaceable>pkg_fmri_pattern</replaceable> ...] </term>

<variablelist termlength="wholeline">

<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>

<listitem><para>指定したパッケージの内容のみを表示します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>H</option> </term>

<listitem><para>出力からヘッダーを省略します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>a</option> <replaceable>attribute</replaceable>=<replaceable> pattern</replaceable></term>

<listitem><para>名前がオプション引数で指定され、値がオプション引数の (glob) <replaceable>pattern</replaceable> に一致する <replaceable>attribute</replaceable> を持つアクションに出力を限定します。このオプションは複数回指定できます。複数の <option>a</option> オプションを指定した場合、それらのいずれかに一致するアクションが表示されます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>g</option> <replaceable>path_or_uri</replaceable></term>

<listitem><para>指定されたパッケージリポジトリまたはアーカイブからこのイメージにインストール可能なパッケージの情報を表示します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションは複数回指定できます。<option>g</option> を使用すると <option>r</option> が暗黙的に指定されます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>m</option></term>

<listitem><para>このイメージにインストールできないアクションを含めて、指定されたパッケージのすべてのアクションのすべての属性を表示します。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>o</option> <replaceable>attribute</replaceable></term>

<listitem><para>指定された属性を、リストの先頭属性の値に従って並べ替えて表示します。<option>o</option> オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの <option>o</option> オプションの引数として複数の属性を指定できます。要求された属性を持つアクションのみが表示されます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>r</option></term>

<listitem><para>このイメージ内で構成された発行元のリポジトリからこのイメージにインストール可能なパッケージの最新バージョンの情報を表示します。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>s</option> <replaceable>sort_key</replaceable></term>

<listitem><para>指定されたアクション属性で、アクションをソートします。このオプションを指定しない場合、デフォルトではパスによって、または <option>o</option> オプションで最初に指定された属性によってソートします。<option>s</option> オプションは複数回指定できます。</para>

</listitem>

</varlistentry>

<varlistentry><term><option>t</option> <replaceable>action_name</replaceable></term>

<listitem><para>指定されたアクションのみを一覧表示します。<option>t</option> オプションは複数回指定できます。または、アクション名をコンマで区切ることにより、1 つの <option>t</option> オプションの引数として複数のアクションを指定できます。<replaceable>action_name</replaceable> の値は、<literal>pkg</literal>(7) のマニュアルページの「アクション」内に一覧表示されているアクションのいずれかで、<literal>file</literal>、<literal>directory</literal>、<literal>driver</literal>、<literal>depend</literal>、<literal>set</literal> などです。</para>

</listitem>

</varlistentry>

</variablelist>

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

<variablelist termlength="wholeline">

<varlistentry><term><literal>action.hash</literal></term>

<listitem><para>アクションがペイロードを伝送する場合、アクションのハッシュの値です。</para>