20077716 generate nroff man pages from xml s11-update s11u3b26
authorErik Trauschke <Erik.Trauschke@oracle.com>
Wed, 01 Jul 2015 10:45:55 -0700
branchs11-update
changeset 3232 a1fb8dcc1a5e
parent 3230 30355eee0c43
child 3233 c70b526fbdd7
20077716 generate nroff man pages from xml 21290367 pkg(1) man page about pkg dehydrate needs clarification 21357680 sync localized man pages for 11.3
.hgignore
src/man/ja_JP/packagemanager.1
src/man/ja_JP/pkg.1
src/man/ja_JP/pkg.5
src/man/ja_JP/pkg.depotd.1m
src/man/ja_JP/pkg.sysrepo.1m
src/man/ja_JP/pkgdepend.1
src/man/ja_JP/pkgdiff.1
src/man/ja_JP/pkgfmt.1
src/man/ja_JP/pkglint.1
src/man/ja_JP/pkgmerge.1
src/man/ja_JP/pkgmogrify.1
src/man/ja_JP/pkgrecv.1
src/man/ja_JP/pkgrepo.1
src/man/ja_JP/pkgsend.1
src/man/ja_JP/pkgsign.1
src/man/ja_JP/pm-updatemanager.1
src/man/packagemanager.1
src/man/pkg.1
src/man/pkg.5
src/man/pkg.depot-config.1m
src/man/pkg.depotd.1m
src/man/pkg.sysrepo.1m
src/man/pkgdepend.1
src/man/pkgdiff.1
src/man/pkgfmt.1
src/man/pkglint.1
src/man/pkgmerge.1
src/man/pkgmogrify.1
src/man/pkgrecv.1
src/man/pkgrepo.1
src/man/pkgsend.1
src/man/pkgsign.1
src/man/pkgsurf.1
src/man/pm-updatemanager.1
src/man/zh_CN/packagemanager.1
src/man/zh_CN/pkg.1
src/man/zh_CN/pkg.5
src/man/zh_CN/pkg.depotd.1m
src/man/zh_CN/pkg.sysrepo.1m
src/man/zh_CN/pkgdepend.1
src/man/zh_CN/pkgdiff.1
src/man/zh_CN/pkgfmt.1
src/man/zh_CN/pkglint.1
src/man/zh_CN/pkgmerge.1
src/man/zh_CN/pkgmogrify.1
src/man/zh_CN/pkgrecv.1
src/man/zh_CN/pkgrepo.1
src/man/zh_CN/pkgsend.1
src/man/zh_CN/pkgsign.1
src/man/zh_CN/pm-updatemanager.1
src/pkg/external_deps.txt
src/pkg/manifests/developer:opensolaris:pkg5.p5m
src/setup.py
--- a/.hgignore	Tue Jun 23 10:48:54 2015 +0530
+++ b/.hgignore	Wed Jul 01 10:45:55 2015 -0700
@@ -32,6 +32,7 @@
 ^src/gui/help/.*/package-manager.localizable.xml$
 ^src/gui/help/.*/pkg_help.pot$
 ^src/gui/help/package-manager-__LOCALE__.omf$
+^src/man/nroff
 ^src/pkg/Makefile.link
 ^src/pkg/pkgtmp/
 ^src/po/i18n_errs.txt$
--- a/src/man/ja_JP/packagemanager.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/packagemanager.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,288 +1,153 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH packagemanager 1 "2013 年 5 月 21 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-packagemanager \- Image Packaging System の GUI 
-.SH 形式
-.LP
-.nf
-/usr/bin/packagemanager [\fIoptions\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/packagemanager [-h | --help]
-    [-i | --info-install \fIfile\fR] [-U | --update-all]
-    [-R | --image-dir \fIdir\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/packagemanager [\fIfile\fR]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpackagemanager\fR は、\fB pkg\fR(5) (Image Packaging System ソフトウェア) のグラフィカルユーザーインタフェースです。
-.sp
-.LP
-パッケージマネージャーを使用すると、次のタスクを実行できます。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-パッケージの検索、インストール、および削除
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-パブリッシャーの追加、削除、および変更
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ブート環境の作成、削除、および管理
-.RE
-.sp
-.LP
-\fIfile\fR オペランドが指定されていて、その接尾辞が \fB\&.p5i\fR である場合、\fBpackagemanager\fR は Web インストールモードで起動し、1 つ以上のパブリッシャーおよびパブリッシャーごとに数多くのパッケージが追加されます。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIfile\fR\fR
-.ad
-.br
-.na
-\fB\fB--info-install\fR \fIfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB\&.p5i\fR ファイルを指定して、\fBpackagemanager\fR を Web インストールモードで実行します。\fIfile\fR の接尾辞は \fB\&.p5i\fR である必要があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.br
-.na
-\fB\fB--image-dir\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-自動的に検出されたイメージではなく、\fIdir\fR をルートとするイメージに対して処理を行います。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-U\fR\fR
-.ad
-.br
-.na
-\fB\fB--update-all\fR\fR
-.ad
-.sp .6
-.RS 4n
-利用可能な更新があるすべてのインストール済みパッケージを更新します。
-.LP
-注 - 
-.sp
-.RS 2
-\fBpackage/pkg\fR、\fBpackage/pkg/package-manager \fR、または \fBpackage/pkg/update-manager\fR を更新する必要がある場合、\fBpackagemanager\fR は最初にこれらのパッケージを更新してから、残りの更新を実行するために再起動されます。
-.RE
-.RE
-
-.SH オペランド
-.sp
-.ne 2
-.mk
-.na
-\fB\fIfile\fR\fR
-.ad
-.RS 8n
-.rt  
-Web インストールファイル。このファイルの接尾辞は \fB\&.p5i\fR である必要があります。Web インストールについての詳細は、パッケージマネージャーのオンラインヘルプを参照してください。
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fR現在のイメージで操作する
-.sp
-.LP
-現在のイメージで \fBpackagemanager\fR を起動します。
+<?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="packagemanager-1">
+<!-- %Z%%M% %I% %E% SMI; -->
+<refmeta><refentrytitle>packagemanager</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo> 
+</refmeta>
+<refnamediv>
+<refname>packagemanager</refname><refpurpose>Image Packaging System の GUI </refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/packagemanager [<replaceable>options</replaceable>]</synopsis>
+<synopsis>/usr/bin/packagemanager [-h | --help]
+    [-i | --info-install <replaceable>file</replaceable>] [-U | --update-all]
+    [-R | --image-dir <replaceable>dir</replaceable>]</synopsis>
+<synopsis>/usr/bin/packagemanager [<replaceable>file</replaceable>]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="packagemanager-1-desc" role="description"><title></title>
+<para><command>packagemanager</command> は、<literal> pkg</literal>(5) (Image Packaging System ソフトウェア) のグラフィカルユーザーインタフェースです。</para>
+<itemizedlist>
+<para>パッケージマネージャーを使用すると、次のタスクを実行できます。</para>
+<listitem><para>パッケージの検索、インストール、および削除</para></listitem>
+<listitem><para>パブリッシャーの追加、削除、および変更</para></listitem>
+<listitem><para>ブート環境の作成、削除、および管理</para></listitem>
+</itemizedlist>
+<para><replaceable>file</replaceable> オペランドが指定されていて、その接尾辞が <literal>.p5i</literal> である場合、<command>packagemanager</command> は Web インストールモードで起動し、1 つ以上のパブリッシャーおよびパブリッシャーごとに数多くのパッケージが追加されます。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>サポートしているオプションは、次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>file</replaceable></term> <term><option>-info-install</option> <replaceable>file</replaceable></term>
+<listitem><para><literal>.p5i</literal> ファイルを指定して、<command>packagemanager</command> を Web インストールモードで実行します。<replaceable>file</replaceable> の接尾辞は <literal>.p5i</literal> である必要があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term> <term><option>-image-dir</option> <replaceable>dir</replaceable></term>
+<listitem><para>自動的に検出されたイメージではなく、<replaceable>dir</replaceable> をルートとするイメージに対して処理を行います。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>U</option></term><term><option>-update-all</option></term>
+<listitem><para>利用可能な更新があるすべてのインストール済みパッケージを更新します。</para>
+<note><para><literal>package/pkg</literal>、<literal>package/pkg/package-manager </literal>、または <literal>package/pkg/update-manager</literal> を更新する必要がある場合、<command>packagemanager</command> は最初にこれらのパッケージを更新してから、残りの更新を実行するために再起動されます。</para></note>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="operands"><title></title>
+<variablelist>
+<varlistentry><term><replaceable>file</replaceable></term>
+<listitem><para>Web インストールファイル。このファイルの接尾辞は <literal>.p5i</literal> である必要があります。Web インストールについての詳細は、パッケージマネージャーのオンラインヘルプを参照してください。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>現在のイメージで操作する</title>
+<para>現在のイメージで <command>packagemanager</command> を起動します。</para>
+<screen>$ <userinput>packagemanager</userinput></screen>
+</example>
+<example><title>指定されたイメージで操作する</title>
+<para><filename>/aux0/example_root</filename> に格納されたイメージで <command>packagemanager</command> を起動します。</para>
+<screen>$ <userinput>packagemanager -R /aux0/example_root</userinput></screen>
+</example>
+<example><title>Web インストールモードで起動する</title>
+<para>Web インストールモードで <command>packagemanager</command> を起動します。</para>
+<screen>$ <userinput>packagemanager ~/test.p5i</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>すべてが動作しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para><literal>pkg</literal>(5) イメージはより大きなファイルシステム内に任意に配置できるため、トークン <envar>$IMAGE_ROOT</envar> を使用して相対パスが区別されます。標準のシステムインストールでは、<envar>$IMAGE_ROOT</envar> は / と同等です。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>完全または部分的なイメージのメタデータディレクトリ。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>ユーザーイメージのメタデータディレクトリ。</para>
+<para>特定のイメージのメタデータ内にある特定のファイルおよびディレクトリには、修復時や復旧時に役立つ情報が含まれています。トークン <envar>$IMAGE_META </envar> は、メタデータが含まれる最上位ディレクトリを参照するために使用されます。通常、<envar> $IMAGE_META</envar> は前述の 2 つのパスのいずれかです。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/gui-cache</filename></term>
+<listitem><para>プログラムの起動やパブリッシャーの切り替えの速度を上げるために <command>packagemanager</command> で保持されるキャッシュ済みメタデータの場所。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><envar>$IMAGE_META</envar> ディレクトリ階層内のその他のパスは非公開であり、変更される可能性があります。</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg/package-manager</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pm-updatemanager-1"><citerefentry><refentrytitle>pm-updatemanager</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para>パッケージマネージャーのオンラインヘルプ</para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para><command>packagemanager</command> は、イメージのファイルおよびディレクトリで操作するために十分な権限で起動する必要があります。</para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-$ \fBpackagemanager\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fR指定されたイメージで操作する
-.sp
-.LP
-\fB/aux0/example_root\fR に格納されたイメージで \fBpackagemanager\fR を起動します。
-
-.sp
-.in +2
-.nf
-$ \fBpackagemanager -R /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 3 \fRWeb インストールモードで起動する
-.sp
-.LP
-Web インストールモードで \fBpackagemanager\fR を起動します。
-
-.sp
-.in +2
-.nf
-$ \fBpackagemanager ~/test.p5i\fR
-.fi
-.in -2
-.sp
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 5n
-.rt  
-すべてが動作しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 5n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 5n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.SH ファイル
-.sp
-.LP
-\fBpkg\fR(5) イメージはより大きなファイルシステム内に任意に配置できるため、トークン \fB$IMAGE_ROOT\fR を使用して相対パスが区別されます。標準のシステムインストールでは、\fB$IMAGE_ROOT\fR は / と同等です。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-完全または部分的なイメージのメタデータディレクトリ。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーイメージのメタデータディレクトリ。
-.sp
-特定のイメージのメタデータ内にある特定のファイルおよびディレクトリには、修復時や復旧時に役立つ情報が含まれています。トークン \fB$IMAGE_META \fR は、メタデータが含まれる最上位ディレクトリを参照するために使用されます。通常、\fB $IMAGE_META\fR は前述の 2 つのパスのいずれかです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/gui-cache\fR\fR
-.ad
-.sp .6
-.RS 4n
-プログラムの起動やパブリッシャーの切り替えの速度を上げるために \fBpackagemanager\fR で保持されるキャッシュ済みメタデータの場所。
-.RE
-
-.sp
-.LP
-\fB$IMAGE_META\fR ディレクトリ階層内のその他のパスは非公開であり、変更される可能性があります。
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg/package-manager\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpm-updatemanager\fR(1), \fBpkg\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-パッケージマネージャーのオンラインヘルプ
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 注意事項
-.sp
-.LP
-\fBpackagemanager\fR は、イメージのファイルおよびディレクトリで操作するために十分な権限で起動する必要があります。
--- a/src/man/ja_JP/pkg.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkg.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,3251 +1,1374 @@
-'\" te
-.\" Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved.
-.TH pkg 1 "2014 年 4 月 7 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkg \- Image Packaging System 取得クライアント
-.SH 形式
-.LP
-.nf
-/usr/bin/pkg [\fIoptions\fR] command [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
+<?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;
+]>
 
-.LP
-.nf
-/usr/bin/pkg refresh [-q] [--full] [\fIpublisher\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg install [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+<refentry lang="ja" id="pkg-1">
+<refmeta><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2015 年 4 月 22 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg exact-install [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...  \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg uninstall [-nvq] [-C \fIn\fR]
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg update [-fnvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg list [-Hafnqsuv] [-g \fIpath_or_uri\fR]...
-    [--no-refresh] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg info [-lqr] [-g \fIpath_or_uri\fR]... [--license]
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg contents [-Hmr] [-a \fIattribute\fR=\fIpattern\fR]...
-    [-g \fIpath_or_uri\fR]... [-o \fIattribute\fR[,\fIattribute\fR]...]...
-    [-s \fIsort_key\fR] [-t \fIaction_name\fR[,\fIaction_name\fR]...]...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg search [-HIaflpr]
-    [-o \fIattribute\fR[,\fIattribute\fR]...]... [-s \fIrepo_uri\fR] \fIquery\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg verify [-Hqv] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg fix [--accept] [--licenses]
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg revert [-nv] [--no-be-activate]
+    [--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 verify [-Hqv] [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkg fix [-Hnvq] [--no-be-activate]
     [--no-backup-be | --require-backup-be]
-    [--backup-be-name \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    (--tagged \fItag-name\fR ... | \fIpath-to-file\fR ...)
-.fi
-
-.LP
-.nf
-/usr/bin/pkg mediator [-aH] [-F \fIformat\fR] [\fImediator\fR ...]
-.fi
-
-.LP
-.nf
-usr/bin/pkg set-mediator [-nv] [-I \fIimplementation\fR]
-    [-V \fIversion\fR] [--no-be-activate]
+    [--backup-be-name <replaceable>name</replaceable>]
+    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]
+    [--accept] [--licenses] [<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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    \fImediator\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-mediator [-nvIV] [--no-be-activate]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    \fImediator\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg variant [-Haiv] [-F \fIformat\fR] [\fIvariant_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg change-variant [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIvariant_name\fR=\fIvalue\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg facet [-Haim] [-F \fIformat\fR] [\fIfacet_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg change-facet [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIfacet_name\fR=(True|False|None) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg avoid [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unavoid [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg freeze [-n] [-c \fIreason\fR] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unfreeze [-n] [\fIpkg_name_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg property [-H] [\fIpropname\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-property \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg add-property-value \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg remove-property-value \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-property \fIpropname\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg publisher [-HPn] [-F \fIformat\fR] [\fIpublisher\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-publisher [-Ped] [-c \fIssl_cert\fR] [-k \fIssl_key\fR]
-    [-g \fIorigin_to_add\fR | --add-origin \fIorigin_to_add\fR]...
-    [-G \fIorigin_to_remove\fR | --remove-origin \fIorigin_to_remove\fR]...
-    [-m \fImirror_to_add\fR | --add-mirror \fImirror_to_add\fR]...
-    [-M \fImirror_to_remove\fR | --remove-mirror \fImirror_to_remove\fR]...
+    [--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 \fIpublisher\fR]
-    [--search-before \fIpublisher\fR] [--search-first]
-    [--approve-ca-cert \fIpath_to_CA\fR]
-    [--revoke-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--unset-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--add-property-value \fIname_of_property\fR=\fIvalue_to_add\fR]
-    [--remove-property-value \fIname_of_property\fR=\fIvalue_to_remove\fR]
-    [--unset-property \fIname_of_property_to_delete\fR]
-    [--proxy \fIproxy_to_use\fR] \fIpublisher\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-publisher -p \fIrepo_uri\fR [-Ped]
-    [-c \fIssl_cert\fR] [-k \fIssl_key\fR] [--non-sticky] [--sticky]
-    [--search-after \fIpublisher\fR] [--search-before \fIpublisher\fR]
-    [--search-first] [--approve-ca-cert \fIpath_to_CA\fR]
-    [--revoke-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--unset-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--add-property-value \fIname_of_property\fR=\fIvalue_to_add\fR]
-    [--remove-property-value \fIname_of_property\fR=\fIvalue_to_remove\fR]
-    [--unset-property \fIname_of_property_to_delete\fR]
-    [--proxy \fIproxy_to_use\fR] [\fIpublisher\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-publisher \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg history [-HNl]
-    [-n \fInumber\fR] [-o \fIcolumn\fR[,\fIcolumn\fR]...]...
-    [-t \fItime\fR | \fItime\fR-\fItime\fR[,\fItime\fR | \fItime\fR-\fItime\fR]...]...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg purge-history
-.fi
-
-.LP
-.nf
-/usr/bin/pkg rebuild-index
-.fi
-
-.LP
-.nf
-/usr/bin/pkg update-format
-.fi
-
-.LP
-.nf
-/usr/bin/pkg version
-.fi
-
-.LP
-.nf
-/usr/bin/pkg help
-.fi
-
-.LP
-.nf
-/usr/bin/pkg image-create [-FPUfz] [--force]
+    [--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</synopsis>
+<synopsis>/usr/bin/pkg image-create [-FPUfz] [--force]
     [--full | --partial | --user] [--zone]
-    [-c \fIssl_cert\fR] [-k \fIssl_key\fR]
-    [-g \fIpath_or_uri\fR | --origin \fIpath_or_uri\fR]...
-    [-m \fIuri\fR | --mirror \fIuri\fR]...
-    [--facet \fIfacet_name\fR=(True|False)]... [--no-refresh]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--variant \fIvariant_name\fR=\fIvalue\fR]...
-    [(-p | --publisher) [\fIname\fR=]\fIrepo_uri\fR] \fIdir\fR
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkg\fR は Image Packaging System 用の取得クライアントです。有効な構成では、\fBpkg\fR を呼び出すことにより、パッケージをインストールする場所を作成し、イメージを呼び出し、パッケージをイメージにインストールすることができます。パッケージはパブリッシャーによって公開され、パブリッシャーはそれらのパッケージを 1 つ以上のリポジトリまたはパッケージアーカイブで利用可能にすることができます。\fBpkg\fR はパブリッシャーのリポジトリまたはパッケージアーカイブからパッケージを取得し、パッケージをイメージにインストールします。
-.sp
-.LP
-パッケージは、BE の一部であるファイルシステムにのみインストールできます。たとえば、デフォルトの Oracle Solaris 11 インストール環境では、パッケージ操作がサポートされるのは、\fBrpool/ROOT/\fIBEname\fR/\fR の下のデータセットのみです。
-.sp
-.LP
-パブリッシャーの名前によって、人、人のグループ、または組織が 1 つ以上のパッケージのソースとして識別されます。パブリッシャーの名前の競合を避け、パブリッシャーを識別しやすくするために、パッケージを公開するエンティティーを表すドメイン名をパブリッシャーの名前として使用することがベストプラクティスです。
-.sp
-.LP
-リポジトリは、クライアントがパッケージの内容 (プログラムやドキュメントなど、パッケージの内部に含まれるファイル) とメタデータ (パッケージの名前や説明など、パッケージについての情報) を公開および取得できる場所です。たとえば、\fBexample.org\fR という名前のパブリッシャーは、\fBhttp://example.org/repository\fR という URI にリポジトリを配置することができます。
-.sp
-.LP
-\fBpkg\fR では、パッケージをアンインストールしたり、(利用可能なパッケージの一覧などの) パブリッシャーメタデータをリフレッシュしたり、イメージにインストールされたパッケージを検証したり、イメージからさまざまなトークンを照会したりすることもできます。これらのクエリーは \fBpkg\fR(5) リポジトリで構成することもできます。
-.sp
-.LP
-イメージには 3 つの種類があります。完全なシステムを提供できるフルイメージ、フルイメージ (親イメージ) にリンクされるがそれ自身では完全なシステムを提供しない部分イメージ、およびユーザーイメージです。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIdir\fR をルートとするイメージを操作します。ディレクトリが指定されなかったか、または環境に基づいて決定される場合、デフォルトは / です。詳細は、「環境変数」のセクションを参照してください。
-.RE
-
-.SH サブコマンド
-.sp
-.LP
-サポートされているサブコマンドは次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg refresh\fR [\fB-q\fR] [\fB- -full\fR] [\fIpublisher\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-クライアントの利用可能パッケージの一覧およびすべてのパブリッシャーのパブリッシャーメタデータを更新します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-クライアントの利用可能パッケージの一覧、および指定されたパブリッシャーのパブリッシャーメタデータのみを更新します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-リクエストされた操作の実行中、進捗状況メッセージを表示しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--full\fR\fR
-.ad
-.sp .6
-.RS 4n
-増分更新を試みる代わりにすべての発行元メタデータを強制的に完全取得し、操作中に使用されるすべてのプロキシでキャッシュデータを無視するようにリクエストします。このオプションはトラブルシューティング目的に用意されており、通常時は使用しないでください。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg install\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージをインストールし、イメージにインストールされたパッケージで許容されている \fIpkg_fmri_pattern\fR と一致する最新バージョンにパッケージを更新します。パッケージの最新バージョンを明示的に要求するには、\fIpkg_fmri_pattern\fR のバージョン部分に \fBlatest\fR を使用します。たとえば、\fBvim@latest\fR のように指定します。\fIpkg_fmri_pattern\fR パターンには、\fBglob\fR(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する \fB?\fR および \fB*\fR 文字を含めることができます。
-.sp
-パッケージは、発行元検索順およびスティッキネスに基づいて選択されます。検索順およびスティッキネスについては、\fBpkg publisher\fR および \fBpkg set-publisher\fR コマンドを参照してください。\fIpkg_fmri_pattern \fR が発行元を指定しない場合、一致するパッケージを提供する最初の発行元がインストール元として使用されます。該当する発行元がこのイメージ内にインストール可能なパッケージのバージョンを提供しない場合、インストール操作は失敗します。このイメージにインストール可能なパッケージのバージョンを提供する発行元を確認するには、\fBpkg list -a\fR コマンドを使用します。
-.sp
-複数の \fIpkg_fmri_pattern\fR が指定され、かつ指定されたパッケージのいずれかをこのイメージにインストールできない場合、指定されたパッケージは一切インストールされません。
-.sp
-インストールプロセスの間に、一部の構成ファイルの名前変更または置換が行われる場合があります。どのファイルを保持するかをパッケージシステムが決定する方法と、パッケージ操作中にファイルが保持されるしくみについては、\fBpkg\fR(5) のマニュアルページのファイルアクションに関する項目を参照してください。
-.sp
-パッケージが回避リストにある場合は、インストールすると回避リストから削除されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-C\fR \fIn\fR\fR
-.ad
-.sp .6
-.RS 4n
-同時に更新する子イメージの数を指定します。子イメージ (通常はインストールされている \fBsolaris\fR ブランドの非大域ゾーン) 内への再帰時に、最大 \fIn\fR 個の子イメージを同時に更新します。更新する子イメージのデフォルト数は、1 です。\fIn\fR が 0 または負数の場合は、すべての子イメージが同時に更新されます。「環境変数」セクションの「\fBPKG_CONCURRENCY\fR」も参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージリポジトリまたはアーカイブを、パッケージデータの取得元になるイメージ内のソースリストに一時的に追加します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。
-.sp
-どのバージョンのパッケージを使用するかを決定するときは、イメージ内に構成されているが、指定された \fIpath_or_uri\fR ソースに見つからない発行元が優先されます。インストールするパッケージのバージョンが、イメージ内で構成されている発行元および \fIpath_or_uri\fR ソースから提供されている場合、クライアントはそのパッケージの内容を \fIpath_or_uri \fR ソースから取得します。インストールまたは更新のあとに、発行元によって提供され、イメージ内で構成されていないパッケージがある場合は、起点なしでイメージ構成に追加されます。イメージ内で構成されている発行元を表示するには、\fBpkg publisher\fR コマンドを使用します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージの変更は行わずに試しに操作を実行します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-リクエストされた操作の実行中、進捗状況メッセージを表示しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-大域ゾーンおよびインストールされているすべての \fBsolaris\fR ブランドの非大域ゾーンで、この操作を実行します。非大域ゾーンへの影響は、各非大域ゾーンにログインして、コマンドを直接実行した場合と似ています。このオプションを指定しないと、大域ゾーンで \fBpkg\fR コマンドを実行した場合、非大域ゾーンは大域ゾーンと互換性を保つために必要な程度でのみ変更されます。このオプションを指定すると、\fBpkg\fR 操作は、\fB-z\fR および \fB-Z\fR オプションで制限されているものを除く、インストールされているすべての非大域ゾーンに適用されます。\fB-z\fR および \fB-Z\fR オプションによって除外されたゾーンは、大域ゾーンと同期を保つために更新が必要な場合、変更される可能性があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-z\fR \fIzonename\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された非大域ゾーンでのみこの操作を実行します。\fB-z\fR オプションは複数回指定できます。\fB-z\fR オプションは、\fB-r\fR オプションと同時に指定した場合のみ使用できます。\fB-z\fR オプションは \fB-Z\fR オプションと一緒に使用できません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-Z\fR \fIzonename\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたゾーンを除くすべての非大域ゾーンでこの操作を実行します。\fB-Z\fR オプションは複数回指定できます。\fB-Z\fR オプションは、\fB-r\fR オプションと同時に指定した場合のみ使用できます。\fB-Z\fR オプションは \fB-z\fR オプションと一緒に使用できません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-リクエストされた操作の実行中に詳細な進捗状況メッセージを出力し、詳細な計画情報 (ファセット、メディエータ、バリアントの変更など) を表示します。このオプションを複数回指定して、表示される計画情報の量を増やすことができます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-更新またはインストールされるパッケージのライセンス条項に同意することを示します。このオプションを指定しないと、パッケージのライセンスに同意が必要になった場合、インストール操作は失敗します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--licenses\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示します。更新されるパッケージの場合、ライセンスが変更された場合のみライセンスを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-操作が正常に完了したあとに検索インデックスを更新しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-be-activate\fR\fR
-.ad
-.sp .6
-.RS 4n
-ブート環境が作成される場合に、それを次回ブート時にアクティブなブート環境として設定しません。詳細は、\fBbeadm\fR(1M) のマニュアルページを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-backup-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-バックアップブート環境を作成しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--require-backup-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-新しいブート環境が作成されない場合に、常にバックアップブート環境を作成します。このオプションを指定しないと、イメージポリシーに基づいてバックアップブート環境が作成されます。バックアップブート環境がいつ自動的に作成されるかについての説明は、次の「イメージプロパティー」の \fBbe-policy\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--backup-be-name\fR \fIname\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された引数を使って、作成されたバックアップブート環境に名前を付けます。\fB--backup-be-name\fR を使用すると \fB--require-backup-be\fR が暗黙的に指定されます。\fBbeadm\fR(1M) のマニュアルページも参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--deny-new-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-新しいブート環境を作成しません。新しいブート環境が必要な場合、この操作は実行されません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--require-new-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-常に新しいブート環境を作成します。このオプションを指定しないと、イメージポリシーに基づいてブート環境が作成されます。ブート環境がいつ自動的に作成されるかについての説明は、次の「イメージプロパティー」の \fBbe-policy\fR を参照してください。このオプションを \fB--require-backup-be\fR と組み合わせることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--be-name\fR \fIname\fR\fR
-.ad
-.sp .6
-.RS 4n
-新たに作成されたブート環境の名前を、指定された引数になるように変更します。\fB--be-name\fR の使用は、暗黙的に \fB--require-new-be\fR を示します。\fBbeadm\fR(1M) のマニュアルページも参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--reject\fR \fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパターンと一致する名前を持つパッケージはインストールされません。一致するパッケージがすでにインストールされている場合、それらはこの操作の一環として削除されます。グループ依存関係のターゲットである拒否対象パッケージは回避リストに登録されます。このオプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sync-actuators\fR\fR
-.ad
-.sp .6
-.RS 4n
-SMF アクチュエータを同期的に実行します。\fBpkg\fR(1) コマンドは、\fBpkg\fR が呼び出されたゾーン (大域ゾーンまたは非大域ゾーン) ですべての SMF アクチュエータが完了するまで戻りません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sync-actuators-timeout\fR \fItimeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-SMF アクチュエータを同期的に実行します。アクチュエータが指定された \fItimeout\fR (秒単位) までに完了しない場合、\fBpkg\fR(1) は操作を継続し、リターンコード 8 で終了します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg exact-install\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージを、空のシステムにインストールする場合と同じようにインストールまたは更新します。以前にインストールされたパッケージのうち、コマンド行で指定されず、指定されたパッケージの依存関係でもないものは、削除されます。このコマンドは、回避リストに含まれるパッケージのインストールや凍結リストに含まれるパッケージの更新を行わないようにする制約を無視します。それ以外については、この \fBexact-install\fR サブコマンドは \fBinstall\fR サブコマンドと同じように動作します。パッケージの最新バージョンを明示的に要求するには、\fIpkg_fmri_pattern\fR のバージョン部分に \fBlatest\fR を使用します。たとえば、\fBvim@latest\fR のように指定します。
-.sp
-パッケージは、発行元検索順およびスティッキネスに基づいて選択されます。検索順およびスティッキネスについては、\fBpkg publisher\fR および \fBpkg set-publisher\fR コマンドを参照してください。\fIpkg_fmri_pattern\fR でパブリッシャーを指定しない場合は、一致するパッケージを提供する最初のパブリッシャーがインストール元として使用されます。該当する発行元がこのイメージ内にインストール可能なパッケージのバージョンを提供しない場合、インストール操作は失敗します。このイメージにインストール可能なパッケージのバージョンを提供する発行元を確認するには、\fBpkg list -a\fR コマンドを使用します。
-.sp
-複数の \fIpkg_fmri_pattern\fR が指定され、かつ指定されたパッケージのいずれかをこのイメージにインストールできない場合、指定されたパッケージは一切インストールされません。
-.sp
-インストールプロセスの間に、一部の構成ファイルの名前変更または置換が行われる場合があります。どのファイルを保持するかをパッケージシステムが決定する方法と、パッケージ操作中にファイルが保持されるしくみについては、\fBpkg\fR(5) のマニュアルページのファイルアクションに関する項目を参照してください。
-.sp
-パッケージが回避リストにある場合は、インストールすると回避リストから削除されます。
-.sp
-オプションの説明については、前述の \fBinstall\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg uninstall\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--ignore-missing\fR] [\fB--no-index\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-\fIpkg_fmri_pattern\fR に一致するインストール済みパッケージを削除します。
-.sp
-パッケージがグループ依存関係の対象である場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。後述する \fBavoid\fR サブコマンドを参照してください。
-.sp
-コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、それが次回リブート時のデフォルトのブート環境になります。ブート環境の管理については、\fBbeadm\fR(1M) のマニュアルページを参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ignore-missing\fR\fR
-.ad
-.sp .6
-.RS 4n
-インストールされていないパッケージを無視します。このオプションを使用すると、\fBpkg uninstall\fR で現在インストールされていないパッケージをアンインストールしようとしたときに、失敗しなくなります。
-.RE
-
-その他のすべてのオプションについては、前述の \fBinstall\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg update\fR [\fB-fnvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--ignore-missing\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージ内のすべてのインストール済みパッケージを、インストール済みパッケージと発行元構成によりシステムに適用される制約で許可される最新のバージョンに更新します。
-.sp
-コマンド出力で、新しいブート環境が作成されたことを示すメッセージに注意してください。新しいブート環境を作成してアクティブにすると、それが次回、\fB--no-be-activate\fR オプションを指定しない場合のリブート時のデフォルトブート環境になります。ブート環境の管理については、\fBbeadm\fR(1M) のマニュアルページを参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージにインストール済みの、指定されたパッケージのみを更新します。指定された \fIpkg_fmri_pattern\fR パターンの 1 つがアスタリスク (*) である場合は、\fIpkg_fmri_pattern\fR を指定しなかった場合と同じ方法で現在のイメージ内のすべてのインストール済みパッケージを更新します。
-.sp
-パッケージの最新バージョンを明示的に要求するには、\fIpkg_fmri_pattern\fR のバージョン部分に \fBlatest\fR を使用します。たとえば、\fBvim@latest\fR のように指定します。
-.sp
-すでにインストールされているものより古い、または新しいバージョンを指定することで、特定のパッケージのインプレースダウングレードまたはアップグレードを実行できます。パッケージの名前変更または廃止の境界をまたがった特定パッケージの更新はサポートされていません。
-.sp
-保持される構成ファイルのうち、ダウングレードされるパッケージの一部であり、元のバージョンがインストールされたあとに変更されたファイルは、拡張子 \fB\&.update\fR を使用して名前が変更されます。どのファイルを保持するかをパッケージシステムが決定する方法と、パッケージアップグレード中にファイルが保持されるしくみについては、\fBpkg\fR(5) のマニュアルページのファイルアクションに関する項目を参照してください。
-.sp
-複数の \fIpkg_fmri_pattern\fR が指定され、かつ指定されたパッケージのいずれかをこのイメージに更新できない場合、指定されたパッケージは一切更新されません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.sp .6
-.RS 4n
-すべてのインストール済みパッケージを更新するときにクライアントに対する最新状態チェックを実行しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ignore-missing\fR\fR
-.ad
-.sp .6
-.RS 4n
-インストールされていないパッケージを無視します。このオプションを使用すると、\fBpkg update\fR で現在インストールされていないパッケージを更新しようとしたときに、失敗しなくなります。
-.RE
-
-その他のすべてのオプションについては、前述の \fBinstall\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg list\fR [\fB-Hafnqsuv\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--no-refresh\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-バージョンやインストール状態などの情報を含む、現在のイメージ内のインストール済みの全パッケージのリストを表示します。デフォルトでは、異なるアーキテクチャーまたはゾーンタイプのパッケージバリアントは除外されます。通常の出力は 3 列形式です。
-.sp
-.in +2
-.nf
-NAME (PUBLISHER)       VERSION                IFO
+    [-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>(5) リポジトリで構成することもできます。</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>
+</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>(5) のマニュアルページのファイルアクションに関する項目を参照してください。</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>(1M) のマニュアルページを参照してください。</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>(1M) のマニュアルページも参照してください。</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>(1M) のマニュアルページも参照してください。</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>(5) のマニュアルページのファイルアクションに関する項目を参照してください。</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>(1M) のマニュアルページを参照してください。</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>(1M) のマニュアルページを参照してください。</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>(5) のマニュアルページのファイルアクションに関する項目を参照してください。</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--
-.fi
-.in -2
-
-最初の列にはパッケージの名前が表示されます。パッケージのインストール元 (または、インストールされていない場合は提供元) であるパブリッシャーがパブリッシャー検索順で先頭でない場合、パッケージ名のあとに一覧表示されるパブリッシャー名は括弧で囲まれています。2 番目の列にはパッケージのリリースバージョンとブランチバージョンが表示されます。リリースバージョンとブランチバージョンについて、およびバリアントについては、\fBpkg\fR(5) のマニュアルページを参照してください。
-.sp
-.LP
-最後の列には、パッケージのステータスを示す一連のフラグが表示されます。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBI\fR 列の \fBi\fR は、パッケージがインストールされていることを示します。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBF\fR 列の \fBf\fR は、パッケージが凍結されていることを示します。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBO\fR 列の \fBo\fR は、パッケージが廃止されていることを示します。\fBO\fR 列の \fBr\fR は、パッケージの名前が変更されたことを示します (廃止の形態の 1 つです)。
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定したパッケージのみを一覧表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-一覧からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-このイメージにインストールされているパッケージと、インストールされていないが、インストール可能なパッケージの最新バージョンを一覧表示します。パッケージがインストール済みの incorporation およびイメージのバリアントによって許可されている場合は、それらをインストールできます。1 つ以上のパターンを指定した場合、指定されたパターンに一致し、インストール済みの incorporation およびイメージのバリアントによって許可されている最新バージョンが一覧表示されます。\fB-a\fR を指定しない場合、インストール済みパッケージのみを一覧表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-af\fR\fR
-.ad
-.sp .6
-.RS 4n
-incorporation の制約またはインストール状態に関係なく、すべてのバリアントについてすべてのパッケージのすべてのバージョンを一覧表示します。これらのオプションを使用するとき、パッケージの最新バージョンを明示的に一覧表示するには、\fIpkg_fmri_pattern\fR のバージョン部分に \fBlatest\fR を使用します。たとえば、\fBvim@latest\fR のように指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。\fB-n\fR を指定しない場合、\fB-g\fR を使用すると \fB-a\fR が暗黙的に指定されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-インストール状態に関係なく、すべての既知のパッケージの最新バージョンを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージを一覧表示しませんが、致命的エラーが発生した場合は失敗を返します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージ名とサマリーを示す 1 行の短縮形式を表示します。このオプションは \fB-a\fR、\fB-n\fR、または \fB-u\fR とともに使用できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-u\fR\fR
-.ad
-.sp .6
-.RS 4n
-新しいバージョンが入手可能なインストール済みパッケージを一覧表示します。このオプションは \fB-g\fR とともに使用できません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-発行元と完全バージョンを含む、フルパッケージ FMRI をすべて最初の列に表示します (VERSION 列は消えます)。このオプションは \fB-a\fR、\fB-n\fR、または \fB-u\fR とともに使用できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-入手可能パッケージの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg info\fR [\fB-lqr\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--license\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージにインストールされているすべてのパッケージについての情報を、人間が判読できる形式で表示します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定したパッケージの情報のみを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージリポジトリまたはアーカイブを、操作のためのパッケージデータのソースとして使用します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。このオプションは複数回指定できます。\fB-g\fR を使用すると \fB-r\fR が暗黙的に指定されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-インストール済みのパッケージの情報だけを表示します。これはデフォルトです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージ情報を表示しませんが、致命的エラーが発生した場合は失敗を返します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-最新の入手可能バージョンに基づいてパッケージを照合し、イメージの構成済みパブリッシャーのリポジトリから、現在インストールされていないパッケージの情報を取得します (必要な場合)。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。\fB-r\fR を指定しない場合、デフォルトでインストール済みパッケージのみが表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--license\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージのライセンステキストを表示します。このオプションは、\fB-l\fR、\fB-q\fR、または \fB-r\fR と組み合わせることができます。すべての \fIpkg_fmri_pattern\fR パターンが既知の問題のパッケージと一致し、ライセンスを持つ場合、成功を返します。1 つ以上のパターンが一致しないか、ライセンスを持たないパッケージと一致した場合、失敗を返します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg contents\fR [\fB-Hmr\fR] [\fB-a\fR \fIattribute\fR=\fIpattern\fR]... [\fB-g\fR \fIpath_or_uri\fR]... [\fB-o\fR \fI attribute\fR[,\fIattribute\fR]...]... [\fB-s\fR \fI sort_key\fR] [\fB-t\fR \fIaction_name\fR[,\fI action_name\fR]...]... [\fIpkg_fmri_pattern\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-イメージ内のすべてのインストール済みパッケージの内容 (アクション属性) を表示します。オプションが指定されていない場合、現在のイメージにインストールされているアクションの \fBpath\fR 属性の値をアルファベット順で並べ替えて表示します。アクションとそれらの属性については、\fBpkg\fR(5) のマニュアルページのアクションに関する項目を参照してください。下の疑似属性名のリストも参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定したパッケージの内容のみを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-出力からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIattribute\fR=\fI pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-名前がオプション引数で指定され、値がオプション引数の (glob) \fIpattern\fR に一致する \fIattribute\fR を持つアクションに出力を限定します。このオプションは複数回指定できます。複数の \fB-a\fR オプションを指定した場合、それらのいずれかに一致するアクションが表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージリポジトリまたはアーカイブからこのイメージにインストール可能なパッケージの情報を表示します。クライアント SSL 証明書が必要なリポジトリは、このオプションとともに使用できません。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションは複数回指定できます。\fB-g\fR を使用すると \fB-r\fR が暗黙的に指定されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-このイメージにインストールできないアクションを含めて、指定されたパッケージのすべてのアクションのすべての属性を表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された属性を、リストの先頭属性の値に従って並べ替えて表示します。\fB-o\fR オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの \fB-o\fR オプションの引数として複数の属性を指定できます。要求された属性を持つアクションのみが表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-このイメージ内で構成された発行元のリポジトリからこのイメージにインストール可能なパッケージの最新バージョンの情報を表示します。インストール可能なパッケージには、現在インストールされているパッケージと、バリアントやファセットの制限などのこのイメージへのインストールの条件を満たすその他のパッケージが含まれます。このオプションを使用するときは、少なくとも 1 つのパッケージを指定する必要があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIsort_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたアクション属性で、アクションをソートします。このオプションを指定しない場合、デフォルトではパスによって、または \fB-o\fR オプションで最初に指定された属性によってソートします。\fB-s\fR オプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたアクションのみを一覧表示します。\fB-t\fR オプションは複数回指定できます。または、アクション名をコンマで区切ることにより、1 つの \fB-t\fR オプションの引数として複数のアクションを指定できます。\fIaction_name\fR の値は、\fBpkg\fR(5) のマニュアルページの「アクション」内に一覧表示されているアクションのいずれかで、\fBfile\fR、\fBdirectory\fR、\fBdriver\fR、\fBdepend\fR、\fBset\fR などです。
-.RE
-
-利便性のために、いくつかの特殊な疑似属性名を使用できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.hash\fR\fR
-.ad
-.sp .6
-.RS 4n
-アクションがペイロードを伝送する場合、アクションのハッシュの値です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.key\fR\fR
-.ad
-.sp .6
-.RS 4n
-アクションのキー属性の値です。たとえば、\fBfile\fR アクションの場合、鍵属性はファイルのパスです。キー属性のないアクションもあります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.name\fR\fR
-.ad
-.sp .6
-.RS 4n
-アクションの名前です。たとえば、ファイルアクションの場合、これは \fBfile\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.raw\fR\fR
-.ad
-.sp .6
-.RS 4n
-一致するアクションのすべての属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-アクションを包含しているパッケージのフル形式 FMRI (たとえば、\fBpkg://solaris/group/feature/[email protected],5.11-0.175.0.0.0.2.1:20120705T153434Z\fR) です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.name\fR\fR
-.ad
-.sp .6
-.RS 4n
-アクションを包含しているパッケージの名前 (たとえば、\fBweb/amp\fR) です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-アクションを包含しているパッケージの発行元 (たとえば、\fBsolaris\fR) です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.shortfmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-アクションを包含しているパッケージのショート形式 FMRI (\fBpkg://solaris/group/feature/[email protected],5.11-0.175\fR など) です。
-.RE
-
-関連するサブコマンドは \fBcontents\fR および \fBsearch\fR であり、どちらもパッケージの内容についてシステムをクエリーします。\fBcontents\fR サブコマンドは、1 つまたは複数のインストールされているか、インストール可能なパッケージ内のアクションを、指定されたオプションに基づいて出力をフィルタ処理して表示します。\fBsearch\fR サブコマンドは逆方向からクエリーを行い、ユーザーが指定したトークンを含むすべてのパッケージの名前を表示します。
-.sp
-各サブコマンドで実行できるクエリーの一部は、他方でも実行できます。サブコマンドの選択は慎重に行ってください。クエリーによっては、もう一方のほうがより自然に実行できる場合があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg search\fR [\fB-HIaflpr\fR] [\fB-o\fR \fIattribute\fR[,\fIattribute\fR]...]... [\fB-s\fR \fIrepo_uri\fR] \fIquery\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIquery\fR と一致するアクションを検索し、一致した検索インデックス、アクション名、アクション値、およびパッケージ名を表示します。次の \fIquery\fR の説明を参照してください。場合によっては、検索結果が重複して生成されることがあります。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-出力からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-大文字/小文字を区別する検索を使用します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-検索を実行して、一致するアクションに関する情報を表示します。これはデフォルトです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージのバージョンに関係なく、すべての結果を表示します。\fBsearch\fR はデフォルトで、現在インストールされているバージョンよりも古いパッケージ、および現在の incorporation によって除外されているパッケージバージョンからの結果を取り除きます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-イメージのインストール済みパッケージを検索します。
-.sp
-\fB-l\fR と \fB-r\fR (または \fB-s\fR) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-出力に含める列を指定します。\fB-o\fR オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの \fB-o\fR オプションの引数として複数の属性を指定できます。前述した疑似属性に加えて、検索結果用の次の属性が定義されています。これらの属性は、特定の結果が一致する理由をわかりやすく示しています。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsearch.match\fR\fR
-.ad
-.sp .6
-.RS 4n
-検索クエリーに一致した文字列。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsearch.match_type\fR\fR
-.ad
-.sp .6
-.RS 4n
-検索クエリーに一致した文字列を含む属性。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR\fR
-.ad
-.sp .6
-.RS 4n
-一部のアクションが各クエリー条件に一致するパッケージを表示します。このオプションを使用することは、クエリーの各条件を山括弧 (\fB<>\fR) で囲むことと等価です。\fB<>\fR 演算子の詳細は、次の \fIquery\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-イメージのパブリッシャーに対応するリポジトリを検索します。これはデフォルトです。
-.sp
-\fB-l\fR と \fB-r\fR (または \fB-s\fR) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI に位置する \fBpkg\fR(5) リポジトリを検索します。これは複数回指定できます。パッケージアーカイブはサポートされていません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIquery\fR\fR
-.ad
-.sp .6
-.RS 4n
-デフォルトでは、\fIquery\fR は完全一致する一連の条件として解釈され、複数の条件は AND でつながれます。
-.sp
-AND と OR がサポートされています。
-.sp
-\fB?\fR および \fB*\fR 文字を \fBglob\fR(3C) 形式のワイルドカードとして使用でき、より柔軟なクエリー一致が可能になります。
-.sp
-単純なトークン一致およびワイルドカード検索に加えて、より複雑なクエリー言語がサポートされています。単一引用符または二重引用符 (\fB\&'\fR または \fB"\fR) を使用することにより、語句を検索できます。\fBpkg\fR が実際に \fB\&'\fR または \fB"\fR を認識するように、必ずシェルを考慮に入れてください。
-.sp
-どのトークンがインデックス化されるかはアクションに依存しますが、コンテンツハッシュとパス名を含めることができます。アクションとそれらの属性については、\fBpkg\fR(5) のマニュアルページのアクションに関する項目を参照してください。前述の \fBpkg contents\fR および \fB- o\fR 内の擬似属性名のリストも参照してください。
-.sp
-構造化されたクエリーは、次の構文でサポートされます:
-.sp
-.in +2
-.nf
-\fIpkg_name\fR:\fIaction_name\fR:\fIindex\fR:\fItoken\fR
-.fi
-.in -2
-
-\fIaction_name\fR の値は、\fBpkg\fR(5) マニュアルページの「アクション」に一覧表示されているアクションのいずれかです。\fIindex\fR は、アクションの属性です。\fIindex\fR の値は、\fItoken\fR と一致している必要があります。
-.sp
-すべてのアクション属性が検索可能なわけではありません。たとえば、\fBmode\fR は \fBfile\fR アクションの属性ですが、\fBmode\fR は \fIindex\fR の有効な値ではありません。
-.sp
-\fIindex\fR の一部の値は、アクション属性ではなく、ほかの属性から派生した値です。たとえば、パスの最後のコンポーネントを取ることにより、\fIindex\fR を、どのアクションの属性でもないが、\fBfile\fR または \fB dir\fR アクションの \fBpath\fR 属性から派生した \fBbasename\fR にできます。
-.sp
-アクションタイプが異なると、有効な \fIindex\fR 値も異なります。このドキュメントには、使用可能な値がすべて含まれているわけではありません。より有用な \fI index\fR 値には、ファイルシステムアクションの \fBbasename\fR および \fBpath\fR、\fBdepend\fR アクションの依存性タイプ (たとえば、\fBrequire\fR、\fB optional\fR、\fBgroup\fR)、および \fBdriver \fR アクションの \fBdriver_name\fR および \fBalias\fR などがあります。
-.sp
-特殊な \fIindex\fR 値の 1 つに、\fBset\fR アクションの \fBname\fR 属性の値があります。この場合、\fItoken\fR が、指定された \fB name\fR 属性に対応する \fBvalue\fR 属性の値と照合されます。たとえば、次の検索により、Development/Databases または System/Databases のいずれかに分類されるパッケージを検索します。「使用例」セクションで、SMF サービスを検索する例を参照してください。
-.sp
-.in +2
-.nf
-$ \fBpkg search info.classification:databases\fR
-.fi
-.in -2
-.sp
-
-構造化クエリー内の欠落したフィールドは、暗黙的にワイルドカード化されます。\fBbasename:pkg\fR の検索は、\fBbasename\fR の \fIindex\fR を持ち、次の部分出力に示すような \fItoken\fR \fBpkg\fR に一致するすべてのパッケージ内のすべてのアクションに一致します:
-.sp
-.in +2
-.nf
-$ \fBpkg search basename:pkg\fR
+x11/wm/fvwm (fvwm.org) 2.6.5                  i--</programlisting>
+<para>最初の列にはパッケージの名前が表示されます。パッケージのインストール元 (または、インストールされていない場合は提供元) であるパブリッシャーがパブリッシャー検索順で先頭でない場合、パッケージ名のあとに一覧表示されるパブリッシャー名は括弧で囲まれています。2 番目の列にはパッケージのリリースバージョンとブランチバージョンが表示されます。リリースバージョンとブランチバージョンについて、およびバリアントについては、<literal>pkg</literal>(5) のマニュアルページを参照してください。</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>
+<listitem><para>イメージ内のすべてのインストール済みパッケージの内容 (アクション属性) を表示します。オプションが指定されていない場合、現在のイメージにインストールされているアクションの <literal>path</literal> 属性の値をアルファベット順で並べ替えて表示します。アクションとそれらの属性については、<literal>pkg</literal>(5) のマニュアルページのアクションに関する項目を参照してください。下の疑似属性名のリストも参照してください。</para>
+<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>(5) のマニュアルページの「アクション」内に一覧表示されているアクションのいずれかで、<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>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.key</literal></term>
+<listitem><para>アクションのキー属性の値です。たとえば、<literal>file</literal> アクションの場合、鍵属性はファイルのパスです。キー属性のないアクションもあります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.name</literal></term>
+<listitem><para>アクションの名前です。たとえば、ファイルアクションの場合、これは <literal>file</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.raw</literal></term>
+<listitem><para>一致するアクションのすべての属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.fmri</literal></term>
+<listitem><para>アクションを包含しているパッケージのフル形式 FMRI (たとえば、<literal>pkg://solaris/group/feature/[email protected],5.11-0.175.0.0.0.2.1:20120705T153434Z</literal>) です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.name</literal></term>
+<listitem><para>アクションを包含しているパッケージの名前 (たとえば、<literal>web/amp</literal>) です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.publisher</literal></term>
+<listitem><para>アクションを包含しているパッケージの発行元 (たとえば、<literal>solaris</literal>) です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.shortfmri</literal></term>
+<listitem><para>アクションを包含しているパッケージのショート形式 FMRI (<literal>pkg://solaris/group/feature/[email protected],5.11-0.175</literal> など) です。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>関連するサブコマンドは <command>contents</command> および <command>search</command> であり、どちらもパッケージの内容についてシステムをクエリーします。<command>contents</command> サブコマンドは、1 つまたは複数のインストールされているか、インストール可能なパッケージ内のアクションを、指定されたオプションに基づいて出力をフィルタ処理して表示します。<command>search</command> サブコマンドは逆方向からクエリーを行い、ユーザーが指定したトークンを含むすべてのパッケージの名前を表示します。</para>
+<para>各サブコマンドで実行できるクエリーの一部は、他方でも実行できます。サブコマンドの選択は慎重に行ってください。クエリーによっては、もう一方のほうがより自然に実行できる場合があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg search</command> [<option>HIaflpr</option>] [<option>o</option> <replaceable>attribute</replaceable>[,<replaceable>attribute</replaceable>]...]... [<option>s</option> <replaceable>repo_uri</replaceable>] <replaceable>query</replaceable></term>
+<listitem><para><replaceable>query</replaceable> と一致するアクションを検索し、一致した検索インデックス、アクション名、アクション値、およびパッケージ名を表示します。次の <replaceable>query</replaceable> の説明を参照してください。場合によっては、検索結果が重複して生成されることがあります。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>H</option> </term>
+<listitem><para>出力からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>I</option></term>
+<listitem><para>大文字/小文字を区別する検索を使用します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>検索を実行して、一致するアクションに関する情報を表示します。これはデフォルトです。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>f</option></term>
+<listitem><para>パッケージのバージョンに関係なく、すべての結果を表示します。<command>search</command> はデフォルトで、現在インストールされているバージョンよりも古いパッケージ、および現在の incorporation によって除外されているパッケージバージョンからの結果を取り除きます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option></term>
+<listitem><para>イメージのインストール済みパッケージを検索します。</para>
+<para><option>l</option> と <option>r</option> (または <option>s</option>) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>attribute</replaceable></term>
+<listitem><para>出力に含める列を指定します。<option>o</option> オプションは複数回指定できます。または、属性名をコンマで区切ることにより、1 つの <option>o</option> オプションの引数として複数の属性を指定できます。前述した疑似属性に加えて、検索結果用の次の属性が定義されています。これらの属性は、特定の結果が一致する理由をわかりやすく示しています。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>search.match</literal></term>
+<listitem><para>検索クエリーに一致した文字列。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>search.match_type</literal></term>
+<listitem><para>検索クエリーに一致した文字列を含む属性。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option></term>
+<listitem><para>一部のアクションが各クエリー条件に一致するパッケージを表示します。このオプションを使用することは、クエリーの各条件を山括弧 (<literal>&lt;&gt;</literal>) で囲むことと等価です。<literal>&lt;></literal> 演算子の詳細は、次の <replaceable>query</replaceable> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>イメージのパブリッシャーに対応するリポジトリを検索します。これはデフォルトです。</para>
+<para><option>l</option> と <option>r</option> (または <option>s</option>) の両方を同時に指定できます。この場合、ローカル検索とリモート検索の両方が実行されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri</replaceable></term>
+<listitem><para>指定された URI に位置する <literal>pkg</literal>(5) リポジトリを検索します。これは複数回指定できます。パッケージアーカイブはサポートされていません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>query</replaceable></term>
+<listitem><para>デフォルトでは、<replaceable>query</replaceable> は完全一致する一連の条件として解釈され、複数の条件は AND でつながれます。</para>
+<para>AND と OR がサポートされています。</para>
+<para><literal>?</literal> および <literal>*</literal> 文字を <literal>glob</literal>(3C) 形式のワイルドカードとして使用でき、より柔軟なクエリー一致が可能になります。</para>
+<para>単純なトークン一致およびワイルドカード検索に加えて、より複雑なクエリー言語がサポートされています。単一引用符または二重引用符 (<literal>'</literal> または <literal>"</literal>) を使用することにより、語句を検索できます。<command>pkg</command> が実際に <literal>'</literal> または <literal>"</literal> を認識するように、必ずシェルを考慮に入れてください。</para>
+<para>どのトークンがインデックス化されるかはアクションに依存しますが、コンテンツハッシュとパス名を含めることができます。アクションとそれらの属性については、<literal>pkg</literal>(5) のマニュアルページのアクションに関する項目を参照してください。前述の <command>pkg contents</command> および <option> o</option> 内の擬似属性名のリストも参照してください。</para>
+<para>構造化されたクエリーは、次の構文でサポートされます:</para>
+<programlisting><replaceable>pkg_name</replaceable>:<replaceable>action_name</replaceable>:<replaceable>
+index</replaceable>:<replaceable>token</replaceable></programlisting>
+<para><replaceable>action_name</replaceable> の値は、<literal>pkg</literal>(5) マニュアルページの「アクション」に一覧表示されているアクションのいずれかです。<replaceable>index</replaceable> は、アクションの属性です。<replaceable>index</replaceable> の値は、<replaceable>token</replaceable> と一致している必要があります。</para>
+<para>すべてのアクション属性が検索可能なわけではありません。たとえば、<literal>mode</literal> は <literal>file</literal> アクションの属性ですが、<literal>mode</literal> は <replaceable>index</replaceable> の有効な値ではありません。</para>
+<para><replaceable>index</replaceable> の一部の値は、アクション属性ではなく、ほかの属性から派生した値です。たとえば、パスの最後のコンポーネントを取ることにより、<replaceable>index</replaceable> を、どのアクションの属性でもないが、<literal>file</literal> または <literal> dir</literal> アクションの <literal>path</literal> 属性から派生した <literal>basename</literal> にできます。</para>
+<para>アクションタイプが異なると、有効な <replaceable>index</replaceable> 値も異なります。このドキュメントには、使用可能な値がすべて含まれているわけではありません。より有用な <replaceable> index</replaceable> 値には、ファイルシステムアクションの <literal>basename</literal> および <literal>path</literal>、<literal>depend</literal> アクションの依存性タイプ (たとえば、<literal>require</literal>、<literal> optional</literal>、<literal>group</literal>)、および <literal>driver </literal> アクションの <literal>driver_name</literal> および <literal>alias</literal> などがあります。</para>
+<para>特殊な <replaceable>index</replaceable> 値の 1 つに、<literal>set</literal> アクションの <literal>name</literal> 属性の値があります。この場合、<replaceable>token</replaceable> が、指定された <literal> name</literal> 属性に対応する <literal>value</literal> 属性の値と照合されます。たとえば、次の検索により、Development/Databases または System/Databases のいずれかに分類されるパッケージを検索します。「使用例」セクションで、SMF サービスを検索する例を参照してください。</para>
+<screen>$ <userinput>pkg search info.classification:databases</userinput></screen>
+<para>構造化クエリー内の欠落したフィールドは、暗黙的にワイルドカード化されます。<literal>basename:pkg</literal> の検索は、<literal>basename</literal> の <replaceable>index</replaceable> を持ち、次の部分出力に示すような <replaceable>token</replaceable> <literal>pkg</literal> に一致するすべてのパッケージ内のすべてのアクションに一致します:</para>
+<screen>$ <userinput>pkg search basename:pkg</userinput>
 INDEX    ACTION VALUE         PACKAGE
 basename dir    usr/share/pkg pkg:/package/[email protected]
 basename dir    var/sadm/pkg  pkg:/package/[email protected]
 basename dir    var/spool/pkg pkg:/package/[email protected]
-basename file   usr/bin/pkg   pkg:/package/[email protected]
-.fi
-.in -2
-.sp
-
-次の完全な出力に示すように、別のフィールドを追加すると検索が絞り込まれます:
-.sp
-.in +2
-.nf
-$ \fBpkg search file:basename:pkg\fR
+basename file   usr/bin/pkg   pkg:/package/[email protected]</screen>
+<para>次の完全な出力に示すように、別のフィールドを追加すると検索が絞り込まれます:</para>
+<screen>$ <userinput>pkg search file:basename:pkg</userinput>
 INDEX    ACTION VALUE       PACKAGE
-basename file   usr/bin/pkg pkg:/package/[email protected]
-.fi
-.in -2
-.sp
-
-\fIpkg_name\fR および \fItoken\fR フィールドでは明示的ワイルドカードがサポートされます。\fIaction_name\fR および \fI index\fR は、正確に一致する必要があります。
-.sp
-ファイルと依存関係の検索例については、「使用例」セクションを参照してください。
-.sp
-アクションをこれらのアクションを含むパッケージに変換するには、次の部分出力に示すように、\fB <>\fR を使用します:
-.sp
-.in +2
-.nf
-$ \fBpkg search \e<pkg\e>\fR
+basename file   usr/bin/pkg pkg:/package/[email protected]</screen>
+<para><replaceable>pkg_name</replaceable> および <replaceable>token</replaceable> フィールドでは明示的ワイルドカードがサポートされます。<replaceable>action_name</replaceable> および <replaceable> index</replaceable> は、正確に一致する必要があります。</para>
+<para>ファイルと依存関係の検索例については、「使用例」セクションを参照してください。</para>
+<para>アクションをこれらのアクションを含むパッケージに変換するには、次の部分出力に示すように、<literal> &lt;></literal> を使用します:</para>
+<screen>$ <userinput>pkg search &bsol;&lt;pkg&bsol;></userinput>
 PACKAGE                                  PUBLISHER
 pkg:/package/[email protected]  solaris
-pkg:/package/[email protected] solaris
-.fi
-.in -2
-.sp
-
-\fB-a\fR オプションを使用する場合 (デフォルト)、\fBtoken\fR を検索した結果は \fBtoken\fR に一致するアクションについての情報である一方で、\fB<token>\fR を検索した結果は、\fBtoken\fR に一致するアクションを包含しているパッケージの一覧です。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg verify\fR [\fB-Hqv\fR] [\fI pkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージ内で、インストールされているすべてのパッケージのインストールを検証します。関連する発行元の現在の署名ポリシーが \fBignore\fR でない場合、各パッケージの署名がポリシーに基づいて検証されます。署名ポリシーが適用されるしくみについては、後述する「イメージプロパティー」の \fBsignature-policy\fR で説明します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージ内で、指定されたインストール済みパッケージのインストールのみを検証します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-検証の出力からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-リクエストされた操作の実行中、進捗状況メッセージおよびその他すべての出力を抑止します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージに関する情報メッセージを含めます。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg fix\fR [\fB--accept\fR] [\fB--licenses\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkg verify\fR で報告されたエラーをすべて修正します。インストール済みパッケージの内容は、独自の内容解析に基づいて検証されるため、ほかのプログラムの場合とは異なる結果が返されることがあります。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージ内で、指定されたインストール済みパッケージに対する \fBpkg verify\fR により報告されたエラーを修正します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-更新またはインストールされるパッケージのライセンス条項に同意することを示します。このオプションを指定しないと、パッケージのライセンスに同意が必要になった場合、操作は失敗します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--licenses\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作の一環としてインストールまたは更新されるパッケージのすべてのライセンスを表示します。更新されるパッケージの場合、ライセンスが変更された場合のみライセンスを表示します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg revert\fR [\fB-nv\fR] [\fB- -no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be \fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name \fR \fIname\fR] (\fB--tagged\fR \fI tag-name\fR ... | \fIpath-to-file\fR ...)\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkg\fR(5) パッケージにより配布されたパッケージを、配布時の状態に戻します。ファイルの所有権および保護も復元されます。
-.LP
-注意 - 
-.sp
-.RS 2
-一部の編集可能ファイルをデフォルト値に戻すと、システムがブート不可になったり、その他の異常動作の原因になったりする可能性があります。
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--tagged\fR \fItag-name\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fItag-name\fR でタグ付けされたすべてのファイルを元に戻し、このタグが付けられているディレクトリの下に \fIpattern\fR と一致するパッケージ解除されたファイルまたはディレクトリがある場合は削除します。\fBtag-name\fR および \fIpattern\fR の詳細については、\fBpkg\fR(5) のマニュアルページの「ファイルアクション」および「ディレクトリアクション」で \fBrevert-tag\fR 属性の説明を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpath-to-file\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたファイルを元に戻します。
-.RE
-
-その他のすべてのオプションについては、前述の \fBinstall\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg mediator\fR [\fB-aH\fR] [\fB-F\fR \fIformat\fR] [\fImediator\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-現在選択されているバージョンやすべてのメディエータの実装を表示します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fImediator\fR\fR
-.ad
-.sp .6
-.RS 4n
-現在選択されているバージョンや指定されたメディエータの実装のみを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-代替出力形式を指定します。\fIformat\fR の値は、\fBtsv\fR (Tab Separated Values)、\fBjson\fR (単一行としての JavaScript Object Notation)、または json-formatted (読みやすい形式にされた JavaScript Object Notation) にできます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-一覧からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-現在インストールされているパッケージに設定可能なメディエーションを一覧表示します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-mediator\fR [\fB-nv\fR] [\fB-I\fR \fIimplementation\fR] [\fB-V\fR \fIversion\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] \fImediator\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージ内の指定されたメディエータのバージョンと実装を設定します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR \fIimplementation\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用するメディエート対象インタフェースの実装を設定します。デフォルトでは、バージョンが指定されない場合、すべての実装バージョンが許可されます。バージョンなしで実装を指定するには、アット記号 (@) を付加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-V\fR \fIversion\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用するメディエート対象インタフェースのバージョンを設定します。
-.RE
-
-指定されたメディエータのバージョンと実装のどちらかまたは両方が現在入手できない場合、指定されたメディエータを使用するリンクはすべて削除されます。
-.sp
-その他のすべてのオプションについては、前述の \fBinstall\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-mediator\fR [\fB-nvIV\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be \fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name \fR \fIname\fR] \fImediator\fR ... \fR
-.ad
-.sp .6
-.RS 4n
-指定されたメディエータのバージョンと実装をシステムデフォルトに戻します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-メディエート対象インタフェースの実装のみを元に戻します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-V\fR \fR
-.ad
-.sp .6
-.RS 4n
-メディエート対象インタフェースのバージョンのみを元に戻します。
-.RE
-
-その他のすべてのオプションについては、前述の \fBinstall\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg variant\fR [\fB-Haiv\fR] [\fB-F\fR \fIformat\fR] [\fIvariant_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-このイメージに設定されているすべてのバリアントの現在値を表示します。バリアントの詳細については、\fBpkg\fR(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIvariant_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-このイメージで設定されている、指定されたバリアントのみの現在値を表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-代替出力形式を指定します。詳細は、\fBpkg mediator\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-一覧からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-イメージに明示的に設定されたすべてのバリアントとインストール済みパッケージに指定されたすべてのバリアントを表示します。\fB-a\fR オプションを \fB-i\fR オプションと組み合わせることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-インストール済みパッケージに指定されたすべてのバリアントを表示します。\fB-i\fR オプションを \fB-a\fR オプションと組み合わせることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-インストール済みパッケージに設定できるバリアント値を表示します。\fB-v\fR オプションは、\fB-a\fR または \fB-i\fR オプションと組み合わせることができます。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg change-variant\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIvariant_name\fR=\fIvalue\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージに設定され、指定されているバリアントの値を変更します。
-.sp
-バリアントの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。バリアントの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。バリアントの詳細については、\fBpkg\fR(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
-.sp
-オプションの説明については、前述の \fBinstall\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg facet\fR [\fB-Haim\fR] [\fB-F\fR \fIformat\fR] [\fIfacet_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkg change-facet\fR コマンドを使用してこのイメージにローカルで設定されたか、(大域ゾーンからファセット設定を継承する非大域ゾーンなどで) 親イメージから継承されたすべてのファセットの現在の値とソースを表示します。ファセットの詳細については、\fBpkg\fR(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIfacet_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-このイメージに設定されている、指定されたファセットのみの現在値を表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-代替出力形式を指定します。詳細は、\fBpkg mediator\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-一覧からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-イメージに明示的に設定されたすべてのファセットとインストール済みパッケージに指定されたすべてのファセットを表示します。\fB-a\fR オプションを \fB-i\fR オプションと組み合わせることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-インストール済みパッケージに指定されたすべてのファセットを表示します。\fB-i\fR オプションを \fB-a\fR オプションと組み合わせることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-マスクされたファセットを出力に含めます。ファセットが (あれば) マスクされているかどうかを示す列を表示します。マスクされたファセットは、(\fBpkg change-facet\fR コマンドを使用して) イメージにローカルで設定されたファセットのうち、同じ名前を持つ継承されたファセットによって隠されるものです。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg change-facet\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIfacet_name\fR=(\fBTrue\fR|\fBFalse\fR|\fBNone\fR) ...\fR
-.ad
-.sp .6
-.RS 4n
-現在のイメージに設定され、指定されたファセットの値を変更します。これらの変更は、これらのファセットを継承するイメージ (非大域ゾーンなど) にも現れます。
-.sp
-ファセットは \fBTrue\fR または \fBFalse\fR に設定できます。ファセットを \fBNone\fR に設定すると、デフォルト値の \fBTrue\fR がそのファセットに適用されるため、ファセットに依存するすべてのアクションがインストールされます。アクションについては、\fBpkg\fR(5) のマニュアルページのアクションに関する項目を参照してください。
-.sp
-ファセットの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。ファセットの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。ファセットの詳細については、\fBpkg\fR(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
-.sp
-オプションの説明については、前述の \fBinstall\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg avoid\fR [\fIpkg_fmri_pattern\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-回避対象の各パッケージを、そのパッケージにグループ依存関係を持つパッケージとともに表示します。
-.sp
-回避リストに登録されているパッケージは、要求された依存関係を満たすために必要であればインストールされます。その依存関係が削除された場合、パッケージはアンインストールされます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパターンに現在一致するパッケージ名を回避リストに登録することにより、それらがグループ依存関係のターゲットである場合にそれらを回避します。現在インストールされていないパッケージのみを回避できます。パッケージが現在グループ依存関係のターゲットである場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unavoid\fR [\fIpkg_fmri_pattern \fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-回避対象のパッケージのリストを表示します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージを回避リストから削除します。回避リストに登録されており、インストール済みパッケージのグループ依存関係に一致するパッケージは、このサブコマンドを使用して削除できません。グループ依存性に一致するパッケージを回避リストから削除するには、パッケージをインストールします。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg freeze\fR [\fB-n\fR] [\fB-c \fR \fIreason\fR] [\fIpkg_fmri_pattern\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-現在凍結されているパッケージについての情報 (パッケージ名、バージョン、パッケージがいつ凍結されたか、パッケージの凍結に関連付けられた理由があればその理由) が表示されます。
-.sp
-パッケージを凍結しても、そのパッケージを削除できなくなるわけではありません。パッケージが削除される場合に警告は表示されません。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージを指定されたバージョンに凍結します。バージョンを指定しない場合、パッケージがインストールされている必要があり、そのインストール済みバージョンで凍結されます。すでに凍結されているパッケージを凍結すると、新しく指定されたバージョンによって凍結バージョンが置き換えられます。
-.sp
-凍結されているパッケージをインストールまたは更新するときは、凍結された時点のバージョンと一致するバージョンである必要があります。たとえば、パッケージが 1.2 で凍結された場合、1.2.1、1.2.9、1.2.0.0.1 などのバージョンに更新することはできます。そのパッケージは 1.3 または 1.1 で終了することはできません。\fIpkg_fmri_pattern\fR で提供されるパブリッシャーは、一致するパッケージを検索するために使用されます。ただし、パブリッシャー情報は凍結の一環として記録されません。パッケージは発行元ではなくバージョンのみに関して凍結されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIreason\fR\fR
-.ad
-.sp .6
-.RS 4n
-凍結されるパッケージとともに理由を記録します。\fI\fR凍結が原因でインストールまたは更新に失敗する場合、その理由が示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-凍結操作を試しに実行し、凍結されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結しません。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unfreeze\fR [\fB-n\fR] [\fI pkg_name_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-現在凍結されているパッケージについての情報 (パッケージ名、バージョン、パッケージがいつ凍結されたか、パッケージの凍結に関連付けられた理由があればその理由) が表示されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-凍結によって適用される制約を、指定されたパッケージから削除します。バージョンを提供しても無視されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-凍結解除操作を試しに実行し、凍結解除されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結解除しません。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg property\fR [\fB-H\fR] [\fI propname\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-すべてのイメージプロパティーの名前と値を表示します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpropname\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたプロパティーのみの名前と値を表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-一覧からヘッダーを省略します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-property\fR \fIpropname\fR \fI propvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存のイメージプロパティーを更新するか、または新しいイメージプロパティーを追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg add-property-value\fR \fIpropname \fR \fIpropvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存のイメージプロパティーに値を追加するか、または新しいイメージプロパティーを追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg remove-property-value\fR \fIpropname \fR \fIpropvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存のイメージプロパティーから値を削除します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-property\fR \fIpropname\fR ... \fR
-.ad
-.sp .6
-.RS 4n
-既存のイメージプロパティーを削除します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg publisher\fR [\fB-HPn\fR] [\fB-F\fR \fIformat\fR] [\fIpublisher\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-すべてのパブリッシャーの一覧を、検索の優先順に従って表示します。パブリッシャーごとに次の情報が表示されます。名前、非固定的や無効などの属性、種類 (起点またはミラー)、オンラインステータス、プロキシ、場所の URI。プロキシ情報は、P というラベルが付いた列に T (true) または F (false) と表示されるだけです。P 列が T のパブリッシャーのプロキシ値を表示するには、\fB-F tsv\fR オプションを使用するか、パブリッシャー名の引数を使用します。\fBpkg publisher\fR コマンドによって表示されるプロキシは、\fBpkg set-publisher\fR コマンドの \fB--proxy\fR オプションを使用して設定されました。\fBhttp_proxy\fR 環境変数を使用して設定されるプロキシは、\fBpkg publisher\fR コマンドによって表示されません。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元のみの詳細な構成を表示します。表示される追加情報には、プロキシ URI、各起点またはミラー URI 用の鍵および証明書、クライアント UUID、カタログが最後に更新された時間などがあります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-代替出力形式を指定します。詳細は、\fBpkg mediator\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-一覧からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR\fR
-.ad
-.sp .6
-.RS 4n
-発行元検索順の先頭の発行元のみを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-有効な発行元のみを表示します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-publisher\fR [-Ped] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fIssl_key\fR] [\fB-g\fR \fIorigin_to_add\fR | \fB--add-origin\fR \fIorigin_to_add\fR]... [\fB-G\fR \fIorigin_to_remove\fR | \fB--remove-origin\fR \fIorigin_to_remove\fR]... [\fB-m\fR \fImirror_to_add\fR | \fB--add-mirror\fR \fImirror_to_add\fR]... [\fB-M\fR \fImirror_to_remove\fR | \fB--remove-mirror\fR \fImirror_to_remove\fR]... [\fB--disable\fR] [\fB--enable\fR] [\fB--no-refresh\fR] [\fB--reset-uuid\fR] [\fB--non-sticky\fR] [\fB--sticky\fR] [\fB--search-after\fR \fIpublisher\fR] [\fB--search-before\fR \fIpublisher\fR] [\fB--search-first\fR] [\fB--approve-ca-cert\fR \fIpath_to_CA\fR] [\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--add-property-value\fR \fIname_of_property\fR=\fIvalue_to_add\fR] [\fB--remove-property-value\fR \fIname_of_property\fR=\fIvalue_to_remove\fR] [\fB--unset-property\fR \fIname_of_property_to_delete\fR] [\fB--proxy\fR \fIproxy_to_use\fR] \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存の発行元を更新するか、発行元を追加します。検索順に影響するオプションを指定しない場合、新しいパブリッシャーは検索順の末尾に付加され、最後に検索されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-G\fR \fIorigin_to_remove\fR\fR
-.ad
-.br
-.na
-\fB\fB--remove-origin\fR \fIorigin_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元の起点のリストから URI またはパスを削除します。特殊値 \fB*\fR を使用して、すべての起点を削除することができます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-M\fR \fImirror_to_remove\fR\fR
-.ad
-.br
-.na
-\fB\fB--remove-mirror\fR \fImirror_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元のミラーのリストから URI を削除します。特殊値 \fB*\fR を使用して、すべてのミラーを削除することができます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR\fR
-.ad
-.br
-.na
-\fB\fB--search-first\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元を、検索順の先頭に設定します。新しいパッケージをインストールするとき、このパブリッシャーが最初に検索されます。インストール済みパッケージの更新は、そのパブリッシャーが sticky であるかぎり、そのパッケージを最初に提供した同じパブリッシャーから取得されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-クライアント SSL 証明書を指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.br
-.na
-\fB\fB--disable\fR\fR
-.ad
-.sp .6
-.RS 4n
-発行元を無効にします。無効にされたパブリッシャーは、パッケージリストの生成時に、または特定のパッケージ操作 (インストール、アンインストール、および更新) で使用されません。ただし、無効なパブリッシャーのプロパティーを設定または表示することはできます。発行元が 1 つだけの場合は、無効にすることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-e\fR\fR
-.ad
-.br
-.na
-\fB\fB--enable\fR\fR
-.ad
-.sp .6
-.RS 4n
-発行元を有効にします。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIorigin_to_add\fR\fR
-.ad
-.br
-.na
-\fB\fB--add-origin\fR \fIorigin_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI またはパスを、特定の発行元の起点として追加します。これはパッケージのリポジトリまたはアーカイブの場所にしてください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIssl_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-クライアント SSL 鍵を指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR \fImirror_to_add\fR\fR
-.ad
-.br
-.na
-\fB\fB--add-mirror\fR \fImirror_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-URI を指定された発行元のミラーとして追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--add-property-value\fR \fIname_of_property \fR=\fIvalue_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存の発行元プロパティーに値を追加するか、または新しい発行元プロパティーを追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--approve-ca-cert\fR \fIpath_to_CA\fR\fR
-.ad
-.sp .6
-.RS 4n
-署名付きパッケージを検証するために、信頼できる CA 証明書として指定された証明書を追加します。ユーザーが承認した CA 証明書の PEM 表現のハッシュは、\fBpkg publisher\fR コマンドの詳細出力に一覧表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--non-sticky\fR\fR
-.ad
-.sp .6
-.RS 4n
-この発行元よりも上位にランクされる発行元が、この発行元から最初にインストールされたパッケージに更新を提供できます。
-.RE
+pkg:/package/[email protected] solaris</screen>
+<para><option>a</option> オプションを使用する場合 (デフォルト)、<literal>token</literal> を検索した結果は <literal>token</literal> に一致するアクションについての情報である一方で、<literal>&lt;token></literal> を検索した結果は、<literal>token</literal> に一致するアクションを包含しているパッケージの一覧です。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg verify</command> [<option>Hqv</option>] [<replaceable> pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para>現在のイメージ内で、インストールされているすべてのパッケージのインストールを検証します。関連する発行元の現在の署名ポリシーが <literal>ignore</literal> でない場合、各パッケージの署名がポリシーに基づいて検証されます。署名ポリシーが適用されるしくみについては、後述する「イメージプロパティー」の <literal>signature-policy</literal> で説明します。</para>
+<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>v</option></term>
+<listitem><para>パッケージに関する情報メッセージを含めます。前述の install コマンドの <option>v</option> オプションの説明も参照してください。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>その他のすべてのオプションについては、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg fix</command> [<option>Hnvq</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>-accept</option>] [<option>-licenses</option>] [<replaceable>pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para><command>pkg verify</command> で報告されたエラーをすべて修正します。インストール済みパッケージの内容は、独自の内容解析に基づいて検証されるため、ほかのプログラムの場合とは異なる結果が返されることがあります。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>現在のイメージ内で、指定されたインストール済みパッケージに対する <command>pkg verify</command> により報告されたエラーを修正します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option> </term>
+<listitem><para>検証の出力からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>パッケージに関する情報メッセージを含めます。前述の install コマンドの <option>v</option> オプションの説明も参照してください。</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>
+</variablelist>
+<para>その他のすべてのオプションについては、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg revert</command> [<option>nv</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>-tagged</option> <replaceable> tag-name</replaceable> ... | <replaceable>path-to-file</replaceable> ...)</term>
+<listitem><para><literal>pkg</literal>(5) パッケージにより配布されたパッケージを、配布時の状態に戻します。ファイルの所有権および保護も復元されます。</para>
+<caution><para>一部の編集可能ファイルをデフォルト値に戻すと、システムがブート不可になったり、その他の異常動作の原因になったりする可能性があります。</para></caution>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-tagged</option> <replaceable>tag-name</replaceable></term>
+<listitem><para><replaceable>tag-name</replaceable> でタグ付けされたすべてのファイルを元に戻し、このタグが付けられているディレクトリの下に <replaceable>pattern</replaceable> と一致するパッケージ解除されたファイルまたはディレクトリがある場合は削除します。<literal>tag-name</literal> および <replaceable>pattern</replaceable> の詳細については、<literal>pkg</literal>(5) のマニュアルページの「ファイルアクション」および「ディレクトリアクション」で <literal>revert-tag</literal> 属性の説明を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>path-to-file</replaceable></term>
+<listitem><para>指定されたファイルを元に戻します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>その他のすべてのオプションについては、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg mediator</command> [<option>aH</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>mediator</replaceable> ...] </term>
+<listitem><para>現在選択されているバージョンやすべてのメディエータの実装を表示します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>mediator</replaceable></term>
+<listitem><para>現在選択されているバージョンや指定されたメディエータの実装のみを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>代替出力形式を指定します。<replaceable>format</replaceable> の値は、<literal>tsv</literal> (Tab Separated Values)、<literal>json</literal> (単一行としての JavaScript Object Notation)、または json-formatted (読みやすい形式にされた JavaScript Object Notation) にできます。</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option> </term>
+<listitem><para>一覧からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>現在インストールされているパッケージに設定可能なメディエーションを一覧表示します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-mediator</command> [<option>nv</option>] [<option>I</option> <replaceable>implementation</replaceable>] [<option>V</option> <replaceable>version</replaceable>] [<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>] <replaceable>mediator</replaceable> ...</term>
+<listitem><para>現在のイメージ内の指定されたメディエータのバージョンと実装を設定します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option> <replaceable>implementation</replaceable></term>
+<listitem><para>使用するメディエート対象インタフェースの実装を設定します。デフォルトでは、バージョンが指定されない場合、すべての実装バージョンが許可されます。バージョンなしで実装を指定するには、アット記号 (@) を付加します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>V</option> <replaceable>version</replaceable></term>
+<listitem><para>使用するメディエート対象インタフェースのバージョンを設定します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>指定されたメディエータのバージョンと実装のどちらかまたは両方が現在入手できない場合、指定されたメディエータを使用するリンクはすべて削除されます。</para>
+<para>その他のすべてのオプションについては、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-mediator</command> [<option>nvIV</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>] <replaceable>mediator</replaceable> ... </term>
+<listitem><para>指定されたメディエータのバージョンと実装をシステムデフォルトに戻します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option></term>
+<listitem><para>メディエート対象インタフェースの実装のみを元に戻します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>V</option> </term>
+<listitem><para>メディエート対象インタフェースのバージョンのみを元に戻します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>その他のすべてのオプションについては、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg variant</command> [<option>Haiv</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>variant_pattern</replaceable> ...]</term>
+<listitem><para>このイメージに設定されているすべてのバリアントの現在値を表示します。バリアントの詳細については、<literal>pkg</literal>(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>variant_pattern</replaceable></term>
+<listitem><para>このイメージで設定されている、指定されたバリアントのみの現在値を表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>代替出力形式を指定します。詳細は、<command>pkg mediator</command> コマンドを参照してください。</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option> </term>
+<listitem><para>一覧からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>a</option></term>
+<listitem>
+<para>イメージに明示的に設定されたすべてのバリアントとインストール済みパッケージに指定されたすべてのバリアントを表示します。<option>a</option> オプションを <option>i</option> オプションと組み合わせることはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>i</option></term>
+<listitem>
+<para>インストール済みパッケージに指定されたすべてのバリアントを表示します。<option>i</option> オプションを <option>a</option> オプションと組み合わせることはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>v</option></term>
+<listitem>
+<para>インストール済みパッケージに設定できるバリアント値を表示します。<option>v</option> オプションは、<option>a</option> または <option>i</option> オプションと組み合わせることができます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg change-variant</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-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>variant_name</replaceable>=<replaceable>value</replaceable> ...</term>
+<listitem><para>現在のイメージに設定され、指定されているバリアントの値を変更します。</para>
+<para>バリアントの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。バリアントの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。バリアントの詳細については、<literal>pkg</literal>(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。</para>
+<para>オプションの説明については、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg facet</command> [<option>Haim</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>facet_pattern</replaceable> ...]</term>
+<listitem><para><command>pkg change-facet</command> コマンドを使用してこのイメージにローカルで設定されたか、(大域ゾーンからファセット設定を継承する非大域ゾーンなどで) 親イメージから継承されたすべてのファセットの現在の値とソースを表示します。ファセットの詳細については、<literal>pkg</literal>(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>facet_pattern</replaceable></term>
+<listitem><para>このイメージに設定されている、指定されたファセットのみの現在値を表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>代替出力形式を指定します。詳細は、<command>pkg mediator</command> コマンドを参照してください。</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><option>H</option> </term>
+<listitem>
+<para>一覧からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>a</option></term>
+<listitem>
+<para>イメージに明示的に設定されたすべてのファセットとインストール済みパッケージに指定されたすべてのファセットを表示します。<option>a</option> オプションを <option>i</option> オプションと組み合わせることはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>i</option></term>
+<listitem>
+<para>インストール済みパッケージに指定されたすべてのファセットを表示します。<option>i</option> オプションを <option>a</option> オプションと組み合わせることはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>m</option></term>
+<listitem>
+<para>マスクされたファセットを出力に含めます。ファセットが (あれば) マスクされているかどうかを示す列を表示します。マスクされたファセットは、(<command>pkg change-facet</command> コマンドを使用して) イメージにローカルで設定されたファセットのうち、同じ名前を持つ継承されたファセットによって隠されるものです。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg change-facet</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-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>facet_name</replaceable>=(<literal>True</literal>|<literal>False</literal>|<literal>None</literal>) ...</term>
+<listitem><para>現在のイメージに設定され、指定されたファセットの値を変更します。これらの変更は、これらのファセットを継承するイメージ (非大域ゾーンなど) にも現れます。</para>
+<para>ファセットは <literal>True</literal> または <literal>False</literal> に設定できます。ファセットを <literal>None</literal> に設定すると、デフォルト値の <literal>True</literal> がそのファセットに適用されるため、ファセットに依存するすべてのアクションがインストールされます。アクションについては、<literal>pkg</literal>(5) のマニュアルページのアクションに関する項目を参照してください。</para>
+<para>ファセットの値を変更すると、パッケージの内容が削除、更新、またはインストールされることがあります。ファセットの値を変更すると、新しいイメージ構成を満たすために、パッケージ全体がインストール、更新、または削除されることもあります。ファセットの詳細については、<literal>pkg</literal>(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。</para>
+<para>オプションの説明については、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg avoid</command> [<replaceable>pkg_fmri_pattern</replaceable> ...] </term>
+<listitem><para>回避対象の各パッケージを、そのパッケージにグループ依存関係を持つパッケージとともに表示します。</para>
+<para>回避リストに登録されているパッケージは、要求された依存関係を満たすために必要であればインストールされます。その依存関係が削除された場合、パッケージはアンインストールされます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>指定されたパターンに現在一致するパッケージ名を回避リストに登録することにより、それらがグループ依存関係のターゲットである場合にそれらを回避します。現在インストールされていないパッケージのみを回避できます。パッケージが現在グループ依存関係のターゲットである場合、パッケージをアンインストールするとそのパッケージは回避リストに登録されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unavoid</command> [<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>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg freeze</command> [<option>n</option>] [<option>c </option> <replaceable>reason</replaceable>] [<replaceable>pkg_fmri_pattern</replaceable> ...] </term>
+<listitem><para>現在凍結されているパッケージについての情報 (パッケージ名、バージョン、パッケージがいつ凍結されたか、パッケージの凍結に関連付けられた理由があればその理由) が表示されます。</para>
+<para>パッケージを凍結しても、そのパッケージを削除できなくなるわけではありません。パッケージが削除される場合に警告は表示されません。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>指定されたパッケージを指定されたバージョンに凍結します。バージョンを指定しない場合、パッケージがインストールされている必要があり、そのインストール済みバージョンで凍結されます。すでに凍結されているパッケージを凍結すると、新しく指定されたバージョンによって凍結バージョンが置き換えられます。</para>
+<para>凍結されているパッケージをインストールまたは更新するときは、凍結された時点のバージョンと一致するバージョンである必要があります。たとえば、パッケージが 1.2 で凍結された場合、1.2.1、1.2.9、1.2.0.0.1 などのバージョンに更新することはできます。そのパッケージは 1.3 または 1.1 で終了することはできません。<replaceable>pkg_fmri_pattern</replaceable> で提供されるパブリッシャーは、一致するパッケージを検索するために使用されます。ただし、パブリッシャー情報は凍結の一環として記録されません。パッケージは発行元ではなくバージョンのみに関して凍結されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>reason</replaceable></term>
+<listitem><para>凍結されるパッケージとともに理由を記録します。<replaceable></replaceable>凍結が原因でインストールまたは更新に失敗する場合、その理由が示されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>凍結操作を試しに実行し、凍結されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結しません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unfreeze</command> [<option>n</option>] [<replaceable> pkg_name_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>n</option></term>
+<listitem><para>凍結解除操作を試しに実行し、凍結解除されるパッケージの一覧を表示しますが、実際にはどのパッケージも凍結解除しません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg property</command> [<option>H</option>] [<replaceable> propname</replaceable> ...]</term>
+<listitem><para>すべてのイメージプロパティーの名前と値を表示します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>propname</replaceable></term>
+<listitem><para>指定されたプロパティーのみの名前と値を表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option> </term>
+<listitem><para>一覧からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-property</command> <replaceable>propname</replaceable> <replaceable> propvalue</replaceable></term>
+<listitem><para>既存のイメージプロパティーを更新するか、または新しいイメージプロパティーを追加します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg add-property-value</command> <replaceable>propname </replaceable> <replaceable>propvalue</replaceable></term>
+<listitem><para>既存のイメージプロパティーに値を追加するか、または新しいイメージプロパティーを追加します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg remove-property-value</command> <replaceable>propname </replaceable> <replaceable>propvalue</replaceable></term>
+<listitem><para>既存のイメージプロパティーから値を削除します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-property</command> <replaceable>propname</replaceable> ... </term>
+<listitem><para>既存のイメージプロパティーを削除します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg publisher</command> [<option>HPn</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>publisher</replaceable> ...] </term>
+<listitem><para>すべてのパブリッシャーの一覧を、検索の優先順に従って表示します。パブリッシャーごとに次の情報が表示されます。名前、非固定的や無効などの属性、種類 (起点またはミラー)、オンラインステータス、プロキシ、場所の URI。プロキシ情報は、P というラベルが付いた列に T (true) または F (false) と表示されるだけです。P 列が T のパブリッシャーのプロキシ値を表示するには、<literal>-F tsv</literal> オプションを使用するか、パブリッシャー名の引数を使用します。<command>pkg publisher</command> コマンドによって表示されるプロキシは、<command>pkg set-publisher</command> コマンドの <option>-proxy</option> オプションを使用して設定されました。<envar>http_proxy</envar> 環境変数を使用して設定されるプロキシは、<command>pkg publisher</command> コマンドによって表示されません。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>publisher</replaceable></term>
+<listitem><para>指定された発行元のみの詳細な構成を表示します。表示される追加情報には、プロキシ URI、各起点またはミラー URI 用の鍵および証明書、クライアント UUID、カタログが最後に更新された時間などがあります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>代替出力形式を指定します。詳細は、<command>pkg mediator</command> コマンドを参照してください。</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option> </term>
+<listitem><para>一覧からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option></term>
+<listitem><para>発行元検索順の先頭の発行元のみを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>有効な発行元のみを表示します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-publisher</command> [-Ped] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable>ssl_key</replaceable>] [<option>g</option> <replaceable>origin_to_add</replaceable> | <option>-add-origin</option> <replaceable>origin_to_add</replaceable>]... [<option>G</option> <replaceable>origin_to_remove</replaceable> | <option>-remove-origin</option> <replaceable>origin_to_remove</replaceable>]... [<option>m</option> <replaceable>mirror_to_add</replaceable> | <option>-add-mirror</option> <replaceable>mirror_to_add</replaceable>]... [<option>M</option> <replaceable>mirror_to_remove</replaceable> | <option>-remove-mirror</option> <replaceable>mirror_to_remove</replaceable>]... [<option>-disable</option>] [<option>-enable</option>] [<option>-no-refresh</option>] [<option>-reset-uuid</option>] [<option>-non-sticky</option>] [<option>-sticky</option>] [<option>-search-after</option> <replaceable>publisher</replaceable>] [<option>-search-before</option> <replaceable>publisher</replaceable>] [<option>-search-first</option>] [<option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable>] [<option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-add-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_add</replaceable>] [<option>-remove-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_remove</replaceable>] [<option>-unset-property</option> <replaceable>name_of_property_to_delete</replaceable>] [<option>-proxy</option> <replaceable>proxy_to_use</replaceable>] <replaceable>publisher</replaceable></term>
+<listitem><para>既存の発行元を更新するか、発行元を追加します。検索順に影響するオプションを指定しない場合、新しいパブリッシャーは検索順の末尾に付加され、最後に検索されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>G</option> <replaceable>origin_to_remove</replaceable></term> <term><option>-remove-origin</option> <replaceable>origin_to_remove</replaceable></term>
+<listitem><para>指定された発行元の起点のリストから URI またはパスを削除します。特殊値 <literal>*</literal> を使用して、すべての起点を削除することができます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>M</option> <replaceable>mirror_to_remove</replaceable></term> <term><option>-remove-mirror</option> <replaceable>mirror_to_remove</replaceable></term>
+<listitem><para>指定された発行元のミラーのリストから URI を削除します。特殊値 <literal>*</literal> を使用して、すべてのミラーを削除することができます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option></term><term><option>-search-first</option></term>
+<listitem><para>指定された発行元を、検索順の先頭に設定します。新しいパッケージをインストールするとき、このパブリッシャーが最初に検索されます。インストール済みパッケージの更新は、そのパブリッシャーが sticky であるかぎり、そのパッケージを最初に提供した同じパブリッシャーから取得されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para>クライアント SSL 証明書を指定します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term><term><option>-disable</option></term>
+<listitem><para>発行元を無効にします。無効にされたパブリッシャーは、パッケージリストの生成時に、または特定のパッケージ操作 (インストール、アンインストール、および更新) で使用されません。ただし、無効なパブリッシャーのプロパティーを設定または表示することはできます。発行元が 1 つだけの場合は、無効にすることはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>e</option></term><term><option>-enable</option></term>
+<listitem><para>発行元を有効にします。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>g</option> <replaceable>origin_to_add</replaceable></term> <term><option>-add-origin</option> <replaceable>origin_to_add</replaceable></term>
+<listitem><para>指定された URI またはパスを、特定の発行元の起点として追加します。これはパッケージのリポジトリまたはアーカイブの場所にしてください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>ssl_key</replaceable></term>
+<listitem><para>クライアント SSL 鍵を指定します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option> <replaceable>mirror_to_add</replaceable></term> <term><option>-add-mirror</option> <replaceable>mirror_to_add</replaceable></term>
+<listitem><para>URI を指定された発行元のミラーとして追加します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-add-property-value</option> <replaceable>name_of_property </replaceable>=<replaceable>value_to_add</replaceable></term>
+<listitem><para>既存の発行元プロパティーに値を追加するか、または新しい発行元プロパティーを追加します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable></term>
+<listitem><para>署名付きパッケージを検証するために、信頼できる CA 証明書として指定された証明書を追加します。ユーザーが承認した CA 証明書の PEM 表現のハッシュは、<command>pkg publisher</command> コマンドの詳細出力に一覧表示されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-refresh</option></term>
+<listitem><para>入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-non-sticky</option></term>
+<listitem><para>この発行元よりも上位にランクされる発行元が、この発行元から最初にインストールされたパッケージに更新を提供できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-proxy</option> <replaceable>proxy_to_use</replaceable></term>
+<listitem><para>指定したプロキシ URI を使用して、指定した起点 (<option>g</option>) またはミラー (<option>m</option>) のコンテンツを取得します。プロキシ値は、パブリッシャーの構成の一部として格納されます。つまり、子イメージが使用するシステムリポジトリは自動的に更新されます。このオプションを使用して認証済みプロキシを設定することはできません。<replaceable>proxy_to_use</replaceable> の値を <literal>protocol://user:password@host</literal> の形式にすることはできません。</para>
+<para>実行時には、<literal>$http_proxy</literal> または関連する環境変数がこのプロキシ設定をオーバーライドします。受け入れられる環境変数名のリストについては、<literal>curl</literal>(1) のマニュアルページの「環境」セクションを参照してください。環境変数を使用してプロキシ URI を設定する場合は、<literal>svc:/application/pkg/system-repository</literal> SMF サービスの該当するプロキシプロパティーも同じ値に設定する必要があります。<citetitle>Oracle Solaris 11.3 でのソフトウェアの追加と更新に関するドキュメント</citetitle>の、プロキシの指定に関する説明を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-remove-property-value</option> <replaceable>name_of_property </replaceable>=<replaceable>value_to_remove</replaceable></term>
+<listitem><para>既存の発行元プロパティーから値を削除します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-reset-uuid</option></term>
+<listitem><para>このイメージをその発行元に対して識別する新しい一意識別子を選択します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove </replaceable></term>
+<listitem><para>署名付きパッケージを検証するために、指定された PEM 表現のハッシュを持つ証明書を失効済みとして扱います。ユーザーが失効させた CA 証明書のハッシュは、<command>pkg publisher</command> コマンドの詳細出力に一覧表示されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-search-after</option> <replaceable>publisher</replaceable></term>
+<listitem><para>追加または変更される発行元が、このオプションで指定された発行元のあとに検索されるように、発行元検索順序を変えます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-search-before</option> <replaceable>publisher</replaceable></term>
+<listitem><para>追加または変更される発行元が、このオプションで指定された発行元の前に検索されるように、発行元検索順序を変えます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>既存の発行元プロパティーを更新するか、または新しい発行元プロパティーを追加します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-sticky</option></term>
+<listitem><para>この発行元からインストールされたパッケージへの更新も、この発行元から取得する必要があります。これはデフォルトの動作です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove </replaceable></term>
+<listitem><para>署名付きパッケージを検証するために、指定されたハッシュを持つ証明書を、承認済み証明書のリストおよび失効済み証明書のリストから削除します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-unset-property</option> <replaceable>name_of_property_to_delete </replaceable></term>
+<listitem><para>既存の発行元プロパティーを削除します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-publisher</command> <option>p</option> <replaceable>repo_uri</replaceable> [-Ped] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable>ssl_key</replaceable>] [<option>-non-sticky</option>] [<option>-sticky</option>] [<option>-search-after</option> <replaceable>publisher</replaceable>] [<option>-search-before</option> <replaceable>publisher</replaceable>] [<option>-search-first</option>] [<option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable>] [<option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-add-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_add</replaceable>] [<option>-remove-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_remove</replaceable>] [<option>-unset-property</option> <replaceable>name_of_property_to_delete</replaceable>] [<option>-proxy</option> <replaceable>proxy_to_use</replaceable>] [<replaceable>publisher</replaceable>]</term>
+<listitem><para><replaceable>repo_uri</replaceable> リポジトリ URI からパブリッシャー構成情報を取得します。</para>
+<para>発行元オペランドがこの <command>set-publisher</command> サブコマンドに指定されている場合、その発行元のみが追加または更新されます。発行元を指定しない場合、<replaceable>repo_uri</replaceable> 内のすべての発行元が必要に応じて追加または更新されます。</para>
+<para>オプションの説明については、前述の <command>set-publisher</command> コマンドを参照してください。<option>p</option> と同時に使用する場合、<option>P</option>、<option>-search-first </option>、<option>-search-before</option>、および <option>-search-after</option> オプションは追加された発行元のみに適用され、更新された発行元には適用されません。</para>
+<para><option>p</option> オプションは、<option>g</option>、<option>-add-origin</option>、<option>G</option>、<option>-remove-origin</option>、<option>m</option>、<option>-add-mirror</option>、<option>M</option>、<option>-remove-mirror</option>、<option>-disable</option>、<option>-enable</option>、<option>-no-refresh</option>、または <option>-reset-uuid</option> オプションと組み合わせることはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-publisher</command> <replaceable>publisher </replaceable> ...</term>
+<listitem><para>指定された発行元に関連付けられた構成を削除します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg history</command> [<option>HNl</option>] [<option>n</option> <replaceable>number</replaceable>] [<option>o</option> <replaceable>column</replaceable>[,<replaceable>column</replaceable>]...]... [<option>t</option> <replaceable>time</replaceable> | <replaceable>time</replaceable>-<replaceable>time</replaceable>[,<replaceable>time</replaceable> | <replaceable>time</replaceable>-<replaceable>time</replaceable>]...]...</term>
+<listitem><para>該当するイメージのコマンド履歴を表示します。操作の開始時間、操作の名前 (<literal>install</literal> など)、クライアント (<literal>pkg</literal> など)、および操作の結果 (成功または失敗) が表示されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>H</option> </term>
+<listitem><para>一覧からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option></term>
+<listitem><para>イメージの長形式のコマンド履歴を表示します。表示される追加情報は、クライアントのバージョン、操作を実行したユーザーの名前、新しいブート環境が作成されたかどうか、操作が完了した時間および費やした合計時間、発行された完全なコマンド、およびコマンドの実行中に発生したすべてのエラーなどがあります。<command>update</command> などの操作では、変更されたパッケージの完全な FMRI が表示されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>N</option></term>
+<listitem><para>リリースノートのテキストを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option> <replaceable>number</replaceable></term>
+<listitem><para>最新のものから順に指定された数のエントリのみを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>column</replaceable></term>
+<listitem><para>指定された列名を使用して出力を表示します。<option>o</option> オプションは複数回指定できます。または、列名をコンマで区切ることにより、1 つの <option>o</option> オプションの引数として複数の列名を指定できます。有効な列名は次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>be</literal></term>
+<listitem><para>この操作が開始されたブート環境の名前。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>be_uuid</literal></term>
+<listitem><para>この操作が開始されたブート環境の <literal>UUID</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>client</literal></term>
+<listitem><para>クライアントの名前。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>client_ver</literal></term>
+<listitem><para>クライアントのバージョン。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>command</literal></term>
+<listitem><para>この操作のために使用されたコマンド行。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>finish</literal></term>
+<listitem><para>この操作が完了した日時。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>id</literal></term>
+<listitem><para>この操作を開始したユーザー ID。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>new_be</literal></term>
+<listitem><para>この操作によって作成された新しいブート環境。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>new_be_uuid</literal></term>
+<listitem><para>この操作によって作成された新しいブート環境の <literal>UUID</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>operation</literal></term>
+<listitem><para>操作の名前。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>outcome</literal></term>
+<listitem><para>この操作の結果のサマリー。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>reason</literal></term>
+<listitem><para>この操作の結果に関する追加情報。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>release_note</literal></term>
+<listitem><para>この操作によってリリースノートが生成されたかどうかを示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>snapshot</literal></term>
+<listitem><para>この操作中に作成されたスナップショット。これは、操作が正常に完了したあとにスナップショットが自動削除されなかった場合にのみ記録されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>start</literal></term>
+<listitem><para>この操作が開始した日時。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>time</literal></term>
+<listitem><para>この操作の実行にかかった合計時間。1 秒未満の操作については 0:00:00 と表示されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>user</literal> </term>
+<listitem><para>この操作を開始したユーザー名。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>command</literal> または <literal>reason</literal> 列を指定する場合、出力フィールドの区切りを維持するためには、それらの列が <option>o</option> リストの最終項目である必要があります。同じ <command>history</command> コマンドでこれら 2 つの列を表示することはできません。</para>
+<para>ブート環境がシステムに存在しなくなった場合、<literal>be</literal> または <literal>new_be</literal> の値のあとにアスタリスク (*) が表示されます。</para>
+<para><literal>be</literal> および <literal>new_be</literal> の値は、<literal>be_uuid</literal> または <literal>new_be_uuid</literal> フィールドを使用して現在のブート環境名を検索することによって取得されます。その後、ブート環境の名前が変更されたあとにその環境が削除された場合、<literal>be</literal> および <literal>new_be</literal> に表示される値は、<command>pkg</command> 操作の時点で記録された値です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>time</replaceable></term> <term><option>t</option> <replaceable>time</replaceable>-<replaceable>time</replaceable></term>
+<listitem><para><literal>%Y-%m-%dT%H:%M:%S</literal> 形式のタイムスタンプのコンマ区切りリストでログレコードを表示します (<literal>strftime</literal>(3C) マニュアルページを参照)。日時の範囲を指定するには、開始と終了のタイムスタンプの間にハイフン (<literal>-</literal>) を使用します。キーワード <literal>now</literal> は、現在の日時の別名として使用できます。このオプションは複数回指定できます。指定されたタイムスタンプに、重複したタイムスタンプまたは重複する日付範囲が含まれる場合、重複した各履歴イベントは表示されません。各履歴イベントの 1 つのインスタンスのみが表示されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg purge-history</command></term>
+<listitem><para>既存の履歴情報をすべて削除します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg rebuild-index</command></term>
+<listitem><para><command>pkg search</command> によって使用されるインデックスを再構築します。これは復旧操作であり、一般的に使用することは想定されていません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg update-format</command></term>
+<listitem><para>イメージの形式を現在のバージョンに更新します。この操作が完了したあとは、古いバージョンの <literal>pkg</literal>(5) システムと組み合わせてイメージを使用することはできなくなります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg version</command></term>
+<listitem><para><command>pkg</command> のバージョンを識別する一意な文字列を表示します。この文字列は、バージョン間で何らかの方法で比較可能であることは保証されていません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg help</command></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--proxy\fR \fIproxy_to_use\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定したプロキシ URI を使用して、指定した起点 (\fB-g\fR) またはミラー (\fB-m\fR) のコンテンツを取得します。プロキシ値は、パブリッシャーの構成の一部として格納されます。つまり、子イメージが使用するシステムリポジトリは自動的に更新されます。このオプションを使用して認証済みプロキシを設定することはできません。\fIproxy_to_use\fR の値を \fBprotocol://user:password@host\fR の形式にすることはできません。
-.sp
-実行時には、\fB$http_proxy\fR または関連する環境変数がこのプロキシ設定をオーバーライドします。受け入れられる環境変数名のリストについては、\fBcurl\fR(1) のマニュアルページの「環境」セクションを参照してください。環境変数を使用してプロキシ URI を設定する場合は、\fBsvc:/application/pkg/system-repository\fR SMF サービスの該当するプロキシプロパティーも同じ値に設定する必要があります。\fIOracle Solaris 11.2 でのソフトウェアの追加と更新に関するドキュメント\fRの、プロキシの指定に関する説明を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--remove-property-value\fR \fIname_of_property \fR=\fIvalue_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存の発行元プロパティーから値を削除します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--reset-uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-このイメージをその発行元に対して識別する新しい一意識別子を選択します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove \fR\fR
-.ad
-.sp .6
-.RS 4n
-署名付きパッケージを検証するために、指定された PEM 表現のハッシュを持つ証明書を失効済みとして扱います。ユーザーが失効させた CA 証明書のハッシュは、\fBpkg publisher\fR コマンドの詳細出力に一覧表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--search-after\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-追加または変更される発行元が、このオプションで指定された発行元のあとに検索されるように、発行元検索順序を変えます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--search-before\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-追加または変更される発行元が、このオプションで指定された発行元の前に検索されるように、発行元検索順序を変えます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--set-property\fR \fIname_of_property\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存の発行元プロパティーを更新するか、または新しい発行元プロパティーを追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sticky\fR\fR
-.ad
-.sp .6
-.RS 4n
-この発行元からインストールされたパッケージへの更新も、この発行元から取得する必要があります。これはデフォルトの動作です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove \fR\fR
-.ad
-.sp .6
-.RS 4n
-署名付きパッケージを検証するために、指定されたハッシュを持つ証明書を、承認済み証明書のリストおよび失効済み証明書のリストから削除します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--unset-property\fR \fIname_of_property_to_delete \fR\fR
-.ad
-.sp .6
-.RS 4n
-既存の発行元プロパティーを削除します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-publisher\fR \fB-p\fR \fIrepo_uri\fR [-Ped] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fIssl_key\fR] [\fB--non-sticky\fR] [\fB--sticky\fR] [\fB--search-after\fR \fIpublisher\fR] [\fB--search-before\fR \fIpublisher\fR] [\fB--search-first\fR] [\fB--approve-ca-cert\fR \fIpath_to_CA\fR] [\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--add-property-value\fR \fIname_of_property\fR=\fIvalue_to_add\fR] [\fB--remove-property-value\fR \fIname_of_property\fR=\fIvalue_to_remove\fR] [\fB--unset-property\fR \fIname_of_property_to_delete\fR] [\fB--proxy\fR \fIproxy_to_use\fR] [\fIpublisher\fR]\fR
-.ad
-.sp .6
-.RS 4n
-\fIrepo_uri\fR リポジトリ URI からパブリッシャー構成情報を取得します。
-.sp
-発行元オペランドがこの \fBset-publisher\fR サブコマンドに指定されている場合、その発行元のみが追加または更新されます。発行元を指定しない場合、\fIrepo_uri\fR 内のすべての発行元が必要に応じて追加または更新されます。
-.sp
-オプションの説明については、前述の \fBset-publisher\fR コマンドを参照してください。\fB-p\fR と同時に使用する場合、\fB-P\fR、\fB--search-first \fR、\fB--search-before\fR、および \fB--search-after\fR オプションは追加された発行元のみに適用され、更新された発行元には適用されません。
-.sp
-\fB-p\fR オプションは、\fB-g\fR、\fB--add-origin\fR、\fB-G\fR、\fB--remove-origin\fR、\fB-m\fR、\fB--add-mirror\fR、\fB-M\fR、\fB--remove-mirror\fR、\fB--disable\fR、\fB--enable\fR、\fB--no-refresh\fR、または \fB--reset-uuid\fR オプションと組み合わせることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-publisher\fR \fIpublisher \fR ...\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元に関連付けられた構成を削除します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg history\fR [\fB-HNl\fR] [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIcolumn\fR[,\fIcolumn\fR]...]... [\fB-t\fR \fItime\fR | \fItime\fR-\fItime\fR[,\fItime\fR | \fItime\fR-\fItime\fR]...]...\fR
-.ad
-.sp .6
-.RS 4n
-該当するイメージのコマンド履歴を表示します。操作の開始時間、操作の名前 (\fBinstall\fR など)、クライアント (\fBpkg\fR など)、および操作の結果 (成功または失敗) が表示されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-一覧からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-イメージの長形式のコマンド履歴を表示します。表示される追加情報は、クライアントのバージョン、操作を実行したユーザーの名前、新しいブート環境が作成されたかどうか、操作が完了した時間および費やした合計時間、発行された完全なコマンド、およびコマンドの実行中に発生したすべてのエラーなどがあります。\fBupdate\fR などの操作では、変更されたパッケージの完全な FMRI が表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-N\fR\fR
-.ad
-.sp .6
-.RS 4n
-リリースノートのテキストを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR \fInumber\fR\fR
-.ad
-.sp .6
-.RS 4n
-最新のものから順に指定された数のエントリのみを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIcolumn\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された列名を使用して出力を表示します。\fB-o\fR オプションは複数回指定できます。または、列名をコンマで区切ることにより、1 つの \fB-o\fR オプションの引数として複数の列名を指定できます。有効な列名は次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作が開始されたブート環境の名前。
-.RE
+<varlistentry><term><command>pkg image-create</command> [<option>FPUfz</option>] [<option>-force</option>] [<option>-full</option> | <option>-partial</option> | <option>-user</option>] [<option>-zone</option>] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable> ssl_key</replaceable>] [<option>g</option> <replaceable>path_or_uri</replaceable> | <option>-origin</option> <replaceable>path_or_uri</replaceable>]... [<option>m</option> <replaceable>uri</replaceable> | <option>-mirror</option> <replaceable>uri</replaceable>]... [<option>-facet</option> <replaceable>facet_name</replaceable>=(<literal>True</literal>|<literal>False</literal>)]... [<option>-no-refresh</option>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-variant</option> <replaceable>variant_name</replaceable>=<replaceable>value</replaceable>]... [(<option>p</option> | <option>-publisher</option>) [<replaceable>name</replaceable>=]<replaceable>repo_uri</replaceable>] <replaceable>dir</replaceable></term>
+<listitem><para><replaceable>dir</replaceable> によって指定された場所に、パッケージ操作に適したイメージを作成します。<command>image-create</command> サブコマンドを使用して作成されたイメージは、ブート可能ではありません。ほとんどのユーザーは、<option>-be-name</option> または <option>-require-new-be</option> オプションを <command>pkg</command> コマンドで使用したり、<command>beadm</command> コマンドまたは <command>zoneadm</command> コマンドを使用してイメージを作成したりする必要があります。<command>pkg image-create</command> コマンドは、パッケージおよびオペレーティングシステムのディストリビューションを維持するといったタスク向けに使用されています。</para>
+<para>デフォルトのイメージタイプは user で、<option>U</option> オプションまたは <option>-user</option> オプションを使用して指定できます。あるいは、イメージタイプはフルイメージ (<option>-F</option> または <option>-full</option>)、または指定された <replaceable>dir</replaceable> パスを包含するフルイメージにリンクされた部分イメージ (<option>P</option> または <option>-partial</option>) に設定できます。</para>
+<para><option>g</option> または <option>-origin</option> を使用して追加の起点を指定できます。<option>m</option> または <option>-mirror</option> を使用して追加のミラーを指定できます。</para>
+<para>パッケージリポジトリの URI は、<option>p</option> または <option>-publisher</option> オプションを使用して提供する必要があります。パブリッシャーの名前も提供した場合、イメージの作成時にそのパブリッシャーのみが追加されます。パブリッシャーの名前を提供しない場合、指定されたリポジトリによって認識されているすべてのパブリッシャーがイメージに追加されます。このパブリッシャーに関連付けられたカタログは、初期作成操作に続いて取得が試みられます。</para>
+<para>クライアント SSL 認証を使用するパブリッシャーの場合、クライアント鍵およびクライアント証明書は <option>c</option> および <option>k</option> オプションを通して登録できます。この鍵と証明書は、イメージ作成中に追加されるすべてのパブリッシャーのために使用されます。</para>
+<para>イメージが非大域ゾーンコンテキストの内部で実行される予定の場合、<option>z</option> (<option>-zone</option>) オプションを使用して適切なバリアントを設定できます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>f</option></term><term><option>-force</option></term>
+<listitem><para>既存のイメージ上にイメージを強制的に作成します。このオプションは慎重に使用してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-facet</option> <replaceable>facet_name</replaceable>=(<literal> True</literal>|<literal>False</literal>)</term>
+<listitem><para>指定されたファセットを指定された値に設定します。ファセットの詳細については、<literal>pkg</literal>(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-refresh</option></term>
+<listitem><para>入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>指定されたイメージプロパティーを指定された値に設定します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-variant</option> <replaceable>variant_name</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>指定されたバリアントを指定された値に設定します。バリアントの詳細については、<literal>pkg</literal>(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe_uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作が開始されたブート環境の \fBUUID\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclient\fR\fR
-.ad
-.sp .6
-.RS 4n
-クライアントの名前。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclient_ver\fR\fR
-.ad
-.sp .6
-.RS 4n
-クライアントのバージョン。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcommand\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作のために使用されたコマンド行。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBfinish\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作が完了した日時。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBid\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作を開始したユーザー ID。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBnew_be\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作によって作成された新しいブート環境。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBnew_be_uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作によって作成された新しいブート環境の \fBUUID\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoperation\fR\fR
-.ad
-.sp .6
-.RS 4n
-操作の名前。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoutcome\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作の結果のサマリー。
-.RE
+<varlistentry><term><command>pkg <option>R</option> <replaceable>dir</replaceable> dehydrate</command> [<option>nvq</option>] [<option>p</option> <replaceable>publisher</replaceable>]...</term>
+<listitem><para><option>R</option> オプションで指定されたイメージから、編集できないパッケージされたファイルおよびパッケージされたハードリンクをすべて削除して、完全にデハイドレートされたイメージを作成します。パッケージされたファイルおよびパッケージされたハードリンクは、現在インストールされているパッケージのバージョンによって提供されたファイルおよびハードリンクです。編集できないファイルは、<literal>preserve</literal> または <literal>overlay</literal> 属性を持つことはできず、値が <literal>false</literal> に設定された <literal>dehydrate</literal> 属性を持つこともできません。</para>
+<para><command>pkg dehydrate</command> コマンドは、代替ルートに対してのみ処理を実行します。代替ルートを指定するには、<option>R</option> オプションを使用します。代替ルートがブート環境に属している場合、デハイドレーションによってブート不可になります。</para>
+<para><command>pkg dehydrate</command> コマンドが成功すると、<option>R</option> オプションで指定された <replaceable>dir</replaceable> イメージに <command>dehydrated</command> というプロパティーが設定されます。<command>dehydrated</command> プロパティーの値は、構成済みのパッケージリポジトリを持っている、<replaceable>dir</replaceable> イメージ内に設定されたパブリッシャーのリストです。</para>
+<para>デハイドレートされたパブリッシャーからのパッケージに対するパッケージインストール操作は、自動的にデハイドレートされます。デハイドレートされたイメージにパッケージをインストールする場合、パッケージの内容はインストールされたあとでデハイドレートされます。パッケージインストール操作には、<command>install</command> だけでなく、<command>update</command> や <command>change-facet</command> などの操作も含まれます。</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定されたパブリッシャーから提供された、編集できないファイルおよびハードリンクだけを削除して、部分的にデハイドレートされたイメージを作成します。イメージ内の構成済みパブリッシャーがすべて指定された場合は、前述の完全にデハイドレートされたイメージが作成されます。</para>
+<para>1 つ以上のパブリッシャーが指定された場合で、そのいずれかがイメージ内に構成されていないときは、イメージからは何も削除されません。</para>
+<para><command>pkg dehydrate</command> コマンドが成功すると、<option>R</option> オプションで指定された <replaceable>dir</replaceable> イメージに <command>dehydrated</command> というプロパティーが設定されます。<command>dehydrated</command> プロパティーの値は、<option>p</option> オプションで指定されたすべてのパブリッシャーのリストです。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>その他のすべてのオプションについては、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBreason\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作の結果に関する追加情報。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrelease_note\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作によってリリースノートが生成されたかどうかを示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsnapshot\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作中に作成されたスナップショット。これは、操作が正常に完了したあとにスナップショットが自動削除されなかった場合にのみ記録されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBstart\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作が開始した日時。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtime\fR\fR
-.ad
-.sp .6
-.RS 4n
-この操作の実行にかかった合計時間。1 秒未満の操作については 0:00:00 と表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuser\fR \fR
-.ad
-.sp .6
-.RS 4n
-この操作を開始したユーザー名。
-.RE
-
-\fBcommand\fR または \fBreason\fR 列を指定する場合、出力フィールドの区切りを維持するためには、それらの列が \fB-o\fR リストの最終項目である必要があります。同じ \fBhistory\fR コマンドでこれら 2 つの列を表示することはできません。
-.sp
-ブート環境がシステムに存在しなくなった場合、\fBbe\fR または \fBnew_be\fR の値のあとにアスタリスク (*) が表示されます。
-.sp
-\fBbe\fR および \fBnew_be\fR の値は、\fBbe_uuid\fR または \fBnew_be_uuid\fR フィールドを使用して現在のブート環境名を検索することによって取得されます。その後、ブート環境の名前が変更されたあとにその環境が削除された場合、\fBbe\fR および \fBnew_be\fR に表示される値は、\fBpkg\fR 操作の時点で記録された値です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fItime\fR\fR
-.ad
-.br
-.na
-\fB\fB-t\fR \fItime\fR-\fItime\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB%Y-%m-%dT%H:%M:%S\fR 形式のタイムスタンプのコンマ区切りリストでログレコードを表示します (\fBstrftime\fR(3C) マニュアルページを参照)。日時の範囲を指定するには、開始と終了のタイムスタンプの間にハイフン (\fB-\fR) を使用します。キーワード \fBnow\fR は、現在の日時の別名として使用できます。このオプションは複数回指定できます。指定されたタイムスタンプに、重複したタイムスタンプまたは重複する日付範囲が含まれる場合、重複した各履歴イベントは表示されません。各履歴イベントの 1 つのインスタンスのみが表示されます。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg purge-history\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存の履歴情報をすべて削除します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg rebuild-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkg search\fR によって使用されるインデックスを再構築します。これは復旧操作であり、一般的に使用することは想定されていません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg update-format\fR\fR
-.ad
-.sp .6
-.RS 4n
-イメージの形式を現在のバージョンに更新します。この操作が完了したあとは、古いバージョンの \fBpkg\fR(5) システムと組み合わせてイメージを使用することはできなくなります。
-.RE
+<varlistentry><term><command>pkg <option>R</option> <replaceable>dir</replaceable> rehydrate</command> [<option>nvq</option>] [<option>p</option> <replaceable>publisher</replaceable>]...</term>
+<listitem><para><command>pkg dehydrate</command> コマンドで削除されたすべてのファイルおよびハードリンクを再インストールします。</para>
+<para><command>pkg rehydrate</command> コマンドは、代替ルートに対してのみ処理を実行します。代替ルートを指定するには、<option>R</option> オプションを使用します。</para>
+<para><command>pkg rehydrate</command> コマンドが成功すると、イメージの <command>dehydrated</command> プロパティーの値は空になります。</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定されたパブリッシャーに関して <command>pkg dehydrate</command> コマンドで削除されたすべてのファイルおよびハードリンクを再インストールします。</para>
+<para>1 つ以上のパブリッシャーが指定された場合で、そのいずれかがイメージ内に構成されていないときは、何もインストールされません。</para>
+<para><command>pkg rehydrate</command> コマンドが成功すると、イメージに設定されている <command>dehydrated</command> プロパティーの値から、指定されたパブリッシャーの名前が削除されます。<command>rehydrate</command> コマンドで指定されていないパブリッシャーは <command>dehydrated</command> プロパティーのリストに残り、それらのパブリッシャーからインストールされた内容はデハイドレートされたままになります。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>その他のすべてのオプションについては、前述の <command>install</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg version\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkg\fR のバージョンを識別する一意な文字列を表示します。この文字列は、バージョン間で何らかの方法で比較可能であることは保証されていません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg image-create\fR [\fB-FPUfz\fR] [\fB--force\fR] [\fB--full\fR | \fB--partial\fR | \fB--user\fR] [\fB--zone\fR] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fI ssl_key\fR] [\fB-g\fR \fIpath_or_uri\fR | \fB--origin\fR \fIpath_or_uri\fR]... [\fB-m\fR \fIuri\fR | \fB--mirror\fR \fIuri\fR]... [\fB--facet\fR \fIfacet_name\fR=(\fBTrue\fR|\fBFalse\fR)]... [\fB--no-refresh\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--variant\fR \fIvariant_name\fR=\fIvalue\fR]... [(\fB-p\fR | \fB--publisher\fR) [\fIname\fR=]\fIrepo_uri\fR] \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIdir\fR によって指定された場所に、パッケージ操作に適したイメージを作成します。\fBimage-create\fR サブコマンドを使用して作成されたイメージは、ブート可能ではありません。ほとんどのユーザーは、\fB--be-name\fR または \fB--require-new-be\fR オプションを \fBpkg\fR コマンドで使用したり、\fBbeadm\fR コマンドまたは \fBzoneadm\fR コマンドを使用してイメージを作成したりする必要があります。\fBpkg image-create\fR コマンドは、パッケージおよびオペレーティングシステムのディストリビューションを維持するといったタスク向けに使用されています。
-.sp
-デフォルトのイメージタイプは user で、\fB-U\fR オプションまたは \fB--user\fR オプションを使用して指定できます。あるいは、イメージタイプはフルイメージ (\fB--F\fR または \fB--full\fR)、または指定された \fIdir\fR パスを包含するフルイメージにリンクされた部分イメージ (\fB-P\fR または \fB--partial\fR) に設定できます。
-.sp
-\fB-g\fR または \fB--origin\fR を使用して追加の起点を指定できます。\fB-m\fR または \fB--mirror\fR を使用して追加のミラーを指定できます。
-.sp
-パッケージリポジトリの URI は、\fB-p\fR または \fB--publisher\fR オプションを使用して提供する必要があります。パブリッシャーの名前も提供した場合、イメージの作成時にそのパブリッシャーのみが追加されます。パブリッシャーの名前を提供しない場合、指定されたリポジトリによって認識されているすべてのパブリッシャーがイメージに追加されます。このパブリッシャーに関連付けられたカタログは、初期作成操作に続いて取得が試みられます。
-.sp
-クライアント SSL 認証を使用するパブリッシャーの場合、クライアント鍵およびクライアント証明書は \fB-c\fR および \fB-k\fR オプションを通して登録できます。この鍵と証明書は、イメージ作成中に追加されるすべてのパブリッシャーのために使用されます。
-.sp
-イメージが非大域ゾーンコンテキストの内部で実行される予定の場合、\fB-z\fR (\fB--zone\fR) オプションを使用して適切なバリアントを設定できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.br
-.na
-\fB\fB--force\fR\fR
-.ad
-.sp .6
-.RS 4n
-既存のイメージ上にイメージを強制的に作成します。このオプションは慎重に使用してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--facet\fR \fIfacet_name\fR=(\fB True\fR|\fBFalse\fR)\fR
-.ad
-.sp .6
-.RS 4n
-指定されたファセットを指定された値に設定します。ファセットの詳細については、\fBpkg\fR(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-入手可能パッケージやその他のメタデータの最新リストを取得するために、イメージのパブリッシャー用のリポジトリへのアクセスを試みません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--set-property\fR \fIname_of_property\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたイメージプロパティーを指定された値に設定します。イメージプロパティーの説明については、下の「イメージプロパティー」を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--variant\fR \fIvariant_name\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたバリアントを指定された値に設定します。バリアントの詳細については、\fBpkg\fR(5) のマニュアルページのファセットとバリアントに関する項目を参照してください。
-.RE
-
-.RE
-
-.SH イメージプロパティー
-.sp
-.LP
-次のプロパティーはイメージの特性を定義します。これらのプロパティーは、イメージの目的、内容、および動作に関する情報を格納します。イメージ内のこれらのプロパティーの現在の値を表示するには、\fBpkg property\fR コマンドを使用します。これらのプロパティーの値を変更するには、\fBpkg set-property\fR コマンドおよび \fBpkg unset-property\fR コマンドを使用します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(文字列) パッケージ操作中にいつブート環境が作成されるかを指定します。次の値が許可されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.sp .6
-.RS 4n
-デフォルトブート環境作成ポリシー \fBcreate-backup\fR を適用します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalways-new\fR\fR
-.ad
-.sp .6
-.RS 4n
-次のブート時にアクティブに設定されている新しいブート環境でパッケージ操作を実行するため、すべてのパッケージ操作に対してリブートを必要とします。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。
-.sp
-このポリシーはもっとも安全ですが、リブートしないとパッケージを追加できないため、ほとんどのサイトの要求よりも厳格です。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcreate-backup\fR\fR
-.ad
-.sp .6
-.RS 4n
-リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。パッケージが変更されるか、カーネルに影響を及ぼす可能性のある内容がインストールされて、ライブブート環境がこの操作の影響を受ける場合、バックアップブート環境は作成されますが、アクティブには設定されません。バックアップブート環境を明示的にリクエストすることもできます。
-.sp
-このポリシーは、新しくインストールされたソフトウェアによりシステムが不安定になっている場合にのみ潜在的に危険です。この可能性はありますが、比較的まれです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwhen-required\fR\fR
-.ad
-.sp .6
-.RS 4n
-リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。
-.sp
-ライブブート環境へのパッケージ変更によりそれ以上の変更が不可能になる場合、フォールバック可能な最近のブート環境が存在しない可能性があるため、このポリシーには最大の危険が伴います。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBca-path\fR\fR
-.ad
-.sp .6
-.RS 4n
-(文字列) SSL 操作用の CA 証明書が格納されたディレクトリを指すパス名。このディレクトリの形式は、ベースとなる SSL 実装に固有です。信頼できる CA 証明書のために別の場所を使用するには、別のディレクトリを指すようにこの値を変更します。CA ディレクトリの要件については、\fBSSL_CTX_load_verify_locations\fR(3openssl) の \fBCApath\fR に関する項目を参照してください。
-.sp
-デフォルト値: \fB/etc/openssl/certs\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcheck-certificate-revocation\fR\fR
-.ad
-.sp .6
-.RS 4n
-(ブール型) \fBTrue\fR に設定されている場合、パッケージクライアントは、署名検証のために使用される証明書の CRL 配布ポイントへのアクセスを試み、発行時よりもあとに証明書が失効していないかどうかを調べます。
-.sp
-デフォルト値: \fBFalse\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcontent-update-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(文字列) パッケージング操作中に、パッケージシステムが、編集できないファイルを更新するときに指定します。次の値が許可されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.sp .6
-.RS 4n
-デフォルトの内容更新ポリシーを常に適用します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalways\fR\fR
-.ad
-.sp .6
-.RS 4n
-変更された編集できないファイルを常にダウンロードおよび更新します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwhen-required\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージシステムで更新が必要であると判断された場合にのみ、変更された編集できないファイルをダウンロードおよび更新します。
-.RE
-
-デフォルト値: \fBalways\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBflush-content-cache-on-success\fR\fR
-.ad
-.sp .6
-.RS 4n
-(ブール型) これが \fBTrue\fR に設定されている場合、パッケージクライアントはイメージ変更操作が正常に完了したときに内容キャッシュ内のファイルを削除します。ブート環境を作成する操作の場合は、ソースと出力先の両方のブート環境から内容が削除されます。
-.sp
-このプロパティーを使用して、ディスク容量の限られたシステムで内容キャッシュを小さく保つことができます。このプロパティーを使用すると、操作が完了するまでの時間が長くなる可能性があります。
-.sp
-デフォルト値: \fBTrue\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmirror-discovery\fR\fR
-.ad
-.sp .6
-.RS 4n
-(ブール型) このプロパティーは、mDNS および DNS-SD を使用してリンクローカル内容ミラーを検出するようにクライアントに命令します。このプロパティーを \fBTrue\fR に設定すると、クライアントはミラーを動的に検出し、そのミラーからパッケージ内容のダウンロードを試みます。mDNS を介してその内容を通知するミラーの実行方法については、\fBpkg.depotd\fR(1M) のマニュアルページを参照してください。
-.sp
-デフォルト値: \fBFalse\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsend-uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-(ブール型) ネットワーク操作の実行時にイメージの汎用一意識別子 (UUID) を送信します。ユーザーはこのオプションを無効にできますが、一部のネットワークリポジトリは UUID を供給しないクライアントとのやり取りを拒否する場合があります。
-.sp
-デフォルト値: \fBTrue\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(文字列) イメージ内のパッケージのインストール、更新、修正、または検証時にマニフェストに対してどのチェックが実行されるかを決定します。パッケージに適用される最終的なポリシーは、イメージポリシーと発行元ポリシーの組み合わせに依存します。この組み合わせの厳格さは、少なくとも、この 2 つのポリシーが個別に適用された場合の厳格な方と同じです。デフォルトでは、パッケージクライアントは証明書が失効済みかどうかをチェックしません。そのようなチェック (クライアントから外部インターネットサイトへのアクセスが必要な場合がある) を有効にするには、\fBcheck-certificate-revocation\fR イメージプロパティーを \fBTrue\fR に設定します。次の値が許可されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBignore\fR\fR
-.ad
-.sp .6
-.RS 4n
-すべてのマニフェストの署名を無視します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBverify\fR\fR
-.ad
-.sp .6
-.RS 4n
-署名が含まれているすべてのマニフェストが有効に署名されていることを確認しますが、インストール済みパッケージがすべて署名されている必要はありません。これがデフォルト値です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-signatures\fR\fR
-.ad
-.sp .6
-.RS 4n
-新しくインストールされたすべてのパッケージに、有効な署名が少なくとも 1 つ含まれている必要があります。インストール済みパッケージに有効な署名が含まれていない場合は、\fBpkg fix\fR および \fBpkg verify\fR コマンドでも警告が表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBrequire-signatures\fR と同じ要件に従いますが、\fBsignature-required-names\fR プロパティーで一覧表示される文字列が、署名の信頼のチェーンを検証するために使用される証明書の共通名としても表示される必要があります。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-(文字列のリスト) パッケージの署名の検証中に、証明書の共通名として表示される必要のある名前の一覧です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtrust-anchor-directory\fR\fR
-.ad
-.sp .6
-.RS 4n
-(文字列) イメージの信頼アンカーを格納するディレクトリのパス名です。このパスはイメージに対して相対的です。デフォルト値は \fBignore\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuse-system-repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-(ブール型) このプロパティーではシステムリポジトリを、イメージおよびパブリッシャー構成のソースとして、および提供されたパブリッシャーと通信するためのプロキシとしてイメージで使用するべきかどうかを指定します。デフォルト値は \fBFalse\fR です。システムリポジトリについては、\fBpkg.sysrepo\fR(1M) のマニュアルページを参照してください。
-.RE
-
-.SH パブリッシャープロパティー
-.sp
-.LP
-次のプロパティーは、特定の発行元の署名ポリシーを定義します。同じ名前のイメージプロパティーはイメージの署名ポリシーを定義します。特定の発行元のこれらのプロパティーの現在の値を表示するには、\fBpkg publisher\fR \fIpublisher_name\fR コマンドを使用します。これらの発行元の署名ポリシープロパティーの値を変更するには、\fBpkg set-publisher\fR コマンドの \fB--set-property\fR オプションと \fB--unset-property\fR オプションを使用します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(文字列) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-(文字列のリスト) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fRパブリッシャーを構成してイメージを作成する
-.sp
-.LP
-パブリッシャーを \fBexample.com\fR として新しいフルイメージを作成し、\fB/aux0/example_root\fR に格納します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F -p example.com=http://pkg.example.com:10000 \e\fR
-\fB/aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fR追加の起点とミラーを指定してイメージを作成する
-.sp
-.LP
-パブリッシャーを \fBexample.com\fR として新しいフルイメージを作成し、1 つのミラーと 2 つの起点を追加し、\fB/aux0/example_root\fR に格納します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F -p example.com=http://pkg.example.com:10000 \e\fR
-\fB-g http://alternate1.example.com:10000/ \e\fR
-\fB-g http://alternate2.example.com:10000/ \e\fR
-\fB-m http://mirror.example.com:10000/ \e\fR
-\fB/aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 3 \fRパブリッシャーを構成せずにイメージを作成する
-.sp
-.LP
-パブリッシャーを構成せずに、新しいフルイメージを \fB/aux0/example_root\fR に作成します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 4 \fRパッケージのインストール
-.sp
-.LP
-\fBwidget\fR パッケージの最新バージョンを現在のイメージにインストールします。
-
-.sp
-.in +2
-.nf
-$ \fBpkg install application/widget\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 5 \fRパッケージの指定された内容を一覧表示する
-.sp
-.LP
-\fBsystem/file-system/zfs\fR パッケージの内容を一覧表示します。アクション名、ファイルのモード (定義されている場合)、サイズ (定義されている場合)、パス、およびターゲット (リンクの場合) を表示します。すべてのアクションで利用可能な \fBaction.name\fR 属性を指定するとすべてのアクションの行が表示されますが、ここでは望ましくないため、\fBdir\fR、\fBfile\fR、\fBlink\fR、および \fBhardlink\fR の各タイプにアクションを限定します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -t dir,file,link,hardlink \e\fR
-\fB-o action.name,mode,pkg.size,path,target system/file-system/zfs\fR
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>イメージプロパティー</title>
+<para>次のプロパティーはイメージの特性を定義します。これらのプロパティーは、イメージの目的、内容、および動作に関する情報を格納します。イメージ内のこれらのプロパティーの現在の値を表示するには、<command>pkg property</command> コマンドを使用します。これらのプロパティーの値を変更するには、<command>pkg set-property</command> コマンドおよび <command>pkg unset-property</command> コマンドを使用します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>be-policy</literal></term>
+<listitem><para>(文字列) パッケージ操作中にいつブート環境が作成されるかを指定します。次の値が許可されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>デフォルトブート環境作成ポリシー <literal>create-backup</literal> を適用します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>always-new</literal></term>
+<listitem><para>次のブート時にアクティブに設定されている新しいブート環境でパッケージ操作を実行するため、すべてのパッケージ操作に対してリブートを必要とします。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。</para>
+<para>このポリシーはもっとも安全ですが、リブートしないとパッケージを追加できないため、ほとんどのサイトの要求よりも厳格です。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>create-backup</literal></term>
+<listitem><para>リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。パッケージが変更されるか、カーネルに影響を及ぼす可能性のある内容がインストールされて、ライブブート環境がこの操作の影響を受ける場合、バックアップブート環境は作成されますが、アクティブには設定されません。バックアップブート環境を明示的にリクエストすることもできます。</para>
+<para>このポリシーは、新しくインストールされたソフトウェアによりシステムが不安定になっている場合にのみ潜在的に危険です。この可能性はありますが、比較的まれです。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>when-required</literal></term>
+<listitem><para>リブートを必要とするパッケージ操作で、新しいブート環境が作成され、次のブート時にアクティブに設定されます。明示的にリクエストされないかぎり、バックアップブート環境は作成されません。</para>
+<para>ライブブート環境へのパッケージ変更によりそれ以上の変更が不可能になる場合、フォールバック可能な最近のブート環境が存在しない可能性があるため、このポリシーには最大の危険が伴います。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>ca-path</literal></term>
+<listitem><para>(文字列) SSL 操作用の CA 証明書が格納されたディレクトリを指すパス名。このディレクトリの形式は、ベースとなる SSL 実装に固有です。信頼できる CA 証明書のために別の場所を使用するには、別のディレクトリを指すようにこの値を変更します。CA ディレクトリの要件については、<literal>SSL_CTX_load_verify_locations</literal>(3openssl) の <literal>CApath</literal> に関する項目を参照してください。</para>
+<para>デフォルト値: <literal>/etc/openssl/certs</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>check-certificate-revocation</literal></term>
+<listitem><para>(ブール型) <literal>True</literal> に設定されている場合、パッケージクライアントは、署名検証のために使用される証明書の CRL 配布ポイントへのアクセスを試み、発行時よりもあとに証明書が失効していないかどうかを調べます。</para>
+<para>デフォルト値: <literal>False</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>content-update-policy</literal></term>
+<listitem><para>(文字列) パッケージング操作中に、パッケージシステムが、編集できないファイルを更新するときに指定します。次の値が許可されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>デフォルトの内容更新ポリシーを常に適用します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>always</literal></term>
+<listitem><para>変更された編集できないファイルを常にダウンロードおよび更新します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>when-required</literal></term>
+<listitem><para>パッケージシステムで更新が必要であると判断された場合にのみ、変更された編集できないファイルをダウンロードおよび更新します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>デフォルト値: <literal>always</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>flush-content-cache-on-success</literal></term>
+<listitem><para>(ブール型) これが <literal>True</literal> に設定されている場合、パッケージクライアントはイメージ変更操作が正常に完了したときに内容キャッシュ内のファイルを削除します。ブート環境を作成する操作の場合は、ソースと出力先の両方のブート環境から内容が削除されます。</para>
+<para>このプロパティーを使用して、ディスク容量の限られたシステムで内容キャッシュを小さく保つことができます。このプロパティーを使用すると、操作が完了するまでの時間が長くなる可能性があります。</para>
+<para>デフォルト値: <literal>True</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mirror-discovery</literal></term>
+<listitem><para>(ブール型) このプロパティーは、mDNS および DNS-SD を使用してリンクローカル内容ミラーを検出するようにクライアントに命令します。このプロパティーを <literal>True</literal> に設定すると、クライアントはミラーを動的に検出し、そのミラーからパッケージ内容のダウンロードを試みます。mDNS を介してその内容を通知するミラーの実行方法については、<command>pkg.depotd</command>(1M) のマニュアルページを参照してください。</para>
+<para>デフォルト値: <literal>False</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>send-uuid</literal></term>
+<listitem><para>(ブール型) ネットワーク操作の実行時にイメージの汎用一意識別子 (UUID) を送信します。ユーザーはこのオプションを無効にできますが、一部のネットワークリポジトリは UUID を供給しないクライアントとのやり取りを拒否する場合があります。</para>
+<para>デフォルト値: <literal>True</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-policy</literal></term>
+<listitem><para>(文字列) イメージ内のパッケージのインストール、更新、修正、または検証時にマニフェストに対してどのチェックが実行されるかを決定します。パッケージに適用される最終的なポリシーは、イメージポリシーと発行元ポリシーの組み合わせに依存します。この組み合わせの厳格さは、少なくとも、この 2 つのポリシーが個別に適用された場合の厳格な方と同じです。デフォルトでは、パッケージクライアントは証明書が失効済みかどうかをチェックしません。そのようなチェック (クライアントから外部インターネットサイトへのアクセスが必要な場合がある) を有効にするには、<literal>check-certificate-revocation</literal> イメージプロパティーを <literal>True</literal> に設定します。次の値が許可されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>ignore</literal></term>
+<listitem><para>すべてのマニフェストの署名を無視します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>verify</literal></term>
+<listitem><para>署名が含まれているすべてのマニフェストが有効に署名されていることを確認しますが、インストール済みパッケージがすべて署名されている必要はありません。これがデフォルト値です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-signatures</literal></term>
+<listitem><para>新しくインストールされたすべてのパッケージに、有効な署名が少なくとも 1 つ含まれている必要があります。インストール済みパッケージに有効な署名が含まれていない場合は、<command>pkg fix</command> および <command>pkg verify</command> コマンドでも警告が表示されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-names</literal></term>
+<listitem><para><literal>require-signatures</literal> と同じ要件に従いますが、<literal>signature-required-names</literal> プロパティーで一覧表示される文字列が、署名の信頼のチェーンを検証するために使用される証明書の共通名としても表示される必要があります。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-required-names</literal></term>
+<listitem><para>(文字列のリスト) パッケージの署名の検証中に、証明書の共通名として表示される必要のある名前の一覧です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>trust-anchor-directory</literal></term>
+<listitem><para>(文字列) イメージの信頼アンカーを格納するディレクトリのパス名です。このパスはイメージに対して相対的です。デフォルト値は <literal>ignore</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>use-system-repo</literal></term>
+<listitem><para>(ブール型) このプロパティーではシステムリポジトリを、イメージおよびパブリッシャー構成のソースとして、および提供されたパブリッシャーと通信するためのプロキシとしてイメージで使用するべきかどうかを指定します。デフォルト値は <literal>False</literal> です。システムリポジトリについては、<command>pkg.sysrepo</command>(1M) のマニュアルページを参照してください。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>パブリッシャープロパティー</title>
+<para>次のプロパティーは、特定の発行元の署名ポリシーを定義します。同じ名前のイメージプロパティーはイメージの署名ポリシーを定義します。特定の発行元のこれらのプロパティーの現在の値を表示するには、<command>pkg publisher</command> <replaceable>publisher_name</replaceable> コマンドを使用します。これらの発行元の署名ポリシープロパティーの値を変更するには、<command>pkg set-publisher</command> コマンドの <option>-set-property</option> オプションと <option>-unset-property</option> オプションを使用します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>signature-policy</literal></term>
+<listitem><para>(文字列) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-required-names</literal></term>
+<listitem><para>(文字列のリスト) このプロパティーの機能は、特定のパブリッシャーからのパッケージのみに適用されることを除いて、同じ名前のイメージプロパティーと同じです。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>パブリッシャーを構成してイメージを作成する</title>
+<para>パブリッシャーを <literal>example.com</literal> として新しいフルイメージを作成し、<literal>/aux0/example_root</literal> に格納します。</para>
+<screen>$ <userinput>pkg image-create -F -p example.com=http://pkg.example.com:10000 &bsol;</userinput>
+<userinput>/aux0/example_root</userinput></screen>
+</example>
+<example id="GLGIN"><title>追加の起点とミラーを指定してイメージを作成する</title>
+<para>パブリッシャーを <literal>example.com</literal> として新しいフルイメージを作成し、1 つのミラーと 2 つの起点を追加し、<literal>/aux0/example_root</literal> に格納します。</para>
+<screen>$ <userinput>pkg image-create -F -p example.com=http://pkg.example.com:10000 &bsol;</userinput>
+<userinput>-g http://alternate1.example.com:10000/ &bsol;</userinput>
+<userinput>-g http://alternate2.example.com:10000/ &bsol;</userinput>
+<userinput>-m http://mirror.example.com:10000/ &bsol;</userinput>
+<userinput>/aux0/example_root</userinput></screen>
+</example>
+<example><title>パブリッシャーを構成せずにイメージを作成する</title>
+<para>パブリッシャーを構成せずに、新しいフルイメージを <literal>/aux0/example_root</literal> に作成します。</para>
+<screen>$ <userinput>pkg image-create -F /aux0/example_root</userinput></screen>
+</example>
+<example><title>パッケージのインストール</title>
+<para><literal>widget</literal> パッケージの最新バージョンを現在のイメージにインストールします。</para>
+<screen>$ <userinput>pkg install application/widget</userinput></screen>
+</example>
+<example><title>パッケージの指定された内容を一覧表示する</title>
+<para><literal>system/file-system/zfs</literal> パッケージの内容を一覧表示します。アクション名、ファイルのモード (定義されている場合)、サイズ (定義されている場合)、パス、およびターゲット (リンクの場合) を表示します。すべてのアクションで利用可能な <literal>action.name</literal> 属性を指定するとすべてのアクションの行が表示されますが、ここでは望ましくないため、<literal>dir</literal>、<literal>file</literal>、<literal>link</literal>、および <literal>hardlink</literal> の各タイプにアクションを限定します。</para>
+<screen>$ <userinput>pkg contents -t dir,file,link,hardlink &bsol;</userinput>
+<userinput>-o action.name,mode,pkg.size,path,target system/file-system/zfs</userinput>
 ACTION.NAME MODE PKG.SIZE PATH                 TARGET
 dir         0755          etc
 dir         0755          etc/fs
@@ -3261,42 +1384,22 @@
 dir         0755          kernel/fs
 dir         0755          kernel/fs/amd64
 hardlink                  kernel/fs/amd64/zfs  ../../../kernel/drv/amd64/zfs
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 6 \fR2 つのパッケージの指定された内容を一覧表示する
-.sp
-.LP
-\fBweb/browser/firefox\fR および \fBmail/thunderbird\fR の内容を一覧表示します。\fBpath\fR 属性の末尾が \fB\&.desktop\fR または \fB\&.png\fR であるアクションのパッケージ名属性およびパス属性のみに表示を限定します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -o pkg.name,path -a path=\e*.desktop \e\fR
-\fB-a path=\e*.png web/browser/firefox mail/thunderbird\fR
+...</screen>
+</example>
+<example><title>2 つのパッケージの指定された内容を一覧表示する</title>
+<para><literal>web/browser/firefox</literal> および <literal>mail/thunderbird</literal> の内容を一覧表示します。<literal>path</literal> 属性の末尾が <filename>.desktop</filename> または <filename>.png</filename> であるアクションのパッケージ名属性およびパス属性のみに表示を限定します。</para>
+<screen>$ <userinput>pkg contents -o pkg.name,path -a path=&bsol;*.desktop &bsol;</userinput>
+<userinput>-a path=&bsol;*.png web/browser/firefox mail/thunderbird</userinput>
 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
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 7 \fRパッケージを検索する
-.sp
-.LP
-パッケージデータベースからトークン \fBbge\fR を検索します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search bge\fR
+...</screen>
+</example>
+<example><title>パッケージを検索する</title>
+<para>パッケージデータベースからトークン <literal>bge</literal> を検索します。</para>
+<screen>$ <userinput>pkg search bge</userinput>
 INDEX       ACTION VALUE                                 PACKAGE
 driver_name driver bge                                   pkg:/driver/network/ethernet/[email protected]
 basename    file   kernel/drv/sparcv9/bge                pkg:/driver/network/ethernet/[email protected]
@@ -3304,81 +1407,36 @@
 basename    file   platform/sun4v/kernel/drv/sparcv9/bge pkg:/system/kernel/[email protected]
 pkg.fmri    set    solaris/driver/network/bge            pkg:/driver/network/[email protected]
 pkg.fmri    set    solaris/driver/network/ethernet/bge   pkg:/driver/network/ethernet/[email protected]
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-このトークンはパッケージ \fBdriver/network/bge\fR 内に、\fB/kernel/drv/\fI arch\fR/bge\fR を表すファイルアクションのベース名として、およびドライバ名として存在します。
-
-.LP
-\fB例 8 \fRファイルの検索
-.sp
-.LP
-先頭のスラッシュ文字を含むファイルのフルパス名を指定して、ファイルを提供するパッケージを検索します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l /usr/bin/vim\fR
+</screen>
+<para>このトークンはパッケージ <literal>driver/network/bge</literal> 内に、<filename>/kernel/drv/<replaceable> arch</replaceable>/bge</filename> を表すファイルアクションのベース名として、およびドライバ名として存在します。</para>
+</example>
+<example id="GMEDQ"><title>ファイルの検索</title>
+<para>先頭のスラッシュ文字を含むファイルのフルパス名を指定して、ファイルを提供するパッケージを検索します。</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l /usr/bin/vim</userinput>
 PATH         PKG.NAME
-usr/bin/vim  editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-\fIaction_name\fR に \fB file\fR を指定し、\fIindex\fR に \fBpath\fR または \fBbasename\fR を指定し、\fItoken\fR に完全または部分的なファイル名を指定することにより、ファイルおよびそのファイルを提供するパッケージを検索します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l file:basename:vim\fR
+usr/bin/vim  editor/vim/vim-core</screen>
+<para><replaceable>action_name</replaceable> に <literal> file</literal> を指定し、<replaceable>index</replaceable> に <literal>path</literal> または <literal>basename</literal> を指定し、<replaceable>token</replaceable> に完全または部分的なファイル名を指定することにより、ファイルおよびそのファイルを提供するパッケージを検索します。</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l file:basename:vim</userinput>
 PATH         PKG.NAME
-usr/bin/vim  editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 9 \fRファイルとディレクトリの検索
-.sp
-.LP
-\fI index\fR に \fBpath\fR または \fBbasename\fR を、\fItoken\fR に完全または部分的なファイル名を指定することにより、ファイルとディレクトリ、およびそれらを提供するパッケージを検索します。使用するシェルによっては、ワイルドカードをエスケープする必要があります。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l path:*/vim\fR
+usr/bin/vim  editor/vim/vim-core</screen>
+</example>
+<example id="GMECW"><title>ファイルとディレクトリの検索</title>
+<para><replaceable> index</replaceable> に <literal>path</literal> または <literal>basename</literal> を、<replaceable>token</replaceable> に完全または部分的なファイル名を指定することにより、ファイルとディレクトリ、およびそれらを提供するパッケージを検索します。使用するシェルによっては、ワイルドカードをエスケープする必要があります。</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l path:*/vim</userinput>
 PATH           PKG.NAME
 usr/bin/vim    editor/vim/vim-core
 usr/share/vim  editor/vim
 usr/share/vim  editor/vim/vim-core
-$ \fBpkg search -o path,pkg.name -l basename:vim\fR
+$ <userinput>pkg search -o path,pkg.name -l basename:vim</userinput>
 PATH           PKG.NAME
 usr/share/vim  editor/vim
 usr/share/vim  editor/vim/vim-core
-usr/bin/vim    editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 10 \fRどのパッケージがどの SMF サービスを提供するかを表示する
-.sp
-.LP
-構造化された検索内で \fIindex\fR に値 \fBorg.opensolaris.smf.fmri\fR を指定し、\fI token\fR に検索対象のサービスの名前を指定することにより、特定の SMF サービスを提供するのはどのパッケージかを表示します。値 \fBorg.opensolaris.smf.fmri\fR は、\fBset\fR アクションの属性の名前です。サービスの名前では、「:」を確実にエスケープしてください。
-
-.sp
-.LP
-たとえば、使用可能な HTTP サーバーを表示するには、\fItoken\fR に値 \fBsvc:/network/http\fR を指定します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search 'org.opensolaris.smf.fmri:svc\e:/network/http*'\fR
+usr/bin/vim    editor/vim/vim-core</screen>
+</example>
+<example id="GMEGA"><title>どのパッケージがどの SMF サービスを提供するかを表示する</title>
+<para>構造化された検索内で <replaceable>index</replaceable> に値 <literal>org.opensolaris.smf.fmri</literal> を指定し、<replaceable> token</replaceable> に検索対象のサービスの名前を指定することにより、特定の SMF サービスを提供するのはどのパッケージかを表示します。値 <literal>org.opensolaris.smf.fmri</literal> は、<literal>set</literal> アクションの属性の名前です。サービスの名前では、「:」を確実にエスケープしてください。</para>
+<para>たとえば、使用可能な HTTP サーバーを表示するには、<replaceable>token</replaceable> に値 <literal>svc:/network/http</literal> を指定します。</para>
+<screen>$ <userinput>pkg search 'org.opensolaris.smf.fmri:svc&bsol;:/network/http*'</userinput>
 INDEX                    ACTION VALUE                        PACKAGE
 org.opensolaris.smf.fmri set    svc:/network/http            pkg:/web/server/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http            pkg:/web/proxy/[email protected]
@@ -3390,636 +1448,281 @@
 org.opensolaris.smf.fmri set    svc:/network/http:privoxy    pkg:/web/proxy/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http:squid      pkg:/web/proxy/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http:tomcat6    pkg:/web/java-servlet/[email protected]
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 11 \fR指定されたパッケージに依存するパッケージを検索する
-.sp
-.LP
-\fBpackage/pkg\fR に依存するインストール済みパッケージを検索します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -l depend::package/pkg\fR
+</screen>
+</example>
+<example><title>指定されたパッケージに依存するパッケージを検索する</title>
+<para><literal>package/pkg</literal> に依存するインストール済みパッケージを検索します。</para>
+<screen>$ <userinput>pkg search -l depend::package/pkg</userinput>
 INDEX       ACTION VALUE                                    PACKAGE
 incorporate depend package/[email protected]      pkg:/consolidation/ips/[email protected]
-require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/library/[email protected]
-require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/library/[email protected]
 require     depend package/pkg                             pkg:/system/zones/brand/[email protected]
 require     depend pkg:/package/[email protected] pkg:/install/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/[email protected]
 require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 12 \fR依存関係を検索する
-.sp
-.LP
-インストール済みパッケージ内のすべての \fBincorporate\fR 依存関係を検索します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -l depend:incorporate:\fR
+</screen>
+</example>
+<example><title>依存関係を検索する</title>
+<para>インストール済みパッケージ内のすべての <literal>incorporate</literal> 依存関係を検索します。</para>
+<screen>$ <userinput>pkg search -l depend:incorporate:</userinput>
 INDEX       ACTION VALUE                                PACKAGE
 incorporate depend pkg:/[email protected]  pkg:/consolidation/osnet/[email protected]
 incorporate depend pkg:/[email protected] pkg:/consolidation/osnet/[email protected]
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 13 \fR発行元を追加
-.sp
-.LP
-新しいパブリッシャー \fBexample.com\fR を追加し、リポジトリの場所を \fBhttp://www.example.com/repo\fR に設定します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g http://www.example.com/repo example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 14 \fR鍵と証明書を指定してパブリッシャーを追加する
-.sp
-.LP
-新しいパブリッシャー \fBexample.com\fR を追加し、セキュリティー保護されたリポジトリの場所を \fBhttps://secure.example.com/repo\fR に設定し、鍵および証明書をディレクトリ \fB/root/creds\fR に格納します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -k /root/creds/example.key \e\fR
-\fB-c /root/creds/example.cert -g https://secure.example.com/repo \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 15 \fRパブリッシャーを追加して自動構成する
-.sp
-.LP
-自動構成を使用して新しいパブリッシャーを追加し、リポジトリの場所を \fB/export/repo\fR に構成します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -p /export/repo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 16 \fRパブリッシャーを追加して手動構成する
-.sp
-.LP
-手動構成を使用して新しいパブリッシャー \fBexample.com\fR を追加し、リポジトリの場所を \fB/export/repo/example.com\fR に構成します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g /export/repo example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 17 \fR発行元を追加してプロキシを構成する
-.sp
-.LP
-起点 \fBhttp://server/repo \fR とプロキシ \fBhttp://webcache:8080\fR を使用して新しい発行元 \fBmypub\fR を追加します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g http://server/repo \e\fR
-\fB--proxy http://webcache:8080 mypub\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 18 \fRすべての署名付きパッケージを検証する
-.sp
-.LP
-すべての署名付きパッケージを検証するようにイメージを構成します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-property signature-policy verify\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 19 \fRすべてのパッケージで署名を必須にする
-.sp
-.LP
-すべてのパッケージで署名を必須とするように、また、いずれかの証明書で文字列 \fBexample.com\fR が共通名として信頼チェーンに出現することを必須とするようにイメージを構成します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-property signature-policy require-names example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 20 \fR指定したパブリッシャーからのすべてのパッケージで署名を必須にする
-.sp
-.LP
-パブリッシャー \fBexample.com\fR からインストールされるすべてのパッケージで署名を必須とするようにイメージを構成します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --set-property signature-policy=require-signatures \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 21 \fR信頼チェーンで指定された文字列を必須にする
-.sp
-.LP
-有効とみなされるために署名の信頼チェーンに存在する必要がある文字列 \fBfoo\fR をイメージの共通名の一覧に追加します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg add-property-value signature-require-names foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 22 \fR指定されたパブリッシャーの信頼チェーンから文字列を削除する
-.sp
-.LP
-パブリッシャー \fBexample.com\fR の署名を検証するために存在する必要がある文字列 \fBfoo\fR を共通名の一覧から削除します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --remove-property-value signature-require-names=foo \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 23 \fR信頼できる CA 証明書を追加する
-.sp
-.LP
-\fB/tmp/example_file.pem\fR に格納された証明書を、パブリッシャー \fBexample.com\fR の信頼できる CA 証明書として追加します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --approve-ca-cert /tmp/example_file.pem \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 24 \fR証明書を失効させる
-.sp
-.LP
-\fBa12345\fR というハッシュを持つ、パブリッシャー \fBexample.com\fR 用の証明書を失効させ、\fBexample.com\fR からのパッケージの署名をその証明書で検証しないようにします。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --revoke-ca-cert a12345 example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 25 \fR証明書を抹消する
-.sp
-.LP
-証明書 \fBa12345\fR がユーザーによって追加または失効させられたことを \fBpkg\fR から抹消します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --unset-ca-cert a12345 example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 26 \fRパッケージをダウングレードする
-.sp
-.LP
-インストール済みパッケージ \[email protected]\fR を古いバージョンにダウングレードします。
-
-.sp
-.in +2
-.nf
-$ \fBpkg update [email protected]\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 27 \fR競合するパッケージインストールを切り替える
-.sp
-.LP
-2 つのパッケージが競合している場合に、どちらのパッケージがインストールされるかを切り替えます。パッケージ A がパッケージ B または C のどちらかに依存し、B および C は相互排他であるとします。A と B がインストールされる場合に、次のコマンドを使用して、A をアンインストールせずに B の代わりに C を使用するように切り替えます。
-
-.sp
-.in +2
-.nf
-$ \fBpkg install --reject B C\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 28 \fRパッケージアーカイブ内のパッケージを一覧表示する
-.sp
-.LP
-パッケージアーカイブ内のすべてのパッケージのすべてのバージョンを一覧表示します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg list -f -g /my/archive.p5p\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 29 \fRパッケージリポジトリ内のパッケージを一覧表示する
-.sp
-.LP
-リポジトリ内のすべてのパッケージのすべてのバージョンを一覧表示します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg list -f -g http://example.com:10000\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 30 \fRパッケージアーカイブ内のパッケージについての情報を表示する
-.sp
-.LP
-パッケージアーカイブ内のパッケージの最新バージョンのパッケージ情報を表示します。パッケージが現在インストールされていてもいなくてもかまいません。
-
-.sp
-.in +2
-.nf
-$ \fBpkg info -g /my/archive.p5p pkg_name\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 31 \fRパッケージアーカイブ内のパッケージの内容を表示する
-.sp
-.LP
-パッケージアーカイブ内のパッケージの内容を表示します。パッケージは現在インストールされていません。
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -g /my/archive.p5p pkg_name\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 32 \fRパブリッシャーの起点とミラーをすべて削除する
-.sp
-.LP
-パブリッシャーのすべての起点およびミラーを削除し、新しい起点を追加します。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -G '*' -M '*' -g http://example.com:10000 \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.SH 環境
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_IMAGE\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージ操作に使用するイメージが含まれるディレクトリ。\fB-R\fR を指定した場合は無視されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_CONNECT_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-トランスポート操作中に接続しようとするのを待機する秒数 (試行ごと)。これが経過するとクライアントは操作を中止します。値 0 は無制限に待機することを意味します。
-.sp
-デフォルト値: 60
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_LOWSPEED_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-クライアントが操作を中止するまでの、トランスポート操作中に \fBlowspeed\fR 制限 (1024 バイト/秒) を下回っていられる秒数。値 0 は、操作を中止しないことを意味します。
-.sp
-デフォルト値: 30
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_CONSECUTIVE_ERROR\fR\fR
-.ad
-.sp .6
-.RS 4n
-一時的なトランスポートエラーの最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。
-.sp
-デフォルト値: 4
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_REDIRECT\fR\fR
-.ad
-.sp .6
-.RS 4n
-トランスポート操作中に許可される HTTP または HTTPS リダイレクトの最大数。これを上回ると接続が中止されます。値 0 は、操作を中止しないことを意味します。
-.sp
-デフォルト値: 5
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CONCURRENCY\fR\fR
-.ad
-.sp .6
-.RS 4n
-同時に更新する子イメージの数。\fB-C\fR オプションが指定されている場合には、無視されます。
-.sp
-子イメージ (通常はインストールされている \fBsolaris\fR ブランドの非大域ゾーン) 内への再帰時に、最大 \fB$PKG_CONCURRENCY \fR 個の子イメージを同時に更新します。\fB$PKG_CONCURRENCY\fR が 0 または負数の場合は、すべての子イメージが同時に更新されます。
-.sp
-デフォルト値: 1
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-ホストあたりのトランスポート試行の最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。
-.sp
-デフォルト値: 4
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhttp_proxy\fR、\fBhttps_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-HTTP または HTTPS プロキシサーバー。
-.RE
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-複数の操作が要求されましたが、それらの一部のみが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB4\fR\fR
-.ad
-.RS 6n
-.rt  
-変更が行われませんでした - 何もしません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB5\fR\fR
-.ad
-.RS 6n
-.rt  
-要求された操作はライブイメージでは実行できません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB6\fR\fR
-.ad
-.RS 6n
-.rt  
-インストールまたは更新中のパッケージのライセンスが受け入れられなかったため、要求された操作を完了できません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB7\fR\fR
-.ad
-.RS 6n
-.rt  
-イメージは現在別のプロセスによって使用されているため、変更できません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB8\fR\fR
-.ad
-.RS 6n
-.rt  
-1 つ以上の SMF アクチュエータがタイムアウトしました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH ファイル
-.sp
-.LP
-\fBpkg\fR(5) イメージは、より大きなファイルシステム内の任意の場所に置くことができます。次のファイル説明で、トークン \fB$IMAGE_ROOT\fR は相対パスを区別するために使用されています。一般的なシステムインストールでは、\fB $IMAGE_ROOT\fR は \fB/\fR と等価です。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-完全または部分的なイメージのメタデータディレクトリ。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーイメージのメタデータディレクトリ。
-.RE
-
-.sp
-.LP
-特定のイメージのメタデータ内のファイルやディレクトリによっては、修復および復旧中に役立つ情報が含まれている可能性があります。トークン \fB$IMAGE_META\fR は、メタデータが含まれる最上位ディレクトリを参照します。\fB$IMAGE_META\fR は通常、上に示した 2 つのパスのいずれかです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/lost+found\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージ操作中に移動された、競合するディレクトリおよびファイルの場所。削除されたディレクトリのパッケージ化されない内容の場所。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-パブリッシャーごとに 1 つのディレクトリが含まれます。各ディレクトリにはパブリッシャー固有のメタデータが格納されます。
-.RE
-
-.sp
-.LP
-\fB$IMAGE_META\fR ディレクトリ階層内のほかのパスは非公開であり、変更される可能性があります。
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkgsend\fR(1), \fBbeadm\fR(1M), \fBpkg.depotd\fR(1M), \fBpkg.sysrepo\fR(1M), \fBglob\fR(3C), \fBpkg\fR(5)
-.sp
-.LP
-\fI『Adding and Updating Software in Oracle Solaris 11.2 』\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
+...</screen>
+</example>
+<example><title>発行元を追加</title>
+<para>新しいパブリッシャー <literal>example.com</literal> を追加し、リポジトリの場所を <literal>http://www.example.com/repo</literal> に設定します。</para>
+<screen>$ <userinput>pkg set-publisher -g http://www.example.com/repo example.com</userinput></screen>
+</example>
+<example><title>鍵と証明書を指定してパブリッシャーを追加する</title>
+<para>新しいパブリッシャー <literal>example.com</literal> を追加し、セキュリティー保護されたリポジトリの場所を <literal>https://secure.example.com/repo</literal> に設定し、鍵および証明書をディレクトリ <literal>/root/creds</literal> に格納します。</para>
+<screen>$ <userinput>pkg set-publisher -k /root/creds/example.key &bsol;</userinput>
+<userinput>-c /root/creds/example.cert -g https://secure.example.com/repo &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>パブリッシャーを追加して自動構成する</title>
+<para>自動構成を使用して新しいパブリッシャーを追加し、リポジトリの場所を <literal>/export/repo</literal> に構成します。</para>
+<screen>$ <userinput>pkg set-publisher -p /export/repo</userinput></screen>
+</example>
+<example><title>パブリッシャーを追加して手動構成する</title>
+<para>手動構成を使用して新しいパブリッシャー <literal>example.com</literal> を追加し、リポジトリの場所を <literal>/export/repo/example.com</literal> に構成します。</para>
+<screen>$ <userinput>pkg set-publisher -g /export/repo example.com</userinput></screen>
+</example>
+<example id="GMFJM"><title>発行元を追加してプロキシを構成する</title>
+<para>起点 <literal>http://server/repo </literal> とプロキシ <literal>http://webcache:8080</literal> を使用して新しい発行元 <literal>mypub</literal> を追加します。</para>
+<screen>$ <userinput>pkg set-publisher -g http://server/repo &bsol;</userinput>
+<userinput>--proxy http://webcache:8080 mypub</userinput></screen>
+</example>
+<example><title>すべての署名付きパッケージを検証する</title>
+<para>すべての署名付きパッケージを検証するようにイメージを構成します。</para>
+<screen>$ <userinput>pkg set-property signature-policy verify</userinput></screen>
+</example>
+<example><title>すべてのパッケージで署名を必須にする</title>
+<para>すべてのパッケージで署名を必須とするように、また、いずれかの証明書で文字列 <literal>example.com</literal> が共通名として信頼チェーンに出現することを必須とするようにイメージを構成します。</para>
+<screen>$ <userinput>pkg set-property signature-policy require-names example.com</userinput></screen>
+</example>
+<example><title>指定したパブリッシャーからのすべてのパッケージで署名を必須にする</title>
+<para>パブリッシャー <literal>example.com</literal> からインストールされるすべてのパッケージで署名を必須とするようにイメージを構成します。</para>
+<screen>$ <userinput>pkg set-publisher --set-property signature-policy=require-signatures &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>信頼チェーンで指定された文字列を必須にする</title>
+<para>有効とみなされるために署名の信頼チェーンに存在する必要がある文字列 <literal>foo</literal> をイメージの共通名の一覧に追加します。</para>
+<screen>$ <userinput>pkg add-property-value signature-require-names foo</userinput></screen>
+</example>
+<example><title>指定されたパブリッシャーの信頼チェーンから文字列を削除する
+</title>
+<para>パブリッシャー <literal>example.com</literal> の署名を検証するために存在する必要がある文字列 <literal>foo</literal> を共通名の一覧から削除します。</para>
+<screen>$ <userinput>pkg set-publisher --remove-property-value signature-require-names=foo &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>信頼できる CA 証明書を追加する</title>
+<para><literal>/tmp/example_file.pem</literal> に格納された証明書を、パブリッシャー <literal>example.com</literal> の信頼できる CA 証明書として追加します。</para>
+<screen>$ <userinput>pkg set-publisher --approve-ca-cert /tmp/example_file.pem &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>証明書を失効させる</title>
+<para><literal>a12345</literal> というハッシュを持つ、パブリッシャー <literal>example.com</literal> 用の証明書を失効させ、<literal>example.com</literal> からのパッケージの署名をその証明書で検証しないようにします。</para>
+<screen>$ <userinput>pkg set-publisher --revoke-ca-cert a12345 example.com</userinput></screen>
+</example>
+<example><title>証明書を抹消する</title>
+<para>証明書 <literal>a12345</literal> がユーザーによって追加または失効させられたことを <command>pkg</command> から抹消します。</para>
+<screen>$ <userinput>pkg set-publisher --unset-ca-cert a12345 example.com</userinput></screen>
+</example>
+<example><title>パッケージをダウングレードする</title>
+<para>インストール済みパッケージ <literal>[email protected]</literal> を古いバージョンにダウングレードします。</para>
+<screen>$ <userinput>pkg update [email protected]</userinput></screen>
+</example>
+<example><title>競合するパッケージインストールを切り替える</title>
+<para>2 つのパッケージが競合している場合に、どちらのパッケージがインストールされるかを切り替えます。パッケージ A がパッケージ B または C のどちらかに依存し、B および C は相互排他であるとします。A と B がインストールされる場合に、次のコマンドを使用して、A をアンインストールせずに B の代わりに C を使用するように切り替えます。</para>
+<screen>$ <userinput>pkg install --reject B C</userinput></screen>
+</example>
+<example><title>パッケージアーカイブ内のパッケージを一覧表示する</title>
+<para>パッケージアーカイブ内のすべてのパッケージのすべてのバージョンを一覧表示します。</para>
+<screen>$ <userinput>pkg list -f -g /my/archive.p5p</userinput></screen>
+</example>
+<example><title>パッケージリポジトリ内のパッケージを一覧表示する</title>
+<para>リポジトリ内のすべてのパッケージのすべてのバージョンを一覧表示します。</para>
+<screen>$ <userinput>pkg list -f -g http://example.com:10000</userinput></screen>
+</example>
+<example><title>パッケージアーカイブ内のパッケージについての情報を表示する</title>
+<para>パッケージアーカイブ内のパッケージの最新バージョンのパッケージ情報を表示します。パッケージが現在インストールされていてもいなくてもかまいません。</para>
+<screen>$ <userinput>pkg info -g /my/archive.p5p pkg_name</userinput></screen>
+</example>
+<example><title>パッケージアーカイブ内のパッケージの内容を表示する</title>
+<para>パッケージアーカイブ内のパッケージの内容を表示します。パッケージは現在インストールされていません。</para>
+<screen>$ <userinput>pkg contents -g /my/archive.p5p pkg_name</userinput></screen>
+</example>
+<example><title>パブリッシャーの起点とミラーをすべて削除する</title>
+<para>パブリッシャーのすべての起点およびミラーを削除し、新しい起点を追加します。</para>
+<screen>$ <userinput>pkg set-publisher -G '*' -M '*' -g http://example.com:10000 &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>イメージをデハイドレートおよびリハイドレートする</title>
+<para>次の例で、<literal>/tmp/test_image</literal> はデハイドレートおよびリハイドレートしようとしているイメージです。</para>
+<para>パブリッシャーが指定されていないため、次のコマンドは <literal>/tmp/test_image</literal> イメージ内で有効になっているすべてのパブリッシャーに対して処理を実行し、<literal>/tmp/test_image</literal> イメージを完全にデハイドレートします。</para>
+<screen>$ <userinput>pkg -R /tmp/test_image dehydrate</userinput></screen>
+<para>パブリッシャーが指定されていないため、次のコマンドは <literal>/tmp/test_image</literal> イメージ内に構成されているすべてのパブリッシャーに対して処理を実行し、<literal>/tmp/test_image</literal> イメージを完全に復元します。</para>
+<screen>$ <userinput>pkg -R /tmp/test_image rehydrate</userinput></screen>
+</example>
+<example><title>パブリッシャーを指定してイメージをデハイドレートおよびリハイドレートする</title>
+<para>次の例で、<literal>/tmp/test_image</literal> はデハイドレートおよびリハイドレートしようとしているイメージです。<literal>test1</literal> および <literal>test2</literal> は <literal>/tmp/test_image</literal> イメージ内で有効になっているパブリッシャーで、その起点からは必要な内容が提供されます。</para>
+<para>次のコマンドは、<literal>test1</literal> パブリッシャーから提供されたファイルおよびハードリンクに対してのみ処理を実行します。</para>
+<screen>$ <userinput>pkg -R /tmp/test_image dehydrate -p test1</userinput></screen>
+<para>次のコマンドは、<literal>test1</literal> パブリッシャーから提供されたファイルおよびハードリンクだけをリハイドレートします。</para>
+<screen>$ <userinput>pkg -R /tmp/test_image rehydrate -p test1</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><envar>PKG_IMAGE</envar></term>
+<listitem><para>パッケージ操作に使用するイメージが含まれるディレクトリ。<option>R</option> を指定した場合は無視されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_CONNECT_TIMEOUT</envar></term>
+<listitem><para>トランスポート操作中に接続しようとするのを待機する秒数 (試行ごと)。これが経過するとクライアントは操作を中止します。値 0 は無制限に待機することを意味します。</para>
+<para>デフォルト値: 60</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_LOWSPEED_TIMEOUT</envar></term>
+<listitem><para>クライアントが操作を中止するまでの、トランスポート操作中に <literal>lowspeed</literal> 制限 (1024 バイト/秒) を下回っていられる秒数。値 0 は、操作を中止しないことを意味します。</para>
+<para>デフォルト値: 30</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_CONSECUTIVE_ERROR</envar></term>
+<listitem><para>一時的なトランスポートエラーの最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。</para>
+<para>デフォルト値: 4</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_REDIRECT</envar></term>
+<listitem><para>トランスポート操作中に許可される HTTP または HTTPS リダイレクトの最大数。これを上回ると接続が中止されます。値 0 は、操作を中止しないことを意味します。</para>
+<para>デフォルト値: 5</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CONCURRENCY</envar></term>
+<listitem><para>同時に更新する子イメージの数。<option>C</option> オプションが指定されている場合には、無視されます。</para>
+<para>子イメージ (通常はインストールされている <literal>solaris</literal> ブランドの非大域ゾーン) 内への再帰時に、最大 <envar>$PKG_CONCURRENCY </envar> 個の子イメージを同時に更新します。<envar>$PKG_CONCURRENCY</envar> が 0 または負数の場合は、すべての子イメージが同時に更新されます。</para>
+<para>デフォルト値: 1</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_TIMEOUT</envar></term>
+<listitem><para>ホストあたりのトランスポート試行の最大数。これを上回るとクライアントは操作を中止します。値 0 は、操作を中止しないことを意味します。</para>
+<para>デフォルト値: 4</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>http_proxy</envar>、<envar>https_proxy</envar></term>
+<listitem><para>HTTP または HTTPS プロキシサーバー。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>複数の操作が要求されましたが、それらの一部のみが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>4</returnvalue></term>
+<listitem><para>変更が行われませんでした - 何もしません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>5</returnvalue></term>
+<listitem><para>要求された操作はライブイメージでは実行できません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>6</returnvalue></term>
+<listitem><para>インストールまたは更新中のパッケージのライセンスが受け入れられなかったため、要求された操作を完了できません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>7</returnvalue></term>
+<listitem><para>イメージは現在別のプロセスによって使用されているため、変更できません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>8</returnvalue></term>
+<listitem><para>1 つ以上の SMF アクチュエータがタイムアウトしました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para><literal>pkg</literal>(5) イメージは、より大きなファイルシステム内の任意の場所に置くことができます。次のファイル説明で、トークン <envar>$IMAGE_ROOT</envar> は相対パスを区別するために使用されています。一般的なシステムインストールでは、<envar> $IMAGE_ROOT</envar> は <literal>/</literal> と等価です。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>完全または部分的なイメージのメタデータディレクトリ。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>ユーザーイメージのメタデータディレクトリ。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>特定のイメージのメタデータ内のファイルやディレクトリによっては、修復および復旧中に役立つ情報が含まれている可能性があります。トークン <envar>$IMAGE_META</envar> は、メタデータが含まれる最上位ディレクトリを参照します。<envar>$IMAGE_META</envar> は通常、上に示した 2 つのパスのいずれかです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_META/lost+found</filename></term>
+<listitem><para>パッケージ操作中に移動された、競合するディレクトリおよびファイルの場所。削除されたディレクトリのパッケージ化されない内容の場所。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/publisher</filename></term>
+<listitem><para>パブリッシャーごとに 1 つのディレクトリが含まれます。各ディレクトリにはパブリッシャー固有のメタデータが格納されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><envar>$IMAGE_META</envar> ディレクトリ階層内のほかのパスは非公開であり、変更される可能性があります。</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="beadm-1m"><citerefentry><refentrytitle>beadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.sysrepo-1m"><citerefentry><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <literal>glob</literal>(3C), <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="AUOSS"><citetitle remap="book">Adding and Updating Software in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
--- a/src/man/ja_JP/pkg.5	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkg.5	Wed Jul 01 10:45:55 2015 -0700
@@ -1,1627 +1,743 @@
-'\" te
-.\" Copyright (c) 2009, 2014, Oracle and/or its affiliates.All rights reserved.
-.TH pkg 5 "2014 年 4 月 10 日" "SunOS 5.11" "標準、環境、マクロ"
-.SH 名前
-pkg \- Image Packaging System
-.SH 機能説明
-.sp
-.LP
-Image Packaging System、\fBpkg\fR(5) は、ソフトウェアのライフサイクル管理 (インストール、アップグレード、および削除) のために提供されるフレームワークです。Image Packaging System は、一連のキーと値のペアおよび (場合によっては) データペイロードで定義されたアクションのコレクションである、パッケージの単位でソフトウェアを管理します。多くの場合、アクションはファイルシステム内に存在するファイルですが、ドライバ、サービス、ユーザーなどのその他のインストール可能オブジェクトも表します。
-.SH パッケージの FMRI とバージョン
-.sp
-.LP
-各パッケージは、スキーム \fBpkg:\fR を使用して、障害管理リソース識別子 (FMRI) によって表されます。パッケージの完全な FMRI は、次の形式のスキーム、パブリッシャー、パッケージ名、およびバージョン文字列で構成されます。
-.sp
-.in +2
-.nf
-pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-\fBsolaris\fR は発行元です。\fBsystem/library/c++-runtime\fR はパッケージ名です。名前空間は階層的であり、その深さは任意ですが、適用される包含関係は存在しません。名前は基本的に任意です。発行元情報はオプションですが、存在する場合は \fBpkg://\fR を前に付ける必要があります。パブリッシャーを含む FMRI は、しばしば「完全修飾」されていると言われます。パブリッシャー情報が存在しない場合、通常はパッケージ名の前に \fBpkg:/\fR が付けられます。
-.sp
-.LP
-クライアントをパッケージ化すると、通常、FMRI にパブリッシャー情報が含まれていない場合に FMRI のスキームを省略できます。たとえば、\fBpkg:/system/library/c++-runtime\fR は \fBsystem/library/c++-runtime\fR と書くことができます。スキームが省略される場合、クライアントは照合の目的で、パッケージ名の最後のコンポーネントを除くすべてのコンポーネントを省略することもできます。たとえば、\fBsystem/library/c++-runtime\fR は \fBlibrary/c++-runtime\fR または \fBc++-runtime\fR と書くことができ、これらは \fBc++-runtime\fR という名前のパッケージまたは \fB/c++-runtime\fR で終わるパッケージ名に一致します。
-.sp
-.LP
-パブリッシャーの名前によって、人、人のグループ、または組織が 1 つ以上のパッケージのソースとして識別されます。パブリッシャーの名前の競合を避け、パブリッシャーを識別しやすくするために、パッケージを公開するエンティティーを表すドメイン名をパブリッシャーの名前として使用することがベストプラクティスです。
-.sp
-.LP
-パッケージ名のあとに、アットマーク記号 (@) で区切られたバージョンが続きます。バージョンは、句読文字で区切られた 4 つの数字の並びで構成されます。最初の 3 つの並びに含まれる要素はドットで区切られ、これらの並びの長さは任意です。バージョンコンポーネント内の先頭のゼロ (たとえば、01.1 または 1.01) は許可されません。末尾のゼロ (たとえば、1.10) は許可されます。
-.sp
-.LP
-バージョンの最初の部分はコンポーネントバージョンです。オペレーティングシステムに緊密に結合されたコンポーネントの場合、これは通常、そのバージョンのオペレーティングシステムでの \fBuname -r\fR の値です。独自の開発ライフサイクルを持つコンポーネントの場合、この並びはドットで区切られたリリース番号 (2.4.10 など) です。
-.sp
-.LP
-バージョンの 2 番目の部分 (存在する場合はコンマ (,) に続いている必要があります) はビルドバージョンです。ビルドバージョンは、パッケージの内容が構築されたオペレーティングシステムのバージョンを指定し、その内容が正常に実行されることを予測できるオペレーティングシステムのバージョンに関する最小の境界が提供されます。
-.sp
-.LP
-バージョンの 3 番目の部分 (存在する場合はハイフン (\fB-\fR) に続いている必要があります) はブランチバージョンです。ブランチバージョンは、ベンダー固有の情報を提供するバージョン管理コンポーネントです。ブランチバージョンは、コンポーネントバージョンとは独立に、パッケージ化のメタデータが変更されたときに 1 増やすことができます。ブランチバージョンには、ビルド番号やその他の情報が含まれていることがあります。
-.sp
-.LP
-バージョンの 4 番目の部分 (存在する場合はコロン (:) に続いている必要があります) はタイムスタンプです。タイムスタンプは、そのパッケージがいつ公開されたかを表します。
-.sp
-.LP
-バージョン間の比較を実行する場合、その左側にあるコンポーネントが同じでないかぎり、バージョン全体のコンポーネントは考慮されません。したがって、\fB4.3\fR が \fB4.2\fR より大きいため、\fB4.3-1\fR は \fB4.2-7\fR より大きく、\fB3\fR が \fB1\fR より大きいため、\fB4.3-3\fR は \fB4.3-1\fR より大きくなります。
-.sp
-.LP
-\fBpkg.human-version\fR 属性は、人間が読むことのできるバージョンの文字列を表示するために使用できます。\fBpkg.human-version\fR 属性の値は、パッケージ FMRI の前述のパッケージバージョンに追加して指定できますが、パッケージ FMRI バージョンを置き換えることはできません。人間が読むことのできるバージョンの文字列は、表示目的でのみ使用されます。詳細は、「設定アクション」を参照してください。
-.sp
-.LP
-システムの多くの部分では、表示される情報量や必要な情報量を減らすために、必要に応じて FMRI を表示するときには短縮し、入力も短い形式を受け入れます。通常、スキーム、パブリッシャー、ビルドバージョン、およびタイムスタンプは省略できます。すべてのバージョン管理情報を省略できることもあります。
-.SH アクション
-.sp
-.LP
-アクションはシステム上のインストール可能オブジェクトを表します。アクションはパッケージのマニフェストに記述されます。すべてのアクションは、最初に名前とキー属性を含みます。また、これらはバージョン履歴をたどる過程で一意のオブジェクトを参照します。アクションには、このほかの属性も含まれます。一部の属性は、パッケージシステムによって直接解釈されます。その他の属性は、システム管理者またはエンドユーザーにのみ役立つ可能性があります。
-.sp
-.LP
-アクションには、次の単純なテキスト表現があります。
-.sp
-.in +2
-.nf
-\fIaction_name\fR \fIattribute1\fR=\fIvalue1\fR \fIattribute2\fR=\fIvalue2\fR ...
-.fi
-.in -2
-
-.sp
-.LP
-属性の名前に、空白、引用符、または等号 (=) を含めることはできません。最初の等号のあとの文字はすべて、値に属します。値にはすべての文字を含めることができますが、スペースは単一引用符または二重引用符で囲む必要があります。二重引用符で囲まれている文字列の内部で単一引用符をエスケープする必要はなく、単一引用符で囲まれている文字列の内部で二重引用符をエスケープする必要はありません。引用符の前にバックスラッシュ (\) 文字を付けて、引用文字列が終了しないようにすることができます。バックスラッシュは、バックスラッシュでエスケープできます。
-.sp
-.LP
-アクションは複数の属性を含むことができます。一部の属性は、単一のアクションに対して異なる値を使用して、複数回名前を付けることができます。同じ名前を持つ複数の属性は、順序付けされていないリストとして扱われます。
-.sp
-.LP
-多くの属性を持つアクションによって、マニフェストファイル内に長い行が作成されることがあります。このような行は、不完全な各行をバックスラッシュで終了することにより折り返すことができます。この継続文字は、属性と値のペアの間に置く必要があることに注意してください。属性も、その値も、さらにその組み合わせも分割することはできません。
-.sp
-.LP
-下に示されている属性セットは、これがすべてではありません。実際、アクションに付加できる属性は任意であるため、標準の属性セットは、将来の開発を実装するために容易に拡張できます。
-.sp
-.LP
-一部の属性によって、パッケージングコンテキストの外部で追加の操作が実行されます。これらの属性は、下の「アクチュエータ」のセクションで説明されています。
-.SS "ファイルアクション"
-.sp
-.LP
-\fBfile\fR アクションは、通常ファイルを表します。\fBfile\fR アクションはペイロードを参照し、次の 4 つの標準属性があります。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpath\fR\fR
-.ad
-.RS 10n
-.rt  
-ファイルがインストールされているファイルシステムのパス。これは \fBfile\fR アクションのキー属性です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmode\fR\fR
-.ad
-.RS 10n
-.rt  
-ファイルのアクセス権 (数値形式)。これらは ACL ではなく、単純なアクセス権のみです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBowner\fR\fR
-.ad
-.RS 10n
-.rt  
-ファイルを所有するユーザーの名前。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR \fR
-.ad
-.RS 10n
-.rt  
-ファイルを所有するグループの名前。
-.RE
-
-.sp
-.LP
-ペイロードは、名前が付けられないという点で位置属性です。これは、アクション名のあとの最初の単語です。公開されたマニフェストでは、これはファイルの内容の \fBSHA-1\fR ハッシュです。これから公開する必要のあるマニフェスト内に存在する場合は、ペイロードを見つけることのできるパスを表します。\fBpkgsend\fR(1) を参照してください。値に等号が含まれている場合は、位置属性の代わりにハッシュ属性を使用できます。この両方を同じアクションで使用できます。ただし、ハッシュは同じである必要があります。
-.sp
-.LP
-\fBpreserve\fR 属性および \fBoverlay\fR 属性は、\fBfile\fR アクションがインストールされるかどうか、およびその方法に影響を及ぼします。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpreserve\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージ操作中にファイルを保持する時期と方法を指定します。
-.sp
-パッケージが最初にインストールされるとき、パッケージによって提供されるファイルが持つ \fBpreserve\fR 属性が何らかの値で定義されており、ファイルがイメージ内にすでに存在する場合、既存のファイルが \fB/var/pkg/lost+found\fR に格納され、パッケージされたファイルはインストールされます。
-.sp
-パッケージが最初にインストールされるとき、パッケージによって提供されるファイルの \fBpreserve\fR 属性が定義済みで、ファイルがイメージ内に存在しない場合、ファイルがインストールされるかどうかは \fBpreserve\fR 属性の値によって決まります。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBpreserve\fR の値が \fBlegacy\fR である場合、パッケージされたファイルはインストールされません。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBpreserve\fR の値が \fBlegacy\fR でない場合、パッケージされたファイルはインストールされます。
-.RE
-パッケージがダウングレードされるとき、ダウングレードされるバージョンのパッケージによって提供されるファイルの \fBpreserve\fR 属性が何らかの値で定義されており、次のすべての条件が真の場合、イメージ内に現在存在するファイルは拡張子 \fB\&.update\fR で名前変更され、ダウングレードされたパッケージからのファイルがインストールされます。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ファイルがイメージ内に存在する。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ダウングレードされるバージョンのパッケージによって提供されるファイルの内容が、現在インストールされているバージョンのパッケージによって提供されるファイルの内容と異なる。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ダウングレードされるバージョンのパッケージによって提供されるファイルの内容が、イメージ内に存在するファイルの内容と異なる。
-.RE
-上の条件のいずれかが真でない場合、このファイルは、パッケージがダウングレードでなくアップグレードされる場合と同様に処理されます。
-.sp
-パッケージがアップグレードされるとき、アップグレードされるバージョンのパッケージによって提供される \fBfile\fR アクションの \fBpreserve\fR 属性が何らかの値で定義されており、\fBfile\fR アクションが、現在インストールされているバージョンのパッケージによって提供される \fBfile\fR アクションと同じである場合、ファイルはインストールされず、イメージ内に存在するファイルは変更されません。以前のバージョンをインストールしたあとに加えられたすべての変更が保持されます。
-.sp
-パッケージがアップグレードされるとき、アップグレードされるバージョンのパッケージによって提供される \fBfile\fR アクションの \fBpreserve\fR 属性が定義済みで、\fBfile\fR アクションが新しいか、現在インストールされているバージョンのパッケージによって提供される \fBfile\fR アクションとは異なる場合、アップグレードは次の方法で実行されます。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-イメージ内にファイルが存在しない場合は、新しいファイルがインストールされます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、現在インストール済みのバージョンのパッケージ内に存在せず、\fBoriginal_name\fR 属性 (以下を参照) を使用した名前変更または移動を行わなかった場合、既存のファイルは \fB/var/pkg/lost+found\fR に格納され、アップグレードされたバージョンのパッケージによって提供されるファイルがインストールされます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、現在インストール済みのバージョンのパッケージによって提供されるファイルと内容が異なる場合、アップグレードは \fBpreserve\fR 属性の値に従って実行されます。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アップグレードされるバージョンのパッケージによって提供されるファイルの \fBpreserve\fR 値が \fBrenameold\fR の場合、既存のファイルは拡張子 \fB\&.old\fR を使用して名前変更され、新しいファイルは更新されたアクセス権およびタイムスタンプ (存在する場合) を使用してインストールされます。下の \fBtimestamp\fR 属性の説明を参照してください。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アップグレードされるバージョンのパッケージによって提供されるファイルの \fBpreserve\fR 値が \fBrenamenew\fR の場合、新しいファイルは拡張子 \fB\&.new\fR を使用してインストールされ、既存のファイルは変更されません。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アップグレードされるバージョンのパッケージによって提供されるファイルの \fBpreserve\fR 値が \fBtrue\fR の場合、新しいファイルはインストールされませんが、既存のファイルのアクセス権およびタイムスタンプ (存在する場合) がリセットされます。
-.RE
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、現在インストール済みのバージョンのパッケージによって提供されるファイルと同じ内容を持ち、\fBpreserve\fR 値が \fBrenameold\fR または \fBrenamenew\fR の場合、既存のファイルはアップグレードされたバージョンのパッケージによって提供されるファイルによって置き換えられ、アクセス権およびタイムスタンプ (存在する場合) も置き換えられます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、アップグレードされるパッケージ内の \fBpreserve\fR 値が \fBlegacy\fR で、現在インストール済みのバージョンのパッケージとは \fBpreserve\fR 値が異なる場合、既存のファイルは拡張子 \fB\&.legacy\fR を使用して名前変更され、新しいファイルは、更新されたアクセス権およびタイムスタンプ (存在する場合) を使用してインストールされます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、アップグレードされるパッケージと、現在インストール済みのバージョンのパッケージの両方で \fBpreserve\fR 値が \fBlegacy\fR の場合、既存のファイルのアクセス権およびタイムスタンプ (存在する場合) がリセットされます。
-.RE
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoverlay\fR\fR
-.ad
-.sp .6
-.RS 4n
-このアクションによってほかのパッケージが同じ場所にファイルを提供できるか、またはそれによって別のファイルをオーバーレイすることを目的にしたファイルが提供されるかを指定します。この機能は、どの自己アセンブリにも参加しておらず (たとえば、\fB/etc/motd\fR)、かつ安全に上書きできる構成ファイルで使用されることを目的にしています。
-.sp
-\fBoverlay\fR が指定されていない場合は、複数のパッケージが同じ場所にファイルを提供することはできません。
-.sp
-\fBoverlay\fR 属性は、次のいずれかの値を持ちます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBallow\fR\fR
-.ad
-.RS 9n
-.rt  
-もう 1 つのパッケージが同じ場所にファイルを配布できるようになります。\fBpreserve\fR 属性も同時に設定されていないかぎり、この値は意味を持ちません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtrue\fR\fR
-.ad
-.RS 9n
-.rt  
-このアクションによって配布されたファイルは、\fBallow\fR を指定したほかのすべてのアクションを上書きします。
-.RE
-
-インストールされたファイルへの変更は、オーバーレイしているファイルの \fBpreserve\fR 属性の値に基づいて保持されます。削除時、ファイルの内容は、\fBpreserve\fR 属性が指定されたかどうかには関係なく、オーバーレイされているアクションがまだインストールされている場合は保持されます。別のファイルをオーバーレイできるのは 1 つのアクションだけであり、\fBmode\fR、\fBowner\fR、および \fBgroup\fR 属性が一致している必要があります。
-.RE
-
-.sp
-.LP
-ELF ファイルの場合、次の属性が認識されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfarch\fR\fR
-.ad
-.sp .6
-.RS 4n
-ELF ファイルのアーキテクチャー。これは、そのファイルが構築されたアーキテクチャー上での \fBuname -p\fR の出力です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfbits\fR\fR
-.ad
-.sp .6
-.RS 4n
-これは \fB32\fR または \fB64\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfhash\fR\fR
-.ad
-.sp .6
-.RS 4n
-これは、そのファイル内の「興味深い」ELF セクションのハッシュです。これらは、バイナリがロードされるときにメモリーにマップされるセクションです。これらは、2 つのバイナリの実行可能ファイルの動作が異なるかどうかを判定するときに考慮する必要のある唯一のセクションです。
-.RE
-
-.sp
-.LP
-\fBfile\fR アクションの場合、次の追加属性が認識されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoriginal_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-この属性は、パッケージからパッケージに、または場所から場所に、あるいはその両方で移動している編集可能なファイルを処理するために使用されます。この形式は、元のパッケージの名前のあとに、コロンとこのファイルの元のパスが続きます。削除されているファイルはすべて、そのパッケージとパス、または \fBoriginal_name\fR 属性の値 (指定されている場合) のどちらかを使用して記録されます。\fBoriginal_name\fR 属性が設定された、インストールされている編集可能なファイルはすべて、それが同じパッケージ化の操作の一部として削除されている場合は、その名前のファイルを使用します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrelease-note\fR\fR
-.ad
-.sp .6
-.RS 4n
-この属性は、このファイルにリリースノートテキストが含まれていることを示すために使用されます。この属性の値は、パッケージ FMRI です。元のイメージに存在し、元のイメージ内のパッケージよりも新しいバージョンのパッケージ名が FMRI で指定されている場合、このファイルはリリースノートに含まれます。特別な FMRI (\fBfeature/pkg/self\fR) は、含まれるパッケージを指します。\fBfeature/pkg/self\fR のバージョンが 0 の場合、このファイルは初期インストールのリリースノートにのみ含まれます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrevert-tag\fR\fR
-.ad
-.sp .6
-.RS 4n
-この属性は、セットとして元に戻すべき編集可能なファイルをタグ付けするために使用されます。\fBrevert-tag\fR 属性の値は \fItagname\fR です。単一の \fBfile\fR アクションに対して複数の \fBrevert-tag\fR 属性を指定できます。これらのいずれかのタグを指定して \fBpkg revert\fR が呼び出されると、ファイルはマニフェストで定義された状態に戻ります。\fBpkg revert\fR コマンドの詳細については、\fBpkg\fR(1) マニュアルページを参照してください。
-.sp
-\fBrevert-tag\fR 属性は、ディレクトリレベルでも指定できます。後述の「ディレクトリアクション」を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsysattr\fR\fR
-.ad
-.sp .6
-.RS 4n
-この属性は、このファイルに設定する必要があるシステム属性を指定するために使用されます。\fBsysattr\fR 属性の値は、次の例に示すように、詳細システム属性のカンマ区切りリストまたはコンパクトシステム属性オプションの文字列シーケンスの場合があります。サポートされるシステム属性は、\fBchmod\fR(1) マニュアルページで説明されています。マニフェストに指定されるシステム属性は、オペレーティングシステムのほかのサブシステムによって設定される場合があるシステム属性に追加で設定されます。
-.sp
-.in +2
-.nf
-file path=opt/secret_file sysattr=hidden,sensitive
-file path=opt/secret_file sysattr=HT
-.fi
-.in -2
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtimestamp\fR\fR
-.ad
-.sp .6
-.RS 4n
-この属性は、ファイルに対するアクセスおよび変更時間を設定するために使用します。\fBtimestamp\fR 属性値は、コロンおよびハイフンを省略した、ISO-8601 形式の UTC で表現する必要があります。
-.sp
-\fBtimestamp\fR 属性は、Python 用の \fB\&.pyc\fR または \fB\&.pyo\fR ファイルをパッケージングする場合に不可欠です。\fB\&.pyc\fR または \fB\&.pyo\fR ファイルに関連する \fB\&.py\fR ファイルは、次の例で示すように、これらのファイル内に埋め込まれたタイムスタンプを使用してマーク付けする必要があります。
-.sp
-.in +2
-.nf
-file path=usr/lib/python2.6/vendor-packages/pkg/__init__.pyc ...
-file path=usr/lib/python2.6/vendor-packages/pkg/__init__.py \e
-     timestamp=20130311T221521Z ...
-.fi
-.in -2
-
-.RE
-
-.sp
-.LP
-\fBfile\fR アクションに対する次の属性はシステムによって自動的に生成されるため、パッケージ開発者によって指定しないでください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhash\fR\fR
-.ad
-.sp .6
-.RS 4n
-非圧縮ファイルの SHA-1 ハッシュ。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBchash\fR\fR
-.ad
-.sp .6
-.RS 4n
-圧縮ファイルの SHA-1 ハッシュ。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.size\fR\fR
-.ad
-.sp .6
-.RS 4n
-非圧縮ファイルのバイト単位のサイズ。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.csize\fR\fR
-.ad
-.sp .6
-.RS 4n
-圧縮ファイルのバイト単位のサイズ。
-.RE
-
-.SS "ディレクトリアクション"
-.sp
-.LP
-\fBdir\fR アクションは、ファイルシステムオブジェクトを表すという点で \fBfile\fR アクションに似ています。\fBdir\fR アクションは、通常ファイルの代わりにディレクトリを表します。\fBdir\fR アクションには、\fBfile\fR アクションが持つのと同じ \fBpath\fR、\fBmode\fR、\fBowner\fR、および \fBgroup\fR 属性があり、\fBpath\fR がキー属性です。\fBdir\fR アクションは \fBrevert-tag\fR 属性も受け入れます。\fBrevert-tag\fR 属性の値は、\fBfile\fR アクションと \fBdir\fR アクションで異なります。
-.sp
-.LP
-ディレクトリは、IPS でカウントされる参照です。あるディレクトリを明示的または暗黙的に参照している最後のパッケージが参照を行わなくなると、そのディレクトリは削除されます。そのディレクトリにパッケージ解除されたファイルシステムオブジェクトが含まれている場合、それらの項目は \fB$IMAGE_META/lost+found\fR に移動されます。\fB$IMAGE_META\fR についての詳細は、「ファイル」のセクションを参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrevert-tag\fR\fR
-.ad
-.sp .6
-.RS 4n
-この属性は、セットとして削除する必要があるパッケージ解除されたファイルを識別するために使用します。\fBfile\fR アクションに対してこの属性を指定する方法についての説明は、上記の「ファイルアクション」を参照してください。ディレクトリの場合、\fBrevert-tag\fR 属性の値は \fItagname\fR\fB=\fR\fIpattern\fR です。単一の \fBdir\fR アクションに対して複数の \fBrevert-tag\fR 属性を指定できます。マッチングする \fItagname\fR を指定して \fBpkg revert\fR が呼び出されると、\fIpattern\fR に一致する (シェルグロビング文字を使用)、この \fBdir\fR ディレクトリの下にあるパッケージ解除されたファイルまたはディレクトリが削除されます。\fBpkg revert\fR コマンドの詳細については、\fBpkg\fR(1) マニュアルページを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsalvage-from\fR\fR
-.ad
-.sp .6
-.RS 4n
-この属性は、パッケージ解除された内容を新しいディレクトリに移動する場合に使用できます。この属性の値は、回収された項目のディレクトリの名前です。\fBsalvage-from\fR 属性を持つディレクトリは、作成時に、\fBsalvage-from\fR 属性の値に指定されたディレクトリのすべての内容を継承します。
-.RE
-
-.SS "リンクアクション"
-.sp
-.LP
-\fBlink\fR アクションはシンボリックリンクを表します。\fBlink\fR アクションには、次の標準属性があります。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-シンボリックリンクがインストールされるファイルシステムのパス。これは \fBlink\fR アクションのキー属性です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtarget\fR \fR
-.ad
-.sp .6
-.RS 4n
-シンボリックリンクのターゲット。リンクの解決先のファイルシステムオブジェクト。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator\fR\fR
-.ad
-.sp .6
-.RS 4n
-特定のメディエーショングループ (たとえば、\fBpython\fR) に参加しているすべてのパス名によって共有されているメディエーション名前空間内のエントリを指定します。\fBmediator-version\fR または \fBmediator-implementation\fR、あるいはその両方に基づいてリンクメディエーションを実行できます。特定のパス名に対してメディエートされたリンクはすべて、同じメディエータを指定する必要があります。ただし、すべてのメディエータバージョンおよび実装が、特定のパスでリンクを提供する必要はありません。メディエーションがリンクを提供していない場合は、そのメディエーションが選択されたときにリンクが削除されます。特定のバージョンまたは実装、あるいはその両方と組み合わせた \fBmediator\fR は、パッケージシステムで使用するために選択できるメディエーションを表します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-version\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBmediator\fR 属性で記述されたインタフェースの (負にならない整数のドットで区切られた並びとして表された) バージョンを指定します。この属性は、\fBmediator\fR が指定され、\fBmediator-implementation\fR は指定されていない場合に必要です。ローカルシステム管理者は、使用するバージョンを明示的に設定できます。指定された値は一般に、リンクを提供しているパッケージのバージョンに一致するようにしてください (たとえば、\fBruntime/python-26\fR は \fBmediator-version=2.6\fR を使用します)。ただし、これは必須ではありません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-implementation\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBmediator-version\fR に加えて、またはこの代わりに使用するメディエータの実装を指定します。実装の文字列は順序付けられているとは見なされず、システム管理者によって明示的に指定されていない場合は、\fBpkg \fR(5) によって文字列が任意に選択されます。
-.sp
-この値は、英数字とスペースで構成された任意の長さの文字列にすることができます。実装自体をバージョン管理できるか、または実際にバージョン管理されている場合は、文字列の最後の @ のあとに (負にならない整数のドットで区切られた並びとして表された) バージョンを指定します。実装の複数のバージョンが存在する場合、デフォルトの動作では、最大のバージョンを持つ実装が選択されます。
-.sp
-特定のパスにある実装メディエーションリンクの 1 つのインスタンスだけがシステムにインストールされている場合は、その 1 つのインスタンスが自動的に選択されます。このパスにある将来のリンクがインストールされても、ベンダー、サイト、またはローカルのオーバーライドが適用されないかぎり、またはいずれかのリンクのバージョンがメディエートされた場合、このリンクは切り替えられません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-priority\fR\fR
-.ad
-.sp .6
-.RS 4n
-メディエートされたリンクの競合を解決する場合、\fBpkg\fR(5) は通常、\fBmediator-version\fR の最大の値を持つリンクを選択するか、またはそれが不可能な場合は \fBmediator-implementation\fR に基づいて選択します。この属性は、正常な競合解決処理のためのオーバーライドを指定するために使用されます。
-.sp
-この属性が指定されていない場合は、デフォルトのメディエータ選択ロジックが適用されます。
-.sp
-この値が \fBvendor\fR である場合は、このリンクが、\fBmediator-priority\fR が指定されていないリンクより優先されます。
-.sp
-この値が \fBsite\fR である場合は、このリンクが、\fBvendor\fR の値を持つリンクや、\fBmediator-priority\fR が指定されていないリンクより優先されます。
-.sp
-ローカルシステム管理者は、上で説明した選択ロジックをオーバーライドできます。
-.RE
-
-.SS "ハードリンクアクション"
-.sp
-.LP
-\fBhardlink\fR アクションは、ハードリンクを表します。このアクションは \fBlink\fR アクションと同じ属性を持ち、そのキー属性も同じく \fBpath\fR です。
-.SS "ドライバアクション"
-.sp
-.LP
-\fBdriver\fR アクションはデバイスドライバを表します。\fBdriver\fR アクションはペイロードを参照しません。ドライバファイル自体を \fBfile\fR アクションとしてインストールする必要があります。次の属性が認識されます (詳細は \fBadd_drv\fR(1M) を参照)。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.sp .6
-.RS 4n
-ドライバの名前。多くの場合はドライババイナリのファイル名ですが、必ずしもそうとは限りません。これは \fBdriver\fR アクションのキー属性です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalias\fR\fR
-.ad
-.sp .6
-.RS 4n
-これはドライバの別名を表します。特定のドライバが複数の \fBalias\fR 属性を持つことができます。特殊な引用符の規則は必要ありません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclass\fR\fR
-.ad
-.sp .6
-.RS 4n
-これはドライバクラスを表します。特定のドライバが複数の \fBclass\fR 属性を持つことができます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBperms\fR\fR
-.ad
-.sp .6
-.RS 4n
-これは、ドライバのデバイスノードのファイルシステムアクセス権を表します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclone_perms\fR\fR
-.ad
-.sp .6
-.RS 4n
-これは、このドライバに対する複製ドライバのマイナーノードのファイルシステムアクセス権を表します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpolicy\fR\fR
-.ad
-.sp .6
-.RS 4n
-これは、デバイスのための追加のセキュリティーポリシーを指定します。特定のドライバが複数の \fBpolicy\fR 属性を持つことができますが、マイナーデバイスの指定が複数の属性に存在することはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBprivs\fR\fR
-.ad
-.sp .6
-.RS 4n
-これは、ドライバで使用される特権を指定します。特定のドライバが複数の \fBprivs\fR 属性を持つことができます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdevlink\fR\fR
-.ad
-.sp .6
-.RS 4n
-これは \fB/etc/devlink.tab\fR 内のエントリを指定します。この値はファイルに書き込まれる行そのものであり、タブは \fB\t\fR で示されます。詳細は、\fBdevlinks\fR(1M) を参照してください。特定のドライバが複数の \fBdevlink\fR 属性を持つことができます。
-.RE
-
-.SS "依存アクション"
-.sp
-.LP
-\fBdepend\fR アクションは、パッケージ間の依存関係を表します。あるパッケージが別のパッケージに依存することがあります。たとえば、最初のパッケージの機能を有効にする (場合によってはインストールする) ために、2 番目のパッケージの機能が必要な場合があります。依存関係はオプションです。インストール時に依存関係が満たされない場合、パッケージシステムはほかの制約に応じて、依存パッケージをインストールするか、または十分に新しいバージョンに更新しようとします。
-.sp
-.LP
-次の属性が認識されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBfmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-依存パッケージを表す FMRI。これは \fBdependency\fR アクションのキー属性です。\fBfmri\fR 値にパブリッシャーを含めることはできません。パッケージ名は完全であると見なされます。タイプ \fBrequire-any\fR の依存関係は、複数の \fBfmri\fR 属性を持つことができます。\fBfmri\fR 値でバージョンはオプションですが、依存関係のタイプによっては、バージョンのない \fBfmri\fR は無意味である場合があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtype\fR\fR
-.ad
-.sp .6
-.RS 4n
-依存関係のタイプ。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire\fR\fR
-.ad
-.sp .6
-.RS 4n
-依存関係が必要であり、かつ \fBfmri\fR 属性で指定されたバージョン以上のバージョンを持っている必要があります。バージョンが指定されていない場合は、任意のバージョンが依存関係を満たします。パッケージの必要な依存関係のいずれかを満たすことができない場合、そのパッケージはインストールできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoptional\fR\fR
-.ad
-.sp .6
-.RS 4n
-依存関係が存在する場合は、指定されたバージョンレベル以上である必要があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexclude\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたバージョンレベル以上という依存関係が存在する場合は、含んでいるパッケージをインストールできません。バージョンが指定されていない場合、依存パッケージは、依存関係を指定しているパッケージと同時にインストールできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBincorporate\fR\fR
-.ad
-.sp .6
-.RS 4n
-依存関係はオプションですが、依存するパッケージのバージョンは制約されます。以下の「制約と凍結」を参照してください。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-any\fR\fR
-.ad
-.sp .6
-.RS 4n
-複数の \fBfmri\fR 属性で指定された複数の依存パッケージのうちのいずれか 1 つが、依存関係のタイプ \fBrequire\fR と同じ規則に従って依存関係を満たすことができます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBconditional\fR\fR
-.ad
-.sp .6
-.RS 4n
-依存関係は、\fBpredicate\fR 属性で定義されたパッケージがシステム上に存在する場合にのみ必要です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBorigin\fR\fR
-.ad
-.sp .6
-.RS 4n
-このパッケージのインストールの前に、依存関係のターゲット (存在する場合) は変更されるイメージ上の指定された値以上である必要があります。\fBroot-image\fR 属性の値が \fBtrue\fR である場合、このパッケージをインストールするには、/ をルートとするイメージ上にターゲットが存在する必要があります。\fBroot-image\fR 属性の値が \fBtrue\fR で、\fBfmri\fR 属性の値が \fBpkg:/feature/firmware/\fR で始まる場合、\fBfmri\fR 値の残りの部分は、ファームウェアの依存関係を評価する \fB/usr/lib/fwenum\fR 内のコマンドとして扱われます。例については、「\fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR」を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR \fR
-.ad
-.sp .6
-.RS 4n
-依存関係は、パッケージがイメージ回避リスト上にないかぎり必要です。廃止されたパッケージは、暗黙のうちにグループの依存関係を満たすことに注意してください。\fBpkg\fR(1) の \fBavoid\fR サブコマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBparent\fR\fR
-.ad
-.sp .6
-.RS 4n
-依存関係は、イメージが子イメージでない場合は無視されます。このイメージが子イメージである場合は、親イメージ内に依存関係が存在する必要があります。\fBparent\fR 依存関係でのパッケージバージョンの照合は、\fBincorporate\fR 依存関係で使用されるものと同じです。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpredicate\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBconditional\fR 依存関係の述語を表す FMRI。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBroot-image\fR\fR
-.ad
-.sp .6
-.RS 4n
-先に説明した \fBorigin\fR 依存関係に対してのみ有効です。
-.RE
-
-.SS "ライセンスアクション"
-.sp
-.LP
-\fBlicense\fR アクションは、パッケージの内容に関連したライセンスやその他の情報ファイルを表します。パッケージは \fBlicense\fR アクションの使用を通して、ライセンス、免責条項、またはその他のガイダンスをパッケージインストーラに提供できます。
-.sp
-.LP
-\fBlicense\fR アクションのペイロードは、パッケージに関連したイメージメタデータディレクトリに提供され、人間が読める形式のテキストデータのみが含まれているべきです。HTML やその他の形式のマークアップが含まれていてはいけません。\fBlicense\fR アクションは、属性を通して、関連するペイロードが表示または同意、あるいはその両方を必要としていることをクライアントに示すことができます。表示または同意、あるいはその両方の方法は、クライアントに任されています。
-.sp
-.LP
-次の属性が認識されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlicense\fR\fR
-.ad
-.sp .6
-.RS 4n
-これは \fBlicense\fR アクションのキー属性です。この属性は、ユーザーがライセンスのテキスト自体を読まなくてもその内容を判断できるように支援するための、ライセンスの意味のある説明を提供します。この値のいくつかの例を次に示します。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ABC Co. Copyright Notice
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ABC Co. Custom License
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Common Development and Distribution License 1.0 (CDDL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-GNU General Public License 2.0 (GPL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-GNU General Public License 2.0 (GPL) Only
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-MIT License
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Mozilla Public License 1.1 (MPL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Simplified BSD License
-.RE
-\fBlicense\fR 値は、パッケージ内で一意である必要があります。上のいくつかの例に示すように、説明にライセンスのバージョンを含めることをお勧めします。パッケージに複数のライセンスに基づくコードが含まれる場合、複数の \fBlicense\fR アクションを使用します。ライセンス属性値の長さは、64 文字以下にしてください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmust-accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBtrue\fR の場合は、関連するパッケージをインストールまたは更新するには、ユーザーがこのライセンスに同意する必要があります。この属性を省略すると、\fBfalse\fR と同等になります。同意の方法 (たとえば、対話型または構成ベース) は、クライアントに任されています。パッケージの更新については、ライセンスアクションまたはペイロードが変更されていない場合、この属性は無視されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmust-display\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBtrue\fR の場合は、パッケージ化の操作中に、クライアントがこのアクションのペイロードを表示する必要があります。この値を省略すると、\fBfalse\fR と同等になります。この属性は、コピーライト表示に使用しないでください。この属性は、操作中に表示する必要のある実際のライセンスまたはその他の素材にのみ使用してください。表示の方法は、クライアントに任されています。パッケージの更新については、ライセンスアクションまたはペイロードが変更されていない場合、この属性は無視されます。
-.RE
-
-.SS "レガシーアクション"
-.sp
-.LP
-\fBlegacy\fR アクションは、従来のパッケージシステムで使用されるパッケージデータを表します。このアクションに関連付けられた属性は、従来のシステムのデータベースに追加されます。そのため、これらのデータベースに問い合わせを行なっているツールは、従来のパッケージが実際にインストールされているかのように動作できます。特にこれにより、\fBpkg\fR 属性で指定されたパッケージがシステムにインストールされていることを従来のシステムに十分に確信させることができるため、このパッケージを、依存関係を満たすために使用できるようになります。
-.sp
-.LP
-\fBpkginfo\fR(4) のパラメータに従って指定された次の属性が認識されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcategory\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBCATEGORY\fR パラメータの値。デフォルト値は \fBsystem\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdesc\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBDESC\fR パラメータの値。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhotline\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBHOTLINE\fR パラメータの値。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBNAME\fR パラメータの値。デフォルト値は \fBnone provided\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-インストールされるパッケージの略語。デフォルト値は、パッケージの FMRI の名前です。これは \fBlegacy\fR アクションのキー属性です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBvendor\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBVENDOR\fR パラメータの値。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBversion\fR\fR
-.ad
-.sp .6
-.RS 4n
-VERSION パラメータの値。デフォルト値は、パッケージの FMRI のバージョンです。
-.RE
-
-.SS "設定アクション"
-.sp
-.LP
-\fBset\fR アクションは、パッケージの説明などの、パッケージレベルの属性 (またはメタデータ) を表します。
-.sp
-.LP
-次の属性が認識されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.RS 9n
-.rt  
-属性の名前。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBvalue\fR\fR
-.ad
-.RS 9n
-.rt  
-属性に与えられた値。
-.RE
-
-.sp
-.LP
-\fBset\fR アクションは、パッケージ作成者が選択した任意のメタデータを提供できます。ただし、パッケージシステムにとって特別な意味を持つ、適切に定義された属性名がいくつか存在します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBinfo.classification\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkg\fR(5) クライアントがパッケージを分類するために使用できる 1 つ以上のトークン。この値には、スキーム (「org.opensolaris.category.2008」や「org.acm.class.1998」など) と実際の分類 (「アプリケーション/ゲーム」など) がコロン (:) で区切られて含まれています。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.description\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージの内容と機能の詳細な説明。通常は、1 つの段落程度の長さです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-含まれるパッケージの名前とバージョン。「説明」セクションの「パッケージの FMRI とバージョン」を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.human-version\fR\fR
-.ad
-.sp .6
-.RS 4n
-IPS によって使用されるバージョンスキームは厳格です。「説明」セクションの「パッケージの FMRI とバージョン」を参照してください。より柔軟性のあるバージョンを \fBpkg.human-version\fR 属性の値として指定できます。値は IPS ツール (\fBpkg info\fR、\fBpkg contents\fR、\fBpkg search\fR など) によって表示されます。\fBpkg.human-version\fR の値はバージョン比較のベースとして使用されず、\fBpkg.fmri\fR バージョンの代わりに使用することはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.obsolete\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBtrue\fR の場合、パッケージは廃止としてマークされています。廃止されたパッケージには、ほかの設定アクション以外のアクションは存在せず、また名前変更としてマークすることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.renamed\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBtrue\fR の場合は、パッケージの名前が変更されました。このパッケージには、このパッケージの名前が変更された先のパッケージバージョンを指す 1 つ以上の \fBdepend\fR アクションも存在する必要があります。パッケージを名前変更と廃止の両方としてマークすることはできませんが、それ以外は任意の数の設定アクションが存在できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.summary\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージの短い、1 行の説明。
-.RE
-
-.SS "グループアクション"
-.sp
-.LP
-\fBgroup\fR アクションは、\fBgroup\fR(4) で定義されるのと同様の UNIX グループを定義します。グループパスワードのサポートはありません。このアクションで定義されたグループには最初、ユーザーリストがありません。ユーザーは、\fBuser\fR アクションを使用して追加できます。次の属性が認識されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroupname\fR\fR
-.ad
-.sp .6
-.RS 4n
-グループの名前の値。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgid\fR\fR
-.ad
-.sp .6
-.RS 4n
-グループの一意の数値 ID。デフォルト値は、100 未満の最初に空いているグループです。
-.RE
-
-.SS "ユーザーアクション"
-.sp
-.LP
-\fBuser\fR アクションは、\fB/etc/passwd\fR、\fB/etc/shadow\fR、\fB/etc/group\fR、および \fB/etc/ftpd/ftpusers\fR ファイルで定義されるのと同様の UNIX ユーザーを定義します。この \fBuser\fR アクションで定義されたユーザーについて、エントリが適切なファイルに追加されます。
-.sp
-.LP
-\fBuser\fR アクションは、デーモンまたは使用するほかのソフトウェアのためにユーザーを定義することを目的としています。管理または対話アカウントを定義する目的で \fBuser\fR アクションを使用しないでください。
-.sp
-.LP
-次の属性が認識されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBusername\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーの一意の名前。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpassword\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーの暗号化パスワード。デフォルト値は \fB*LK*\fR です。\fBshadow\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーの一意の UID。デフォルト値は、100 未満の最初に空いている値です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR \fR
-.ad
-.sp .6
-.RS 4n
-ユーザーのプライマリグループの名前。\fB/etc/group\fR に存在する必要があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgcos-field\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB/etc/passwd\fR 内の \fBgcos\fR フィールドの値。デフォルト値は \fBusername\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhome-dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーのホームディレクトリ。このディレクトリはシステムイメージディレクトリ内にある必要があり、\fB/home\fR などの別のマウントポイントの下であってはいけません。デフォルト値は \fB/\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlogin-shell\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーのデフォルトのシェル。デフォルト値は空です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup-list\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーが属しているセカンダリグループ。\fBgroup\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBftpuser\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBtrue\fR または \fBfalse\fR に設定できます。\fBtrue\fR のデフォルト値は、ユーザーが FTP 経由のログインを許可されていることを示します。\fBftpusers\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlastchg\fR\fR
-.ad
-.sp .6
-.RS 4n
-1970 年 1 月 1 日と、パスワードが最後に変更された日付の間の日数。デフォルト値は空です。\fBshadow\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmin\fR \fR
-.ad
-.sp .6
-.RS 4n
-パスワード変更の間の必要な最小日数。パスワードの有効期限を有効にするには、このフィールドを 0 以上に設定する必要があります。デフォルト値は空です。\fBshadow\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmax\fR \fR
-.ad
-.sp .6
-.RS 4n
-パスワードが有効な最大日数。デフォルト値は空です。\fBshadow\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwarn\fR\fR
-.ad
-.sp .6
-.RS 4n
-パスワードの期限が切れる前にユーザーに警告が表示される日数。\fBshadow\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBinactive\fR\fR
-.ad
-.sp .6
-.RS 4n
-そのユーザーに許可されている非活動の日数。これはマシンごとにカウントされます。最終ログインに関する情報は、そのマシンの \fBlastlog\fR ファイルから取得されます。\fBshadow\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexpire\fR\fR
-.ad
-.sp .6
-.RS 4n
-UNIX エポック (1970 年 1 月 1 日) 以降の日数として表される絶対的な日付。この日数に達すると、ログインを使用できなくなります。たとえば、13514 の期限切れの値は、ログインの有効期限が 2007 年 1 月 1 日であることを指定します。\fBshadow\fR(4) を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBflag\fR\fR
-.ad
-.sp .6
-.RS 4n
-空に設定されています。\fBshadow\fR(4) を参照してください。
-.RE
-
-.SH アクチュエータ
-.sp
-.LP
-コンテキストによっては、特定のアクションの準備として、またはその導入のあとに、追加の操作を実行することが適している場合があります。これらの追加の操作はオペレーティングシステムに固有のもので、一般にライブシステムイメージ上でのみ必要です。ライブイメージは、現在のゾーンのアクティブな実行中のブート環境の \fB/\fR にマウントされたイメージです。パッケージのインストールまたは削除に関与する複数のアクションのアクチュエータが同一である場合、アクチュエータの存在に対応する操作は、そのインストールまたは削除に対して 1 回実行されます。
-.sp
-.LP
-アクチュエータを誤って指定すると、そのアクチュエータがインストールを安全に進めるための手段を決定できない場合、パッケージのインストールが失敗することがあります。
-.sp
-.LP
-次のアクチュエータが定義されています。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBreboot-needed\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBtrue\fR または \fBfalse\fR に設定できます。このアクチュエータは、パッケージシステムがライブイメージ上で動作している場合、タグ付きアクションの更新または削除を新しいブート環境で実行する必要があることを宣言します。新しいブート環境の作成は、\fBbe-policy\fR イメージプロパティーによって制御されます。\fBbe-policy\fR プロパティーについての詳細は、\fBpkg\fR(1) のマニュアルページの「イメージプロパティー」セクションを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdisable_fmri\fR、\fBrefresh_fmri\fR、\fBrestart_fmri\fR、\fBsuspend_fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-これらの各アクチュエータは、パッケージのインストールまたは削除中に操作するサービスインスタンスの FMRI の値を取ります。\fBdisable_fmri\fR を指定すると、\fBsvcadm\fR(1M) の \fBdisable\fR サブコマンドに従って、アクションの削除の前に特定の FMRI が無効になります。\fBrefresh_fmri\fR および \fBrestart_fmri\fR を指定すると、\fBsvcadm\fR(1M) の対応するサブコマンドに従って、アクションのインストール、更新、または削除のあとに特定の FMRI が更新または再起動されます。最後に、\fBsuspend_fmri\fR を指定すると、アクションのインストールフェーズの前に特定の FMRI が一時的に無効になり、そのフェーズが完了したあとに有効になります。
-.sp
-この値には、複数のサービスインスタンスに一致するパターンを含めることができます。ただし、それをインスタンスを示さずに暗黙的に行うのではなく、\fBsvcs\fR(1) によって受け入れられた glob を使用して明示的に行う必要があります。
-.RE
-
-.SH メディエーション
-.sp
-.LP
-メディエータは、一連の関連するシンボリックリンクまたはハードリンクを表す名前です。2 つ以上のリンクアクションが同じパスとメディエータ名を持つ場合、ユーザーまたはパッケージシステムは、バージョン、実装、または優先度に基づいてリンクターゲットを選択します。メディエータ属性については、「リンクアクション」を参照してください。
-.sp
-.LP
-次の例は、リンクがバージョンによって選択される、\fBjava\fR という名前のメディエータの 2 つの異なるインスタンスを示しています。これらの 2 つの \fBlink\fR アクションは 2 つの異なるパッケージに出現します。
-.sp
-.in +2
-.nf
-link mediator=java mediator-version=1.6 path=usr/java target=jdk/jdk1.6.0_31
-link mediator=java mediator-version=1.7 path=usr/java target=jdk/jdk1.7.0_02
-.fi
-.in -2
-
-.sp
-.LP
-このリンクパスのバージョンを選択する方法については、\fBpkg\fR(1) のマニュアルページの \fBset-mediator\fR サブコマンドを参照してください。バージョンを選択するには、両方のパッケージがインストールされている必要があります。
-.SH 制約と凍結
-.sp
-.LP
-パッケージが新しいバージョンに移行される場合、またはシステムに追加されたり、システムから削除されたりする場合、選択されるバージョンや、削除が許可されるかどうかは、そのパッケージに対するさまざまな制約によって決定されます。これらの制約は、依存関係の形式でほかのパッケージが定義するか、または凍結の形式で管理者が定義できます。
-.sp
-.LP
-制約のもっとも一般的な形式は、上の「依存アクション」で説明したように、\fBrequire\fR 依存関係によって提供されます。このような制約によって、パッケージがダウングレードまたは削除されることが回避されます。
-.sp
-.LP
-オペレーティングシステムのほとんどの部分は、\fBincorporation\fR と呼ばれるパッケージによってカプセル化されています。これらのパッケージは主に、\fBincorporate\fR 依存関係によって表される制約を提供します。
-.sp
-.LP
-上で説明したように、組み込まれたパッケージがシステム上に存在する必要はありませんが、存在する場合は、包括的な最小バージョンと排他的な最大バージョンの両方を指定します。たとえば、依存する FMRI のバージョンが 1.4.3 の場合、1.4.3 未満のバージョンは依存関係を満たさず、1.4.4 以上のバージョンでも依存関係を満たしません。ただし、1.4.3.7 など、単にドット形式の数列を拡張したバージョンは許可されます。
-.sp
-.LP
-incorporation は、システムの各部の同期的なアップグレードを強制的に行うために使用されます。C ライブラリやカーネルなどの一部のコンポーネントでは、これは基本的な要件です。ほかには依存関係が存在しない単純なユーザーランドコンポーネントなどのその他のコンポーネントでは、incorporation の特定のバージョンから参照できるテストされた、既知の一連のパッケージバージョンを提供するためだけに、同期アップグレードが使用されます。
-.sp
-.LP
-incorporation は単なるパッケージであるため、削除することができ、それが提供しているすべての制約がそれによって緩和されます。ただし、その緩和は安全ではないため、Oracle Solaris によって提供される多くの incorporation が、それらの incorporation によって組み込まれているパッケージには必要です。
-.sp
-.LP
-パッケージを、インストール済みの incorporation によって許可されていないバージョンにアップグレードしようとしても、要求を満たすためにその incorporation の新しいバージョンを見つけようとする試みは行われず、そのアップグレードは失敗します。制約自体を移動する必要があるが、それを指定している incorporation を削除できない場合は、その incorporation を、制約の目的のバージョンを指定するバージョンにアップグレードする必要があります。incorporation をアップグレードすると、その新しいバージョンによって提供される制約を満たさない組み込まれたパッケージもすべてアップグレードされます。
-.sp
-.LP
-システム管理者は、\fBpkg freeze\fR コマンドを使用してパッケージを制約できます。バージョンが指定されていない場合、指定されたパッケージは、システムにインストールされているバージョンに制約されます。バージョン管理されたパッケージが指定された場合、この管理上の制約 (つまり、凍結) は、\fBfmri\fR 属性が指定されたパッケージバージョンの値を持った状態で incorporate 依存関係がインストールされているかのように機能します。
-.sp
-.LP
-凍結がパッケージシステムによって自動的に解除されることはありません。制約を緩和するには、\fBpkg unfreeze\fR コマンドを使用します。
-.SH 発行元とリポジトリ
-.sp
-.LP
-上で詳細に説明したように、パブリッシャーとは単に、パッケージクライアントがパッケージのプロバイダを識別するために使用する名前です。パブリッシャーは、パッケージリポジトリまたはパッケージアーカイブ、あるいはその両方を使用してパッケージを配布できます。現在パッケージシステムでサポートされているリポジトリのタイプには、起点リポジトリとミラーリポジトリの 2 つがあります。
-.sp
-.LP
-\fB起点\fRは、1 つ以上のパッケージのすべてのメタデータ (カタログ、マニフェスト、検索インデックスなど) と内容 (ファイル) を含むパッケージリポジトリです。イメージ内の特定のパブリッシャーに対して複数の起点が構成されている場合、パッケージクライアント API は、パッケージデータの取得元として最適な起点を選択しようとします。これはもっとも一般的なタイプのリポジトリであり、パッケージリポジトリ上で \fBpkgsend\fR または \fBpkgrecv\fR が使用された場合は常に、暗黙的に作成されます。
-.sp
-.LP
-\fBミラー\fRは、パッケージの内容 (ファイル) のみを含むパッケージリポジトリです。イメージ内の特定のパブリッシャーに対して 1 つ以上のミラーが構成されている場合、クライアント API はパッケージ内容の取得のためのミラーを優先し、パッケージの内容の取得元として最適なミラーを選択しようとします。ミラーが到達不可能か、必要な内容が含まれていないか、またはより低速な場合、クライアント API は、構成されているいずれかの起点リポジトリから内容を取得します。ミラーは、\fBpkg.depotd\fR(1M) の動的ミラー機能を使用している、信頼できる一連のクライアント間の内容共有に使用されることを目的にしています。ミラーはまた、パッケージのメタデータへのアクセスを認証するために使用されることも目的にしています。ただし、パッケージの内容は認証なしで配布します。たとえば、あるクライアントが、アクセスするには SSL キーと証明書のペアが必要な \fBhttps\fR 起点と、パッケージの内容を提供する \fBhttp\fR ミラーを使用して構成される可能性があります。このようにして、認可クライアントだけがパッケージをインストールまたは更新できるようにしながら、パッケージ内容の取得のための認証のオーバーヘッドが回避されます。ミラーは、\fBfile\fR という名前のサブディレクトリとその親を除く、リポジトリのすべてのサブディレクトリを削除することによって作成できます。また、\fBpkg.depotd\fR(1M) のミラーモードを使用すると、起点リポジトリもミラーとしてプロビジョニングできます。
-.SH 大域ゾーンと非大域ゾーンの更新
-.sp
-.LP
-\fBpkg\fR システムは、非大域ゾーンを強制的に大域ゾーンと同期された状態に保持します。つまり、同じカーネルが確実に実行されるようにするために、特定のパッケージを大域ゾーンとすべての非大域ゾーンで同じバージョンにする必要があります。このために、\fBpkg\fR は \fBparent\fR 依存関係を使用して、非大域ゾーンに特定の制約を課します。\fBparent\fR 依存関係についての詳細は、上の「依存アクション」を参照してください。
-.sp
-.LP
-大域ゾーンが非大域ゾーンに課す制限のため、非大域ゾーンは大域ゾーンのパッケージにアクセスできる必要があり、かつ同様の発行元構成にする必要があります。これらの目的はどちらも、\fBシステムリポジトリ\fR を使用して実現されます (\fBpkg.sysrepo\fR(1M) のマニュアルページを参照)。システムリポジトリは、大域ゾーン内で構成された発行元へのアクセスと、これらの発行元が構成されている方法に関する情報を提供します。インストールまたは更新中に非大域ゾーンで別のパッケージが選択されないようにするために、発行元の検索順序で、システム発行元には非大域ゾーン内で構成された発行元より高くランク付けされます。発行元の検索順序については、\fBpkg\fR(1) のマニュアルページの \fBpkg set-publisher\fR コマンドを参照してください。
-.sp
-.LP
-システム上のすべての非大域ゾーンを更新するには、大域ゾーン内で \fBpkg update\fR コマンドを引数なしで使用します。このコマンドは大域ゾーンに対して、また各非大域ゾーンに対して再帰的に動作します。非大域ゾーンを大域ゾーン内で行われた変更と同期された状態にするために、非大域ゾーンに対して必要な最小の変更が加えられます。たとえば、パッケージ \fBfoo\fR が大域ゾーンと非大域ゾーンの両方にバージョン 1 でインストールされており、システムリポジトリ内でバージョン 2 が使用可能であると想定します。\fBfoo\fR に親の依存関係が存在する場合、\fBparent\fR 依存関係によってパッケージは強制的に同期された状態に保持されるため、\fBpkg update foo\fR は \fBfoo\fR を大域ゾーンと非大域ゾーンの両方でバージョン 2 に更新します。\fBfoo\fR に親の依存関係が存在しない場合、\fBfoo\fR は大域ゾーンでバージョン 2 に更新されますが、非大域ゾーンではバージョン 1 のままになります。
-.SH ファセットとバリアント
-.sp
-.LP
-ソフトウェアには、省略可能なコンポーネントや、相互に排他的なコンポーネントが含まれることがあります。省略可能なコンポーネントの例には、ロケールやドキュメントがあります。相互に排他的なコンポーネントの例には、SPARC バイナリと x86 バイナリや、デバッグバイナリと非デバッグバイナリなどがあります。
-.sp
-.LP
-IPS では、省略可能なコンポーネントを\fBファセット\fR、相互に排他的なコンポーネントを\fBバリアント\fRと呼びます。ファセットとバリアントはパッケージアクションのタグとして指定します。各ファセットタグおよびバリアントタグには名前と値があります。1 つのアクションに複数のファセットタグおよびバリアントタグを付けることができます。複数のファセットおよびバリアントタグのあるコンポーネントの例には、開発者によって使われるアーキテクチャー固有のヘッダーファイルや SPARC 大域ゾーン専用のコンポーネントなどがあります。
-.sp
-.LP
-バリアントタグの例は \fBvariant.arch=sparc\fR です。ファセットタグの例は \fBfacet.devel=true\fR です。ファセットとバリアントは、\fBfacet.\fR や \fB variant.\fR を先頭に付けずに参照されることがよくあります。
-.sp
-.LP
-ファセットとバリアントはイメージの特殊なプロパティーであり、個々のパッケージには設定できません。イメージに設定されたファセットおよびバリアントの現在の値を表示するには、\fBpkg\fR(1) のマニュアルページに示すように、\fBpkg facet\fR コマンドと \fBpkg variant\fR コマンドを使用します。イメージに設定されたファセットおよびバリアントの値を変更するには、\fBpkg change-facet\fR コマンドと \fB pkg change-variant\fR コマンドを使用します。
-.sp
-.LP
-ファセットは、パッケージクライアントによってブール値として扱われ、ファセットは、イメージ内で \fBtrue\fR (有効) または \fBfalse\fR (無効) にのみ設定できます。デフォルトで、イメージ内のすべてのファセットは、\fBtrue\fR に設定されていると見なされます。
-.sp
-.LP
-ファセットは、\fBpkg change-facet\fR コマンドを使用してイメージ内でローカルに設定するか、親イメージから継承することができます。たとえば、非大域ゾーンは大域ゾーンからファセットを継承できます。継承されたファセットは、ローカルで設定されたファセットよりも先に評価され、優先されます。同じファセットが、継承もローカル設定もされた場合、継承されたファセット値によって、ローカルで設定された値がマスクされます。マスクされたファセットは、ファセットの評価とパッケージアクションに影響しません。\fBpkg change-facet\fR コマンドを使用して行われるファセット変更は、ローカルで設定されたファセットにのみ影響します。継承されたファセットは、親イメージ内で変更を行うことによってのみ変更できます。デフォルトでは、\fBpkg facet\fR コマンドはマスクされたファセットを表示しません。
-.sp
-.LP
-ファセットが設定されたアクションをクライアントがフィルタ処理する方法を制御するために、アクションのファセットタグの値を \fBall\fR または \fBtrue\fR に設定できます。\fBall\fR または \fBtrue\fR 以外のすべての値では、未定義の動作が発生します。ファセットタグを持つアクションをインストールするために、イメージ内に存在する必要のある条件の説明については以下を参照してください。
-.sp
-.LP
-ファセットに対する \fBall\fR 値は、単一レベルを超えるフィルタリングが必要な場合に便利です。次の例で、\fBdoc\fR ファセットと、\fBlocale\fR ファセットの少なくとも 1 つが、イメージ内で \fBtrue\fR の場合のみ、\fBfoo.txt\fR がインストールされます。これにより、管理者はドキュメントを除外しつつ、特定のロケールのサポートを有効化または無効化できます。さらに、\fBdoc\fR ファセットと \fBdevel\fR ファセットの両方がイメージ内で \fBtrue\fR の場合のみ、\fBapi.txt\fR がインストールされます。
-.sp
-.in +2
-.nf
-file path=usr/share/doc/foo/foo.txt facet.doc=all facet.locale.en_GB=true facet.locale.en_US=true
-file path=usr/share/doc/foo/api.txt facet.doc=all facet.devel=all
-.fi
-.in -2
-
-.sp
-.LP
-イメージに設定されるファセットは、\fBdoc.man\fR などの完全なファセットか、\fBlocale.*\fR などのパターンになります。これは、ファセット名前空間の一部を無効にし、その中の個々のファセットのみを有効にする場合に役立ちます。たとえば、次の例に示すように、すべてのロケールを無効にしてから、1 つか 2 つの特定のロケールのみを有効にすることができます。
-.sp
-.in +2
-.nf
-# \fBpkg change-facet locale.*=false\fR
+<refentry lang="ja" id="pkg-5">
+<refmeta><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum> <refmiscinfo class="date">2015 年 3 月 10 日</refmiscinfo> <refmiscinfo class="sectdesc">&man5;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2009, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg</refname><refpurpose>Image Packaging System</refpurpose>
+</refnamediv>
+<refsect1 id="GLHDA" role="description"><title></title>
+<para>Image Packaging System、<literal>pkg</literal>(5) は、ソフトウェアのライフサイクル管理 (インストール、アップグレード、および削除) のために提供されるフレームワークです。Image Packaging System は、一連のキーと値のペアおよび (場合によっては) データペイロードで定義されたアクションのコレクションである、パッケージの単位でソフトウェアを管理します。多くの場合、アクションはファイルシステム内に存在するファイルですが、ドライバ、サービス、ユーザーなどのその他のインストール可能オブジェクトも表します。</para>
+</refsect1>
+<refsect1 role="other"><title>パッケージの FMRI とバージョン</title>
+<para>各パッケージは、スキーム <literal>pkg:</literal> を使用して、障害管理リソース識別子 (FMRI) によって表されます。パッケージの完全な FMRI は、次の形式のスキーム、パブリッシャー、パッケージ名、およびバージョン文字列で構成されます。</para>
+<screen>pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
+</screen>
+<para><literal>solaris</literal> は発行元です。<literal>system/library/c++-runtime</literal> はパッケージ名です。名前空間は階層的であり、その深さは任意ですが、適用される包含関係は存在しません。名前は基本的に任意です。発行元情報はオプションですが、存在する場合は <literal>pkg://</literal> を前に付ける必要があります。パブリッシャーを含む FMRI は、しばしば「完全修飾」されていると言われます。パブリッシャー情報が存在しない場合、通常はパッケージ名の前に <literal>pkg:/</literal> が付けられます。</para>
+<para>クライアントをパッケージ化すると、通常、FMRI にパブリッシャー情報が含まれていない場合に FMRI のスキームを省略できます。たとえば、<literal>pkg:/system/library/c++-runtime</literal> は <literal>system/library/c++-runtime</literal> と書くことができます。スキームが省略される場合、クライアントは照合の目的で、パッケージ名の最後のコンポーネントを除くすべてのコンポーネントを省略することもできます。たとえば、<literal>system/library/c++-runtime</literal> は <literal>library/c++-runtime</literal> または <literal>c++-runtime</literal> と書くことができ、これらは <literal>c++-runtime</literal> という名前のパッケージまたは <literal>/c++-runtime</literal> で終わるパッケージ名に一致します。</para>
+<para>パブリッシャーの名前によって、人、人のグループ、または組織が 1 つ以上のパッケージのソースとして識別されます。パブリッシャーの名前の競合を避け、パブリッシャーを識別しやすくするために、パッケージを公開するエンティティーを表すドメイン名をパブリッシャーの名前として使用することがベストプラクティスです。</para>
+<para>パッケージ名のあとに、アットマーク記号 (@) で区切られたバージョンが続きます。バージョンは、句読文字で区切られた 4 つの数字の並びで構成されます。最初の 3 つの並びに含まれる要素はドットで区切られ、これらの並びの長さは任意です。バージョンコンポーネント内の先頭のゼロ (たとえば、01.1 または 1.01) は許可されません。末尾のゼロ (たとえば、1.10) は許可されます。</para>
+<para>バージョンの最初の部分はコンポーネントバージョンです。オペレーティングシステムに緊密に結合されたコンポーネントの場合、これは通常、そのバージョンのオペレーティングシステムでの <command>uname -r</command> の値です。独自の開発ライフサイクルを持つコンポーネントの場合、この並びはドットで区切られたリリース番号 (2.4.10 など) です。</para>
+<para>バージョンの 2 番目の部分 (存在する場合はコンマ (,) に続いている必要があります) はビルドバージョンです。ビルドバージョンは、パッケージの内容が構築されたオペレーティングシステムのバージョンを指定し、その内容が正常に実行されることを予測できるオペレーティングシステムのバージョンに関する最小の境界が提供されます。</para>
+<para>バージョンの 3 番目の部分 (存在する場合はハイフン (<literal>-</literal>) に続いている必要があります) はブランチバージョンです。ブランチバージョンは、ベンダー固有の情報を提供するバージョン管理コンポーネントです。ブランチバージョンは、コンポーネントバージョンとは独立に、パッケージ化のメタデータが変更されたときに 1 増やすことができます。ブランチバージョンには、ビルド番号やその他の情報が含まれていることがあります。</para>
+<para>バージョンの 4 番目の部分 (存在する場合はコロン (:) に続いている必要があります) はタイムスタンプです。タイムスタンプは、そのパッケージがいつ公開されたかを表します。</para>
+<para>バージョン間の比較を実行する場合、その左側にあるコンポーネントが同じでないかぎり、バージョン全体のコンポーネントは考慮されません。したがって、<literal>4.3</literal> が <literal>4.2</literal> より大きいため、<literal>4.3-1</literal> は <literal>4.2-7</literal> より大きく、<literal>3</literal> が <literal>1</literal> より大きいため、<literal>4.3-3</literal> は <literal>4.3-1</literal> より大きくなります。</para>
+<para><literal>pkg.human-version</literal> 属性は、人間が読むことのできるバージョンの文字列を表示するために使用できます。<literal>pkg.human-version</literal> 属性の値は、パッケージ FMRI の前述のパッケージバージョンに追加して指定できますが、パッケージ FMRI バージョンを置き換えることはできません。人間が読むことのできるバージョンの文字列は、表示目的でのみ使用されます。詳細は、「設定アクション」を参照してください。</para>
+<para>システムの多くの部分では、表示される情報量や必要な情報量を減らすために、必要に応じて FMRI を表示するときには短縮し、入力も短い形式を受け入れます。通常、スキーム、パブリッシャー、ビルドバージョン、およびタイムスタンプは省略できます。すべてのバージョン管理情報を省略できることもあります。</para>
+</refsect1>
+<refsect1 role="other"><title>アクション</title>
+<para>アクションはシステム上のインストール可能オブジェクトを表します。アクションはパッケージのマニフェストに記述されます。すべてのアクションは、最初に名前とキー属性を含みます。また、これらはバージョン履歴をたどる過程で一意のオブジェクトを参照します。アクションには、このほかの属性も含まれます。一部の属性は、パッケージシステムによって直接解釈されます。その他の属性は、システム管理者またはエンドユーザーにのみ役立つ可能性があります。</para>
+<para>アクションには、次の単純なテキスト表現があります。</para>
+<programlisting><replaceable>action_name</replaceable> <replaceable>attribute1</replaceable>=<replaceable>
+value1</replaceable> <replaceable>attribute2</replaceable>=<replaceable>value2</replaceable> ...
+</programlisting>
+<para>属性の名前に、空白、引用符、または等号 (=) を含めることはできません。最初の等号のあとの文字はすべて、値に属します。値にはすべての文字を含めることができますが、スペースは単一引用符または二重引用符で囲む必要があります。二重引用符で囲まれている文字列の内部で単一引用符をエスケープする必要はなく、単一引用符で囲まれている文字列の内部で二重引用符をエスケープする必要はありません。引用符の前にバックスラッシュ (\) 文字を付けて、引用文字列が終了しないようにすることができます。バックスラッシュは、バックスラッシュでエスケープできます。</para>
+<para>アクションは複数の属性を含むことができます。一部の属性は、単一のアクションに対して異なる値を使用して、複数回名前を付けることができます。同じ名前を持つ複数の属性は、順序付けされていないリストとして扱われます。</para>
+<para>多くの属性を持つアクションによって、マニフェストファイル内に長い行が作成されることがあります。このような行は、不完全な各行をバックスラッシュで終了することにより折り返すことができます。この継続文字は、属性と値のペアの間に置く必要があることに注意してください。属性も、その値も、さらにその組み合わせも分割することはできません。</para>
+<para>下に示されている属性セットは、これがすべてではありません。実際、アクションに付加できる属性は任意であるため、標準の属性セットは、将来の開発を実装するために容易に拡張できます。</para>
+<para>一部の属性によって、パッケージングコンテキストの外部で追加の操作が実行されます。これらの属性は、下の「アクチュエータ」のセクションで説明されています。</para>
+<refsect2><title>ファイルアクション</title>
+<para><literal>file</literal> アクションは、通常ファイルを表します。<literal>file</literal> アクションはペイロードを参照し、次の 4 つの標準属性があります。</para>
+<variablelist>
+<varlistentry><term><literal>path</literal></term>
+<listitem><para>ファイルがインストールされているファイルシステムのパス。これは <literal>file</literal> アクションのキー属性です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mode</literal></term>
+<listitem><para>ファイルのアクセス権 (数値形式)。これらは ACL ではなく、単純なアクセス権のみです。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>owner</literal></term>
+<listitem><para>ファイルを所有するユーザーの名前。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal> </term>
+<listitem><para>ファイルを所有するグループの名前。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>ペイロードは、名前が付けられないという点で位置属性です。これは、アクション名のあとの最初の単語です。公開されたマニフェストでは、これはファイルの内容の <literal>SHA-1</literal> ハッシュです。これから公開する必要のあるマニフェスト内に存在する場合は、ペイロードを見つけることのできるパスを表します。<command>pkgsend</command>(1) を参照してください。値に等号が含まれている場合は、位置属性の代わりにハッシュ属性を使用できます。この両方を同じアクションで使用できます。ただし、ハッシュは同じである必要があります。</para>
+<para><literal>preserve</literal> 属性および <literal>overlay</literal> 属性は、<literal>file</literal> アクションがインストールされるかどうか、およびその方法に影響を及ぼします。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>preserve</literal></term>
+<listitem><para>パッケージ操作中にファイルを保持する時期と方法を指定します。</para>
+<para>パッケージが最初にインストールされるとき、パッケージによって提供されるファイルが持つ <literal>preserve</literal> 属性が何らかの値で定義されており、ファイルがイメージ内にすでに存在する場合、既存のファイルが <filename>/var/pkg/lost+found</filename> に格納され、パッケージされたファイルはインストールされます。</para>
+<para>パッケージが最初にインストールされるとき、パッケージによって提供されるファイルの <literal>preserve</literal> 属性が定義済みで、ファイルがイメージ内に存在しない場合、ファイルがインストールされるかどうかは <literal>preserve</literal> 属性の値によって決まります。</para>
+<itemizedlist>
+<listitem><para><literal>preserve</literal> の値が <literal>legacy</literal> である場合、パッケージされたファイルはインストールされません。</para></listitem>
+<listitem><para><literal>preserve</literal> の値が <literal>legacy</literal> でない場合、パッケージされたファイルはインストールされます。</para></listitem>
+</itemizedlist>
+<para>パッケージがダウングレードされるとき、ダウングレードされるバージョンのパッケージによって提供されるファイルの <literal>preserve</literal> 属性が何らかの値で定義されており、次のすべての条件が真の場合、イメージ内に現在存在するファイルは拡張子 <filename>.update</filename> で名前変更され、ダウングレードされたパッケージからのファイルがインストールされます。</para>
+<itemizedlist>
+<listitem><para>ファイルがイメージ内に存在する。</para></listitem>
+<listitem><para>ダウングレードされるバージョンのパッケージによって提供されるファイルの内容が、現在インストールされているバージョンのパッケージによって提供されるファイルの内容と異なる。</para></listitem>
+<listitem><para>ダウングレードされるバージョンのパッケージによって提供されるファイルの内容が、イメージ内に存在するファイルの内容と異なる。</para></listitem>
+</itemizedlist>
+<para>上の条件のいずれかが真でない場合、このファイルは、パッケージがダウングレードでなくアップグレードされる場合と同様に処理されます。</para>
+<para>パッケージがアップグレードされるとき、アップグレードされるバージョンのパッケージによって提供される <literal>file</literal> アクションの <literal>preserve</literal> 属性が何らかの値で定義されており、<literal>file</literal> アクションが、現在インストールされているバージョンのパッケージによって提供される <literal>file</literal> アクションと同じである場合、ファイルはインストールされず、イメージ内に存在するファイルは変更されません。以前のバージョンをインストールしたあとに加えられたすべての変更が保持されます。</para>
+<para>パッケージがアップグレードされるとき、アップグレードされるバージョンのパッケージによって提供される <literal>file</literal> アクションの <literal>preserve</literal> 属性が定義済みで、<literal>file</literal> アクションが新しいか、現在インストールされているバージョンのパッケージによって提供される <literal>file</literal> アクションとは異なる場合、アップグレードは次の方法で実行されます。</para>
+<itemizedlist>
+<listitem><para>イメージ内にファイルが存在しない場合は、新しいファイルがインストールされます。
+</para></listitem>
+<listitem><para>アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、現在インストール済みのバージョンのパッケージ内に存在せず、<literal>original_name</literal> 属性 (以下を参照) を使用した名前変更または移動を行わなかった場合、既存のファイルは <filename>/var/pkg/lost+found</filename> に格納され、アップグレードされたバージョンのパッケージによって提供されるファイルがインストールされます。</para>
+</listitem>
+<listitem><para>アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、現在インストール済みのバージョンのパッケージによって提供されるファイルと内容が異なる場合、アップグレードは <literal>preserve</literal> 属性の値に従って実行されます。</para>
+<itemizedlist>
+<listitem><para>アップグレードされるバージョンのパッケージによって提供されるファイルの <literal>preserve</literal> 値が <literal>renameold</literal> の場合、既存のファイルは拡張子 <filename>.old</filename> を使用して名前変更され、新しいファイルは更新されたアクセス権およびタイムスタンプ (存在する場合) を使用してインストールされます。下の <literal>timestamp</literal> 属性の説明を参照してください。</para>
+</listitem>
+<listitem><para>アップグレードされるバージョンのパッケージによって提供されるファイルの <literal>preserve</literal> 値が <literal>renamenew</literal> の場合、新しいファイルは拡張子 <filename>.new</filename> を使用してインストールされ、既存のファイルは変更されません。</para></listitem>
+<listitem><para>アップグレードされるバージョンのパッケージによって提供されるファイルの <literal>preserve</literal> 値が <literal>true</literal> の場合、新しいファイルはインストールされませんが、既存のファイルのアクセス権およびタイムスタンプ (存在する場合) がリセットされます。</para></listitem>
+</itemizedlist>
+</listitem>
+<listitem><para>アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、現在インストール済みのバージョンのパッケージによって提供されるファイルと同じ内容を持ち、<literal>preserve</literal> 値が <literal>renameold</literal> または <literal>renamenew</literal> の場合、既存のファイルはアップグレードされたバージョンのパッケージによって提供されるファイルによって置き換えられ、アクセス権およびタイムスタンプ (存在する場合) も置き換えられます。</para>
+</listitem>
+<listitem><para>アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、アップグレードされるパッケージ内の <literal>preserve</literal> 値が <literal>legacy</literal> で、現在インストール済みのバージョンのパッケージとは <literal>preserve</literal> 値が異なる場合、既存のファイルは拡張子 <literal>.legacy</literal> を使用して名前変更され、新しいファイルは、更新されたアクセス権およびタイムスタンプ (存在する場合) を使用してインストールされます。</para></listitem>
+<listitem><para>アップグレードされるバージョンのパッケージによって提供されるファイルがイメージ内に存在し、アップグレードされるパッケージと、現在インストール済みのバージョンのパッケージの両方で <literal>preserve</literal> 値が <literal>legacy</literal> の場合、既存のファイルのアクセス権およびタイムスタンプ (存在する場合) がリセットされます。</para></listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>overlay</literal></term>
+<listitem><para>このアクションによってほかのパッケージが同じ場所にファイルを提供できるか、またはそれによって別のファイルをオーバーレイすることを目的にしたファイルが提供されるかを指定します。この機能は、どの自己アセンブリにも参加しておらず (たとえば、<filename>/etc/motd</filename>)、かつ安全に上書きできる構成ファイルで使用されることを目的にしています。</para>
+<para><literal>overlay</literal> が指定されていない場合は、複数のパッケージが同じ場所にファイルを提供することはできません。</para>
+<para><literal>overlay</literal> 属性は、次のいずれかの値を持ちます。</para>
+<variablelist>
+<varlistentry><term><literal>allow</literal></term>
+<listitem><para>もう 1 つのパッケージが同じ場所にファイルを配布できるようになります。<literal>preserve</literal> 属性も同時に設定されていないかぎり、この値は意味を持ちません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>true</literal></term>
+<listitem><para>このアクションによって配布されたファイルは、<literal>allow</literal> を指定したほかのすべてのアクションを上書きします。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>インストールされたファイルへの変更は、オーバーレイしているファイルの <literal>preserve</literal> 属性の値に基づいて保持されます。削除時、ファイルの内容は、<literal>preserve</literal> 属性が指定されたかどうかには関係なく、オーバーレイされているアクションがまだインストールされている場合は保持されます。別のファイルをオーバーレイできるのは 1 つのアクションだけであり、<literal>mode</literal>、<literal>owner</literal>、および <literal>group</literal> 属性が一致している必要があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>dehydrate</literal></term>
+<listitem><para>パッケージパブリッシャーのパッケージがデハイドレートされるとき、またはデハイドレートされたパブリッシャーのパッケージが変更されるときに、このアクションを削除するかどうかを指定します。<literal>dehydrate</literal> 属性の値は <literal>true</literal> または <literal>false</literal> です。<literal>dehydrate</literal> 属性の値が <literal>false</literal> の場合、デハイドレート操作中にアクションは削除されません。それ以外の場合、アクションは削除されます。<literal>preserve</literal> または <literal>overlay</literal> 属性がタグ付けされているファイルアクションは、デハイドレート操作から暗黙的に除外されるため、この属性を必要としません。
+</para>
+<programlisting>file path=etc/zones/SYSdefault.xml dehydrate=false ...</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>ELF ファイルの場合、次の属性が認識されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>elfarch</literal></term>
+<listitem><para>ELF ファイルのアーキテクチャー。これは、そのファイルが構築されたアーキテクチャー上での <command>uname -p</command> の出力です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>elfbits</literal></term>
+<listitem><para>これは <literal>32</literal> または <literal>64</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>elfhash</literal></term>
+<listitem><para>これは、そのファイル内の「興味深い」ELF セクションのハッシュです。これらは、バイナリがロードされるときにメモリーにマップされるセクションです。これらは、2 つのバイナリの実行可能ファイルの動作が異なるかどうかを判定するときに考慮する必要のある唯一のセクションです。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>file</literal> アクションの場合、次の追加属性が認識されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>original_name</literal></term>
+<listitem><para>この属性は、パッケージからパッケージに、または場所から場所に、あるいはその両方で移動している編集可能なファイルを処理するために使用されます。この形式は、元のパッケージの名前のあとに、コロンとこのファイルの元のパスが続きます。削除されているファイルはすべて、そのパッケージとパス、または <literal>original_name</literal> 属性の値 (指定されている場合) のどちらかを使用して記録されます。<literal>original_name</literal> 属性が設定された、インストールされている編集可能なファイルはすべて、それが同じパッケージ化の操作の一部として削除されている場合は、その名前のファイルを使用します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>release-note</literal></term>
+<listitem><para>この属性は、このファイルにリリースノートテキストが含まれていることを示すために使用されます。この属性の値は、パッケージ FMRI です。元のイメージに存在し、元のイメージ内のパッケージよりも新しいバージョンのパッケージ名が FMRI で指定されている場合、このファイルはリリースノートに含まれます。特別な FMRI (<literal>feature/pkg/self</literal>) は、含まれるパッケージを指します。<literal>feature/pkg/self</literal> のバージョンが 0 の場合、このファイルは初期インストールのリリースノートにのみ含まれます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>revert-tag</literal></term>
+<listitem><para>この属性は、セットとして元に戻すべき編集可能なファイルをタグ付けするために使用されます。<literal>revert-tag</literal> 属性の値は <replaceable>tagname</replaceable> です。単一の <literal>file</literal> アクションに対して複数の <literal>revert-tag</literal> 属性を指定できます。これらのいずれかのタグを指定して <command>pkg revert</command> が呼び出されると、ファイルはマニフェストで定義された状態に戻ります。<command>pkg revert</command> コマンドの詳細については、<command>pkg</command>(1) マニュアルページを参照してください。</para>
+<para><literal>revert-tag</literal> 属性は、ディレクトリレベルでも指定できます。後述の「ディレクトリアクション」を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>sysattr</literal></term>
+<listitem><para>この属性は、このファイルに設定する必要があるシステム属性を指定するために使用されます。<literal>sysattr</literal> 属性の値は、次の例に示すように、詳細システム属性のカンマ区切りリストまたはコンパクトシステム属性オプションの文字列シーケンスの場合があります。サポートされるシステム属性は、<literal>chmod</literal>(1) マニュアルページで説明されています。マニフェストに指定されるシステム属性は、オペレーティングシステムのほかのサブシステムによって設定される場合があるシステム属性に追加で設定されます。</para>
+<programlisting>file path=opt/secret_file sysattr=hidden,sensitive
+file path=opt/secret_file sysattr=HT</programlisting>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>timestamp</literal></term>
+<listitem><para>この属性は、ファイルに対するアクセスおよび変更時間を設定するために使用します。<literal>timestamp</literal> 属性値は、コロンおよびハイフンを省略した、ISO-8601 形式の UTC で表現する必要があります。</para>
+<para><literal>timestamp</literal> 属性は、Python 用の <filename>.pyc</filename> または <filename>.pyo</filename> ファイルをパッケージングする場合に不可欠です。<filename>.pyc</filename> または <filename>.pyo</filename> ファイルに関連する <filename>.py</filename> ファイルは、次の例で示すように、これらのファイル内に埋め込まれたタイムスタンプを使用してマーク付けする必要があります。</para>
+<programlisting>file path=usr/lib/python2.7/vendor-packages/pkg/__init__.pyc ...
+file path=usr/lib/python2.7/vendor-packages/pkg/__init__.py &bsol;
+     timestamp=20130311T221521Z ...</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>file</literal> アクションに対する次の属性はシステムによって自動的に生成されるため、パッケージ開発者によって指定しないでください。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>hash</literal></term>
+<listitem><para>非圧縮ファイルの SHA-1 ハッシュ。</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>chash</literal></term>
+<listitem><para>圧縮ファイルの SHA-1 ハッシュ。</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.size</literal></term>
+<listitem><para>非圧縮ファイルのバイト単位のサイズ。</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.csize</literal></term>
+<listitem><para>圧縮ファイルのバイト単位のサイズ。</para></listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>ディレクトリアクション</title>
+<para><literal>dir</literal> アクションは、ファイルシステムオブジェクトを表すという点で <command>file</command> アクションに似ています。<literal>dir</literal> アクションは、通常ファイルの代わりにディレクトリを表します。<literal>dir</literal> アクションには、<literal>file</literal> アクションが持つのと同じ <literal>path</literal>、<literal>mode</literal>、<literal>owner</literal>、および <literal>group</literal> 属性があり、<literal>path</literal> がキー属性です。<literal>dir</literal> アクションは <literal>revert-tag</literal> 属性も受け入れます。<literal>revert-tag</literal> 属性の値は、<literal>file</literal> アクションと <literal>dir</literal> アクションで異なります。</para>
+<para>ディレクトリは、IPS でカウントされる参照です。あるディレクトリを明示的または暗黙的に参照している最後のパッケージが参照を行わなくなると、そのディレクトリは削除されます。そのディレクトリにパッケージ解除されたファイルシステムオブジェクトが含まれている場合、それらの項目は <filename>$IMAGE_META/lost+found</filename> に移動されます。<literal>$IMAGE_META</literal> についての詳細は、「ファイル」のセクションを参照してください。</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><literal>revert-tag</literal></term>
+<listitem>
+<para>この属性は、セットとして削除する必要があるパッケージ解除されたファイルを識別するために使用します。<literal>file</literal> アクションに対してこの属性を指定する方法についての説明は、上記の「ファイルアクション」を参照してください。ディレクトリの場合、<literal>revert-tag</literal> 属性の値は <replaceable>tagname</replaceable><literal>=</literal><replaceable>pattern</replaceable> です。単一の <literal>dir</literal> アクションに対して複数の <literal>revert-tag</literal> 属性を指定できます。マッチングする <replaceable>tagname</replaceable> を指定して <command>pkg revert</command> が呼び出されると、<replaceable>pattern</replaceable> に一致する (シェルグロビング文字を使用)、この <literal>dir</literal> ディレクトリの下にあるパッケージ解除されたファイルまたはディレクトリが削除されます。<command>pkg revert</command> コマンドの詳細については、<command>pkg</command>(1) マニュアルページを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>salvage-from</literal></term>
+<listitem><para>この属性は、パッケージ解除された内容を新しいディレクトリに移動する場合に使用できます。この属性の値は、回収された項目のディレクトリの名前です。<literal>salvage-from</literal> 属性を持つディレクトリは、作成時に、<literal>salvage-from</literal> 属性の値に指定されたディレクトリのすべての内容を継承します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>リンクアクション</title>
+<para><literal>link</literal> アクションはシンボリックリンクを表します。<literal>link</literal> アクションには、次の標準属性があります。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>path</literal></term>
+<listitem><para>シンボリックリンクがインストールされるファイルシステムのパス。これは <literal>link</literal> アクションのキー属性です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>target</literal> </term>
+<listitem><para>シンボリックリンクのターゲット。リンクの解決先のファイルシステムオブジェクト。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator</literal></term>
+<listitem><para>特定のメディエーショングループ (たとえば、<literal>python</literal>) に参加しているすべてのパス名によって共有されているメディエーション名前空間内のエントリを指定します。<literal>mediator-version</literal> または <literal>mediator-implementation</literal>、あるいはその両方に基づいてリンクメディエーションを実行できます。特定のパス名に対してメディエートされたリンクはすべて、同じメディエータを指定する必要があります。ただし、すべてのメディエータバージョンおよび実装が、特定のパスでリンクを提供する必要はありません。メディエーションがリンクを提供していない場合は、そのメディエーションが選択されたときにリンクが削除されます。特定のバージョンまたは実装、あるいはその両方と組み合わせた <literal>mediator</literal> は、パッケージシステムで使用するために選択できるメディエーションを表します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-version</literal></term>
+<listitem><para><literal>mediator</literal> 属性で記述されたインタフェースの (負にならない整数のドットで区切られた並びとして表された) バージョンを指定します。この属性は、<literal>mediator</literal> が指定され、<literal>mediator-implementation</literal> は指定されていない場合に必要です。ローカルシステム管理者は、使用するバージョンを明示的に設定できます。指定された値は一般に、リンクを提供しているパッケージのバージョンに一致するようにしてください (たとえば、<literal>runtime/python-27</literal> は <literal>mediator-version=2.7</literal> を使用します)。ただし、これは必須ではありません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-implementation</literal></term>
+<listitem><para><literal>mediator-version</literal> に加えて、またはこの代わりに使用するメディエータの実装を指定します。実装の文字列は順序付けられているとは見なされず、システム管理者によって明示的に指定されていない場合は、<literal>pkg </literal>(5) によって文字列が任意に選択されます。</para>
+<para>この値は、英数字とスペースで構成された任意の長さの文字列にすることができます。実装自体をバージョン管理できるか、または実際にバージョン管理されている場合は、文字列の最後の @ のあとに (負にならない整数のドットで区切られた並びとして表された) バージョンを指定します。実装の複数のバージョンが存在する場合、デフォルトの動作では、最大のバージョンを持つ実装が選択されます。</para>
+<para>特定のパスにある実装メディエーションリンクの 1 つのインスタンスだけがシステムにインストールされている場合は、その 1 つのインスタンスが自動的に選択されます。このパスにある将来のリンクがインストールされても、ベンダー、サイト、またはローカルのオーバーライドが適用されないかぎり、またはいずれかのリンクのバージョンがメディエートされた場合、このリンクは切り替えられません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-priority</literal></term>
+<listitem><para>メディエートされたリンクの競合を解決する場合、<literal>pkg</literal>(5) は通常、<literal>mediator-version</literal> の最大の値を持つリンクを選択するか、またはそれが不可能な場合は <literal>mediator-implementation</literal> に基づいて選択します。この属性は、正常な競合解決処理のためのオーバーライドを指定するために使用されます。</para>
+<para>この属性が指定されていない場合は、デフォルトのメディエータ選択ロジックが適用されます。</para>
+<para>この値が <literal>vendor</literal> である場合は、このリンクが、<literal>mediator-priority</literal> が指定されていないリンクより優先されます。</para>
+<para>この値が <literal>site</literal> である場合は、このリンクが、<literal>vendor</literal> の値を持つリンクや、<literal>mediator-priority</literal> が指定されていないリンクより優先されます。</para>
+<para>ローカルシステム管理者は、上で説明した選択ロジックをオーバーライドできます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>ハードリンクアクション</title>
+<para><literal>hardlink</literal> アクションは、ハードリンクを表します。このアクションは <literal>link</literal> アクションと同じ属性を持ち、そのキー属性も同じく <literal>path</literal> です。</para>
+</refsect2>
+<refsect2><title>ドライバアクション</title>
+<para><literal>driver</literal> アクションはデバイスドライバを表します。<literal>driver</literal> アクションはペイロードを参照しません。ドライバファイル自体を <literal>file</literal> アクションとしてインストールする必要があります。次の属性が認識されます (詳細は <command>add_drv</command>(1M) を参照)。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>name</literal></term>
+<listitem><para>ドライバの名前。多くの場合はドライババイナリのファイル名ですが、必ずしもそうとは限りません。これは <literal>driver</literal> アクションのキー属性です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>alias</literal></term>
+<listitem><para>これはドライバの別名を表します。特定のドライバが複数の <literal>alias</literal> 属性を持つことができます。特殊な引用符の規則は必要ありません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>class</literal></term>
+<listitem><para>これはドライバクラスを表します。特定のドライバが複数の <literal>class</literal> 属性を持つことができます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>perms</literal></term>
+<listitem><para>これは、ドライバのデバイスノードのファイルシステムアクセス権を表します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>clone_perms</literal></term>
+<listitem><para>これは、このドライバに対する複製ドライバのマイナーノードのファイルシステムアクセス権を表します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>policy</literal></term>
+<listitem><para>これは、デバイスのための追加のセキュリティーポリシーを指定します。特定のドライバが複数の <literal>policy</literal> 属性を持つことができますが、マイナーデバイスの指定が複数の属性に存在することはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>privs</literal></term>
+<listitem><para>これは、ドライバで使用される特権を指定します。特定のドライバが複数の <literal>privs</literal> 属性を持つことができます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>devlink</literal></term>
+<listitem><para>これは <filename>/etc/devlink.tab</filename> 内のエントリを指定します。この値はファイルに書き込まれる行そのものであり、タブは <literal>\t</literal> で示されます。詳細は、<literal>devlinks</literal>(1M) を参照してください。特定のドライバが複数の <literal>devlink</literal> 属性を持つことができます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>依存アクション</title>
+<para><command>depend</command> アクションは、パッケージ間の依存関係を表します。あるパッケージが別のパッケージに依存することがあります。たとえば、最初のパッケージの機能を有効にする (場合によってはインストールする) ために、2 番目のパッケージの機能が必要な場合があります。依存関係はオプションです。インストール時に依存関係が満たされない場合、パッケージシステムはほかの制約に応じて、依存パッケージをインストールするか、または十分に新しいバージョンに更新しようとします。</para>
+<para>次の属性が認識されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>fmri</literal></term>
+<listitem><para>依存パッケージを表す FMRI。これは <literal>dependency</literal> アクションのキー属性です。<literal>fmri</literal> 値にパブリッシャーを含めることはできません。パッケージ名は完全であると見なされます。タイプ <literal>require-any</literal> の依存関係は、複数の <literal>fmri</literal> 属性を持つことができます。<literal>fmri</literal> 値でバージョンはオプションですが、依存関係のタイプによっては、バージョンのない <literal>fmri</literal> は無意味である場合があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>type</literal></term>
+<listitem><para>依存関係のタイプ。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>require</literal></term>
+<listitem><para>依存関係が必要であり、かつ <literal>fmri</literal> 属性で指定されたバージョン以上のバージョンを持っている必要があります。バージョンが指定されていない場合は、任意のバージョンが依存関係を満たします。パッケージの必要な依存関係のいずれかを満たすことができない場合、そのパッケージはインストールできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>optional</literal></term>
+<listitem><para>依存関係が存在する場合は、指定されたバージョンレベル以上である必要があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exclude</literal></term>
+<listitem><para>指定されたバージョンレベル以上という依存関係が存在する場合は、含んでいるパッケージをインストールできません。バージョンが指定されていない場合、依存パッケージは、依存関係を指定しているパッケージと同時にインストールできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>incorporate</literal></term>
+<listitem><para>依存関係はオプションですが、依存するパッケージのバージョンは制約されます。以下の「制約と凍結」を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-any</literal></term>
+<listitem><para>複数の <literal>fmri</literal> 属性で指定された複数の依存パッケージのうちのいずれか 1 つが、依存関係のタイプ <literal>require</literal> と同じ規則に従って依存関係を満たすことができます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>conditional</literal></term>
+<listitem><para>依存関係は、<literal>predicate</literal> 属性で定義されたパッケージがシステム上に存在する場合にのみ必要です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>origin</literal></term>
+<listitem><para>このパッケージのインストールの前に、依存関係のターゲット (存在する場合) は変更されるイメージ上の指定された値以上である必要があります。<literal>root-image</literal> 属性の値が <literal>true</literal> である場合、このパッケージをインストールするには、/ をルートとするイメージ上にターゲットが存在する必要があります。<literal>root-image</literal> 属性の値が <literal>true</literal> で、<literal>fmri</literal> 属性の値が <literal>pkg:/feature/firmware/</literal> で始まる場合、<literal>fmri</literal> 値の残りの部分は、ファームウェアの依存関係を評価する <filename>/usr/lib/fwenum</filename> 内のコマンドとして扱われます。例については、「<citetitle>Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle>」を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal> </term>
+<listitem><para>依存関係は、パッケージがイメージ回避リスト上にないかぎり必要です。廃止されたパッケージは、暗黙のうちにグループの依存関係を満たすことに注意してください。<command>pkg</command>(1) の <command>avoid</command> サブコマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>parent</literal></term>
+<listitem><para>依存関係は、イメージが子イメージでない場合は無視されます。このイメージが子イメージである場合は、親イメージ内に依存関係が存在する必要があります。<literal>parent</literal> 依存関係でのパッケージバージョンの照合は、<literal>incorporate</literal> 依存関係で使用されるものと同じです。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>predicate</literal></term>
+<listitem><para><literal>conditional</literal> 依存関係の述語を表す FMRI。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>root-image</literal></term>
+<listitem><para>先に説明した <literal>origin</literal> 依存関係に対してのみ有効です。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>ライセンスアクション</title>
+<para><literal>license</literal> アクションは、パッケージの内容に関連したライセンスやその他の情報ファイルを表します。パッケージは <literal>license</literal> アクションの使用を通して、ライセンス、免責条項、またはその他のガイダンスをパッケージインストーラに提供できます。</para>
+<para><literal>license</literal> アクションのペイロードは、パッケージに関連したイメージメタデータディレクトリに提供され、人間が読める形式のテキストデータのみが含まれているべきです。HTML やその他の形式のマークアップが含まれていてはいけません。<literal>license</literal> アクションは、属性を通して、関連するペイロードが表示または同意、あるいはその両方を必要としていることをクライアントに示すことができます。表示または同意、あるいはその両方の方法は、クライアントに任されています。</para>
+<para>次の属性が認識されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>license</literal></term>
+<listitem><para>これは <literal>license</literal> アクションのキー属性です。この属性は、ユーザーがライセンスのテキスト自体を読まなくてもその内容を判断できるように支援するための、ライセンスの意味のある説明を提供します。この値のいくつかの例を次に示します。</para>
+<itemizedlist>
+<listitem><para>ABC Co. Copyright Notice</para></listitem>
+<listitem><para>ABC Co. Custom License</para></listitem>
+<listitem><para>Common Development and Distribution License 1.0 (CDDL)</para>
+</listitem>
+<listitem><para>GNU General Public License 2.0 (GPL)</para></listitem>
+<listitem><para>GNU General Public License 2.0 (GPL) Only</para></listitem>
+<listitem><para>MIT License</para></listitem>
+<listitem><para>Mozilla Public License 1.1 (MPL)</para></listitem>
+<listitem><para>Simplified BSD License</para></listitem>
+</itemizedlist>
+<para><literal>license</literal> 値は、パッケージ内で一意である必要があります。上のいくつかの例に示すように、説明にライセンスのバージョンを含めることをお勧めします。パッケージに複数のライセンスに基づくコードが含まれる場合、複数の <literal>license</literal> アクションを使用します。ライセンス属性値の長さは、64 文字以下にしてください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>must-accept</literal></term>
+<listitem><para><literal>true</literal> の場合は、関連するパッケージをインストールまたは更新するには、ユーザーがこのライセンスに同意する必要があります。この属性を省略すると、<literal>false</literal> と同等になります。同意の方法 (たとえば、対話型または構成ベース) は、クライアントに任されています。パッケージの更新については、ライセンスアクションまたはペイロードが変更されていない場合、この属性は無視されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>must-display</literal></term>
+<listitem><para><literal>true</literal> の場合は、パッケージ化の操作中に、クライアントがこのアクションのペイロードを表示する必要があります。この値を省略すると、<literal>false</literal> と同等になります。この属性は、コピーライト表示に使用しないでください。この属性は、操作中に表示する必要のある実際のライセンスまたはその他の素材にのみ使用してください。表示の方法は、クライアントに任されています。パッケージの更新については、ライセンスアクションまたはペイロードが変更されていない場合、この属性は無視されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>レガシーアクション</title>
+<para><literal>legacy</literal> アクションは、従来のパッケージシステムで使用されるパッケージデータを表します。このアクションに関連付けられた属性は、従来のシステムのデータベースに追加されます。そのため、これらのデータベースに問い合わせを行なっているツールは、従来のパッケージが実際にインストールされているかのように動作できます。特にこれにより、<literal>pkg</literal> 属性で指定されたパッケージがシステムにインストールされていることを従来のシステムに十分に確信させることができるため、このパッケージを、依存関係を満たすために使用できるようになります。</para>
+<para><literal>pkginfo</literal>(4) のパラメータに従って指定された次の属性が認識されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>category</literal></term>
+<listitem><para><literal>CATEGORY</literal> パラメータの値。デフォルト値は <literal>system</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>desc</literal></term>
+<listitem><para><literal>DESC</literal> パラメータの値。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>hotline</literal></term>
+<listitem><para><literal>HOTLINE</literal> パラメータの値。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>name</literal></term>
+<listitem><para><literal>NAME</literal> パラメータの値。デフォルト値は <literal>none provided</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg</literal></term>
+<listitem><para>インストールされるパッケージの略語。デフォルト値は、パッケージの FMRI の名前です。これは <literal>legacy</literal> アクションのキー属性です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>vendor</literal></term>
+<listitem><para><literal>VENDOR</literal> パラメータの値。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>version</literal></term>
+<listitem><para>VERSION パラメータの値。デフォルト値は、パッケージの FMRI のバージョンです。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>設定アクション</title>
+<para><literal>set</literal> アクションは、パッケージの説明などの、パッケージレベルの属性 (またはメタデータ) を表します。</para>
+<para>次の属性が認識されます。</para>
+<variablelist>
+<varlistentry><term><literal>name</literal></term>
+<listitem><para>属性の名前。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>value</literal></term>
+<listitem><para>属性に与えられた値。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>set</literal> アクションは、パッケージ作成者が選択した任意のメタデータを提供できます。ただし、パッケージシステムにとって特別な意味を持つ、適切に定義された属性名がいくつか存在します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>info.classification</literal></term>
+<listitem><para><literal>pkg</literal>(5) クライアントがパッケージを分類するために使用できる 1 つ以上のトークン。この値には、スキーム (「org.opensolaris.category.2008」や「org.acm.class.1998」など) と実際の分類 (「アプリケーション/ゲーム」など) がコロン (:) で区切られて含まれています。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.description</literal></term>
+<listitem><para>パッケージの内容と機能の詳細な説明。通常は、1 つの段落程度の長さです。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.fmri</literal></term>
+<listitem><para>含まれるパッケージの名前とバージョン。「説明」セクションの「パッケージの FMRI とバージョン」を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.human-version</literal></term>
+<listitem><para>IPS によって使用されるバージョンスキームは厳格です。「説明」セクションの「パッケージの FMRI とバージョン」を参照してください。より柔軟性のあるバージョンを <literal>pkg.human-version</literal> 属性の値として指定できます。値は IPS ツール (<command>pkg info</command>、<command>pkg contents</command>、<command>pkg search</command> など) によって表示されます。<literal>pkg.human-version</literal> の値はバージョン比較のベースとして使用されず、<literal>pkg.fmri</literal> バージョンの代わりに使用することはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.obsolete</literal></term>
+<listitem><para><literal>true</literal> の場合、パッケージは廃止としてマークされています。廃止されたパッケージには、ほかの設定アクション以外のアクションは存在せず、また名前変更としてマークすることはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.renamed</literal></term>
+<listitem><para><literal>true</literal> の場合は、パッケージの名前が変更されました。このパッケージには、このパッケージの名前が変更された先のパッケージバージョンを指す 1 つ以上の <literal>depend</literal> アクションも存在する必要があります。パッケージを名前変更と廃止の両方としてマークすることはできませんが、それ以外は任意の数の設定アクションが存在できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.summary</literal></term>
+<listitem><para>パッケージの短い、1 行の説明。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>グループアクション</title>
+<para><literal>group</literal> アクションは、<literal>group</literal>(4) で定義されるのと同様の UNIX グループを定義します。グループパスワードのサポートはありません。このアクションで定義されたグループには最初、ユーザーリストがありません。ユーザーは、<literal>user</literal> アクションを使用して追加できます。次の属性が認識されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>groupname</literal></term>
+<listitem><para>グループの名前の値。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>gid</literal></term>
+<listitem><para>グループの一意の数値 ID。デフォルト値は、100 未満の最初に空いているグループです。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>ユーザーアクション</title>
+<para><literal>user</literal> アクションは、<filename>/etc/passwd</filename>、<filename>/etc/shadow</filename>、<filename>/etc/group</filename>、および <filename>/etc/ftpd/ftpusers</filename> ファイルで定義されるのと同様の UNIX ユーザーを定義します。この <literal>user</literal> アクションで定義されたユーザーについて、エントリが適切なファイルに追加されます。</para>
+<para><literal>user</literal> アクションは、デーモンまたは使用するほかのソフトウェアのためにユーザーを定義することを目的としています。管理または対話アカウントを定義する目的で <literal>user</literal> アクションを使用しないでください。</para>
+<para>次の属性が認識されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>username</literal></term>
+<listitem><para>ユーザーの一意の名前。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>password</literal></term>
+<listitem><para>ユーザーの暗号化パスワード。デフォルト値は <literal>*LK*</literal> です。<literal>shadow</literal>(4) を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>uid</literal></term>
+<listitem><para>ユーザーの一意の UID。デフォルト値は、100 未満の最初に空いている値です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal> </term>
+<listitem><para>ユーザーのプライマリグループの名前。<filename>/etc/group</filename> に存在する必要があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>gcos-field</literal></term>
+<listitem><para><filename>/etc/passwd</filename> 内の <literal>gcos</literal> フィールドの値。デフォルト値は <literal>username</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>home-dir</literal></term>
+<listitem><para>ユーザーのホームディレクトリ。このディレクトリはシステムイメージディレクトリ内にある必要があり、<filename>/home</filename> などの別のマウントポイントの下であってはいけません。デフォルト値は <literal>/</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>login-shell</literal></term>
+<listitem><para>ユーザーのデフォルトのシェル。デフォルト値は空です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group-list</literal></term>
+<listitem><para>ユーザーが属しているセカンダリグループ。<literal>group</literal>(4) を参照してください。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>ftpuser</literal></term>
+<listitem><para><literal>true</literal> または <literal>false</literal> に設定できます。<literal>true</literal> のデフォルト値は、ユーザーが FTP 経由のログインを許可されていることを示します。<literal>ftpusers</literal>(4) を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>lastchg</literal></term>
+<listitem><para>1970 年 1 月 1 日と、パスワードが最後に変更された日付の間の日数。デフォルト値は空です。<literal>shadow</literal>(4) を参照してください。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>min</literal> </term>
+<listitem><para>パスワード変更の間の必要な最小日数。パスワードの有効期限を有効にするには、このフィールドを 0 以上に設定する必要があります。デフォルト値は空です。<literal>shadow</literal>(4) を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>max</literal> </term>
+<listitem><para>パスワードが有効な最大日数。デフォルト値は空です。<literal>shadow</literal>(4) を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>warn</literal></term>
+<listitem><para>パスワードの期限が切れる前にユーザーに警告が表示される日数。<literal>shadow</literal>(4) を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>inactive</literal></term>
+<listitem><para>そのユーザーに許可されている非活動の日数。これはマシンごとにカウントされます。最終ログインに関する情報は、そのマシンの <filename>lastlog</filename> ファイルから取得されます。<literal>shadow</literal>(4) を参照してください。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>expire</literal></term>
+<listitem><para>UNIX エポック (1970 年 1 月 1 日) 以降の日数として表される絶対的な日付。この日数に達すると、ログインを使用できなくなります。たとえば、13514 の期限切れの値は、ログインの有効期限が 2007 年 1 月 1 日であることを指定します。<literal>shadow</literal>(4) を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>flag</literal></term>
+<listitem><para>空に設定されています。<literal>shadow</literal>(4) を参照してください。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+<refsect1 role="other"><title>アクチュエータ</title>
+<para>コンテキストによっては、特定のアクションの準備として、またはその導入のあとに、追加の操作を実行することが適している場合があります。これらの追加の操作はオペレーティングシステムに固有のもので、一般にライブシステムイメージ上でのみ必要です。ライブイメージは、現在のゾーンのアクティブな実行中のブート環境の <literal>/</literal> にマウントされたイメージです。パッケージのインストールまたは削除に関与する複数のアクションのアクチュエータが同一である場合、アクチュエータの存在に対応する操作は、そのインストールまたは削除に対して 1 回実行されます。</para>
+<para>アクチュエータを誤って指定すると、そのアクチュエータがインストールを安全に進めるための手段を決定できない場合、パッケージのインストールが失敗することがあります。</para>
+<para>次のアクチュエータが定義されています。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>reboot-needed</literal></term>
+<listitem><para><literal>true</literal> または <literal>false</literal> に設定できます。このアクチュエータは、パッケージシステムがライブイメージ上で動作している場合、タグ付きアクションの更新または削除を新しいブート環境で実行する必要があることを宣言します。新しいブート環境の作成は、<literal>be-policy</literal> イメージプロパティーによって制御されます。<literal>be-policy</literal> プロパティーについての詳細は、<literal>pkg</literal>(1) のマニュアルページの「イメージプロパティー」セクションを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>disable_fmri</literal>、<literal>refresh_fmri</literal>、<literal>restart_fmri</literal>、<literal>suspend_fmri</literal></term>
+<listitem><para>これらの各アクチュエータは、パッケージのインストールまたは削除中に操作するサービスインスタンスの FMRI の値を取ります。<literal>disable_fmri</literal> を指定すると、<literal>svcadm</literal>(1M) の <literal>disable</literal> サブコマンドに従って、アクションの削除の前に特定の FMRI が無効になります。<literal>refresh_fmri</literal> および <literal>restart_fmri</literal> を指定すると、<literal>svcadm</literal>(1M) の対応するサブコマンドに従って、アクションのインストール、更新、または削除のあとに特定の FMRI が更新または再起動されます。最後に、<literal>suspend_fmri</literal> を指定すると、アクションのインストールフェーズの前に特定の FMRI が一時的に無効になり、そのフェーズが完了したあとに有効になります。</para>
+<para>この値には、複数のサービスインスタンスに一致するパターンを含めることができます。ただし、それをインスタンスを示さずに暗黙的に行うのではなく、<literal>svcs</literal>(1) によって受け入れられた glob を使用して明示的に行う必要があります。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>メディエーション</title>
+<para>メディエータは、一連の関連するシンボリックリンクまたはハードリンクを表す名前です。2 つ以上のリンクアクションが同じパスとメディエータ名を持つ場合、ユーザーまたはパッケージシステムは、バージョン、実装、または優先度に基づいてリンクターゲットを選択します。メディエータ属性については、「リンクアクション」を参照してください。</para>
+<para>次の例は、リンクがバージョンによって選択される、<literal>java</literal> という名前のメディエータの 2 つの異なるインスタンスを示しています。これらの 2 つの <literal>link</literal> アクションは 2 つの異なるパッケージに出現します。</para>
+<programlisting>link mediator=java mediator-version=1.6 path=usr/java target=jdk/jdk1.6.0_31
+link mediator=java mediator-version=1.7 path=usr/java target=jdk/jdk1.7.0_02</programlisting>
+<para>このリンクパスのバージョンを選択する方法については、<command>pkg</command>(1) のマニュアルページの <command>set-mediator</command> サブコマンドを参照してください。バージョンを選択するには、両方のパッケージがインストールされている必要があります。</para>
+</refsect1>
+<refsect1 role="other"><title>制約と凍結</title>
+<para>パッケージが新しいバージョンに移行される場合、またはシステムに追加されたり、システムから削除されたりする場合、選択されるバージョンや、削除が許可されるかどうかは、そのパッケージに対するさまざまな制約によって決定されます。これらの制約は、依存関係の形式でほかのパッケージが定義するか、または凍結の形式で管理者が定義できます。</para>
+<para>制約のもっとも一般的な形式は、上の「依存アクション」で説明したように、<literal>require</literal> 依存関係によって提供されます。このような制約によって、パッケージがダウングレードまたは削除されることが回避されます。</para>
+<para>オペレーティングシステムのほとんどの部分は、<emphasis>incorporation</emphasis> と呼ばれるパッケージによってカプセル化されています。これらのパッケージは主に、<literal>incorporate</literal> 依存関係によって表される制約を提供します。</para>
+<para>上で説明したように、組み込まれたパッケージがシステム上に存在する必要はありませんが、存在する場合は、包括的な最小バージョンと排他的な最大バージョンの両方を指定します。たとえば、依存する FMRI のバージョンが 1.4.3 の場合、1.4.3 未満のバージョンは依存関係を満たさず、1.4.4 以上のバージョンでも依存関係を満たしません。ただし、1.4.3.7 など、単にドット形式の数列を拡張したバージョンは許可されます。</para>
+<para>incorporation は、システムの各部の同期的なアップグレードを強制的に行うために使用されます。C ライブラリやカーネルなどの一部のコンポーネントでは、これは基本的な要件です。ほかには依存関係が存在しない単純なユーザーランドコンポーネントなどのその他のコンポーネントでは、incorporation の特定のバージョンから参照できるテストされた、既知の一連のパッケージバージョンを提供するためだけに、同期アップグレードが使用されます。</para>
+<para>incorporation は単なるパッケージであるため、削除することができ、それが提供しているすべての制約がそれによって緩和されます。ただし、その緩和は安全ではないため、Oracle Solaris によって提供される多くの incorporation が、それらの incorporation によって組み込まれているパッケージには必要です。</para>
+<para>パッケージを、インストール済みの incorporation によって許可されていないバージョンにアップグレードしようとしても、要求を満たすためにその incorporation の新しいバージョンを見つけようとする試みは行われず、そのアップグレードは失敗します。制約自体を移動する必要があるが、それを指定している incorporation を削除できない場合は、その incorporation を、制約の目的のバージョンを指定するバージョンにアップグレードする必要があります。incorporation をアップグレードすると、その新しいバージョンによって提供される制約を満たさない組み込まれたパッケージもすべてアップグレードされます。</para>
+<para>システム管理者は、<command>pkg freeze</command> コマンドを使用してパッケージを制約できます。バージョンが指定されていない場合、指定されたパッケージは、システムにインストールされているバージョンに制約されます。バージョン管理されたパッケージが指定された場合、この管理上の制約 (つまり、凍結) は、<literal>fmri</literal> 属性が指定されたパッケージバージョンの値を持った状態で incorporate 依存関係がインストールされているかのように機能します。</para>
+<para>凍結がパッケージシステムによって自動的に解除されることはありません。制約を緩和するには、<command>pkg unfreeze</command> コマンドを使用します。</para>
+</refsect1>
+<refsect1 role="other"><title>発行元とリポジトリ</title>
+<para>上で詳細に説明したように、パブリッシャーとは単に、パッケージクライアントがパッケージのプロバイダを識別するために使用する名前です。パブリッシャーは、パッケージリポジトリまたはパッケージアーカイブ、あるいはその両方を使用してパッケージを配布できます。現在パッケージシステムでサポートされているリポジトリのタイプには、起点リポジトリとミラーリポジトリの 2 つがあります。</para>
+<para><emphasis>起点</emphasis>は、1 つ以上のパッケージのすべてのメタデータ (カタログ、マニフェスト、検索インデックスなど) と内容 (ファイル) を含むパッケージリポジトリです。イメージ内の特定のパブリッシャーに対して複数の起点が構成されている場合、パッケージクライアント API は、パッケージデータの取得元として最適な起点を選択しようとします。これはもっとも一般的なタイプのリポジトリであり、パッケージリポジトリ上で <command>pkgsend</command> または <command>pkgrecv</command> が使用された場合は常に、暗黙的に作成されます。</para>
+<para><emphasis>ミラー</emphasis>は、パッケージの内容 (ファイル) のみを含むパッケージリポジトリです。イメージ内の特定のパブリッシャーに対して 1 つ以上のミラーが構成されている場合、クライアント API はパッケージ内容の取得のためのミラーを優先し、パッケージの内容の取得元として最適なミラーを選択しようとします。ミラーが到達不可能か、必要な内容が含まれていないか、またはより低速な場合、クライアント API は、構成されているいずれかの起点リポジトリから内容を取得します。ミラーは、<command>pkg.depotd</command>(1M) の動的ミラー機能を使用している、信頼できる一連のクライアント間の内容共有に使用されることを目的にしています。ミラーはまた、パッケージのメタデータへのアクセスを認証するために使用されることも目的にしています。ただし、パッケージの内容は認証なしで配布します。たとえば、あるクライアントが、アクセスするには SSL キーと証明書のペアが必要な <literal>https</literal> 起点と、パッケージの内容を提供する <literal>http</literal> ミラーを使用して構成される可能性があります。このようにして、認可クライアントだけがパッケージをインストールまたは更新できるようにしながら、パッケージ内容の取得のための認証のオーバーヘッドが回避されます。ミラーは、<filename>file</filename> という名前のサブディレクトリとその親を除く、リポジトリのすべてのサブディレクトリを削除することによって作成できます。また、<command>pkg.depotd</command>(1M) のミラーモードを使用すると、起点リポジトリもミラーとしてプロビジョニングできます。</para>
+</refsect1>
+<refsect1 role="other"><title>大域ゾーンと非大域ゾーンの更新</title>
+<para><literal>pkg</literal> システムは、非大域ゾーンを強制的に大域ゾーンと同期された状態に保持します。つまり、同じカーネルが確実に実行されるようにするために、特定のパッケージを大域ゾーンとすべての非大域ゾーンで同じバージョンにする必要があります。このために、<literal>pkg</literal> は <literal>parent</literal> 依存関係を使用して、非大域ゾーンに特定の制約を課します。<literal>parent</literal> 依存関係についての詳細は、上の「依存アクション」を参照してください。</para>
+<para>大域ゾーンが非大域ゾーンに課す制限のため、非大域ゾーンは大域ゾーンのパッケージにアクセスできる必要があり、かつ同様の発行元構成にする必要があります。これらの目的はどちらも、<emphasis role="strong">システムリポジトリ</emphasis> を使用して実現されます (<literal>pkg.sysrepo</literal>(1M) のマニュアルページを参照)。システムリポジトリは、大域ゾーン内で構成された発行元へのアクセスと、これらの発行元が構成されている方法に関する情報を提供します。インストールまたは更新中に非大域ゾーンで別のパッケージが選択されないようにするために、発行元の検索順序で、システム発行元には非大域ゾーン内で構成された発行元より高くランク付けされます。発行元の検索順序については、<literal>pkg</literal>(1) のマニュアルページの <command>pkg set-publisher</command> コマンドを参照してください。</para>
+<para>システム上のすべての非大域ゾーンを更新するには、大域ゾーン内で <command>pkg update</command> コマンドを引数なしで使用します。このコマンドは大域ゾーンに対して、また各非大域ゾーンに対して再帰的に動作します。非大域ゾーンを大域ゾーン内で行われた変更と同期された状態にするために、非大域ゾーンに対して必要な最小の変更が加えられます。たとえば、パッケージ <literal>foo</literal> が大域ゾーンと非大域ゾーンの両方にバージョン 1 でインストールされており、システムリポジトリ内でバージョン 2 が使用可能であると想定します。<literal>foo</literal> に親の依存関係が存在する場合、<literal>parent</literal> 依存関係によってパッケージは強制的に同期された状態に保持されるため、<command>pkg update foo</command> は <literal>foo</literal> を大域ゾーンと非大域ゾーンの両方でバージョン 2 に更新します。<literal>foo</literal> に親の依存関係が存在しない場合、<literal>foo</literal> は大域ゾーンでバージョン 2 に更新されますが、非大域ゾーンではバージョン 1 のままになります。</para>
+</refsect1>
+<refsect1 role="other"><title>ファセットとバリアント</title>
+<para>ソフトウェアには、省略可能なコンポーネントや、相互に排他的なコンポーネントが含まれることがあります。省略可能なコンポーネントの例には、ロケールやドキュメントがあります。相互に排他的なコンポーネントの例には、SPARC バイナリと x86 バイナリや、デバッグバイナリと非デバッグバイナリなどがあります。</para>
+<para>IPS では、省略可能なコンポーネントを<emphasis>ファセット</emphasis>、相互に排他的なコンポーネントを<emphasis>バリアント</emphasis>と呼びます。ファセットとバリアントはパッケージアクションのタグとして指定します。各ファセットタグおよびバリアントタグには名前と値があります。1 つのアクションに複数のファセットタグおよびバリアントタグを付けることができます。複数のファセットおよびバリアントタグのあるコンポーネントの例には、開発者によって使われるアーキテクチャー固有のヘッダーファイルや SPARC 大域ゾーン専用のコンポーネントなどがあります。</para>
+<para>バリアントタグの例は <literal>variant.arch=sparc</literal> です。ファセットタグの例は <literal>facet.devel=true</literal> です。ファセットとバリアントは、<literal>facet.</literal> や <literal> variant.</literal> を先頭に付けずに参照されることがよくあります。</para>
+<para>ファセットとバリアントはイメージの特殊なプロパティーであり、個々のパッケージには設定できません。イメージに設定されたファセットおよびバリアントの現在の値を表示するには、<command>pkg</command>(1) のマニュアルページに示すように、<command>pkg facet</command> コマンドと <command>pkg variant</command> コマンドを使用します。イメージに設定されたファセットおよびバリアントの値を変更するには、<command>pkg change-facet</command> コマンドと <command> pkg change-variant</command> コマンドを使用します。</para>
+<para>ファセットは、パッケージクライアントによってブール値として扱われ、ファセットは、イメージ内で <literal>true</literal> (有効) または <literal>false</literal> (無効) にのみ設定できます。デフォルトでは、「facet.debug.」または「facet.optional.」で始まるファセットはすべて、イメージ内で <literal>false</literal> に設定されているとみなされます。その他はすべて、イメージ内で <literal>true</literal> に設定されているとみなされます。</para>
+<para>ファセットは、<command>pkg change-facet</command> コマンドを使用してイメージ内でローカルに設定するか、親イメージから継承することができます。たとえば、非大域ゾーンは大域ゾーンからファセットを継承できます。継承されたファセットは、ローカルで設定されたファセットよりも先に評価され、優先されます。同じファセットが、継承もローカル設定もされた場合、継承されたファセット値によって、ローカルで設定された値がマスクされます。マスクされたファセットは、ファセットの評価とパッケージアクションに影響しません。<command>pkg change-facet</command> コマンドを使用して行われるファセット変更は、ローカルで設定されたファセットにのみ影響します。継承されたファセットは、親イメージ内で変更を行うことによってのみ変更できます。デフォルトでは、<command>pkg facet</command> コマンドはマスクされたファセットを表示しません。</para>
+<para>ファセットが設定されたアクションをクライアントがフィルタ処理する方法を制御するために、アクションのファセットタグの値を <literal>all</literal> または <literal>true</literal> に設定できます。<literal>all</literal> または <literal>true</literal> 以外のすべての値では、未定義の動作が発生します。ファセットタグを持つアクションをインストールするために、イメージ内に存在する必要のある条件の説明については以下を参照してください。</para>
+<para>ファセットに対する <literal>all</literal> 値は、単一レベルを超えるフィルタリングが必要な場合に便利です。次の例で、<literal>doc</literal> ファセットと、<literal>locale</literal> ファセットの少なくとも 1 つが、イメージ内で <literal>true</literal> の場合のみ、<literal>foo.txt</literal> がインストールされます。これにより、管理者はドキュメントを除外しつつ、特定のロケールのサポートを有効化または無効化できます。さらに、<literal>doc</literal> ファセットと <literal>devel</literal> ファセットの両方がイメージ内で <literal>true</literal> の場合のみ、<literal>api.txt</literal> がインストールされます。</para>
+<programlisting>file path=usr/share/doc/foo/foo.txt facet.doc=all facet.locale.en_GB=true facet.locale.en_US=true
+file path=usr/share/doc/foo/api.txt facet.doc=all facet.devel=all</programlisting>
+<para>イメージに設定されるファセットは、<literal>doc.man</literal> などの完全なファセットか、<literal>locale.*</literal> などのパターンになります。これは、ファセット名前空間の一部を無効にし、その中の個々のファセットのみを有効にする場合に役立ちます。たとえば、次の例に示すように、すべてのロケールを無効にしてから、1 つか 2 つの特定のロケールのみを有効にすることができます。</para>
+<screen># <userinput>pkg change-facet locale.*=false</userinput>
 [output about packages being updated]
-# \fBpkg change-facet locale.en_US=true\fR
-[output about packages being updated]
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-ほとんどのバリアントは任意の数の値を設定できます。たとえば、\fBarch\fR バリアントには、\fBi386\fR、\fBsparc\fR、\fBppc\fR、\fBarm\fR、またはディストリビューションでサポートされているどんなアーキテクチャーでも設定できます。(Oracle Solaris では \fBi386\fR と \fBsparc\fR のみが使用されます。)例外は \fBdebug\fR バリアントです。\fBdebug\fR バリアントには、\fBtrue\fR または \fBfalse\fR のみを設定でき、ほかの値では動作が不確定になります。ファイルアクションに非デバッグバージョンとデバッグバージョンの両方がある場合、次の例に示すように、両方のバージョンに該当する \fBdebug\fR バリアントが明示的に設定されている必要があります。
-.sp
-.in +2
-.nf
-file group=sys mode=0644 overlay=allow owner=root \e
-  path=etc/motd pkg.csize=115 pkg.size=103 preserve=true \e
+# <userinput>pkg change-facet locale.en_US=true</userinput>
+[output about packages being updated]</screen>
+<para>ほとんどのバリアントは任意の数の値を設定できます。たとえば、<literal>arch</literal> バリアントには、<literal>i386</literal>、<literal>sparc</literal>、<literal>ppc</literal>、<literal>arm</literal>、またはディストリビューションでサポートされているどんなアーキテクチャーでも設定できます。(Oracle Solaris では <literal>i386</literal> と <literal>sparc</literal> のみが使用されます。)例外は <literal>debug</literal> バリアントです。<literal>debug</literal> バリアントには、<literal>true</literal> または <literal>false</literal> のみを設定でき、ほかの値では動作が不確定になります。ファイルアクションに非デバッグバージョンとデバッグバージョンの両方がある場合、次の例に示すように、両方のバージョンに該当する <literal>debug</literal> バリアントが明示的に設定されている必要があります。</para>
+<programlisting>file group=sys mode=0644 overlay=allow owner=root &bsol;
+  path=etc/motd pkg.csize=115 pkg.size=103 preserve=true &bsol;
   variant.debug.osnet=true
 
-file group=sys mode=0644 overlay=allow owner=root \e
-  path=etc/motd pkg.csize=68 pkg.size=48 preserve=true \e
-  variant.debug.osnet=false
-.fi
-.in -2
-
-.sp
-.LP
-バリアントを使用するパッケージをインストールするために、バリアント値をイメージに設定する必要があります。\fBarch\fR および \fBzone\fR バリアントは、イメージを作成し、その初期コンテンツをインストールするプログラムによって設定されます。イメージ内の \fBdebug.*\fR バリアントはデフォルトで \fBfalse\fR です。
-.sp
-.LP
-イメージに設定されたファセットとバリアントは、特定のアクションがインストールされるかどうかに影響します。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ファセットまたはバリアントタグのないアクションは常にインストールされます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ファセットタグのあるアクションは、次の条件がイメージ内に存在する場合にインストールされます。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBall\fR 値を持つアクションのすべてのファセットタグが、イメージ内で \fBtrue\fR である (\fBtrue\fR がデフォルトです)。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-アクションのいずれかのファセットタグが、\fBtrue\fR の値を持つ場合、イメージ内のこれらのファセットの少なくとも 1 つが \fBtrue\fR である。
-.RE
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-バリアントタグのあるアクションは、すべてのバリアントタグの値がイメージに設定されている値と同じ場合にのみインストールされます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ファセットタグとバリアントタグの両方があるアクションは、ファセットとバリアントの両方でアクションのインストールが許可されている場合にインストールされます。
-.RE
-.sp
-.LP
-カスタムのファセットタグと \fBvariant.debug.*\fR バリアントタグを作成できます。詳細については、「\fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR」を参照してください。Oracle Solaris では、次のタグが一般に使用されます。
-.sp
-
-.sp
-.TS
-tab();
-cw(2.75i) cw(2.75i) 
-lw(2.75i) lw(2.75i) 
-.
-バリアント名取り得る値
-_
-\fBvariant.arch\fR\fBsparc\fR、\fBi386\fR
-\fBvariant.opensolaris.zone\fR\fBglobal\fR、\fBnonglobal\fR
-\fBvariant.debug.*\fR\fBtrue\fR、\fBfalse\fR
-.TE
-
-.sp
-.LP
-次のリストに、Oracle Solaris で使用される小さなファセットタグの例を示します。
-.sp
-.in +2
-.nf
-facet.devel             facet.doc
+file group=sys mode=0644 overlay=allow owner=root &bsol;
+  path=etc/motd pkg.csize=68 pkg.size=48 preserve=true &bsol;
+  variant.debug.osnet=false</programlisting>
+<para>バリアントを使用するパッケージをインストールするために、バリアント値をイメージに設定する必要があります。<literal>arch</literal> および <literal>zone</literal> バリアントは、イメージを作成し、その初期コンテンツをインストールするプログラムによって設定されます。イメージ内の <literal>debug.*</literal> バリアントはデフォルトで <literal>false</literal> です。</para>
+<itemizedlist>
+<para>イメージに設定されたファセットとバリアントは、特定のアクションがインストールされるかどうかに影響します。</para>
+<listitem><para>ファセットまたはバリアントタグのないアクションは常にインストールされます。</para>
+</listitem>
+<listitem><para>ファセットタグのあるアクションは、次の条件がイメージ内に存在する場合にインストールされます。</para>
+<itemizedlist>
+<listitem><para>アクションのファセットタグのうち、値 <literal>all</literal> を持つものはすべて、イメージ内では <literal>true</literal> です (デフォルトでは、「facet.debug.」または「facet.optional.」で始まるファセットはすべて <literal>false</literal>、その他はすべて <literal>true</literal> です)。</para>
+</listitem>
+<listitem><para>アクションのいずれかのファセットタグが、<literal>true</literal> の値を持つ場合、イメージ内のこれらのファセットの少なくとも 1 つが <literal>true</literal> である。</para>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem><para>バリアントタグのあるアクションは、すべてのバリアントタグの値がイメージに設定されている値と同じ場合にのみインストールされます。</para>
+</listitem>
+<listitem><para>ファセットタグとバリアントタグの両方があるアクションは、ファセットとバリアントの両方でアクションのインストールが許可されている場合にインストールされます。</para>
+</listitem>
+</itemizedlist>
+<para>カスタムのファセットタグと <literal>variant.debug.*</literal> バリアントタグを作成できます。詳細については、「<citetitle>Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle>」を参照してください。Oracle Solaris では、次のタグが一般に使用されます。</para>
+<informaltable frame="topbot">
+<textobject><simpara>バリアントとそれらの取り得る値。</simpara></textobject>
+<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="50*" /><colspec colwidth="50*" /><thead>
+<row rowsep="1">
+<entry>
+<para>バリアント名</para>
+</entry>
+<entry>
+<para>取り得る値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry>
+<para><literal>variant.arch</literal></para>
+</entry>
+<entry>
+<para><literal>sparc</literal>、<literal>i386</literal></para>
+</entry>
+</row>
+<row>
+<entry>
+<para><literal>variant.opensolaris.zone</literal></para>
+</entry>
+<entry>
+<para><literal>global</literal>、<literal>nonglobal</literal></para>
+</entry>
+</row>
+<row>
+<entry>
+<para><literal>variant.debug.*</literal></para>
+</entry>
+<entry>
+<para><literal>true</literal>、<literal>false</literal></para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<para>次のリストに、Oracle Solaris で使用される小さなファセットタグの例を示します。</para>
+<programlisting>facet.devel             facet.doc
 facet.doc.html          facet.doc.info
 facet.doc.man           facet.doc.pdf
 facet.locale.de         facet.locale.en_GB
 facet.locale.en_US      facet.locale.fr
-facet.locale.ja_JP      facet.locale.zh_CN
-.fi
-.in -2
-
-.SH イメージポリシー
-.sp
-.LP
-イメージポリシーはブール値を持つイメージプロパティーによって定義されます。\fBflush-content-cache-on-success\fR および \fBsend-uuid\fR プロパティーについてとそれらの値の表示および変更方法については、\fBpkg\fR(1) のマニュアルページのイメージプロパティーに関する項目を参照してください。
-.SH ファイル
-.sp
-.LP
-\fBpkg\fR(5) イメージはより大きなファイルシステム内に任意に配置できるため、トークン \fB$IMAGE_ROOT\fR を使用して相対パスが区別されます。標準的なシステムインストールでは、\fB$IMAGE_ROOT\fR は / と同等です。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-完全または部分的なイメージのメタデータディレクトリ。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーイメージのメタデータディレクトリ。
-.RE
-
-.sp
-.LP
-特定のイメージのメタデータ内の特定のファイルおよびディレクトリに、修復や復旧中に役立つ情報を含めることができます。トークン \fB$IMAGE_META \fR は、メタデータが含まれる最上位ディレクトリを参照するために使用されます。通常、\fB $IMAGE_META\fR は前述の 2 つのパスのいずれかです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/lost+found\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージ操作中に移動された、競合するディレクトリおよびファイルの場所。
-.RE
+facet.locale.ja_JP      facet.locale.zh_CN</programlisting>
+</refsect1>
+<refsect1 role="other"><title>イメージポリシー</title>
+<para>イメージポリシーはブール値を持つイメージプロパティーによって定義されます。<literal>flush-content-cache-on-success</literal> および <literal>send-uuid</literal> プロパティーについてとそれらの値の表示および変更方法については、<literal>pkg</literal>(1) のマニュアルページのイメージプロパティーに関する項目を参照してください。</para>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para><literal>pkg</literal>(5) イメージはより大きなファイルシステム内に任意に配置できるため、トークン <literal>$IMAGE_ROOT</literal> を使用して相対パスが区別されます。標準的なシステムインストールでは、<literal>$IMAGE_ROOT</literal> は / と同等です。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>完全または部分的なイメージのメタデータディレクトリ。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>ユーザーイメージのメタデータディレクトリ。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>特定のイメージのメタデータ内の特定のファイルおよびディレクトリに、修復や復旧中に役立つ情報を含めることができます。トークン <literal>$IMAGE_META </literal> は、メタデータが含まれる最上位ディレクトリを参照するために使用されます。通常、<literal> $IMAGE_META</literal> は前述の 2 つのパスのいずれかです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_META/lost+found</filename></term>
+<listitem><para>パッケージ操作中に移動された、競合するディレクトリおよびファイルの場所。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/publisher</filename></term>
+<listitem><para>パブリッシャーごとに 1 つのディレクトリが含まれます。各ディレクトリにはパブリッシャー固有のメタデータが格納されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>$IMAGE_META</literal> ディレクトリ階層内のその他のパスは非公開であり、変更される可能性があります。</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.sysrepo-1m"><citerefentry><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="svcs-1"><citerefentry><refentrytitle>svcs</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="svcadm-1m"><citerefentry><refentrytitle>svcadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="AUOSS"><citetitle remap="book">Adding and Updating Software in Oracle Solaris 11.3</citetitle></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><olink targetdoc="PKDEV"><citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-パブリッシャーごとに 1 つのディレクトリが含まれます。各ディレクトリにはパブリッシャー固有のメタデータが格納されます。
-.RE
-
-.sp
-.LP
-\fB$IMAGE_META\fR ディレクトリ階層内のその他のパスは非公開であり、変更される可能性があります。
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(1), \fBpkgsend\fR(1), \fBpkg.depotd\fR(1M), \fBpkg.sysrepo\fR(1M), \fBsvcs\fR(1), \fBsvcadm\fR(1M)
-.sp
-.LP
-\fI『Adding and Updating Software in Oracle Solaris 11.2 』\fR
-.sp
-.LP
-\fI『Copying and Creating Package Repositories in Oracle Solaris 11.2 』\fR
-.sp
-.LP
-\fI『Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2 』\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/ja_JP/pkg.depotd.1m	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkg.depotd.1m	Wed Jul 01 10:45:55 2015 -0700
@@ -1,846 +1,386 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkg.depotd 1M "2013 年 10 月 2 日" "SunOS 5.11" "システム管理コマンド"
-.SH 名前
-pkg.depotd \- Image Packaging System の集積サーバー
-.SH 形式
-.LP
-.nf
-/usr/lib/pkg.depotd [--cfg \fIsource\fR] [-a \fIaddress\fR]
-    [--content-root \fIroot_dir\fR] [-d \fIinst_root\fR]
-    [--debug \fIfeature_list\fR] [--disable-ops=\fIop\fR[/1][,...]]
-    [--image-root \fIpath\fR] [--log-access \fIdest\fR]
-    [--log-errors \fIdest\fR] [--mirror \fImode\fR] [-p \fIport\fR]
-    [--proxy-base \fIurl\fR] [--readonly \fImode\fR] [-s \fIthreads\fR]
-    [--sort-file-max-size \fIbytes\fR] [--ssl-cert-file \fIsource\fR]
-    [--ssl-dialog \fItype\fR] [--ssl-key-file \fIsource\fR]
-    [-t \fIsocket_timeout\fR] [--writable-root \fIpath\fR]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkg.depotd\fR は、Image Packaging System の集積サーバーです。パッケージリポジトリの内部に格納されたデータへのネットワークアクセスを提供します。ファイルシステム経由でのリポジトリへの直接アクセスをサポートしないクライアントや、ネットワークアクセスが唯一利用可能な、または推奨されるトランスポート手段であるクライアントでは通常、パッケージ集積庫を使用します。
-.sp
-.LP
-取得クライアントである\fBpkg\fR などのクライアントは、直接リポジトリから、または集積サーバーを通じてパッケージおよびパッケージメタデータのリストを取得できます。公開クライアントである \fBpkgsend\fR は、直接リポジトリに、または集積サーバーを通じて新しいバージョンのパッケージを送信できます。\fBpkgrepo\fR を使用して、集積サーバーで使用するリポジトリを作成したり、集積サーバーで直接、および集積サーバーを通じてこれらのリポジトリを管理したりすることができます。
-.sp
-.LP
-\fBpkg.depotd\fR は通常、システム上のサービスとして実行されます。パッケージおよびソフトウェアの開発者が、テスト目的で非公開のコピーを実行することが必要になる場合があります。
-.sp
-.LP
-集積庫は、単体では一切のアクセス制御手段を提供しません。デフォルトでは、接続できるすべてのクライアントは、すべてのパッケージデータを読み取ることができ、新しいパッケージバージョンを公開できます。サービス管理機構 (SMF) のもとで実行される場合は例外であり、この場合はデフォルトで読み取り専用モードで実行されます。後述の注意事項に関するセクションで、内容が増大していく公開集積サーバーを保守するためのベストプラクティスをいくつか説明します。
-.SH SMF プロパティー
-.sp
-.LP
-\fBpkg.depotd\fR サーバーは通常、そのサービスと関連付けられた SMF プロパティーを通して構成されます。\fBsvc:/application/pkg/server\fR サービスは、\fBpkg.depot\fR サーバープロセスを実行するか、\fBsvc:/application/pkg/depot\fR サービスの構成に貢献します。\fBpkg.depot-config\fR(1M) マニュアルページおよび後述の \fBpkg/standalone\fR プロパティーを参照してください。
-.sp
-.LP
-SMF プロパティーについては、\fBsmf\fR(5) マニュアルページを参照してください。次のようなプロパティーがあります。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/address\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBnet_address\fR) 接続を待機する IP アドレス。デフォルト値は 0.0.0.0 (\fBINADDR_ANY\fR) で、これはすべてのアクティブなインタフェースで待機することを示します。すべてのアクティブな IPv6 インタフェースで待機するには、\fB::\fR を使用します。最初の値のみが使用されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/content_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) インスタンスがその静的な Web コンテンツやほかの Web コンテンツを検索するファイルシステムパス。デフォルト値は \fB/usr/share/lib/pkg\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/debug\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 有効にするデバッグ機能のコンマ区切りリスト。指定可能な値は、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBheaders\fR\fR
-.ad
-.RS 11n
-.rt  
-すべての要求のヘッダーをエラーログに記録します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/disable_ops\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 集積サーバーに対して無効にする操作のコンマ区切りリスト。操作は \fIoperation\fR[/\fIversion\fR] のように指定します (たとえば、\fBcatalog\fR または \fBsearch_1\fR)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/image_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) ファイル情報がファイルデータのキャッシュとして使用されるイメージのパス。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/inst_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) インスタンスがそのリポジトリデータを検索するファイルシステムパス。\fBPKG_REPO\fR が指定されていないかぎり、必須です。デフォルト値は \fB/var/pkgrepo\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/log_access\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 集積プロセスによってログに記録される、アクセスに関連した任意の情報の出力先。指定可能な値は \fBstderr\fR、\fBstdout\fR、\fBnone\fR、または絶対パス名です。\fBstdout\fR が \fBtty\fR の場合、デフォルト値は \fBstdout\fR です。\fBstdout\fR が \fBtty\fR でない場合、デフォルト値は \fBnone\fR です。\fBpkg\fR をサービスとして実行する場合、\fBlog_access\fR のデフォルト値は \fBnone\fR で、出力は \fB/var/svc/log/application-pkg-server:*\fR に書き込まれます。大きいログファイルの管理例については、\fBlogadm\fR(1M) マニュアルページを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/log_errors\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 集積プロセスによってログに記録される、任意のエラーやその他の情報の出力先。指定可能な値は \fBstderr\fR、\fBstdout\fR、\fBnone\fR、または絶対パス名です。デフォルト値は \fBstderr\fR です。大きいログファイルの管理例については、\fBlogadm\fR(1M) マニュアルページを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/mirror\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBブール型\fR) パッケージミラーモードを使用するかどうかを設定します。true の場合、公開操作およびメタデータ操作は無効になり、制限付きのブラウザユーザーインタフェースのみが提供されます。\fBpkg/readonly\fR プロパティーが true のときは、このプロパティーを true に設定できません。デフォルト値は \fBfalse\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/port\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 着信するパッケージ要求をインスタンスが待機するポート番号。SSL 証明書および鍵の情報が提供されなかった場合のデフォルト値は 80、提供された場合のデフォルト値は 443 です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/proxy_base\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBuri\fR) 集積サーバーのベース URL を変更します。これは、逆プロキシ構成において、Apache またはその他の Web サーバーの内側で動作するときに最も有用です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/readonly\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBboolean\fR) \fBpkgsend\fR によって開始される操作などの変更操作を無効にするかどうかを設定します。取得操作は引き続き使用可能です。\fBpkg/mirror\fR プロパティーが true のときは、このプロパティーを true に設定できません。デフォルト値は \fBtrue\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/socket_timeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) サーバーが接続を閉じる前にクライアントからの応答を待機する最大秒数。デフォルト値は 60 です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/sort_file_max_size\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) インデクサソートファイルの最大サイズ。集積庫がインデックス作成に使用する RAM 容量を制限したり、速度向上のために RAM 容量を増やしたりするために使用します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_cert_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) PEM エンコードされた証明書ファイルの絶対パス名。デフォルト値は \fBnone\fR です。このプロパティーは \fBssl_key_file\fR とともに使用してください。\fBssl_cert_file\fR および \fB/ssl_key_file\fR の両方が指定された場合、集積庫のみが SSL 要求に応答します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_dialog\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) \fBssl_key_file\fR の復号化に使用するパスフレーズの取得方法を指定します。指定可能な値は、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbuiltin\fR\fR
-.ad
-.sp .6
-.RS 4n
-パスフレーズの入力を求めます。これがデフォルト値です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexec:\fI/path/to/program\fR\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された外部プログラムを実行してパスフレーズを取得します。プログラムへの最初の引数は \fB\&''\fR であり、予約されています。プログラムへの 2 番目の引数はサーバーのポート番号です。パスフレーズは \fBstdout\fR に出力されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsmf:fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-FMRI に関連したサービスインスタンスから、プロパティー \fBpkg_secure/ssl_key_passphrase\fR の値を取得しようとします。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_key_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) PEM エンコードされた非公開鍵ファイルの絶対パス名。このプロパティーは、\fBssl_cert_file\fR プロパティーとともに使用してください。\fB/ssl_key_file\fR および \fBssl_cert_file\fR の両方が指定された場合、集積庫のみが SSL 要求に応答します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/standalone\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBboolean\fR) 最小の Apache 構成で、単一の Apache インスタンスから複数のリポジトリを簡単に提供するには、このプロパティーを \fBfalse\fR に設定し、この \fBpkg/server\fR インスタンスの \fBpkg/readonly\fR プロパティーを \fBtrue\fR に設定します。\fBpkg/standalone\fR のデフォルト値は \fBfalse\fR で、\fBpkg/readonly\fR のデフォルト値は \fBtrue\fR です。詳細は、\fBpkg.depot-config\fR(1M) のマニュアルページを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/threads\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 要求を処理するために起動されるスレッドの数。デフォルト値は 60 です。小規模の配備にのみ適しています。この値は、同時実行されるクライアントの数の約 20 倍に設定してください。\fBthreads\fR の最大値は 5000 です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/writable_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) プログラムが書き込みアクセスを行えるディレクトリへのファイルシステムパス。これは \fB-readonly\fR オプションとともに使用して、集積サーバーがパッケージ情報への書き込みアクセスを必要とせずに、検索インデックスなどのファイルを作成できるようにします。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_secure/ssl_key_passphrase\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) \fBpkg/ssl_key_file\fR の復号化に使用するパスワード。この値は属性 \fBsolaris.smf.read.pkg-server\fR を使用して読み取り承認保護されます。
-.RE
-
-.sp
-.LP
-集積サーバーのブラウザユーザーインタフェース (BUI) の表示および動作は次のプロパティーを使用して制御されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_description\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) RSS/Atom フィードの説明段落。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_icon\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) RSS/Atom フィードを視覚的に表現するために使われる小さい画像のパス名。パス名は \fBcontent_root\fR からの相対パスで指定します。デフォルト値は \fBweb/_themes/pkg-block-icon.png\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_logo\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) RSS/Atom フィードを視覚的にブランディングまたは識別するために使われる大きな画像のパス名。この値は \fBcontent_root\fR からの相対パスで指定します。デフォルト値は \fBweb/_themes/pkg-block-icon.png\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) リポジトリにサービスを提供する集積庫によって生成される、RSS/Atom フィードの短い説明的な名前。デフォルト値は「package repository feed」です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_window\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) フィードの生成時に含める、リポジトリに関するフィードが最後に生成された時点までの時間数。
-.RE
-
-.sp
-.LP
-パッケージ集積庫は、\fBpkg\fR(5) からのローカルクライアントイメージのミラーサーバーとして機能することもできます。これにより、LAN 上で 1 つのサブネットを共有する複数のクライアントが、そのファイルキャッシュをミラー化できます。クライアント間で互いにファイルをダウンロードできるため、パッケージ集積サーバーの負荷が軽減されます。この機能は、SMF によって構成される代替集積サービスとして利用可能です。この機能はサービス検出のために mDNS および \fBdns-sd\fR を使用します。
-.sp
-.LP
-mDNS ミラーは通常、そのサービスと関連付けられた SMF プロパティーを通して構成されます。次のようなプロパティーがあります。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/image_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) ファイル情報がファイルデータのキャッシュとして使用されるイメージのパス。デフォルト値は \fB/\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/port\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 着信するパッケージ要求をインスタンスが待機するポート番号。デフォルトの値は 80 です。
-.RE
-
-.SH オプション
-.sp
-.LP
-\fBpkg.depotd\fR はその基本構成情報をファイルから、または既存の SMF サービスインスタンスのプロパティーデータから読み取ることができます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cfg\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-構成データを読み書きするときに使用するファイルのパス名、または \fBsmf:\fIfmri\fR\fR 形式の文字列。\fIfmri\fR は、構成データの読み取り元インスタンスのサービス障害管理リソース識別子 (FMRI) です。指定されるファイルの形式については、後述する「集積庫の構成」を参照してください。
-.RE
-
-.sp
-.LP
-利用可能な既存の設定ソースがない場合や、\fB--cfg\fR を使用して指定された構成ファイルから読み取られた値をオーバーライドする場合は、次のオプションを使用して、集積サーバーのデフォルト動作を変更できます:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIaddress\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/address\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--content-root\fR \fIroot_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/content_root\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIinst_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/inst_root\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--debug\fR \fIfeature_list\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/debug\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--disable-ops\fR=\fIop\fR[\fB /1\fR][,...]\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/disable_ops\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--image-root\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-上記の \fBpkg/image_root\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--log-access\fR \fIdest\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/log_access\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--log-errors\fR \fIdest\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/log_errors\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--mirror\fR \fImode\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/mirror\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIport\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/port\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--proxy-base\fR \fIurl\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/proxy_base\fR を参照してください。空の値を指定した場合、このオプションは無視されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--readonly\fR \fImode\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/readonly\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR\fIthreads\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/threads\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sort-file-max-size\fR \fIbytes\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/sort_file_max_size\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-cert-file\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/ssl_cert_file\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-dialog\fR \fItype\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/ssl_dialog\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-key-file\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/ssl_key_file\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIsocket_timeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/socket_timeout\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--writable-root\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-前出の \fBpkg/writable_root\fR を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.LP
-パッケージリポジトリの追加の管理機能は \fBpkgrepo\fR によって提供されます。
-.SH 集積庫の構成
-.sp
-.LP
-\fB--cfg\fR オプションを使用して (SMF の FMRI の代わりに) 構成ファイルが指定されたときは、集積サーバーはすべての構成データを単純テキスト形式で読み書きします。構成データについては「SMF プロパティー」ですでに説明しました。設定データは、\fB[\fIsection\fR]\fR ヘッダーで始まるセクション群と、それに続く \fBname = \fIvalue\fR\fR エントリ群で構成されます。記述の継続は RFC 822 形式です。継続行を空白で始めることにより、複数の行に値を分割できます。
-.sp
-.LP
-構成ファイルで指定されていない必要な値はすべて、前出の「オプション」で一覧表示したオプションを使用して指定する必要があります。サンプルの構成ファイルは次のようになります。
-.sp
-.in +2
-.nf
-[pkg]
+<refentry lang="ja" id="pkg.depotd-1m">
+<refmeta><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum> <refmiscinfo class="date">2013 年 10 月 2 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1m;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg.depotd</refname><refpurpose>Image Packaging System の集積サーバー</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/lib/pkg.depotd [--cfg <replaceable>source</replaceable>] [-a <replaceable>address</replaceable>]
+    [--content-root <replaceable>root_dir</replaceable>] [-d <replaceable>inst_root</replaceable>]
+    [--debug <replaceable>feature_list</replaceable>] [--disable-ops=<replaceable>op</replaceable>[/1][,...]]
+    [--image-root <replaceable>path</replaceable>] [--log-access <replaceable>dest</replaceable>]
+    [--log-errors <replaceable>dest</replaceable>] [--mirror <replaceable>mode</replaceable>] [-p <replaceable>port</replaceable>]
+    [--proxy-base <replaceable>url</replaceable>] [--readonly <replaceable>mode</replaceable>] [-s <replaceable>threads</replaceable>]
+    [--sort-file-max-size <replaceable>bytes</replaceable>] [--ssl-cert-file <replaceable>source</replaceable>]
+    [--ssl-dialog <replaceable>type</replaceable>] [--ssl-key-file <replaceable>source</replaceable>]
+    [-t <replaceable>socket_timeout</replaceable>] [--writable-root <replaceable>path</replaceable>]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="GLHAR" role="description"><title></title>
+<para><command>pkg.depotd</command> は、Image Packaging System の集積サーバーです。パッケージリポジトリの内部に格納されたデータへのネットワークアクセスを提供します。ファイルシステム経由でのリポジトリへの直接アクセスをサポートしないクライアントや、ネットワークアクセスが唯一利用可能な、または推奨されるトランスポート手段であるクライアントでは通常、パッケージ集積庫を使用します。</para>
+<para>取得クライアントである<command>pkg</command> などのクライアントは、直接リポジトリから、または集積サーバーを通じてパッケージおよびパッケージメタデータのリストを取得できます。公開クライアントである <command>pkgsend</command> は、直接リポジトリに、または集積サーバーを通じて新しいバージョンのパッケージを送信できます。<command>pkgrepo</command> を使用して、集積サーバーで使用するリポジトリを作成したり、集積サーバーで直接、および集積サーバーを通じてこれらのリポジトリを管理したりすることができます。</para>
+<para><command>pkg.depotd</command> は通常、システム上のサービスとして実行されます。パッケージおよびソフトウェアの開発者が、テスト目的で非公開のコピーを実行することが必要になる場合があります。</para>
+<para>集積庫は、単体では一切のアクセス制御手段を提供しません。デフォルトでは、接続できるすべてのクライアントは、すべてのパッケージデータを読み取ることができ、新しいパッケージバージョンを公開できます。サービス管理機構 (SMF) のもとで実行される場合は例外であり、この場合はデフォルトで読み取り専用モードで実行されます。後述の注意事項に関するセクションで、内容が増大していく公開集積サーバーを保守するためのベストプラクティスをいくつか説明します。</para>
+</refsect1>
+<refsect1 role="other"><title>SMF プロパティー</title>
+<para><literal>pkg.depotd</literal> サーバーは通常、そのサービスと関連付けられた SMF プロパティーを通して構成されます。<literal>svc:/application/pkg/server</literal> サービスは、<literal>pkg.depot</literal> サーバープロセスを実行するか、<literal>svc:/application/pkg/depot</literal> サービスの構成に貢献します。<literal>pkg.depot-config</literal>(1M) マニュアルページおよび後述の <literal>pkg/standalone</literal> プロパティーを参照してください。</para>
+<para>SMF プロパティーについては、<literal>smf</literal>(5) マニュアルページを参照してください。次のようなプロパティーがあります。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg/address</literal></term>
+<listitem><para>(<literal>net_address</literal>) 接続を待機する IP アドレス。デフォルト値は 0.0.0.0 (<literal>INADDR_ANY</literal>) で、これはすべてのアクティブなインタフェースで待機することを示します。すべてのアクティブな IPv6 インタフェースで待機するには、<literal>::</literal> を使用します。最初の値のみが使用されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/content_root</literal></term>
+<listitem><para>(<literal>astring</literal>) インスタンスがその静的な Web コンテンツやほかの Web コンテンツを検索するファイルシステムパス。デフォルト値は <filename>/usr/share/lib/pkg</filename> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/debug</literal></term>
+<listitem><para>(<literal>astring</literal>) 有効にするデバッグ機能のコンマ区切りリスト。指定可能な値は、次のとおりです。</para>
+<variablelist>
+<varlistentry><term><literal>headers</literal></term>
+<listitem><para>すべての要求のヘッダーをエラーログに記録します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/disable_ops</literal></term>
+<listitem><para>(<literal>astring</literal>) 集積サーバーに対して無効にする操作のコンマ区切りリスト。操作は <replaceable>operation</replaceable>[/<replaceable>version</replaceable>] のように指定します (たとえば、<literal>catalog</literal> または <literal>search_1</literal>)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/image_root</literal></term>
+<listitem><para>(<literal>astring</literal>) ファイル情報がファイルデータのキャッシュとして使用されるイメージのパス。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/inst_root</literal></term>
+<listitem><para>(<literal>astring</literal>) インスタンスがそのリポジトリデータを検索するファイルシステムパス。<literal>PKG_REPO</literal> が指定されていないかぎり、必須です。デフォルト値は <filename>/var/pkgrepo</filename> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/log_access</literal></term>
+<listitem><para>(<literal>astring</literal>) 集積プロセスによってログに記録される、アクセスに関連した任意の情報の出力先。指定可能な値は <filename>stderr</filename>、<filename>stdout</filename>、<literal>none</literal>、または絶対パス名です。<filename>stdout</filename> が <literal>tty</literal> の場合、デフォルト値は <filename>stdout</filename> です。<filename>stdout</filename> が <literal>tty</literal> でない場合、デフォルト値は <literal>none</literal> です。<literal>pkg</literal> をサービスとして実行する場合、<literal>log_access</literal> のデフォルト値は <literal>none</literal> で、出力は <filename>/var/svc/log/application-pkg-server:*</filename> に書き込まれます。大きいログファイルの管理例については、<literal>logadm</literal>(1M) マニュアルページを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/log_errors</literal></term>
+<listitem><para>(<literal>astring</literal>) 集積プロセスによってログに記録される、任意のエラーやその他の情報の出力先。指定可能な値は <filename>stderr</filename>、<filename>stdout</filename>、<literal>none</literal>、または絶対パス名です。デフォルト値は <filename>stderr</filename> です。大きいログファイルの管理例については、<literal>logadm</literal>(1M) マニュアルページを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/mirror</literal></term>
+<listitem><para>(<literal>ブール型</literal>) パッケージミラーモードを使用するかどうかを設定します。true の場合、公開操作およびメタデータ操作は無効になり、制限付きのブラウザユーザーインタフェースのみが提供されます。<literal>pkg/readonly</literal> プロパティーが true のときは、このプロパティーを true に設定できません。デフォルト値は <literal>false</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/port</literal></term>
+<listitem><para>(<literal>count</literal>) 着信するパッケージ要求をインスタンスが待機するポート番号。SSL 証明書および鍵の情報が提供されなかった場合のデフォルト値は 80、提供された場合のデフォルト値は 443 です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/proxy_base</literal></term>
+<listitem><para>(<literal>uri</literal>) 集積サーバーのベース URL を変更します。これは、逆プロキシ構成において、Apache またはその他の Web サーバーの内側で動作するときに最も有用です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/readonly</literal></term>
+<listitem><para>(<literal>boolean</literal>) <command>pkgsend</command> によって開始される操作などの変更操作を無効にするかどうかを設定します。取得操作は引き続き使用可能です。<literal>pkg/mirror</literal> プロパティーが true のときは、このプロパティーを true に設定できません。デフォルト値は <literal>true</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/socket_timeout</literal></term>
+<listitem><para>(<literal>count</literal>) サーバーが接続を閉じる前にクライアントからの応答を待機する最大秒数。デフォルト値は 60 です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/sort_file_max_size</literal></term>
+<listitem><para>(<literal>count</literal>) インデクサソートファイルの最大サイズ。集積庫がインデックス作成に使用する RAM 容量を制限したり、速度向上のために RAM 容量を増やしたりするために使用します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_cert_file</literal></term>
+<listitem><para>(<literal>astring</literal>) PEM エンコードされた証明書ファイルの絶対パス名。デフォルト値は <literal>none</literal> です。このプロパティーは <literal>ssl_key_file</literal> とともに使用してください。<literal>ssl_cert_file</literal> および <literal>/ssl_key_file</literal> の両方が指定された場合、集積庫のみが SSL 要求に応答します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_dialog</literal></term>
+<listitem><para>(<literal>astring</literal>) <literal>ssl_key_file</literal> の復号化に使用するパスフレーズの取得方法を指定します。指定可能な値は、次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>builtin</literal></term>
+<listitem><para>パスフレーズの入力を求めます。これがデフォルト値です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exec:<replaceable>/path/to/program</replaceable></literal></term>
+<listitem><para>指定された外部プログラムを実行してパスフレーズを取得します。プログラムへの最初の引数は <literal>''</literal> であり、予約されています。プログラムへの 2 番目の引数はサーバーのポート番号です。パスフレーズは <filename>stdout</filename> に出力されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>smf:fmri</literal></term>
+<listitem><para>FMRI に関連したサービスインスタンスから、プロパティー <literal>pkg_secure/ssl_key_passphrase</literal> の値を取得しようとします。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_key_file</literal></term>
+<listitem><para>(<literal>astring</literal>) PEM エンコードされた非公開鍵ファイルの絶対パス名。このプロパティーは、<literal>ssl_cert_file</literal> プロパティーとともに使用してください。<literal>/ssl_key_file</literal> および <literal>ssl_cert_file</literal> の両方が指定された場合、集積庫のみが SSL 要求に応答します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/standalone</literal></term>
+<listitem><para>(<literal>boolean</literal>) 最小の Apache 構成で、単一の Apache インスタンスから複数のリポジトリを簡単に提供するには、このプロパティーを <literal>false</literal> に設定し、この <literal>pkg/server</literal> インスタンスの <literal>pkg/readonly</literal> プロパティーを <literal>true</literal> に設定します。<literal>pkg/standalone</literal> のデフォルト値は <literal>false</literal> で、<literal>pkg/readonly</literal> のデフォルト値は <literal>true</literal> です。詳細は、<literal>pkg.depot-config</literal>(1M) のマニュアルページを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/threads</literal></term>
+<listitem><para>(<literal>count</literal>) 要求を処理するために起動されるスレッドの数。デフォルト値は 60 です。小規模の配備にのみ適しています。この値は、同時実行されるクライアントの数の約 20 倍に設定してください。<literal>threads</literal> の最大値は 5000 です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/writable_root</literal></term>
+<listitem><para>(<literal>astring</literal>) プログラムが書き込みアクセスを行えるディレクトリへのファイルシステムパス。これは <option>readonly</option> オプションとともに使用して、集積サーバーがパッケージ情報への書き込みアクセスを必要とせずに、検索インデックスなどのファイルを作成できるようにします。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_secure/ssl_key_passphrase</literal></term>
+<listitem><para>(<literal>astring</literal>) <literal>pkg/ssl_key_file</literal> の復号化に使用するパスワード。この値は属性 <literal>solaris.smf.read.pkg-server</literal> を使用して読み取り承認保護されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>集積サーバーのブラウザユーザーインタフェース (BUI) の表示および動作は次のプロパティーを使用して制御されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg_bui/feed_description</literal></term>
+<listitem><para>(<literal>astring</literal>) RSS/Atom フィードの説明段落。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_icon</literal></term>
+<listitem><para>(<literal>astring</literal>) RSS/Atom フィードを視覚的に表現するために使われる小さい画像のパス名。パス名は <literal>content_root</literal> からの相対パスで指定します。デフォルト値は <filename>web/_themes/pkg-block-icon.png</filename> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_logo</literal></term>
+<listitem><para>(<literal>astring</literal>) RSS/Atom フィードを視覚的にブランディングまたは識別するために使われる大きな画像のパス名。この値は <literal>content_root</literal> からの相対パスで指定します。デフォルト値は <filename>web/_themes/pkg-block-icon.png</filename> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_name</literal></term>
+<listitem><para>(<literal>astring</literal>) リポジトリにサービスを提供する集積庫によって生成される、RSS/Atom フィードの短い説明的な名前。デフォルト値は「package repository feed」です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_window</literal></term>
+<listitem><para>(<literal>count</literal>) フィードの生成時に含める、リポジトリに関するフィードが最後に生成された時点までの時間数。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>パッケージ集積庫は、<literal>pkg</literal>(5) からのローカルクライアントイメージのミラーサーバーとして機能することもできます。これにより、LAN 上で 1 つのサブネットを共有する複数のクライアントが、そのファイルキャッシュをミラー化できます。クライアント間で互いにファイルをダウンロードできるため、パッケージ集積サーバーの負荷が軽減されます。この機能は、SMF によって構成される代替集積サービスとして利用可能です。この機能はサービス検出のために mDNS および <literal>dns-sd</literal> を使用します。</para>
+<para>mDNS ミラーは通常、そのサービスと関連付けられた SMF プロパティーを通して構成されます。次のようなプロパティーがあります。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg/image_root</literal></term>
+<listitem><para>(<literal>astring</literal>) ファイル情報がファイルデータのキャッシュとして使用されるイメージのパス。デフォルト値は <filename>/</filename> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/port</literal></term>
+<listitem><para>(<literal>count</literal>) 着信するパッケージ要求をインスタンスが待機するポート番号。デフォルトの値は 80 です。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para><command>pkg.depotd</command> はその基本構成情報をファイルから、または既存の SMF サービスインスタンスのプロパティーデータから読み取ることができます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-cfg</option> <replaceable>source</replaceable></term>
+<listitem><para>構成データを読み書きするときに使用するファイルのパス名、または <literal>smf:<replaceable>fmri</replaceable></literal> 形式の文字列。<replaceable>fmri</replaceable> は、構成データの読み取り元インスタンスのサービス障害管理リソース識別子 (FMRI) です。指定されるファイルの形式については、後述する「集積庫の構成」を参照してください。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>利用可能な既存の設定ソースがない場合や、<option>-cfg</option> を使用して指定された構成ファイルから読み取られた値をオーバーライドする場合は、次のオプションを使用して、集積サーバーのデフォルト動作を変更できます:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>a</option> <replaceable>address</replaceable></term>
+<listitem><para>前出の <literal>pkg/address</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-content-root</option> <replaceable>root_dir</replaceable></term>
+<listitem><para>前出の <literal>pkg/content_root</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>inst_root</replaceable></term>
+<listitem><para>前出の <literal>pkg/inst_root</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-debug</option> <replaceable>feature_list</replaceable></term>
+<listitem><para>前出の <literal>pkg/debug</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-disable-ops</option>=<replaceable>op</replaceable>[<literal> /1</literal>][,...]</term>
+<listitem><para>前出の <literal>pkg/disable_ops</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-image-root</option> <replaceable>path</replaceable></term>
+<listitem><para>上記の <literal>pkg/image_root</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-log-access</option> <replaceable>dest</replaceable></term>
+<listitem><para>前出の <literal>pkg/log_access</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-log-errors</option> <replaceable>dest</replaceable></term>
+<listitem><para>前出の <literal>pkg/log_errors</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-mirror</option> <replaceable>mode</replaceable></term>
+<listitem><para>前出の <literal>pkg/mirror</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
+<listitem><para>前出の <literal>pkg/port</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-proxy-base</option> <replaceable>url</replaceable></term>
+<listitem><para>前出の <literal>pkg/proxy_base</literal> を参照してください。空の値を指定した場合、このオプションは無視されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-readonly</option> <replaceable>mode</replaceable></term>
+<listitem><para>前出の <literal>pkg/readonly</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option><replaceable>threads</replaceable></term>
+<listitem><para>前出の <literal>pkg/threads</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-sort-file-max-size</option> <replaceable>bytes</replaceable></term>
+<listitem><para>前出の <literal>pkg/sort_file_max_size</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-cert-file</option> <replaceable>source</replaceable></term>
+<listitem><para>前出の <literal>pkg/ssl_cert_file</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-dialog</option> <replaceable>type</replaceable></term>
+<listitem><para>前出の <literal>pkg/ssl_dialog</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-key-file</option> <replaceable>source</replaceable></term>
+<listitem><para>前出の <literal>pkg/ssl_key_file</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>socket_timeout</replaceable></term>
+<listitem><para>前出の <literal>pkg/socket_timeout</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-writable-root</option> <replaceable>path</replaceable></term>
+<listitem><para>前出の <literal>pkg/writable_root</literal> を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>パッケージリポジトリの追加の管理機能は <command>pkgrepo</command> によって提供されます。</para>
+</refsect1>
+<refsect1 role="other"><title>集積庫の構成</title>
+<para><option>-cfg</option> オプションを使用して (SMF の FMRI の代わりに) 構成ファイルが指定されたときは、集積サーバーはすべての構成データを単純テキスト形式で読み書きします。構成データについては「SMF プロパティー」ですでに説明しました。設定データは、<literal>[<replaceable>section</replaceable>]</literal> ヘッダーで始まるセクション群と、それに続く <literal>name = <replaceable>value</replaceable></literal> エントリ群で構成されます。記述の継続は RFC 822 形式です。継続行を空白で始めることにより、複数の行に値を分割できます。</para>
+<para>構成ファイルで指定されていない必要な値はすべて、前出の「オプション」で一覧表示したオプションを使用して指定する必要があります。サンプルの構成ファイルは次のようになります。</para>
+<programlisting>[pkg]
 port = 80
 inst_root = /export/repo
 
 [pub_example_com]
 feed_description = example.com's software
-  update log
-.fi
-.in -2
-
-.SH 使用例
-.LP
-\fB例 1 \fR集積サーバーの有効化
-.sp
-.in +2
-.nf
-# \fBsvcadm enable application/pkg/server\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fRサーバーの待機ポートを変更します。
-.sp
-.in +2
-.nf
-# \fBsvccfg -s application/pkg/server setprop pkg/port = 10000\fR
-# \fBsvcadm refresh application/pkg/server\fR
-# \fBsvcadm restart application/pkg/server\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 3 \fRミラーの有効化
-.sp
-.in +2
-.nf
-# \fBsvcadm enable application/pkg/dynamic-mirror\fR
-.fi
-.in -2
-.sp
-
-.SH 環境
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_REPO\fR\fR
-.ad
-.RS 21n
-.rt  
-サービスを提供するリポジトリを格納したディレクトリを指定します。\fB-d\fR を指定する場合、この値は無視されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_DEPOT_CONTENT\fR\fR
-.ad
-.RS 21n
-.rt  
-集積庫によって提供される静的コンテンツを格納したディレクトリを指定します。後述する「ファイル」で一覧表示されたファイルはこのディレクトリに存在する必要がありますが、ファイルの内容は、提供されるデフォルトの内容と異なっていてもかまいません。
-.RE
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 13n
-.rt  
-正常終了。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 13n
-.rt  
-エラーが発生した。
-.RE
+  update log</programlisting>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>集積サーバーの有効化</title>
+<screen># <userinput>svcadm enable application/pkg/server</userinput></screen>
+</example>
+<example id="GLHBM"><title>サーバーの待機ポートを変更します。</title>
+<screen># <userinput>svccfg -s application/pkg/server setprop pkg/port = 10000</userinput>
+# <userinput>svcadm refresh application/pkg/server</userinput>
+# <userinput>svcadm restart application/pkg/server</userinput></screen>
+</example>
+<example id="GLHAW"><title>ミラーの有効化</title>
+<screen># <userinput>svcadm enable application/pkg/dynamic-mirror</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_REPO</envar></term>
+<listitem><para>サービスを提供するリポジトリを格納したディレクトリを指定します。<option>d</option> を指定する場合、この値は無視されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_DEPOT_CONTENT</envar></term>
+<listitem><para>集積庫によって提供される静的コンテンツを格納したディレクトリを指定します。後述する「ファイル」で一覧表示されたファイルはこのディレクトリに存在する必要がありますが、ファイルの内容は、提供されるデフォルトの内容と異なっていてもかまいません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist termlength="xtranarrow">
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>正常終了。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>/usr/share/lib/pkg</filename></term>
+<listitem><para>デフォルトの表示コンテンツの場所。別の場所を選択するには、<literal>pkg/content_root</literal> を変更します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg.depot-config-1m"><citerefentry><refentrytitle>pkg.depot-config</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="dns-sd-1m"><citerefentry><refentrytitle>dns-sd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="MDNSD-1M"><citerefentry><refentrytitle>mdnsd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <literal>syslogd</literal>(1M), <olink targetdoc="refman" targetptr="SMF-5"><citerefentry><refentrytitle>smf</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Oracle Solaris 11.3 パッケージリポジトリのコピーおよび作成に関するドキュメント</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para><literal>pkd.depotd</literal> サービスは、サービス識別子 <literal>svc:/application/pkg/server</literal> のもとで SMF によって管理されます。</para>
+<para>mDNS ミラーサービスは、サービス識別子 <literal>svc:/application/pkg/dynamic-mirror</literal> のもとで SMF によって管理されます。</para>
+<para>集積庫への読み取りアクセスを制御するために、<command>pkg</command> がネイティブでサポートするクライアントベースの SSL 証明書アクセスなどの認証方式と組み合わせて HTTP 逆プロキシを使用できます。</para>
+<para>最小の Apache 構成で、単一の Apache インスタンスから複数のリポジトリを簡単に提供するには、特定の <literal>pkg/server</literal> インスタンスの <literal>pkg/standalone</literal> プロパティーを <literal>false</literal> に設定し、そのインスタンスの <literal>pkg/readonly</literal> プロパティーを <literal>true</literal> に設定します。詳細は、<literal>pkg.depot-config</literal>(1M) のマニュアルページを参照してください。</para>
+<para>ファイルシステムベースの操作を使用して構成またはパッケージデータを変更した場合、操作および出力に変更内容を反映できるように、集積サーバープロセスを再起動する必要があります。集積サーバープロセスを再起動するには、次のいずれかの方法を使用します。</para>
+<itemizedlist>
+<listitem><para><command>svcadm</command> を使用して、<literal>application/pkg/server</literal> インスタンスを再起動します。</para></listitem>
+<listitem><para><command>kill</command> を使用して、<literal>SIGUSR1</literal> シグナルを集積サーバープロセスに送信します。これにより、プロセスはそのままの状態で、すべての構成、パッケージ、および検索データを再読み込みする「正常な再起動」が実行されます。</para>
+<screen># <userinput>kill -USR1 <replaceable>pid</replaceable></userinput></screen>
+</listitem>
+</itemizedlist>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 13n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 13n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH ファイル
-.sp
-.ne 2
-.mk
-.na
-\fB\fB/usr/share/lib/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-デフォルトの表示コンテンツの場所。別の場所を選択するには、\fBpkg/content_root\fR を変更します。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg.depot-config\fR(1M), \fBdns-sd\fR(1M), \fBmdnsd\fR(1M), \fBpkg\fR(1), \fBpkgrepo\fR(1), \fBpkgsend\fR(1), \fBsyslogd\fR(1M), \fBsmf\fR(5)
-.sp
-.LP
-\fI『Oracle Solaris 11.2 パッケージリポジトリのコピーおよび作成に関するドキュメント』\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 注意事項
-.sp
-.LP
-\fBpkd.depotd\fR サービスは、サービス識別子 \fBsvc:/application/pkg/server\fR のもとで SMF によって管理されます。
-.sp
-.LP
-mDNS ミラーサービスは、サービス識別子 \fBsvc:/application/pkg/dynamic-mirror\fR のもとで SMF によって管理されます。
-.sp
-.LP
-集積庫への読み取りアクセスを制御するために、\fBpkg\fR がネイティブでサポートするクライアントベースの SSL 証明書アクセスなどの認証方式と組み合わせて HTTP 逆プロキシを使用できます。
-.sp
-.LP
-最小の Apache 構成で、単一の Apache インスタンスから複数のリポジトリを簡単に提供するには、特定の \fBpkg/server\fR インスタンスの \fBpkg/standalone\fR プロパティーを \fBfalse\fR に設定し、そのインスタンスの \fBpkg/readonly\fR プロパティーを \fBtrue\fR に設定します。詳細は、\fBpkg.depot-config\fR(1M) のマニュアルページを参照してください。
-.sp
-.LP
-ファイルシステムベースの操作を使用して構成またはパッケージデータを変更した場合、操作および出力に変更内容を反映できるように、集積サーバープロセスを再起動する必要があります。集積サーバープロセスを再起動するには、次のいずれかの方法を使用します。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBsvcadm\fR を使用して、\fBapplication/pkg/server\fR インスタンスを再起動します。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBkill\fR を使用して、\fBSIGUSR1\fR シグナルを集積サーバープロセスに送信します。これにより、プロセスはそのままの状態で、すべての構成、パッケージ、および検索データを再読み込みする「正常な再起動」が実行されます。
-.sp
-.in +2
-.nf
-# \fBkill -USR1 \fIpid\fR\fR
-.fi
-.in -2
-.sp
-
-.RE
--- a/src/man/ja_JP/pkg.sysrepo.1m	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkg.sysrepo.1m	Wed Jul 01 10:45:55 2015 -0700
@@ -1,171 +1,115 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkg.sysrepo 1M "2013 年 5 月 21 日" "SunOS 5.11" "システム管理コマンド"
-.SH 名前
-pkg.sysrepo \- Image Packaging System システムリポジトリ構成
-.SH 形式
-.LP
-.nf
-/usr/lib/pkg.sysrepo -p \fIport\fR [-c \fIcache_dir\fR] [-s \fIcache_size\fR]
-    [-w \fIhttp_proxy\fR] [-W \fIhttps_proxy\fR]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkg.sysrepo\fR は、Image Packaging System (IPS) システムリポジトリの構成ファイルを生成するために使用されます。\fBpkg.sysrepo \fR は、\fBsvc:/application/pkg/system-repository\fR サービス管理機能 (SMF) サービスから呼び出されます。構成の変更は、SMF サービスのプロパティーに対して行うようにしてください。
-.sp
-.LP
-システムリポジトリは、参照イメージ内に構成されたパッケージリポジトリへのアクセスを、集中管理プロキシを通して提供する役割を果たします。その参照イメージに加えられたパブリッシャーの構成の変更は、そのシステムリポジトリを使用するように構成されたすべてのクライアントにただちに認識されます。
-.sp
-.LP
-システムリポジトリは、大域ゾーン内に構成されたリポジトリに非大域ゾーンからアクセスできるようにするために、主に大域ゾーンで使用されます。SMF サービス \fBsvc:/application/pkg/zones-proxyd\fR および \fBsvc:/application/pkg/zones-proxy-client\fR は、非大域ゾーンと大域ゾーンの間のトランスポートを提供する役割を果たします。このトランスポートは、\fBpkg\fR(5) でのみ使用されます。
-.sp
-.LP
-\fBhttp\fR、\fBhttps\fR、および \fB v4\fR ファイルリポジトリと \fBp5p\fR アーカイブのみがサポートされます。古いファイルリポジトリ形式はサポートされません。リポジトリバージョンについての詳細は、\fBpkgrepo\fR(1) を参照してください。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-構成された発行元からの応答をキャッシュするためにシステムリポジトリで使用すべきディレクトリの絶対パスを指定します。
-.sp
-デフォルトでは、ファイルキャッシュが使用されます。ただし、インメモリーキャッシュを使用すべきであることを示すために、特殊な値 \fBmemory\fR を使用できます。システムリポジトリがキャッシュを実行すべきではないことを示すために、特殊な値 \fBNone\fR を使用できます。この設定は、\fBconfig/cache_dir\fR SMF プロパティーを使用して構成するようにしてください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIport\fR\fR
-.ad
-.sp .6
-.RS 4n
-システムリポジトリがリクエストを待機するために使用すべきポートを指定します。この設定は、\fBconfig/port\fR SMF プロパティーを使用して構成するようにしてください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIcache_size\fR\fR
-.ad
-.sp .6
-.RS 4n
-システムリポジトリの最大キャッシュサイズを定義する整数値 (M バイト単位)。この設定は、\fBconfig/cache_max\fR SMF プロパティーを使用して構成するようにしてください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-w\fR \fIhttp_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-システムリポジトリが http ベースのパッケージリポジトリにアクセスするために使用できる Web プロキシを定義する、\fB\fIscheme\fR://\fI hostname\fR[:\fIport\fR]\fR 形式の文字列。この設定は、\fBconfig/http_proxy \fR SMF プロパティーを使用して構成できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-W\fR \fIhttps_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-システムリポジトリが https ベースのパッケージリポジトリにアクセスするために使用できる Web プロキシを定義する、\fB\fIscheme\fR://\fI hostname\fR[:\fIport\fR]\fR 形式の文字列。この設定は、\fBconfig/https_proxy \fR SMF プロパティーを使用して構成できます。
-.RE
+<?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;
+]>
 
-.SH 使用例
-.LP
-\fB例 1 \fRシステムリポジトリの有効化
-.sp
-.in +2
-.nf
-$ \fBsvcadm enable svc:/application/pkg/system-repository\fR
-.fi
-.in -2
-.sp
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが、有効な構成の書き込みに失敗しました。
-.RE
+<refentry lang="ja" id="pkg.sysrepo-1m">
+<refmeta><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1m;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg.sysrepo</refname><refpurpose>Image Packaging System システムリポジトリ構成</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/lib/pkg.sysrepo -p <replaceable>port</replaceable> [-c <replaceable>
+cache_dir</replaceable>] [-s <replaceable>cache_size</replaceable>]
+    [-w <replaceable>http_proxy</replaceable>] [-W <replaceable>https_proxy</replaceable>]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgsysrepo-1m-desc" role="description"><title></title>
+<para><command>pkg.sysrepo</command> は、Image Packaging System (IPS) システムリポジトリの構成ファイルを生成するために使用されます。<command>pkg.sysrepo </command> は、<literal>svc:/application/pkg/system-repository</literal> サービス管理機能 (SMF) サービスから呼び出されます。構成の変更は、SMF サービスのプロパティーに対して行うようにしてください。</para>
+<para>システムリポジトリは、参照イメージ内に構成されたパッケージリポジトリへのアクセスを、集中管理プロキシを通して提供する役割を果たします。その参照イメージに加えられたパブリッシャーの構成の変更は、そのシステムリポジトリを使用するように構成されたすべてのクライアントにただちに認識されます。</para>
+<para>システムリポジトリは、大域ゾーン内に構成されたリポジトリに非大域ゾーンからアクセスできるようにするために、主に大域ゾーンで使用されます。SMF サービス <literal>svc:/application/pkg/zones-proxyd</literal> および <literal>svc:/application/pkg/zones-proxy-client</literal> は、非大域ゾーンと大域ゾーンの間のトランスポートを提供する役割を果たします。このトランスポートは、<literal>pkg</literal>(5) でのみ使用されます。</para>
+<para><literal>http</literal>、<literal>https</literal>、および <literal> v4</literal> ファイルリポジトリと <literal>p5p</literal> アーカイブのみがサポートされます。古いファイルリポジトリ形式はサポートされません。リポジトリバージョンについての詳細は、<command>pkgrepo</command>(1) を参照してください。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>サポートしているオプションは、次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>構成された発行元からの応答をキャッシュするためにシステムリポジトリで使用すべきディレクトリの絶対パスを指定します。</para>
+<para>デフォルトでは、ファイルキャッシュが使用されます。ただし、インメモリーキャッシュを使用すべきであることを示すために、特殊な値 <literal>memory</literal> を使用できます。システムリポジトリがキャッシュを実行すべきではないことを示すために、特殊な値 <literal>None</literal> を使用できます。この設定は、<literal>config/cache_dir</literal> SMF プロパティーを使用して構成するようにしてください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
+<listitem><para>システムリポジトリがリクエストを待機するために使用すべきポートを指定します。この設定は、<literal>config/port</literal> SMF プロパティーを使用して構成するようにしてください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>cache_size</replaceable></term>
+<listitem><para>システムリポジトリの最大キャッシュサイズを定義する整数値 (M バイト単位)。この設定は、<literal>config/cache_max</literal> SMF プロパティーを使用して構成するようにしてください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>w</option> <replaceable>http_proxy</replaceable></term>
+<listitem><para>システムリポジトリが http ベースのパッケージリポジトリにアクセスするために使用できる Web プロキシを定義する、<literal><replaceable>scheme</replaceable>://<replaceable> hostname</replaceable>[:<replaceable>port</replaceable>]</literal> 形式の文字列。この設定は、<literal>config/http_proxy </literal> SMF プロパティーを使用して構成できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>W</option> <replaceable>https_proxy</replaceable></term>
+<listitem><para>システムリポジトリが https ベースのパッケージリポジトリにアクセスするために使用できる Web プロキシを定義する、<literal><replaceable>scheme</replaceable>://<replaceable> hostname</replaceable>[:<replaceable>port</replaceable>]</literal> 形式の文字列。この設定は、<literal>config/https_proxy </literal> SMF プロパティーを使用して構成できます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>システムリポジトリの有効化</title>
+<screen>$ <userinput>svcadm enable svc:/application/pkg/system-repository</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>コマンドが、有効な構成の書き込みに失敗しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(1), \fBpkg.depotd\fR(1M), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/ja_JP/pkgdepend.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgdepend.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,416 +1,186 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgdepend 1 "2013 年 7 月 12 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgdepend \- Image Packaging System 依存関係アナライザ
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgdepend [\fIoptions\fR] \fIcommand\fR [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgdepend generate [-IMm] -d \fIdir\fR [-d \fIdir\fR]
-    [-D \fIname\fR=\fIvalue\fR] [-k \fIpath\fR] \fImanifest_file\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgdepend resolve [-EmoSv] [-d \fIoutput_dir\fR]
-    [-e \fIexternal_package_file\fR]... [-s \fIsuffix\fR]
-    \fImanifest_file\fR ...
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkgdepend\fR コマンドは、パッケージの依存関係を生成および解決します。パッケージは、ほかのパッケージのファイルに依存することがあります。\fBpkgdepend\fR コマンドは通常、ファイル依存関係の生成と、ファイルからパッケージへの解決という 2 つのパスで使用されます。
-.sp
-.LP
-\fBgenerate\fR サブコマンドはパッケージの内容を検査し、そのパッケージにどのような外部ファイルが必要かを判定します。
-.sp
-.LP
-\fBresolve\fR サブコマンドは、\fBgenerate\fR ステップからファイルのリストを取得し、これらの依存ファイルを含むパッケージの名前を判定するためにパッケージの参照セットを検索します。依存ファイルが検索されるパッケージの参照セットは、パブリッシャーのシステムに現在インストールされているパッケージです。
-.sp
-.LP
-依存関係情報のソースとして、提供されたファイルの次のいくつかのコンポーネントが使用されます。
-.sp
-.ne 2
-.mk
-.na
-\fBELF\fR
-.ad
-.RS 22n
-.rt  
-提供されたファイル内の ELF ヘッダーが依存関係情報のために分析され、\fB-k\fR および \fB-D\fR オプションが指定されていると取得された情報が変更されます。ELF 依存関係についての詳細は、\fBldd\fR および\fI『Oracle Solaris 11.2 Linkers and Libraries Guide 』\fRを参照してください。 
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBスクリプト\fR
-.ad
-.RS 22n
-.rt  
-インタプリタを参照している \fB#!\fR 行を含むシェルスクリプトによって、そのインタプリタを提供しているパッケージへの依存関係が生成されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBPython\fR
-.ad
-.RS 22n
-.rt  
-Python スクリプトはまず、スクリプトとして分析されます。さらに、そのスクリプトでインポートが宣言されていると、それらも依存関係情報のソースとして機能することがあります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBハードリンク\fR
-.ad
-.RS 22n
-.rt  
-マニフェスト内のハードリンクによって、リンクターゲットを提供しているパッケージへの依存関係が生成されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBSMF\fR
-.ad
-.RS 22n
-.rt  
-\fBrequire_all\fR 依存関係を含む提供された SMF サービスマニフェストによって、これらの FMRI を提供する SMF マニフェストを提供しているパッケージへの依存関係が生成されます。
-.RE
-
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIdir\fR をルートとするイメージを操作します。ディレクトリが指定されなかったか、または環境に基づいて決定される場合、デフォルトは / です。詳細は、「環境変数」のセクションを参照してください。
-.RE
-
-.SH サブコマンド
-.sp
-.LP
-サポートされているサブコマンドは次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgdepend generate\fR [\fB-IMm\fR] \fB- d\fR \fIdir\fR [\fB-d\fR \fIdir\fR] [\fB-D\fR \fIname\fR=\fIvalue\fR] [\fB-k\fR \fIpath\fR] \fImanifest_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fImanifest_file\fR で指定されたマニフェストのファイルへの依存関係を生成します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fImanifest_file\fR 内で満たされている依存関係を表示します。\fB-I\fR と \fBpkgdepend resolve\fR の結果を使用しないでください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-M\fR\fR
-.ad
-.sp .6
-.RS 4n
-分析できなかったファイルタイプのリストを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-元のマニフェストを繰り返してから、検出された依存関係をすべて追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-マニフェストのファイルを検索するディレクトリのリストに \fIdir\fR を追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-D\fR \fIname\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-ELF ファイル依存関係のための実行パス内のトークン \fIname\fR を展開する方法として \fIvalue\fR を追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-カーネルモジュールを検索する実行パスのリストに \fIpath\fR を追加します。\fB-k\fR オプションを使用すると、デフォルトのパス (\fB/kernel\fR と \fB/usr/kernel\fR) が削除されます。
-.sp
-\fB-k\fR オプションで指定されるような実行パスは、アクションまたはマニフェスト属性 \fBpkg.depend.runpath\fR を使用して、アクションごとまたはマニフェストごとにも指定できます。\fBpkg.depend.runpath\fR 属性の値は、使用するパスのコロンで区切られた文字列です。マニフェストまたはアクション内にいずれかの \fBpkg.depend.runpath\fR 属性を設定すると、\fB-k\fR オプションで指定されたパスがオーバーライドされます。
-.sp
-\fBpkg.depend.runpath\fR 属性値の 1 つのコンポーネントとして、特殊なトークン \fB$PKGDEPEND_RUNPATH\fR を使用すると、分析対象のファイルのための標準のシステム実行パスを含めることができます。
-.RE
+<?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;
+]>
 
-場合によっては、依存関係が自動的に生成されることを回避したいことがあります。たとえば、あるパッケージによって、一連のモジュールをインポートするサンプルの Python スクリプトが提供される場合、そのサンプルスクリプトによってインポートされるこれらのモジュールは、サンプルスクリプトを提供しているパッケージの依存関係ではありません。指定されたファイルに対する依存関係の生成を回避するには、アクションまたはマニフェスト属性 \fBpkg.depend.bypass-generate\fR を使用します。
-.sp
-\fBpkg.depend.bypass-generate\fR 値は、ファイル名に一致する Python の正規表現です。これらの正規表現は、ファイルパスの先頭と最後に暗黙的に固定されます。次の例で指定されている値は \fBthis/that\fR に一致しますが、\fBsomething/this/that/the/other\fR には一致しません。
-.sp
-.in +2
-.nf
-pkg.depend.bypass-generate=this/that
-.fi
-.in -2
-
-Python 正規表現の構文については、コマンド \fBpydoc re\fR を使用するか、または \fBhttp://docs.python.org/dev/howto/regex.html\fR にあるより完全なドキュメントを参照してください。
-.sp
-\fBpkgdepend generate\fR 入力マニフェストに SMF マニフェストファイルが含まれる場合、それらの SMF マニフェストファイルによって宣言されている SMF サービスまたはインスタンスが \fBpkgdepend\fR の出力に含まれます。これらの SMF サービスまたはインスタンスは、\fBorg.opensolaris.smf.fmri\fR の名前で \fBset\fR アクションの形式で含まれます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgdepend resolve\fR [\fB-EmoSv\fR] [\fB-d\fR \fIoutput_dir\fR] [\fB-e\fR \fI external_package_file\fR]... [\fB-s\fR \fIsuffix\fR] \fI manifest_file\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-ファイルへの依存関係を、これらのファイルを提供するパッケージへの依存関係に変換します。依存関係は、まずコマンド行に指定されたマニフェストに基づいて解決され、次にシステムにインストールされているパッケージに基づいて解決されます。デフォルトでは、各マニフェストの依存関係は \fB\fImanifest_file\fR.res\fR という名前のファイルに格納されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-e\fR \fIexternal_package_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIexternal_package_file\fR 内のパターンに名前が一致したシステムからのパッケージに対してのみ解決します。このオプションは複数回指定できます。\fB-e\fR オプションは \fB-S\fR オプションと一緒に使用できません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-E\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB-e\fR が指定された場合、外部の依存関係であると予想されたが、外部の依存関係ではなかったパッケージが表示されます。外部の依存関係であると予想されるパッケージは、\fIexternal_package_file\fR 内のパターンに名前が一致するシステムからのパッケージです。
-.sp
-\fB-e\fR が指定されない場合、解決済みパッケージの外部の依存関係を表示します。解決済みパッケージの外部の依存関係とは、解決済みパッケージの依存関係のターゲットで、コマンド行で指定されないパッケージです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-解決された依存関係を追加する前に、\fBgenerate\fR ステップによって生成された依存関係をすべて削除して、マニフェストを繰り返します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR\fR
-.ad
-.sp .6
-.RS 4n
-結果を標準出力に書き込みます。このオプションは、人による使用を目的にしています。この出力をファイルに追加すると、無効なマニフェストが生成されることがあります。マニフェスト処理のパイプラインでは、\fB-o\fR の代わりに \fB-d\fR または \fB-s\fR オプションを使用することを強くお勧めします。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIoutput_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された各マニフェストの解決された依存関係を \fIoutput_dir\fR 内の個別のファイルに書き込みます。デフォルトでは、各ファイルには、そのファイルに書き込まれた依存関係のソースだったマニフェストと同じベース名が付けられます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIsuffix\fR\fR
-.ad
-.sp .6
-.RS 4n
-出力ファイルごとに、解決された依存関係のソースだったファイルのベース名に \fIsuffix\fR を追加します。\fIsuffix\fR が \fI\&.suffix\fR でない場合、ピリオド (.) が \fIsuffix\fR の前に付加されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-S\fR\fR
-.ad
-.sp .6
-.RS 4n
-コマンド行で指定されたマニフェストに対してのみ解決し、システムにインストールされているマニフェストに対しては解決しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-追加のパッケージ依存関係デバッグ用のメタデータを含めます。
-.RE
-
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fR依存関係を生成する
-.sp
-.LP
-\fBfoo\fR (このコンテンツディレクトリは \fB\&./bar/baz\fR 内に存在する) に書き込まれているマニフェストの依存関係を生成し、その結果を \fBfoo.fdeps\fR に格納します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d ./bar/baz foo > foo.fdeps\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fR依存関係を解決する
-.sp
-.LP
-\fBfoo.fdeps\fR と \fB bar.fdeps\fR における互いに対するファイル依存関係と、システムに現在インストールされているパッケージに対するファイル依存関係を解決します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend resolve foo.fdeps bar.fdeps\fR
-$ \fBls *.res\fR
-foo.fdeps.res    bar.fdeps.res
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 3 \fR2 つのマニフェストの依存関係を生成および解決する
-.sp
-.LP
-2 つのマニフェスト (\fBfoo\fR と \fBbar\fR) へのファイル依存関係を生成し、すべての情報を元のマニフェスト内に保持します。次に、これらのファイル依存関係を解決し、結果のマニフェストを \fB\&./res\fR 内に格納します。これらの結果のマニフェストは、\fBpkgsend publish\fR で使用できます。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d /proto/foo -m foo > ./deps/foo\fR
-$ \fBpkgdepend generate -d /proto/bar -m bar > ./deps/bar\fR
-$ \fBpkgdepend resolve -m -d ./res ./deps/foo ./deps/bar\fR
-$ \fBls ./res\fR
-foo    bar
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 4 \fRELF ファイル依存関係のためのトークンに値を追加する
-.sp
-.LP
-コンテンツディレクトリが / 内に存在する \fBfoo\fR に書き込まれているマニフェストの依存関係を生成するときに、ELF ファイルの実行パス内のすべての \fBPLATFORM\fR トークンを \fBsun4v\fR と \fBsun4u\fR に置き換えます。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d / -D 'PLATFORM=sun4v' \e\fR
-\fB-D 'PLATFORM=sun4u' foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 5 \fRカーネルモジュールディレクトリを指定する
-.sp
-.LP
-コンテンツディレクトリが / 内に存在する \fBfoo\fR に書き込まれているマニフェストの依存関係を生成するときに、カーネルモジュールを検索するディレクトリとして \fB/kmod\fR を指定します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d / -k /kmod foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 6 \fR依存関係の生成をバイパスする
-.sp
-.LP
-指定された Python スクリプトの標準の Python 実行パスに \fBopt/python\fR を追加し、\fBopt/python/foo/file.py\fR として提供されるファイルの \fBtest\fR という名前のすべての Python モジュールに対する依存関係の生成をバイパスします。
-
-.sp
-.LP
-\fBusr/lib/python2.6/vendor-packages/xdg\fR で提供されたすべてのファイルに対する依存関係の生成を回避します。
-
-.sp
-.in +2
-.nf
-$ \fBcat manifest.py\fR
+<refentry lang="ja" id="pkgdepend-1">
+<refmeta><refentrytitle>pkgdepend</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2015 年 1 月 28 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgdepend</refname><refpurpose>Image Packaging System 依存関係アナライザ</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgdepend [<replaceable>options</replaceable>] <replaceable>command
+</replaceable> [<replaceable>cmd_options</replaceable>] [<replaceable>operands</replaceable>]
+</synopsis>
+<synopsis>/usr/bin/pkgdepend generate [-IMm] -d <replaceable>dir</replaceable> [-d <replaceable>
+dir</replaceable>]
+    [-D <replaceable>name</replaceable>=<replaceable>value</replaceable>] [-k <replaceable>
+path</replaceable>] <replaceable>manifest_file</replaceable></synopsis>
+<synopsis>/usr/bin/pkgdepend resolve [-EmoSv] [-d <replaceable>output_dir</replaceable>]
+    [-e <replaceable>external_package_file</replaceable>]... [-s <replaceable>suffix
+</replaceable>]
+    <replaceable>manifest_file</replaceable> ...</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgdepend-1-desc" role="description"><title></title>
+<para><command>pkgdepend</command> コマンドは、パッケージの依存関係を生成および解決します。パッケージは、ほかのパッケージのファイルに依存することがあります。<command>pkgdepend</command> コマンドは通常、ファイル依存関係の生成と、ファイルからパッケージへの解決という 2 つのパスで使用されます。</para>
+<para><command>generate</command> サブコマンドはパッケージの内容を検査し、そのパッケージにどのような外部ファイルが必要かを判定します。</para>
+<para><command>resolve</command> サブコマンドは、<command>generate</command> ステップからファイルのリストを取得し、これらの依存ファイルを含むパッケージの名前を判定するためにパッケージの参照セットを検索します。依存ファイルが検索されるパッケージの参照セットは、パブリッシャーのシステムに現在インストールされているパッケージです。</para>
+<para>依存関係情報のソースとして、提供されたファイルの次のいくつかのコンポーネントが使用されます。</para>
+<variablelist>
+<varlistentry><term>ELF</term>
+<listitem><para>提供されたファイル内の ELF ヘッダーが依存関係情報のために分析され、<option>k</option> および <option>D</option> オプションが指定されていると取得された情報が変更されます。ELF 依存関係についての詳細は、<command>ldd</command> および<olink targetdoc="OSLLG"><citetitle remap="book">Oracle Solaris 11.3 Linkers and Libraries Guide</citetitle></olink>を参照してください。 </para>
+</listitem>
+</varlistentry>
+<varlistentry><term>スクリプト</term>
+<listitem><para>インタプリタを参照している <literal>#!</literal> 行を含むシェルスクリプトによって、そのインタプリタを提供しているパッケージへの依存関係が生成されます。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>Python</term>
+<listitem><para>Python スクリプトはまず、スクリプトとして分析されます。さらに、そのスクリプトでインポートが宣言されていると、それらも依存関係情報のソースとして機能することがあります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>ハードリンク</term>
+<listitem><para>マニフェスト内のハードリンクによって、リンクターゲットを提供しているパッケージへの依存関係が生成されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>SMF</term>
+<listitem><para><literal>require_all</literal> 依存関係を含む提供された SMF サービスマニフェストによって、これらの FMRI を提供する SMF マニフェストを提供しているパッケージへの依存関係が生成されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</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>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>サポートされているサブコマンドは次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgdepend generate</command> [<option>IMm</option>] <option> d</option> <replaceable>dir</replaceable> [<option>d</option> <replaceable>dir</replaceable>] [<option>D</option> <replaceable>name</replaceable>=<replaceable>value</replaceable>] [<option>k</option> <replaceable>path</replaceable>] <replaceable>manifest_file</replaceable></term>
+<listitem><para><replaceable>manifest_file</replaceable> で指定されたマニフェストのファイルへの依存関係を生成します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option></term>
+<listitem><para><replaceable>manifest_file</replaceable> 内で満たされている依存関係を表示します。<option>I</option> と <command>pkgdepend resolve</command> の結果を使用しないでください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>M</option></term>
+<listitem><para>分析できなかったファイルタイプのリストを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option></term>
+<listitem><para>元のマニフェストを繰り返してから、検出された依存関係をすべて追加します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>dir</replaceable></term>
+<listitem><para>マニフェストのファイルを検索するディレクトリのリストに <replaceable>dir</replaceable> を追加します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>D</option> <replaceable>name</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>ELF ファイル依存関係のための実行パス内のトークン <replaceable>name</replaceable> を展開する方法として <replaceable>value</replaceable> を追加します。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>path</replaceable></term>
+<listitem><para>カーネルモジュールを検索する実行パスのリストに <replaceable>path</replaceable> を追加します。<option>k</option> オプションを使用すると、デフォルトのパス (<filename>/kernel</filename> と <filename>/usr/kernel</filename>) が削除されます。</para>
+<para><option>k</option> オプションで指定されるような実行パスは、アクションまたはマニフェスト属性 <literal>pkg.depend.runpath</literal> を使用して、アクションごとまたはマニフェストごとにも指定できます。<literal>pkg.depend.runpath</literal> 属性の値は、使用するパスのコロンで区切られた文字列です。マニフェストまたはアクション内にいずれかの <literal>pkg.depend.runpath</literal> 属性を設定すると、<option>k</option> オプションで指定されたパスがオーバーライドされます。</para>
+<para><literal>pkg.depend.runpath</literal> 属性値の 1 つのコンポーネントとして、特殊なトークン <envar>$PKGDEPEND_RUNPATH</envar> を使用すると、分析対象のファイルのための標準のシステム実行パスを含めることができます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>場合によっては、依存関係が自動的に生成されることを回避したいことがあります。たとえば、あるパッケージによって、一連のモジュールをインポートするサンプルの Python スクリプトが提供される場合、そのサンプルスクリプトによってインポートされるこれらのモジュールは、サンプルスクリプトを提供しているパッケージの依存関係ではありません。指定されたファイルに対する依存関係の生成を回避するには、アクションまたはマニフェスト属性 <literal>pkg.depend.bypass-generate</literal> を使用します。</para>
+<para><literal>pkg.depend.bypass-generate</literal> 値は、ファイル名に一致する Python の正規表現です。これらの正規表現は、ファイルパスの先頭と最後に暗黙的に固定されます。次の例で指定されている値は <literal>this/that</literal> に一致しますが、<literal>something/this/that/the/other</literal> には一致しません。</para>
+<programlisting>pkg.depend.bypass-generate=this/that</programlisting>
+<para>Python 正規表現の構文については、コマンド <command>pydoc re</command> を使用するか、または <literal>http://docs.python.org/dev/howto/regex.html</literal> にあるより完全なドキュメントを参照してください。</para>
+<para><command>pkgdepend generate</command> 入力マニフェストに SMF マニフェストファイルが含まれる場合、それらの SMF マニフェストファイルによって宣言されている SMF サービスまたはインスタンスが <command>pkgdepend</command> の出力に含まれます。これらの SMF サービスまたはインスタンスは、<literal>org.opensolaris.smf.fmri</literal> の名前で <literal>set</literal> アクションの形式で含まれます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgdepend resolve</command> [<option>EmoSv</option>] [<option>d</option> <replaceable>output_dir</replaceable>] [<option>e</option> <replaceable> external_package_file</replaceable>]... [<option>s</option> <replaceable>suffix</replaceable>] <replaceable> manifest_file</replaceable> ...</term>
+<listitem><para>ファイルへの依存関係を、これらのファイルを提供するパッケージへの依存関係に変換します。依存関係は、まずコマンド行に指定されたマニフェストに基づいて解決され、次にシステムにインストールされているパッケージに基づいて解決されます。デフォルトでは、各マニフェストの依存関係は <filename><replaceable>manifest_file</replaceable>.res</filename> という名前のファイルに格納されます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>e</option> <replaceable>external_package_file</replaceable></term>
+<listitem><para><replaceable>external_package_file</replaceable> 内のパターンに名前が一致したシステムからのパッケージに対してのみ解決します。このオプションは複数回指定できます。<option>e</option> オプションは <option>S</option> オプションと一緒に使用できません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>E</option></term>
+<listitem><para><option>e</option> が指定された場合、外部の依存関係であると予想されたが、外部の依存関係ではなかったパッケージが表示されます。外部の依存関係であると予想されるパッケージは、<replaceable>external_package_file</replaceable> 内のパターンに名前が一致するシステムからのパッケージです。
+</para>
+<para><option>e</option> が指定されない場合、解決済みパッケージの外部の依存関係を表示します。解決済みパッケージの外部の依存関係とは、解決済みパッケージの依存関係のターゲットで、コマンド行で指定されないパッケージです。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option></term>
+<listitem><para>解決された依存関係を追加する前に、<command>generate</command> ステップによって生成された依存関係をすべて削除して、マニフェストを繰り返します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option></term>
+<listitem><para>結果を標準出力に書き込みます。このオプションは、人による使用を目的にしています。この出力をファイルに追加すると、無効なマニフェストが生成されることがあります。マニフェスト処理のパイプラインでは、<option>o</option> の代わりに <option>d</option> または <option>s</option> オプションを使用することを強くお勧めします。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>output_dir</replaceable></term>
+<listitem><para>指定された各マニフェストの解決された依存関係を <replaceable>output_dir</replaceable> 内の個別のファイルに書き込みます。デフォルトでは、各ファイルには、そのファイルに書き込まれた依存関係のソースだったマニフェストと同じベース名が付けられます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>suffix</replaceable></term>
+<listitem><para>出力ファイルごとに、解決された依存関係のソースだったファイルのベース名に <replaceable>suffix</replaceable> を追加します。<replaceable>suffix</replaceable> が <replaceable>.suffix</replaceable> でない場合、ピリオド (.) が <replaceable>suffix</replaceable> の前に付加されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>S</option></term>
+<listitem><para>コマンド行で指定されたマニフェストに対してのみ解決し、システムにインストールされているマニフェストに対しては解決しません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>追加のパッケージ依存関係デバッグ用のメタデータを含めます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>依存関係を生成する</title>
+<para><filename>foo</filename> (このコンテンツディレクトリは <filename>./bar/baz</filename> 内に存在する) に書き込まれているマニフェストの依存関係を生成し、その結果を <filename>foo.fdeps</filename> に格納します。</para>
+<screen>$ <userinput>pkgdepend generate -d ./bar/baz foo > foo.fdeps</userinput></screen>
+</example>
+<example><title>依存関係を解決する</title>
+<para><filename>foo.fdeps</filename> と <filename> bar.fdeps</filename> における互いに対するファイル依存関係と、システムに現在インストールされているパッケージに対するファイル依存関係を解決します。</para>
+<screen>$ <userinput>pkgdepend resolve foo.fdeps bar.fdeps</userinput>
+$ <userinput>ls *.res</userinput>
+foo.fdeps.res    bar.fdeps.res</screen>
+</example>
+<example><title>2 つのマニフェストの依存関係を生成および解決する</title>
+<para>2 つのマニフェスト (<literal>foo</literal> と <literal>bar</literal>) へのファイル依存関係を生成し、すべての情報を元のマニフェスト内に保持します。次に、これらのファイル依存関係を解決し、結果のマニフェストを <filename>./res</filename> 内に格納します。これらの結果のマニフェストは、<command>pkgsend publish</command> で使用できます。
+</para>
+<screen>$ <userinput>pkgdepend generate -d /proto/foo -m foo > ./deps/foo</userinput>
+$ <userinput>pkgdepend generate -d /proto/bar -m bar > ./deps/bar</userinput>
+$ <userinput>pkgdepend resolve -m -d ./res ./deps/foo ./deps/bar</userinput>
+$ <userinput>ls ./res</userinput>
+foo    bar</screen>
+</example>
+<example><title>ELF ファイル依存関係のためのトークンに値を追加する</title>
+<para>コンテンツディレクトリが / 内に存在する <literal>foo</literal> に書き込まれているマニフェストの依存関係を生成するときに、ELF ファイルの実行パス内のすべての <envar>PLATFORM</envar> トークンを <literal>sun4v</literal> と <literal>sun4u</literal> に置き換えます。</para>
+<screen>$ <userinput>pkgdepend generate -d / -D 'PLATFORM=sun4v' &bsol;</userinput>
+<userinput>-D 'PLATFORM=sun4u' foo</userinput></screen>
+</example>
+<example><title>カーネルモジュールディレクトリを指定する</title>
+<para>コンテンツディレクトリが / 内に存在する <filename>foo</filename> に書き込まれているマニフェストの依存関係を生成するときに、カーネルモジュールを検索するディレクトリとして <filename>/kmod</filename> を指定します。</para>
+<screen>$ <userinput>pkgdepend generate -d / -k /kmod foo</userinput></screen>
+</example>
+<example><title>依存関係の生成をバイパスする</title>
+<para>指定された Python スクリプトの標準の Python 実行パスに <filename>opt/python</filename> を追加し、<filename>opt/python/foo/file.py</filename> として提供されるファイルの <literal>test</literal> という名前のすべての Python モジュールに対する依存関係の生成をバイパスします。</para>
+<para><filename>usr/lib/python2.7/vendor-packages/xdg</filename> で提供されたすべてのファイルに対する依存関係の生成を回避します。</para>
+<screen>$ <userinput>cat manifest.py</userinput>
 set name=pkg.fmri value=pkg:/[email protected],1.0
 set name=pkg.summary value="My test package"
 dir path=opt mode=0755 group=sys owner=root
@@ -421,101 +191,81 @@
 #
 # Add runpath and bypass-generate attributes:
 #
-file path=opt/python/foo/file.py mode=0644 group=sys owner=root \e
-    pkg.depend.bypass-generate=.*/test.py.* \e
-    pkg.depend.bypass-generate=.*/testmodule.so \e
-    pkg.depend.bypass-generate=.*/test.so \e
-    pkg.depend.bypass-generate=usr/lib/python2.6/vendor-packages/xdg/.* \e
+file path=opt/python/foo/file.py mode=0644 group=sys owner=root &bsol;
+    pkg.depend.bypass-generate=.*/test.py.* &bsol;
+    pkg.depend.bypass-generate=.*/testmodule.so &bsol;
+    pkg.depend.bypass-generate=.*/test.so &bsol;
+    pkg.depend.bypass-generate=usr/lib/python2.7/vendor-packages/xdg/.* &bsol;
     pkg.depend.runpath=$PKGDEPEND_RUNPATH:/opt/python
 
-$ \fBpkgdepend generate -d proto manifest.py\fR
-.fi
-.in -2
-.sp
-
-.SH 環境
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_IMAGE\fR\fR
-.ad
-.RS 13n
-.rt  
-パッケージ操作に使用するイメージを含むディレクトリを指定します。\fB-R\fR が指定されている場合は、この値は無視されます。
-.RE
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-すべてが動作しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-エラーが発生した。
-.RE
+$ <userinput>pkgdepend generate -d proto manifest.py</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_IMAGE</envar></term>
+<listitem><para>パッケージ操作に使用するイメージを含むディレクトリを指定します。<option>R</option> が指定されている場合は、この値は無視されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>すべてが動作しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg </refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/ja_JP/pkgdiff.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgdiff.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,218 +1,136 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgdiff 1 "2013 年 2 月 26 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgdiff \- パッケージマニフェストの比較
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgdiff [-i \fIattribute\fR]... [-o \fIattribute\fR]
-    [-t \fIaction_name\fR[,\fIaction_name\fR]...]...
-    [-v \fIname\fR=\fIvalue\fR]... (\fIfile1\fR | -) (\fIfile2\fR | -)
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkgdiff\fR は 2 つのパッケージマニフェストを比較し、違いを報告します。いずれかのマニフェストを \fBstdin\fR から読み取るには、ファイル名の代わりに \fB-\fR を指定します。\fBpkgdiff\fR は、比較の前に、各マニフェストとアクションを一貫した順序にソートします。
-.sp
-.LP
-出力の形式は次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB+ \fIcomplete_action\fR\fR
-.ad
-.sp .6
-.RS 4n
-このアクションは \fIfile2\fR に含まれていますが、\fIfile1\fR には含まれていません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB- \fIcomplete_action\fR\fR
-.ad
-.sp .6
-.RS 4n
-このアクションは \fIfile1\fR に含まれていますが、\fIfile2\fR には含まれていません。
-.RE
-
-.sp
-.in +2
-.nf
-\fIactionname\fR \fIkeyvalue\fR [\fIvariant values, if any\fR]
-.fi
-.in -2
-
-.sp
-.ne 2
-.mk
-.na
-\fB- \fIattribute1\fR=\fIvalue1\fR\fR
-.ad
-.sp .6
-.RS 4n
-この \fIattribute\fR,\fIvalue\fR は \fIfile1\fR に含まれていますが、\fIfile2\fR には含まれていません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB+ \fIattribute2\fR=\fIvalue2\fR\fR
-.ad
-.sp .6
-.RS 4n
-この \fIattribute\fR,\fIvalue\fR は \fIfile2\fR に含まれていますが、\fIfile1\fR には含まれていません。
-.RE
-
-.sp
-.LP
-バリアントは異なるが、タイプとキー属性値が同じアクションは、比較の目的では別のアクションとして扱われます。そのため、属性を変更したアクションは属性変更としてではなく、完全な形式で表示されます。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-比較中に \fIattribute\fR が存在した場合は、無視します。\fB-i\fR \fIhash\fR により、ファイルのハッシュ値を無視できます。このオプションを \fB-o\fR オプションとともに使用することはできません。このオプションは複数回指定できます。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIattribute\fR の違いのみを報告します。このオプションを \fB-i\fR オプションとともに使用することはできません。このオプションは、アクション時に \fIattribute\fR に影響を与えないアクション変更をすべて省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR[,\fIaction_name\fR]...\fR
-.ad
-.sp .6
-.RS 4n
-指定されたアクションのみを比較します。複数のアクションをコンマ区切りリストで指定できます。\fIaction_name\fR の値は、\fBpkg\fR(5) マニュアルページの「アクション」に一覧表示されているアクションのいずれかです。たとえば、\fIaction_name\fR には次の値を指定できます。\fBfile\fR、\fBdir\fR、\fBdriver\fR、\fBdepend\fR、\fBset\fR。このオプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR \fIname\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-このバリアント値の違いのみを計算します。たとえば、\fBarch=sparc\fR の違いのみを計算します。このバリアントタグは、比較前にすべてのアクションについて削除されます。バリアントあたり 1 つの値のみを指定できます。このオプションは、異なるバリアントに対して複数回指定できます。
-.RE
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-違いは見つかりませんでした。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-違いが見つかりました。
-.RE
+<refentry lang="ja" id="pkgdiff-1">
+<refmeta><refentrytitle>pkgdiff</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 2 月 26 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgdiff</refname><refpurpose>パッケージマニフェストの比較</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgdiff [-i <replaceable>attribute</replaceable>]... [-o <replaceable>attribute</replaceable>]
+    [-t <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]...
+    [-v <replaceable>name</replaceable>=<replaceable>value</replaceable>]... (<replaceable>file1</replaceable> | -) (<replaceable>file2</replaceable> | -)
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgdiff-1-desc" role="description"><title></title>
+<para><command>pkgdiff</command> は 2 つのパッケージマニフェストを比較し、違いを報告します。いずれかのマニフェストを <literal>stdin</literal> から読み取るには、ファイル名の代わりに <literal>-</literal> を指定します。<command>pkgdiff</command> は、比較の前に、各マニフェストとアクションを一貫した順序にソートします。</para>
+<para>出力の形式は次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term>+ <replaceable>complete_action</replaceable></term>
+<listitem><para>このアクションは <replaceable>file2</replaceable> に含まれていますが、<replaceable>file1</replaceable> には含まれていません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>- <replaceable>complete_action</replaceable></term>
+<listitem><para>このアクションは <replaceable>file1</replaceable> に含まれていますが、<replaceable>file2</replaceable> には含まれていません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<programlisting><replaceable>actionname</replaceable> <replaceable>keyvalue</replaceable> [<replaceable>variant values, if any</replaceable>]</programlisting>
+<variablelist termlength="wholeline">
+<varlistentry><term>- <replaceable>attribute1</replaceable>=<replaceable>value1</replaceable></term>
+<listitem><para>この <replaceable>attribute</replaceable>,<replaceable>value</replaceable> は <replaceable>file1</replaceable> に含まれていますが、<replaceable>file2</replaceable> には含まれていません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>+ <replaceable>attribute2</replaceable>=<replaceable>value2</replaceable></term>
+<listitem><para>この <replaceable>attribute</replaceable>,<replaceable>value</replaceable> は <replaceable>file2</replaceable> に含まれていますが、<replaceable>file1</replaceable> には含まれていません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>バリアントは異なるが、タイプとキー属性値が同じアクションは、比較の目的では別のアクションとして扱われます。そのため、属性を変更したアクションは属性変更としてではなく、完全な形式で表示されます。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>サポートしているオプションは、次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-help</option></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>attribute</replaceable></term>
+<listitem><para>比較中に <replaceable>attribute</replaceable> が存在した場合は、無視します。<option>i</option> <replaceable>hash</replaceable> により、ファイルのハッシュ値を無視できます。このオプションを <option>o</option> オプションとともに使用することはできません。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>attribute</replaceable></term>
+<listitem><para><replaceable>attribute</replaceable> の違いのみを報告します。このオプションを <option>i</option> オプションとともに使用することはできません。このオプションは、アクション時に <replaceable>attribute</replaceable> に影響を与えないアクション変更をすべて省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>t</option> <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...</term>
+<listitem>
+<para>指定されたアクションのみを比較します。複数のアクションをコンマ区切りリストで指定できます。<replaceable>action_name</replaceable> の値は、<literal>pkg</literal>(5) マニュアルページの「アクション」に一覧表示されているアクションのいずれかです。たとえば、<replaceable>action_name</replaceable> には次の値を指定できます。<literal>file</literal>、<literal>dir</literal>、<literal>driver</literal>、<literal>depend</literal>、<literal>set</literal>。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option> <replaceable>name</replaceable>=<replaceable>value</replaceable></term>
+<listitem><para>このバリアント値の違いのみを計算します。たとえば、<literal>arch=sparc</literal> の違いのみを計算します。このバリアントタグは、比較前にすべてのアクションについて削除されます。バリアントあたり 1 つの値のみを指定できます。このオプションは、異なるバリアントに対して複数回指定できます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>違いは見つかりませんでした。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>違いが見つかりました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg </refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/ja_JP/pkgfmt.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgfmt.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,147 +1,104 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgfmt 1 "2013 年 5 月 21 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgfmt \- パッケージマニフェストの整形
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgfmt [-c|-d|-u] [\fIpackage-manifest-file\fR]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fB-c\fR または \fB-d\fR オプションが指定されない \fBpkgfmt\fR は、80 文字での行の折り返し、タイプによるアクションのソート、属性のソートなどを含む、一貫した方法でパッケージマニフェストを整形します。アクションに解析されない行 (マクロ、コメント、変換など) は、ソートされた順序では表示されません。
-.sp
-.LP
-引数が指定されない場合、\fBpkgfmt\fR は \fBstdin\fR を EOF まで読み取ったあと、整形されたマニフェストを \fBstdout\fR に書き込みます。コマンド行で指定されたマニフェストはすべて、その場所で整形されます。
-.sp
-.LP
-\fB-c\fR オプションが指定された \fBpkgfmt\fR は、マニフェストが \fBpkgfmt\fR 形式で整形されているかどうかをチェックします。\fB-d\fR オプションを指定すると、ファイルが正しく整形されていない場合にその違いが表示されます。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.RS 10n
-.rt  
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR\fR
-.ad
-.RS 10n
-.rt  
-マニフェストが \fBpkgfmt\fR 形式で整形されているかどうかをチェックします。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.RS 10n
-.rt  
-統合された形式で整形されたバージョンとのマニフェストの違いを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-u\fR\fR
-.ad
-.RS 10n
-.rt  
-80 文字で行を折り返しません。このオプションは、パッケージマニフェストに従来のテキスト処理ツールを適用する場合に有効です。
-.RE
+<?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;
+]>
 
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-\fB-c\fR または \fB-d\fR オプションが指定され、1 つ以上のマニフェストが \fBpkgfmt\fR の正常な形式でないか、またはエラーが発生しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
+<refentry lang="ja" id="pkgfmt-1">
+<refmeta><refentrytitle>pkgfmt</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgfmt</refname><refpurpose>パッケージマニフェストの整形</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgfmt [-c|-d|-u] [<replaceable>package-manifest-file</replaceable>]
+</synopsis></refsynopsisdiv>
+<refsect1 id="pkgfmt-1-desc" role="description"><title></title>
+<para><option>c</option> または <option>d</option> オプションが指定されない <command>pkgfmt</command> は、80 文字での行の折り返し、タイプによるアクションのソート、属性のソートなどを含む、一貫した方法でパッケージマニフェストを整形します。アクションに解析されない行 (マクロ、コメント、変換など) は、ソートされた順序では表示されません。</para>
+<para>引数が指定されない場合、<command>pkgfmt</command> は <literal>stdin</literal> を EOF まで読み取ったあと、整形されたマニフェストを <literal>stdout</literal> に書き込みます。コマンド行で指定されたマニフェストはすべて、その場所で整形されます。</para>
+<para><option>c</option> オプションが指定された <command>pkgfmt</command> は、マニフェストが <command>pkgfmt</command> 形式で整形されているかどうかをチェックします。<option>d</option> オプションを指定すると、ファイルが正しく整形されていない場合にその違いが表示されます。
+</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>サポートしているオプションは、次のとおりです。</para>
+<variablelist>
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option></term>
+<listitem><para>マニフェストが <command>pkgfmt</command> 形式で整形されているかどうかをチェックします。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term>
+<listitem><para>統合された形式で整形されたバージョンとのマニフェストの違いを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>u</option></term>
+<listitem><para>80 文字で行を折り返しません。このオプションは、パッケージマニフェストに従来のテキスト処理ツールを適用する場合に有効です。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para><option>c</option> または <option>d</option> オプションが指定され、1 つ以上のマニフェストが <command>pkgfmt</command> の正常な形式でないか、またはエラーが発生しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/ja_JP/pkglint.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkglint.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,310 +1,135 @@
-'\" te
-.\" Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved.
-.TH pkglint 1 "2014 年 1 月 14 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkglint \- Image Packaging System パッケージ lint
-.SH 形式
-.LP
-.nf
-/usr/bin/pkglint [-c \fIcache_dir\fR] [-r \fIrepo_uri\fR]... [-p \fIregexp\fR]
-    [-f \fIconfig_file\fR] [-b \fIbuild_no\fR] [-v]
-    [-l \fIlint_uri\fR] | \fImanifest\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkglint -L [-v]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkglint\fR は、必要に応じて別のリポジトリを参照しながら、1 つ以上のパッケージマニフェストに対して一連のチェックを実行します。
-.sp
-.LP
-\fBpkglint\fR は、パッケージ公開前の、パッケージ作成処理中に使用するべきです。\fBpkglint\fR は、マニフェストに対して、\fBpkgsend\fR または \fBpkg.depotd\fR の通常動作中に実行するには負荷が大きすぎる可能性のある徹底的なテストを実行します。\fBpkglint\fR のチェックには、重複したアクション、欠落した属性、および異常なファイルアクセス権に対するテストが含まれます。
-.sp
-.LP
-lint のためのマニフェストは、コマンド行で、スペースで区切られたローカルファイルのリストとして渡すことができます。または、リポジトリからマニフェストを取得できます。
-.sp
-.LP
-リポジトリからマニフェストを取得する場合、\fBpkglint\fR は最初の実行で、指定されたキャッシュディレクトリ内に \fBpkg\fR(5) ユーザーイメージを作成して設定します。\fB-r\fR オプションが指定されている場合は、参照リポジトリのために \fIcache_dir\fR\fB/ref_image\fR という名前のユーザーイメージが作成されます。\fB-l\fR オプションが指定されている場合は、lint リポジトリのために \fIcache_dir\fR\fB/lint_image\fR という名前のユーザーイメージが作成されます。これらのイメージに内容はインストールされません。これらのイメージは、リポジトリからマニフェストを取得するために \fBpkglint\fR でのみ使用されます。
-.sp
-.LP
-\fBpkglint\fR の以降の呼び出しではキャッシュディレクトリを再利用できるため、\fB-r\fR または \fB-l\fR 引数はすべて省略できます。
-.sp
-.LP
-\fBpkglint\fR では、キャッシュディレクトリ内のパブリッシャーを構成するためのサポートが制限されています。これらのイメージに対して、より複雑な発行元の構成を実行するには、\fBpkg\fR を使用します。
-.sp
-.LP
-\fBpkglint\fR では、パッケージ作成者は、特定のマニフェストまたはアクションに対するチェックをバイパスできます。\fBTrue\fR に設定された属性 \fBpkg.linted\fR を含むマニフェストまたはアクションでは、そのマニフェストまたはアクションに対する lint 出力は生成されません。
-.sp
-.LP
-\fBpkglint\fR チェックの名前の部分文字列を使用して、よりきめ細かな \fBpkg.linted\fR 設定を行うことができます。たとえば、\fBpkg.linted.\fI check\fR.\fIid\fR\fR が \fBTrue\fR に設定されていると、特定のマニフェストまたはアクションに対する \fB\fIcheck\fR.\fIid \fR\fR という名前を持つすべてのチェックがバイパスされます。
-.sp
-.LP
-\fBpkglint\fR の動作は、\fBpkglintrc\fR ファイルを指定することによって構成できます。デフォルトでは、\fBpkglint\fR は、\fB/usr/share/lib/pkg/pkglintrc\fR および \fB$HOME/.pkglintrc \fR 内の構成オプションを検索します。別の構成ファイルを指定するには、\fB-f\fR オプションを使用します。
-.sp
-.LP
-lint の実行中に検出されたエラーまたは警告はすべて \fBstderr\fR に出力されます。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-b\fR \fIbuild_no\fR\fR
-.ad
-.sp .6
-.RS 4n
-lint および参照リポジトリからの lint 中に使用されるパッケージのリストを絞り込むために使用されるビルド番号を指定します。\fB-b\fR オプションが指定されていない場合は、最新バージョンのパッケージが使用されます。\fBversion.pattern \fR 構成プロパティーも参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-lint および参照リポジトリからのパッケージのメタデータをキャッシュするために使用されるローカルディレクトリを指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR \fIlint_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-lint リポジトリの場所を表す URI を指定します。HTTP ベースとファイルシステムベースの両方の公開がサポートされています。\fB-l\fR を指定する場合は、\fB-c\fR も指定する必要があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-L\fR\fR
-.ad
-.sp .6
-.RS 4n
-既知の lint チェックと除外された lint チェックを一覧表示してから終了します。各チェックの短縮名と説明を表示します。\fB-v\fR フラグと組み合わせる場合は、説明の代わりに、このチェックを実装するメソッドを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR \fIconfig_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIconfig_file\fR 構成ファイルを使用して \fBpkglint\fR セッションを構成します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIregexp\fR\fR
-.ad
-.sp .6
-.RS 4n
-lint リポジトリからチェックされるパッケージのリストを絞り込むために使用される正規表現を指定します。参照リポジトリからはすべてのマニフェストがロードされ (\fB-b\fR が指定されている場合は、その値に一致すると仮定)、このパターンは無視されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR \fIrepo_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-参照リポジトリの場所を表す URI を指定します。\fB-r\fR を指定する場合は、\fB-c\fR も指定する必要があります。\fB-r\fR オプションは複数回指定できます。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkglint\fR を冗長モードで実行し、構成ファイル内の \fBlog_level\fR 設定をすべて上書きします。
-.RE
-
-.SH ファイル
-.sp
-.LP
-\fBpkglintrc\fR 構成ファイルは、次のキーと値の引数を取ります。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlog_level\fR\fR
-.ad
-.sp .6
-.RS 4n
-lint メッセージを発行する最小のレベル。このレベルより低い lint メッセージは破棄されます。デフォルト値は \fBINFO\fR です。
-.sp
-ログレベルを最小のレベルからもっとも重大なレベルの順に示すと、\fBDEBUG\fR、\fBINFO\fR、\fBWARNING\fR、\fBERROR\fR、\fBCRITICAL\fR になります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdo_pub_checks\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBTrue\fR の場合は、公開されたパッケージにとってのみ意味がある可能性のあるチェックを実行します。デフォルト値は \fBTrue\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkglint.ext.\fR*\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkglint\fR のプラグインメカニズムを使用すると、実行時に lint モジュールを追加できます。\fBpkglint.ext.\fR で始まるキーはすべて、完全に指定された Python モジュールである必要のある値を取ります。詳細は、「開発者」のセクションを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkglint.exclude\fR\fR
-.ad
-.sp .6
-.RS 4n
-実行されるチェックのセットから省略する、完全に指定された Python モジュール、クラス、または関数名のスペースで区切られたリスト。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuse_progress_tracker\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBTrue\fR の場合は、lint の実行中にマニフェストに対する処理を繰り返すときに進捗トラッカーを使用します。デフォルト値は \fBTrue\fR です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBversion.pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-lint の対象となるビルド番号を指定するときに使用されるバージョンのパターン (\fB-b\fR)。構成ファイルで指定されていない場合、\fB-b\fR オプションはパターン \fB*,5.11-0.\fR を使用します。これは、ブランチ接頭辞が 0 である 5.11 ビルドのすべてのコンポーネントに一致します。
-.RE
-
-.SH 開発者
-.sp
-.LP
-\fBpkglint\fR によって実行されるチェックのセットを拡張するには、\fBpkg.lint.base.Checker\fR とそのサブクラス \fBManifestChecker \fR、\fBActionChecker\fR、および \fBContentChecker\fR をサブクラス化します。これらのクラスを含む Python モジュール名を、構成ファイル内の新しい \fBpkglint.ext.\fR キーに追加します。
-.sp
-.LP
-これらの新しいサブクラスのインスタンスは、起動時に \fBpkglint\fR によって作成されます。lint セッション中に、特殊なキーワード引数 \fBpkglint_id\fR を持つ、各サブクラスの内部のメソッドが呼び出されます。これらのメソッドには、スーパークラス内の対応する \fBcheck()\fR メソッドと同じ署名が含まれているべきです。また、これらのメソッドには、\fBpkglint -L\fR によって出力される説明として使用される \fBpkglint_desc\fR 属性も割り当てられていなくてはいけません。
-.sp
-.LP
-パラメータは \fBChecker\fR サブクラスから使用できます。これにより、これらのサブクラスは自身の動作を調整できます。推奨されるパラメータの命名規則は、\fB\fIpkglint_id\fR.\fIname\fR\fR です。パラメータ値は構成ファイル内に格納するか、または \fBLintEngine.get_param()\fR メソッドを使用して取得されるマニフェストまたはアクションでアクセスすることができます。マニフェストからパラメータにアクセスする場合は、\fBpkglint\fR パラメータが既存のどのアクションまたはマニフェスト値とも重複しないようにするために、キー名に接頭辞 \fBpkg.lint\fR が付加されます。
-.SH 使用例
-.LP
-\fB例 1 \fR特定のリポジトリに対する最初の実行
-.sp
-.LP
-特定のリポジトリに対する \fBpkglint\fR セッションのはじめての実行。
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache -r http://localhost:10000 mymanifest.mf\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fR同じリポジトリに対するそれ以降の実行
-.sp
-.LP
-例 1 で使用されている同じリポジトリに対するそれ以降の実行。
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache mymanifest-fixed.mf\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 3 \fR絞り込まれたマニフェストセットでの lint リポジトリの使用
-.sp
-.LP
-lint リポジトリでの \fBpkglint\fR セッションの実行と、チェックするマニフェストのサブセットの指定。
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/othercache -l http://localhost:10000 \e\fR
-\fB-p '.*firefox.*'\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 4 \fRビルドの指定
-.sp
-.LP
-冗長モードでの特定のビルドに対する \fBpkglint\fR セッションの実行。
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache -r http://localhost:10000 \e\fR
-\fB-l http://localhost:12000 -b 147 -v\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 5 \fR構成ファイルの変更
-.sp
-.LP
-新しい lint モジュールを含む構成ファイル (一部のチェックを除外)。
-
-.sp
-.in +2
-.nf
-$ \fBcat ~/.pkglintrc\fR
+<refentry lang="ja" id="pkglint-1">
+<refmeta><refentrytitle>pkglint</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2014 年 4 月 29 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkglint</refname><refpurpose>Image Packaging System パッケージ lint</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkglint [-c <replaceable>cache_dir</replaceable>] [-r <replaceable>
+repo_uri</replaceable>]... [-p <replaceable>regexp</replaceable>]
+    [-f <replaceable>config_file</replaceable>] [-b <replaceable>build_no</replaceable>] [-v]
+    [-l <replaceable>lint_uri</replaceable>]... | <replaceable>manifest</replaceable> ...
+</synopsis>
+<synopsis>/usr/bin/pkglint -L [-v]</synopsis>
+</refsynopsisdiv>
+<refsect1 role="description"><title></title>
+<para><command>pkglint</command> は、必要に応じて別のリポジトリを参照しながら、1 つ以上のパッケージマニフェストに対して一連のチェックを実行します。</para>
+<para><command>pkglint</command> は、パッケージ公開前の、パッケージ作成処理中に使用するべきです。<command>pkglint</command> は、マニフェストに対して、<command>pkgsend</command> または <command>pkg.depotd</command> の通常動作中に実行するには負荷が大きすぎる可能性のある徹底的なテストを実行します。<command>pkglint</command> のチェックには、重複したアクション、欠落した属性、および異常なファイルアクセス権に対するテストが含まれます。</para>
+<para>lint のためのマニフェストは、コマンド行で、スペースで区切られたローカルファイルのリストとして渡すことができます。または、リポジトリからマニフェストを取得できます。</para>
+<para>リポジトリからマニフェストを取得する場合、<command>pkglint</command> は最初の実行で、指定されたキャッシュディレクトリ内に <literal>pkg</literal>(5) ユーザーイメージを作成して設定します。<option>r</option> オプションが指定されている場合は、参照リポジトリのために <replaceable>cache_dir</replaceable><literal>/ref_image</literal> という名前のユーザーイメージが作成されます。<option>l</option> オプションが指定されている場合は、lint リポジトリのために <replaceable>cache_dir</replaceable><literal>/lint_image</literal> という名前のユーザーイメージが作成されます。これらのイメージに内容はインストールされません。これらのイメージは、リポジトリからマニフェストを取得するために <command>pkglint</command> でのみ使用されます。</para>
+<para><command>pkglint</command> の以降の呼び出しではキャッシュディレクトリを再利用できるため、<option>r</option> または <option>l</option> 引数はすべて省略できます。</para>
+<para><command>pkglint</command> では、キャッシュディレクトリ内のパブリッシャーを構成するためのサポートが制限されています。これらのイメージに対して、より複雑な発行元の構成を実行するには、<command>pkg</command> を使用します。</para>
+<para><command>pkglint</command> では、パッケージ作成者は、特定のマニフェストまたはアクションに対するチェックをバイパスできます。<literal>True</literal> に設定された属性 <literal>pkg.linted</literal> を含むマニフェストまたはアクションでは、そのマニフェストまたはアクションに対する lint 出力は生成されません。</para>
+<para><command>pkglint</command> チェックの名前の部分文字列を使用して、よりきめ細かな <literal>pkg.linted</literal> 設定を行うことができます。たとえば、<literal>pkg.linted.<replaceable> check</replaceable>.<replaceable>id</replaceable></literal> が <literal>True</literal> に設定されていると、特定のマニフェストまたはアクションに対する <literal><replaceable>check</replaceable>.<replaceable>id </replaceable></literal> という名前を持つすべてのチェックがバイパスされます。</para>
+<para><command>pkglint</command> の動作は、<filename>pkglintrc</filename> ファイルを指定することによって構成できます。デフォルトでは、<command>pkglint</command> は、<filename>/usr/share/lib/pkg/pkglintrc</filename> および <filename>$HOME/.pkglintrc </filename> 内の構成オプションを検索します。別の構成ファイルを指定するには、<option>f</option> オプションを使用します。</para>
+<para>lint の実行中に検出されたエラーまたは警告はすべて <filename>stderr</filename> に出力されます。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>サポートしているオプションは、次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>b</option> <replaceable>build_no</replaceable></term>
+<listitem><para>lint および参照リポジトリからの lint 中に使用されるパッケージのリストを絞り込むために使用されるビルド番号を指定します。<option>b</option> オプションが指定されていない場合は、最新バージョンのパッケージが使用されます。<literal>version.pattern </literal> 構成プロパティーも参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>lint および参照リポジトリからのパッケージのメタデータをキャッシュするために使用されるローカルディレクトリを指定します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option> <replaceable>lint_uri</replaceable></term>
+<listitem><para>lint リポジトリの場所を表す URI を指定します。HTTP ベースとファイルシステムベースの両方の公開がサポートされています。<option>l</option> を指定する場合は、<option>c</option> も指定する必要があります。<option>l</option> オプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>L</option></term>
+<listitem><para>既知の lint チェックと除外された lint チェックを一覧表示してから終了します。各チェックの短縮名と説明を表示します。<option>v</option> フラグと組み合わせる場合は、説明の代わりに、このチェックを実装するメソッドを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>f</option> <replaceable>config_file</replaceable></term>
+<listitem><para><replaceable>config_file</replaceable> 構成ファイルを使用して <command>pkglint</command> セッションを構成します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>regexp</replaceable></term>
+<listitem><para>lint リポジトリからチェックされるパッケージのリストを絞り込むために使用される正規表現を指定します。参照リポジトリからはすべてのマニフェストがロードされ (<option>b</option> が指定されている場合は、その値に一致すると仮定)、このパターンは無視されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option> <replaceable>repo_uri</replaceable></term>
+<listitem><para>参照リポジトリの場所を表す URI を指定します。<option>r</option> を指定する場合は、<option>c</option> も指定する必要があります。<option>r</option> オプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para><command>pkglint</command> を冗長モードで実行し、構成ファイル内の <literal>log_level</literal> 設定をすべて上書きします。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para><filename>pkglintrc</filename> 構成ファイルは、次のキーと値の引数を取ります。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>log_level</literal></term>
+<listitem><para>lint メッセージを発行する最小のレベル。このレベルより低い lint メッセージは破棄されます。デフォルト値は <literal>INFO</literal> です。
+</para>
+<para>ログレベルを最小のレベルからもっとも重大なレベルの順に示すと、<literal>DEBUG</literal>、<literal>INFO</literal>、<literal>WARNING</literal>、<literal>ERROR</literal>、<literal>CRITICAL</literal> になります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>do_pub_checks</literal></term>
+<listitem><para><literal>True</literal> の場合は、公開されたパッケージにとってのみ意味がある可能性のあるチェックを実行します。デフォルト値は <literal>True</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkglint.ext.</literal>*</term>
+<listitem><para><command>pkglint</command> のプラグインメカニズムを使用すると、実行時に lint モジュールを追加できます。<literal>pkglint.ext.</literal> で始まるキーはすべて、完全に指定された Python モジュールである必要のある値を取ります。詳細は、「開発者」のセクションを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkglint.exclude</literal></term>
+<listitem><para>実行されるチェックのセットから省略する、完全に指定された Python モジュール、クラス、または関数名のスペースで区切られたリスト。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>use_progress_tracker</literal></term>
+<listitem><para><literal>True</literal> の場合は、lint の実行中にマニフェストに対する処理を繰り返すときに進捗トラッカーを使用します。デフォルト値は <literal>True</literal> です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>version.pattern</literal></term>
+<listitem><para>lint の対象となるビルド番号を指定するときに使用されるバージョンのパターン (<option>b</option>)。構成ファイルで指定されていない場合、<option>b</option> オプションはパターン <literal>*,5.11-0.</literal> を使用します。これは、ブランチ接頭辞が 0 である 5.11 ビルドのすべてのコンポーネントに一致します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>開発者</title>
+<para><command>pkglint</command> によって実行されるチェックのセットを拡張するには、<literal>pkg.lint.base.Checker</literal> とそのサブクラス <literal>ManifestChecker </literal>、<literal>ActionChecker</literal>、および <literal>ContentChecker</literal> をサブクラス化します。これらのクラスを含む Python モジュール名を、構成ファイル内の新しい <literal>pkglint.ext.</literal> キーに追加します。</para>
+<para>これらの新しいサブクラスのインスタンスは、起動時に <command>pkglint</command> によって作成されます。lint セッション中に、特殊なキーワード引数 <literal>pkglint_id</literal> を持つ、各サブクラスの内部のメソッドが呼び出されます。これらのメソッドには、スーパークラス内の対応する <function>check</function> メソッドと同じ署名が含まれているべきです。また、これらのメソッドには、<command>pkglint -L</command> によって出力される説明として使用される <literal>pkglint_desc</literal> 属性も割り当てられていなくてはいけません。</para>
+<para>パラメータは <literal>Checker</literal> サブクラスから使用できます。これにより、これらのサブクラスは自身の動作を調整できます。推奨されるパラメータの命名規則は、<literal><replaceable>pkglint_id</replaceable>.<replaceable>name</replaceable></literal> です。パラメータ値は構成ファイル内に格納するか、または <function>LintEngine.get_param</function> メソッドを使用して取得されるマニフェストまたはアクションでアクセスすることができます。マニフェストからパラメータにアクセスする場合は、<command>pkglint</command> パラメータが既存のどのアクションまたはマニフェスト値とも重複しないようにするために、キー名に接頭辞 <literal>pkg.lint</literal> が付加されます。</para>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>特定のリポジトリに対する最初の実行</title>
+<para>特定のリポジトリに対する <command>pkglint</command> セッションのはじめての実行。</para>
+<screen>$ <userinput>pkglint -c /space/cache -r http://localhost:10000 mymanifest.mf</userinput></screen>
+</example>
+<example><title>同じリポジトリに対するそれ以降の実行</title>
+<para>例 1 で使用されている同じリポジトリに対するそれ以降の実行。</para>
+<screen>$ <userinput>pkglint -c /space/cache mymanifest-fixed.mf</userinput></screen>
+</example>
+<example><title>絞り込まれたマニフェストセットでの lint リポジトリの使用</title>
+<para>lint リポジトリでの <command>pkglint</command> セッションの実行と、チェックするマニフェストのサブセットの指定。</para>
+<screen>$ <userinput>pkglint -c /space/othercache -l http://localhost:10000 &bsol;</userinput>
+<userinput>-p '.*firefox.*'</userinput></screen>
+</example>
+<example><title>ビルドの指定</title>
+<para>冗長モードでの特定のビルドに対する <command>pkglint</command> セッションの実行。</para>
+<screen>$ <userinput>pkglint -c /space/cache -r http://localhost:10000 &bsol;</userinput>
+<userinput>-l http://localhost:12000 -b 147 -v</userinput></screen>
+</example>
+<example><title>構成ファイルの変更</title>
+<para>新しい lint モジュールを含む構成ファイル (一部のチェックを除外)。</para>
+<screen>$ <userinput>cat ~/.pkglintrc</userinput>
 [pkglint]
 
 log_level = DEBUG
@@ -314,82 +139,66 @@
 pkglint.ext.opensolaris = pkg.lint.opensolaris
 pkglint.exclude: pkg.lint.opensolaris.OpenSolarisActionChecker
 pkg.lint.pkglint.PkgActionChecker.unusual_perms pkg.lint.pkglint.PkgManifestChecker
-pkg.lint.opensolaris.OpenSolarisManifestChecker
-.fi
-.in -2
-.sp
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-1 つ以上のパッケージマニフェストに lint エラーが含まれています。
-.RE
+pkg.lint.opensolaris.OpenSolarisManifestChecker</screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>1 つ以上のパッケージマニフェストに lint エラーが含まれています。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>マニフェストで lint エラーではないエラーが発生しました。たとえば、無効なコマンド行オプションが指定されました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg </refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd </refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle> <manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum> </citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-マニフェストで lint エラーではないエラーが発生しました。たとえば、無効なコマンド行オプションが指定されました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(1), \fBpkg.depotd\fR(1M), \fBpkgsend\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/ja_JP/pkgmerge.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgmerge.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,468 +1,231 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgmerge 1 "2013 年 11 月 14 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgmerge \- Image Packaging System パッケージマージユーティリティー
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgmerge [-n] -d \fIdest_repo\fR
-    [-p \fIpublisher_prefix\fR]...
-    -s \fIvariant\fR=\fIvalue\fR[,...],\fIsrc_repo\fR ...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkgmerge\fR は、複数バリアントのパッケージを作成するためのパッケージ公開ツールです。このツールはそのために、名前とバージョン (タイムスタンプは除外) が同じパッケージをマージし、特定のソースの指定されたバリアント名および値とマージされるバージョン内で一意であるアクションをタグ付けしたあと、新しいパッケージをターゲットリポジトリに公開します。各ソースのすべてのパッケージの最新バージョンのみが使用されます。
-.sp
-.LP
-アクションの属性 \fBpkg.merge.blend\fR がマージされるバリアントの名前に設定されている場合は、アクションの最終的な出力に追加されたバリアントタグが含まれないようにするために、そのアクションはマージの前にほかのマニフェストにコピーされます。属性 \fBpkg.merge.blend\fR 自体は、出力マニフェストですべてのアクションから削除されることに注意してください。この属性は、複数のパスマージに異なる値を使用して繰り返すことができます。
-.sp
-.LP
-入力マニフェスト内の同じパスに入る同一でないアクションがあると、\fBpkgmerge\fR はエラーで終了します。
-.sp
-.LP
-\fBpkgmerge\fR 操作後に、公開先のリポジトリが \fBpkg search\fR 操作をサポートする必要がある場合は、リポジトリ上で \fBpkgrepo refresh\fR を実行して、検索インデックスを更新してください。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIdest_repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-マージされたパッケージを公開する先のターゲットリポジトリのファイルシステムのパスまたは URI を指定します。このターゲットリポジトリはすでに存在している必要があります。新しいリポジトリは、\fBpkgrepo\fR を使用して作成できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-ターゲットリポジトリを変更することなく、試験実行を行います。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher_prefix\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージのマージ元になるパブリッシャーの名前を指定します。このオプションは複数回指定できます。
-.sp
-デフォルトでは、すべてのソースリポジトリ内のすべてのパブリッシャーからパッケージがマージされます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIvariant\fR=\fIvalue\fR[,...],\fIsrc_repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-このソースのパッケージに使用するバリアント名および値、そのあとに、パッケージを取得する元のソースリポジトリまたはパッケージアーカイブのファイルシステムのパスまたは URI を指定します。複数のバリアントをコンマで区切って指定できます。すべてのソースに対して同じバリアントを指定する必要があります。このオプションは複数回指定できます。
-.RE
-
-.SH オペランド
-.sp
-.LP
-次のオペランドを指定できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-マージするパッケージを指定します。\fIpkg_fmri_pattern\fR オペランドには、\fBglob\fR(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する \fB?\fR および \fB*\fR 文字を含めることができます。
-.RE
-
-.SH 環境
-.sp
-.LP
-次の環境変数がサポートされています。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBTMPDIR\fR\fR
-.ad
-.RS 10n
-.rt  
-プログラム実行中に一時データが格納されるディレクトリの絶対パス。設定されていない場合、一時データはデフォルトで \fB/var/tmp\fR に格納されます。
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fRバリアント名および値を指定する
-.sp
-.LP
-指定されたソース内に見つかった各パッケージを、取得元のソースに指定された特定のバリアント名および値でタグ付けします。
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src.example.com \e\fR
-\fB-d http://dest.example.com\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-サンプルパッケージ:
+<?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;
+]>
 
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-操作のあとのサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+<refentry lang="ja" id="pkgmerge-1">
+<refmeta><refentrytitle>pkgmerge</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 11 月 14 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgmerge</refname><refpurpose>Image Packaging System パッケージマージユーティリティー</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgmerge [-n] -d <replaceable>dest_repo</replaceable>
+    [-p <replaceable>publisher_prefix</replaceable>]...
+    -s <replaceable>variant</replaceable>=<replaceable>value</replaceable>[,...],<replaceable>src_repo</replaceable> ...
+    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgmerge-1-desc" role="description"><title></title>
+<para><command>pkgmerge</command> は、複数バリアントのパッケージを作成するためのパッケージ公開ツールです。このツールはそのために、名前とバージョン (タイムスタンプは除外) が同じパッケージをマージし、特定のソースの指定されたバリアント名および値とマージされるバージョン内で一意であるアクションをタグ付けしたあと、新しいパッケージをターゲットリポジトリに公開します。各ソースのすべてのパッケージの最新バージョンのみが使用されます。</para>
+<para>アクションの属性 <literal>pkg.merge.blend</literal> がマージされるバリアントの名前に設定されている場合は、アクションの最終的な出力に追加されたバリアントタグが含まれないようにするために、そのアクションはマージの前にほかのマニフェストにコピーされます。属性 <literal>pkg.merge.blend</literal> 自体は、出力マニフェストですべてのアクションから削除されることに注意してください。この属性は、複数のパスマージに異なる値を使用して繰り返すことができます。</para>
+<para>入力マニフェスト内の同じパスに入る同一でないアクションがあると、<command>pkgmerge</command> はエラーで終了します。</para>
+<para><command>pkgmerge</command> 操作後に、公開先のリポジトリが <command>pkg search</command> 操作をサポートする必要がある場合は、リポジトリ上で <command>pkgrepo refresh</command> を実行して、検索インデックスを更新してください。</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>d</option> <replaceable>dest_repo</replaceable></term>
+<listitem><para>マージされたパッケージを公開する先のターゲットリポジトリのファイルシステムのパスまたは URI を指定します。このターゲットリポジトリはすでに存在している必要があります。新しいリポジトリは、<command>pkgrepo</command> を使用して作成できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>ターゲットリポジトリを変更することなく、試験実行を行います。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher_prefix</replaceable></term>
+<listitem><para>パッケージのマージ元になるパブリッシャーの名前を指定します。このオプションは複数回指定できます。</para>
+<para>デフォルトでは、すべてのソースリポジトリ内のすべてのパブリッシャーからパッケージがマージされます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>variant</replaceable>=<replaceable>value</replaceable>[,...],<replaceable>src_repo</replaceable></term>
+<listitem><para>このソースのパッケージに使用するバリアント名および値、そのあとに、パッケージを取得する元のソースリポジトリまたはパッケージアーカイブのファイルシステムのパスまたは URI を指定します。複数のバリアントをコンマで区切って指定できます。すべてのソースに対して同じバリアントを指定する必要があります。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="operands"><title></title>
+<para>次のオペランドを指定できます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>マージするパッケージを指定します。<replaceable>pkg_fmri_pattern</replaceable> オペランドには、<literal>glob</literal>(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する <literal>?</literal> および <literal>*</literal> 文字を含めることができます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<para>次の環境変数がサポートされています。</para>
+<variablelist>
+<varlistentry><term><envar>TMPDIR</envar></term>
+<listitem><para>プログラム実行中に一時データが格納されるディレクトリの絶対パス。設定されていない場合、一時データはデフォルトで <filename>/var/tmp</filename> に格納されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>バリアント名および値を指定する</title>
+<para>指定されたソース内に見つかった各パッケージを、取得元のソースに指定された特定のバリアント名および値でタグ付けします。</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src.example.com &bsol;</userinput>
+<userinput>-d http://dest.example.com</userinput></screen>
+<para>サンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>操作のあとのサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fB例 2 \fRパッケージをマージおよび公開する
-.sp
-.LP
-特定のソースの最新バージョンの各パッケージをマージし、新しいパッケージをターゲットリポジトリに公開します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src1.example.com \e\fR
-\fB-s arch=i386,http://src2.example.com \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-ソース 1 (SPARC) のサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-ソース 2 (i386) のサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-マージされたパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example><title>パッケージをマージおよび公開する</title>
+<para>特定のソースの最新バージョンの各パッケージをマージし、新しいパッケージをターゲットリポジトリに公開します。</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src1.example.com &bsol;</userinput>
+<userinput>-s arch=i386,http://src2.example.com &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>ソース 1 (SPARC) のサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>ソース 2 (i386) のサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>マージされたパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc value=i386
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fB例 3 \fRi386 システムと SPARC システムのデバッグおよびデバッグ以外のパッケージをマージする
-.sp
-.LP
-i386 システムと SPARC システムの一連のデバッグおよびデバッグ以外のリポジトリ内の最新バージョンの各パッケージをマージします。
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,debug=false,/repo/sparc-nondebug \e\fR
-\fB-s arch=sparc,debug=true,/repo/sparc-debug \e\fR
-\fB-s arch=i386,debug=false,/repo/i386-nondebug \e\fR
-\fB-s arch=i386,debug=true,/repo/i386-debug \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-ソース 1 (SPARC デバッグ以外) のサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-ソース 2 (SPARC デバッグ) のサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121411Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-ソース 3 (i386 デバッグ以外) のサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-ソース 4 (i386 デバッグ) のサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-マージされたパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example><title>i386 システムと SPARC システムのデバッグおよびデバッグ以外のパッケージをマージする</title>
+<para>i386 システムと SPARC システムの一連のデバッグおよびデバッグ以外のリポジトリ内の最新バージョンの各パッケージをマージします。</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,debug=false,/repo/sparc-nondebug &bsol;</userinput>
+<userinput>-s arch=sparc,debug=true,/repo/sparc-debug &bsol;</userinput>
+<userinput>-s arch=i386,debug=false,/repo/i386-nondebug &bsol;</userinput>
+<userinput>-s arch=i386,debug=true,/repo/i386-debug &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>ソース 1 (SPARC デバッグ以外) のサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>ソース 2 (SPARC デバッグ) のサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121411Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>ソース 3 (i386 デバッグ以外) のサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>ソース 4 (i386 デバッグ) のサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>マージされたパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
 set name=variant.arch value=sparc value=i386
 set name=variant.debug value=false value=true
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=false
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=true
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=false
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=true
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fB例 4 \fR\fBpkg.merge.blend\fR を使用してマージする
-.sp
-.LP
-\fBpkg.merge.blend\fR 属性を使用して、競合しない 2 つのアーキテクチャーのパッケージをマージします。
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src1/example.com \e\fR
-\fB-s arch=i386,http://src2.example.com \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-ソース 1 (SPARC) のサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root \e
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=false
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=true
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=false
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=true
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example id="GLFDD"><title><literal>pkg.merge.blend</literal> を使用してマージする</title>
+<para><literal>pkg.merge.blend</literal> 属性を使用して、競合しない 2 つのアーキテクチャーのパッケージをマージします。</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src1/example.com &bsol;</userinput>
+<userinput>-s arch=i386,http://src2.example.com &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>ソース 1 (SPARC) のサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/sparc/foo pkg.merge.blend=arch
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-ソース 2 (i386) のサンプルパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root \e
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>ソース 2 (i386) のサンプルパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root &bsol;
     group=bin path=usr/bin/i386/foo pkg.merge.blend=arch
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-マージされたパッケージ:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>マージされたパッケージ:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc value=i386
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root \e
+file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root &bsol;
     group=bin path=usr/bin/i386/foo
-file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root \e
+file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/sparc/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fB例 5 \fR異なるパブリッシャー接頭辞が付いたパッケージのマージ
-.sp
-.LP
-これらのリポジトリ内のほかのパッケージに \fBexample.com\fR 接頭辞が付いている場合でも、\fBdev\fR 接頭辞が付いたパッケージのみをマージします。
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -p dev -s arch=sparc,http://src1.example.com \e
--s arch=i386,http://src2.example.com \e
--d /path/to/target/repository\fR
-.fi
-.in -2
-.sp
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkgrepo\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fI『Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2 』\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example id="differentpubs"><title>異なるパブリッシャー接頭辞が付いたパッケージのマージ</title>
+<para>これらのリポジトリ内のほかのパッケージに <literal>example.com</literal> 接頭辞が付いている場合でも、<literal>dev</literal> 接頭辞が付いたパッケージのみをマージします。</para>
+<screen>$ <userinput>pkgmerge -p dev -s arch=sparc,http://src1.example.com &bsol;
+-s arch=i386,http://src2.example.com &bsol;
+-d /path/to/target/repository</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="PKDEV"><citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
--- a/src/man/ja_JP/pkgmogrify.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgmogrify.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,624 +1,286 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgmogrify 1 "2013 年 7 月 12 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgmogrify \- Image Packaging System マニフェスト変換ツール
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgmogrify [-vi] [-I \fIincludedir\fR]...
-    [-D \fImacro\fR=\fIvalue\fR]... [-O \fIoutputfile\fR]
-    [-P \fIprintfile\fR] [\fIinputfile\fR ...]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkgmogrify\fR は、パッケージマニフェストのプログラムによる編集を可能にして、ソフトウェアの構築やパッケージの公開を自動化するときに必要な標準的な変換を簡略化します。
-.sp
-.LP
-\fBpkgmogrify\fR は、次の機能を提供します。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-マクロ置換。単一のマニフェストを各種アーキテクチャーやプラットフォーム間で簡単に共有できます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ほかのマニフェスト、または標準のコンポーネントや変換などのマニフェストフラグメントの取り込み。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-パッケージアクションの変換。アクション属性の変更、削除、または追加が含まれます。
-.RE
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-D\fR \fImacro\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fImacro\fR を値 \fIvalue\fR とともにマクロとして定義します。このオプションは複数回指定できます。マクロは、入力ファイル内で \fB$(macro)\fR として指定されます。置換は、それ以上の変換が見つからなくなるまで繰り返されます。一般的な語法には次のものがあります。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-行の先頭にあるアーキテクチャー固有のタグを使用した、ほかのアーキテクチャー上のマニフェスト内の行の除外。
-.sp
-.in +2
-.nf
-$(sparc_ONLY)file ...
-.fi
-.in -2
-
-SPARC アーキテクチャーを処理する場合、このマクロは空の文字列に設定されます。ほかのアーキテクチャーを処理する場合、このマクロはコマンド行で \fB#\fR に設定されるため、このアクションが現在のアーキテクチャー上のマニフェストから除外されます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-パス名のプラットフォーム固有の部分の指定。実行可能ファイルおよびライブラリのための 64 ビットアーキテクチャーディレクトリの名前などがあります。
-.sp
-.in +2
-.nf
-file path=usr/bin/$(ARCH64)/cputrack ...
-.fi
-.in -2
-
-これらのマクロは、コマンド行で目的の値に設定するようにしてください。定義済みのマクロ値は存在しません。
-.RE
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR \fIincludedir\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたディレクトリを、コマンド行で指定されたファイルと、埋め込みのインクルード指令の両方の検索パスに追加します。このオプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-O\fR \fIoutputfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-マニフェスト出力を指定されたファイルに書き込みます。このファイルは、エラーが発生した場合や、変換指令によって強制的な中止操作が実行された場合は書き込まれません。デフォルトでは、マニフェスト出力は\fB標準出力\fRに書き込まれます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR \fIprintfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-変換指令の出力操作から得られた出力を指定されたファイルに書き込みます。このファイルは、エラーが発生した場合や、変換指令によって強制的な中止操作が実行された場合は書き込まれません。デフォルトでは、この出力は\fB標準出力\fRに書き込まれます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-ファイル内のインクルード指令を無視します。コマンド行 (または\fB標準入力\fR) で指定されたファイルのみが処理されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-出力マニフェストに変換の効果を示すコメントを書き込みます。この情報がデバッグに役立つことがあります。
-.RE
-
-.SH 埋め込みの指令
-.sp
-.LP
-マニフェストファイルでは、インクルード指令と変換指令という 2 つのタイプの指令がサポートされています。
-.sp
-.LP
-インクルード指令の形式は次のとおりです。
-.sp
-.in +2
-.nf
-<include \fIfile\fR>
-.fi
-.in -2
-
-.sp
-.LP
-この指令により、\fBpkgmogrify\fR は \fBfile\fR という名前のファイルを、最初に現在のディレクトリで、次に \fB-I\fR オプションで指定されたディレクトリで検索します。見つかった場合は、ファイルの内容がマニフェストの、この指令が置かれている場所に挿入されます。見つからなかった場合、\fBpkgmogrify\fR はエラーで終了します。
-.sp
-.LP
-変換指令の形式は次のとおりです。
-.sp
-.in +2
-.nf
-<transform \fImatching-criteria\fR -> \fIoperation\fR>
-.fi
-.in -2
-
-.sp
-.LP
-これらの指令は、すべての入力がメモリー内に読み取られるまで累積されたあと、各指令が検出された順序でアクションに適用されます。
-.sp
-.LP
-一致条件の形式は次のとおりです。
-.sp
-.in +2
-.nf
-[\fIaction-name\fR ... ] [\fIattribute\fR=<\fIvalue-regexp\fR> ...]
-.fi
-.in -2
-
-.sp
-.LP
-指定された \fIaction-name\fR の少なくとも 1 つが一致する必要があります。指定されたすべての \fIattribute\fR が一致する必要があります。アクションの名前と属性が、\fBpkg\fR(5) マニュアルページの「アクション」に一覧表示されます。使用されている正規表現の構文は Python の構文です。Python 正規表現の構文については、コマンド \fBpydoc re\fR を使用するか、または \fBhttp://docs.python.org/dev/howto/regex.html\fR にあるより完全なドキュメントを参照してください。正規表現は先頭に固定され、末尾には固定されません。そのため、ファイルを拡張子で照合する正規表現には先頭に \fB\&.*\fR を含める必要があり、さらに末尾には \fB$\fR を含めるようにしてください。
-.sp
-.LP
-複数の条件をスペースで区切って指定できます。
-.sp
-.LP
-次の操作が使用できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBadd\fR\fR
-.ad
-.RS 11n
-.rt  
-属性に値を追加します。この操作は 2 つの引数を取ります。最初の引数は属性の名前であり、2 番目の引数は値です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.RS 11n
-.rt  
-属性の値がまだ存在しない場合は、その値を設定します。この操作は \fBadd\fR 操作と同じく 2 つの引数を取ります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdelete\fR\fR
-.ad
-.RS 11n
-.rt  
-属性値を削除します。この操作は 2 つの引数を取ります。最初の引数は属性の名前です。2 番目の引数は、削除される属性値を照合するための正規表現です。アクションを照合するために使用される正規表現とは異なり、この表現は固定されません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdrop\fR\fR
-.ad
-.RS 11n
-.rt  
-このアクションを破棄します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBedit\fR\fR
-.ad
-.RS 11n
-.rt  
-アクションの属性を変更します。この操作には 3 つの引数を指定します。最初の引数は属性の名前であり、2 番目の引数は属性値を照合するための正規表現です。3 番目の引数は、正規表現で一致した値の部分に置き換えられる置換文字列です。アクションを照合するために使用される正規表現とは異なり、この表現は固定されません。正規表現でグループが定義されている場合は、置換文字列内で通常の正規表現の後方参照 (形式は \fB\e1\fR、\fB\e2\fR など) を使用できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBemit\fR\fR
-.ad
-.RS 11n
-.rt  
-マニフェスト出力ストリームに行を出力します。これは、有効なアクション文字列、空 (空行が生成されます)、またはコメント (\fB#\fR のあとに任意のテキストが続きます) である必要があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexit\fR\fR
-.ad
-.RS 11n
-.rt  
-マニフェスト処理を終了します。マニフェストは出力されず、\fBprint\fR 操作は適用されません。引数が 1 つ指定されている場合、その引数は整数である必要があり、終了コードとして使用されます。デフォルト値は 0 です。引数が 2 つ指定されている場合、最初の引数は終了コードであり、2 番目の引数は\fB標準エラー出力\fRに出力されるメッセージです。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBprint\fR\fR
-.ad
-.RS 11n
-.rt  
-\fB-P\fR で指定された出力ファイルにメッセージを出力します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBset\fR\fR
-.ad
-.RS 11n
-.rt  
-属性の値を設定します。この操作は \fBadd\fR 操作と同じく 2 つの引数を取ります。
-.RE
+<?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;
+]>
 
-.sp
-.LP
-\fBdelete\fR と \fBdrop\fR を除くすべての操作は、出力ストリームにその内容が出力される (オプションである可能性がある) 引数を取ります。これらの文字列には、3 種類の特殊なトークンを含めることができます。これらのトークンにより、各アクションの固定された変換に基づかない情報を出力に含めることが可能になります。
-.sp
-.LP
-最初の種類の置換を使用すると、パーセント記号に続けて属性の名前を丸括弧に入れて指定することによって、操作で現在のアクションの属性の値を参照できます。たとえば、\fB%(alias)\fR は、アクションの \fBalias\fR 属性の値を参照します。
-.sp
-.LP
-いくつかの合成属性が存在します。次の 2 つは \fBpkgmogrify\fR に固有です
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBpkg.manifest.filename\fR は、アクションが見つかったファイルの名前を参照します。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBpkg.manifest.lineno\fR は、アクションが見つかった行を参照します。
-.RE
-.sp
-.LP
-次の 3 つの合成属性は、\fBpkg\fR で使用されるものに似ています:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.hash\fR は、アクションにペイロードが含まれている場合、そのアクションのハッシュ値を参照します。ペイロードを含むアクションの場合、\fBset\fR 操作は、\fBaction.hash\fR 属性を操作することによってアクションのハッシュを変更できます。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.key\fR は、キー属性の値を参照します。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.name\fR は、アクションの名前を参照します。
-.RE
-.sp
-.LP
-値を要求された属性が存在しない場合、\fBpkgmogrify\fR はエラーで終了します。エラーで終了することを回避するには、属性名のあとに \fB;notfound=\fR と、属性値の代わりに置換する値を指定します。たとえば、\fB%(alias;notfound='no alias')\fR は、属性 \fBalias\fR の値が存在する場合はその値を出力し、それ以外の場合は \fBno alias\fR を出力します。
-.sp
-.LP
-値を要求された属性が複数値の場合は、各値がスペースで区切られて出力されます。\fBnotfound\fR トークンと同様に、トークン \fBprefix\fR、\fBsuffix\fR、および \fBsep\fR を使用してこの動作を変更できます。\fBprefix\fR で指定された文字列は各値の先頭に追加され、\fBsuffix\fR で指定された文字列は各値の末尾に追加され、\fBsep\fR はある値の接尾辞とその次の値の接頭辞の間に配置されます。
-.sp
-.LP
-アクション属性と同様に、\fBpkgmogrify\fR 指令では \fB%{pkg.fmri}\fR のように、丸括弧の代わりに中括弧を使用してパッケージ属性を参照できます。変換指令が適用される時点で、この属性は \fBset\fR アクションで定義されている必要があります。そうしないと、この属性は上で説明した \fBnotfound\fR として扱われます。処理が、パッケージを記述しているマニフェストファイルの最後に達すると、属性は次のパッケージのためにクリアーされます。
-.sp
-.LP
-これは、パッケージ属性をアクション属性であるかのように参照するためだけでなく、これらの属性を照合したり、一時的に変更したりするためにも有効です。したがって、これらの状況では、合成アクション名 \fBpkg\fR を (\fBpkgmogrify\fR のコンテキストでのみ) 使用できます。
-.sp
-.LP
-\fBpkgmogrify\fR がコマンド行で指定されたマニフェストの読み取りを完了し、そのマニフェストで \fBpkg.fmri\fR パッケージ属性が定義されている場合、\fBpkgmogrify\fR はこの合成アクション \fBpkg\fR を作成します。属性はパッケージの属性になります。その後、\fB<transform>\fR 指令は、ほかのアクションに照合できるのと同様に、このアクションに照合できます。
-.sp
-.LP
-\fBpkg\fR アクションに対する操作は、メモリー内でのみ実行されるために、出力されたマニフェストに直接影響を与えないという点で特殊です。たとえば、\fBadd\fR、\fBdefault\fR、または \fBset\fR 操作を使用して \fBpkg\fR アクションに属性を設定しようとしても、照合するほかの \fB<transform>\fR 指令では使用可能であるにもかかわらず、\fBset\fR アクションがマニフェストに追加されません。\fBpkg\fR アクションに対して \fBemit\fR を実行しようとすると、エラーが発生します。パッケージ属性を追加するには、代わりに \fBset\fR アクションに対して \fBemit\fR を実行します。
-.sp
-.LP
-3 番目の種類の置換は後方参照です。この置換は \fBedit\fR 操作で使用可能なものとは異なり、\fB->\fR の左側にある変換一致に列挙されているグループへの参照です。これらは、一致条件にある順序で、\fB%<1>\fR、\fB%<2>\fR などによって指定されます。
-.sp
-.LP
-処理の順序は次のとおりです。
-.RS +4
-.TP
-1.
-入力ファイルから行が読み取られます。
-.RE
-.RS +4
-.TP
-2.
-マクロが適用されます。
-.RE
-.RS +4
-.TP
-3.
-\fB<include ...>\fR および \fB<transform>\fR 指令が処理されることにより、追加のファイルが検出され、読み取られます。
-.RE
-.RS +4
-.TP
-4.
-すべての入力が累積されたあと、入力内の各行がアクションに変換され、すべての変換が適用されます。
-.RE
-.RS +4
-.TP
-5.
-処理が正常に完了すると、出力が書き込まれます。
-.RE
-.SH 使用例
-.LP
-\fB例 1 \fRSMF マニフェストにタグを追加する
-.sp
-.LP
-サービス管理機能 (SMF) マニフェストにタグを追加して、パッケージがライブシステムにインストールされたときにこれらのマニフェストがインポートされるようにします。
-
-.sp
-.in +2
-.nf
-<transform file path=(var|lib)/svc/manifest/.*\e.xml -> \e
-    add restart_fmri svc:/system/manifest-import:default>
-.fi
-.in -2
-
-.LP
-\fB例 2 \fRファイルを移動する
-.sp
-.LP
-ファイルを \fBusr/sfw/bin\fR から \fBusr/bin\fR に移動します。
-
-.sp
-.in +2
-.nf
-<transform file -> edit path usr/sfw/bin usr/bin>
-.fi
-.in -2
-
-.LP
-\fB例 3 \fRリブートの必要性を指定する
-.sp
-.LP
-\fBreboot-needed\fR タグを、\fB/kernel\fR の下にある、\fB\&.conf\fR ファイル以外のファイルに追加します。この例では、入力ファイルに存在する順序で各アクションに変換が適用されることを利用しています。
-
-.sp
-.in +2
-.nf
-<transform file path=kernel/.* -> set reboot-needed true>
-<transform file path=kernel/.*\e.conf -> delete reboot-needed .*>
-.fi
-.in -2
-
-.sp
-.LP
-これはまた、正規表現を使用した 1 つの変換規則でも実行できます。
-
-.LP
-\fB例 4 \fRFMRI 属性を依存アクションに変換する
-.sp
-.LP
-パッケージ属性 \fBpkg.fmri\fR を incorporation の一部になるように \fBdepend\fR アクションに変換します。
-
-.sp
-.in +2
-.nf
-<transform set name=pkg.fmri -> \e
+<refentry lang="ja" id="pkgmogrify-1">
+<refmeta><refentrytitle>pkgmogrify</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 7 月 12 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgmogrify</refname><refpurpose>Image Packaging System マニフェスト変換ツール</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgmogrify [-vi] [-I <replaceable>includedir</replaceable>]...
+    [-D <replaceable>macro</replaceable>=<replaceable>value</replaceable>]... [-O <replaceable>
+outputfile</replaceable>]
+    [-P <replaceable>printfile</replaceable>] [<replaceable>inputfile</replaceable> ...]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="GKVND" role="description"><title></title>
+<para><command>pkgmogrify</command> は、パッケージマニフェストのプログラムによる編集を可能にして、ソフトウェアの構築やパッケージの公開を自動化するときに必要な標準的な変換を簡略化します。</para>
+<itemizedlist>
+<para><command>pkgmogrify</command> は、次の機能を提供します。</para>
+<listitem><para>マクロ置換。単一のマニフェストを各種アーキテクチャーやプラットフォーム間で簡単に共有できます。</para></listitem>
+<listitem><para>ほかのマニフェスト、または標準のコンポーネントや変換などのマニフェストフラグメントの取り込み。</para></listitem>
+<listitem><para>パッケージアクションの変換。アクション属性の変更、削除、または追加が含まれます。</para></listitem>
+</itemizedlist>
+</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>D</option> <replaceable>macro</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para><replaceable>macro</replaceable> を値 <replaceable>value</replaceable> とともにマクロとして定義します。このオプションは複数回指定できます。マクロは、入力ファイル内で <literal>$(macro)</literal> として指定されます。置換は、それ以上の変換が見つからなくなるまで繰り返されます。一般的な語法には次のものがあります。</para>
+<itemizedlist>
+<listitem><para>行の先頭にあるアーキテクチャー固有のタグを使用した、ほかのアーキテクチャー上のマニフェスト内の行の除外。</para>
+<programlisting>$(sparc_ONLY)file ...</programlisting>
+<para>SPARC アーキテクチャーを処理する場合、このマクロは空の文字列に設定されます。ほかのアーキテクチャーを処理する場合、このマクロはコマンド行で <literal>#</literal> に設定されるため、このアクションが現在のアーキテクチャー上のマニフェストから除外されます。</para>
+</listitem>
+<listitem><para>パス名のプラットフォーム固有の部分の指定。実行可能ファイルおよびライブラリのための 64 ビットアーキテクチャーディレクトリの名前などがあります。</para>
+<programlisting>file path=usr/bin/$(ARCH64)/cputrack ...</programlisting>
+<para>これらのマクロは、コマンド行で目的の値に設定するようにしてください。定義済みのマクロ値は存在しません。</para>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>I</option> <replaceable>includedir</replaceable></term>
+<listitem><para>指定されたディレクトリを、コマンド行で指定されたファイルと、埋め込みのインクルード指令の両方の検索パスに追加します。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>O</option> <replaceable>outputfile</replaceable></term>
+<listitem><para>マニフェスト出力を指定されたファイルに書き込みます。このファイルは、エラーが発生した場合や、変換指令によって強制的な中止操作が実行された場合は書き込まれません。デフォルトでは、マニフェスト出力は<filename>標準出力</filename>に書き込まれます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option> <replaceable>printfile</replaceable></term>
+<listitem><para>変換指令の出力操作から得られた出力を指定されたファイルに書き込みます。このファイルは、エラーが発生した場合や、変換指令によって強制的な中止操作が実行された場合は書き込まれません。デフォルトでは、この出力は<filename>標準出力</filename>に書き込まれます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option></term>
+<listitem><para>ファイル内のインクルード指令を無視します。コマンド行 (または<filename>標準入力</filename>) で指定されたファイルのみが処理されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>出力マニフェストに変換の効果を示すコメントを書き込みます。この情報がデバッグに役立つことがあります。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>埋め込みの指令</title>
+<para>マニフェストファイルでは、インクルード指令と変換指令という 2 つのタイプの指令がサポートされています。</para>
+<para>インクルード指令の形式は次のとおりです。</para>
+<programlisting>&lt;include <replaceable>file</replaceable>></programlisting>
+<para>この指令により、<command>pkgmogrify</command> は <literal>file</literal> という名前のファイルを、最初に現在のディレクトリで、次に <option>I</option> オプションで指定されたディレクトリで検索します。見つかった場合は、ファイルの内容がマニフェストの、この指令が置かれている場所に挿入されます。見つからなかった場合、<command>pkgmogrify</command> はエラーで終了します。</para>
+<para>変換指令の形式は次のとおりです。</para>
+<programlisting>&lt;transform <replaceable>matching-criteria</replaceable> -> <replaceable>
+operation</replaceable>></programlisting>
+<para>これらの指令は、すべての入力がメモリー内に読み取られるまで累積されたあと、各指令が検出された順序でアクションに適用されます。
+</para>
+<para>一致条件の形式は次のとおりです。</para>
+<programlisting>[<replaceable>action-name</replaceable> ... ] [<replaceable>attribute
+</replaceable>=&lt;<replaceable>value-regexp</replaceable>> ...]</programlisting>
+<para>指定された <replaceable>action-name</replaceable> の少なくとも 1 つが一致する必要があります。指定されたすべての <replaceable>attribute</replaceable> が一致する必要があります。アクションの名前と属性が、<literal>pkg</literal>(5) マニュアルページの「アクション」に一覧表示されます。使用されている正規表現の構文は Python の構文です。Python 正規表現の構文については、コマンド <command>pydoc re</command> を使用するか、または <literal>http://docs.python.org/dev/howto/regex.html</literal> にあるより完全なドキュメントを参照してください。正規表現は先頭に固定され、末尾には固定されません。そのため、ファイルを拡張子で照合する正規表現には先頭に <literal>.*</literal> を含める必要があり、さらに末尾には <literal>$</literal> を含めるようにしてください。</para>
+<para>複数の条件をスペースで区切って指定できます。</para>
+<para>次の操作が使用できます。</para>
+<variablelist>
+<varlistentry><term><literal>add</literal></term>
+<listitem><para>属性に値を追加します。この操作は 2 つの引数を取ります。最初の引数は属性の名前であり、2 番目の引数は値です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>属性の値がまだ存在しない場合は、その値を設定します。この操作は <command>add</command> 操作と同じく 2 つの引数を取ります。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>delete</literal></term>
+<listitem><para>属性値を削除します。この操作は 2 つの引数を取ります。最初の引数は属性の名前です。2 番目の引数は、削除される属性値を照合するための正規表現です。アクションを照合するために使用される正規表現とは異なり、この表現は固定されません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>drop</literal></term>
+<listitem><para>このアクションを破棄します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>edit</literal></term>
+<listitem><para>アクションの属性を変更します。この操作には 3 つの引数を指定します。最初の引数は属性の名前であり、2 番目の引数は属性値を照合するための正規表現です。3 番目の引数は、正規表現で一致した値の部分に置き換えられる置換文字列です。アクションを照合するために使用される正規表現とは異なり、この表現は固定されません。正規表現でグループが定義されている場合は、置換文字列内で通常の正規表現の後方参照 (形式は <literal>\1</literal>、<literal>\2</literal> など) を使用できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>emit</literal></term>
+<listitem><para>マニフェスト出力ストリームに行を出力します。これは、有効なアクション文字列、空 (空行が生成されます)、またはコメント (<literal>#</literal> のあとに任意のテキストが続きます) である必要があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exit</literal></term>
+<listitem><para>マニフェスト処理を終了します。マニフェストは出力されず、<literal>print</literal> 操作は適用されません。引数が 1 つ指定されている場合、その引数は整数である必要があり、終了コードとして使用されます。デフォルト値は 0 です。引数が 2 つ指定されている場合、最初の引数は終了コードであり、2 番目の引数は<filename>標準エラー出力</filename>に出力されるメッセージです。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>print</literal></term>
+<listitem><para><option>P</option> で指定された出力ファイルにメッセージを出力します。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>set</literal></term>
+<listitem><para>属性の値を設定します。この操作は <command>add</command> 操作と同じく 2 つの引数を取ります。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>delete</literal> と <literal>drop</literal> を除くすべての操作は、出力ストリームにその内容が出力される (オプションである可能性がある) 引数を取ります。これらの文字列には、3 種類の特殊なトークンを含めることができます。これらのトークンにより、各アクションの固定された変換に基づかない情報を出力に含めることが可能になります。</para>
+<para>最初の種類の置換を使用すると、パーセント記号に続けて属性の名前を丸括弧に入れて指定することによって、操作で現在のアクションの属性の値を参照できます。たとえば、<literal>%(alias)</literal> は、アクションの <literal>alias</literal> 属性の値を参照します。</para>
+<itemizedlist>
+<para>いくつかの合成属性が存在します。次の 2 つは <command>pkgmogrify</command> に固有です
+</para>
+<listitem><para><literal>pkg.manifest.filename</literal> は、アクションが見つかったファイルの名前を参照します。</para></listitem>
+<listitem><para><literal>pkg.manifest.lineno</literal> は、アクションが見つかった行を参照します。</para></listitem>
+</itemizedlist>
+<itemizedlist>
+<para>次の 3 つの合成属性は、<command>pkg</command> で使用されるものに似ています:
+</para>
+<listitem><para><literal>action.hash</literal> は、アクションにペイロードが含まれている場合、そのアクションのハッシュ値を参照します。ペイロードを含むアクションの場合、<literal>set</literal> 操作は、<literal>action.hash</literal> 属性を操作することによってアクションのハッシュを変更できます。</para></listitem>
+<listitem><para><literal>action.key</literal> は、キー属性の値を参照します。</para></listitem>
+<listitem><para><literal>action.name</literal> は、アクションの名前を参照します。</para>
+</listitem>
+</itemizedlist>
+<para>値を要求された属性が存在しない場合、<command>pkgmogrify</command> はエラーで終了します。エラーで終了することを回避するには、属性名のあとに <literal>;notfound=</literal> と、属性値の代わりに置換する値を指定します。たとえば、<literal>%(alias;notfound='no alias')</literal> は、属性 <literal>alias</literal> の値が存在する場合はその値を出力し、それ以外の場合は <literal>no alias</literal> を出力します。</para>
+<para>値を要求された属性が複数値の場合は、各値がスペースで区切られて出力されます。<literal>notfound</literal> トークンと同様に、トークン <literal>prefix</literal>、<literal>suffix</literal>、および <literal>sep</literal> を使用してこの動作を変更できます。<literal>prefix</literal> で指定された文字列は各値の先頭に追加され、<literal>suffix</literal> で指定された文字列は各値の末尾に追加され、<literal>sep</literal> はある値の接尾辞とその次の値の接頭辞の間に配置されます。</para>
+<para>アクション属性と同様に、<command>pkgmogrify</command> 指令では <literal>%{pkg.fmri}</literal> のように、丸括弧の代わりに中括弧を使用してパッケージ属性を参照できます。変換指令が適用される時点で、この属性は <literal>set</literal> アクションで定義されている必要があります。そうしないと、この属性は上で説明した <literal>notfound</literal> として扱われます。処理が、パッケージを記述しているマニフェストファイルの最後に達すると、属性は次のパッケージのためにクリアーされます。</para>
+<para>これは、パッケージ属性をアクション属性であるかのように参照するためだけでなく、これらの属性を照合したり、一時的に変更したりするためにも有効です。したがって、これらの状況では、合成アクション名 <literal>pkg</literal> を (<command>pkgmogrify</command> のコンテキストでのみ) 使用できます。
+</para>
+<para><command>pkgmogrify</command> がコマンド行で指定されたマニフェストの読み取りを完了し、そのマニフェストで <literal>pkg.fmri</literal> パッケージ属性が定義されている場合、<command>pkgmogrify</command> はこの合成アクション <literal>pkg</literal> を作成します。属性はパッケージの属性になります。その後、<literal>&lt;transform></literal> 指令は、ほかのアクションに照合できるのと同様に、このアクションに照合できます。</para>
+<para><literal>pkg</literal> アクションに対する操作は、メモリー内でのみ実行されるために、出力されたマニフェストに直接影響を与えないという点で特殊です。たとえば、<literal>add</literal>、<literal>default</literal>、または <literal>set</literal> 操作を使用して <literal>pkg</literal> アクションに属性を設定しようとしても、照合するほかの <literal>&lt;transform&gt;</literal> 指令では使用可能であるにもかかわらず、<literal>set</literal> アクションがマニフェストに追加されません。<literal>pkg</literal> アクションに対して <literal>emit</literal> を実行しようとすると、エラーが発生します。パッケージ属性を追加するには、代わりに <literal>set</literal> アクションに対して <literal>emit</literal> を実行します。</para>
+<para>3 番目の種類の置換は後方参照です。この置換は <literal>edit</literal> 操作で使用可能なものとは異なり、<literal>-&gt;</literal> の左側にある変換一致に列挙されているグループへの参照です。これらは、一致条件にある順序で、<literal>%&lt;1&gt;</literal>、<literal>%&lt;2&gt;</literal> などによって指定されます。</para>
+<orderedlist>
+<para>処理の順序は次のとおりです。</para>
+<listitem><para>入力ファイルから行が読み取られます。</para></listitem>
+<listitem><para>マクロが適用されます。</para></listitem>
+<listitem><para><literal>&lt;include ...&gt;</literal> および <literal>&lt;transform&gt;</literal> 指令が処理されることにより、追加のファイルが検出され、読み取られます。</para></listitem>
+<listitem><para>すべての入力が累積されたあと、入力内の各行がアクションに変換され、すべての変換が適用されます。</para></listitem>
+<listitem><para>処理が正常に完了すると、出力が書き込まれます。</para></listitem>
+</orderedlist></refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>SMF マニフェストにタグを追加する</title>
+<para>サービス管理機能 (SMF) マニフェストにタグを追加して、パッケージがライブシステムにインストールされたときにこれらのマニフェストがインポートされるようにします。</para>
+<programlisting>&lt;transform file path=(var|lib)/svc/manifest/.*&bsol;.xml -> &bsol;
+    add restart_fmri svc:/system/manifest-import:default></programlisting>
+</example>
+<example><title>ファイルを移動する</title>
+<para>ファイルを <filename>usr/sfw/bin</filename> から <filename>usr/bin</filename> に移動します。
+</para>
+<programlisting>&lt;transform file -> edit path usr/sfw/bin usr/bin></programlisting>
+</example>
+<example><title>リブートの必要性を指定する</title>
+<para><literal>reboot-needed</literal> タグを、<filename>/kernel</filename> の下にある、<filename>.conf</filename> ファイル以外のファイルに追加します。この例では、入力ファイルに存在する順序で各アクションに変換が適用されることを利用しています。</para>
+<programlisting>&lt;transform file path=kernel/.* -> set reboot-needed true>
+&lt;transform file path=kernel/.*&bsol;.conf -> delete reboot-needed .*></programlisting>
+<para>これはまた、正規表現を使用した 1 つの変換規則でも実行できます。</para>
+</example>
+<example><title>FMRI 属性を依存アクションに変換する</title>
+<para>パッケージ属性 <literal>pkg.fmri</literal> を incorporation の一部になるように <literal>depend</literal> アクションに変換します。</para>
+<programlisting>&lt;transform set name=pkg.fmri -> &bsol;
     emit depend type=incorporate fmri=%(value)>
-<transform set name=pkg.fmri -> drop>
-.fi
-.in -2
-
-.LP
-\fB例 5 \fRバグ番号のリストを出力する
-.sp
-.LP
-引用符で囲まれた、接頭辞付きのバグ番号のコンマ区切りリストを出力します。
+&lt;transform set name=pkg.fmri -> drop></programlisting>
+</example>
+<example><title>バグ番号のリストを出力する</title>
+<para>引用符で囲まれた、接頭辞付きのバグ番号のコンマ区切りリストを出力します。</para>
+<programlisting>set name=bugs value=12345 value=54321 value=13579 value=97531
+&lt;transform set name=bugs -> &bsol;
+    print %(value;sep=",";prefix="bug='";suffix="'")></programlisting>
+</example>
+<example><title>欠落した属性を許可する</title>
+<para>属性がない場合でも、安全にメッセージを出力します。</para>
+<programlisting>&lt;transform driver -> print Found aliases: %(alias;notfound=&lt;none>)>
+</programlisting>
+</example>
+<example><title>デフォルト値を設定する</title>
+<para>所有者、グループ、およびアクセス権のデフォルト値を設定します。</para>
+<programlisting>&lt;transform file dir -> default owner root>
+&lt;transform file dir -> default group bin>
+&lt;transform file -> default mode 0444>
+&lt;transform dir -> default mode 0755></programlisting>
+</example>
+<example><title>廃止としてマークされていないパッケージに依存関係を追加する</title>
+<para>廃止としてマークされていないすべてのパッケージについて、そのパッケージを提供する統合のための incorporation への依存関係を追加します。この一連の変換は、マニフェストが読み取られたあとに実行される必要があります。そうしないと、依存関係が常に出力されます。<literal>pkg</literal> アクションの変更には永続的な効果がないため、<literal>pkg.obsolete=false</literal> に一致する属性をクリーンアップする必要はありません。</para>
+<programlisting>&lt;transform pkg -> default pkg.obsolete false>
+&lt;transform pkg pkg.obsolete=false -> emit depend &bsol;
+    fmri=consolidation/$(CONS)/$(CONS)-incorporation type=require></programlisting>
+</example>
+<example><title>エラーが検出された場合は終了してメッセージを出力する</title>
+<para>廃止された属性がマニフェスト内に検出された場合は、エラーメッセージを出力します。
+</para>
+<programlisting>&lt;transform file dir link hardlink opensolaris.zone=.* -> &bsol;
+    exit 1 The opensolaris.zone attribute is obsolete.></programlisting>
+</example>
+<example><title>適切なロケールファセットを設定する</title>
+<para>対象のパス名に適したロケールファセットを設定します。</para>
+<programlisting>&lt;transform dir file link hardlink path=.*/locale/([^/]+).* -> &bsol;
+    default facet.locale.%&lt;1> true></programlisting>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>すべてが動作しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>予期しない不具合が発生しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない処理エラー。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>/usr/share/pkg/transforms</filename></term>
+<listitem><para>このディレクトリには、ファセット、アクチュエータ、およびその他の属性を設定するために役立つ変換を含むファイルが入っています。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg </refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle> <manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-set name=bugs value=12345 value=54321 value=13579 value=97531
-<transform set name=bugs -> \e
-    print %(value;sep=",";prefix="bug='";suffix="'")>
-.fi
-.in -2
-
-.LP
-\fB例 6 \fR欠落した属性を許可する
-.sp
-.LP
-属性がない場合でも、安全にメッセージを出力します。
-
-.sp
-.in +2
-.nf
-<transform driver -> print Found aliases: %(alias;notfound=<none>)>
-.fi
-.in -2
-
-.LP
-\fB例 7 \fRデフォルト値を設定する
-.sp
-.LP
-所有者、グループ、およびアクセス権のデフォルト値を設定します。
-
-.sp
-.in +2
-.nf
-<transform file dir -> default owner root>
-<transform file dir -> default group bin>
-<transform file -> default mode 0444>
-<transform dir -> default mode 0755>
-.fi
-.in -2
-
-.LP
-\fB例 8 \fR廃止としてマークされていないパッケージに依存関係を追加する
-.sp
-.LP
-廃止としてマークされていないすべてのパッケージについて、そのパッケージを提供する統合のための incorporation への依存関係を追加します。この一連の変換は、マニフェストが読み取られたあとに実行される必要があります。そうしないと、依存関係が常に出力されます。\fBpkg\fR アクションの変更には永続的な効果がないため、\fBpkg.obsolete=false\fR に一致する属性をクリーンアップする必要はありません。
-
-.sp
-.in +2
-.nf
-<transform pkg -> default pkg.obsolete false>
-<transform pkg pkg.obsolete=false -> emit depend \e
-    fmri=consolidation/$(CONS)/$(CONS)-incorporation type=require>
-.fi
-.in -2
-
-.LP
-\fB例 9 \fRエラーが検出された場合は終了してメッセージを出力する
-.sp
-.LP
-廃止された属性がマニフェスト内に検出された場合は、エラーメッセージを出力します。
-
-.sp
-.in +2
-.nf
-<transform file dir link hardlink opensolaris.zone=.* -> \e
-    exit 1 The opensolaris.zone attribute is obsolete.>
-.fi
-.in -2
-
-.LP
-\fB例 10 \fR適切なロケールファセットを設定する
-.sp
-.LP
-対象のパス名に適したロケールファセットを設定します。
-
-.sp
-.in +2
-.nf
-<transform dir file link hardlink path=.*/locale/([^/]+).* -> \e
-    default facet.locale.%<1> true>
-.fi
-.in -2
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-すべてが動作しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない不具合が発生しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない処理エラー。
-.RE
-
-.SH ファイル
-.sp
-.ne 2
-.mk
-.na
-\fB\fB/usr/share/pkg/transforms\fR\fR
-.ad
-.sp .6
-.RS 4n
-このディレクトリには、ファセット、アクチュエータ、およびその他の属性を設定するために役立つ変換を含むファイルが入っています。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/ja_JP/pkgrecv.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgrecv.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,378 +1,164 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgrecv 1 "2013 年 11 月 21 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgrecv \- Image Packaging System 内容取得ユーティリティー
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgrecv [-aknrv] [-s (\fIsrc_path\fR|\fIsrc_uri\fR)]
-    [-d (\fIdest_path\fR|\fIdest_uri\fR)] [-c \fIcache_dir\fR]
-    [-m \fImatch\fR] [--raw]
-    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR]
-    [--dkey \fIdest_key\fR --dcert \fIdest_cert\fR]
-    (\fIfmri\fR|\fIpattern\fR) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrecv [-s (\fIsrc_path\fR|\fIsrc_uri\fR)] --newest
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrecv [-nv] [-s (\fIsrc_path\fR|\fIsrc_uri\fR)]
-    [-d (\fIdest_path\fR|\fIdest_uri\fR)] [-p \fIpublisher\fR]...
-    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR] --clone
-.fi
+<?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;
+]>
 
-.SH 機能説明
-.sp
-.LP
-\fBpkgrecv\fR は、\fBpkg\fR(5) リポジトリまたは \fB-s\fR オプションで指定されたパッケージアーカイブから一致する各 \fIfmri\fR または \fIpattern\fR のすべてのバージョンを取得し、取得したパッケージを、\fB-d\fR オプションで指定されたパッケージリポジトリまたはパッケージアーカイブにオプションで再発行します。デフォルトでは、パッケージは \fBpkg\fR、\fBpkg.depotd\fR、およびパッケージ公開ツールでの使用に適したパッケージリポジトリ形式で取得されます。
-.sp
-.LP
-変更のないパッケージは再発行されません。したがって、既存のリポジトリを更新する時間は、新規および変更されたパッケージの数によって異なります。
-.sp
-.LP
-\fB-m\fR オプションを使用して、一致する各パッケージのすべてのバージョンを取得するか、一致する各パッケージの最新バージョンのみを取得するかを指定します。
-.sp
-.LP
-取得対象に \fB\&'*'\fR を指定しない場合、指定されたパッケージのすべての依存関係を取得するようにするために、\fB-r\fR オプションを指定したい場合があります。
-.LP
-注 - 
-.sp
-.RS 2
-同じ公開先リポジトリまたはアーカイブにパッケージを再発行するために、\fBpkgrecv\fR の複数インスタンスを同時に使用しないでください。この場合、新しく受け取ったパッケージに、重複するアクションが含まれる可能性があります。
-.RE
-.sp
-.LP
-\fIdest_uri\fR に対してパッケージを取得する \fBpkgrecv\fR 操作後に、\fIdest_uri\fR リポジトリが \fBpkg search\fR 操作をサポートする必要がある場合は、そのリポジトリ上で \fBpkgrepo refresh\fR を実行して、検索インデックスを更新してください。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-取得されたパッケージデータを、\fB-d\fR オプションで指定された場所にある \fBpkg\fR(5) アーカイブ内に格納します。\fB-d\fR で指定されたファイルが存在していてはいけません。\fB-a\fR オプションは、ファイルシステムベースの出力先の場合にのみ使用できます。必須ではありませんが、\fB\&.p5p\fR のファイル拡張子 (たとえば、\fBarchive.p5p\fR) を使用することを強くお勧めします。\fB-a\fR オプションを \fB--raw\fR オプションと一緒に組み合わせることはできません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-ダウンロードされた内容をキャッシュするために使用されるディレクトリのパスを指定します。このディレクトリが指定されていない場合は、クライアントによってキャッシュディレクトリが自動的に選択されます。ダウンロードが中断されたときに、キャッシュディレクトリが自動的に選択されていた場合は、このオプションを使用してダウンロードを再開します。一時的なデータストレージに使用される場所を設定する方法についての詳細は、下の「環境変数」のセクションを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR (\fIdest_path\fR|\fIdest_uri\fR)\fR
-.ad
-.sp .6
-.RS 4n
-取得したパッケージを再発行する必要があるファイルシステムのパスまたは URI を指定します。\fB-a\fR を指定する場合、この宛先は、まだ存在しないパッケージアーカイブである必要があります。\fB-a\fR を指定しない場合、この宛先は、すでに存在するパッケージリポジトリである必要があります。\fBpkgrepo\fR コマンドを使用して、新規パッケージリポジトリを作成します。\fB-d\fR が指定されていない場合は、\fBPKG_DEST\fR の値が使用されます。以下の「環境変数」を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR\fR
-.ad
-.sp .6
-.RS 4n
-取得されたパッケージの内容を圧縮されたままにします。このオプションは、再公開時には無視されます。圧縮されたパッケージの内容を \fBpkgsend\fR で使用しないようにしてください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR \fImatch\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIpattern\fR が指定された場合、または \fIfmri\fR が完全に指定されていない場合に、取得するパッケージのバージョンを制御します。これを説明するため、\fB-s\fR オプションで指定されたソース内に例として次の 4 つのパッケージが存在するとします。これらの FMRI で、\fB@\fR と \fB:\fR の間にある文字は番号付きのパッケージバージョンを表し、\fB:\fR から末尾までの文字はバージョン文字列のタイムスタンプ部分を表します。
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+<refentry lang="ja" id="pkgrecv-1">
+<refmeta><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 11 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgrecv</refname><refpurpose>Image Packaging System 内容取得ユーティリティー</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgrecv [-aknrv] [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)]
+    [-d (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)] [-c <replaceable>cache_dir</replaceable>]
+    [-m <replaceable>match</replaceable>] [--raw]
+    [--key <replaceable>src_key</replaceable> --cert <replaceable>src_cert</replaceable>]
+    [--dkey <replaceable>dest_key</replaceable> --dcert <replaceable>dest_cert</replaceable>]
+    (<replaceable>fmri</replaceable>|<replaceable>pattern</replaceable>) ...</synopsis>
+<synopsis>/usr/bin/pkgrecv [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)] --newest</synopsis>
+<synopsis>/usr/bin/pkgrecv [-nv] [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)]
+    [-d (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)] [-p <replaceable>publisher</replaceable>]...
+    [--key <replaceable>src_key</replaceable> --cert <replaceable>src_cert</replaceable>] --clone
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgrecv-1-desc" role="description"><title></title>
+<para><command>pkgrecv</command> は、<literal>pkg</literal>(5) リポジトリまたは <option>s</option> オプションで指定されたパッケージアーカイブから一致する各 <replaceable>fmri</replaceable> または <replaceable>pattern</replaceable> のすべてのバージョンを取得し、取得したパッケージを、<option>d</option> オプションで指定されたパッケージリポジトリまたはパッケージアーカイブにオプションで再発行します。デフォルトでは、パッケージは <command>pkg</command>、<command>pkg.depotd</command>、およびパッケージ公開ツールでの使用に適したパッケージリポジトリ形式で取得されます。</para>
+<para>変更のないパッケージは再発行されません。したがって、既存のリポジトリを更新する時間は、新規および変更されたパッケージの数によって異なります。</para>
+<para><option>m</option> オプションを使用して、一致する各パッケージのすべてのバージョンを取得するか、一致する各パッケージの最新バージョンのみを取得するかを指定します。</para>
+<para>取得対象に <literal>'*'</literal> を指定しない場合、指定されたパッケージのすべての依存関係を取得するようにするために、<option>r</option> オプションを指定したい場合があります。</para>
+<note><para>同じ公開先リポジトリまたはアーカイブにパッケージを再発行するために、<command>pkgrecv</command> の複数インスタンスを同時に使用しないでください。この場合、新しく受け取ったパッケージに、重複するアクションが含まれる可能性があります。</para></note>
+<para><replaceable>dest_uri</replaceable> に対してパッケージを取得する <command>pkgrecv</command> 操作後に、<replaceable>dest_uri</replaceable> リポジトリが <command>pkg search</command> 操作をサポートする必要がある場合は、そのリポジトリ上で <command>pkgrepo refresh</command> を実行して、検索インデックスを更新してください。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>サポートしているオプションは、次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>取得されたパッケージデータを、<option>d</option> オプションで指定された場所にある <literal>pkg</literal>(5) アーカイブ内に格納します。<option>d</option> で指定されたファイルが存在していてはいけません。<option>a</option> オプションは、ファイルシステムベースの出力先の場合にのみ使用できます。必須ではありませんが、<literal>.p5p</literal> のファイル拡張子 (たとえば、<literal>archive.p5p</literal>) を使用することを強くお勧めします。<option>a</option> オプションを <option>-raw</option> オプションと一緒に組み合わせることはできません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>ダウンロードされた内容をキャッシュするために使用されるディレクトリのパスを指定します。このディレクトリが指定されていない場合は、クライアントによってキャッシュディレクトリが自動的に選択されます。ダウンロードが中断されたときに、キャッシュディレクトリが自動的に選択されていた場合は、このオプションを使用してダウンロードを再開します。一時的なデータストレージに使用される場所を設定する方法についての詳細は、下の「環境変数」のセクションを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)</term>
+<listitem><para>取得したパッケージを再発行する必要があるファイルシステムのパスまたは URI を指定します。<option>a</option> を指定する場合、この宛先は、まだ存在しないパッケージアーカイブである必要があります。<option>a</option> を指定しない場合、この宛先は、すでに存在するパッケージリポジトリである必要があります。<command>pkgrepo</command> コマンドを使用して、新規パッケージリポジトリを作成します。<option>d</option> が指定されていない場合は、<envar>PKG_DEST</envar> の値が使用されます。以下の「環境変数」を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option></term>
+<listitem><para>取得されたパッケージの内容を圧縮されたままにします。このオプションは、再公開時には無視されます。圧縮されたパッケージの内容を <command>pkgsend</command> で使用しないようにしてください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option> <replaceable>match</replaceable></term>
+<listitem><para><replaceable>pattern</replaceable> が指定された場合、または <replaceable>fmri</replaceable> が完全に指定されていない場合に、取得するパッケージのバージョンを制御します。これを説明するため、<option>s</option> オプションで指定されたソース内に例として次の 4 つのパッケージが存在するとします。これらの FMRI で、<literal>@</literal> と <literal>:</literal> の間にある文字は番号付きのパッケージバージョンを表し、<literal>:</literal> から末尾までの文字はバージョン文字列のタイムスタンプ部分を表します。</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120903T170234Z
 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120819T155007Z
-.fi
-.in -2
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBall-timestamps\fR\fR
-.ad
-.sp .6
-.RS 4n
-一致する各 \fIfmri\fR または \fIpattern\fR のすべてのバージョンを取得します (\fBall-versions\fR を暗黙的に意味します)。これは、\fB-m\fR オプションが指定されなかった場合のデフォルト動作です。前述の例では、4 つのパッケージがすべて取得されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBall-versions\fR\fR
-.ad
-.sp .6
-.RS 4n
-一致する各 \fIfmri\fR または \fIpattern\fR の各バージョンの最新のタイムスタンプを取得します。前述の例では、次の 2 つのパッケージが取得されます。
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z
-.fi
-.in -2
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlatest\fR\fR
-.ad
-.sp .6
-.RS 4n
-一致する各 \fIfmri\fR または \fIpattern\fR の最新バージョンのみを取得します。前述の例では、次のパッケージのみが取得されます。
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
-.fi
-.in -2
-
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-変更を行うことなく、試験実行を行います。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパブリッシャーのみをクローニングします。このオプションは複数回指定できます。\fB-p\fR オプションは、\fB--clone\fR オプションと組み合わせた場合にのみ有効です。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-一致する \fIfmri\fR または \fIpattern\fR ごとのすべての依存関係を再帰的に取得します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR (\fIsrc_path\fR|\fIsrc_uri\fR)\fR
-.ad
-.sp .6
-.RS 4n
-パッケージデータ受信先の \fBpkg\fR(5) リポジトリまたはパッケージアーカイブのファイルシステムのパスまたは URI を指定します。\fB-s\fR が指定されていない場合は、\fBPKG_SRC\fR の値が使用されます。以下の「環境変数」を参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-詳細出力を表示します。これには、取得したパッケージ数とそれらの完全な FMRI、取得したファイル数、および推定転送サイズが含まれます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIsrc_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-ソース HTTPS リポジトリからパッケージを取得するために使用するクライアント SSL キーファイルを指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cert\fR \fIsrc_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-ソース HTTPS リポジトリからパッケージを取得するために使用するクライアント SSL 証明書ファイルを指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--dkey\fR \fIdest_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-公開先の HTTPS リポジトリにパッケージを公開するために使用するクライアント SSL キーファイルを指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--dcert\fR \fIdest_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-公開先の HTTPS リポジトリにパッケージを公開するために使用するクライアント SSL 証明書ファイルを指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--clone\fR\fR
-.ad
-.sp .6
-.RS 4n
-ソースリポジトリの正確なコピーを作成します。デフォルトでは、ソースリポジトリ内のパブリッシャーが公開先にも存在する場合にのみ、クローン操作が成功します。クローン操作を指定されたパブリッシャーに制限するには、\fB-p\fR オプションを使用します。\fB-p\fR オプションを使用して指定されたパブリッシャーが公開先リポジトリにまだ存在しない場合は、公開先リポジトリに追加されます。公開先リポジトリに存在するがソースリポジトリに存在しないパッケージは、削除されます。クローン操作でエラーが発生した場合、公開先リポジトリは変更されたままになります。このため、公開先リポジトリを専用の ZFS データセットに配置し、クローン操作を実行する前にスナップショットを作成するようにしてください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--newest\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB-s\fR オプションで指定されたリポジトリから使用可能な最新バージョンのパッケージを一覧表示します。その他のすべてのオプションは無視されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--raw\fR\fR
-.ad
-.sp .6
-.RS 4n
-raw パッケージデータを取得し、\fB-d\fR で指定された場所に、幹およびバージョンごとの一連のディレクトリ構造内に格納します。\fB--raw\fR オプションは、ファイルシステムベースの出力先の場合にのみ使用できます。このパッケージデータを使用すると、一般にはファイルの内容を修正するか、または追加のパッケージメタデータを提供することによって、パッケージを便利に変更して再公開することができます。\fB--raw\fR オプションを \fB-a\fR と組み合わせることはできません。
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fR最新のパッケージを一覧表示する
-.sp
-.LP
-\fBtest\fR という名前のシステム上のリポジトリから使用可能な最新のパッケージを一覧表示します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test --newest\fR
+pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120819T155007Z</programlisting>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>all-timestamps</literal></term>
+<listitem><para>一致する各 <replaceable>fmri</replaceable> または <replaceable>pattern</replaceable> のすべてのバージョンを取得します (<literal>all-versions</literal> を暗黙的に意味します)。これは、<option>m</option> オプションが指定されなかった場合のデフォルト動作です。前述の例では、4 つのパッケージがすべて取得されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>all-versions</literal></term>
+<listitem><para>一致する各 <replaceable>fmri</replaceable> または <replaceable>pattern</replaceable> の各バージョンの最新のタイムスタンプを取得します。前述の例では、次の 2 つのパッケージが取得されます。</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z</programlisting>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>latest</literal></term>
+<listitem><para>一致する各 <replaceable>fmri</replaceable> または <replaceable>pattern</replaceable> の最新バージョンのみを取得します。前述の例では、次のパッケージのみが取得されます。</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>変更を行うことなく、試験実行を行います。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定されたパブリッシャーのみをクローニングします。このオプションは複数回指定できます。<option>p</option> オプションは、<option>-clone</option> オプションと組み合わせた場合にのみ有効です。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>一致する <replaceable>fmri</replaceable> または <replaceable>pattern</replaceable> ごとのすべての依存関係を再帰的に取得します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)</term>
+<listitem><para>パッケージデータ受信先の <literal>pkg</literal>(5) リポジトリまたはパッケージアーカイブのファイルシステムのパスまたは URI を指定します。<option>s</option> が指定されていない場合は、<envar>PKG_SRC</envar> の値が使用されます。以下の「環境変数」を参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>詳細出力を表示します。これには、取得したパッケージ数とそれらの完全な FMRI、取得したファイル数、および推定転送サイズが含まれます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>src_key</replaceable></term>
+<listitem><para>ソース HTTPS リポジトリからパッケージを取得するために使用するクライアント SSL キーファイルを指定します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-cert</option> <replaceable>src_cert</replaceable></term>
+<listitem><para>ソース HTTPS リポジトリからパッケージを取得するために使用するクライアント SSL 証明書ファイルを指定します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-dkey</option> <replaceable>dest_key</replaceable></term>
+<listitem><para>公開先の HTTPS リポジトリにパッケージを公開するために使用するクライアント SSL キーファイルを指定します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-dcert</option> <replaceable>dest_cert</replaceable></term>
+<listitem><para>公開先の HTTPS リポジトリにパッケージを公開するために使用するクライアント SSL 証明書ファイルを指定します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-clone</option></term>
+<listitem><para>ソースリポジトリの正確なコピーを作成します。デフォルトでは、ソースリポジトリ内のパブリッシャーが公開先にも存在する場合にのみ、クローン操作が成功します。クローン操作を指定されたパブリッシャーに制限するには、<option>p</option> オプションを使用します。<option>p</option> オプションを使用して指定されたパブリッシャーが公開先リポジトリにまだ存在しない場合は、公開先リポジトリに追加されます。公開先リポジトリに存在するがソースリポジトリに存在しないパッケージは、削除されます。クローン操作でエラーが発生した場合、公開先リポジトリは変更されたままになります。このため、公開先リポジトリを専用の ZFS データセットに配置し、クローン操作を実行する前にスナップショットを作成するようにしてください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-newest</option></term>
+<listitem><para><option>s</option> オプションで指定されたリポジトリから使用可能な最新バージョンのパッケージを一覧表示します。その他のすべてのオプションは無視されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-raw</option></term>
+<listitem><para>raw パッケージデータを取得し、<option>d</option> で指定された場所に、幹およびバージョンごとの一連のディレクトリ構造内に格納します。<option>-raw</option> オプションは、ファイルシステムベースの出力先の場合にのみ使用できます。このパッケージデータを使用すると、一般にはファイルの内容を修正するか、または追加のパッケージメタデータを提供することによって、パッケージを便利に変更して再公開することができます。<option>-raw</option> オプションを <option>a</option> と組み合わせることはできません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>最新のパッケージを一覧表示する</title>
+<para><literal>test</literal> という名前のシステム上のリポジトリから使用可能な最新のパッケージを一覧表示します。</para>
+<screen>$ <userinput>pkgrecv -s http://test --newest</userinput>
 pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
 pkg://solaris/system/library/[email protected],5.11-0.175.1.0.0.7.1234:20120109T215840Z
-pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190432Z
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fRraw パッケージデータを取得する
-.sp
-.LP
-例 1 から \fBc++-runtime\fR パッケージを \fBpkgsend publish\fR で使用するために適した形式で受け取ります。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test \e\fR
-\fB-d /local/repo --raw \e\fR
-\[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z\fR
+pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190432Z</screen>
+</example>
+<example><title>raw パッケージデータを取得する</title>
+<para>例 1 から <literal>c++-runtime</literal> パッケージを <command>pkgsend publish</command> で使用するために適した形式で受け取ります。</para>
+<screen>$ <userinput>pkgrecv -s http://test &bsol;</userinput>
+<userinput>-d /local/repo --raw &bsol;</userinput>
+<userinput>[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z</userinput>
 Processing packages for publisher solaris ...
 Retrieving and evaluating 1 package(s)...
 PROCESS       ITEMS     GET (MB)    SEND (MB)
 Completed       1/1      3.5/3.5      0.0/0.0
-$ \fBls /local/repo\fR
-pkg5.repository  publisher  system%2Flibrary%2Fc%2B%2B-runtime
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 3 \fRシステムから依存関係を取得する
-.sp
-.LP
-\fBtest\fR という名前のシステムから、パッケージ \fBeditor/vim\fR とそのすべての依存関係を受け取ります。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d /local/repo -r editor/vim\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 4 \fR最新バージョンのみを取得する
-.sp
-.LP
-\fBtest\fR という名前のシステムから、パッケージ \fBeditor/vim\fR の最新バージョンのみを受け取ります。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d /local/repo -m latest -v \e\fR
-\fBeditor/vim\fR
+$ <userinput>ls /local/repo</userinput>
+pkg5.repository  publisher  system%2Flibrary%2Fc%2B%2B-runtime</screen>
+</example>
+<example><title>システムから依存関係を取得する</title>
+<para><literal>test</literal> という名前のシステムから、パッケージ <literal>editor/vim</literal> とそのすべての依存関係を受け取ります。</para>
+<screen>$ <userinput>pkgrecv -s http://test -d /local/repo -r editor/vim</userinput></screen>
+</example>
+<example><title>最新バージョンのみを取得する</title>
+<para><literal>test</literal> という名前のシステムから、パッケージ <literal>editor/vim</literal> の最新バージョンのみを受け取ります。</para>
+<screen>$ <userinput>pkgrecv -s http://test -d /local/repo -m latest -v &bsol;</userinput>
+<userinput>editor/vim</userinput>
 Processing packages for publisher solaris ...
 Retrieving and evaluating 1 package(s)...
 
@@ -385,225 +171,118 @@
 editor/[email protected],5.11-0.175.1.0.0.24.0:20120904T172128Z
 
 PROCESS                                     ITEMS    GET (MB) SEND (MB)
-Completed                                     1/1     9.2/9.2 25.4/25.4
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 5 \fRすべてのバージョンを取得し、リモートから再公開する
-.sp
-.LP
-\fBtest\fR という名前のシステムから、パッケージ \fBlibrary/zlib\fR のすべてのバージョンを受け取り、それを \fBremote\fR という名前のシステム上のリモートリポジトリに再公開します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d http://remote:10000 \e\fR
-\fB-m all-versions library/zlib\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 6 \fRリポジトリから依存関係を取得する
-.sp
-.LP
-\fB/export/repo\fR にあるリポジトリから、パッケージ \fBeditor/gnu-emacs\fR とそのすべての依存関係を受け取ります。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 7 \fR追加パッケージおよび変更された内容の取得
-.sp
-.LP
-まだ存在しないすべてのパッケージおよびすべての変更済みの内容を、\fBhttp://pkg.oracle.com/solaris/release/\fR にあるリポジトリから \fB/export/repoSolaris11\fR にあるリポジトリに受信します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://pkg.oracle.com/solaris/release/ \e\fR
-\fB-d /export/repoSolaris11 -m all-timestamps '*'\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-まだ存在しないすべてのパッケージおよびすべての変更済みの内容を、\fBhttps://pkg.oracle.com/solaris/support/\fR にあるセキュアなリポジトリから \fB/export/repoSolaris11\fR にあるリポジトリに受信します。 
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s https://pkg.oracle.com/solaris/support/ \e\fR
-\fB-d /export/repoSolaris11 -m all-timestamps \e\fR
-\fB--key /var/pkg/ssl/Oracle_Solaris_11_Support.key.pem \e\fR
-\fB--cert /var/pkg/ssl/Oracle_Solaris_11_Support.certificate.pem '*'\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 8 \fRパッケージアーカイブを作成する
-.sp
-.LP
-\fBhttp://example.com:10000\fR にあるリポジトリから、パッケージ \fBeditor/gnu-emacs\fR とそのすべての依存関係を含むパッケージアーカイブを作成します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://example.com:10000 -d /my/emacs.p5p -a \e\fR
-\fB-r editor/gnu-emacs\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 9 \fRパッケージをアーカイブからリポジトリにコピーする
-.sp
-.LP
-パッケージアーカイブ内のすべてのパッケージを \fB/export/repo\fR にある既存のリポジトリにコピーします。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s /my/archive.p5p -d /export/repo '*'\fR
-.fi
-.in -2
-.sp
-
-.SH 環境
-.sp
-.LP
-次の環境変数がサポートされています。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_DEST\fR\fR
-.ad
-.RS 12n
-.rt  
-取得されたパッケージを保存する先のディレクトリのパス、またはパッケージがコピーされるリポジトリまたはパッケージアーカイブのファイルシステムのパスまたは URI。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_SRC\fR\fR
-.ad
-.RS 12n
-.rt  
-パッケージ取得先の \fBpkg\fR(5) リポジトリまたはパッケージアーカイブの場所を表す URI またはファイルシステムのパス。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBTMPDIR\fR\fR
-.ad
-.RS 12n
-.rt  
-プログラム実行中に一時データが格納されるディレクトリの絶対パス。設定されていない場合、一時データはデフォルトで \fB/var/tmp\fR に格納されます。
-.RE
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-複数の操作が要求されましたが、それらの一部のみが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkgrepo\fR(1), \fBpkgsend\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fI『Copying and Creating Package Repositories in Oracle Solaris 11.2 』\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 注意事項
-.sp
-.LP
-ファイルシステムベースの公開先リポジトリを使用する場合、パッケージの転送が完了して Web インタフェースまたは検索応答で変更が反映されたあとに、そのリポジトリを提供している \fBpkg.depotd\fR プロセスを再開する必要があります。詳細は、\fBpkg.depotd\fR(1M) を参照してください。
+Completed                                     1/1     9.2/9.2 25.4/25.4</screen>
+</example>
+<example><title>すべてのバージョンを取得し、リモートから再公開する</title>
+<para><literal>test</literal> という名前のシステムから、パッケージ <literal>library/zlib</literal> のすべてのバージョンを受け取り、それを <literal>remote</literal> という名前のシステム上のリモートリポジトリに再公開します。</para>
+<screen>$ <userinput>pkgrecv -s http://test -d http://remote:10000 &bsol;</userinput>
+<userinput>-m all-versions library/zlib</userinput></screen>
+</example>
+<example><title>リポジトリから依存関係を取得する</title>
+<para><filename>/export/repo</filename> にあるリポジトリから、パッケージ <literal>editor/gnu-emacs</literal> とそのすべての依存関係を受け取ります。</para>
+<screen>$ <userinput>pkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs</userinput></screen>
+</example>
+<example><title>追加パッケージおよび変更された内容の取得</title>
+<para>まだ存在しないすべてのパッケージおよびすべての変更済みの内容を、<literal>http://pkg.oracle.com/solaris/release/</literal> にあるリポジトリから <literal>/export/repoSolaris11</literal> にあるリポジトリに受信します。</para>
+<screen>$ <userinput>pkgrecv -s http://pkg.oracle.com/solaris/release/ &bsol;</userinput>
+<userinput>-d /export/repoSolaris11 -m all-timestamps '*'</userinput></screen>
+<para>まだ存在しないすべてのパッケージおよびすべての変更済みの内容を、<literal>https://pkg.oracle.com/solaris/support/</literal> にあるセキュアなリポジトリから <literal>/export/repoSolaris11</literal> にあるリポジトリに受信します。 </para>
+<screen>$ <userinput>pkgrecv -s https://pkg.oracle.com/solaris/support/ &bsol;</userinput>
+<userinput>-d /export/repoSolaris11 -m all-timestamps &bsol;</userinput>
+<userinput>--key /var/pkg/ssl/Oracle_Solaris_11_Support.key.pem &bsol;</userinput>
+<userinput>--cert /var/pkg/ssl/Oracle_Solaris_11_Support.certificate.pem '*'</userinput></screen>
+</example>
+<example><title>パッケージアーカイブを作成する</title>
+<para><literal>http://example.com:10000</literal> にあるリポジトリから、パッケージ <literal>editor/gnu-emacs</literal> とそのすべての依存関係を含むパッケージアーカイブを作成します。</para>
+<screen>$ <userinput>pkgrecv -s http://example.com:10000 -d /my/emacs.p5p -a &bsol;</userinput>
+<userinput>-r editor/gnu-emacs</userinput></screen>
+</example>
+<example><title>パッケージをアーカイブからリポジトリにコピーする</title>
+<para>パッケージアーカイブ内のすべてのパッケージを <filename>/export/repo</filename> にある既存のリポジトリにコピーします。</para>
+<screen>$ <userinput>pkgrecv -s /my/archive.p5p -d /export/repo '*'</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<para>次の環境変数がサポートされています。</para>
+<variablelist>
+<varlistentry><term><envar>PKG_DEST</envar></term>
+<listitem><para>取得されたパッケージを保存する先のディレクトリのパス、またはパッケージがコピーされるリポジトリまたはパッケージアーカイブのファイルシステムのパスまたは URI。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_SRC</envar></term>
+<listitem><para>パッケージ取得先の <literal>pkg</literal>(5) リポジトリまたはパッケージアーカイブの場所を表す URI またはファイルシステムのパス。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>TMPDIR</envar></term>
+<listitem><para>プログラム実行中に一時データが格納されるディレクトリの絶対パス。設定されていない場合、一時データはデフォルトで <filename>/var/tmp</filename> に格納されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>複数の操作が要求されましたが、それらの一部のみが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>ファイルシステムベースの公開先リポジトリを使用する場合、パッケージの転送が完了して Web インタフェースまたは検索応答で変更が反映されたあとに、そのリポジトリを提供している <command>pkg.depotd</command> プロセスを再開する必要があります。詳細は、<command>pkg.depotd</command>(1M) を参照してください。</para>
+</refsect1>
+</refentry>
--- a/src/man/ja_JP/pkgrepo.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgrepo.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,1191 +1,540 @@
-'\" te
-.\" Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved.
-.TH pkgrepo 1 "2014 年 3 月 27 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgrepo \- Image Packaging System リポジトリ管理ユーティリティー
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgrepo create [--version \fIver\fR] \fIuri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo add-publisher -s \fIrepo_uri_or_path\fR
-    \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo remove-publisher [-n] [--synchronous]
-    -s \fIrepo_uri_or_path\fR \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo get [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [\fIsection/property\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo info [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo list [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo contents [-m]
-    [-t \fIaction_name\fR[,\fIaction_name\fR]...]... -s \fIrepo_uri_or_path\fR
-    [--key \fIssl_key\fR --cert \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo rebuild [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [--no-catalog] [--no-index]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo refresh [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [--no-catalog] [--no-index]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo remove [-n] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo set [-p \fIpublisher\fR]... -s \fIrepo_uri_or_path\fR
-    \fIsection/property\fR=[\fIvalue\fR] ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo set [-p \fIpublisher\fR]... -s \fIrepo_uri_or_path\fR
-    \fIsection/property\fR=([\fIvalue\fR]) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo verify [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo fix [-v] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo help
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo version
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkgrepo\fR を使用すると、\fBpkg\fR(5) パッケージリポジトリの作成および管理を行うことができます。パッケージリポジトリは、\fBpkg\fR や、\fBpkgsend\fR または \fBpkgrecv\fR などの公開クライアントがパッケージデータを格納したり取得したりできるようにするための、定義済みの一連のディレクトリおよびファイルです。さらに、パッケージリポジトリへのネットワークベースのアクセスが必要な場合、\fBpkg.depotd\fR は、クライアントにパッケージデータを格納したり取得したりするためのリポジトリへのアクセスを提供できます。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.SH サブコマンド
-.sp
-.LP
-サポートされているサブコマンドは次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo create\fR [\fB--version\fR \fIver\fR] \fIuri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された場所に \fBpkg\fR(5) リポジトリを作成します。
-.sp
-このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--version\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたバージョンと互換性がある形式でリポジトリを作成します。デフォルトでは、バージョン 4 のリポジトリが作成されます。サポートされるバージョンは次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB3\fR
-.ad
-.RS 5n
-.rt  
-1 つのパブリッシャー、カタログバージョン 1、および検索バージョン 1 でのパッケージの格納をサポートします。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB4\fR
-.ad
-.RS 5n
-.rt  
-複数のパブリッシャー、カタログバージョン 1、および検索バージョン 1 でのパッケージの格納をサポートします。
-.RE
-
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo add-publisher\fR \fB-s\fR \fIrepo_uri_or_path\fR \fIpublisher\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元をリポジトリに追加します。新しいパブリッシャーにパッケージや内容は含まれていません。
-.sp
-このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo remove-publisher\fR [\fB-n\fR] [\fB--synchronous\fR] \fB-s\fR \fIrepo_uri_or_path\fR \fIpublisher\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパブリッシャーをリポジトリから削除します。指定されたパブリッシャーのすべてのパッケージとすべてのほかのデータを削除します。
-.sp
-デフォルトパブリッシャーが削除され、リポジトリ内にパブリッシャーが 1 つだけ残った場合は、その残りのパブリッシャーがデフォルトになります。リポジトリの \fBpublisher/prefix\fR プロパティーは、その残りのパブリッシャーに設定されます。
-.sp
-デフォルトパブリッシャーが削除され、リポジトリ内に複数のパブリッシャーが残った場合、またはリポジトリ内の最後のパブリッシャーが削除された場合、\fBpublisher/prefix\fR プロパティーは未設定になります。
-.sp
-このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-パブリッシャーの変更は行わずに試しに操作を実行します。終了する前に、パブリッシャーごとに削除されるパッケージの数が表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--synchronous\fR\fR
-.ad
-.sp .6
-.RS 4n
-操作が完了するのを待ってから戻ります。このオプションが指定されなかった場合、このコマンドはただちに戻りますが、パブリッシャーはバックグラウンドで非同期的に削除されます。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo get\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIsection/property\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリまたはその発行元のプロパティー情報を表示します。
-.sp
-デフォルトでは、各プロパティーとその値が個別の行に出力されます。空の ASCII 文字列値は、二重引用符 (\fB""\fR) のペアで表されます。ASCII 文字列値内の次の Bourne シェルのメタキャラクタと、改行、スペース、およびタブは、バックスラッシュ文字 (\fB\\fR) でエスケープする必要があります。
-.sp
-.in +2
-.nf
-; & ( ) | ^ < > \e " ' `
-.fi
-.in -2
-
-発行元とリポジトリプロパティーの表示例については、「使用例」セクションを参照してください。
-.sp
-プロパティーのリスト、および各プロパティーの目的と値については、下の \fBset\fR サブコマンドを参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-代替出力形式を指定します。\fIformat\fR の値は、\fBtsv\fR (Tab Separated Values)、\fBjson\fR (単一行としての JavaScript Object Notation)、または \fBjson-formatted\fR (読みやすい形式にされた JavaScript Object Notation) にできます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR \fR
-.ad
-.sp .6
-.RS 4n
-一覧からヘッダーを省略します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元のプロパティー情報を表示します。特殊な値 \fBall\fR により、すべてのパブリッシャーのプロパティーが表示されます。このオプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB--key\fR オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL キーファイルを指定するために使用します。\fB--cert\fR オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL 証明書ファイルを指定するために使用します。このオプションのペアは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection/property\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB publisher/prefix\fR や \fBrepository/version\fR などの、指定されたプロパティーの値のみを表示します。プロパティーの完全な一覧については、\fB set\fR サブコマンドを参照してください。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo info\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]...\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリで認識されているパッケージ発行元のリストを表示します。このリストには、パブリッシャーごとのパッケージの数、パブリッシャーのパッケージデータが最後に更新された日時、およびパブリッシャーのパッケージデータのステータス (現在処理されているかどうかなど) が含まれます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元のデータのみを表示します。指定されていない場合は、すべてのパブリッシャーのデータが表示されます。このオプションは複数回指定できます。
-.RE
-
-ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo list\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-指定された \fIpkg_fmri_pattern\fR にマッチする \fIrepo_uri_or_path\fR リポジトリのパッケージを一覧表示します。パターンが指定されない場合、リポジトリのすべてのパッケージが一覧表示されます。\fIpkg_fmri_pattern\fR パターンには、\fBglob\fR(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する \fB?\fR および \fB*\fR 文字を含めることができます。
-.sp
-デフォルトの出力では、最初の列にパッケージのパブリッシャーの名前が含まれます。2 番目の列にはパッケージの名前が含まれます。3 番目の列には、パッケージのステータスを示すフラグが含まれます。ステータス列の \fBo\fR の値は、パッケージが廃止されていることを示します。ステータス列の \fBr\fR の値は、パッケージの名前が変更されたことを示します (廃止の形態の 1 つです)。4 番目の列には、パッケージのリリースおよびブランチのバージョンが含まれます。リリースバージョンとブランチバージョンについては、\fBpkg\fR(5) を参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元のパッケージのみを表示します。指定されていない場合は、すべてのパブリッシャーのパッケージが一覧表示されます。このオプションは複数回指定できます。
-.RE
-
-ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo contents\fR [\fB-m\fR [\fB-t\fR \fIaction_name\fR[,\fIaction_name\fR]...]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR...]\fR
-.ad
-.sp .6
-.RS 4n
-\fIrepo_uri_or_path\fR リポジトリ内のすべてのパッケージを一覧表示します。\fIpkg_fmri_pattern\fR が指定された場合は、リポジトリ内の一致するすべてのパッケージの内容 (アクション属性) を表示します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージ内のアクションのすべての属性を表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージ内の指定されたアクションのみを表示します。\fB-t\fR オプションは複数回指定できます。または、アクション名をコンマで区切ることにより、1 つの \fB-t\fR オプションの引数として複数のアクションを指定できます。\fIaction_name\fR の値は、\fBpkg\fR(5) のマニュアルページの「アクション」に一覧表示されているアクションのいずれか (\fBfile\fR、\fBdir\fR、\fBdriver\fR、\fBdepend\fR、\fBset\fR など) です。
-.RE
-
-ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo rebuild\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB--no-catalog\fR] [\fB--no-index\fR]\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリ内に見つかったすべてのカタログ、検索、およびその他のキャッシュされた情報を破棄し、それをリポジトリの現在の内容に基づいて再作成します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元についてのみ操作を実行します。指定されていない場合や、特殊な値 \fBall\fR が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージデータを再構築しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-検索インデックスを再構築しません。
-.RE
-
-ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo refresh\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB--no-catalog\fR] [\fB--no-index\fR] \fR
-.ad
-.sp .6
-.RS 4n
-リポジトリ内に見つかった新しいパッケージをすべてカタログ化し、すべての検索インデックスを更新します。これは、遅延公開 (\fBpkgsend\fR の \fB--no-catalog\fR または \fB--no-index\fR オプション) で使用されることを目的にしています。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元についてのみ操作を実行します。指定されていない場合や、特殊な値 \fBall\fR が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-新しいパッケージを追加しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-検索インデックスを更新しません。
-.RE
-
-ほかのすべてのオプションの説明については、前述の \fBpkgrepo get\fR コマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo remove\fR [\fB-n\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリから、指定された \fIpkg_fmri_pattern\fR パターンに一致するパッケージ (これらのパッケージが参照している、ほかのどのパッケージでも使用されていないすべてのファイルを含む) を削除します。\fIpkg_fmri_pattern\fR パターンには、\fBglob\fR(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する \fB?\fR および \fB*\fR 文字を含めることができます。
-.LP
-注 - 
-.sp
-.RS 2
-関連するパブリッシャーのすべての検索インデックスデータが削除されます。
-.RE
-このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。
-.LP
-注意 - 
-.sp
-.RS 2
-この操作は元に戻せません。また、ほかのクライアントがそのリポジトリにアクセスしている間に使用すべきではありません。使用すると、それらのクライアントが取得操作中に失敗する可能性があります。
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージの変更は行わずに試しに操作を実行します。終了する前に、削除されるパッケージのリストが表示されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元の一致するパッケージのみを削除します。指定されていない場合は、すべてのパブリッシャーの一致するパッケージがすべて削除されます。このオプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo set\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIsection/property\fR=[\fIvalue\fR] ...\fR
-.ad
-.br
-.na
-\fB\fBpkgrepo set\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIsection/property\fR=([\fIvalue\fR]) ...\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリまたは発行元の指定されたプロパティーの値を設定します。
-.sp
-このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された発行元のプロパティーデータのみを設定します。パブリッシャーがまだ存在しない場合は、追加されます。特殊な値 \fBall\fR を使用すると、すべての発行元のプロパティーを設定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
-.RE
-
-プロパティーと値は、次のいずれかの形式を使用して指定できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=\fR
-.ad
-.sp .6
-.RS 4n
-プロパティー値をクリアーします。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-プロパティー値を指定された値に置き換えます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=(\fIvalue1\fR \fIvalue2\fR \fIvalueN\fR)\fR
-.ad
-.sp .6
-.RS 4n
-プロパティー値を値のリストに置き換えます。
-.RE
-
-リポジトリバージョン 3 および 4 の場合は、リポジトリの次のプロパティーを設定できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpublisher/prefix\fR\fR
-.ad
-.sp .6
-.RS 4n
-デフォルトのパブリッシャーの名前を表す文字列。最初の文字は a-z、A-Z、または 0-9 である必要があります。文字列の残りの部分には、文字 0-9、-、.、a-z、および A-Z のみを含めることができます。この値は、複数のパブリッシャーのパッケージが存在するとき、またはパッケージがリポジトリに公開されているが、パブリッシャーが指定されていないときに使用されるべきパブリッシャーを示します。
-.RE
-
-リポジトリバージョン 3 および 4 の場合は、リポジトリ内の個々のパブリッシャーの次のプロパティーを設定できます。これらのプロパティーを設定するときは、\fB-p\fR オプションを使用して 1 つ以上のパブリッシャーを指定します。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpublisher/alias\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリの構成データを使用してパブリッシャーを追加するときにクライアントが使用すべきデフォルトの別名を表す文字列。最初の文字は a-z、A-Z、または 0-9 である必要があります。文字列の残りの部分には、文字 0-9、-、.、a-z、および A-Z のみを含めることができます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/check-certificate-revocation\fR\fR
-.ad
-.sp .6
-.RS 4n
-証明書が失効したかどうかを検査する boolean。このプロパティーを \fBTrue\fR に設定すると、\fBpkgrepo verify\fR および \fBpkgrepo fix\fR コマンドは、署名検証のために使用される証明書の CRL 配布ポイントへのアクセスを試み、発行時よりもあとに証明書が失効していないかどうかを調べます。デフォルト値は \fBFalse\fR です。このプロパティーは、リポジトリの内容を検証するために、\fBverify\fR および \fBfix\fR サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。この値は、対応する \fBpkg\fR(1) プロパティー値と同じである必要があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/collection_type\fR\fR
-.ad
-.sp .6
-.RS 4n
-このリポジトリで提供されるパッケージのタイプを示す値 \fBcore\fR または \fBsupplemental\fR を持つことができます。
-.sp
-\fBcore\fR タイプは、このリポジトリにはリポジトリ内のパッケージによって宣言されたすべての依存関係が含まれていることを示します。\fBcore\fR タイプは主に、オペレーティングシステムリポジトリに使用されます。
-.sp
-\fBsupplemental\fR タイプは、このリポジトリには、別のリポジトリ内に配置されているパッケージに依存するか、またはそれらのパッケージとともに使用されるためのパッケージが含まれていることを示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/description\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリの目的と内容を説明した標準テキストの段落。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/detailed_url\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリに関する追加情報を提供するドキュメント (Web ページなど) の場所を表す URI。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/legal_uris\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリに関する追加の使用条件情報を提供するドキュメントの場所 (URI) のリスト。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/mirrors\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリのパッケージ内容のコピーを含むが、パッケージのメタデータは含まないリポジトリの場所 (URI) のリスト。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/name\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリの名前を含む標準テキスト文字列。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/origins\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリのパッケージのメタデータと内容の完全なコピーを含むリポジトリの場所 (URI) のリスト。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/refresh_seconds\fR\fR
-.ad
-.sp .6
-.RS 4n
-クライアントが、更新されたパッケージデータがあるかどうかを調べるためにリポジトリをチェックする際に、各更新チェックのあとに待つべき秒数を表す整数値。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/registration_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリへのアクセスのための資格を取得するために使用する必要のあるリソースの場所を表す URI。この 1 つの例に、登録 Web ページがあります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/related_uris\fR\fR
-.ad
-.sp .6
-.RS 4n
-ユーザーが関心を持っている可能性があるパッケージを含むリポジトリの場所 (URI) のリスト。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/signature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージの署名の検証中に、証明書の共通名として表示される必要のある名前の一覧です。このプロパティーは、リポジトリの内容を検証するために、\fBverify\fR および \fBfix\fR サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。これらの値は、対応する \fBpkg\fR(1) プロパティー値と同じである必要があります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/trust-anchor-directory\fR\fR
-.ad
-.sp .6
-.RS 4n
-このリポジトリ内のパッケージのトラストアンカーを含むディレクトリの絶対パス名。指定しない場合、\fB/etc/certs/CA/\fR が使用されます。このプロパティーは、リポジトリの内容を検証するために、\fBverify\fR および \fBfix\fR サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。この値は、対応する \fBpkg\fR(1) プロパティー値と同じである必要があります。
-.RE
-
-ここには記載されていないが \fBget\fR サブコマンドの出力に一覧表示されるプロパティーは、内部使用のために予約されているため、設定しないようにしてください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo verify\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージリポジトリの内容の次の属性が正しいことを検証します。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ファイルのチェックサム
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ファイルのアクセス権
-.sp
-\fBpkg5srv\fR ユーザーがリポジトリの内容を読み取ることができることを確認するために、リポジトリへのパスも検査されます。この検査は、\fBsvc:/application/pkg/server\fR サービスを使用するか、システムに非大域ゾーンがある場合に \fBsvc:/application/pkg/system-repository\fR サービスを使用することによって使用できるようになるリポジトリに対して必要になることがあります。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-パッケージマニフェストのアクセス権
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-パッケージマニフェストの内容
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-パッケージ署名
-.sp
-パッケージマニフェスト署名は、\fBrepository/signature-required-names\fR、\fBrepository/trust-anchor-directory\fR、および \fBrepository/check-certificate-revocation \fR プロパティーの値に基づいて計算されます。
-.RE
-エラーは \fBstdout\fR に出力されます。何らかのエラーが出力された場合、\fBpkgrepo\fR コマンドはゼロ以外の戻りコードで終了します。
-.sp
-このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパブリッシャーについてのみ操作を実行します。パブリッシャーが指定されていない場合や、特殊な値 \fBall\fR が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo fix\fR [\fB-v\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-最初にリポジトリを検証し、無効なリポジトリの内容をリポジトリ内の検疫ディレクトリに移動することによって、リポジトリの内容を修正します。
-.sp
-リポジトリエラーが見つかった場合は、リポジトリの再構築が自動的に実行されます。エラーが見つかった場合は、メッセージが \fBstdout\fR に出力され、リポジトリ内容を復元するために \fBpkgsend\fR(1) または \fBpkgrecv\fR(1) を使用して再インポートする必要があるパッケージが示されます。
-.sp
-このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-リポジトリの検証時に見つかったエラーを詳述する出力が含まれます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパブリッシャーについてのみ操作を実行します。パブリッシャーが指定されていない場合や、特殊な値 \fBall\fR が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定された URI またはファイルシステムのパスにあるリポジトリを操作します。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo version\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkg\fR(5) システムのバージョンを識別する一意の文字列を表示します。\fBversion\fR 操作によって生成される値はソート可能ではないため、等しいかどうかを超えて安全に比較することはできません。
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fRパッケージリポジトリを作成する
-.sp
-.in +2
-.nf
-$ \fBpkgrepo create /my/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fR情報を表示する
-.sp
-.LP
-パブリッシャーのサマリーと、リポジトリ内のパッケージの数を表示します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo info -s /my/repository\fR
+<refentry lang="ja" id="pkgrepo-1">
+<refmeta><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2015 年 5 月 26 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgrepo</refname><refpurpose>Image Packaging System リポジトリ管理ユーティリティー</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgrepo create [--version <replaceable>ver</replaceable>] <replaceable>uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo add-publisher -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>publisher</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo remove-publisher [-n] [--synchronous]
+    -s <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo get [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [<replaceable>section/property</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkgrepo info [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...</synopsis>
+<synopsis>/usr/bin/pkgrepo list [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkgrepo contents [-m]
+    [-t <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]... -s <replaceable>repo_uri_or_path</replaceable>
+    [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable>...]</synopsis>
+<synopsis>/usr/bin/pkgrepo rebuild [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [--no-catalog] [--no-index]</synopsis>
+<synopsis>/usr/bin/pkgrepo refresh [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [--no-catalog] [--no-index]</synopsis>
+<synopsis>/usr/bin/pkgrepo remove [-n] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> <replaceable>pkg_fmri_pattern</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo set [-p <replaceable>publisher</replaceable>]... -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>section/property</replaceable>=[<replaceable>value</replaceable>] ...</synopsis>
+<synopsis>/usr/bin/pkgrepo set [-p <replaceable>publisher</replaceable>]... -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>section/property</replaceable>=([<replaceable>value</replaceable>]) ...</synopsis>
+<synopsis>/usr/bin/pkgrepo verify [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo fix [-v] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo help</synopsis>
+<synopsis>/usr/bin/pkgrepo version</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgrepo-1-desc" role="description"><title></title>
+<para><command>pkgrepo</command> を使用すると、<literal>pkg</literal>(5) パッケージリポジトリの作成および管理を行うことができます。パッケージリポジトリは、<command>pkg</command> や、<command>pkgsend</command> または <command>pkgrecv</command> などの公開クライアントがパッケージデータを格納したり取得したりできるようにするための、定義済みの一連のディレクトリおよびファイルです。さらに、パッケージリポジトリへのネットワークベースのアクセスが必要な場合、<command>pkg.depotd</command> は、クライアントにパッケージデータを格納したり取得したりするためのリポジトリへのアクセスを提供できます。</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>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>サポートされているサブコマンドは次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgrepo create</command> [<option>-version</option> <replaceable>ver</replaceable>] <replaceable>uri_or_path</replaceable></term>
+<listitem><para>指定された場所に <literal>pkg</literal>(5) リポジトリを作成します。</para>
+<para>このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-version</option></term>
+<listitem><para>指定されたバージョンと互換性がある形式でリポジトリを作成します。デフォルトでは、バージョン 4 のリポジトリが作成されます。サポートされるバージョンは次のとおりです。</para>
+<variablelist>
+<varlistentry><term>3</term>
+<listitem><para>1 つのパブリッシャー、カタログバージョン 1、および検索バージョン 1 でのパッケージの格納をサポートします。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>4</term>
+<listitem><para>複数のパブリッシャー、カタログバージョン 1、および検索バージョン 1 でのパッケージの格納をサポートします。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo add-publisher</command> <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</term>
+<listitem><para>指定された発行元をリポジトリに追加します。新しいパブリッシャーにパッケージや内容は含まれていません。</para>
+<para>このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>指定された URI またはファイルシステムのパスにあるリポジトリを操作します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo remove-publisher</command> [<option>n</option>] [<option>-synchronous</option>] <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</term>
+<listitem><para>指定されたパブリッシャーをリポジトリから削除します。指定されたパブリッシャーのすべてのパッケージとすべてのほかのデータを削除します。</para>
+<para>デフォルトパブリッシャーが削除され、リポジトリ内にパブリッシャーが 1 つだけ残った場合は、その残りのパブリッシャーがデフォルトになります。リポジトリの <literal>publisher/prefix</literal> プロパティーは、その残りのパブリッシャーに設定されます。</para>
+<para>デフォルトパブリッシャーが削除され、リポジトリ内に複数のパブリッシャーが残った場合、またはリポジトリ内の最後のパブリッシャーが削除された場合、<literal>publisher/prefix</literal> プロパティーは未設定になります。</para>
+<para>このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>n</option></term>
+<listitem><para>パブリッシャーの変更は行わずに試しに操作を実行します。終了する前に、パブリッシャーごとに削除されるパッケージの数が表示されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>指定された URI またはファイルシステムのパスにあるリポジトリを操作します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-synchronous</option></term>
+<listitem><para>操作が完了するのを待ってから戻ります。このオプションが指定されなかった場合、このコマンドはただちに戻りますが、パブリッシャーはバックグラウンドで非同期的に削除されます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo get</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>section/property</replaceable> ...]</term>
+<listitem><para>リポジトリまたはその発行元のプロパティー情報を表示します。</para>
+<para>デフォルトでは、各プロパティーとその値が個別の行に出力されます。空の ASCII 文字列値は、二重引用符 (<literal>""</literal>) のペアで表されます。ASCII 文字列値内の次の Bourne シェルのメタキャラクタと、改行、スペース、およびタブは、バックスラッシュ文字 (<literal>\</literal>) でエスケープする必要があります。</para>
+<programlisting>; &amp; ( ) | ^ &lt; > &bsol; " ' `</programlisting>
+<para>発行元とリポジトリプロパティーの表示例については、「使用例」セクションを参照してください。</para>
+<para>プロパティーのリスト、および各プロパティーの目的と値については、下の <command>set</command> サブコマンドを参照してください。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>代替出力形式を指定します。<replaceable>format</replaceable> の値は、<literal>tsv</literal> (Tab Separated Values)、<literal>json</literal> (単一行としての JavaScript Object Notation)、または <literal>json-formatted</literal> (読みやすい形式にされた JavaScript Object Notation) にできます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option> </term>
+<listitem><para>一覧からヘッダーを省略します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定された発行元のプロパティー情報を表示します。特殊な値 <literal>all</literal> により、すべてのパブリッシャーのプロパティーが表示されます。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>指定された URI またはファイルシステムのパスにあるリポジトリを操作します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para><option>-key</option> オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL キーファイルを指定するために使用します。<option>-cert</option> オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL 証明書ファイルを指定するために使用します。このオプションのペアは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section/property</replaceable></term>
+<listitem><para><literal> publisher/prefix</literal> や <literal>repository/version</literal> などの、指定されたプロパティーの値のみを表示します。プロパティーの完全な一覧については、<command> set</command> サブコマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo info</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]...</term>
+<listitem><para>リポジトリで認識されているパッケージ発行元のリストを表示します。このリストには、パブリッシャーごとのパッケージの数、パブリッシャーのパッケージデータが最後に更新された日時、およびパブリッシャーのパッケージデータのステータス (現在処理されているかどうかなど) が含まれます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定された発行元のデータのみを表示します。指定されていない場合は、すべてのパブリッシャーのデータが表示されます。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>ほかのすべてのオプションの説明については、前述の <command>pkgrepo get</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo list</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para>指定された <replaceable>pkg_fmri_pattern</replaceable> にマッチする <replaceable>repo_uri_or_path</replaceable> リポジトリのパッケージを一覧表示します。パターンが指定されない場合、リポジトリのすべてのパッケージが一覧表示されます。<replaceable>pkg_fmri_pattern</replaceable> パターンには、<literal>glob</literal>(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する <literal>?</literal> および <literal>*</literal> 文字を含めることができます。</para>
+<para>デフォルトの出力では、最初の列にパッケージのパブリッシャーの名前が含まれます。2 番目の列にはパッケージの名前が含まれます。3 番目の列には、パッケージのステータスを示すフラグが含まれます。ステータス列の <literal>o</literal> の値は、パッケージが廃止されていることを示します。ステータス列の <literal>r</literal> の値は、パッケージの名前が変更されたことを示します (廃止の形態の 1 つです)。4 番目の列には、パッケージのリリースおよびブランチのバージョンが含まれます。リリースバージョンとブランチバージョンについては、<literal>pkg</literal>(5) を参照してください。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定された発行元のパッケージのみを表示します。指定されていない場合は、すべてのパブリッシャーのパッケージが一覧表示されます。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>ほかのすべてのオプションの説明については、前述の <command>pkgrepo get</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo contents</command> [<option>m</option> [<option>t</option> <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable>...]</term>
+<listitem><para><replaceable>repo_uri_or_path</replaceable> リポジトリ内のすべてのパッケージを一覧表示します。<replaceable>pkg_fmri_pattern</replaceable> が指定された場合は、リポジトリ内の一致するすべてのパッケージの内容 (アクション属性) を表示します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>m</option></term>
+<listitem><para>指定されたパッケージ内のアクションのすべての属性を表示します。</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>(5) のマニュアルページの「アクション」に一覧表示されているアクションのいずれか (<literal>file</literal>、<literal>dir</literal>、<literal>driver</literal>、<literal>depend</literal>、<literal>set</literal> など) です。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>ほかのすべてのオプションの説明については、前述の <command>pkgrepo get</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo rebuild</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>-no-catalog</option>] [<option>-no-index</option>]</term>
+<listitem><para>リポジトリ内に見つかったすべてのカタログ、検索、およびその他のキャッシュされた情報を破棄し、それをリポジトリの現在の内容に基づいて再作成します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定された発行元についてのみ操作を実行します。指定されていない場合や、特殊な値 <literal>all</literal> が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>パッケージデータを再構築しません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>検索インデックスを再構築しません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>ほかのすべてのオプションの説明については、前述の <command>pkgrepo get</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo refresh</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>-no-catalog</option>] [<option>-no-index</option>] </term>
+<listitem><para>リポジトリ内に見つかった新しいパッケージをすべてカタログ化し、すべての検索インデックスを更新します。これは、遅延公開 (<command>pkgsend</command> の <option>-no-catalog</option> または <option>-no-index</option> オプション) で使用されることを目的にしています。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定された発行元についてのみ操作を実行します。指定されていない場合や、特殊な値 <literal>all</literal> が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>新しいパッケージを追加しません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>検索インデックスを更新しません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>ほかのすべてのオプションの説明については、前述の <command>pkgrepo get</command> コマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo remove</command> [<option>n</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>pkg_fmri_pattern</replaceable> ...</term>
+<listitem><para>リポジトリから、指定された <replaceable>pkg_fmri_pattern</replaceable> パターンに一致するパッケージ (これらのパッケージが参照している、ほかのどのパッケージでも使用されていないすべてのファイルを含む) を削除します。<replaceable>pkg_fmri_pattern</replaceable> パターンには、<literal>glob</literal>(3C) 形式のワイルドカードとして 1 つ以上のパッケージと一致する <literal>?</literal> および <literal>*</literal> 文字を含めることができます。</para>
+<note><para>関連するパブリッシャーのすべての検索インデックスデータが削除されます。</para>
+</note>
+<para>このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。</para>
+<caution><para>この操作は元に戻せません。また、ほかのクライアントがそのリポジトリにアクセスしている間に使用すべきではありません。使用すると、それらのクライアントが取得操作中に失敗する可能性があります。</para></caution>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>n</option></term>
+<listitem><para>パッケージの変更は行わずに試しに操作を実行します。終了する前に、削除されるパッケージのリストが表示されます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定された発行元の一致するパッケージのみを削除します。指定されていない場合は、すべてのパブリッシャーの一致するパッケージがすべて削除されます。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>指定された URI またはファイルシステムのパスにあるリポジトリを操作します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo set</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>section/property</replaceable>=[<replaceable>value</replaceable>] ...</term><term><command>pkgrepo set</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>section/property</replaceable>=([<replaceable>value</replaceable>]) ...</term>
+<listitem><para>リポジトリまたは発行元の指定されたプロパティーの値を設定します。</para>
+<para>このサブコマンドは、ファイルシステムベースのリポジトリでのみ使用できます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定された発行元のプロパティーデータのみを設定します。パブリッシャーがまだ存在しない場合は、追加されます。特殊な値 <literal>all</literal> を使用すると、すべての発行元のプロパティーを設定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>指定された URI またはファイルシステムのパスにあるリポジトリを操作します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>プロパティーと値は、次のいずれかの形式を使用して指定できます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=</term>
+<listitem><para>プロパティー値をクリアーします。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=<replaceable>value</replaceable></term>
+<listitem><para>プロパティー値を指定された値に置き換えます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=(<replaceable>value1</replaceable> <replaceable>value2</replaceable> <replaceable>valueN</replaceable>)</term>
+<listitem><para>プロパティー値を値のリストに置き換えます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>リポジトリバージョン 3 および 4 の場合は、リポジトリの次のプロパティーを設定できます。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>publisher/prefix</literal></term>
+<listitem><para>デフォルトのパブリッシャーの名前を表す文字列。最初の文字は a-z、A-Z、または 0-9 である必要があります。文字列の残りの部分には、文字 0-9、-、.、a-z、および A-Z のみを含めることができます。この値は、複数のパブリッシャーのパッケージが存在するとき、またはパッケージがリポジトリに公開されているが、パブリッシャーが指定されていないときに使用されるべきパブリッシャーを示します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>リポジトリバージョン 3 および 4 の場合は、リポジトリ内の個々のパブリッシャーの次のプロパティーを設定できます。これらのプロパティーを設定するときは、<option>p</option> オプションを使用して 1 つ以上のパブリッシャーを指定します。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>publisher/alias</literal></term>
+<listitem><para>リポジトリの構成データを使用してパブリッシャーを追加するときにクライアントが使用すべきデフォルトの別名を表す文字列。最初の文字は a-z、A-Z、または 0-9 である必要があります。文字列の残りの部分には、文字 0-9、-、.、a-z、および A-Z のみを含めることができます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/check-certificate-revocation</literal></term>
+<listitem><para>証明書が失効したかどうかを検査する boolean。このプロパティーを <literal>True</literal> に設定すると、<command>pkgrepo verify</command> および <command>pkgrepo fix</command> コマンドは、署名検証のために使用される証明書の CRL 配布ポイントへのアクセスを試み、発行時よりもあとに証明書が失効していないかどうかを調べます。デフォルト値は <literal>False</literal> です。このプロパティーは、リポジトリの内容を検証するために、<command>verify</command> および <command>fix</command> サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。この値は、対応する <literal>pkg</literal>(1) プロパティー値と同じである必要があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/collection_type</literal></term>
+<listitem><para>このリポジトリで提供されるパッケージのタイプを示す値 <literal>core</literal> または <literal>supplemental</literal> を持つことができます。</para>
+<para><literal>core</literal> タイプは、このリポジトリにはリポジトリ内のパッケージによって宣言されたすべての依存関係が含まれていることを示します。<literal>core</literal> タイプは主に、オペレーティングシステムリポジトリに使用されます。</para>
+<para><literal>supplemental</literal> タイプは、このリポジトリには、別のリポジトリ内に配置されているパッケージに依存するか、またはそれらのパッケージとともに使用されるためのパッケージが含まれていることを示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/description</literal></term>
+<listitem><para>リポジトリの目的と内容を説明した標準テキストの段落。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/detailed_url</literal></term>
+<listitem><para>リポジトリに関する追加情報を提供するドキュメント (Web ページなど) の場所を表す URI。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/legal_uris</literal></term>
+<listitem><para>リポジトリに関する追加の使用条件情報を提供するドキュメントの場所 (URI) のリスト。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/mirrors</literal></term>
+<listitem><para>リポジトリのパッケージ内容のコピーを含むが、パッケージのメタデータは含まないリポジトリの場所 (URI) のリスト。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/name</literal></term>
+<listitem><para>リポジトリの名前を含む標準テキスト文字列。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/origins</literal></term>
+<listitem><para>リポジトリのパッケージのメタデータと内容の完全なコピーを含むリポジトリの場所 (URI) のリスト。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/refresh_seconds</literal></term>
+<listitem><para>クライアントが、更新されたパッケージデータがあるかどうかを調べるためにリポジトリをチェックする際に、各更新チェックのあとに待つべき秒数を表す整数値。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/registration_uri</literal></term>
+<listitem><para>リポジトリへのアクセスのための資格を取得するために使用する必要のあるリソースの場所を表す URI。この 1 つの例に、登録 Web ページがあります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/related_uris</literal></term>
+<listitem><para>ユーザーが関心を持っている可能性があるパッケージを含むリポジトリの場所 (URI) のリスト。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/signature-required-names</literal></term>
+<listitem><para>パッケージの署名の検証中に、証明書の共通名として表示される必要のある名前の一覧です。このプロパティーは、リポジトリの内容を検証するために、<command>verify</command> および <command>fix</command> サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。これらの値は、対応する <literal>pkg</literal>(1) プロパティー値と同じである必要があります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/trust-anchor-directory</literal></term>
+<listitem><para>このリポジトリ内のパッケージのトラストアンカーを含むディレクトリの絶対パス名。指定しない場合、<filename>/etc/certs/CA/</filename> が使用されます。このプロパティーは、リポジトリの内容を検証するために、<command>verify</command> および <command>fix</command> サブコマンドによってのみ使用されます。このプロパティーはクライアント設定には影響しません。この値は、対応する <literal>pkg</literal>(1) プロパティー値と同じである必要があります。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>ここには記載されていないが <command>get</command> サブコマンドの出力に一覧表示されるプロパティーは、内部使用のために予約されているため、設定しないようにしてください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo verify</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>パッケージリポジトリの内容の次の属性が正しいことを検証します。</para>
+<itemizedlist>
+<listitem><para>ファイルのチェックサム</para></listitem>
+<listitem><para>ファイルのアクセス権</para><para><literal>pkg5srv</literal> ユーザーがリポジトリの内容を読み取ることができることを確認するために、リポジトリへのパスも検査されます。この検査は、<literal>svc:/application/pkg/server</literal> サービスを使用するか、システムに非大域ゾーンがある場合に <literal>svc:/application/pkg/system-repository</literal> サービスを使用することによって使用できるようになるリポジトリに対して必要になることがあります。</para>
+</listitem>
+<listitem><para>パッケージマニフェストのアクセス権</para></listitem>
+<listitem><para>パッケージマニフェストの内容</para></listitem>
+<listitem><para>パッケージ署名</para><para>パッケージマニフェスト署名は、<literal>repository/signature-required-names</literal>、<literal>repository/trust-anchor-directory</literal>、および <literal>repository/check-certificate-revocation </literal> プロパティーの値に基づいて計算されます。</para>
+</listitem>
+</itemizedlist>
+<para>エラーは <literal>stdout</literal> に出力されます。何らかのエラーが出力された場合、<command>pkgrepo</command> コマンドはゼロ以外の戻りコードで終了します。</para>
+<para>このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定されたパブリッシャーについてのみ操作を実行します。パブリッシャーが指定されていない場合や、特殊な値 <literal>all</literal> が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>指定された URI またはファイルシステムのパスにあるリポジトリを操作します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo fix</command> [<option>v</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>最初にリポジトリを検証し、無効なリポジトリの内容をリポジトリ内の検疫ディレクトリに移動することによって、リポジトリの内容を修正します。</para>
+<para>リポジトリエラーが見つかった場合は、リポジトリの再構築が自動的に実行されます。エラーが見つかった場合は、メッセージが <literal>stdout</literal> に出力され、リポジトリ内容を復元するために <literal>pkgsend</literal>(1) または <literal>pkgrecv</literal>(1) を使用して再インポートする必要があるパッケージが示されます。</para>
+<para>このサブコマンドは、バージョン 4 のファイルシステムベースのリポジトリでのみ使用できます。
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>v</option></term>
+<listitem><para>リポジトリの検証時に見つかったエラーを詳述する出力が含まれます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>指定されたパブリッシャーについてのみ操作を実行します。パブリッシャーが指定されていない場合や、特殊な値 <literal>all</literal> が指定されている場合は、すべてのパブリッシャーについて操作が実行されます。このオプションは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>指定された URI またはファイルシステムのパスにあるリポジトリを操作します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo help</command></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo version</command></term>
+<listitem><para><literal>pkg</literal>(5) システムのバージョンを識別する一意の文字列を表示します。<command>version</command> 操作によって生成される値はソート可能ではないため、等しいかどうかを超えて安全に比較することはできません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>パッケージリポジトリを作成する</title>
+<screen>$ <userinput>pkgrepo create /my/repository</userinput></screen>
+</example>
+<example><title>情報を表示する</title>
+<para>パブリッシャーのサマリーと、リポジトリ内のパッケージの数を表示します。
+</para>
+<screen>$ <userinput>pkgrepo info -s /my/repository</userinput>
 PUBLISHER   PACKAGES STATUS UPDATED
 example.com 5        online 2011-07-22T18:09:09.769106Z
-$ \fBpkgrepo info -s http://pkg.oracle.com/solaris/release/\fR
+$ <userinput>pkgrepo info -s http://pkg.oracle.com/solaris/release/</userinput>
 PUBLISHER PACKAGES STATUS UPDATED
-solaris   3941     online 2010-11-12T19:24:25.967246Z
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 3 \fRカタログと検索データを再構築する
-.sp
-.LP
-リポジトリのカタログと検索データを再構築します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo rebuild -s /my/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 4 \fRカタログと検索データを再表示する
-.sp
-.LP
-リポジトリのカタログと検索データを再表示します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo refresh -s /my/repository\fR
-$ \fBpkgrepo refresh -s http://example.com/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 5 \fRすべてのリポジトリプロパティーを表示する
-.sp
-.in +2
-.nf
-$ \fBpkgrepo get -s /export/repoSolaris11\fR
+solaris   3941     online 2010-11-12T19:24:25.967246Z</screen>
+</example>
+<example><title>カタログと検索データを再構築する</title>
+<para>リポジトリのカタログと検索データを再構築します。</para>
+<screen>$ <userinput>pkgrepo rebuild -s /my/repository</userinput></screen>
+</example>
+<example><title>カタログと検索データを再表示する</title>
+<para>リポジトリのカタログと検索データを再表示します。</para>
+<screen>$ <userinput>pkgrepo refresh -s /my/repository</userinput>
+$ <userinput>pkgrepo refresh -s http://example.com/repository</userinput></screen>
+</example>
+<example><title>すべてのリポジトリプロパティーを表示する</title>
+<screen>$ <userinput>pkgrepo get -s /export/repoSolaris11</userinput>
 SECTION    PROPERTY    VALUE
 publisher  prefix      solaris
-repository description Local\e copy\e of\e the\e Oracle\e Solaris\e 11\e repository
-repository name        Oracle\e Solaris\e 11
+repository description Local&bsol; copy&bsol; of&bsol; the&bsol; Oracle&bsol; Solaris&bsol; 11&bsol; repository
+repository name        Oracle&bsol; Solaris&bsol; 11
 repository version     4
-$ \fBpkgrepo get -s http://pkg.oracle.com/solaris/release/\fR
+$ <userinput>pkgrepo get -s http://pkg.oracle.com/solaris/release/</userinput>
 SECTION    PROPERTY VALUE
 deployment content  s11_11-11
 deployment pubdate  20111102T222051Z
 publisher  prefix   solaris
-repository version  4
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 6 \fRすべてのパブリッシャープロパティーを表示する
-.sp
-.in +2
-.nf
-$ \fBpkgrepo get -s http://pkg.oracle.com/solaris/release/ -p all\fR
+repository version  4</screen>
+</example>
+<example><title>すべてのパブリッシャープロパティーを表示する</title>
+<screen>$ <userinput>pkgrepo get -s http://pkg.oracle.com/solaris/release/ -p all</userinput>
 PUBLISHER SECTION    PROPERTY         VALUE
 solaris   publisher  alias
 solaris   publisher  prefix           solaris
 solaris   repository collection-type  core
-solaris   repository description      This\e repository\e serves\e the\e Oracle\e
-Solaris\e 11\e Package\e repository.
+solaris   repository description      This&bsol; repository&bsol; serves&bsol; the&bsol; Oracle&bsol;
+Solaris&bsol; 11&bsol; Package&bsol; repository.
 solaris   repository legal-uris       ()
 solaris   repository mirrors          (http://pkg-cdn1.oracle.com/solaris.release/)
-solaris   repository name             Oracle\e Solaris\e 11\e Package\e Repository
+solaris   repository name             Oracle&bsol; Solaris&bsol; 11&bsol; Package&bsol; Repository
 solaris   repository origins          ()
 solaris   repository refresh-seconds
 solaris   repository registration-uri ""
-solaris   repository related-uris     ()
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 7 \fRデフォルトのパブリッシャーを設定する
-.sp
-.in +2
-.nf
-$ \fBpkgrepo set -s /my/repository publisher/prefix=example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 8 \fRパブリッシャープロパティーを設定する
-.sp
-.in +2
-.nf
-$ \fBpkgrepo set -s /my/repository -p example.com \e\fR
-\fBrepository/origins=http://example.com/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 9 \fR新しいパブリッシャーをリポジトリに追加する
-.sp
-.in +2
-.nf
-$ \fBpkgrepo add-publisher -s /my/repository example.com\fR
-.fi
-.in -2
-.sp
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-複数の操作が要求されましたが、それらの一部のみが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB4\fR\fR
-.ad
-.RS 6n
-.rt  
-変更は行われませんでした。処理がありません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(1), \fBpkgrecv\fR(1), \fBpkgsend\fR(1), \fBpkg.depotd\fR(1M), \fBpkg\fR(5)
-.sp
-.LP
-\fI『Copying and Creating Package Repositories in Oracle Solaris 11.2 』\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 注意事項
-.sp
-.LP
-\fBpkgrepo\fR のほとんどの操作は、パッケージアーカイブでは使用できません。パッケージアーカイブは、\fBpkgrecv\fR(1) のマニュアルページの \fB-a\fR オプションで説明されているように、通常は \fB\&.p5p\fR 拡張子を持つファイルです。パッケージアーカイブには、パッケージが含まれていますが、リポジトリ構成は含まれていません。ただし、\fBpkgrepo list\fR、\fBpkgrepo info\fR、および \fBpkgrepo contents\fR コマンドは、パッケージアーカイブに対して動作します。
+solaris   repository related-uris     ()</screen>
+</example>
+<example><title>デフォルトのパブリッシャーを設定する</title>
+<screen>$ <userinput>pkgrepo set -s /my/repository publisher/prefix=example.com</userinput></screen>
+</example>
+<example><title>パブリッシャープロパティーを設定する</title>
+<screen>$ <userinput>pkgrepo set -s /my/repository -p example.com &bsol;</userinput>
+<userinput>repository/origins=http://example.com/repository</userinput></screen>
+</example>
+<example><title>新しいパブリッシャーをリポジトリに追加する</title>
+<screen>$ <userinput>pkgrepo add-publisher -s /my/repository example.com</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>複数の操作が要求されましたが、それらの一部のみが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>4</returnvalue></term>
+<listitem><para>変更は行われませんでした。処理がありません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgrecv-1"><citerefentry><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para><command>pkgrepo</command> のほとんどの操作は、パッケージアーカイブでは使用できません。パッケージアーカイブは、<literal>pkgrecv</literal>(1) のマニュアルページの <option>a</option> オプションで説明されているように、通常は <filename>.p5p</filename> 拡張子を持つファイルです。パッケージアーカイブには、パッケージが含まれていますが、リポジトリ構成は含まれていません。ただし、<command>pkgrepo list</command>、<command>pkgrepo info</command>、および <command>pkgrepo contents</command> コマンドは、パッケージアーカイブに対して動作します。</para>
+</refsect1>
+</refentry>
--- a/src/man/ja_JP/pkgsend.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgsend.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,401 +1,207 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgsend 1 "2013 年 7 月 30 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgsend \- Image Packaging System の公開クライアント
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgsend [\fIoptions\fR] \fIcommand\fR [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgsend generate [-T \fIpattern\fR] [--target \fIfile\fR]
-    \fIsource\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgsend publish [-b \fIbundle\fR]... [-d \fIsource\fR]...
-    [-s \fIrepo_uri_or_path\fR] [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [-T \fIpattern\fR] [--no-catalog] [\fImanifest\fR ...]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkgsend\fR では、パッケージのマニフェストを使用して、新しいパッケージと新しいパッケージのバージョンをイメージパッケージングリポジトリに公開できます。リポジトリを作成または管理するには、\fBpkgrepo\fR(1) を参照してください。既存のリポジトリ内でパッケージからパッケージアーカイブを作成するには、\fBpkgrecv\fR(1) を参照してください。パッケージのマニフェストの詳細は、\fBpkg\fR(5) を参照してください。
-.sp
-.LP
-\fBpkgsend publish\fR 操作のあとで、\fIrepo_uri_or_path\fR リポジトリが \fBpkg search\fR 操作をサポートする必要がある場合は、リポジトリ上で \fBpkgrepo refresh\fR を実行して、検索インデックスを更新してください。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.SH サブコマンド
-.sp
-.LP
-サポートされているサブコマンドは次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgsend generate\fR [\fB-T\fR \fIpattern\fR] [\fB--target\fR \fIfile\fR] \fIsource\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-各 \fIsource\fR (SVR4 パッケージ、ディレクトリ、\fBtar\fR ファイルなど) を読み取り、その \fIsource\fR を\fB標準出力\fRに表示するマニフェストを生成します。出力マニフェストで、\fBfile\fR および \fBdir\fR アクションの所有者は \fBroot\fR に設定され、グループは \fBbin\fR に設定されています。
-.sp
-これで、出力されたマニフェストに注釈を加え、\fBpkgdepend\fR を使用して依存関係を追加または分析し、\fBpkglint\fR を使用してその正当性を検証してから \fBpublish\fR サブコマンドに渡すことができるようになります。
-.sp
-.LP
-サポートされているソースを次に示します。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ファイルシステム形式の SVR4 パッケージ
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-データストリーム形式の SVR4 パッケージ
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBtar\fR ファイル
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ディレクトリ
-.RE
-ソース内のファイルのベース名が \fB-T\fR で指定されたパターンに一致している場合、ファイルのタイムスタンプがそのファイルのアクションに追加されます。\fIpattern\fR は、次のシェルマッチング規則を使用します。
-.sp
-.ne 2
-.mk
-.na
-\fB*\fR
-.ad
-.RS 10n
-.rt  
-すべてと一致します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB?\fR
-.ad
-.RS 10n
-.rt  
-任意の単一文字と一致します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB[\fIseq\fR]\fR
-.ad
-.RS 10n
-.rt  
-\fIseq\fR 内にある任意の文字と一致します。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB![\fIseq\fR]\fR
-.ad
-.RS 10n
-.rt  
-\fIseq\fR 内にない文字と一致します。
-.RE
-
-指定されたソースがディレクトリ内にある場合、単一の i ノードに対して複数のパス名があると、\fBファイル\fRのアクションを \fBハードリンク\fRのアクションと明確に区別できません。通常、ファイルシステム調査で最初に見つかったものがファイルとして扱われ、残りのものがハードリンクとして扱われます。この処理は、ファイルシステムの実装に応じて自由に設定できます。ファイルとして扱うパス名を指定するには、各パス名を引数として \fB--target\fR オプションに渡します。このオプションはほかの種類のソースには影響しません。これは、ソースにはパス名がファイルであるかハードリンクであるかを示す機能があるためです。
-.sp
-SVR4 パッケージがソースとして提供されている場合、\fBpkgsend\fR は、クラスアクションスクリプトを持つファイルが存在せず、プリインストールスクリプト、ポストインストールスクリプト、削除前スクリプト、または削除後スクリプトが存在することを確認します。\fBmanifest\fR クラスを使用してインストールされた SMF マニフェストがある場合、例外が作成されます。\fBBASEDIR\fR は、すべての再配置可能パスから削除されます。
-.sp
-SVR4 \fBDESC\fR パラメータは、\fBpkg.description\fR 値に変換されます。SVR4 \fBNAME\fR パラメータは、\fBpkg.summary\fR 値に変換されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgsend publish\fR [\fB-b\fR \fIbundle\fR]... [\fB-d\fR \fIsource\fR]... [\fB-s\fR \fIrepo_uri_or_path\fR] [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB-T\fR \fIpattern\fR] [\fB--no-catalog\fR] [\fImanifest\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-指定されたパッケージマニフェストを使用するパッケージをターゲットパッケージリポジトリに公開します。これにより、指定されたソースからそのパッケージ用のファイルが取得されます。複数のマニフェストが指定されている場合、それらのマニフェストは指定された順序で追加されます。マニフェストが指定されていない場合は、\fBstdin\fR からマニフェストが読み取られます。
-.sp
-指定しない場合、\fBpkgsend publish\fR はビルドバージョンをパッケージ FMRI に追加します。\fBpublish\fR ツールは、タイムスタンプも (UTC の現在時間) をパッケージ FMRI に追加します。パッケージ FMRI のバージョン文字列については、\fBpkg \fR(5) のマニュアルページを参照してください。
-.sp
-複数の \fBpkgsend publish\fR プロセスが同じ \fB-s\fR リポジトリに同時に公開する場合は、\fB--no-catalog\fR オプションを指定することをお勧めします。下記の \fB--no-catalog\fR オプションの説明を参照してください。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-b\fR \fIbundle\fR\fR
-.ad
-.sp .6
-.RS 4n
-マニフェスト内でファイルを検索するときに、指定されたバンドルを検索するソースの一覧に追加します。バンドルは、tar ファイルや SVR4 パッケージなどのソースです。このオプションが複数回指定されている場合、ソースはコマンド行に表示される順序で検索されます。\fB-b\fR と \fB-d\fR の両方が指定されている場合、\fB-d\fR のソースが最初に検索されます。サポートされているバンドルとその使用方法の詳細は、前述の \fBgenerate\fR サブコマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-マニフェスト内でファイルを検索するときに、指定されたディレクトリを検索するソースの一覧に追加します。このオプションが複数回指定されている場合、ソースはコマンド行に表示される順序で検索されます。サポートされているソースとその使用方法の詳細は、上記の \fBgenerate\fR サブコマンドを参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-特定の URI またはファイルシステムパスに存在しているリポジトリにパッケージが公開されます。公開についての制限事項と推奨事項の詳細は、次の「注意事項」のセクションを参照してください。また、「環境変数」のセクションも参照してください。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB--key\fR オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL キーファイルを指定するために使用します。\fB--cert\fR オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL 証明書ファイルを指定するために使用します。このオプションのペアは複数回指定できます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-パッケージを発行元のカタログに追加しません。パブリッシャーのカタログの更新は連続で実行されるため、複数のパッケージを一度に公開する場合には常にこのオプションを使用することを推奨します。複数のプロセスが同時にパッケージを公開するときは、このオプションを使用しないと、公開のパフォーマンスが大幅に低下する可能性があります。公開の完了後、\fBpkgrepo refresh\fR コマンドを使用してそれぞれのパブリッシャーカタログに新しいパッケージを追加できます。
-.RE
-
-\fB-T\fR オプションの説明については、前述の \fBgenerate\fR サブコマンドを参照してください。
-.RE
-
-.SH 環境
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_REPO\fR\fR
-.ad
-.RS 12n
-.rt  
-公開先リポジトリのパスまたは URI です。
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fRパッケージの生成と公開
-.sp
-.LP
-\fBpkgsend generate\fR を使用してパッケージを作成し、そのパッケージを公開します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend generate /path/to/proto > /path/to/manifests/foo.p5m\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-\fBexample.com\fR パブリッシャーのパッケージ FMRI を、\fBfoo.p5m\fR の先頭に追加します。
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
-.fi
-.in -2
-
-.sp
-.LP
-結果として生成されるマニフェストは、次のようになります。
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
+<refentry lang="ja" id="pkgsend-1">
+<refmeta><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 7 月 30 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgsend</refname><refpurpose>Image Packaging System の公開クライアント</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgsend [<replaceable>options</replaceable>] <replaceable>command</replaceable> [<replaceable>cmd_options</replaceable>] [<replaceable>operands</replaceable>]
+</synopsis>
+<synopsis>/usr/bin/pkgsend generate [-T <replaceable>pattern</replaceable>] [--target <replaceable>file</replaceable>]
+    <replaceable>source</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgsend publish [-b <replaceable>bundle</replaceable>]... [-d <replaceable>source</replaceable>]...
+    [-s <replaceable>repo_uri_or_path</replaceable>] [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [-T <replaceable>pattern</replaceable>] [--no-catalog] [<replaceable>manifest</replaceable> ...]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgsend-1-desc" role="description"><title></title>
+<para><command>pkgsend</command> では、パッケージのマニフェストを使用して、新しいパッケージと新しいパッケージのバージョンをイメージパッケージングリポジトリに公開できます。リポジトリを作成または管理するには、<command>pkgrepo</command>(1) を参照してください。既存のリポジトリ内でパッケージからパッケージアーカイブを作成するには、<command>pkgrecv</command>(1) を参照してください。パッケージのマニフェストの詳細は、<literal>pkg</literal>(5) を参照してください。</para>
+<para><command>pkgsend publish</command> 操作のあとで、<replaceable>repo_uri_or_path</replaceable> リポジトリが <command>pkg search</command> 操作をサポートする必要がある場合は、リポジトリ上で <command>pkgrepo refresh</command> を実行して、検索インデックスを更新してください。</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>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>サポートされているサブコマンドは次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgsend generate</command> [<option>T</option> <replaceable>pattern</replaceable>] [<option>-target</option> <replaceable>file</replaceable>] <replaceable>source</replaceable> ...</term>
+<listitem><para>各 <replaceable>source</replaceable> (SVR4 パッケージ、ディレクトリ、<command>tar</command> ファイルなど) を読み取り、その <replaceable>source</replaceable> を<filename>標準出力</filename>に表示するマニフェストを生成します。
+</para>
+<para>これで、出力されたマニフェストに注釈を加え、<command>pkgdepend</command> を使用して依存関係を追加または分析し、<command>pkglint</command> を使用してその正当性を検証してから <command>publish</command> サブコマンドに渡すことができるようになります。
+</para>
+<itemizedlist>
+<para>サポートされているソースを次に示します。</para>
+<listitem><para>ファイルシステム形式の SVR4 パッケージ</para></listitem>
+<listitem><para>データストリーム形式の SVR4 パッケージ</para></listitem>
+<listitem><para><command>tar</command> ファイル</para></listitem>
+<listitem><para>ディレクトリ</para></listitem>
+</itemizedlist>
+<para>ソース内のファイルのベース名が <option>T</option> で指定されたパターンに一致している場合、ファイルのタイムスタンプがそのファイルのアクションに追加されます。<replaceable>pattern</replaceable> は、次のシェルマッチング規則を使用します。</para>
+<variablelist>
+<varlistentry><term>*</term>
+<listitem><para>すべてと一致します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>?</term>
+<listitem><para>任意の単一文字と一致します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>[<replaceable>seq</replaceable>]</term>
+<listitem><para><replaceable>seq</replaceable> 内にある任意の文字と一致します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>![<replaceable>seq</replaceable>]</term>
+<listitem><para><replaceable>seq</replaceable> 内にない文字と一致します。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>指定されたソースがディレクトリ内にある場合、単一の i ノードに対して複数のパス名があると、<literal>ファイル</literal>のアクションを <literal>ハードリンク</literal>のアクションと明確に区別できません。通常、ファイルシステム調査で最初に見つかったものがファイルとして扱われ、残りのものがハードリンクとして扱われます。この処理は、ファイルシステムの実装に応じて自由に設定できます。ファイルとして扱うパス名を指定するには、各パス名を引数として <option>-target</option> オプションに渡します。このオプションはほかの種類のソースには影響しません。これは、ソースにはパス名がファイルであるかハードリンクであるかを示す機能があるためです。</para>
+<para>SVR4 パッケージがソースとして提供されている場合、<command>pkgsend</command> は、クラスアクションスクリプトを持つファイルが存在せず、プリインストールスクリプト、ポストインストールスクリプト、削除前スクリプト、または削除後スクリプトが存在することを確認します。<literal>manifest</literal> クラスを使用してインストールされた SMF マニフェストがある場合、例外が作成されます。<literal>BASEDIR</literal> は、すべての再配置可能パスから削除されます。</para>
+<para>SVR4 <literal>DESC</literal> パラメータは、<literal>pkg.description</literal> 値に変換されます。SVR4 <literal>NAME</literal> パラメータは、<literal>pkg.summary</literal> 値に変換されます。</para>
+<para>ディレクトリに基づいたマニフェストを生成するとき、デフォルトでは、各ファイルおよびディレクトリの所有者とグループはそれぞれ root と bin になります。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgsend publish</command> [<option>b</option> <replaceable>bundle</replaceable>]... [<option>d</option> <replaceable>source</replaceable>]... [<option>s</option> <replaceable>repo_uri_or_path</replaceable>] [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>T</option> <replaceable>pattern</replaceable>] [<option>-no-catalog</option>] [<replaceable>manifest</replaceable> ...]</term>
+<listitem><para>指定されたパッケージマニフェストを使用するパッケージをターゲットパッケージリポジトリに公開します。これにより、指定されたソースからそのパッケージ用のファイルが取得されます。複数のマニフェストが指定されている場合、それらのマニフェストは指定された順序で追加されます。マニフェストが指定されていない場合は、<literal>stdin</literal> からマニフェストが読み取られます。</para>
+<para>指定しない場合、<command>pkgsend publish</command> はビルドバージョンをパッケージ FMRI に追加します。<command>publish</command> ツールは、タイムスタンプも (UTC の現在時間) をパッケージ FMRI に追加します。パッケージ FMRI のバージョン文字列については、<literal>pkg </literal>(5) のマニュアルページを参照してください。</para>
+<para>複数の <command>pkgsend publish</command> プロセスが同じ <option>s</option> リポジトリに同時に公開する場合は、<option>-no-catalog</option> オプションを指定することをお勧めします。下記の <option>-no-catalog</option> オプションの説明を参照してください。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>b</option> <replaceable>bundle</replaceable></term>
+<listitem><para>マニフェスト内でファイルを検索するときに、指定されたバンドルを検索するソースの一覧に追加します。バンドルは、tar ファイルや SVR4 パッケージなどのソースです。このオプションが複数回指定されている場合、ソースはコマンド行に表示される順序で検索されます。<option>b</option> と <option>d</option> の両方が指定されている場合、<option>d</option> のソースが最初に検索されます。サポートされているバンドルとその使用方法の詳細は、前述の <command>generate</command> サブコマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>source</replaceable></term>
+<listitem><para>マニフェスト内でファイルを検索するときに、指定されたディレクトリを検索するソースの一覧に追加します。このオプションが複数回指定されている場合、ソースはコマンド行に表示される順序で検索されます。サポートされているソースとその使用方法の詳細は、上記の <command>generate</command> サブコマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>特定の URI またはファイルシステムパスに存在しているリポジトリにパッケージが公開されます。公開についての制限事項と推奨事項の詳細は、次の「注意事項」のセクションを参照してください。また、「環境変数」のセクションも参照してください。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para><option>-key</option> オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL キーファイルを指定するために使用します。<option>-cert</option> オプションは、HTTPS リポジトリからのパッケージ取得に使用するクライアント SSL 証明書ファイルを指定するために使用します。このオプションのペアは複数回指定できます。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>パッケージを発行元のカタログに追加しません。パブリッシャーのカタログの更新は連続で実行されるため、複数のパッケージを一度に公開する場合には常にこのオプションを使用することを推奨します。複数のプロセスが同時にパッケージを公開するときは、このオプションを使用しないと、公開のパフォーマンスが大幅に低下する可能性があります。公開の完了後、<command>pkgrepo refresh</command> コマンドを使用してそれぞれのパブリッシャーカタログに新しいパッケージを追加できます。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><option>T</option> オプションの説明については、前述の <command>generate</command> サブコマンドを参照してください。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_REPO</envar></term>
+<listitem><para>公開先リポジトリのパスまたは URI です。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>パッケージの生成と公開</title>
+<para><command>pkgsend generate</command> を使用してパッケージを作成し、そのパッケージを公開します。</para>
+<screen>$ <userinput>pkgsend generate /path/to/proto > /path/to/manifests/foo.p5m</userinput></screen>
+<para><literal>example.com</literal> パブリッシャーのパッケージ FMRI を、<filename>foo.p5m</filename> の先頭に追加します。</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]</programlisting>
+<para>結果として生成されるマニフェストは、次のようになります。</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]
 dir group=sys mode=0755 owner=root path=usr
 dir group=bin mode=0755 owner=root path=usr/bin
-file usr/bin/foo group=bin mode=0555 owner=root path=usr/bin/foo
-.fi
-.in -2
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s http://example.com:10000 -d /path/to/proto \e\fR
-\fB/path/to/manifests/foo.p5m\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fR簡易パッケージの作成と公開
-.sp
-.LP
-次の行を含むパブリッシャー \fBexample.com\fR に対してマニフェストを作成します。
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
-file /exdir/foo mode=0555 owner=root group=bin path=/usr/bin/foo
-.fi
-.in -2
-
-.sp
-.LP
-パッケージを公開します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s http://example.com:10000 -d /exdir\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 3 \fR既存のマニフェストの使用
-.sp
-.LP
-ファイルシステムベースの公開と既存のマニフェストを使用してパッケージを公開します。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s /tmp/example_repo -d /tmp/pkg_files \e\fR
-\fB/tmp/pkg_manifest\fR
-.fi
-.in -2
-.sp
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
+file usr/bin/foo group=bin mode=0555 owner=root path=usr/bin/foo</programlisting>
+<screen>$ <userinput>pkgsend publish -s http://example.com:10000 -d /path/to/proto &bsol;</userinput>
+<userinput>/path/to/manifests/foo.p5m</userinput></screen>
+</example>
+<example><title>簡易パッケージの作成と公開</title>
+<para>次の行を含むパブリッシャー <literal>example.com</literal> に対してマニフェストを作成します。</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]
+file /exdir/foo mode=0555 owner=root group=bin path=/usr/bin/foo</programlisting>
+<para>パッケージを公開します。</para>
+<screen>$ <userinput>pkgsend publish -s http://example.com:10000 -d /exdir</userinput></screen>
+</example>
+<example><title>既存のマニフェストの使用</title>
+<para>ファイルシステムベースの公開と既存のマニフェストを使用してパッケージを公開します。</para>
+<screen>$ <userinput>pkgsend publish -s /tmp/example_repo -d /tmp/pkg_files &bsol;</userinput>
+<userinput>/tmp/pkg_manifest</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgdepend-1"><citerefentry><refentrytitle>pkgdepend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="PKDEV"><citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>公開プロトコルの制限事項により、サイズが 128MB を超えるパッケージファイルを個別に公開する場合には、ファイルシステムベースの公開を使用する必要があります。ファイルシステムベースの公開は、リポジトリのアクセス制御が必要な場合にも推奨されます。</para>
+<para>ファイルシステムベースの公開を使用する場合、公開が完了して Web インタフェースまたは検索応答で変更が反映されたあとに、公開先リポジトリを提供している <command>pkg.depotd</command> プロセスを再開する必要があります。詳細は、<command>pkg.depotd</command>(1M) を参照してください。</para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkgdepend\fR(1), \fBpkgrepo\fR(1), \fBpkg.depotd\fR(1M), \fBpkg\fR(5)
-.sp
-.LP
-\fI『Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2 』\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 注意事項
-.sp
-.LP
-公開プロトコルの制限事項により、サイズが 128MB を超えるパッケージファイルを個別に公開する場合には、ファイルシステムベースの公開を使用する必要があります。ファイルシステムベースの公開は、リポジトリのアクセス制御が必要な場合にも推奨されます。
-.sp
-.LP
-ファイルシステムベースの公開を使用する場合、公開が完了して Web インタフェースまたは検索応答で変更が反映されたあとに、公開先リポジトリを提供している \fBpkg.depotd\fR プロセスを再開する必要があります。詳細は、\fBpkg.depotd\fR(1M) を参照してください。
--- a/src/man/ja_JP/pkgsign.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pkgsign.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,240 +1,145 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgsign 1 "2013 年 5 月 21 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pkgsign \- Image Packaging System の署名ユーティリティー
-.SH 形式
-.LP
-.nf
-/usr/bin/pkgsign [-a \fIhash_algorithm\fR]
-    [-c \fIpath_to_signing_certificate\fR]
-    [-i \fIpath_to_intermediate_cert\fR] ...
-    [-k \fIpath_to_private_key\fR] [-n] -s \fIpath_or_uri\fR
-    [--help] [--no-index] [--no-catalog]
-    (\fIfmri\fR|\fIpattern\fR) ...
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpkgsign\fR は、指定されたキーと証明書を使用して署名アクションを追加することにより、リポジトリ内で所定の FMRI のマニフェストを直接更新します。変更されたパッケージは、元のタイムスタンプを保持します。
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIhash_algorithm\fR\fR
-.ad
-.sp .6
-.RS 4n
-デフォルトの署名アルゴリズムではなく、\fIhash_algorithm\fR 署名アルゴリズムが使用されます。デフォルトの署名アルゴリズムは \fBrsa-sha256\fR です。サポートされている署名アルゴリズムは、\fBrsa-sha256\fR、\fBrsa-sha384\fR、\fBrsa-sha512\fR、\fBsha256\fR、\fBsha384\fR、\fBsha512\fR です。ハッシュアルゴリズムを指定するだけの署名アルゴリズムを使用すると、署名の値は、パッケージのマニフェストのハッシュになります。\fBrsa\fR とハッシュアルゴリズムを指定する署名アルゴリズムを使用すると、署名の値は、提供された非公開鍵で署名が追加されたマニフェストのハッシュになります (\fB-c\fR オプションと \fB-k\fR オプションを参照)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIpath_to_signing_certificate\fR\fR
-.ad
-.sp .6
-.RS 4n
-証明書 \fIpath_to_signing_certificate\fR を、このアクションで署名の値を検証するときに使用する証明書として追加します。\fB-c\fR オプションは、\fB-k\fR オプションでのみ使用されます。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIpath_to_intermediate_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-証明書 \fIpath_to_intermediate_cert\fR を、\fB-c\fR への引数として指定された証明書 \fIpath_to_signing_certificate\fR を検証するときに使用する証明書として追加します。複数の証明書を追加するには、\fB-i\fR を複数回指定します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIpath_to_private_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIpath_to_private_key\fR に格納された非公開鍵を使用してマニフェストに署名を追加します。\fB-k\fR オプションは、\fB-c\fR オプションでのみ使用されます。\fB-k\fR が設定されていない場合、署名の値はマニフェストのハッシュになります。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-評価実行を行い、リポジトリは一切変更しません。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fIpath_or_uri\fR にあるリポジトリ内のパッケージに署名を追加します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-署名付きマニフェストが再公開されたあとに、リポジトリの検索インデックスを更新しません。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-署名付きマニフェストが再公開されたあとに、リポジトリのカタログを更新しません。
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fRマニフェストのハッシュ値を使用した署名の追加
-.sp
-.LP
-マニフェストのハッシュ値を使用して、\fBhttp://localhost:10000\fR に公開されたパッケージに署名を追加します。多くの場合、これはテストに役立ちます。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsign -s http://localhost:10000 -a sha256 \e\fR
-\[email protected],5.11-0:20100626T030108Z\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB例 2 \fRキーと証明書を使用した署名の追加
-.sp
-.LP
-\fBrsa-sha384\fR を使用して、\fB/foo/bar\fR 内のファイルリポジトリに公開されたパッケージに署名を追加し、マニフェストをハッシュ化して署名を追加します。署名キーは \fB/key/usr2.key\fR に、関連の証明書は \fB/key/usr2.cert\fR に、その証明書の検証に必要な証明書は \fB/icerts/usr1.cert\fR にあります。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsign -s file:///foo/bar/ -a rsa-sha384 \e\fR
-\fB-k /key/usr2.key -c /key/usr2.cert -i /icerts/usr1.cert \e\fR
-\[email protected],5.11-0:20100626T031341Z\fR
-.fi
-.in -2
-.sp
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-コマンドが成功しました。
-.RE
+<refentry lang="ja" id="pkgsign-1">
+<refmeta><refentrytitle>pkgsign</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgsign</refname><refpurpose>Image Packaging System の署名ユーティリティー</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgsign [-a <replaceable>hash_algorithm</replaceable>]
+    [-c <replaceable>path_to_signing_certificate</replaceable>]
+    [-i <replaceable>path_to_intermediate_cert</replaceable>] ...
+    [-k <replaceable>path_to_private_key</replaceable>] [-n] -s <replaceable>path_or_uri
+</replaceable>
+    [--help] [--no-index] [--no-catalog]
+    (<replaceable>fmri</replaceable>|<replaceable>pattern</replaceable>) ...</synopsis></refsynopsisdiv>
+<refsect1 id="pkgsign-1-desc" role="description"><title></title>
+<para><command>pkgsign</command> は、指定されたキーと証明書を使用して署名アクションを追加することにより、リポジトリ内で所定の FMRI のマニフェストを直接更新します。変更されたパッケージは、元のタイムスタンプを保持します。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>サポートしているオプションは、次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-help</option></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option> <replaceable>hash_algorithm</replaceable></term>
+<listitem><para>デフォルトの署名アルゴリズムではなく、<replaceable>hash_algorithm</replaceable> 署名アルゴリズムが使用されます。デフォルトの署名アルゴリズムは <literal>rsa-sha256</literal> です。サポートされている署名アルゴリズムは、<literal>rsa-sha256</literal>、<literal>rsa-sha384</literal>、<literal>rsa-sha512</literal>、<literal>sha256</literal>、<literal>sha384</literal>、<literal>sha512</literal> です。ハッシュアルゴリズムを指定するだけの署名アルゴリズムを使用すると、署名の値は、パッケージのマニフェストのハッシュになります。<literal>rsa</literal> とハッシュアルゴリズムを指定する署名アルゴリズムを使用すると、署名の値は、提供された非公開鍵で署名が追加されたマニフェストのハッシュになります (<option>c</option> オプションと <option>k</option> オプションを参照)。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>path_to_signing_certificate</replaceable></term>
+<listitem><para>証明書 <replaceable>path_to_signing_certificate</replaceable> を、このアクションで署名の値を検証するときに使用する証明書として追加します。<option>c</option> オプションは、<option>k</option> オプションでのみ使用されます。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>path_to_intermediate_cert</replaceable></term>
+<listitem><para>証明書 <replaceable>path_to_intermediate_cert</replaceable> を、<option>c</option> への引数として指定された証明書 <replaceable>path_to_signing_certificate</replaceable> を検証するときに使用する証明書として追加します。複数の証明書を追加するには、<option>i</option> を複数回指定します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>path_to_private_key</replaceable></term>
+<listitem><para><replaceable>path_to_private_key</replaceable> に格納された非公開鍵を使用してマニフェストに署名を追加します。<option>k</option> オプションは、<option>c</option> オプションでのみ使用されます。<option>k</option> が設定されていない場合、署名の値はマニフェストのハッシュになります。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>評価実行を行い、リポジトリは一切変更しません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>path_or_uri</replaceable></term>
+<listitem><para><replaceable>path_or_uri</replaceable> にあるリポジトリ内のパッケージに署名を追加します。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>署名付きマニフェストが再公開されたあとに、リポジトリの検索インデックスを更新しません。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>署名付きマニフェストが再公開されたあとに、リポジトリのカタログを更新しません。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>マニフェストのハッシュ値を使用した署名の追加</title>
+<para>マニフェストのハッシュ値を使用して、<literal>http://localhost:10000</literal> に公開されたパッケージに署名を追加します。多くの場合、これはテストに役立ちます。</para>
+<screen>$ <userinput>pkgsign -s http://localhost:10000 -a sha256 &bsol;</userinput>
+<userinput>[email protected],5.11-0:20100626T030108Z</userinput></screen>
+</example>
+<example><title>キーと証明書を使用した署名の追加</title>
+<para><literal>rsa-sha384</literal> を使用して、<literal>/foo/bar</literal> 内のファイルリポジトリに公開されたパッケージに署名を追加し、マニフェストをハッシュ化して署名を追加します。署名キーは <literal>/key/usr2.key</literal> に、関連の証明書は <literal>/key/usr2.cert</literal> に、その証明書の検証に必要な証明書は <literal>/icerts/usr1.cert</literal> にあります。</para>
+<screen>$ <userinput>pkgsign -s file:///foo/bar/ -a rsa-sha384 &bsol;</userinput>
+<userinput>-k /key/usr2.key -c /key/usr2.cert -i /icerts/usr1.cert &bsol;</userinput>
+<userinput>[email protected],5.11-0:20100626T031341Z</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>コマンドが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>複数の操作が要求されましたが、それらの一部のみが成功しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>予期しない例外が発生しました。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgrecv-1"><citerefentry><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-複数の操作が要求されましたが、それらの一部のみが成功しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-予期しない例外が発生しました。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpkg\fR(1), \fBpkgrecv\fR(1), \fBpkgsend\fR(1), \fBpkgrepo\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/ja_JP/pm-updatemanager.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/ja_JP/pm-updatemanager.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,176 +1,111 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pm-updatemanager 1 "2013 年 5 月 21 日" "SunOS 5.11" "ユーザーコマンド"
-.SH 名前
-pm-updatemanager \- パッケージを更新するためのアプリケーション
-.SH 形式
-.LP
-.nf
-/usr/bin/pm-updatemanager [\fIoptions\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pm-updatemanager [-h | --help] [-d | --debug]
-    [-R \fIdir\fR | --image-dir \fIdir\fR]
-.fi
-
-.SH 機能説明
-.sp
-.LP
-\fBpm-updatemanager\fR は、システムにインストールされたパッケージで利用可能な更新の有無を確認し、インストールします。
-.LP
-注 - 
-.sp
-.RS 2
-\fBpackage/pkg\fR、\fBpackage/pkg/package-manager\fR、または \fBpackage/pkg/update-manager\fR パッケージを更新する必要がある場合、\fBpm-updatemanager\fR は、最初にこれらのパッケージを更新してから、残りの更新の実行を再開します。
-.RE
-.SH オプション
-.sp
-.LP
-サポートしているオプションは、次のとおりです。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用方法に関するメッセージを表示します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.br
-.na
-\fB\fB--debug\fR\fR
-.ad
-.sp .6
-.RS 4n
-デバッグモードで \fBpm-updatemanager\fR を実行します。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.br
-.na
-\fB\fB--image-dir\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-自動的に検出されたイメージではなく、\fIdir\fR をルートとするイメージに対して処理を行います。
-.RE
-
-.SH 使用例
-.LP
-\fB例 1 \fR現在のイメージの更新
-.sp
-.LP
-現在のイメージ上で \fBpm-updatemanager\fR を呼び出します。現在のイメージにインストールされたパッケージで利用可能なすべての更新の有無を確認し、インストールします。
+<?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="pm-updatemanager-1">
+<!-- %Z%%M% %I% %E% SMI; -->
+<refmeta><refentrytitle>pm-updatemanager</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo> 
+</refmeta>
+<refnamediv>
+<refname>pm-updatemanager</refname><refpurpose>パッケージを更新するためのアプリケーション</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pm-updatemanager [<replaceable>options</replaceable>]</synopsis>
+<synopsis>/usr/bin/pm-updatemanager [-h | --help] [-d | --debug]
+    [-R <replaceable>dir</replaceable> | --image-dir <replaceable>dir</replaceable>]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pm-updatemanager-1-desc" role="description"><title></title>
+<para><command>pm-updatemanager</command> は、システムにインストールされたパッケージで利用可能な更新の有無を確認し、インストールします。</para>
+<note><para><literal>package/pkg</literal>、<literal>package/pkg/package-manager</literal>、または <literal>package/pkg/update-manager</literal> パッケージを更新する必要がある場合、<command>pm-updatemanager</command> は、最初にこれらのパッケージを更新してから、残りの更新の実行を再開します。</para></note>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>サポートしているオプションは、次のとおりです。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>使用方法に関するメッセージを表示します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term><term><option>-debug</option></term>
+<listitem><para>デバッグモードで <command>pm-updatemanager</command> を実行します。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term> <term><option>-image-dir</option> <replaceable>dir</replaceable></term>
+<listitem><para>自動的に検出されたイメージではなく、<replaceable>dir</replaceable> をルートとするイメージに対して処理を行います。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>現在のイメージの更新</title>
+<para>現在のイメージ上で <command>pm-updatemanager</command> を呼び出します。現在のイメージにインストールされたパッケージで利用可能なすべての更新の有無を確認し、インストールします。</para>
+<screen>$ <userinput>/usr/lib/pm-launch pm-updatemanager</userinput></screen>
+<para>これは、デスクトップのメニューオプションで「システム」&#62;「管理」&#62;「Update Manager」を選択したときに呼び出されるコマンドと同じです。</para>
+</example>
+<example><title>指定されたイメージの更新</title>
+<para><literal>/aux0/example_root</literal> に格納されている <command>pm-updatemanager</command> を呼び出します。</para>
+<screen>$ <userinput>/usr/lib/pm-launch pm-updatemanager -R /aux0/example_root</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>次の終了ステータスが返されます。</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>すべてが動作しました。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>エラーが発生した。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>無効なコマンド行オプションが指定された。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>次の属性については、<literal>attributes</literal>(5) を参照してください。</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性タイプ</para>
+</entry>
+<entry align="center">
+<para>属性値</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>使用条件</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg/update-manager</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>インタフェースの安定性</para>
+</entry>
+<entry align="left">
+<para>不確実</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="packagemanager-1"><citerefentry><refentrytitle>packagemanager</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>所有権がないイメージに対して処理を行う場合、必要な権限を使用して <command>pm-updatemanager</command> を呼び出す必要があります。通常、このような状況では、<literal>/usr/lib/pm-launch</literal> を使用して <command>pm-updatemanager</command> を呼び出します。
+</para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-$ \fB/usr/lib/pm-launch pm-updatemanager\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-これは、デスクトップのメニューオプションで「システム」>「管理」>「Update Manager」を選択したときに呼び出されるコマンドと同じです。
-
-.LP
-\fB例 2 \fR指定されたイメージの更新
-.sp
-.LP
-\fB/aux0/example_root\fR に格納されている \fBpm-updatemanager\fR を呼び出します。
-
-.sp
-.in +2
-.nf
-$ \fB/usr/lib/pm-launch pm-updatemanager -R /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.SH 終了ステータス
-.sp
-.LP
-次の終了ステータスが返されます。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 5n
-.rt  
-すべてが動作しました。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 5n
-.rt  
-エラーが発生した。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 5n
-.rt  
-無効なコマンド行オプションが指定された。
-.RE
-
-.SH 属性
-.sp
-.LP
-次の属性については、\fBattributes\fR(5) を参照してください。
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性タイプ属性値
-_
-使用条件\fBpackage/pkg/update-manager\fR
-_
-インタフェースの安定性不確実
-.TE
-
-.SH 関連項目
-.sp
-.LP
-\fBpackagemanager\fR(1), \fBpkg\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 注意事項
-.sp
-.LP
-所有権がないイメージに対して処理を行う場合、必要な権限を使用して \fBpm-updatemanager\fR を呼び出す必要があります。通常、このような状況では、\fB/usr/lib/pm-launch\fR を使用して \fBpm-updatemanager\fR を呼び出します。
--- a/src/man/packagemanager.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/packagemanager.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,288 +1,186 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH packagemanager 1 "21 May 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-packagemanager \- GUI for the Image Packaging System
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/packagemanager [\fIoptions\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/packagemanager [-h | --help]
-    [-i | --info-install \fIfile\fR] [-U | --update-all]
-    [-R | --image-dir \fIdir\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/packagemanager [\fIfile\fR]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpackagemanager\fR is the graphical user interface for \fBpkg\fR(5), the Image Packaging System software.
-.sp
-.LP
-The Package Manager enables you to perform the following tasks:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Search, install, and remove packages.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Add, remove, and modify publishers.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Create, remove, and manage boot environments.
-.RE
-.sp
-.LP
-If the \fIfile\fR operand is specified and its suffix is \fB\&.p5i\fR, \fBpackagemanager\fR launches in Web Install mode, which adds one or more publishers and a number of packages for each publisher.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIfile\fR\fR
-.ad
-.br
-.na
-\fB\fB--info-install\fR \fIfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a \fB\&.p5i\fR file to run \fBpackagemanager\fR in Web Install mode. The \fIfile\fR must have the suffix \fB\&.p5i\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.br
-.na
-\fB\fB--image-dir\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the image rooted at \fIdir\fR, rather than the image discovered automatically.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-U\fR\fR
-.ad
-.br
-.na
-\fB\fB--update-all\fR\fR
-.ad
-.sp .6
-.RS 4n
-Update all installed packages that have updates available.
-.LP
-Note - 
-.sp
-.RS 2
-If the \fBpackage/pkg\fR, \fBpackage/pkg/package-manager\fR, or \fBpackage/pkg/update-manager\fR packages need to be updated, \fBpackagemanager\fR first updates these packages and then restarts to carry out any remaining updates.
-.RE
-.RE
-
-.SH OPERANDS
-.sp
-.ne 2
-.mk
-.na
-\fB\fIfile\fR\fR
-.ad
-.RS 8n
-.rt  
-A Web Install file. This file must have the suffix \fB\&.p5i\fR. See the Package Manager online help for more information about Web Install.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fROperate on the Current Image
-.sp
-.LP
-Invoke \fBpackagemanager\fR on the current image.
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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 id="packagemanager-1">
+<!-- %Z%%M% %I% %E% SMI; -->
+<refmeta><refentrytitle>packagemanager</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">21 May 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its
+affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>packagemanager</refname><refpurpose>GUI for the Image Packaging System</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/packagemanager [<replaceable>options</replaceable>]</synopsis>
+<synopsis>/usr/bin/packagemanager [-h | --help]
+    [-i | --info-install <replaceable>file</replaceable>] [-U | --update-all]
+    [-R | --image-dir <replaceable>dir</replaceable>]</synopsis>
+<synopsis>/usr/bin/packagemanager [<replaceable>file</replaceable>]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="packagemanager-1-desc" role="description"><title></title>
+<para><command>packagemanager</command> is the graphical user interface for <literal>
+pkg</literal>(5), the Image Packaging System software.</para>
+<itemizedlist>
+<para>The Package Manager enables you to perform the following tasks:</para>
+<listitem><para>Search, install, and remove packages.</para></listitem>
+<listitem><para>Add, remove, and modify publishers.</para></listitem>
+<listitem><para>Create, remove, and manage boot environments.</para></listitem>
+</itemizedlist>
+<para>If the <replaceable>file</replaceable> operand is specified and its
+suffix is <literal>.p5i</literal>, <command>packagemanager</command> launches
+in Web Install mode, which adds one or more publishers and a number of packages
+for each publisher.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>file</replaceable></term>
+<term><option>-info-install</option> <replaceable>file</replaceable></term>
+<listitem><para>Specify a <literal>.p5i</literal> file to run <command>packagemanager
+</command> in Web Install mode. The <replaceable>file</replaceable> must have
+the suffix <literal>.p5i</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term>
+<term><option>-image-dir</option> <replaceable>dir</replaceable></term>
+<listitem><para>Operate on the image rooted at <replaceable>dir</replaceable>,
+rather than the image discovered automatically.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>U</option></term><term><option>-update-all</option></term>
+<listitem><para>Update all installed packages that have updates available.</para>
+<note><para>If the <literal>package/pkg</literal>, <literal>package/pkg/package-manager
+</literal>, or <literal>package/pkg/update-manager</literal> packages need
+to be updated, <command>packagemanager</command> first updates these packages
+and then restarts to carry out any remaining updates.</para></note>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="operands"><title></title>
+<variablelist>
+<varlistentry><term><replaceable>file</replaceable></term>
+<listitem><para>A Web Install file. This file must have the suffix <literal>.p5i</literal>.
+See the Package Manager online help for more information about Web Install.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Operate on the Current Image</title>
+<para>Invoke <command>packagemanager</command> on the current image.</para>
+<screen>$ <userinput>packagemanager</userinput></screen>
+</example>
+<example><title>Operate on a Specified Image</title>
+<para>Invoke <command>packagemanager</command> in the image stored at <filename>/aux0/example_root
+</filename>.</para>
+<screen>$ <userinput>packagemanager -R /aux0/example_root</userinput></screen>
+</example>
+<example><title>Invoke in Web Install Mode</title>
+<para>Invoke <command>packagemanager</command> in Web Install mode.</para>
+<screen>$ <userinput>packagemanager ~/test.p5i</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Everything worked.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para>Since <literal>pkg</literal>(5) images can be located arbitrarily within
+a larger file system, the token <envar>$IMAGE_ROOT</envar> is used to distinguish
+relative paths. For a typical system installation, <envar>$IMAGE_ROOT</envar> is
+equivalent to /.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>Metadata directory for a full or partial image.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>Metadata directory for a user image.</para>
+<para>Within the metadata of a particular image, certain files and directories
+contain information useful during repair and recovery. The token <envar>$IMAGE_META
+</envar> is used to refer to the top-level directory that contains the metadata. <envar>
+$IMAGE_META</envar> is typically one of the two paths given above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/gui-cache</filename></term>
+<listitem><para>Location for cached metadata maintained by <command>packagemanager
+</command> to speed up program startup and switching between publishers.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Other paths within the <envar>$IMAGE_META</envar> directory hierarchy
+are Private, and are subject to change.</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg/package-manager</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pm-updatemanager-1"><citerefentry><refentrytitle>pm-updatemanager</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para>Package Manager online help</para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para><command>packagemanager</command> needs to be invoked with sufficient
+privilege to operate on an image's files and directories.</para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-$ \fBpackagemanager\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fROperate on a Specified Image
-.sp
-.LP
-Invoke \fBpackagemanager\fR in the image stored at \fB/aux0/example_root\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpackagemanager -R /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 3 \fRInvoke in Web Install Mode
-.sp
-.LP
-Invoke \fBpackagemanager\fR in Web Install mode.
-
-.sp
-.in +2
-.nf
-$ \fBpackagemanager ~/test.p5i\fR
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 5n
-.rt  
-Everything worked.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 5n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 5n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.SH FILES
-.sp
-.LP
-Since \fBpkg\fR(5) images can be located arbitrarily within a larger file system, the token \fB$IMAGE_ROOT\fR is used to distinguish relative paths. For a typical system installation, \fB$IMAGE_ROOT\fR is equivalent to /.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-Metadata directory for a full or partial image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-Metadata directory for a user image.
-.sp
-Within the metadata of a particular image, certain files and directories contain information useful during repair and recovery. The token \fB$IMAGE_META\fR is used to refer to the top-level directory that contains the metadata. \fB$IMAGE_META\fR is typically one of the two paths given above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/gui-cache\fR\fR
-.ad
-.sp .6
-.RS 4n
-Location for cached metadata maintained by \fBpackagemanager\fR to speed up program startup and switching between publishers.
-.RE
-
-.sp
-.LP
-Other paths within the \fB$IMAGE_META\fR directory hierarchy are Private, and are subject to change.
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg/package-manager\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpm-updatemanager\fR(1), \fBpkg\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-Package Manager online help
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH NOTES
-.sp
-.LP
-\fBpackagemanager\fR needs to be invoked with sufficient privilege to operate on an image's files and directories.
--- a/src/man/pkg.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkg.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,3349 +1,1972 @@
-'\" te
-.\" Copyright (c) 2007, 2015, Oracle and/or its affiliates. All rights reserved.
-.TH pkg 1 "07 Apr 2014" "SunOS 5.11" "User Commands"
-.SH NAME
-pkg \- Image Packaging System retrieval client
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkg [\fIoptions\fR] command [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.LP
-.nf
-/usr/bin/pkg refresh [-q] [--full] [\fIpublisher\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg install [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+<refentry id="pkg-1">
+<refmeta><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">22 Apr 2015</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg</refname><refpurpose>Image Packaging System retrieval client</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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg exact-install [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...  \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg uninstall [-nvq] [-C \fIn\fR]
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg update [-fnvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg list [-Hafnqsuv] [-g \fIpath_or_uri\fR]...
-    [--no-refresh] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg info [-lqr] [-g \fIpath_or_uri\fR]... [--license]
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg contents [-Hmr] [-a \fIattribute\fR=\fIpattern\fR]...
-    [-g \fIpath_or_uri\fR]... [-o \fIattribute\fR[,\fIattribute\fR]...]...
-    [-s \fIsort_key\fR] [-t \fIaction_name\fR[,\fIaction_name\fR]...]...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg search [-HIaflpr]
-    [-o \fIattribute\fR[,\fIattribute\fR]...]... [-s \fIrepo_uri\fR] \fIquery\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg verify [-Hqv] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg fix [-Hnvq] [--no-be-activate]
+    [--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 verify [-Hqv] [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkg fix [-Hnvq] [--no-be-activate]
     [--no-backup-be | --require-backup-be]
-    [--backup-be-name \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--accept] [--licenses] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg revert [-nv] [--no-be-activate]
+    [--backup-be-name <replaceable>name</replaceable>]
+    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]
+    [--accept] [--licenses] [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkg revert [-nv] [--no-be-activate]
     [--no-backup-be | --require-backup-be]
-    [--backup-be-name \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    (--tagged \fItag-name\fR ... | \fIpath-to-file\fR ...)
-.fi
-
-.LP
-.nf
-/usr/bin/pkg mediator [-aH] [-F \fIformat\fR] [\fImediator\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-mediator [-nv] [-I \fIimplementation\fR]
-    [-V \fIversion\fR] [--no-be-activate]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    \fImediator\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-mediator [-nvIV] [--no-be-activate]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    \fImediator\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg variant [-Haiv] [-F \fIformat\fR] [\fIvariant_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg change-variant [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIvariant_name\fR=\fIvalue\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg facet [-Haim] [-F \fIformat\fR] [\fIfacet_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg change-facet [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIfacet_name\fR=(True|False|None) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg avoid [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unavoid [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg freeze [-n] [-c \fIreason\fR] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unfreeze [-n] [\fIpkg_name_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg property [-H] [\fIpropname\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-property \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg add-property-value \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg remove-property-value \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-property \fIpropname\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg publisher [-HPn] [-F \fIformat\fR] [\fIpublisher\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-publisher [-Ped] [-c \fIssl_cert\fR] [-k \fIssl_key\fR]
-    [-g \fIorigin_to_add\fR | --add-origin \fIorigin_to_add\fR]...
-    [-G \fIorigin_to_remove\fR | --remove-origin \fIorigin_to_remove\fR]...
-    [-m \fImirror_to_add\fR | --add-mirror \fImirror_to_add\fR]...
-    [-M \fImirror_to_remove\fR | --remove-mirror \fImirror_to_remove\fR]...
+    [--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 \fIpublisher\fR]
-    [--search-before \fIpublisher\fR] [--search-first]
-    [--approve-ca-cert \fIpath_to_CA\fR]
-    [--revoke-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--unset-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--add-property-value \fIname_of_property\fR=\fIvalue_to_add\fR]
-    [--remove-property-value \fIname_of_property\fR=\fIvalue_to_remove\fR]
-    [--unset-property \fIname_of_property_to_delete\fR]
-    [--proxy \fIproxy_to_use\fR] \fIpublisher\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-publisher -p \fIrepo_uri\fR [-Ped]
-    [-c \fIssl_cert\fR] [-k \fIssl_key\fR] [--non-sticky] [--sticky]
-    [--search-after \fIpublisher\fR] [--search-before \fIpublisher\fR]
-    [--search-first] [--approve-ca-cert \fIpath_to_CA\fR]
-    [--revoke-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--unset-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--add-property-value \fIname_of_property\fR=\fIvalue_to_add\fR]
-    [--remove-property-value \fIname_of_property\fR=\fIvalue_to_remove\fR]
-    [--unset-property \fIname_of_property_to_delete\fR]
-    [--proxy \fIproxy_to_use\fR] [\fIpublisher\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-publisher \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg history [-HNl]
-    [-n \fInumber\fR] [-o \fIcolumn\fR[,\fIcolumn\fR]...]...
-    [-t \fItime\fR | \fItime\fR-\fItime\fR[,\fItime\fR | \fItime\fR-\fItime\fR]...]...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg purge-history
-.fi
-
-.LP
-.nf
-/usr/bin/pkg rebuild-index
-.fi
-
-.LP
-.nf
-/usr/bin/pkg update-format
-.fi
-
-.LP
-.nf
-/usr/bin/pkg version
-.fi
-
-.LP
-.nf
-/usr/bin/pkg help
-.fi
-
-.LP
-.nf
-/usr/bin/pkg image-create [-FPUfz] [--force]
+    [--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</synopsis>
+<synopsis>/usr/bin/pkg image-create [-FPUfz] [--force]
     [--full | --partial | --user] [--zone]
-    [-c \fIssl_cert\fR] [-k \fIssl_key\fR]
-    [-g \fIpath_or_uri\fR | --origin \fIpath_or_uri\fR]...
-    [-m \fIuri\fR | --mirror \fIuri\fR]...
-    [--facet \fIfacet_name\fR=(True|False)]... [--no-refresh]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--variant \fIvariant_name\fR=\fIvalue\fR]...
-    [(-p | --publisher) [\fIname\fR=]\fIrepo_uri\fR] \fIdir\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg -R \fIdir\fR dehydrate [-nvq] [-p \fIpublisher\fR]...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg -R \fIdir\fR rehydrate [-nvq] [-p \fIpublisher\fR]...
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkg\fR is the retrieval client for the Image Packaging System. With a valid configuration, \fBpkg\fR can be invoked to create locations for packages to be installed, called images, and install packages into those images. Packages are published by publishers, who can make their packages available at one or more repositories, or in package archives. \fBpkg\fR retrieves packages from a publisher\&'s repository or package archives and installs the packages into an image.
-.sp
-.LP
-Packages can only be installed into file systems that are part of a BE. For example, on a default Oracle Solaris 11 installation, only datasets under \fBrpool/ROOT/\fIBEname\fR/\fR are supported for package operations.
-.sp
-.LP
-A publisher name identifies a person, group of persons, or an organization as the source of one or more packages. To avoid publisher name collisions and help identify the publisher, a best practice is to use a domain name that represents the entity publishing the packages as a publisher name.
-.sp
-.LP
-A repository is a location where clients can publish and retrieve package content (files contained within the package such as programs and documents) and metadata (information about the package such as its name and description). As an example, a publisher named \fBexample.org\fR might have their repository located at the URI \fBhttp://example.org/repository\fR.
-.sp
-.LP
-\fBpkg\fR can also uninstall packages, refresh publisher metadata (such as the list of available packages), validate package installation in an image, and query the image for various tokens. These queries can also be made of \fBpkg\fR(5) repositories.
-.sp
-.LP
-Images can be of three types: full images, capable of providing a complete system; partial images, which are linked to a full image (parent image), but do not provide a complete system on their own; and user images.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the image rooted at \fIdir\fR. If no directory was specified or determined based on environment, the default is /. See the "Environment Variables" section for more information.
-.RE
-
-.SH SUB-COMMANDS
-.sp
-.LP
-The following subcommands are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg refresh\fR [\fB-q\fR] [\fB--full\fR] [\fIpublisher\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Update the client\&'s list of available packages and publisher metadata for all publishers.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Update the client\&'s list of available packages and publisher metadata only for the specified publishers.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-Hide progress messages during the requested operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--full\fR\fR
-.ad
-.sp .6
-.RS 4n
-Force a full retrieval of all publisher metadata, instead of attempting an incremental update, and request that any proxies used during the operation ignore cached data. This option exists for troubleshooting purposes and should not be used on a regular basis.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg install\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Install and update the specified packages to the newest version that match \fIpkg_fmri_pattern\fR allowed by the packages installed in the image. To explicitly request the latest version of a package, use \fBlatest\fR for the version portion of \fIpkg_fmri_pattern\fR. For example, specify \fBvim@latest\fR. The \fIpkg_fmri_pattern\fR pattern can include the \fB?\fR and \fB*\fR characters as \fBglob\fR(3C)-style wildcards to match one or more packages.
-.sp
-Packages are selected based on publisher search order and stickiness. See the \fBpkg publisher\fR and \fBpkg set-publisher\fR commands for information about search order and stickiness. If the \fIpkg_fmri_pattern\fR does not specify the publisher, the first publisher that provides a matching package is used as the installation source. If that publisher does not provide a version of the package that can be installed in this image, then the installation operation fails. Use the \fBpkg list -a\fR command to see which publishers provide a version of the package that can be installed in this image.
-.sp
-If more than one \fIpkg_fmri_pattern\fR is specified, and if any of the specified packages cannot be installed in this image, then none of the specified packages will be installed.
-.sp
-Some configuration files might be renamed or replaced during the installation process. 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 \fBpkg\fR(5) man page.
-.sp
-If a package is on the avoid list, installing it removes it from that list.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-C\fR \fIn\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the number of child images to update in parallel. When recursing into child images (usually installed \fBsolaris\fR branded non-global zones), update at most \fIn\fR child images in parallel. The default number of child images to update in parallel is 1. If \fIn\fR is 0 or a negative number, all child images are updated in parallel. See also \fBPKG_CONCURRENCY\fR in the "Environment Variables" section.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Temporarily add the specified package repository or archive to the list of sources in the image from which to retrieve package data. Repositories that require a client SSL certificate cannot be used with this option. This option can be specified multiple times.
-.sp
-When deciding which version of a package to use, publishers configured in the image, but not found in the specified \fIpath_or_uri\fR sources, take precedence. If the version of the package to be installed is provided by a publisher configured in the image and by a \fIpath_or_uri\fR source, the client retrieves the content for that package from the \fIpath_or_uri\fR sources. After installation or update, any packages provided by publishers not configured in the image are added to the image configuration without an origin. Use the \fBpkg publisher\fR command to see which publishers are configured in the image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run of the operation with no package changes made.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-Hide progress messages during the requested operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-Run this operation in the global zone and also in all installed \fBsolaris\fR branded non-global zones. The effect on the non-global zone is similar to logging into each non-global zone and running the command directly. Without this option, when you run \fBpkg\fR commands in the global zone, non-global zones are modified only to the extent required to keep them compatible with the global zone. With this option, the \fBpkg\fR operation is applied to all installed non-global zones except as limited by the \fB-z\fR and \fB-Z\fR options. Zones that are excluded by the \fB-z\fR and \fB-Z\fR options might still be modified if updates are required to keep them in sync with the global zone.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-z\fR \fIzonename\fR\fR
-.ad
-.sp .6
-.RS 4n
-Run this operation only in the specified non-global zone. The \fB-z\fR option can be specified multiple times. The \fB-z\fR option can only be used with the \fB-r\fR option. The \fB-z\fR option cannot be used with the \fB-Z\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-Z\fR \fIzonename\fR\fR
-.ad
-.sp .6
-.RS 4n
-Run this operation in all non-global zones except for the specified zone. The \fB-Z\fR option can be specified multiple times. The \fB-Z\fR option can only be used with the \fB-r\fR option. The \fB-Z\fR option cannot be used with the \fB-z\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Issue verbose progress messages during the requested operation, and display detailed planning information (such as changing facets, mediators, and variants). This option can be specified multiple times to increase the amount of planning information displayed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-Indicate that you agree to and accept the terms of the licenses of the packages that are updated or installed. If you do not provide this option, and any package licenses require acceptance, the installation operation fails.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--licenses\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display all of the licenses for the packages that are installed or updated as part of this operation. For updated packages, display the license only if the license has changed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not update the search indexes after the operation has completed successfully.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not attempt to contact the repositories for the image\&'s publishers to retrieve the newest list of available packages and other metadata.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-be-activate\fR\fR
-.ad
-.sp .6
-.RS 4n
-If a boot environment is created, do not set it as the active boot environment on the next boot. See the \fBbeadm\fR(1M) man page for more information.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-backup-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not create a backup boot environment.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--require-backup-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-Always create a backup boot environment if a new boot environment will not be created. Without this option, a backup boot environment is created based on image policy. See \fBbe-policy\fR in "Image Properties" below for an explanation of when backup boot environments are created automatically.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--backup-be-name\fR \fIname\fR\fR
-.ad
-.sp .6
-.RS 4n
-Name the created backup boot environment using the given argument. Use of \fB--backup-be-name\fR implies \fB--require-backup-be\fR. See also the \fBbeadm\fR(1M) man page.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--deny-new-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not create a new boot environment. This operation is not performed if a new boot environment is required.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--require-new-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-Always create a new boot environment. Without this option, a boot environment is created based on image policy. See \fBbe-policy\fR in "Image Properties" below for an explanation of when boot environments are created automatically. This option cannot be combined with \fB--require-backup-be\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--be-name\fR \fIname\fR\fR
-.ad
-.sp .6
-.RS 4n
-Rename the newly created boot environment to be the argument given. Use of \fB--be-name\fR implies \fB--require-new-be\fR. See also the \fBbeadm\fR(1M) man page.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--reject\fR \fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Prevent packages with names matching the given pattern from being installed. If matching packages are already installed, they are removed as part of this operation. Rejected packages that are the target of group dependencies are placed on the avoid list. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sync-actuators\fR\fR
-.ad
-.sp .6
-.RS 4n
-Run SMF actuators synchronously. The \fBpkg\fR(1) command will not return until all SMF actuators have finished in the zone in which \fBpkg\fR was invoked (the global zone or a non-global zone).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sync-actuators-timeout\fR \fItimeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-Run SMF actuators synchronously. If the actuators do not finish within the given \fItimeout\fR in seconds, \fBpkg\fR(1) will continue operation and exit with return code 8.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg exact-install\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Install or update the specified packages as if installing onto a bare system. Any previously installed packages that are not specified on the command line and are not a dependency of the specified packages will be removed. This command ignores restrictions to not install packages that are on the avoid list and not update packages that are on the frozen list. Otherwise, this \fBexact-install\fR subcommand behaves the same way that the \fBinstall\fR subcommand behaves. To explicitly request the latest version of a package, use \fBlatest\fR for the version portion of \fIpkg_fmri_pattern\fR. For example, specify \fBvim@latest\fR.
-.sp
-Packages are selected based on publisher search order and stickiness. See the \fBpkg publisher\fR and \fBpkg set-publisher\fR commands for information about search order and stickiness. If the \fIpkg_fmri_pattern\fR does not specify the publisher, the first publisher that provides a matching package is used as the installation source. If that publisher does not provide a version of the package that can be installed in this image, then the installation operation fails. Use the \fBpkg list -a\fR command to see which publishers provide a version of the package that can be installed in this image.
-.sp
-If more than one \fIpkg_fmri_pattern\fR is specified, and if any of the specified packages cannot be installed in this image, then none of the specified packages will be installed.
-.sp
-Some configuration files might be renamed or replaced during the installation process. 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 \fBpkg\fR(5) man page.
-.sp
-If a package is on the avoid list, installing it removes it from that list.
-.sp
-For descriptions of options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg uninstall\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--ignore-missing\fR] [\fB--no-index\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Remove installed packages that match \fIpkg_fmri_pattern\fR.
-.sp
-If a package is the subject of a group dependency, uninstalling it places it on the avoid list. See the \fBavoid\fR subcommand below.
-.sp
-In the command output, note any messages that say a new boot environment has been created. If a new boot environment has been created and activated, that is the environment that is booted by default on next reboot. See the \fBbeadm\fR(1M) man page for information about managing boot environments.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ignore-missing\fR\fR
-.ad
-.sp .6
-.RS 4n
-Ignore packages that are not installed. Using this option prevents \fBpkg uninstall\fR from failing when attempting to uninstall a package that is not currently installed.
-.RE
-
-For all other options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg update\fR [\fB-fnvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--ignore-missing\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Update all packages installed in the current image to the newest version allowed by the constraints imposed on the system by installed packages and publisher configuration.
-.sp
-In the command output, note any messages that say a new boot environment has been created. If a new boot environment has been created and activated, that is the environment that is booted by default on next reboot if you do not specify the \fB--no-be-activate\fR option. See the \fBbeadm\fR(1M) man page for information about managing boot environments.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Update only the specified packages installed in the current image. If asterisk (*) is one of the \fIpkg_fmri_pattern\fR patterns provided, update all packages installed in the current image in the same way as when no \fIpkg_fmri_pattern\fR is provided.
-.sp
-To explicitly request the latest version of a package, use \fBlatest\fR for the version portion of \fIpkg_fmri_pattern\fR. For example, specify \fBvim@latest\fR.
-.sp
-Versions older or newer than what is already installed can be specified to perform in-place downgrades or upgrades of specific packages. Updating specific packages across package rename or obsolete boundaries is not supported.
-.sp
-Any preserved configuration files that are part of packages to be downgraded and that have been changed since the original version was installed are renamed using the extension \fB\&.update\fR. 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 \fBpkg\fR(5) man page.
-.sp
-If more than one \fIpkg_fmri_pattern\fR is specified, and if any of the specified packages cannot be updated in this image, then none of the specified packages will be updated.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not execute the client up-to-date check when updating all installed packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ignore-missing\fR\fR
-.ad
-.sp .6
-.RS 4n
-Ignore packages that are not installed. Using this option prevents \fBpkg update\fR from failing when attempting to update a package that is not currently installed.
-.RE
-
-For all other options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg list\fR [\fB-Hafnqsuv\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--no-refresh\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display a list of all packages installed in the current image, including information such as version and installed state. By default, package variants for a different architecture or zone type are excluded. The usual output is in three columns:
-.sp
-.in +2
-.nf
-NAME (PUBLISHER)       VERSION                IFO
+    [-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> is the retrieval client for the Image Packaging
+System. With a valid configuration, <command>pkg</command> can be invoked
+to create locations for packages to be installed, called images, and install
+packages into those images. Packages are published by publishers, who can
+make their packages available at one or more repositories, or in package
+archives. <command>pkg</command> retrieves packages from a publisher's
+repository or package archives and installs the packages into an image.</para>
+<para>Packages can only be installed into file systems that are part of a BE.
+For example, on a default Oracle Solaris 11 installation, only datasets under
+<filename>rpool/ROOT/<replaceable>BEname</replaceable>/</filename> are supported
+for package operations.</para>
+<para>A publisher name identifies a person, group of persons, or an organization
+as the source of one or more packages. To avoid publisher name collisions
+and help identify the publisher, a best practice is to use a domain name that
+represents the entity publishing the packages as a publisher name.</para>
+<para>A repository is a location where clients can publish and retrieve package
+content (files contained within the package such as programs and documents)
+and metadata (information about the package such as its name and description).
+As an example, a publisher named <literal>example.org</literal> might have
+their repository located at the URI <literal>http://example.org/repository</literal>.</para>
+<para><command>pkg</command> can also uninstall packages, refresh publisher
+metadata (such as the list of available packages), validate package installation
+in an image, and query the image for various tokens. These queries can also
+be made of <literal>pkg</literal>(5) repositories.</para>
+<para>Images can be of three types: full images, capable of providing a complete
+system; partial images, which are linked to a full image (parent image), but
+do not provide a complete system on their own; and user images.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term>
+<listitem><para>Operate on the image rooted at <replaceable>dir</replaceable>.
+If no directory was specified or determined based on environment, the default
+is /. See the &ldquo;Environment Variables&rdquo; section for more information.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>The following subcommands are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkg refresh</command> [<option>q</option>] [<option>
+-full</option>] [<replaceable>publisher</replaceable> ...]</term>
+<listitem><para>Update the client&rsquo;s list of available packages and publisher
+metadata for all publishers.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>publisher</replaceable></term>
+<listitem><para>Update the client&rsquo;s list of available packages and publisher
+metadata only for the specified publishers.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>q</option></term>
+<listitem><para>Hide progress messages during the requested operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-full</option></term>
+<listitem><para>Force a full retrieval of all publisher metadata, instead
+of attempting an incremental update, and request that any proxies used during
+the operation ignore cached data. This option exists for troubleshooting purposes
+and should not be used on a regular basis.</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>Install and update the specified packages to the newest version
+that match <replaceable>pkg_fmri_pattern</replaceable> allowed by the packages
+installed in the image. To explicitly request the latest version of a package,
+use <literal>latest</literal> for the version portion of
+<replaceable>pkg_fmri_pattern</replaceable>. For example, specify
+<literal>vim@latest</literal>. The <replaceable>pkg_fmri_pattern</replaceable>
+pattern can include the <literal>?</literal> and <literal>*</literal>
+characters as <literal>glob</literal>(3C)-style wildcards to match one or more
+packages.</para>
+<para>Packages are selected based on publisher search order and stickiness.
+See the <command>pkg publisher</command> and <command>pkg set-publisher</command> commands
+for information about search order and stickiness. If the <replaceable>pkg_fmri_pattern
+</replaceable> does not specify the publisher, the first publisher that provides
+a matching package is used as the installation source. If that publisher does
+not provide a version of the package that can be installed in this image,
+then the installation operation fails. Use the <command>pkg list -a</command> command
+to see which publishers provide a version of the package that can be installed
+in this image.</para>
+<para>If more than one <replaceable>pkg_fmri_pattern</replaceable> is specified,
+and if any of the specified packages cannot be installed in this image, then
+none of the specified packages will be installed.</para>
+<para>Some configuration files might be renamed or replaced during the installation
+process. For more information about how the package system determines which files
+to preserve, and how they are preserved during package operations, see &ldquo;File
+Actions&rdquo; in the <literal>pkg</literal>(5) man page.</para>
+<para>If a package is on the avoid list, installing it removes it from that
+list.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>C</option> <replaceable>n</replaceable></term>
+<listitem><para>Specify the number of child images to update in parallel. When recursing into child images (usually installed <literal>solaris</literal> branded non-global zones), update at most <replaceable>n</replaceable> child images in parallel. The default number of child images to update in parallel is 1. If <replaceable>n</replaceable> is 0 or a negative number, all child images are updated in parallel. See also <envar>PKG_CONCURRENCY</envar> in the &ldquo;Environment Variables&rdquo; section.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>g</option> <replaceable>path_or_uri</replaceable></term>
+<listitem><para>Temporarily add the specified package repository or archive
+to the list of sources in the image from which to retrieve package data. Repositories
+that require a client SSL certificate cannot be used with this option. This
+option can be specified multiple times.</para>
+<para>When deciding which version of a package to use, publishers configured
+in the image, but not found in the specified <replaceable>path_or_uri</replaceable> sources,
+take precedence. If the version of the package to be installed is provided
+by a publisher configured in the image and by a <replaceable>path_or_uri</replaceable> source,
+the client retrieves the content for that package from the <replaceable>path_or_uri
+</replaceable> sources. After installation or update, any packages provided
+by publishers not configured in the image are added to the image configuration
+without an origin. Use the <command>pkg publisher</command> command to see
+which publishers are configured in the image.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run of the operation with no package changes
+made.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>q</option></term>
+<listitem><para>Hide progress messages during the requested operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>Run this operation in the global zone and also in all installed <literal>solaris</literal> branded non-global zones. The effect on the non-global zone is similar to logging into each non-global zone and running the command directly. Without this option, when you run <literal>pkg</literal> commands in the global zone, non-global zones are modified only to the extent required to keep them compatible with the global zone. With this option, the <literal>pkg</literal> operation is applied to all installed non-global zones except as limited by the <option>z</option> and <option>Z</option> options. Zones that are excluded by the <option>z</option> and <option>Z</option> options might still be modified if updates are required to keep them in sync with the global zone.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>z</option> <replaceable>zonename</replaceable></term>
+<listitem><para>Run this operation only in the specified non-global zone. The <option>z</option> option can be specified multiple times. The <option>z</option> option can only be used with the <option>r</option> option. The <option>z</option> option cannot be used with the <option>Z</option> option.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>Z</option> <replaceable>zonename</replaceable></term>
+<listitem><para>Run this operation in all non-global zones except for the specified zone. The <option>Z</option> option can be specified multiple times. The <option>Z</option> option can only be used with the <option>r</option> option. The <option>Z</option> option cannot be used with the <option>z</option> option.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>Issue verbose progress messages during the requested operation,
+and display detailed planning information (such as changing facets, mediators,
+and variants). This option can be specified multiple times to increase the
+amount of planning information displayed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-accept</option></term>
+<listitem><para>Indicate that you agree to and accept the terms of the licenses
+of the packages that are updated or installed. If you do not provide this
+option, and any package licenses require acceptance, the installation operation
+fails.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-licenses</option></term>
+<listitem><para>Display all of the licenses for the packages that are installed
+or updated as part of this operation. For updated packages, display the license
+only if the license has changed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>Do not update the search indexes after the operation has completed
+successfully.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-refresh</option></term>
+<listitem><para>Do not attempt to contact the repositories for the image&rsquo;s
+publishers to retrieve the newest list of available packages and other metadata.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-be-activate</option></term>
+<listitem><para>If a boot environment is created, do not set it as the active
+boot environment on the next boot. See the <command>beadm</command>(1M) man
+page for more information.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-backup-be</option></term>
+<listitem><para>Do not create a backup boot environment.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-require-backup-be</option></term>
+<listitem><para>Always create a backup boot environment if a new boot environment will not be created. Without this option, a backup boot environment is created based on image policy. See <literal>be-policy</literal> in &ldquo;Image Properties&rdquo; below for an explanation of when backup boot environments are created automatically.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-backup-be-name</option> <replaceable>name</replaceable></term>
+<listitem><para>Name the created backup boot environment using the given argument.
+Use of <option>-backup-be-name</option> implies <option>-require-backup-be</option>.
+See also the <command>beadm</command>(1M) man page.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-deny-new-be</option></term>
+<listitem><para>Do not create a new boot environment. This operation is not
+performed if a new boot environment is required.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-require-new-be</option></term>
+<listitem><para>Always create a new boot environment. Without this option, a boot environment is created based on image policy. See <literal>be-policy</literal> in &ldquo;Image Properties&rdquo; below for an explanation of when boot environments are created automatically. This option cannot be combined with <option>-require-backup-be</option>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-be-name</option> <replaceable>name</replaceable></term>
+<listitem><para>Rename the newly created boot environment to be the argument
+given. Use of <option>-be-name</option> implies <option>-require-new-be</option>.
+See also the <command>beadm</command>(1M) man page.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-reject</option> <replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Prevent packages with names matching the given pattern from
+being installed. If matching packages are already installed, they are removed
+as part of this operation. Rejected packages that are the target of group
+dependencies are placed on the avoid list. This option can be specified multiple
+times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-sync-actuators</option></term>
+<listitem><para>Run SMF actuators synchronously. The <command>pkg</command>(1) command will not return until all SMF actuators have finished in the zone in which <command>pkg</command> was invoked (the global zone or a non-global zone).</para></listitem>
+</varlistentry>
+<varlistentry><term><option>-sync-actuators-timeout</option> <replaceable>timeout</replaceable></term>
+<listitem><para>Run SMF actuators synchronously. If the actuators do not finish within the given <replaceable>timeout</replaceable> in seconds, <command>pkg</command>(1) will continue operation and exit with return code 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>Install or update the specified packages as if installing onto a bare system. Any previously installed packages that are not specified on the command line and are not a dependency of the specified packages will be removed. This command ignores restrictions to not install packages that are on the avoid list and not update packages that are on the frozen list. Otherwise, this <command>exact-install</command> subcommand behaves the same way that the <command>install</command> subcommand behaves. To explicitly request the latest version of a package, use <literal>latest</literal> for the version portion of <replaceable>pkg_fmri_pattern</replaceable>. For example, specify <literal>vim@latest</literal>.</para>
+<para>Packages are selected based on publisher search order and stickiness. See the <command>pkg publisher</command> and <command>pkg set-publisher</command> commands for information about search order and stickiness. If the <replaceable>pkg_fmri_pattern</replaceable> does not specify the publisher, the first publisher that provides a matching package is used as the installation source. If that publisher does not provide a version of the package that can be installed in this image, then the installation operation fails. Use the <command>pkg list -a</command> command to see which publishers provide a version of the package that can be installed in this image.</para>
+<para>If more than one <replaceable>pkg_fmri_pattern</replaceable> is specified, and if any of the specified packages cannot be installed in this image, then none of the specified packages will be installed.</para>
+<para>Some configuration files might be renamed or replaced during the installation process. For more information about how the package system determines which files to preserve, and how they are preserved during package operations, see &ldquo;File Actions&rdquo; in the <literal>pkg</literal>(5) man page.</para>
+<para>If a package is on the avoid list, installing it removes it from that list.</para>
+<para>For descriptions of options, see the <command>install</command> command above.</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>Remove installed packages that match <replaceable>pkg_fmri_pattern
+</replaceable>.</para>
+<para>If a package is the subject of a group dependency, uninstalling it places
+it on the avoid list. See the <command>avoid</command> subcommand below.</para>
+<para>In the command output, note any messages that say a new boot environment has been created. If
+a new boot environment has been created and activated, that is the environment that is booted by
+default on next reboot. See the <command>beadm</command>(1M) man page for information about managing
+boot environments.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-ignore-missing</option></term>
+<listitem><para>Ignore packages that are not installed. Using this option prevents <command>pkg uninstall</command> from failing when attempting to uninstall a package that is not currently installed.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For all other options, see the <command>install</command> command above.</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>Update all packages installed in the current image to the
+newest version allowed by the constraints imposed on the system by installed
+packages and publisher configuration.</para>
+<para>In the command output, note any messages that say a new boot environment
+has been created. If a new boot environment has been created and activated,
+that is the environment that is booted by default on next reboot if you do
+not specify the <option>-no-be-activate</option> option. See the <command>beadm</command>(1M)
+man page for information about managing boot environments.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Update only the specified packages installed in the current
+image. If asterisk (*) is one of the <replaceable>pkg_fmri_pattern</replaceable> patterns
+provided, update all packages installed in the current image in the same way as when no <replaceable>pkg_fmri_pattern</replaceable> is provided.</para>
+<para>To explicitly request the latest version of a package, use <literal>latest</literal> for
+the version portion of <replaceable>pkg_fmri_pattern</replaceable>. For example,
+specify <literal>vim@latest</literal>.</para>
+<para>Versions older or newer than what is already installed can be specified
+to perform in-place downgrades or upgrades of specific packages. Updating
+specific packages across package rename or obsolete boundaries is not supported.</para>
+<para>Any preserved configuration files that are part of packages to be downgraded and that have
+been changed since the original version was installed are renamed using the extension
+<literal>.update</literal>. For more information about how the package system determines which files
+to preserve, and how these files are preserved during package upgrades, see &ldquo;File
+Actions&rdquo; in the <literal>pkg</literal>(5) man page.</para>
+<para>If more than one <replaceable>pkg_fmri_pattern</replaceable> is specified,
+and if any of the specified packages cannot be updated in this image, then
+none of the specified packages will be updated.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>f</option></term>
+<listitem><para>Do not execute the client up-to-date check when updating all
+installed packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ignore-missing</option></term>
+<listitem><para>Ignore packages that are not installed. Using this option prevents <command>pkg update</command> from failing when attempting to update a package that is not currently installed.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For all other options, see the <command>install</command> command above.</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>Display a list of all packages installed in the current image,
+including information such as version and installed state. By default, package
+variants for a different architecture or zone type are excluded. The usual
+output is in three columns:</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--
-.fi
-.in -2
-
-The first column contains the name of the package. If the publisher from which the package is installed (or available, if not installed) is not the first in the publisher search order, then the publisher name is listed in parentheses after the package name. The second column contains the release and branch versions of the package. See the \fBpkg\fR(5) man page for information about release and branch versions and about variants.
-.sp
-.LP
-The last column contains a set of flags that show the status of the package:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-An \fBi\fR in the \fBI\fR column shows that the package is installed.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-An \fBf\fR in the \fBF\fR column shows that the package is frozen.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-An \fBo\fR in the \fBO\fR column shows that the package is obsolete. An \fBr\fR in the \fBO\fR column shows that the package has been renamed (a form of obsoletion).
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-List only the specified packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the listing.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-List installed packages and list the newest version of packages that are not installed but could be installed in this image. Packages can be installed if they are allowed by the installed incorporations and by the image\&'s variants. If one or more patterns are specified, then the newest version matching the specified pattern and allowed by any installed incorporations and the image\&'s variants is listed. Without \fB-a\fR, list only installed packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-af\fR\fR
-.ad
-.sp .6
-.RS 4n
-List all versions of all packages for all variants regardless of incorporation constraints or installed state. To explicitly list the latest version of a package when using these options, use \fBlatest\fR for the version portion of \fIpkg_fmri_pattern\fR. For example, specify \fBvim@latest\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Use the specified package repository or archive as the source of package data for the operation. Repositories that require a client SSL certificate cannot be used with this option. This option can be specified multiple times. Use of \fB-g\fR implies \fB-a\fR if \fB-n\fR is not specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the newest versions of all known packages, regardless of installed state.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not list any packages, but return failure if a fatal error occurs.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a one-line short-form giving the package name and summary. This option can be used with \fB-a\fR, \fB-n\fR, or \fB-u\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-u\fR\fR
-.ad
-.sp .6
-.RS 4n
-List installed packages that have newer versions available. This option cannot be used with \fB-g\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Show full package FMRIs, including publisher and complete version, all in the first column (the VERSION column disappears). This option can be used with \fB-a\fR, \fB-n\fR, or \fB-u\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not attempt to contact the repositories for the image\&'s publishers to retrieve the newest list of available packages.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg info\fR [\fB-lqr\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--license\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display information about all packages installed in the current image in a human-readable form.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display information for only the specified packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Use the specified package repository or archive as the source of package data for the operation. Repositories that require a client SSL certificate cannot be used with this option. This option can be specified multiple times. Use of \fB-g\fR implies \fB-r\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only display information for installed packages. This is the default.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not display any package information, but return failure if a fatal error occurs.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-Match packages based on the newest available versions, retrieving information for packages not currently installed (if necessary) from the repositories of the image\&'s configured publishers. At least one package must be specified when using this option. Without \fB-r\fR, only installed packages are displayed by default.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--license\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the license texts for the packages. This option can be combined with \fB-l\fR, \fB-q\fR, or \fB-r\fR. Return success if all \fIpkg_fmri_pattern\fR patterns match known packages and have licenses. Return failure if one or more patterns are unmatched or match packages that do not have licenses.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg contents\fR [\fB-Hmr\fR] [\fB-a\fR \fIattribute\fR=\fIpattern\fR]... [\fB-g\fR \fIpath_or_uri\fR]... [\fB-o\fR \fIattribute\fR[,\fIattribute\fR]...]... [\fB-s\fR \fIsort_key\fR] [\fB-t\fR \fIaction_name\fR[,\fIaction_name\fR]...]... [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display the contents (action attributes) of all packages installed in the image. With no options, display the value of the \fBpath\fR attribute for actions installed in the current image, sorted alphabetically by attribute value. For information about actions and their attributes, see "Actions" in the \fBpkg\fR(5) man page. See also the list of pseudo attribute names below.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display contents of only the specified packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the output.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIattribute\fR=\fIpattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Limit the output to those actions that have an \fIattribute\fR named in the option argument with a value that matches the (glob) \fIpattern\fR in the option argument. This option can be specified multiple times. If multiple \fB-a\fR options are given, then actions that match any of them are displayed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display information for packages that could be installed in this image from the specified package repository or archive. Repositories that require a client SSL certificate cannot be used with this option. Packages that could be installed include packages that are currently installed and other packages that satisfy criteria for installation in this image, such as variant and facet restrictions. This option can be specified multiple times. Use of \fB-g\fR implies \fB-r\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display all attributes of all actions in the specified packages, including actions that could not be installed in this image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the specified attributes, sorted according to the values of the first attribute listed. The \fB-o\fR option can be specified multiple times, or multiple attributes can be specified as the argument to one \fB-o\fR option by separating the attribute names with commas. Only actions that have the requested attributes are displayed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display information for the newest available versions of packages that could be installed in this image from the repositories of the publishers configured in this image. Packages that could be installed include packages that are currently installed and other packages that satisfy criteria for installation in this image, such as variant and facet restrictions. At least one package must be specified when using this option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIsort_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-Sort actions by the specified action attribute. If not provided, the default is to sort by path or by the first attribute specified by the \fB-o\fR option. The \fB-s\fR option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only list the specified actions. The \fB-t\fR option can be specified multiple times, or multiple actions can be specified as the argument to one \fB-t\fR option by separating the action names with commas. The value of \fIaction_name\fR is one of the actions listed in "Actions" in the \fBpkg\fR(5) man page, such as \fBfile\fR, \fBdirectory\fR, \fBdriver\fR, \fBdepend\fR, \fBset\fR.
-.RE
-
-Several special pseudo attribute names are available for convenience:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.hash\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value of the action\&'s hash, if the action carries a payload.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.key\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value of the action\&'s key attribute. For example, for a \fBfile\fR action, the key attribute is the path to the file. Some actions do not have a key attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.name\fR\fR
-.ad
-.sp .6
-.RS 4n
-The name of the action. For example, for a file action, this is \fBfile\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.raw\fR\fR
-.ad
-.sp .6
-.RS 4n
-All attributes of matching actions.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-The full FMRI of the package containing the action, such as \fBpkg://solaris/group/feature/[email protected],5.11-0.175.0.0.0.2.1:20120705T153434Z\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.name\fR\fR
-.ad
-.sp .6
-.RS 4n
-The name of the package containing the action, such as \fBweb/amp\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-The publisher of the package containing the action, such as \fBsolaris\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.shortfmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-The short form FMRI of the package containing the action, such as \fBpkg://solaris/group/feature/[email protected],5.11-0.175\fR
-.RE
-
-The \fBcontents\fR and \fBsearch\fR subcommands are related: Both query the system for the contents of packages. The \fBcontents\fR subcommand displays actions in one or more installed or installable packages, filtering the output based on the specified options. The \fBsearch\fR subcommand approaches the query from the other direction, displaying the names of all packages that contain a user-supplied token.
-.sp
-Each subcommand is capable of formulating some queries of which the other is capable. Care should be taken in choosing the subcommand, as a given query can be more naturally formulated in one than in the other.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg search\fR [\fB-HIaflpr\fR] [\fB-o\fR \fIattribute\fR[,\fIattribute\fR]...]... [\fB-s\fR \fIrepo_uri\fR] \fIquery\fR\fR
-.ad
-.sp .6
-.RS 4n
-Search for actions that match \fIquery\fR, and display the matching search index, action name, action value, and package name. See the description of \fIquery\fR below. Some searches might yield duplicate results.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the output.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-Use a case-sensitive search.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform the search and display information about the matching actions. This is the default.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.sp .6
-.RS 4n
-Show all results, regardless of package version. By default, \fBsearch\fR prunes results from packages older than the currently installed version and from package versions excluded by current incorporations.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-Search the image\&'s installed packages.
-.sp
-Both \fB-l\fR and \fB-r\fR (or \fB-s\fR) can be specified together, in which case both local and remote searches are performed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the columns to include in the output. The \fB-o\fR option can be specified multiple times, or multiple attributes can be specified as the argument to one \fB-o\fR option by separating the attribute names with commas. In addition to the pseudo attributes outlined above, the following attributes are defined for search results. These attributes help show why a particular result was a match:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsearch.match\fR\fR
-.ad
-.sp .6
-.RS 4n
-The string that matched the search query.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsearch.match_type\fR\fR
-.ad
-.sp .6
-.RS 4n
-The attribute that contained the string that matched the search query.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display packages that have some actions that match each query term. Using this option is equivalent to putting angle brackets (\fB<>\fR) around each term in the query. See \fIquery\fR below for more description of the \fB<>\fR operator.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-Search the repositories corresponding to the image\&'s publishers. This is the default.
-.sp
-Both \fB-l\fR and \fB-r\fR (or \fB-s\fR) can be specified together, in which case both local and remote searches are performed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Search the \fBpkg\fR(5) repository located at the given URI. This can be specified multiple times. Package archives are not supported.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIquery\fR\fR
-.ad
-.sp .6
-.RS 4n
-By default, \fIquery\fR is interpreted as a series of terms to be matched exactly and multiple terms are ANDed.
-.sp
-AND and OR are supported.
-.sp
-The \fB?\fR and \fB*\fR characters can be used as \fBglob\fR(3C)\(hystyle wildcards, allowing more flexible query matches.
-.sp
-In addition to simple token matching and wildcard search, a more complicated query language is supported. Phrases can be searched for by using single or double quotation marks (\fB\&'\fR or \fB"\fR). Be sure to take your shell into account so that \fBpkg\fR actually sees the \fB\&'\fR or \fB"\fR.
-.sp
-Which tokens are indexed is action-dependent, but can include content hashes and path names. For information about actions and their attributes, see "Actions" in the \fBpkg\fR(5) man page. See also the list of pseudo attribute names in \fBpkg contents\fR and \fB-o\fR above.
-.sp
-Structured queries are supported with the following syntax:
-.sp
-.in +2
-.nf
-\fIpkg_name\fR:\fIaction_name\fR:\fIindex\fR:\fItoken\fR
-.fi
-.in -2
-
-The value of \fIaction_name\fR is one of the actions listed in "Actions" in the \fBpkg\fR(5) man page. The \fIindex\fR is an attribute of the action. The value of \fIindex\fR must match \fItoken\fR.
-.sp
-Not all action attributes are searchable. For example, \fBmode\fR is an attribute of the \fBfile\fR action, but \fBmode\fR is not a valid value for \fIindex\fR.
-.sp
-Some values for \fIindex\fR are not action attributes but are values derived from other attributes. For example, \fIindex\fR can be \fBbasename\fR, which is not an attribute of any action but is derived from the \fBpath\fR attribute of the \fBfile\fR or \fBdir\fR action by taking the last component of the path.
-.sp
-Different action types have different valid values for \fIindex\fR. This documentation does not list all possible values. Some of the more useful \fIindex\fR values are \fBbasename\fR and \fBpath\fR for file system actions, the dependency type (for example, \fBrequire\fR, \fBoptional\fR, \fBgroup\fR) for \fBdepend\fR actions, and \fBdriver_name\fR and \fBalias\fR for \fBdriver\fR actions.
-.sp
-One special value for \fIindex\fR is the value of a \fBname\fR attribute for a \fBset\fR action. In this case, \fItoken\fR is matched against the value of the \fBvalue\fR attribute that corresponds to the specified \fBname\fR attribute. For example, the following search finds packages that are classified as either Development/Databases or System/Databases. In the "Examples" section, see the example of finding SMF services.
-.sp
-.in +2
-.nf
-$ \fBpkg search info.classification:databases\fR
-.fi
-.in -2
-.sp
-
-Missing fields in a structured query are implicitly wildcarded. A search for \fBbasename:pkg\fR matches all actions in all packages that have an \fIindex\fR of \fBbasename\fR and that match the \fItoken\fR \fBpkg\fR, as shown in the following partial output:
-.sp
-.in +2
-.nf
-$ \fBpkg search basename:pkg\fR
+x11/wm/fvwm (fvwm.org) 2.6.5                  i--</programlisting>
+<para>The first column contains the name of the package. If the publisher
+from which the package is installed (or available, if not installed) is not
+the first in the publisher search order, then the publisher name is listed
+in parentheses after the package name. The second column contains the release
+and branch versions of the package. See the <literal>pkg</literal>(5) man
+page for information about release and branch versions and about variants.</para>
+<itemizedlist>
+<para>The last column contains a set of flags that show the status of the
+package:</para>
+<listitem><para>An <literal>i</literal> in the <literal>I</literal> column
+shows that the package is installed.</para></listitem>
+<listitem><para>An <literal>f</literal> in the <literal>F</literal> column
+shows that the package is frozen.</para></listitem>
+<listitem><para>An <literal>o</literal> in the <literal>O</literal> column
+shows that the package is obsolete. An <literal>r</literal> in the <literal>O</literal> column
+shows that the package has been renamed (a form of obsoletion).</para>
+</listitem>
+</itemizedlist>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>List only the specified packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the listing.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>List installed packages and list the newest version of packages
+that are not installed but could be installed in this image. Packages can
+be installed if they are allowed by the installed incorporations and by the
+image&rsquo;s variants. If one or more patterns are specified, then the newest version
+matching the specified pattern and allowed by any installed incorporations
+and the image&rsquo;s variants is listed. Without <option>a</option>, list only
+installed packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>af</option></term>
+<listitem><para>List all versions of all packages for all variants regardless
+of incorporation constraints or installed state. To explicitly list the latest
+version of a package when using these options, use <literal>latest</literal> for
+the version portion of <replaceable>pkg_fmri_pattern</replaceable>. For example,
+specify <literal>vim@latest</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>g</option> <replaceable>path_or_uri</replaceable></term>
+<listitem><para>Use the specified package repository or archive as the source
+of package data for the operation. Repositories that require a client SSL
+certificate cannot be used with this option. This option can be specified
+multiple times. Use of <option>g</option> implies <option>a</option> if <option>n
+</option> is not specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Display the newest versions of all known packages, regardless
+of installed state.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>q</option></term>
+<listitem>
+<para>Do not list any packages, but return failure if a fatal error occurs.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option></term>
+<listitem><para>Display a one-line short-form giving the package name and
+summary. This option can be used with <option>a</option>, <option>n</option>,
+or <option>u</option>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>u</option></term>
+<listitem><para>List installed packages that have newer versions available.
+This option cannot be used with <option>g</option>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>Show full package FMRIs, including publisher and complete
+version, all in the first column (the VERSION column disappears). This option
+can be used with <option>a</option>, <option>n</option>, or <option>u</option>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-refresh</option></term>
+<listitem><para>Do not attempt to contact the repositories for the image&rsquo;s
+publishers to retrieve the newest list of available packages.</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>Display information about all packages installed in the current
+image in a human-readable form.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Display information for only the specified packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>g</option> <replaceable>path_or_uri</replaceable></term>
+<listitem><para>Use the specified package repository or archive as the source
+of package data for the operation. Repositories that require a client SSL
+certificate cannot be used with this option. This option can be specified
+multiple times. Use of <option>g</option> implies <option>r</option>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option></term>
+<listitem><para>Only display information for installed packages. This is the
+default.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>q</option></term>
+<listitem>
+<para>Do not display any package information, but return failure if a fatal error occurs.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>Match packages based on the newest available versions, retrieving
+information for packages not currently installed (if necessary) from the repositories
+of the image&rsquo;s configured publishers. At least one package must be specified
+when using this option. Without <option>r</option>, only installed packages
+are displayed by default.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-license</option></term>
+<listitem><para>Display the license texts for the packages. This option can
+be combined with <option>l</option>, <option>q</option>, or <option>r</option>.
+Return success if all <replaceable>pkg_fmri_pattern</replaceable> patterns
+match known packages and have licenses. Return failure if one or more patterns
+are unmatched or match packages that do not have licenses.</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>
+<listitem><para>Display the contents (action attributes) of all packages installed
+in the image. With no options, display the value of the <literal>path</literal> attribute
+for actions installed in the current image, sorted alphabetically by attribute
+value. For information about actions and their attributes, see &ldquo;Actions&rdquo;
+in the <literal>pkg</literal>(5) man page. See also the list of pseudo attribute
+names below.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Display contents of only the specified packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the output.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option> <replaceable>attribute</replaceable>=<replaceable>
+pattern</replaceable></term>
+<listitem><para>Limit the output to those actions that have an <replaceable>attribute
+</replaceable> named in the option argument with a value that matches the
+(glob) <replaceable>pattern</replaceable> in the option argument. This option
+can be specified multiple times. If multiple <option>a</option> options are
+given, then actions that match any of them are displayed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>g</option> <replaceable>path_or_uri</replaceable></term>
+<listitem><para>Display information for packages that could be installed in
+this image from the specified package repository or archive. Repositories
+that require a client SSL certificate cannot be used with this option. Packages
+that could be installed include packages that are currently installed and
+other packages that satisfy criteria for installation in this image, such
+as variant and facet restrictions. This option can be specified multiple times.
+Use of <option>g</option> implies <option>r</option>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option></term>
+<listitem><para>Display all attributes of all actions in the specified packages,
+including actions that could not be installed in this image.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>attribute</replaceable></term>
+<listitem><para>Display the specified attributes, sorted according to the
+values of the first attribute listed. The <option>o</option> option can be
+specified multiple times, or multiple attributes can be specified as the argument
+to one <option>o</option> option by separating the attribute names with commas.
+Only actions that have the requested attributes are displayed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>Display information for the newest available versions of packages
+that could be installed in this image from the repositories of the publishers
+configured in this image. Packages that could be installed include packages
+that are currently installed and other packages that satisfy criteria for
+installation in this image, such as variant and facet restrictions. At least
+one package must be specified when using this option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>sort_key</replaceable></term>
+<listitem><para>Sort actions by the specified action attribute. If not provided,
+the default is to sort by path or by the first attribute specified by the <option>
+o</option> option. The <option>s</option> option can be specified multiple
+times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>action_name</replaceable></term>
+<listitem><para>Only list the specified actions. The <option>t</option> option
+can be specified multiple times, or multiple actions can be specified as the
+argument to one <option>t</option> option by separating the action names with
+commas. The value of <replaceable>action_name</replaceable> is one of the
+actions listed in &ldquo;Actions&rdquo; in the <literal>pkg</literal>(5) man
+page, such as <literal>file</literal>, <literal>directory</literal>, <literal>driver
+</literal>, <literal>depend</literal>, <literal>set</literal>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Several special pseudo attribute names are available for convenience:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>action.hash</literal></term>
+<listitem><para>The value of the action&rsquo;s hash, if the action carries a payload.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.key</literal></term>
+<listitem><para>The value of the action&rsquo;s key attribute. For example, for
+a <literal>file</literal> action, the key attribute is the path to the file.
+Some actions do not have a key attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.name</literal></term>
+<listitem><para>The name of the action. For example, for a file action, this
+is <literal>file</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.raw</literal></term>
+<listitem><para>All attributes of matching actions.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.fmri</literal></term>
+<listitem><para>The full FMRI of the package containing the action, such as <literal>pkg://solaris/group/feature/[email protected],5.11-0.175.0.0.0.2.1:20120705T153434Z</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.name</literal></term>
+<listitem><para>The name of the package containing the action, such as
+<literal>web/amp</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.publisher</literal></term>
+<listitem><para>The publisher of the package containing the action, such as <literal>
+solaris</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.shortfmri</literal></term>
+<listitem><para>The short form FMRI of the package containing the action,
+such as <literal>pkg://solaris/group/feature/[email protected],5.11-0.175</literal></para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>The <command>contents</command> and <command>search</command> subcommands
+are related: Both query the system for the contents of packages. The <command>contents
+</command> subcommand displays actions in one or more installed or installable
+packages, filtering the output based on the specified options. The <command>search
+</command> subcommand approaches the query from the other direction, displaying
+the names of all packages that contain a user-supplied token.</para>
+<para>Each subcommand is capable of formulating some queries of which the
+other is capable. Care should be taken in choosing the subcommand, as a given
+query can be more naturally formulated in one than in the other.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg search</command> [<option>HIaflpr</option>]
+[<option>o</option> <replaceable>attribute</replaceable>[,<replaceable>attribute</replaceable>]...]...
+[<option>s</option> <replaceable>repo_uri</replaceable>] <replaceable>query</replaceable></term>
+<listitem><para>Search for actions that match <replaceable>query</replaceable>, and display the matching
+search index, action name, action value, and package name. See the description of
+<replaceable>query</replaceable> below. Some searches might yield duplicate results.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the output.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>I</option></term>
+<listitem><para>Use a case-sensitive search.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>Perform the search and display information about the matching
+actions. This is the default.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>f</option></term>
+<listitem><para>Show all results, regardless of package version. By default, <command>search</command> prunes
+results from packages older than the currently installed version and from package versions excluded
+by current incorporations.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option></term>
+<listitem><para>Search the image&rsquo;s installed packages.</para>
+<para>Both <option>l</option> and <option>r</option> (or <option>s</option>)
+can be specified together, in which case both local and remote searches are
+performed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>attribute</replaceable></term>
+<listitem><para>Specify the columns to include in the output. The <option>o</option> option can be specified multiple
+times, or multiple attributes can be specified as the argument to one <option>o</option> option by
+separating the attribute names with commas. In addition to the pseudo attributes outlined above, the
+following attributes are defined for search results. These attributes help show why a particular
+result was a match:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>search.match</literal></term>
+<listitem><para>The string that matched the search query.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>search.match_type</literal></term>
+<listitem><para>The attribute that contained the string that matched the search
+query.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option></term>
+<listitem><para>Display packages that have some actions that match each query
+term. Using this option is equivalent to putting angle brackets (<literal>&lt;></literal>)
+around each term in the query. See <replaceable>query</replaceable> below
+for more description of the <literal>&lt;></literal> operator.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>Search the repositories corresponding to the image&rsquo;s publishers.
+This is the default.</para>
+<para>Both <option>l</option> and <option>r</option> (or <option>s</option>)
+can be specified together, in which case both local and remote searches are
+performed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri</replaceable></term>
+<listitem><para>Search the <literal>pkg</literal>(5) repository located at
+the given URI. This can be specified multiple times. Package archives are
+not supported.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>query</replaceable></term>
+<listitem><para>By default, <replaceable>query</replaceable> is interpreted as a series of terms to be matched
+exactly and multiple terms are ANDed.</para>
+<para>AND and OR are supported.</para>
+<para>The <literal>?</literal> and <literal>*</literal> characters can be used as <literal>glob</literal>(3C)&hyphen;style wildcards, allowing more flexible query matches.</para>
+<para>In addition to simple token matching and wildcard search, a more complicated
+query language is supported. Phrases can be searched for by using single or
+double quotation marks (<literal>'</literal> or <literal>"</literal>). Be
+sure to take your shell into account so that <command>pkg</command> actually
+sees the <literal>'</literal> or <literal>"</literal>.</para>
+<para>Which tokens are indexed is action-dependent, but can include content
+hashes and path names. For information about actions and their attributes,
+see &ldquo;Actions&rdquo; in the <literal>pkg</literal>(5) man page. See also
+the list of pseudo attribute names in <command>pkg contents</command> and <option>
+o</option> above.</para>
+<para>Structured queries are supported with the following syntax:</para>
+<programlisting><replaceable>pkg_name</replaceable>:<replaceable>action_name</replaceable>:<replaceable>
+index</replaceable>:<replaceable>token</replaceable></programlisting>
+<para>The value of <replaceable>action_name</replaceable> is one of the actions
+listed in &ldquo;Actions&rdquo; in the <literal>pkg</literal>(5) man page.
+The <replaceable>index</replaceable> is an attribute of the action. The value
+of <replaceable>index</replaceable> must match <replaceable>token</replaceable>.</para>
+<para>Not all action attributes are searchable. For example, <literal>mode</literal> is
+an attribute of the <literal>file</literal> action, but <literal>mode</literal> is
+not a valid value for <replaceable>index</replaceable>.</para>
+<para>Some values for <replaceable>index</replaceable> are not action attributes
+but are values derived from other attributes. For example, <replaceable>index</replaceable> can
+be <literal>basename</literal>, which is not an attribute of any action but
+is derived from the <literal>path</literal> attribute of the <literal>file</literal> or <literal>
+dir</literal> action by taking the last component of the path.</para>
+<para>Different action types have different valid values for <replaceable>index</replaceable>.
+This documentation does not list all possible values. Some of the more useful <replaceable>
+index</replaceable> values are <literal>basename</literal> and <literal>path</literal> for
+file system actions, the dependency type (for example, <literal>require</literal>, <literal>
+optional</literal>, <literal>group</literal>) for <literal>depend</literal> actions,
+and <literal>driver_name</literal> and <literal>alias</literal> for <literal>driver
+</literal> actions.</para>
+<para>One special value for <replaceable>index</replaceable> is the value
+of a <literal>name</literal> attribute for a <literal>set</literal> action.
+In this case, <replaceable>token</replaceable> is matched against the value
+of the <literal>value</literal> attribute that corresponds to the specified <literal>
+name</literal> attribute. For example, the following search finds packages
+that are classified as either Development/Databases or System/Databases. In
+the &ldquo;Examples&rdquo; section, see the example of finding SMF services.</para>
+<screen>$ <userinput>pkg search info.classification:databases</userinput></screen>
+<para>Missing fields in a structured query are implicitly wildcarded. A search
+for <literal>basename:pkg</literal> matches all actions in all packages that
+have an <replaceable>index</replaceable> of <literal>basename</literal> and
+that match the <replaceable>token</replaceable> <literal>pkg</literal>, as
+shown in the following partial output:</para>
+<screen>$ <userinput>pkg search basename:pkg</userinput>
 INDEX    ACTION VALUE         PACKAGE
 basename dir    usr/share/pkg pkg:/package/[email protected]
 basename dir    var/sadm/pkg  pkg:/package/[email protected]
 basename dir    var/spool/pkg pkg:/package/[email protected]
-basename file   usr/bin/pkg   pkg:/package/[email protected]
-.fi
-.in -2
-.sp
-
-Adding another field narrows the search, as shown in the following complete output:
-.sp
-.in +2
-.nf
-$ \fBpkg search file:basename:pkg\fR
+basename file   usr/bin/pkg   pkg:/package/[email protected]</screen>
+<para>Adding another field narrows the search, as shown in the following complete
+output:</para>
+<screen>$ <userinput>pkg search file:basename:pkg</userinput>
 INDEX    ACTION VALUE       PACKAGE
-basename file   usr/bin/pkg pkg:/package/[email protected]
-.fi
-.in -2
-.sp
-
-Explicit wildcards are supported in the \fIpkg_name\fR and \fItoken\fR fields. The \fIaction_name\fR and \fIindex\fR must match exactly.
-.sp
-See the "Examples" section for examples of searching for files and dependencies.
-.sp
-To convert actions to the packages that contain those actions, use \fB<>\fR, as shown in the following partial output:
-.sp
-.in +2
-.nf
-$ \fBpkg search \e<pkg\e>\fR
+basename file   usr/bin/pkg pkg:/package/[email protected]</screen>
+<para>Explicit wildcards are supported in the <replaceable>pkg_name</replaceable> and <replaceable>
+token</replaceable> fields. The <replaceable>action_name</replaceable> and <replaceable>
+index</replaceable> must match exactly.</para>
+<para>See the &ldquo;Examples&rdquo; section for examples of searching for
+files and dependencies.</para>
+<para>To convert actions to the packages that contain those actions, use <literal>
+&lt;></literal>, as shown in the following partial output:</para>
+<screen>$ <userinput>pkg search &bsol;&lt;pkg&bsol;></userinput>
 PACKAGE                                  PUBLISHER
 pkg:/package/[email protected]  solaris
-pkg:/package/[email protected] solaris
-.fi
-.in -2
-.sp
-
-With the \fB-a\fR option (and by default), searching for \fBtoken\fR results in information about the actions that match \fBtoken\fR, while searching for \fB<token>\fR results in a list of packages that contain actions that match \fBtoken\fR.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg verify\fR [\fB-Hqv\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Validate the installation of all packages installed in the current image. If current signature policy for related publishers is not \fBignore\fR, the signatures of each package are validated based on policy. See \fBsignature-policy\fR in "Image Properties" below for an explanation of how signature policies are applied.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Validate the installation of only the specified packages installed in the current image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the verification output.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Include informational messages regarding packages. See also the description of the \fB-v\fR option for the \fBinstall\fR command above.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-For all other options, see the \fBinstall\fR command above.
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg fix\fR [\fB-Hnvq\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--accept\fR] [\fB--licenses\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Fix any errors reported by \fBpkg verify\fR. Verification of installed package content is based on a custom content analysis that might return different results than those of other programs.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Fix errors reported by \fBpkg verify\fR for only the specified packages installed in the current image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-Indicate that you agree to and accept the terms of the licenses of the packages that are updated or installed. If you do not provide this option, and any package licenses require acceptance, the operation fails.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--licenses\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display all of the licenses for the packages that are installed or updated as part of this operation. For updated packages, display the license only if the license has changed.
-.RE
-
-For all other options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the verification output.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Include informational messages regarding packages. See also the description of the \fB-v\fR option for the \fBinstall\fR command above.
-.RE
-
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg revert\fR [\fB-nv\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] (\fB--tagged\fR \fItag-name\fR ... | \fIpath-to-file\fR ...)\fR
-.ad
-.sp .6
-.RS 4n
-Revert files delivered by \fBpkg\fR(5) packages to their as-delivered condition. File ownership and protections are also restored.
-.LP
-Caution - 
-.sp
-.RS 2
-Reverting some editable files to their default values can make the system unbootable, or cause other malfunctions.
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--tagged\fR \fItag-name\fR\fR
-.ad
-.sp .6
-.RS 4n
-Revert all files tagged with \fItag-name\fR, and remove any unpackaged files or directories that are under directories with this tag and that match \fIpattern\fR. See the description of the \fBrevert-tag\fR attribute in "File Actions" and "Directory Actions" in the \fBpkg\fR(5) man page for more information about \fBtag-name\fR and \fIpattern\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpath-to-file\fR\fR
-.ad
-.sp .6
-.RS 4n
-Revert the specified files.
-.RE
-
-For all other options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg mediator\fR [\fB-aH\fR] [\fB-F\fR \fIformat\fR] [\fImediator\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display the current selected version and/or implementation of all mediators.
-.sp
-.ne 2
-.mk
-.na
-\fB\fImediator\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the current selected version and/or implementation of only the specified mediators.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify an alternative output format. The value of \fIformat\fR can be \fBtsv\fR (Tab Separated Values), \fBjson\fR (JavaScript Object Notation as a single line), or json-formatted (JavaScript Object Notation, formatted for readability).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the listing.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-List the mediations that can be set for currently installed packages.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-mediator\fR [\fB-nv\fR] [\fB-I\fR \fIimplementation\fR] [\fB-V\fR \fIversion\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] \fImediator\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Set the version and/or implementation for the specified mediators in the current image.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR \fIimplementation\fR\fR
-.ad
-.sp .6
-.RS 4n
-Set the implementation of the mediated interface to use. By default, if no version is specified, all implementation versions are allowed. To specify an implementation with no version, append an at sign (@).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-V\fR \fIversion\fR\fR
-.ad
-.sp .6
-.RS 4n
-Set the version of the mediated interface to use.
-.RE
-
-If the specified mediator version and/or implementation is not currently available, any links using the specified mediators are removed.
-.sp
-For all other options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-mediator\fR [\fB-nvIV\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] \fImediator\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Revert the version and/or implementation of the specified mediators to the system default.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-Revert only the implementation of the mediated interface.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-V\fR\fR
-.ad
-.sp .6
-.RS 4n
-Revert only the version of the mediated interface.
-.RE
-
-For all other options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg variant\fR [\fB-Haiv\fR] [\fB-F\fR \fIformat\fR] [\fIvariant_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display the current values of all variants set in this image. See "Facets and Variants" in the \fBpkg\fR(5) man page for more information about variants.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIvariant_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the current values of only the specified variants set in this image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify an alternative output format. For a description, see the \fBpkg mediator\fR command.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the listing.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display all variants explicitly set in the image and all variants that are listed in installed packages. The \fB-a\fR option cannot be combined with the \fB-i\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display all variants that are listed in installed packages. The \fB-i\fR option cannot be combined with the \fB-a\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the possible variant values that can be set for installed packages. The \fB-v\fR option can be combined with the \fB-a\fR or \fB-i\fR option.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg change-variant\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIvariant_name\fR=\fIvalue\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Change the values of the specified variants set in the current image.
-.sp
-Changing the value of a variant can cause package content to be removed, updated, or installed. Changing a variant value can also cause entire packages to be installed, updated, or removed to satisfy the new image configuration. See "Facets and Variants" in the \fBpkg\fR(5) man page for more information about variants.
-.sp
-For descriptions of options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg facet\fR [\fB-Haim\fR] [\fB-F\fR \fIformat\fR] [\fIfacet_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display the current values and source of all facets that either have been set locally in this image by using the \fBpkg change-facet\fR command or have been inherited from a parent image (such as a non-global zone inheriting the facet setting from the global zone). See "Facets and Variants" in the \fBpkg\fR(5) man page for more information about facets.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIfacet_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the current values of only the specified facets set in this image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify an alternative output format. For a description, see the \fBpkg mediator\fR command.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the listing.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display all facets explicitly set in the image and all facets that are listed in installed packages. The \fB-a\fR option cannot be combined with the \fB-i\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display all facets that are listed in installed packages. The \fB-i\fR option cannot be combined with the \fB-a\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-Include masked facets in the output. Display a column that indicates which, if any, facets are masked. Masked facets are facets set locally in an image (by using the \fBpkg change-facet\fR command) that are hidden by an inherited facet with the same name.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg change-facet\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIfacet_name\fR=(\fBTrue\fR|\fBFalse\fR|\fBNone\fR) ...\fR
-.ad
-.sp .6
-.RS 4n
-Change the values of the specified facets set in the current image. The changes also appear in any images that inherit these facets, such as non-global zones.
-.sp
-Facets can be set to \fBTrue\fR or \fBFalse\fR. Setting a facet to \fBNone\fR applies the default value of \fBTrue\fR to that facet; thus, any actions subject to the facet will be installed. See "Actions" in the \fBpkg\fR(5) man page for information about actions.
-.sp
-Changing the value of a facet can cause package content to be removed, updated, or installed. Changing a facet value can also cause entire packages to be installed, updated, or removed to satisfy the new image configuration. See "Facets and Variants" in the \fBpkg\fR(5) man page for more information about facets.
-.sp
-For descriptions of options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg avoid\fR [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display each avoided package along with any packages that have a group dependency on that package.
-.sp
-Packages that are on the avoid list are installed if needed to satisfy a required dependency. If that dependency is removed, the package is uninstalled.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Avoid the specified packages if they are the target of a group dependency by placing the package names that currently match the specified patterns on the avoid list. Only packages that are not currently installed can be avoided. If a package is currently the target of a group dependency, uninstalling the package places it on the avoid list.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unavoid\fR [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display the list of avoided packages.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Remove the specified packages from the avoid list. Packages on the avoid list that match an installed package\&'s group dependency cannot be removed using this subcommand. To remove a package from the avoid list that matches a group dependency, install the package.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg freeze\fR [\fB-n\fR] [\fB-c\fR \fIreason\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display information about currently frozen packages: package names, versions, when the package was frozen, and any associated reasons for freezing the packages.
-.sp
-Freezing a package does not prevent removal of the package. No warning is displayed if the package is removed.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Freeze the specified packages to the specified versions. If no version is given, the package must be installed and is frozen at that installed version. Freezing a package that is already frozen replaces the freeze version with the newly specified version.
-.sp
-When a package that is frozen is installed or updated, it must end up at a version that matches the version at which it was frozen. For example, if a package was frozen at 1.2, then it could be updated to 1.2.1, 1.2.9, 1.2.0.0.1, and so on. That package could not end up at 1.3, or 1.1. A publisher presented in the \fIpkg_fmri_pattern\fR is used to find matching packages. However, publisher information is not recorded as part of the freeze. A package is frozen with respect to its version only, not its publisher.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIreason\fR\fR
-.ad
-.sp .6
-.RS 4n
-Record the \fIreason\fR with the packages that are frozen. The reason is shown if a freeze prevents an installation or update from succeeding.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run of the freeze operation, displaying the list of packages that would be frozen without freezing any packages.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unfreeze\fR [\fB-n\fR] [\fIpkg_name_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display information about currently frozen packages: package names, versions, when the package was frozen, and any associated reasons for freezing the packages.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Remove the constraints that freezing imposes from the specified packages. Any versions provided are ignored.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run of the unfreeze operation, displaying the list of packages that would be unfrozen without unfreezing any packages.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg property\fR [\fB-H\fR] [\fIpropname\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display the names and values of all image properties. See "Image Properties" below for descriptions of image properties.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpropname\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the names and values for only the specified properties.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the listing.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-property\fR \fIpropname\fR \fIpropvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Update an existing image property or add a new image property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg add-property-value\fR \fIpropname\fR \fIpropvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add a value to an existing image property or add a new image property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg remove-property-value\fR \fIpropname\fR \fIpropvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Remove a value from an existing image property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-property\fR \fIpropname\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Remove an existing image property or properties.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg publisher\fR [\fB-HPn\fR] [\fB-F\fR \fIformat\fR] [\fIpublisher\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display the list of all publishers in order of search preference. The following information is displayed for each publisher: name, attributes such as non-sticky and disabled, type (origin or mirror), online status, proxy, and location URI. Proxy information is shown only as T (true) or F (false) under the column labeled P. To show the proxy value for a publisher with T in the P column, use the \fB-F tsv\fR option or specify the publisher name argument. Proxies shown by the \fBpkg publisher\fR command were set by using the \fB--proxy\fR option of the \fBpkg set-publisher\fR command. Proxies set by using an \fBhttp_proxy\fR environment variable are not shown by the \fBpkg publisher\fR command.
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display detailed configuration for only the specified publishers. Additional information displayed includes the proxy URI, key, and certificate for each origin or mirror URI, the client UUID, and the time the catalog was last updated.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify an alternative output format. For a description, see the \fBpkg mediator\fR command.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the listing.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display only the first publisher in the publisher search order.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display only enabled publishers.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-publisher\fR [-Ped] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fIssl_key\fR] [\fB-g\fR \fIorigin_to_add\fR | \fB--add-origin\fR \fIorigin_to_add\fR]... [\fB-G\fR \fIorigin_to_remove\fR | \fB--remove-origin\fR \fIorigin_to_remove\fR]... [\fB-m\fR \fImirror_to_add\fR | \fB--add-mirror\fR \fImirror_to_add\fR]... [\fB-M\fR \fImirror_to_remove\fR | \fB--remove-mirror\fR \fImirror_to_remove\fR]... [\fB--disable\fR] [\fB--enable\fR] [\fB--no-refresh\fR] [\fB--reset-uuid\fR] [\fB--non-sticky\fR] [\fB--sticky\fR] [\fB--search-after\fR \fIpublisher\fR] [\fB--search-before\fR \fIpublisher\fR] [\fB--search-first\fR] [\fB--approve-ca-cert\fR \fIpath_to_CA\fR] [\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--add-property-value\fR \fIname_of_property\fR=\fIvalue_to_add\fR] [\fB--remove-property-value\fR \fIname_of_property\fR=\fIvalue_to_remove\fR] [\fB--unset-property\fR \fIname_of_property_to_delete\fR] [\fB--proxy\fR \fIproxy_to_use\fR] \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Update an existing publisher or add a publisher. If no options affecting search order are specified, new publishers are appended to the search order and are thus searched last.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-G\fR \fIorigin_to_remove\fR\fR
-.ad
-.br
-.na
-\fB\fB--remove-origin\fR \fIorigin_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-Remove the URI or path from the list of origins for the given publisher. The special value \fB*\fR can be used to remove all origins.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-M\fR \fImirror_to_remove\fR\fR
-.ad
-.br
-.na
-\fB\fB--remove-mirror\fR \fImirror_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-Remove the URI from the list of mirrors for the given publisher. The special value \fB*\fR can be used to remove all mirrors.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR\fR
-.ad
-.br
-.na
-\fB\fB--search-first\fR\fR
-.ad
-.sp .6
-.RS 4n
-Set the specified publisher first in the search order. When installing new packages, this publisher is searched first. Updates to already installed packages come from the same publisher that originally provided the package as long as that publisher remains sticky.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the client SSL certificate.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.br
-.na
-\fB\fB--disable\fR\fR
-.ad
-.sp .6
-.RS 4n
-Disable the publisher. A disabled publisher is not used when populating the package list or in certain package operations (install, uninstall, and update). However, the properties for a disabled publisher can still be set and viewed. If only one publisher exists, it cannot be disabled.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-e\fR\fR
-.ad
-.br
-.na
-\fB\fB--enable\fR\fR
-.ad
-.sp .6
-.RS 4n
-Enable the publisher.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIorigin_to_add\fR\fR
-.ad
-.br
-.na
-\fB\fB--add-origin\fR \fIorigin_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the specified URI or path as an origin for the given publisher. This should be the location of a package repository or archive.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIssl_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the client SSL key.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR \fImirror_to_add\fR\fR
-.ad
-.br
-.na
-\fB\fB--add-mirror\fR \fImirror_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the URI as a mirror for the given publisher.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--add-property-value\fR \fIname_of_property\fR=\fIvalue_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add a value to an existing publisher property or add a new publisher property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--approve-ca-cert\fR \fIpath_to_CA\fR\fR
-.ad
-.sp .6
-.RS 4n
-For verifying signed packages, add the specified certificate as a CA certificate that is trusted. The hashes of the PEM representation of the user-approved CA certificates are listed in the detailed output of the \fBpkg publisher\fR command.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not attempt to contact the repositories for the image\&'s publishers to retrieve the newest list of available packages and other metadata.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--non-sticky\fR\fR
-.ad
-.sp .6
-.RS 4n
-Higher ranked publishers than this one can provide updates to packages originally installed from this publisher.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--proxy\fR \fIproxy_to_use\fR\fR
-.ad
-.sp .6
-.RS 4n
-Use the specified proxy URI to retrieve content for the specified origin (\fB-g\fR) or mirror (\fB-m\fR). The proxy value is stored as part of the publisher configuration, which means the system repository used by child images is automatically updated. This option cannot be used to set an authenticated proxy. The \fIproxy_to_use\fR value cannot have the form \fBprotocol://user:password@host\fR.
-.sp
-At run time, \fBhttp_proxy\fR or related environment variables override this proxy setting. See the "Environment" section of the \fBcurl\fR(1) man page for the list of accepted environment variable names. If you use an environment variable to set the proxy URI, you must also set the appropriate proxy property of the \fBsvc:/application/pkg/system-repository\fR SMF service to the same value. See "Specifying a Proxy" in \fIAdding and Updating Software in Oracle Solaris 11.2\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--remove-property-value\fR \fIname_of_property\fR=\fIvalue_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-Remove a value from an existing publisher property.
-.RE
+pkg:/package/[email protected] solaris</screen>
+<para>With the <option>a</option> option (and by default), searching for <literal>
+token</literal> results in information about the actions that match <literal>token
+</literal>, while searching for <literal>&lt;token></literal> results in a
+list of packages that contain actions that match <literal>token</literal>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg verify</command> [<option>Hqv</option>] [<replaceable>
+pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para>Validate the installation of all packages installed in the
+current image. If current signature policy for related publishers is not <literal>
+ignore</literal>, the signatures of each package are validated based on policy.
+See <literal>signature-policy</literal> in &ldquo;Image Properties&rdquo;
+below for an explanation of how signature policies are applied.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Validate the installation of only the specified packages installed
+in the current image.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the verification output.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>Include informational messages regarding packages. See also the
+description of the <option>v</option> option for the install command above.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For all other options, see the <command>install</command> command above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg fix</command> [<option>Hnvq</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>-accept</option>] [<option>-licenses</option>] [<replaceable>pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para>Fix any errors reported by <command>pkg verify</command>.
+Verification of installed package content is based on a custom content analysis
+that might return different results than those of other programs.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Fix errors reported by <command>pkg verify</command> for only
+the specified packages installed in the current image.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the verification output.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>Include informational messages regarding packages. See also the
+description of the <option>v</option> option for the install command above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-accept</option></term>
+<listitem><para>Indicate that you agree to and accept the terms of the licenses
+of the packages that are updated or installed. If you do not provide this
+option, and any package licenses require acceptance, the operation fails.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-licenses</option></term>
+<listitem><para>Display all of the licenses for the packages that are installed
+or updated as part of this operation. For updated packages, display the license
+only if the license has changed.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For all other options, see the <command>install</command> command above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg revert</command> [<option>nv</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>-tagged</option> <replaceable>
+tag-name</replaceable> ... | <replaceable>path-to-file</replaceable> ...)</term>
+<listitem><para>Revert files delivered by <literal>pkg</literal>(5) packages to their as-delivered condition. File ownership and protections are also restored.</para>
+<caution><para>Reverting some editable files to their default values can make
+the system unbootable, or cause other malfunctions.</para></caution>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-tagged</option> <replaceable>tag-name</replaceable></term>
+<listitem><para>Revert all files tagged with <replaceable>tag-name</replaceable>, and remove any unpackaged
+files or directories that are under directories with this tag and that match
+<replaceable>pattern</replaceable>. See the description of the <literal>revert-tag</literal>
+attribute in &ldquo;File Actions&rdquo; and &ldquo;Directory Actions&rdquo; in the
+<literal>pkg</literal>(5) man page for more information about <literal>tag-name</literal> and
+<replaceable>pattern</replaceable>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>path-to-file</replaceable></term>
+<listitem><para>Revert the specified files.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For all other options, see the <command>install</command> command above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg mediator</command> [<option>aH</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>mediator</replaceable> ...]
+</term>
+<listitem><para>Display the current selected version and/or implementation
+of all mediators.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>mediator</replaceable></term>
+<listitem><para>Display the current selected version and/or implementation
+of only the specified mediators.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>Specify an alternative output format. The value of <replaceable>format</replaceable> can be <literal>tsv</literal> (Tab Separated Values), <literal>json</literal> (JavaScript Object Notation as a single line), or json-formatted (JavaScript Object Notation, formatted for readability).</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the listing.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>List the mediations that can be set for currently installed
+packages.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-mediator</command> [<option>nv</option>] [<option>I</option> <replaceable>implementation</replaceable>] [<option>V</option> <replaceable>version</replaceable>] [<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>] <replaceable>mediator</replaceable> ...</term>
+<listitem><para>Set the version and/or implementation for the specified mediators
+in the current image.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option> <replaceable>implementation</replaceable></term>
+<listitem><para>Set the implementation of the mediated interface to use. By
+default, if no version is specified, all implementation versions are allowed.
+To specify an implementation with no version, append an at sign (@).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>V</option> <replaceable>version</replaceable></term>
+<listitem><para>Set the version of the mediated interface to use.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>If the specified mediator version and/or implementation is not currently
+available, any links using the specified mediators are removed.</para>
+<para>For all other options, see the <command>install</command> command above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-mediator</command> [<option>nvIV</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>] <replaceable>mediator</replaceable> ...
+</term>
+<listitem><para>Revert the version and/or implementation of the specified
+mediators to the system default.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option></term>
+<listitem><para>Revert only the implementation of the mediated interface.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>V</option></term>
+<listitem><para>Revert only the version of the mediated interface.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For all other options, see the <command>install</command> command above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg variant</command> [<option>Haiv</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>variant_pattern</replaceable> ...]</term>
+<listitem><para>Display the current values of all variants set in this image.
+See &ldquo;Facets and Variants&rdquo; in the <literal>pkg</literal>(5) man
+page for more information about variants.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>variant_pattern</replaceable></term>
+<listitem><para>Display the current values of only the specified variants
+set in this image.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>Specify an alternative output format. For a description, see the <command>pkg mediator</command> command.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the listing.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>a</option></term>
+<listitem>
+<para>Display all variants explicitly set in the image and all variants that are listed in installed
+packages. The <option>a</option> option cannot be combined with the <option>i</option>
+option.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>i</option></term>
+<listitem>
+<para>Display all variants that are listed in installed packages. The <option>i</option> option
+cannot be combined with the <option>a</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>v</option></term>
+<listitem>
+<para>Display the possible variant values that can be set for installed packages. The
+<option>v</option> option can be combined with the <option>a</option> or <option>i</option>
+option.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg change-variant</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-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>variant_name</replaceable>=<replaceable>value</replaceable> ...</term>
+<listitem><para>Change the values of the specified variants set in the current
+image.</para>
+<para>Changing the value of a variant can cause package content to be removed,
+updated, or installed. Changing a variant value can also cause entire packages
+to be installed, updated, or removed to satisfy the new image configuration.
+See &ldquo;Facets and Variants&rdquo; in the <literal>pkg</literal>(5) man
+page for more information about variants.</para>
+<para>For descriptions of options, see the <command>install</command> command
+above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg facet</command> [<option>Haim</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>facet_pattern</replaceable> ...]</term>
+<listitem><para>Display the current values and source of all facets that either have been set locally in this
+image by using the <command>pkg change-facet</command> command or have been inherited from a
+parent image (such as a non-global zone inheriting the facet setting from the global zone). See &ldquo;Facets and Variants&rdquo; in the <literal>pkg</literal>(5) man page for
+more information about facets.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>facet_pattern</replaceable></term>
+<listitem><para>Display the current values of only the specified facets set
+in this image.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>Specify an alternative output format. For a description, see the <command>pkg mediator</command> command.</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><option>H</option></term>
+<listitem>
+<para>Omit the headers from the listing.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>a</option></term>
+<listitem>
+<para>Display all facets explicitly set in the image and all facets that are listed in installed
+packages. The <option>a</option> option cannot be combined with the <option>i</option>
+option.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>i</option></term>
+<listitem>
+<para>Display all facets that are listed in installed packages. The <option>i</option> option cannot
+be combined with the <option>a</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>m</option></term>
+<listitem>
+<para>Include masked facets in the output. Display a column that indicates which, if any, facets are masked. Masked facets are facets set locally in an image (by using the <command>pkg change-facet</command> command) that are hidden by an inherited facet with the same name.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg change-facet</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-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>facet_name</replaceable>=(<literal>True</literal>|<literal>False</literal>|<literal>None</literal>) ...</term>
+<listitem><para>Change the values of the specified facets set in the current
+image. The changes also appear in any images that inherit these facets, such as non-global zones.</para>
+<para>Facets can be set to <literal>True</literal> or <literal>False</literal>.
+Setting a facet to <literal>None</literal> applies the default value of
+<literal>True</literal> to that facet; thus, any actions subject to the facet
+will be installed. See &ldquo;Actions&rdquo; in the <literal>pkg</literal>(5)
+man page for information about actions.</para>
+<para>Changing the value of a facet can cause package content to be removed,
+updated, or installed. Changing a facet value can also cause entire packages
+to be installed, updated, or removed to satisfy the new image configuration.
+See &ldquo;Facets and Variants&rdquo; in the <literal>pkg</literal>(5) man
+page for more information about facets.</para>
+<para>For descriptions of options, see the <command>install</command> command
+above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg avoid</command> [<replaceable>pkg_fmri_pattern</replaceable> ...]
+</term>
+<listitem><para>Display each avoided package along with any packages that
+have a group dependency on that package.</para>
+<para>Packages that are on the avoid list are installed if needed to satisfy a required dependency. If that dependency is removed, the package is uninstalled.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Avoid the specified packages if they are the target of a group
+dependency by placing the package names that currently match the specified
+patterns on the avoid list. Only packages that are not currently installed
+can be avoided. If a package is currently the target of a group dependency,
+uninstalling the package places it on the avoid list.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unavoid</command> [<replaceable>pkg_fmri_pattern
+</replaceable> ...]</term>
+<listitem><para>Display the list of avoided packages.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Remove the specified packages from the avoid list. Packages
+on the avoid list that match an installed package&rsquo;s group dependency cannot
+be removed using this subcommand. To remove a package from the avoid list
+that matches a group dependency, install the package.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg freeze</command> [<option>n</option>] [<option>c</option> <replaceable>reason</replaceable>] [<replaceable>pkg_fmri_pattern</replaceable> ...]
+</term>
+<listitem><para>Display information about currently frozen packages: package
+names, versions, when the package was frozen, and any associated reasons for
+freezing the packages.</para>
+<para>Freezing a package does not prevent removal of the package. No warning
+is displayed if the package is removed.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Freeze the specified packages to the specified versions. If
+no version is given, the package must be installed and is frozen at that installed
+version. Freezing a package that is already frozen replaces the freeze version
+with the newly specified version.</para>
+<para>When a package that is frozen is installed or updated, it must end up
+at a version that matches the version at which it was frozen. For example,
+if a package was frozen at 1.2, then it could be updated to 1.2.1, 1.2.9,
+1.2.0.0.1, and so on. That package could not end up at 1.3, or 1.1. A publisher
+presented in the <replaceable>pkg_fmri_pattern</replaceable> is used to find
+matching packages. However, publisher information is not recorded as part
+of the freeze. A package is frozen with respect to its version only, not its
+publisher.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>reason</replaceable></term>
+<listitem><para>Record the <replaceable>reason</replaceable> with the packages
+that are frozen. The reason is shown if a freeze prevents an installation
+or update from succeeding.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run of the freeze operation, displaying the
+list of packages that would be frozen without freezing any packages.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unfreeze</command> [<option>n</option>] [<replaceable>
+pkg_name_pattern</replaceable> ...]</term>
+<listitem><para>Display information about currently frozen packages: package
+names, versions, when the package was frozen, and any associated reasons for
+freezing the packages.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Remove the constraints that freezing imposes from the specified
+packages. Any versions provided are ignored.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run of the unfreeze operation, displaying
+the list of packages that would be unfrozen without unfreezing any packages.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg property</command> [<option>H</option>] [<replaceable>
+propname</replaceable> ...]</term>
+<listitem><para>Display the names and values of all image properties. See &ldquo;Image
+Properties&rdquo; below for descriptions of image properties.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>propname</replaceable></term>
+<listitem><para>Display the names and values for only the specified properties.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the listing.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-property</command> <replaceable>propname</replaceable> <replaceable>
+propvalue</replaceable></term>
+<listitem><para>Update an existing image property or add a new image property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg add-property-value</command> <replaceable>propname
+</replaceable> <replaceable>propvalue</replaceable></term>
+<listitem><para>Add a value to an existing image property or add a new image
+property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg remove-property-value</command> <replaceable>propname
+</replaceable> <replaceable>propvalue</replaceable></term>
+<listitem><para>Remove a value from an existing image property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-property</command> <replaceable>propname</replaceable> ...
+</term>
+<listitem><para>Remove an existing image property or properties.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg publisher</command> [<option>HPn</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>publisher</replaceable> ...]
+</term>
+<listitem><para>Display the list of all publishers in order of search
+preference. The following information is displayed for each publisher: name,
+attributes such as non-sticky and disabled, type (origin or mirror), online
+status, proxy, and location URI. Proxy information is shown only as T (true) or
+F (false) under the column labeled P. To show the proxy value for a publisher
+with T in the P column, use the <literal>-F tsv</literal> option or specify the
+publisher name argument. Proxies shown by the <command>pkg publisher</command>
+command were set by using the <option>-proxy</option> option of the
+<command>pkg set-publisher</command> command. Proxies set by using an
+<envar>http_proxy</envar> environment variable are not shown by the
+<command>pkg publisher</command> command.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>publisher</replaceable></term>
+<listitem><para>Display detailed configuration for only the specified publishers.
+Additional information displayed includes the proxy URI, key, and certificate
+for each origin or mirror URI, the client UUID, and the time the catalog was
+last updated.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>Specify an alternative output format. For a description, see the <command>pkg mediator</command> command.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the listing.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option></term>
+<listitem><para>Display only the first publisher in the publisher search order.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Display only enabled publishers.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-publisher</command> [-Ped] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable>ssl_key</replaceable>] [<option>g</option> <replaceable>origin_to_add</replaceable> | <option>-add-origin</option> <replaceable>origin_to_add</replaceable>]... [<option>G</option> <replaceable>origin_to_remove</replaceable> | <option>-remove-origin</option> <replaceable>origin_to_remove</replaceable>]... [<option>m</option> <replaceable>mirror_to_add</replaceable> | <option>-add-mirror</option> <replaceable>mirror_to_add</replaceable>]... [<option>M</option> <replaceable>mirror_to_remove</replaceable> | <option>-remove-mirror</option> <replaceable>mirror_to_remove</replaceable>]... [<option>-disable</option>] [<option>-enable</option>] [<option>-no-refresh</option>] [<option>-reset-uuid</option>] [<option>-non-sticky</option>] [<option>-sticky</option>] [<option>-search-after</option> <replaceable>publisher</replaceable>] [<option>-search-before</option> <replaceable>publisher</replaceable>] [<option>-search-first</option>] [<option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable>] [<option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-add-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_add</replaceable>] [<option>-remove-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_remove</replaceable>] [<option>-unset-property</option> <replaceable>name_of_property_to_delete</replaceable>] [<option>-proxy</option> <replaceable>proxy_to_use</replaceable>] <replaceable>publisher</replaceable></term>
+<listitem><para>Update an existing publisher or add a publisher. If no options
+affecting search order are specified, new publishers are appended to the search
+order and are thus searched last.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>G</option> <replaceable>origin_to_remove</replaceable></term>
+<term><option>-remove-origin</option> <replaceable>origin_to_remove</replaceable></term>
+<listitem><para>Remove the URI or path from the list of origins for the given
+publisher. The special value <literal>*</literal> can be used to remove all
+origins.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>M</option> <replaceable>mirror_to_remove</replaceable></term>
+<term><option>-remove-mirror</option> <replaceable>mirror_to_remove</replaceable></term>
+<listitem><para>Remove the URI from the list of mirrors for the given publisher.
+The special value <literal>*</literal> can be used to remove all mirrors.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option></term><term><option>-search-first</option></term>
+<listitem><para>Set the specified publisher first in the search order. When
+installing new packages, this publisher is searched first. Updates to already
+installed packages come from the same publisher that originally provided the
+package as long as that publisher remains sticky.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para>Specify the client SSL certificate.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term><term><option>-disable</option></term>
+<listitem><para>Disable the publisher. A disabled publisher is not used when
+populating the package list or in certain package operations (install, uninstall,
+and update). However, the properties for a disabled publisher can still be
+set and viewed. If only one publisher exists, it cannot be disabled.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>e</option></term><term><option>-enable</option></term>
+<listitem><para>Enable the publisher.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>g</option> <replaceable>origin_to_add</replaceable></term>
+<term><option>-add-origin</option> <replaceable>origin_to_add</replaceable></term>
+<listitem><para>Add the specified URI or path as an origin for the given publisher.
+This should be the location of a package repository or archive.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>ssl_key</replaceable></term>
+<listitem><para>Specify the client SSL key.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option> <replaceable>mirror_to_add</replaceable></term>
+<term><option>-add-mirror</option> <replaceable>mirror_to_add</replaceable></term>
+<listitem><para>Add the URI as a mirror for the given publisher.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-add-property-value</option> <replaceable>name_of_property
+</replaceable>=<replaceable>value_to_add</replaceable></term>
+<listitem><para>Add a value to an existing publisher property or add a new
+publisher property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable></term>
+<listitem><para>For verifying signed packages, add the specified certificate
+as a CA certificate that is trusted. The hashes of the PEM representation
+of the user-approved CA certificates are listed in the detailed output of
+the <command>pkg publisher</command> command.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-refresh</option></term>
+<listitem><para>Do not attempt to contact the repositories for the image&rsquo;s
+publishers to retrieve the newest list of available packages and other metadata.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-non-sticky</option></term>
+<listitem><para>Higher ranked publishers than this one can provide updates
+to packages originally installed from this publisher.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-proxy</option> <replaceable>proxy_to_use</replaceable></term>
+<listitem><para>Use the specified proxy URI to retrieve content for the
+specified origin (<option>g</option>) or mirror (<option>m</option>). The proxy
+value is stored as part of the publisher configuration, which means the system
+repository used by child images is automatically updated. This option cannot be
+used to set an authenticated proxy. The <replaceable>proxy_to_use</replaceable>
+value cannot have the form <literal>protocol://user:password@host</literal>.</para>
+<para>At run time, <literal>http_proxy</literal> or related environment
+variables override this proxy setting. See the &ldquo;Environment&rdquo;
+section of the <literal>curl</literal>(1) man page for the list of accepted
+environment variable names. If you use an environment variable to set the
+proxy URI, you must also set the appropriate proxy property of the
+<literal>svc:/application/pkg/system-repository</literal> SMF service to the
+same value. See &ldquo;Specifying a Proxy&rdquo; in
+<citetitle>Adding and Updating Software in Oracle Solaris 11.3</citetitle>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-remove-property-value</option> <replaceable>name_of_property
+</replaceable>=<replaceable>value_to_remove</replaceable></term>
+<listitem><para>Remove a value from an existing publisher property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-reset-uuid</option></term>
+<listitem><para>Choose a new unique identifier that identifies this image
+to its publisher.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove
+</replaceable></term>
+<listitem><para>For verifying signed packages, treat the certificate with the given hash of its PEM representation as revoked. The hashes of the user-revoked CA certificates are listed in the detailed output of the <command>pkg publisher</command> command.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-search-after</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Alter the publisher search order so that the publisher being
+added or modified is searched after the publisher specified in this option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-search-before</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Alter the publisher search order so that the publisher being
+added or modified is searched before the publisher specified in this option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>
+value</replaceable></term>
+<listitem><para>Update an existing publisher property or add a new publisher
+property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-sticky</option></term>
+<listitem><para>Updates to packages that were installed from this publisher
+must also come from this publisher. This is the default behavior.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove
+</replaceable></term>
+<listitem><para>For verifying signed packages, remove the certificate with
+the given hash from the list of approved certificates and the list of revoked
+certificates.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-unset-property</option> <replaceable>name_of_property_to_delete
+</replaceable></term>
+<listitem><para>Remove an existing publisher property.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-publisher</command> <option>p</option> <replaceable>repo_uri</replaceable> [-Ped] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable>ssl_key</replaceable>] [<option>-non-sticky</option>] [<option>-sticky</option>] [<option>-search-after</option> <replaceable>publisher</replaceable>] [<option>-search-before</option> <replaceable>publisher</replaceable>] [<option>-search-first</option>] [<option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable>] [<option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-add-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_add</replaceable>] [<option>-remove-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_remove</replaceable>] [<option>-unset-property</option> <replaceable>name_of_property_to_delete</replaceable>] [<option>-proxy</option> <replaceable>proxy_to_use</replaceable>] [<replaceable>publisher</replaceable>]</term>
+<listitem><para>Retrieve publisher configuration information from the <replaceable>repo_uri</replaceable> repository URI.</para>
+<para>If a publisher operand is specified to this <command>set-publisher</command> subcommand,
+then only that publisher is added or updated. If no publisher is specified,
+all publishers in <replaceable>repo_uri</replaceable> are added or updated
+as appropriate.</para>
+<para>For descriptions of options, see the <command>set-publisher</command> command
+above. When used with <option>p</option>, the <option>P</option>, <option>-search-first
+</option>, <option>-search-before</option>, and <option>-search-after</option> options
+only apply to added publishers, not to updated publishers.</para>
+<para>The <option>p</option> option cannot be combined with the <option>g</option>, <option>
+-add-origin</option>, <option>G</option>, <option>-remove-origin</option>, <option>
+m</option>, <option>-add-mirror</option>, <option>M</option>, <option>-remove-mirror
+</option>, <option>-disable</option>, <option>-enable</option>, <option>-no-refresh
+</option>, or <option>-reset-uuid</option> options.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-publisher</command> <replaceable>publisher
+</replaceable> ...</term>
+<listitem><para>Remove the configuration associated with the specified publisher
+or publishers.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg history</command> [<option>HNl</option>] [<option>n</option> <replaceable>number</replaceable>] [<option>o</option> <replaceable>column</replaceable>[,<replaceable>column</replaceable>]...]... [<option>t</option> <replaceable>time</replaceable> | <replaceable>time</replaceable>-<replaceable>time</replaceable>[,<replaceable>time</replaceable> | <replaceable>time</replaceable>-<replaceable>time</replaceable>]...]...</term>
+<listitem><para>Display the command history of the applicable image. Display
+the start time of the operation, the name of the operation (for example,
+<literal>install</literal>), the client (for example, <literal>pkg</literal>),
+and the outcome of the operation (Succeeded or Failed).</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the listing.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option></term>
+<listitem><para>Display the long form of the command history of the image.
+Additional information displayed includes the version of the client, the name
+of the user who performed the operation, whether a new boot environment was
+created, the time the operation completed and total time taken, the complete
+command that was issued, and any errors that were encountered while executing
+the command. For operations such as <command>update</command>, complete FMRIs
+of changed packages are shown.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>N</option></term>
+<listitem><para>Display the release note text.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option> <replaceable>number</replaceable></term>
+<listitem><para>Display only the specified number of most recent entries.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>column</replaceable></term>
+<listitem><para>Display output using the specified column names. The <option>o</option> option
+can be specified multiple times, or multiple column names can be specified
+as the argument to one <option>o</option> option by separating the column
+names with commas. Valid column names are:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>be</literal></term>
+<listitem><para>The name of the boot environment this operation was started
+on.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>be_uuid</literal></term>
+<listitem><para>The <literal>uuid</literal> of the boot environment this operation
+was started on.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>client</literal></term>
+<listitem><para>The name of the client.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>client_ver</literal></term>
+<listitem><para>The version of the client.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>command</literal></term>
+<listitem><para>The command line used for this operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>finish</literal></term>
+<listitem><para>The time that this operation finished.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>id</literal></term>
+<listitem><para>The user id that started this operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>new_be</literal></term>
+<listitem><para>The new boot environment created by this operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>new_be_uuid</literal></term>
+<listitem><para>The <literal>uuid</literal> of the new boot environment created
+by this operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>operation</literal></term>
+<listitem><para>The name of the operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>outcome</literal></term>
+<listitem><para>A summary of the outcome of this operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>reason</literal></term>
+<listitem><para>Additional information on the outcome of this operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>release_note</literal></term>
+<listitem><para>Indicates whether this operation generated release notes.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>snapshot</literal></term>
+<listitem><para>The snapshot taken during this operation. This is only recorded if the snapshot was not automatically removed after successful operation completion.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>start</literal></term>
+<listitem><para>The time that this operation started.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>time</literal></term>
+<listitem><para>The total time taken to perform this operation. For operations
+that take less than one second, 0:00:00 is shown.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>user</literal></term>
+<listitem><para>The username that started this operation.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>If the <literal>command</literal> or <literal>reason</literal> columns
+are specified, they must be the last item in the <option>o</option> list,
+in order to preserve output field separation. These two columns cannot be
+shown in the same <command>history</command> command.</para>
+<para>An asterisk (*) is shown after the values for <literal>be</literal> or <literal>
+new_be</literal> if the boot environment is no longer present on the system.</para>
+<para>The values for <literal>be</literal> and <literal>new_be</literal> are
+obtained by looking up the current boot environment name, using the <literal>be_uuid
+</literal> or <literal>new_be_uuid</literal> fields. If a boot environment
+was subsequently renamed, and later deleted, the values displayed for <literal>be
+</literal> and <literal>new_be</literal> are the values recorded at the time
+of the <command>pkg</command> operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>time</replaceable></term>
+<term><option>t</option> <replaceable>time</replaceable>-<replaceable>time</replaceable></term>
+<listitem><para>Display log records for a comma-separated list of timestamps,
+formatted with <literal>%Y-%m-%dT%H:%M:%S</literal> (see the <literal>strftime</literal>(3C)
+man page). To specify a range of times, use a hyphen (<literal>-</literal>)
+between a start and finish timestamp. The keyword <literal>now</literal> can
+be used as an alias for the current time. This option can be specified multiple
+times. If the timestamps specified contain duplicate timestamps or overlapping
+ranges, duplicate history events are not displayed. Only a single instance
+of each history event is displayed.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg purge-history</command></term>
+<listitem><para>Delete all existing history information.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg rebuild-index</command></term>
+<listitem><para>Rebuild the index used by <command>pkg search</command>. This
+is a recovery operation not intended for general use.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg update-format</command></term>
+<listitem><para>Update the format of the image to the current version. Once
+this operation has completed, the image can no longer be used with older versions
+of the <literal>pkg</literal>(5) system.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg version</command></term>
+<listitem><para>Display a unique string identifying the version of <command>pkg</command>.
+This string is not guaranteed to be comparable in any fashion between versions.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg help</command></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--reset-uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-Choose a new unique identifier that identifies this image to its publisher.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-For verifying signed packages, treat the certificate with the given hash of its PEM representation as revoked. The hashes of the user-revoked CA certificates are listed in the detailed output of the \fBpkg publisher\fR command.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--search-after\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Alter the publisher search order so that the publisher being added or modified is searched after the publisher specified in this option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--search-before\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Alter the publisher search order so that the publisher being added or modified is searched before the publisher specified in this option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Update an existing publisher property or add a new publisher property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sticky\fR\fR
-.ad
-.sp .6
-.RS 4n
-Updates to packages that were installed from this publisher must also come from this publisher. This is the default behavior.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-For verifying signed packages, remove the certificate with the given hash from the list of approved certificates and the list of revoked certificates.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--unset-property\fR \fIname_of_property_to_delete\fR\fR
-.ad
-.sp .6
-.RS 4n
-Remove an existing publisher property.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-publisher\fR \fB-p\fR \fIrepo_uri\fR [-Ped] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fIssl_key\fR] [\fB--non-sticky\fR] [\fB--sticky\fR] [\fB--search-after\fR \fIpublisher\fR] [\fB--search-before\fR \fIpublisher\fR] [\fB--search-first\fR] [\fB--approve-ca-cert\fR \fIpath_to_CA\fR] [\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--add-property-value\fR \fIname_of_property\fR=\fIvalue_to_add\fR] [\fB--remove-property-value\fR \fIname_of_property\fR=\fIvalue_to_remove\fR] [\fB--unset-property\fR \fIname_of_property_to_delete\fR] [\fB--proxy\fR \fIproxy_to_use\fR] [\fIpublisher\fR]\fR
-.ad
-.sp .6
-.RS 4n
-Retrieve publisher configuration information from the \fIrepo_uri\fR repository URI.
-.sp
-If a publisher operand is specified to this \fBset-publisher\fR subcommand, then only that publisher is added or updated. If no publisher is specified, all publishers in \fIrepo_uri\fR are added or updated as appropriate.
-.sp
-For descriptions of options, see the \fBset-publisher\fR command above. When used with \fB-p\fR, the \fB-P\fR, \fB--search-first\fR, \fB--search-before\fR, and \fB--search-after\fR options only apply to added publishers, not to updated publishers.
-.sp
-The \fB-p\fR option cannot be combined with the \fB-g\fR, \fB--add-origin\fR, \fB-G\fR, \fB--remove-origin\fR, \fB-m\fR, \fB--add-mirror\fR, \fB-M\fR, \fB--remove-mirror\fR, \fB--disable\fR, \fB--enable\fR, \fB--no-refresh\fR, or \fB--reset-uuid\fR options.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-publisher\fR \fIpublisher\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Remove the configuration associated with the specified publisher or publishers.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg history\fR [\fB-HNl\fR] [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIcolumn\fR[,\fIcolumn\fR]...]... [\fB-t\fR \fItime\fR | \fItime\fR-\fItime\fR[,\fItime\fR | \fItime\fR-\fItime\fR]...]...\fR
-.ad
-.sp .6
-.RS 4n
-Display the command history of the applicable image. Display the start time of the operation, the name of the operation (for example, \fBinstall\fR), the client (for example, \fBpkg\fR), and the outcome of the operation (Succeeded or Failed).
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the listing.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the long form of the command history of the image. Additional information displayed includes the version of the client, the name of the user who performed the operation, whether a new boot environment was created, the time the operation completed and total time taken, the complete command that was issued, and any errors that were encountered while executing the command. For operations such as \fBupdate\fR, complete FMRIs of changed packages are shown.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-N\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the release note text.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR \fInumber\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display only the specified number of most recent entries.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIcolumn\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display output using the specified column names. The \fB-o\fR option can be specified multiple times, or multiple column names can be specified as the argument to one \fB-o\fR option by separating the column names with commas. Valid column names are:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe\fR\fR
-.ad
-.sp .6
-.RS 4n
-The name of the boot environment this operation was started on.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe_uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-The \fBuuid\fR of the boot environment this operation was started on.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclient\fR\fR
-.ad
-.sp .6
-.RS 4n
-The name of the client.
-.RE
+<varlistentry><term><command>pkg image-create</command> [<option>FPUfz</option>] [<option>-force</option>] [<option>-full</option> | <option>-partial</option> | <option>-user</option>] [<option>-zone</option>] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable> ssl_key</replaceable>] [<option>g</option> <replaceable>path_or_uri</replaceable> | <option>-origin</option> <replaceable>path_or_uri</replaceable>]... [<option>m</option> <replaceable>uri</replaceable> | <option>-mirror</option> <replaceable>uri</replaceable>]... [<option>-facet</option> <replaceable>facet_name</replaceable>=(<literal>True</literal>|<literal>False</literal>)]... [<option>-no-refresh</option>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-variant</option> <replaceable>variant_name</replaceable>=<replaceable>value</replaceable>]... [(<option>p</option> | <option>-publisher</option>) [<replaceable>name</replaceable>=]<replaceable>repo_uri</replaceable>] <replaceable>dir</replaceable></term>
+<listitem><para>At the location given by <replaceable>dir</replaceable>, create an image suitable for package operations. Images created by using the <command>image-create</command> subcommand are not bootable. Most users should use the <option>-be-name</option> or <option>-require-new-be</option> options with <command>pkg</command> commands, or use the <command>beadm</command> or <command>zoneadm</command> commands to create images. The <command>pkg image-create</command> command is used for tasks such as maintaining packages and operating system distributions.</para>
+<para>The default image type is user, which can be specified by using the <option>U</option> or <option>-user</option> option. Alternatively, the image type can be set to a full image (<option>-F</option> or <option>-full</option>) or to a partial image (<option>P</option> or <option>-partial</option>) linked to the full image enclosing the given <replaceable>dir</replaceable> path.</para>
+<para>Additional origins can be specified using <option>g</option> or <option>-origin</option>. Additional mirrors can be specified using <option>m</option> or <option>-mirror</option>.</para>
+<para>A package repository URI must be provided using the <option>p</option> or <option>-publisher</option> option. If a publisher name is also provided, then only that publisher is added when the image is created. If a publisher name is
+not provided, then all publishers known by the specified repository are added
+to the image. An attempt to retrieve the catalog associated with this publisher
+is made following the initial creation operations.</para>
+<para>For publishers using client SSL authentication, a client key and client
+certificate can be registered via the <option>c</option> and <option>k</option> options. This key and certificate are used for all publishers added during image creation.</para>
+<para>If the image is to be run within non-global zone context, use the <option>z</option> (<option>-zone</option>) option to set an appropriate variant.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>f</option></term><term><option>-force</option></term>
+<listitem><para>Force the creation of an image over an existing image. This
+option should be used with care.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-facet</option> <replaceable>facet_name</replaceable>=(<literal>
+True</literal>|<literal>False</literal>)</term>
+<listitem><para>Set the specified facet to the indicated value. See &ldquo;Facets
+and Variants&rdquo; in the <literal>pkg</literal>(5) man page for more information
+about facets.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-refresh</option></term>
+<listitem><para>Do not attempt to contact the repositories for the image&rsquo;s
+publishers to retrieve the newest list of available packages and other metadata.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>
+value</replaceable></term>
+<listitem><para>Set the specified image property to the indicated value. See &ldquo;Image
+Properties&rdquo; below for descriptions of image properties.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-variant</option> <replaceable>variant_name</replaceable>=<replaceable>
+value</replaceable></term>
+<listitem><para>Set the specified variant to the indicated value. See &ldquo;Facets
+and Variants&rdquo; in the <literal>pkg</literal>(5) man page for more information
+about variants.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclient_ver\fR\fR
-.ad
-.sp .6
-.RS 4n
-The version of the client.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcommand\fR\fR
-.ad
-.sp .6
-.RS 4n
-The command line used for this operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBfinish\fR\fR
-.ad
-.sp .6
-.RS 4n
-The time that this operation finished.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBid\fR\fR
-.ad
-.sp .6
-.RS 4n
-The user id that started this operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBnew_be\fR\fR
-.ad
-.sp .6
-.RS 4n
-The new boot environment created by this operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBnew_be_uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-The \fBuuid\fR of the new boot environment created by this operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoperation\fR\fR
-.ad
-.sp .6
-.RS 4n
-The name of the operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoutcome\fR\fR
-.ad
-.sp .6
-.RS 4n
-A summary of the outcome of this operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBreason\fR\fR
-.ad
-.sp .6
-.RS 4n
-Additional information on the outcome of this operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrelease_note\fR\fR
-.ad
-.sp .6
-.RS 4n
-Indicates whether this operation generated release notes.
-.RE
+<varlistentry><term><command>pkg <option>R</option> <replaceable>dir</replaceable> dehydrate</command> [<option>nvq</option>] [<option>p</option> <replaceable>publisher</replaceable>]...</term>
+<listitem><para>Remove all non-editable packaged files and packaged hardlinks from the image specified by the <option>R</option> option to create a fully dehydrated image. Packaged files and packaged hardlinks are files and hardlinks that are delivered by the currently installed version of a package. A non-editable file cannot have any <literal>preserve</literal> or <literal>overlay</literal> attribute and cannot have a <literal>dehydrate</literal> attribute with a value of <literal>false</literal>.</para>
+<para>The <command>pkg dehydrate</command> command only operates on an alternate root. Use the <option>R</option> option to specify the alternate root. If the alternate root belongs to a boot environment, dehydration will render it unbootable.</para>
+<para>If the <command>pkg dehydrate</command> command succeeds, a property named <command>dehydrated</command> is set on the <replaceable>dir</replaceable> image specified by the <option>R</option> option. The value of the <command>dehydrated</command> property is a list of all publishers set in the <replaceable>dir</replaceable> image that have a configured package repository.</para>
+<para>Package installation operations on packages from a dehydrated publisher are automatically dehydrated. If you install a package in a dehydrated image, the package content is installed and then dehydrated. Package installation operations can include operations such as <command>update</command> and <command>change-facet</command> as well as <command>install</command>.</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Remove only non-editable files and hardlinks delivered by the specified publishers to create a partially dehydrated image. If all configured publishers of the image are specified, a fully dehydrated image is created as described above.</para>
+<para>If one or more publishers is specified, and if any of the publishers is not configured in the image, then nothing is removed from the image.</para>
+<para>If the <command>pkg dehydrate</command> command succeeds, a property named <command>dehydrated</command> is set on the <replaceable>dir</replaceable> image specified by the <option>R</option> option. The value of the <command>dehydrated</command> property is a list of all publishers specified by <option>p</option> options.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For all other options, see the <command>install</command> command above.</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsnapshot\fR\fR
-.ad
-.sp .6
-.RS 4n
-The snapshot taken during this operation. This is only recorded if the snapshot was not automatically removed after successful operation completion.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBstart\fR\fR
-.ad
-.sp .6
-.RS 4n
-The time that this operation started.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtime\fR\fR
-.ad
-.sp .6
-.RS 4n
-The total time taken to perform this operation. For operations that take less than one second, 0:00:00 is shown.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuser\fR\fR
-.ad
-.sp .6
-.RS 4n
-The username that started this operation.
-.RE
-
-If the \fBcommand\fR or \fBreason\fR columns are specified, they must be the last item in the \fB-o\fR list, in order to preserve output field separation. These two columns cannot be shown in the same \fBhistory\fR command.
-.sp
-An asterisk (*) is shown after the values for \fBbe\fR or \fBnew_be\fR if the boot environment is no longer present on the system.
-.sp
-The values for \fBbe\fR and \fBnew_be\fR are obtained by looking up the current boot environment name, using the \fBbe_uuid\fR or \fBnew_be_uuid\fR fields. If a boot environment was subsequently renamed, and later deleted, the values displayed for \fBbe\fR and \fBnew_be\fR are the values recorded at the time of the \fBpkg\fR operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fItime\fR\fR
-.ad
-.br
-.na
-\fB\fB-t\fR \fItime\fR-\fItime\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display log records for a comma-separated list of timestamps, formatted with \fB%Y-%m-%dT%H:%M:%S\fR (see the \fBstrftime\fR(3C) man page). To specify a range of times, use a hyphen (\fB-\fR) between a start and finish timestamp. The keyword \fBnow\fR can be used as an alias for the current time. This option can be specified multiple times. If the timestamps specified contain duplicate timestamps or overlapping ranges, duplicate history events are not displayed. Only a single instance of each history event is displayed.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg purge-history\fR\fR
-.ad
-.sp .6
-.RS 4n
-Delete all existing history information.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg rebuild-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-Rebuild the index used by \fBpkg search\fR. This is a recovery operation not intended for general use.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg update-format\fR\fR
-.ad
-.sp .6
-.RS 4n
-Update the format of the image to the current version. Once this operation has completed, the image can no longer be used with older versions of the \fBpkg\fR(5) system.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg version\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a unique string identifying the version of \fBpkg\fR. This string is not guaranteed to be comparable in any fashion between versions.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
+<varlistentry><term><command>pkg <option>R</option> <replaceable>dir</replaceable> rehydrate</command> [<option>nvq</option>] [<option>p</option> <replaceable>publisher</replaceable>]...</term>
+<listitem><para>Reinstall all files and hardlinks removed by the <command>pkg dehydrate</command> command.</para>
+<para>The <command>pkg rehydrate</command> command only operates on an alternate root. Use the <option>R</option> option to specify the alternate root.</para>
+<para>If the <command>pkg rehydrate</command> command succeeds, the value of the <command>dehydrated</command> property of the image is empty.</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Reinstall all files and hardlinks removed by the <command>pkg dehydrate</command> command for the specified publishers.</para>
+<para>If one or more publishers is specified, and if any of the publishers is not configured in the image, then nothing is installed.</para>
+<para>If the <command>pkg rehydrate</command> command succeeds, the specified publisher names are removed from the value of the <command>dehydrated</command> property set on the image. Publishers not specified in the <command>rehydrate</command> command remain listed in the <command>dehydrated</command> property, and content installed from those publishers will still be dehydrated.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For all other options, see the <command>install</command> command above.</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg image-create\fR [\fB-FPUfz\fR] [\fB--force\fR] [\fB--full\fR | \fB--partial\fR | \fB--user\fR] [\fB--zone\fR] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fI ssl_key\fR] [\fB-g\fR \fIpath_or_uri\fR | \fB--origin\fR \fIpath_or_uri\fR]... [\fB-m\fR \fIuri\fR | \fB--mirror\fR \fIuri\fR]... [\fB--facet\fR \fIfacet_name\fR=(\fBTrue\fR|\fBFalse\fR)]... [\fB--no-refresh\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--variant\fR \fIvariant_name\fR=\fIvalue\fR]... [(\fB-p\fR | \fB--publisher\fR) [\fIname\fR=]\fIrepo_uri\fR] \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-At the location given by \fIdir\fR, create an image suitable for package operations. Images created by using the \fBimage-create\fR subcommand are not bootable. Most users should use the \fB--be-name\fR or \fB--require-new-be\fR options with \fBpkg\fR commands, or use the \fBbeadm\fR or \fBzoneadm\fR commands to create images. The \fBpkg image-create\fR command is used for tasks such as maintaining packages and operating system distributions.
-.sp
-The default image type is user, which can be specified by using the \fB-U\fR or \fB--user\fR option. Alternatively, the image type can be set to a full image (\fB--F\fR or \fB--full\fR) or to a partial image (\fB-P\fR or \fB--partial\fR) linked to the full image enclosing the given \fIdir\fR path.
-.sp
-Additional origins can be specified using \fB-g\fR or \fB--origin\fR. Additional mirrors can be specified using \fB-m\fR or \fB--mirror\fR.
-.sp
-A package repository URI must be provided using the \fB-p\fR or \fB--publisher\fR option. If a publisher name is also provided, then only that publisher is added when the image is created. If a publisher name is not provided, then all publishers known by the specified repository are added to the image. An attempt to retrieve the catalog associated with this publisher is made following the initial creation operations.
-.sp
-For publishers using client SSL authentication, a client key and client certificate can be registered via the \fB-c\fR and \fB-k\fR options. This key and certificate are used for all publishers added during image creation.
-.sp
-If the image is to be run within non-global zone context, use the \fB-z\fR (\fB--zone\fR) option to set an appropriate variant.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.br
-.na
-\fB\fB--force\fR\fR
-.ad
-.sp .6
-.RS 4n
-Force the creation of an image over an existing image. This option should be used with care.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--facet\fR \fIfacet_name\fR=(\fBTrue\fR|\fBFalse\fR)\fR
-.ad
-.sp .6
-.RS 4n
-Set the specified facet to the indicated value. See "Facets and Variants" in the \fBpkg\fR(5) man page for more information about facets.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not attempt to contact the repositories for the image\&'s publishers to retrieve the newest list of available packages and other metadata.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Set the specified image property to the indicated value. See "Image Properties" below for descriptions of image properties.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--variant\fR \fIvariant_name\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Set the specified variant to the indicated value. See "Facets and Variants" in the \fBpkg\fR(5) man page for more information about variants.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg \fB-R\fR \fIdir\fR dehydrate\fR [\fB-nvq\fR] [\fB-p\fR \fIpublisher\fR]...\fR
-.ad
-.sp .6
-.RS 4n
-Remove all non-editable packaged files and packaged hardlinks from the image specified by the \fB-R\fR option to create a fully dehydrate image. A non-editable packaged file is a file delivered by the currently installed version of a package that has no \fBpreserve\fR or \fBoverlay\fR attribute, or has a \fBdehydrate\fR value of \fBFalse\fR. A packaged hardlink is a hardlink delivered by the currently installed version of a package. 
-.sp
-The \fBpkg dehydrate\fR command only operates on an alternate root. Use the \fB-R\fR option to specify the alternate root. If the alternate root belongs to a boot environment, dehydration will render it unbootable.
-.sp
-If the \fBpkg dehydrate\fR command succeeds, a property named \fBdehydrated\fR is set on the \fIdir\fR image specified by the \fB-R\fR option. The value of the \fBdehydrated\fR property is a list of all publishers set in the \fIdir\fR image that have a configured package repository.
-.sp
-Package installation operations on packages from a dehydrated publisher are automatically dehydrated. If you install a package in a dehydrated image, the package content is installed and then dehydrated. Package installation operations can include operations such as \fBupdate\fR and \fBchange-facet\fR as well as \fBinstall\fR.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Remove only non-editable files and hardlinks delivered by the specified publishers to create a partially dehydrated image. If all configured publishers of the image are specified, a fully dehydrated image is created as described above.
-.sp
-If one or more publishers is specified, and if any of the publishers is not configured in the image, then nothing is removed from the image.
-.sp
-If the \fBpkg dehydrate\fR command succeeds, a property named \fBdehydrated\fR is set on the \fIdir\fR image specified by the \fB-R\fR option. The value of the \fBdehydrated\fR property is a list of all publishers specified by \fB-p\fR options.
-.RE
-
-For all other options, see the \fBinstall\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg \fB-R\fR \fIdir\fR rehydrate\fR [\fB-nvq\fR] [\fB-p\fR \fIpublisher\fR]...\fR
-.ad
-.sp .6
-.RS 4n
-Reinstall all files and hardlinks removed by the \fBpkg dehydrate\fR command.
-.sp
-The \fBpkg rehydrate\fR command only operates on an alternate root. Use the \fB-R\fR option to specify the alternate root.
-.sp
-If the \fBpkg rehydrate\fR command succeeds, the value of the \fBdehydrated\fR property of the image is empty.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Reinstall all files and hardlinks removed by the \fBpkg dehydrate\fR command for the specified publishers.
-.sp
-If one or more publishers is specified, and if any of the the publishers is not configured in the image, then nothing is installed.
-.sp
-If the \fBpkg rehydrate\fR command succeeds, the specified publisher names are removed from the value of the \fBdehydrated\fR property set on the image. Publishers not specified in the \fBrehydrate\fR command remain listed in the \fBdehydrated\fR property, and content installed from those publishers will still be dehydrated.
-.RE
-
-For all other options, see the \fBinstall\fR command above.
-.RE
-
-.SH IMAGE PROPERTIES
-.sp
-.LP
-The following properties define characteristics of the image. These properties store information about the purpose, content, and behavior of the image. To view the current values of these properties in the image, use the \fBpkg property\fR command. To modify the values of these properties, use the \fBpkg set-property\fR and \fBpkg unset-property\fR commands.
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(string) Specify when a boot environment is created during packaging operations. The following values are allowed:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.sp .6
-.RS 4n
-Apply the default boot environment creation policy, \fBcreate-backup\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalways-new\fR\fR
-.ad
-.sp .6
-.RS 4n
-Requires a reboot for all package operations by performing them in a new boot environment set as active on the next boot. A backup boot environment is not created unless explicitly requested.
-.sp
-This policy is the safest, but is more strict than most sites need since no packages can be added without a reboot.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcreate-backup\fR\fR
-.ad
-.sp .6
-.RS 4n
-For package operations that require a reboot, a new boot environment is created and set as active on the next boot. If packages are modified or content that could affect the kernel is installed and the operation affects the live boot environment, a backup boot environment is created but not set as active. A backup boot environment can also be explicitly requested.
-.sp
-This policy is potentially risky only if newly installed software causes system instability, which is possible but relatively rare.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwhen-required\fR\fR
-.ad
-.sp .6
-.RS 4n
-For package operations that require a reboot, a new boot environment is created and set as active on the next boot. A backup boot environment is not created unless explicitly requested.
-.sp
-This policy carries the greatest risk since if a packaging change to the live boot environment makes further changes impossible, there might be no recent boot environment to which one can fallback.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBca-path\fR\fR
-.ad
-.sp .6
-.RS 4n
-(string) A path name that points to a directory where CA certificates are kept for SSL operations. The format of this directory is specific to the underlying SSL implementation. To use an alternate location for trusted CA certificates, change this value to point to a different directory. See the \fBCApath\fR portions of \fBSSL_CTX_load_verify_locations\fR(3openssl) for requirements for the CA directory.
-.sp
-Default value: \fB/etc/openssl/certs\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcheck-certificate-revocation\fR\fR
-.ad
-.sp .6
-.RS 4n
-(boolean) If this is set to \fBTrue\fR, the package client attempts to contact any CRL distribution points in the certificates used for signature verification to determine whether the certificate has been revoked since being issued.
-.sp
-Default value: \fBFalse\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcontent-update-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(string) Specify when the package system will update non-editable files during packaging operations. The following values are allowed:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.sp .6
-.RS 4n
-Always apply the default content update policy.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalways\fR\fR
-.ad
-.sp .6
-.RS 4n
-Always download and update non-editable files that have changed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwhen-required\fR\fR
-.ad
-.sp .6
-.RS 4n
-Download and update non-editable files that have changed only if the package system has determined that an update is required.
-.RE
-
-Default value: \fBalways\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBflush-content-cache-on-success\fR\fR
-.ad
-.sp .6
-.RS 4n
-(boolean) If this is set to \fBTrue\fR, the package client removes the files in its content-cache when image-modifying operations complete successfully. For operations that create a boot environment, the content will be removed from both the source and destination boot environment.
-.sp
-This property can be used to keep the content-cache small on systems with limited disk space. This property can cause operations to take longer to complete.
-.sp
-Default value: \fBTrue\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmirror-discovery\fR\fR
-.ad
-.sp .6
-.RS 4n
-(boolean) This property tells the client to discover link-local content mirrors using mDNS and DNS-SD. If this property is set to \fBTrue\fR, the client attempts to download package content from mirrors it dynamically discovers. To run a mirror that advertises its content via mDNS, see the \fBpkg.depotd\fR(1M) man page.
-.sp
-Default value: \fBFalse\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsend-uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-(boolean) Send the image\&'s Universally Unique Identifier (UUID) when performing network operations. Although users can disable this option, some network repositories might refuse to talk to clients that do not supply a UUID.
-.sp
-Default value: \fBTrue\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(string) Determine what checks will be performed on manifests when installing, updating, modifying, or verifying packages in the image. The final policy applied to a package depends on the combination of image policy and publisher policy. The combination will be at least as strict as the stricter of the two policies taken individually. By default, the package client does not check whether certificates have been revoked. To enable those checks, which might require the client to contact external Internet sites, set the \fBcheck-certificate-revocation\fR image property to \fBTrue\fR. The following values are allowed:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBignore\fR\fR
-.ad
-.sp .6
-.RS 4n
-Ignore signatures for all manifests.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBverify\fR\fR
-.ad
-.sp .6
-.RS 4n
-Verify that all manifests with signatures are validly signed, but do not require all installed packages to be signed. This is the default value.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-signatures\fR\fR
-.ad
-.sp .6
-.RS 4n
-Require that all newly installed packages have at least one valid signature. The \fBpkg fix\fR and \fBpkg verify\fR commands also warn if an installed package does not have a valid signature.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-Follow the same requirements as \fBrequire-signatures\fR but also require that the strings listed in the \fBsignature-required-names\fR property appear as a common name of the certificates used to verify the chains of trust of the signatures.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-(list of strings) A list of names that must be seen as common names of certificates while validating the signatures of a package.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtrust-anchor-directory\fR\fR
-.ad
-.sp .6
-.RS 4n
-(string) The path name of the directory that contains the trust anchors for the image. This path is relative to the image. The default value is \fBignore\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuse-system-repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-(boolean) This property indicates whether the image should use the system repository as a source for image and publisher configuration and as a proxy for communicating with the publishers provided. The default value is \fBFalse\fR. See the \fBpkg.sysrepo\fR(1M) man page for information about system repositories.
-.RE
-
-.SH PUBLISHER PROPERTIES
-.sp
-.LP
-The following properties define signature policy for a particular publisher. The image properties of the same name define signature policy for the image. To view the current values of these properties for a particular publisher, use the \fBpkg publisher\fR \fIpublisher_name\fR command. To modify the values of these publisher signature policy properties, use the \fB--set-property\fR and \fB--unset-property\fR options of the \fBpkg set-publisher\fR command.
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(string) This property functions identically to the image property of the same name except that it only applies to packages from the particular publisher.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-(list of strings) This property functions identically to the image property of the same name except that it only applies to packages from the particular publisher.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRCreate an Image With Publisher Configured
-.sp
-.LP
-Create a new, full image, with publisher \fBexample.com\fR, stored at \fB/aux0/example_root\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F -p example.com=http://pkg.example.com:10000 \e\fR
-\fB/aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRCreate an Image, Specifying Additional Origins and Mirror
-.sp
-.LP
-Create a new, full image, with publisher \fBexample.com\fR, that also has an additional mirror, two additional origins, and is stored at \fB/aux0/example_root\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F -p example.com=http://pkg.example.com:10000 \e\fR
-\fB-g http://alternate1.example.com:10000/ \e\fR
-\fB-g http://alternate2.example.com:10000/ \e\fR
-\fB-m http://mirror.example.com:10000/ \e\fR
-\fB/aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 3 \fRCreate an Image With No Publisher Configured
-.sp
-.LP
-Create a new, full image with no publishers configured at \fB/aux0/example_root\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 4 \fRInstall a Package
-.sp
-.LP
-Install the latest version of the \fBwidget\fR package in the current image.
-
-.sp
-.in +2
-.nf
-$ \fBpkg install application/widget\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 5 \fRList Specified Contents of a Package
-.sp
-.LP
-List the contents of the \fBsystem/file-system/zfs\fR package. Display the action name, the mode of the file (if defined), the size (if defined), the path, and the target (if a link). Limit the action to types \fBdir\fR, \fBfile\fR, \fBlink\fR, and \fBhardlink\fR, since specifying the \fBaction.name\fR attribute, which is available for all actions, displays a line for all actions, which is not desired here.
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -t dir,file,link,hardlink \e\fR
-\fB-o action.name,mode,pkg.size,path,target system/file-system/zfs\fR
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>Image Properties</title>
+<para>The following properties define characteristics of the image. These
+properties store information about the purpose, content, and behavior of the
+image. To view the current values of these properties in the image, use the
+<command>pkg property</command> command. To modify the values of these
+properties, use the <command>pkg set-property</command> and
+<command>pkg unset-property</command> commands.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>be-policy</literal></term>
+<listitem><para>(string) Specify when a boot environment is created during
+packaging operations. The following values are allowed:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>Apply the default boot environment creation policy, <literal>create-backup
+</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>always-new</literal></term>
+<listitem><para>Requires a reboot for all package operations by performing them
+in a new boot environment set as active on the next boot. A backup boot
+environment is not created unless explicitly requested.</para>
+<para>This policy is the safest, but is more strict than most sites need since
+no packages can be added without a reboot.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>create-backup</literal></term>
+<listitem><para>For package operations that require a reboot, a new boot environment
+is created and set as active on the next boot. If packages are modified or
+content that could affect the kernel is installed and the operation affects
+the live boot environment, a backup boot environment is created but not set
+as active. A backup boot environment can also be explicitly requested.</para>
+<para>This policy is potentially risky only if newly installed software causes
+system instability, which is possible but relatively rare.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>when-required</literal></term>
+<listitem><para>For package operations that require a reboot, a new boot environment
+is created and set as active on the next boot. A backup boot environment is
+not created unless explicitly requested.</para>
+<para>This policy carries the greatest risk since if a packaging change to
+the live boot environment makes further changes impossible, there might be
+no recent boot environment to which one can fallback.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>ca-path</literal></term>
+<listitem><para>(string) A path name that points to a directory where CA certificates
+are kept for SSL operations. The format of this directory is specific to the
+underlying SSL implementation. To use an alternate location for trusted CA
+certificates, change this value to point to a different directory. See the <literal>
+CApath</literal> portions of <literal>SSL_CTX_load_verify_locations</literal>(3openssl)
+for requirements for the CA directory.</para>
+<para>Default value: <literal>/etc/openssl/certs</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>check-certificate-revocation</literal></term>
+<listitem><para>(boolean) If this is set to <literal>True</literal>, the package
+client attempts to contact any CRL distribution points in the certificates
+used for signature verification to determine whether the certificate has been
+revoked since being issued.</para>
+<para>Default value: <literal>False</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>content-update-policy</literal></term>
+<listitem><para>(string) Specify when the package system will update non-editable files during packaging operations. The following values are allowed:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>Always apply the default content update policy.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>always</literal></term>
+<listitem><para>Always download and update non-editable files that have changed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>when-required</literal></term>
+<listitem><para>Download and update non-editable files that have changed only if the package system has determined that an update is required.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Default value: <literal>always</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>flush-content-cache-on-success</literal></term>
+<listitem><para>(boolean) If this is set to <literal>True</literal>, the package
+client removes the files in its content-cache when image-modifying operations
+complete successfully. For operations that create a boot environment, the
+content will be removed from both the source and destination boot
+environment.</para>
+<para>This property can be used to keep the content-cache small on systems
+with limited disk space. This property can cause operations to take longer
+to complete.</para>
+<para>Default value: <literal>True</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mirror-discovery</literal></term>
+<listitem><para>(boolean) This property tells the client to discover link-local content mirrors using mDNS and
+DNS-SD. If this property is set to <literal>True</literal>, the client attempts to download package
+content from mirrors it dynamically discovers. To run a mirror that advertises its content via mDNS,
+see the <command>pkg.depotd</command>(1M) man page.</para>
+<para>Default value: <literal>False</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>send-uuid</literal></term>
+<listitem><para>(boolean) Send the image&rsquo;s Universally Unique Identifier (UUID)
+when performing network operations. Although users can disable this option,
+some network repositories might refuse to talk to clients that do not supply
+a UUID.</para>
+<para>Default value: <literal>True</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-policy</literal></term>
+<listitem><para>(string) Determine what checks will be performed on manifests
+when installing, updating, modifying, or verifying packages in the image.
+The final policy applied to a package depends on the combination of image
+policy and publisher policy. The combination will be at least as strict as
+the stricter of the two policies taken individually. By default, the package
+client does not check whether certificates have been revoked. To enable those
+checks, which might require the client to contact external Internet sites, set
+the <literal>check-certificate-revocation</literal> image property to
+<literal>True</literal>. The following values are allowed:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>ignore</literal></term>
+<listitem><para>Ignore signatures for all manifests.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>verify</literal></term>
+<listitem><para>Verify that all manifests with signatures are validly signed,
+but do not require all installed packages to be signed. This is the default
+value.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-signatures</literal></term>
+<listitem><para>Require that all newly installed packages have at least one
+valid signature. The <command>pkg fix</command> and <command>pkg verify</command> commands
+also warn if an installed package does not have a valid signature.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-names</literal></term>
+<listitem><para>Follow the same requirements as <literal>require-signatures</literal> but
+also require that the strings listed in the <literal>signature-required-names</literal> property
+appear as a common name of the certificates used to verify the chains of trust
+of the signatures.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-required-names</literal></term>
+<listitem><para>(list of strings) A list of names that must be seen as common
+names of certificates while validating the signatures of a package.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>trust-anchor-directory</literal></term>
+<listitem><para>(string) The path name of the directory that contains the
+trust anchors for the image. This path is relative to the image. The default
+value is <literal>ignore</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>use-system-repo</literal></term>
+<listitem><para>(boolean) This property indicates whether the image should
+use the system repository as a source for image and publisher configuration
+and as a proxy for communicating with the publishers provided. The default
+value is <literal>False</literal>. See the <command>pkg.sysrepo</command>(1M)
+man page for information about system repositories.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>Publisher Properties</title>
+<para>The following properties define signature policy for a particular publisher.
+The image properties of the same name define signature policy for the image.
+To view the current values of these properties for a particular publisher,
+use the <command>pkg publisher</command> <replaceable>publisher_name</replaceable> command.
+To modify the values of these publisher signature policy properties, use the <option>
+-set-property</option> and <option>-unset-property</option> options of the <command>
+pkg set-publisher</command> command.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>signature-policy</literal></term>
+<listitem><para>(string) This property functions identically to the image
+property of the same name except that it only applies to packages from the
+particular publisher.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-required-names</literal></term>
+<listitem><para>(list of strings) This property functions identically to the
+image property of the same name except that it only applies to packages from
+the particular publisher.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Create an Image With Publisher Configured</title>
+<para>Create a new, full image, with publisher <literal>example.com</literal>,
+stored at <literal>/aux0/example_root</literal>.</para>
+<screen>$ <userinput>pkg image-create -F -p example.com=http://pkg.example.com:10000 &bsol;</userinput>
+<userinput>/aux0/example_root</userinput></screen>
+</example>
+<example id="GLGIN"><title>Create an Image, Specifying Additional Origins and Mirror</title>
+<para>Create a new, full image, with publisher <literal>example.com</literal>,
+that also has an additional mirror, two additional origins, and is stored
+at <literal>/aux0/example_root</literal>.</para>
+<screen>$ <userinput>pkg image-create -F -p example.com=http://pkg.example.com:10000 &bsol;</userinput>
+<userinput>-g http://alternate1.example.com:10000/ &bsol;</userinput>
+<userinput>-g http://alternate2.example.com:10000/ &bsol;</userinput>
+<userinput>-m http://mirror.example.com:10000/ &bsol;</userinput>
+<userinput>/aux0/example_root</userinput></screen>
+</example>
+<example><title>Create an Image With No Publisher Configured</title>
+<para>Create a new, full image with no publishers configured at <literal>/aux0/example_root
+</literal>.</para>
+<screen>$ <userinput>pkg image-create -F /aux0/example_root</userinput></screen>
+</example>
+<example><title>Install a Package</title>
+<para>Install the latest version of the <literal>widget</literal> package
+in the current image.</para>
+<screen>$ <userinput>pkg install application/widget</userinput></screen>
+</example>
+<example><title>List Specified Contents of a Package</title>
+<para>List the contents of the <literal>system/file-system/zfs</literal> package.
+Display the action name, the mode of the file (if defined), the size (if defined),
+the path, and the target (if a link). Limit the action to types <literal>dir</literal>, <literal>
+file</literal>, <literal>link</literal>, and <literal>hardlink</literal>,
+since specifying the <literal>action.name</literal> attribute, which is available
+for all actions, displays a line for all actions, which is not desired here.</para>
+<screen>$ <userinput>pkg contents -t dir,file,link,hardlink &bsol;</userinput>
+<userinput>-o action.name,mode,pkg.size,path,target system/file-system/zfs</userinput>
 ACTION.NAME MODE PKG.SIZE PATH                 TARGET
 dir         0755          etc
 dir         0755          etc/fs
@@ -3359,42 +1982,25 @@
 dir         0755          kernel/fs
 dir         0755          kernel/fs/amd64
 hardlink                  kernel/fs/amd64/zfs  ../../../kernel/drv/amd64/zfs
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 6 \fRList Specified Contents of Two Packages
-.sp
-.LP
-List the contents of \fBweb/browser/firefox\fR and \fBmail/thunderbird\fR, limiting the display to just the package name and path attributes of actions whose \fBpath\fR attribute ends in \fB\&.desktop\fR or \fB\&.png\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -o pkg.name,path -a path=\e*.desktop \e\fR
-\fB-a path=\e*.png web/browser/firefox mail/thunderbird\fR
+...</screen>
+</example>
+<example><title>List Specified Contents of Two Packages</title>
+<para>List the contents of <literal>web/browser/firefox</literal> and <literal>mail/thunderbird
+</literal>, limiting the display to just the package name and path attributes
+of actions whose <literal>path</literal> attribute ends in <filename>.desktop</filename> or <filename>
+.png</filename>.</para>
+<screen>$ <userinput>pkg contents -o pkg.name,path -a path=&bsol;*.desktop &bsol;</userinput>
+<userinput>-a path=&bsol;*.png web/browser/firefox mail/thunderbird</userinput>
 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
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 7 \fRSearch for a Package
-.sp
-.LP
-Search the package database for the token \fBbge\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg search bge\fR
+...</screen>
+</example>
+<example><title>Search for a Package</title>
+<para>Search the package database for the token <literal>bge</literal>.</para>
+<screen>$ <userinput>pkg search bge</userinput>
 INDEX       ACTION VALUE                                 PACKAGE
 driver_name driver bge                                   pkg:/driver/network/ethernet/[email protected]
 basename    file   kernel/drv/sparcv9/bge                pkg:/driver/network/ethernet/[email protected]
@@ -3402,81 +2008,50 @@
 basename    file   platform/sun4v/kernel/drv/sparcv9/bge pkg:/system/kernel/[email protected]
 pkg.fmri    set    solaris/driver/network/bge            pkg:/driver/network/[email protected]
 pkg.fmri    set    solaris/driver/network/ethernet/bge   pkg:/driver/network/ethernet/[email protected]
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-The token is in the package \fBdriver/network/bge\fR both as the basename for the file action representing \fB/kernel/drv/\fIarch\fR/bge\fR and as a driver name.
-
-.LP
-\fBExample 8 \fRSearch for a File
-.sp
-.LP
-Search for the package that delivers a file by specifying the full path name of the file, including the leading slash character.
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l /usr/bin/vim\fR
+</screen>
+<para>The token is in the package <literal>driver/network/bge</literal> both
+as the basename for the file action representing <filename>/kernel/drv/<replaceable>
+arch</replaceable>/bge</filename> and as a driver name.</para>
+</example>
+<example id="GMEDQ"><title>Search for a File</title>
+<para>Search for the package that delivers a file by specifying the full path
+name of the file, including the leading slash character.</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l /usr/bin/vim</userinput>
 PATH         PKG.NAME
-usr/bin/vim  editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Search for a file and the package that delivers that file by specifying \fBfile\fR for the \fIaction_name\fR, \fBpath\fR or \fBbasename\fR for the \fIindex\fR, and the full or partial file name for the \fItoken\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l file:basename:vim\fR
+usr/bin/vim  editor/vim/vim-core</screen>
+<para>Search for a file and the package that delivers that file by specifying <literal>
+file</literal> for the <replaceable>action_name</replaceable>, <literal>path</literal> or <literal>
+basename</literal> for the <replaceable>index</replaceable>, and the full
+or partial file name for the <replaceable>token</replaceable>.</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l file:basename:vim</userinput>
 PATH         PKG.NAME
-usr/bin/vim  editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 9 \fRSearch for Files and Directories
-.sp
-.LP
-Search for files and directories and the packages that deliver them by specifying \fBpath\fR or \fBbasename\fR for the \fIindex\fR and the full or partial file name for the \fItoken\fR. Depending on your shell, you might need to escape wildcards.
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l path:*/vim\fR
+usr/bin/vim  editor/vim/vim-core</screen>
+</example>
+<example id="GMECW"><title>Search for Files and Directories</title>
+<para>Search for files and directories and the packages that deliver them
+by specifying <literal>path</literal> or <literal>basename</literal> for the <replaceable>
+index</replaceable> and the full or partial file name for the <replaceable>token</replaceable>.
+Depending on your shell, you might need to escape wildcards.</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l path:*/vim</userinput>
 PATH           PKG.NAME
 usr/bin/vim    editor/vim/vim-core
 usr/share/vim  editor/vim
 usr/share/vim  editor/vim/vim-core
-$ \fBpkg search -o path,pkg.name -l basename:vim\fR
+$ <userinput>pkg search -o path,pkg.name -l basename:vim</userinput>
 PATH           PKG.NAME
 usr/share/vim  editor/vim
 usr/share/vim  editor/vim/vim-core
-usr/bin/vim    editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 10 \fRShow Which Packages Provide Which SMF Services
-.sp
-.LP
-Show which packages provide a particular SMF service by specifying the value \fBorg.opensolaris.smf.fmri\fR for the \fIindex\fR in a structured search and the name of the service you want to find for the \fItoken\fR. The value \fBorg.opensolaris.smf.fmri\fR is the name of an attribute of a \fBset\fR action. Remember to escape the : in the name of the service.
-
-.sp
-.LP
-For example, show which HTTP servers are available by specifying the value \fBsvc:/network/http\fR for the \fItoken\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg search 'org.opensolaris.smf.fmri:svc\e:/network/http*'\fR
+usr/bin/vim    editor/vim/vim-core</screen>
+</example>
+<example id="GMEGA"><title>Show Which Packages Provide Which SMF Services</title>
+<para>Show which packages provide a particular SMF service by specifying the
+value <literal>org.opensolaris.smf.fmri</literal> for the <replaceable>index</replaceable> in
+a structured search and the name of the service you want to find for the <replaceable>
+token</replaceable>. The value <literal>org.opensolaris.smf.fmri</literal> is
+the name of an attribute of a <literal>set</literal> action. Remember to escape
+the : in the name of the service.</para>
+<para>For example, show which HTTP servers are available by specifying the value <literal>svc:/network/http</literal> for the <replaceable>token</replaceable>.</para>
+<screen>$ <userinput>pkg search 'org.opensolaris.smf.fmri:svc&bsol;:/network/http*'</userinput>
 INDEX                    ACTION VALUE                        PACKAGE
 org.opensolaris.smf.fmri set    svc:/network/http            pkg:/web/server/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http            pkg:/web/proxy/[email protected]
@@ -3488,696 +2063,326 @@
 org.opensolaris.smf.fmri set    svc:/network/http:privoxy    pkg:/web/proxy/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http:squid      pkg:/web/proxy/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http:tomcat6    pkg:/web/java-servlet/[email protected]
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 11 \fRSearch for Packages that Depend on the Specified Package
-.sp
-.LP
-Search for installed packages that depend on \fBpackage/pkg\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -l depend::package/pkg\fR
+</screen>
+</example>
+<example><title>Search for Packages that Depend on the Specified Package</title>
+<para>Search for installed packages that depend on <literal>package/pkg</literal>.</para>
+<screen>$ <userinput>pkg search -l depend::package/pkg</userinput>
 INDEX       ACTION VALUE                                    PACKAGE
 incorporate depend package/[email protected]      pkg:/consolidation/ips/[email protected]
-require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/library/[email protected]
-require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/library/[email protected]
 require     depend package/pkg                             pkg:/system/zones/brand/[email protected]
 require     depend pkg:/package/[email protected] pkg:/install/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/[email protected]
 require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 12 \fRSearch for Dependencies
-.sp
-.LP
-Search for all \fBincorporate\fR dependencies in installed packages.
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -l depend:incorporate:\fR
+</screen>
+</example>
+<example><title>Search for Dependencies</title>
+<para>Search for all <literal>incorporate</literal> dependencies in installed
+packages.</para>
+<screen>$ <userinput>pkg search -l depend:incorporate:</userinput>
 INDEX       ACTION VALUE                                PACKAGE
 incorporate depend pkg:/[email protected]  pkg:/consolidation/osnet/[email protected]
 incorporate depend pkg:/[email protected] pkg:/consolidation/osnet/[email protected]
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 13 \fRAdd a Publisher
-.sp
-.LP
-Add a new publisher \fBexample.com\fR, with a repository located at \fBhttp://www.example.com/repo\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g http://www.example.com/repo example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 14 \fRAdd a Publisher With Key and Certificate
-.sp
-.LP
-Add a new publisher \fBexample.com\fR, with a secure repository located at \fBhttps://secure.example.com/repo\fR, and a key and certificate stored in the directory \fB/root/creds\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -k /root/creds/example.key \e\fR
-\fB-c /root/creds/example.cert -g https://secure.example.com/repo \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 15 \fRAdd and Automatically Configure a Publisher
-.sp
-.LP
-Add a new publisher with a repository located at \fB/export/repo\fR using automatic configuration.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -p /export/repo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 16 \fRAdd and Manually Configure a Publisher
-.sp
-.LP
-Add a new publisher \fBexample.com\fR with a repository located at \fB/export/repo/example.com\fR using manual configuration.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g /export/repo example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 17 \fRAdd a Publisher and Configure a Proxy
-.sp
-.LP
-Add a new publisher \fBmypub\fR with origin \fBhttp://server/repo\fR and proxy \fBhttp://webcache:8080\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g http://server/repo \e\fR
-\fB--proxy http://webcache:8080 mypub\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 18 \fRVerify All Signed Packages
-.sp
-.LP
-Configure an image to verify all signed packages.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-property signature-policy verify\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 19 \fRRequire All Packages To Be Signed
-.sp
-.LP
-Configure an image to require all packages to be signed, and require the string \fBexample.com\fR to be seen as a common name for one of the certificates in the chain of trust.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-property signature-policy require-names example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 20 \fRRequire All Packages From a Specified Publisher To Be Signed
-.sp
-.LP
-Configure an image so that all packages installed from publisher \fBexample.com\fR must be signed.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --set-property signature-policy=require-signatures \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 21 \fRRequire a Specified String in the Chain of Trust
-.sp
-.LP
-Add the string \fBfoo\fR to the image\&'s list of common names that must be seen in a signature\&'s chain of trust to be considered valid.
-
-.sp
-.in +2
-.nf
-$ \fBpkg add-property-value signature-require-names foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 22 \fRRemove a String From the Chain of Trust for a Specified Publisher
-.sp
-.LP
-Remove the string \fBfoo\fR from the list of common names that must be seen to validate a signature for the publisher \fBexample.com\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --remove-property-value signature-require-names=foo \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 23 \fRAdd a Trusted CA Certificate
-.sp
-.LP
-Add the certificate stored in \fB/tmp/example_file.pem\fR as a trusted CA certificate for the publisher \fBexample.com\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --approve-ca-cert /tmp/example_file.pem \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 24 \fRRevoke a Certificate
-.sp
-.LP
-Revoke the certificate with the hash \fBa12345\fR for publisher \fBexample.com\fR, preventing the certificate from validating any signatures for packages from \fBexample.com\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --revoke-ca-cert a12345 example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 25 \fRForget About a Certificate
-.sp
-.LP
-Make \fBpkg\fR forget that the certificate \fBa12345\fR was ever added or revoked by the user.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --unset-ca-cert a12345 example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 26 \fRDowngrade a Package
-.sp
-.LP
-Downgrade the installed package \[email protected]\fR to an older version.
-
-.sp
-.in +2
-.nf
-$ \fBpkg update [email protected]\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 27 \fRSwitch Conflicting Package Installation
-.sp
-.LP
-In the case of two conflicting packages, change which package is installed. Suppose package A depends on either package B or package C, and B and C are mutually exclusive. If A and B are installed, use the following command to switch to using C instead of B without uninstalling A:
-
-.sp
-.in +2
-.nf
-$ \fBpkg install --reject B C\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 28 \fRList Packages in a Package Archive
-.sp
-.LP
-List all versions of all packages in a package archive.
-
-.sp
-.in +2
-.nf
-$ \fBpkg list -f -g /my/archive.p5p\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 29 \fRList Packages in a Package Repository
-.sp
-.LP
-List all versions of all packages in a repository.
-
-.sp
-.in +2
-.nf
-$ \fBpkg list -f -g http://example.com:10000\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 30 \fRDisplay Information About a Package in a Package Archive
-.sp
-.LP
-Display the package information for the latest version of a package in a package archive. The package might or might not be currently installed.
-
-.sp
-.in +2
-.nf
-$ \fBpkg info -g /my/archive.p5p pkg_name\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 31 \fRDisplay Contents of a Package in a Package Archive
-.sp
-.LP
-Display the contents of a package in a package archive. The package is not currently installed.
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -g /my/archive.p5p pkg_name\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 32 \fRRemove All Publisher Origins and Mirrors
-.sp
-.LP
-Remove all of the origins and mirrors for a publisher and add a new origin.
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -G '*' -M '*' -g http://example.com:10000 \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 33 \fRDehydrating and Rehydrating an Image
-.sp
-.LP
-In these examples, \fB/tmp/test_image\fR is the image that you want to dehydrate and rehydrate.
-
-.sp
-.LP
-Because no publisher is specified, the following command fully dehydrates the \fB/tmp/test_image\fR image by operating on all publishers that are enabled in the \fB/tmp/test_image\fR image.
-
-.sp
-.in +2
-.nf
-$ \fBpkg -R /tmp/test_image dehydrate\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Because no publisher is specified, the following command operates on all publishers configured in the \fB/tmp/test_image\fR image to fully restore the \fB/tmp/test_image\fR image.
-
-.sp
-.in +2
-.nf
-$ \fBpkg -R /tmp/test_image rehydrate\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 34 \fRDehydrating and Rehydrating an Image Specifying Publishers
-.sp
-.LP
-In these examples, \fB/tmp/test_image\fR is the image that you want to dehydrate and rehydrate, and the \fBtest1\fR and \fBtest2\fR publishers are enabled in the \fB/tmp/test_image\fR image and their origins provide the necessary content.
-
-.sp
-.LP
-The following command operates only on files and hardlinks delivered by the \fBtest1\fR publisher.
-
-.sp
-.in +2
-.nf
-$ \fBpkg -R /tmp/test_image dehydrate -p test1\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-The following command rehydrates only files and hardlinks delivered by the \fBtest1\fR publisher.
-
-.sp
-.in +2
-.nf
-$ \fBpkg -R /tmp/test_image rehydrate -p test1\fR
-.fi
-.in -2
-.sp
-
-.SH ENVIRONMENT VARIABLES
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_IMAGE\fR\fR
-.ad
-.sp .6
-.RS 4n
-The directory containing the image to use for package operations. Ignored if \fB-R\fR is specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_CONNECT_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-Seconds to wait trying to connect during transport operations (for each attempt) before the client aborts the operation. A value of 0 means wait indefinitely.
-.sp
-Default value: 60
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_LOWSPEED_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-Seconds below the \fBlowspeed\fR limit (1024 bytes/second) during transport operations before the client aborts the operation. A value of 0 means do not abort the operation.
-.sp
-Default value: 30
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_CONSECUTIVE_ERROR\fR\fR
-.ad
-.sp .6
-.RS 4n
-Maximum number of transient transport errors before the client aborts the operation. A value of 0 means do not abort the operation.
-.sp
-Default value: 4
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_REDIRECT\fR\fR
-.ad
-.sp .6
-.RS 4n
-Maximum number of HTTP or HTTPS redirects allowed during transport operations before a connection is aborted. A value of 0 means do not abort the operation.
-.sp
-Default value: 5
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CONCURRENCY\fR\fR
-.ad
-.sp .6
-.RS 4n
-The number of child images to update in parallel. Ignored if the \fB-C\fR option is specified.
-.sp
-When recursing into child images (usually installed \fBsolaris\fR branded non-global zones), update at most \fB$PKG_CONCURRENCY\fR child images in parallel. If \fB$PKG_CONCURRENCY\fR is 0 or a negative number, all child images are updated in parallel.
-.sp
-Default value: 1
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-Maximum number of transport attempts per host before the client aborts the operation. A value of 0 means do not abort the operation.
-.sp
-Default value: 4
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhttp_proxy\fR, \fBhttps_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-HTTP or HTTPS proxy server.
-.RE
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-Multiple operations were requested, but only some of them succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB4\fR\fR
-.ad
-.RS 6n
-.rt  
-No changes were made - nothing to do.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB5\fR\fR
-.ad
-.RS 6n
-.rt  
-The requested operation cannot be performed on a live image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB6\fR\fR
-.ad
-.RS 6n
-.rt  
-The requested operation cannot be completed because the licenses for the packages being installed or updated have not been accepted.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB7\fR\fR
-.ad
-.RS 6n
-.rt  
-The image is currently in use by another process and cannot be modified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB8\fR\fR
-.ad
-.RS 6n
-.rt  
-One or more SMF actuators timed out.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH FILES
-.sp
-.LP
-A \fBpkg\fR(5) image can be located arbitrarily within a larger file system. In the following file descriptions, the token \fB$IMAGE_ROOT\fR is used to distinguish relative paths. For a typical system installation, \fB$IMAGE_ROOT\fR is equivalent to \fB/\fR
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-Metadata directory for a full or partial image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-Metadata directory for a user image.
-.RE
-
-.sp
-.LP
-Within a particular image\&'s metadata, certain files and directories can contain information useful during repair and recovery. The token \fB$IMAGE_META\fR refers to the top-level directory containing the metadata. \fB$IMAGE_META\fR is typically one of the two paths given above.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/lost+found\fR\fR
-.ad
-.sp .6
-.RS 4n
-Location of conflicting directories and files moved during a package operation. Location of unpackaged contents of a removed directory.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Contains a directory for each publisher. Each directory stores publisher-specific metadata.
-.RE
-
-.sp
-.LP
-Other paths within the \fB$IMAGE_META\fR directory hierarchy are private and are subject to change.
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkgsend\fR(1), \fBbeadm\fR(1M), \fBpkg.depotd\fR(1M), \fBpkg.sysrepo\fR(1M), \fBglob\fR(3C), \fBpkg\fR(5)
-.sp
-.LP
-\fIAdding and Updating Software in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
+...</screen>
+</example>
+<example><title>Add a Publisher</title>
+<para>Add a new publisher <literal>example.com</literal>, with a repository
+located at <literal>http://www.example.com/repo</literal>.</para>
+<screen>$ <userinput>pkg set-publisher -g http://www.example.com/repo example.com</userinput></screen>
+</example>
+<example><title>Add a Publisher With Key and Certificate</title>
+<para>Add a new publisher <literal>example.com</literal>, with a secure repository
+located at <literal>https://secure.example.com/repo</literal>, and a key and
+certificate stored in the directory <literal>/root/creds</literal>.</para>
+<screen>$ <userinput>pkg set-publisher -k /root/creds/example.key &bsol;</userinput>
+<userinput>-c /root/creds/example.cert -g https://secure.example.com/repo &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>Add and Automatically Configure a Publisher</title>
+<para>Add a new publisher with a repository located at <literal>/export/repo</literal> using
+automatic configuration.</para>
+<screen>$ <userinput>pkg set-publisher -p /export/repo</userinput></screen>
+</example>
+<example><title>Add and Manually Configure a Publisher</title>
+<para>Add a new publisher <literal>example.com</literal> with a repository located at <literal>/export/repo/example.com</literal> using manual configuration.</para>
+<screen>$ <userinput>pkg set-publisher -g /export/repo example.com</userinput></screen>
+</example>
+<example id="GMFJM"><title>Add a Publisher and Configure a Proxy</title>
+<para>Add a new publisher <literal>mypub</literal> with origin <literal>http://server/repo
+</literal> and proxy <literal>http://webcache:8080</literal>.</para>
+<screen>$ <userinput>pkg set-publisher -g http://server/repo &bsol;</userinput>
+<userinput>--proxy http://webcache:8080 mypub</userinput></screen>
+</example>
+<example><title>Verify All Signed Packages</title>
+<para>Configure an image to verify all signed packages.</para>
+<screen>$ <userinput>pkg set-property signature-policy verify</userinput></screen>
+</example>
+<example><title>Require All Packages To Be Signed</title>
+<para>Configure an image to require all packages to be signed, and require
+the string <literal>example.com</literal> to be seen as a common name for
+one of the certificates in the chain of trust.</para>
+<screen>$ <userinput>pkg set-property signature-policy require-names example.com</userinput></screen>
+</example>
+<example><title>Require All Packages From a Specified Publisher To Be Signed</title>
+<para>Configure an image so that all packages installed from publisher <literal>example.com
+</literal> must be signed.</para>
+<screen>$ <userinput>pkg set-publisher --set-property signature-policy=require-signatures &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>Require a Specified String in the Chain of Trust</title>
+<para>Add the string <literal>foo</literal> to the image&rsquo;s list of common
+names that must be seen in a signature&rsquo;s chain of trust to be considered valid.</para>
+<screen>$ <userinput>pkg add-property-value signature-require-names foo</userinput></screen>
+</example>
+<example><title>Remove a String From the Chain of Trust for a Specified Publisher
+</title>
+<para>Remove the string <literal>foo</literal> from the list of common names that must be seen to validate a signature for the publisher <literal>example.com</literal>.</para>
+<screen>$ <userinput>pkg set-publisher --remove-property-value signature-require-names=foo &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>Add a Trusted CA Certificate</title>
+<para>Add the certificate stored in <literal>/tmp/example_file.pem</literal> as
+a trusted CA certificate for the publisher <literal>example.com</literal>.</para>
+<screen>$ <userinput>pkg set-publisher --approve-ca-cert /tmp/example_file.pem &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>Revoke a Certificate</title>
+<para>Revoke the certificate with the hash <literal>a12345</literal> for publisher <literal>
+example.com</literal>, preventing the certificate from validating any signatures
+for packages from <literal>example.com</literal>.</para>
+<screen>$ <userinput>pkg set-publisher --revoke-ca-cert a12345 example.com</userinput></screen>
+</example>
+<example><title>Forget About a Certificate</title>
+<para>Make <command>pkg</command> forget that the certificate <literal>a12345</literal> was
+ever added or revoked by the user.</para>
+<screen>$ <userinput>pkg set-publisher --unset-ca-cert a12345 example.com</userinput></screen>
+</example>
+<example><title>Downgrade a Package</title>
+<para>Downgrade the installed package <literal>[email protected]</literal> to an older
+version.</para>
+<screen>$ <userinput>pkg update [email protected]</userinput></screen>
+</example>
+<example><title>Switch Conflicting Package Installation</title>
+<para>In the case of two conflicting packages, change which package is installed.
+Suppose package A depends on either package B or package C, and B and C are
+mutually exclusive. If A and B are installed, use the following command to
+switch to using C instead of B without uninstalling A:</para>
+<screen>$ <userinput>pkg install --reject B C</userinput></screen>
+</example>
+<example><title>List Packages in a Package Archive</title>
+<para>List all versions of all packages in a package archive.</para>
+<screen>$ <userinput>pkg list -f -g /my/archive.p5p</userinput></screen>
+</example>
+<example><title>List Packages in a Package Repository</title>
+<para>List all versions of all packages in a repository.</para>
+<screen>$ <userinput>pkg list -f -g http://example.com:10000</userinput></screen>
+</example>
+<example><title>Display Information About a Package in a Package Archive</title>
+<para>Display the package information for the latest version of a package
+in a package archive. The package might or might not be currently installed.</para>
+<screen>$ <userinput>pkg info -g /my/archive.p5p pkg_name</userinput></screen>
+</example>
+<example><title>Display Contents of a Package in a Package Archive</title>
+<para>Display the contents of a package in a package archive. The package
+is not currently installed.</para>
+<screen>$ <userinput>pkg contents -g /my/archive.p5p pkg_name</userinput></screen>
+</example>
+<example><title>Remove All Publisher Origins and Mirrors</title>
+<para>Remove all of the origins and mirrors for a publisher and add a new
+origin.</para>
+<screen>$ <userinput>pkg set-publisher -G '*' -M '*' -g http://example.com:10000 &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>Dehydrating and Rehydrating an Image</title>
+<para>In these examples, <literal>/tmp/test_image</literal> is the image that you want to dehydrate and rehydrate.</para>
+<para>Because no publisher is specified, the following command fully dehydrates the <literal>/tmp/test_image</literal> image by operating on all publishers that are enabled in the <literal>/tmp/test_image</literal> image.</para>
+<screen>$ <userinput>pkg -R /tmp/test_image dehydrate</userinput></screen>
+<para>Because no publisher is specified, the following command operates on all publishers configured in the <literal>/tmp/test_image</literal> image to fully restore the <literal>/tmp/test_image</literal> image.</para>
+<screen>$ <userinput>pkg -R /tmp/test_image rehydrate</userinput></screen>
+</example>
+<example><title>Dehydrating and Rehydrating an Image Specifying Publishers</title>
+<para>In these examples, <literal>/tmp/test_image</literal> is the image that you want to dehydrate and rehydrate, and the <literal>test1</literal> and <literal>test2</literal> publishers are enabled in the <literal>/tmp/test_image</literal> image and their origins provide the necessary content.</para>
+<para>The following command operates only on files and hardlinks delivered by the <literal>test1</literal> publisher.</para>
+<screen>$ <userinput>pkg -R /tmp/test_image dehydrate -p test1</userinput></screen>
+<para>The following command rehydrates only files and hardlinks delivered by the <literal>test1</literal> publisher.</para>
+<screen>$ <userinput>pkg -R /tmp/test_image rehydrate -p test1</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><envar>PKG_IMAGE</envar></term>
+<listitem><para>The directory containing the image to use for package operations.
+Ignored if <option>R</option> is specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_CONNECT_TIMEOUT</envar></term>
+<listitem><para>Seconds to wait trying to connect during transport operations
+(for each attempt) before the client aborts the operation. A value of 0 means
+wait indefinitely.</para>
+<para>Default value: 60</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_LOWSPEED_TIMEOUT</envar></term>
+<listitem><para>Seconds below the <literal>lowspeed</literal> limit (1024
+bytes/second) during transport operations before the client aborts the operation.
+A value of 0 means do not abort the operation.</para>
+<para>Default value: 30</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_CONSECUTIVE_ERROR</envar></term>
+<listitem><para>Maximum number of transient transport errors before the client
+aborts the operation. A value of 0 means do not abort the operation.</para>
+<para>Default value: 4</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_REDIRECT</envar></term>
+<listitem><para>Maximum number of HTTP or HTTPS redirects allowed during transport
+operations before a connection is aborted. A value of 0 means do not abort
+the operation.</para>
+<para>Default value: 5</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CONCURRENCY</envar></term>
+<listitem><para>The number of child images to update in parallel. Ignored
+if the <option>C</option> option is specified.</para>
+<para>When recursing into child images (usually installed <literal>solaris</literal> branded non-global zones), update at most <envar>$PKG_CONCURRENCY</envar> child images in parallel. If <envar>$PKG_CONCURRENCY</envar> is 0 or a negative number, all child images are updated in parallel.</para>
+<para>Default value: 1</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_TIMEOUT</envar></term>
+<listitem><para>Maximum number of transport attempts per host before the client
+aborts the operation. A value of 0 means do not abort the operation.</para>
+<para>Default value: 4</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>http_proxy</envar>, <envar>https_proxy</envar></term>
+<listitem><para>HTTP or HTTPS proxy server.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>Multiple operations were requested, but only some of them
+succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>4</returnvalue></term>
+<listitem><para>No changes were made - nothing to do.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>5</returnvalue></term>
+<listitem><para>The requested operation cannot be performed on a live image.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>6</returnvalue></term>
+<listitem><para>The requested operation cannot be completed because the licenses
+for the packages being installed or updated have not been accepted.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>7</returnvalue></term>
+<listitem><para>The image is currently in use by another process and cannot
+be modified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>8</returnvalue></term>
+<listitem><para>One or more SMF actuators timed out.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para>A <literal>pkg</literal>(5) image can be located arbitrarily within
+a larger file system. In the following file descriptions, the token <envar>$IMAGE_ROOT
+</envar> is used to distinguish relative paths. For a typical system installation, <envar>
+$IMAGE_ROOT</envar> is equivalent to <literal>/</literal></para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>Metadata directory for a full or partial image.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>Metadata directory for a user image.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Within a particular image&rsquo;s metadata, certain files and directories
+can contain information useful during repair and recovery. The token <envar>$IMAGE_META
+</envar> refers to the top-level directory containing the metadata. <envar>$IMAGE_META
+</envar> is typically one of the two paths given above.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_META/lost+found</filename></term>
+<listitem><para>Location of conflicting directories and files moved during
+a package operation. Location of unpackaged contents of a removed directory.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/publisher</filename></term>
+<listitem><para>Contains a directory for each publisher. Each directory stores
+publisher-specific metadata.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Other paths within the <envar>$IMAGE_META</envar> directory hierarchy
+are private and are subject to change.</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="beadm-1m"><citerefentry><refentrytitle>beadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.sysrepo-1m"><citerefentry><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <literal>glob</literal>(3C), <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="AUOSS"><citetitle remap="book">Adding and Updating Software in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
--- a/src/man/pkg.5	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkg.5	Wed Jul 01 10:45:55 2015 -0700
@@ -1,1645 +1,1347 @@
-'\" te
-.\" Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved.
-.TH pkg 5 "10 Apr 2014" "SunOS 5.11" "Standards, Environments, and Macros"
-.SH NAME
-pkg \- Image Packaging System
-.SH DESCRIPTION
-.sp
-.LP
-The image packaging system, \fBpkg\fR(5), is a framework that provides for software lifecycle management (installation, upgrade, and removal). Image packaging manages software in units of packages, which are collections of actions, defined by a set of key/value pairs and possibly a data payload. In many cases, actions are files found in a file system, but they also represent other installable objects, such as drivers, services, and users.
-.SH PACKAGE FMRIS AND VERSIONS
-.sp
-.LP
-Each package is represented by a fault management resource identifier (FMRI) with the scheme \fBpkg:\fR. The full FMRI for a package consists of the scheme, a publisher, the package name, and a version string in the following format:
-.sp
-.in +2
-.nf
-pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-\fBsolaris\fR is the publisher. \fBsystem/library/c++-runtime\fR is the package name. Although the namespace is hierarchical and arbitrarily deep, there is no enforced containment; the name is essentially arbitrary. The publisher information is optional, but must be preceded by \fBpkg://\fR if present. An FMRI that includes the publisher is often referred to as being "fully qualified." If publisher information is not present, then the package name should generally be preceded by \fBpkg:/\fR.
-.sp
-.LP
-Packaging clients often allow the scheme of an FMRI to be omitted if it does not contain publisher information. For example, \fBpkg:/system/library/c++-runtime\fR can be written as \fBsystem/library/c++-runtime\fR. If the scheme is omitted, clients also allow omission of all but the last component of a package name for matching purposes. For example, \fBsystem/library/c++-runtime\fR could be written as \fBlibrary/c++-runtime\fR or \fBc++-runtime\fR, which would then match packages named \fBc++-runtime\fR or package names ending in \fB/c++-runtime\fR.
-.sp
-.LP
-A publisher name identifies a person, group of persons, or an organization as the source of one or more packages. To avoid publisher name collisions and help identify the publisher, a best practice is to use a domain name that represents the entity publishing the packages as a publisher name.
-.sp
-.LP
-The version follows the package name, separated by an at sign (@). The version consists of four sequences of numbers, separated by punctuation. The elements in the first three sequences are separated by dots, and the sequences are arbitrarily long. Leading zeros in version components (for example, 01.1 or 1.01) are not permitted. Trailing zeros (for example, 1.10) are permitted.
-.sp
-.LP
-The first part of the version is the component version. For components tightly bound to the operating system, this is usually the value of \fBuname -r\fR for that version of the operating system. For a component with its own development lifecycle, this sequence is a dotted release number, such as 2.4.10.
-.sp
-.LP
-The second part of the version, which if present must follow a comma (,), is the build version. The build version specifies what version of the operating system the contents of the package were built on, providing a minimum bound on which operating system version the contents can be expected to run successfully.
-.sp
-.LP
-The third part of the version, which if present must follow a hyphen (\fB-\fR), is the branch version. The branch version is a versioning component that provides vendor-specific information. The branch version can be incremented when the packaging metadata is changed, independently of the component version. The branch version might contain a build number or other information.
-.sp
-.LP
-The fourth part of the version, which if present must follow a colon (:), is a timestamp. The timestamp represents when the package was published.
-.sp
-.LP
-When performing comparisons between versions, no component of the full version is considered unless the components to its left are the same. Thus, \fB4.3-1\fR is greater than \fB4.2-7\fR because \fB4.3\fR is greater than \fB4.2\fR, and \fB4.3-3\fR is greater than \fB4.3-1\fR because \fB3\fR is greater than \fB1\fR.
-.sp
-.LP
-The \fBpkg.human-version\fR attribute can be used to provide a human-readable version string. The value of the \fBpkg.human-version\fR attribute can be provided in addition to the package version described above for the package FMRI but cannot replace the package FMRI version. The human-readable version string is only used for display purposes. See "Set Actions" for more information.
-.sp
-.LP
-Many parts of the system, when appropriate, abridge FMRIs when displaying them, and accept input in shorter forms to reduce the volume of information displayed or required. Typically, the scheme, publisher, build version, and timestamp can be elided. Sometimes all of the versioning information can be omitted.
-.SH ACTIONS
-.sp
-.LP
-Actions represent the installable objects on a system. Actions are described in the manifest of a package. Every action consists primarily of its name and a key attribute. Together, these refer to a unique object as it follows a version history. Actions can have other attributes. Some attributes are interpreted directly by the packaging system. Other attributes might be useful only to the system administrator or the end-user.
-.sp
-.LP
-Actions have a simple text representation:
-.sp
-.in +2
-.nf
-\fIaction_name\fR \fIattribute1\fR=\fIvalue1\fR \fIattribute2\fR=\fIvalue2\fR ...
-.fi
-.in -2
-
-.sp
-.LP
-Names of attributes cannot have whitespace, quotation marks, or equals signs (=) in them. All characters after the first equals sign belong to the value. Values can have all of those, though spaces must be enclosed in single or double quotation marks. Single quotation marks do not need to be escaped inside a string that is enclosed in double quotation marks, and double quotation marks do not need to be escaped inside a string that is enclosed in single quotation marks. A quotation mark can be prefixed with a backslash (\e) character to avoid terminating the quoted string. A backslash can be escaped with a backslash.
-.sp
-.LP
-Actions can have multiple attributes. Some attributes can be named multiple times with different values for a single action. Multiple attributes with the same name are treated as unordered lists.
-.sp
-.LP
-Actions with many attributes can create long lines in a manifest file. Such lines can be wrapped by terminating each incomplete line with a backslash. Note that this continuation character must occur between attribute/value pairs. Neither attributes nor their values nor the combination can be split.
-.sp
-.LP
-The attributes listed below are not an exhaustive set. In fact, the attributes that can be attached to an action are arbitrary, and the standard sets of attributes are easy to augment to incorporate future developments.
-.sp
-.LP
-Some attributes cause additional operations to be executed outside of the packaging context. These attributes are documented in the "Actuators" section below.
-.SS "File Actions"
-.sp
-.LP
-The \fBfile\fR action represents an ordinary file. The \fBfile\fR action references a payload, and has four standard attributes:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpath\fR\fR
-.ad
-.RS 9n
-.rt  
-The file system path where the file is installed. This is a \fBfile\fR action's key attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmode\fR\fR
-.ad
-.RS 9n
-.rt  
-The access permissions (in numeric form) of the file. These are simple permissions only, not ACLs.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBowner\fR\fR
-.ad
-.RS 9n
-.rt  
-The name of the user that owns the file.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR\fR
-.ad
-.RS 9n
-.rt  
-The name of the group that owns the file.
-.RE
-
-.sp
-.LP
-The payload is a positional attribute in that it is not named. It is the first word after the action name. In a published manifest, it is the \fBSHA-1\fR hash of the file contents. If present in a manifest that has yet to be published, it represents the path where the payload can be found. See \fBpkgsend\fR(1). The hash attribute can be used instead of the positional attribute, should the value include an equals sign. Both can be used in the same action. However, the hashes must be identical.
-.sp
-.LP
-The \fBpreserve\fR and \fBoverlay\fR attributes affect whether and how a \fBfile\fR action is installed.
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpreserve\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specifies when and how files are preserved during package operations.
-.sp
-When a package is initially installed, if a file delivered by the package has a \fBpreserve\fR attribute defined with any value and the file already exists in the image, the existing file is stored in \fB/var/pkg/lost+found\fR and the packaged file is installed.
-.sp
-When a package is initially installed, if a file delivered by the package has a \fBpreserve\fR attribute defined and the file does not already exist in the image, whether that file is installed depends on the value of the \fBpreserve\fR attribute:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the value of \fBpreserve\fR is \fBlegacy\fR, the packaged file is not installed.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the value of \fBpreserve\fR is not \fBlegacy\fR, the packaged file is installed.
-.RE
-When a package is downgraded, if a file delivered by the downgraded version of the package has a \fBpreserve\fR attribute defined with any value and all of the following conditions are true, the file that currently exists in the image is renamed with the extension \fB\&.update\fR, and the file from the downgraded package is installed:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-The file exists in the image.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-The content of the file delivered by the downgraded version of the package is different from the content of the file delivered by the currently installed version of the package.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-The content of the file delivered by the downgraded version of the package is different from the content of the file that exists in the image.
-.RE
-If any of the above conditions is not true, the file is treated the same as if the package is being upgraded, rather than downgraded.
-.sp
-When a package is upgraded, if a \fBfile\fR action delivered by the upgraded version of the package has a \fBpreserve\fR attribute defined with any value and the \fBfile\fR action is the same as the \fBfile\fR action delivered by the currently installed version of the package, the file is not installed, and the file that exists in the image is not modified. Any modifications made since the previous version was installed are preserved.
-.sp
-When a package is upgraded, if a \fBfile\fR action delivered by the upgraded version of the package has a \fBpreserve\fR attribute defined and the \fBfile\fR action is new or is different from the \fBfile\fR action delivered by the currently installed version of the package, the upgrade is done in the following way:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file does not exist in the image, the new file is installed.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file delivered by the upgraded version of the package exists in the image, did not exist in the currently installed version of the package, and was not renamed or moved by using the \fBoriginal_name\fR attribute (see below), then the existing file is stored in \fB/var/pkg/lost+found\fR and the file delivered by the upgraded version of the package is installed.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file delivered by the upgraded version of the package exists in the image and has different content from the file delivered by the currently installed version of the package, the upgrade is done according to the value of the \fBpreserve\fR attribute:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file delivered by the upgraded version of the package has a \fBpreserve\fR value of \fBrenameold\fR, the existing file is renamed with the extension \fB\&.old\fR, and the new file is installed with updated permissions and timestamp (if present). See the \fBtimestamp\fR attribute description below.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file delivered by the upgraded version of the package has a \fBpreserve\fR value of \fBrenamenew\fR, the new file is installed with the extension \fB\&.new\fR and the existing file is not modified.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file delivered by the upgraded version of the package has a \fBpreserve\fR value of \fBtrue\fR, the new file is not installed, but the permissions and timestamp (if present) are reset on the existing file.
-.RE
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file delivered by the upgraded version of the package exists in the image, has the same content as the file delivered by the currently installed version of the package, and has a \fBpreserve\fR value of either \fBrenameold\fR or \fBrenamenew\fR, the existing file is replaced by the file delivered by the upgraded version of the package, including replacing permissions and timestamp (if present).
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file delivered by the upgraded version of the package exists in the image, has a \fBpreserve\fR value of \fBlegacy\fR in the upgraded package, and has a different \fBpreserve\fR value in the currently installed version of the package, the existing file is renamed with the extension \fB\&.legacy\fR, and the new file is installed with updated permissions and timestamp (if present).
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If the file delivered by the upgraded version of the package exists in the image and has a \fBpreserve\fR value of \fBlegacy\fR in both the upgraded package and the currently installed version of the package, the permissions and timestamp (if present) are reset on the existing file.
-.RE
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoverlay\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specifies whether the action allows other packages to deliver a file at the same location or whether it delivers a file intended to overlay another file. This functionality is intended for use with configuration files that do not participate in any self-assembly (for example, \fB/etc/motd\fR) and that can be safely overwritten.
-.sp
-If \fBoverlay\fR is not specified, multiple packages cannot deliver files to the same location.
-.sp
-The \fBoverlay\fR attribute can have one of the following values:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBallow\fR\fR
-.ad
-.RS 9n
-.rt  
-One other package is allowed to deliver a file to the same location. This value has no effect unless the \fBpreserve\fR attribute is also set.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtrue\fR\fR
-.ad
-.RS 9n
-.rt  
-The file delivered by the action overwrites any other action that has specified \fBallow\fR.
-.RE
-
-Changes to the installed file are preserved based on the value of the \fBpreserve\fR attribute of the overlaying file. On removal, the contents of the file are preserved if the action being overlaid is still installed, regardless of whether the \fBpreserve\fR attribute was specified. Only one action can overlay another, and the \fBmode\fR, \fBowner\fR, and \fBgroup\fR attributes must match.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdehydrate\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specifies whether this action should be removed when a package publisher's packages are dehydrated or when a dehydrated publisher's packages are modified. The value of the \fBdehydrate\fR attribute can be \fBtrue\fR or \fBfalse\fR. If the value of the \fBdehydrate\fR attribute is \fBfalse\fR, the action will not be removed during dehydrate operations. Otherwise, the action will be removed. File actions tagged with the \fBpreserve\fR or \fBoverlay\fR attributes are implicitly excluded from dehydration operations and do not need this attribute.
-.sp
-.in +2
-.nf
-file path=etc/zones/SYSdefault.xml dehydrate=false ...
-.fi
-.in -2
-
-.RE
-
-.sp
-.LP
-The following attributes are recognized for ELF files:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfarch\fR\fR
-.ad
-.sp .6
-.RS 4n
-The architecture of the ELF file. This is the output of \fBuname -p\fR on the architecture for which the file is built.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfbits\fR\fR
-.ad
-.sp .6
-.RS 4n
-This is \fB32\fR or \fB64\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfhash\fR\fR
-.ad
-.sp .6
-.RS 4n
-This is the hash of the "interesting" ELF sections in the file. These are the sections that are mapped into memory when the binary is loaded. These are the only sections necessary to consider when determining whether the executable behavior of two binaries will differ.
-.RE
-
-.sp
-.LP
-The following additional attributes are recognized for \fBfile\fR actions:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoriginal_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-This attribute is used to handle editable files moving from package to package or from place to place, or both. The form this takes is the name of the originating package, followed by a colon and the original path to the file. Any file being deleted is recorded either with its package and path, or with the value of the \fBoriginal_name\fR attribute if specified. Any editable file being installed that has the \fBoriginal_name\fR attribute set uses the file of that name if it is deleted as part of the same packaging operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrelease-note\fR\fR
-.ad
-.sp .6
-.RS 4n
-This attribute is used to indicate that this file contains release note text. The value of this attribute is a package FMRI. If the FMRI specifies a package name that is present in the original image and a version that is newer than the version of the package in the original image, this file will be part of the release notes. A special FMRI of \fBfeature/pkg/self\fR refers to the containing package. If the version of \fBfeature/pkg/self\fR is 0, this file will only be part of the release notes on initial installation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrevert-tag\fR\fR
-.ad
-.sp .6
-.RS 4n
-This attribute is used to tag editable files that should be reverted as a set. The value of the \fBrevert-tag\fR attribute is a \fItagname\fR. Multiple \fBrevert-tag\fR attributes can be specified for a single \fBfile\fR action. The file reverts to its manifest-defined state when \fBpkg revert\fR is invoked with any of those tags specified. See the \fBpkg\fR(1) man page for information about the \fBpkg revert\fR command.
-.sp
-The \fBrevert-tag\fR attribute can also be specified at the directory level. See "Directory Actions" below.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsysattr\fR\fR
-.ad
-.sp .6
-.RS 4n
-This attribute is used to specify any system attributes that should be set for this file. The value of the \fBsysattr\fR attribute can be a comma-separated list of verbose system attributes or a string sequence of compact system attribute options, as shown in the following examples. Supported system attributes are explained in the \fBchmod\fR(1) man page. System attributes specified in the manifest are set additionally to system attributes that might have been set by other subsystems of the operating system.
-.sp
-.in +2
-.nf
-file path=opt/secret_file sysattr=hidden,sensitive
-file path=opt/secret_file sysattr=HT
-.fi
-.in -2
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtimestamp\fR\fR
-.ad
-.sp .6
-.RS 4n
-This attribute is used to set the access and modification time on the file. The \fBtimestamp\fR attribute value must be expressed in UTC in ISO-8601 format, omitting the colons and hyphens.
-.sp
-The \fBtimestamp\fR attribute is essential when packaging \fB\&.pyc\fR or \fB\&.pyo\fR files for Python. The related \fB\&.py\fR file for the \fB\&.pyc\fR or \fB\&.pyo\fR files must be marked with the timestamp embedded within those files, as shown in the following example:
-.sp
-.in +2
-.nf
-file path=usr/lib/python2.7/vendor-packages/pkg/__init__.pyc ...
-file path=usr/lib/python2.7/vendor-packages/pkg/__init__.py \e
-     timestamp=20130311T221521Z ...
-.fi
-.in -2
-
-.RE
-
-.sp
-.LP
-The following attributes for \fBfile\fR actions are automatically generated by the system and should not be specified by package developers:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhash\fR\fR
-.ad
-.sp .6
-.RS 4n
-The SHA-1 hash of the uncompressed file.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBchash\fR\fR
-.ad
-.sp .6
-.RS 4n
-The SHA-1 hash of the compressed file.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.size\fR\fR
-.ad
-.sp .6
-.RS 4n
-The size in bytes of the uncompressed file.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.csize\fR\fR
-.ad
-.sp .6
-.RS 4n
-The size in bytes of the compressed file.
-.RE
-
-.SS "Directory Actions"
-.sp
-.LP
-The \fBdir\fR action is like the \fBfile\fR action in that it represents a file system object. The \fBdir\fR action represents a directory instead of an ordinary file. The \fBdir\fR action has the same \fBpath\fR, \fBmode\fR, \fBowner\fR, and \fBgroup\fR attributes that the \fBfile\fR action has, and \fBpath\fR is the key attribute. The \fBdir\fR action also accepts the \fBrevert-tag\fR attribute. The value of the \fBrevert-tag\fR attribute is different for \fBfile\fR and \fBdir\fR actions.
-.sp
-.LP
-Directories are reference counted in IPS. When the last package that either explicitly or implicitly references a directory no longer does so, that directory is removed. If that directory contains unpackaged file system objects, those items are moved into \fB$IMAGE_META/lost+found\fR. See the "Files" section for more information about \fB$IMAGE_META\fR.
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrevert-tag\fR\fR
-.ad
-.sp .6
-.RS 4n
-This attribute is used to identify unpackaged files that should be removed as a set. See "File Actions" above for a description of how to specify this attribute for \fBfile\fR actions. For directories, the value of the \fBrevert-tag\fR attribute is \fItagname\fR\fB=\fR\fIpattern\fR. Multiple \fBrevert-tag\fR attributes can be specified for a single \fBdir\fR action. When \fBpkg revert\fR is invoked with a matching \fItagname\fR, any unpackaged files or directories under this \fBdir\fR directory that match \fIpattern\fR (using shell globbing characters) are removed. See the \fBpkg\fR(1) man page for information about the \fBpkg revert\fR command.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsalvage-from\fR\fR
-.ad
-.sp .6
-.RS 4n
-This attribute can be used to move unpackaged contents into a new directory. The value of this attribute is the name of a directory of salvaged items. A directory with a \fBsalvage-from\fR attribute inherits on creation any contents of the directory named in the value of the \fBsalvage-from\fR attribute.
-.RE
-
-.SS "Link Actions"
-.sp
-.LP
-The \fBlink\fR action represents a symbolic link. The \fBlink\fR action has the following standard attributes:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-The file system path where the symbolic link is installed. This is a \fBlink\fR action's key attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtarget\fR\fR
-.ad
-.sp .6
-.RS 4n
-The target of the symbolic link. The file system object to which the link resolves.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specifies the entry in the mediation namespace shared by all path names participating in a given mediation group (for example, \fBpython\fR). Link mediation can be performed based on \fBmediator-version\fR and/or \fBmediator-implementation\fR. All mediated links for a given path name must specify the same mediator. However, not all mediator versions and implementations need to provide a link at a given path. If a mediation does not provide a link, then the link is removed when that mediation is selected. A \fBmediator\fR, in combination with a specific version and/or implementation represents a mediation that can be selected for use by the packaging system.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-version\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specifies the version (expressed as a dot-separated sequence of nonnegative integers) of the interface described by the \fBmediator\fR attribute. This attribute is required if \fBmediator\fR is specified and \fBmediator-implementation\fR is not. A local system administrator can set the version to use explicitly. The value specified should generally match the version of the package delivering the link (for example, \fBruntime/python-27\fR should use \fBmediator-version=2.7\fR), although this is not required.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-implementation\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specifies the implementation of the mediator for use in addition to or instead of the \fBmediator-version\fR. Implementation strings are not considered to be ordered and a string is arbitrary selected by \fBpkg\fR(5) if not explicitly specified by a system administrator.
-.sp
-The value can be a string of arbitrary length composed of alphanumeric characters and spaces. If the implementation itself can be versioned or is versioned, then the version should be specified at the end of the string, after a @ (expressed as a dot-separated sequence of nonnegative integers). If multiple versions of an implementation exist, the default behavior is to select the implementation with the greatest version.
-.sp
-If only one instance of an implementation mediation link at a particular path is installed on a system, then that one is chosen automatically. If future links at the path are installed, the link is not switched unless a vendor, site, or local override applies, or if one of the links is version mediated.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-priority\fR\fR
-.ad
-.sp .6
-.RS 4n
-When resolving conflicts in mediated links, \fBpkg\fR(5) normally chooses the link with the greatest value of \fBmediator-version\fR or based on \fBmediator-implementation\fR if that is not possible. This attribute is used to specify an override for the normal conflict resolution process.
-.sp
-If this attribute is not specified, the default mediator selection logic is applied.
-.sp
-If the value is \fBvendor\fR, the link is preferred over those that do not have a \fBmediator-priority\fR specified.
-.sp
-If the value is \fBsite\fR, the link is preferred over those that have a value of \fBvendor\fR or that do not have a \fBmediator-priority\fR specified.
-.sp
-A local system administrator can override the selection logic described above.
-.RE
-
-.SS "Hardlink Actions"
-.sp
-.LP
-The \fBhardlink\fR action represents a hard link. It has the same attributes as the \fBlink\fR action, and \fBpath\fR is also its key attribute.
-.SS "Driver Actions"
-.sp
-.LP
-The \fBdriver\fR action represents a device driver. The \fBdriver\fR action does not reference a payload. The driver files themselves must be installed as \fBfile\fR actions. The following attributes are recognized (see \fBadd_drv\fR(1M) for more information):
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.sp .6
-.RS 4n
-The name of the driver. This is usually, but not always, the file name of the driver binary. This is the \fBdriver\fR action's key attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalias\fR\fR
-.ad
-.sp .6
-.RS 4n
-This represents an alias for the driver. A given driver can have more than one \fBalias\fR attribute. No special quoting rules are necessary.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclass\fR\fR
-.ad
-.sp .6
-.RS 4n
-This represents a driver class. A given driver can have more than one \fBclass\fR attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBperms\fR\fR
-.ad
-.sp .6
-.RS 4n
-This represents the file system permissions for the driver's device nodes.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclone_perms\fR\fR
-.ad
-.sp .6
-.RS 4n
-This represents the file system permissions for the clone driver's minor nodes for this driver.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpolicy\fR\fR
-.ad
-.sp .6
-.RS 4n
-This specifies additional security policy for the device. A given driver can have more than one \fBpolicy\fR attribute, but no minor device specification can be present in more than one attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBprivs\fR\fR
-.ad
-.sp .6
-.RS 4n
-This specifies privileges used by the driver. A given driver can have more than one \fBprivs\fR attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdevlink\fR\fR
-.ad
-.sp .6
-.RS 4n
-This specifies an entry in \fB/etc/devlink.tab\fR. The value is the exact line to go into the file, with tabs denoted by \fB\et\fR\&. See \fBdevlinks\fR(1M) for more information. A given driver can have more than one \fBdevlink\fR attribute.
-.RE
-
-.SS "Depend Actions"
-.sp
-.LP
-The \fBdepend\fR action represents an inter-package dependency. A package can depend on another package because the first requires functionality in the second for the functionality in the first to work, or even to install. Dependencies can be optional. If a dependency is not met at the time of installation, the packaging system attempts to install or update the dependent package to a sufficiently new version, subject to other constraints.
-.sp
-.LP
-The following attributes are recognized:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBfmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-The FMRI representing the dependent package. This is the \fBdependency\fR action's key attribute. The \fBfmri\fR value must not include the publisher. The package name is assumed to be complete. Dependencies of type \fBrequire-any\fR can have multiple \fBfmri\fR attributes. A version is optional on the \fBfmri\fR value, though for some types of dependencies, an \fBfmri\fR with no version has no meaning.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtype\fR\fR
-.ad
-.sp .6
-.RS 4n
-The type of the dependency.
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire\fR\fR
-.ad
-.sp .6
-.RS 4n
-The dependency is required and must have a version equal to or greater than the version specified in the \fBfmri\fR attribute. If the version is not specified, any version satisfies the dependency. A package cannot be installed if any of its required dependencies cannot be satisfied.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoptional\fR\fR
-.ad
-.sp .6
-.RS 4n
-The dependency, if present, must be at the specified version level or greater.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexclude\fR\fR
-.ad
-.sp .6
-.RS 4n
-The containing package cannot be installed if the dependency is present at the specified version level or greater. If no version is specified, the dependent package cannot be installed concurrently with the package specifying the dependency.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBincorporate\fR\fR
-.ad
-.sp .6
-.RS 4n
-The dependency is optional, but the version of the dependent package is constrained. See "Constraints and Freezing" below.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-any\fR\fR
-.ad
-.sp .6
-.RS 4n
-Any one of multiple dependent packages as specified by multiple \fBfmri\fR attributes can satisfy the dependency, following the same rules as the \fBrequire\fR dependency type.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBconditional\fR\fR
-.ad
-.sp .6
-.RS 4n
-The dependency is required only if the package defined by the \fBpredicate\fR attribute is present on the system.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBorigin\fR\fR
-.ad
-.sp .6
-.RS 4n
-Prior to installation of this package, the dependency target must, if present, be at the specified value or greater on the image to be modified. If the value of the \fBroot-image\fR attribute is \fBtrue\fR, the target must be present on the image rooted at / in order to install this package. If the value of the \fBroot-image\fR attribute is \fBtrue\fR and the value of the \fBfmri\fR attribute starts with \fBpkg:/feature/firmware/\fR, the remainder of the \fBfmri\fR value is treated as a command in \fB/usr/lib/fwenum\fR that evaluates the firmware dependency. See \fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR for examples.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR\fR
-.ad
-.sp .6
-.RS 4n
-The dependency is required unless the package is on the image avoid list. Note that obsolete packages silently satisfy the group dependency. See the \fBavoid\fR subcommand in \fBpkg\fR(1).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBparent\fR\fR
-.ad
-.sp .6
-.RS 4n
-The dependency is ignored if the image is not a child image. If the image is a child image then the dependency is required to be present in the parent image. The package version matching for a \fBparent\fR dependency is the same as that used for \fBincorporate\fR dependencies.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpredicate\fR\fR
-.ad
-.sp .6
-.RS 4n
-The FMRI representing the predicate for \fBconditional\fR dependencies.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBroot-image\fR\fR
-.ad
-.sp .6
-.RS 4n
-Has an effect only for \fBorigin\fR dependencies as mentioned above.
-.RE
-
-.SS "License Actions"
-.sp
-.LP
-The \fBlicense\fR action represents a license or other informational file associated with the package contents. A package can deliver licenses, disclaimers, or other guidance to the package installer through the use of the \fBlicense\fR action.
-.sp
-.LP
-The payload of the \fBlicense\fR action is delivered into the image metadata directory related to the package, and should only contain human-readable text data. It should not contain HTML or any other form of markup. Through attributes, \fBlicense\fR actions can indicate to clients that the related payload must be displayed and/or require acceptance of it. The method of display and/or acceptance is at the discretion of clients.
-.sp
-.LP
-The following attributes are recognized:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlicense\fR\fR
-.ad
-.sp .6
-.RS 4n
-This is a \fBlicense\fR action's key attribute. This attribute provides a meaningful description for the license to assist users in determining the contents without reading the license text itself. Some example values include:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ABC Co. Copyright Notice
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ABC Co. Custom License
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Common Development and Distribution License 1.0 (CDDL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-GNU General Public License 2.0 (GPL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-GNU General Public License 2.0 (GPL) Only
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-MIT License
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Mozilla Public License 1.1 (MPL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Simplified BSD License
-.RE
-The \fBlicense\fR value must be unique within a package. Including the version of the license in the description, as shown in several of the examples above, is recommended. If a package has code under multiple licenses, use multiple \fBlicense\fR actions. The length of the license attribute value should not be more than 64 characters.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmust-accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-When \fBtrue\fR, this license must be accepted by a user before the related package can be installed or updated. Omission of this attribute is equivalent to \fBfalse\fR. The method of acceptance (interactive or configuration-based, for example) is at the discretion of clients. For package updates, this attribute is ignored if the license action or payload has not changed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmust-display\fR\fR
-.ad
-.sp .6
-.RS 4n
-When \fBtrue\fR, the action's payload must be displayed by clients during packaging operations. Omission of this value is equivalent to \fBfalse\fR. This attribute should not be used for copyright notices. This attribute should only be used for licenses or other material that must be displayed during operations. The method of display is at the discretion of clients. For package updates, this attribute is ignored if the license action or payload has not changed.
-.RE
-
-.SS "Legacy Actions"
-.sp
-.LP
-The \fBlegacy\fR action represents package data used by a legacy packaging system. The attributes associated with this action are added into the legacy system's databases so that the tools querying those databases can operate as if the legacy package were actually installed. In particular, this should be sufficient to convince the legacy system that the package named by the \fBpkg\fR attribute is installed on the system, so that the package can be used to satisfy dependencies.
-.sp
-.LP
-The following attributes, named in accordance with the parameters on \fBpkginfo\fR(4), are recognized:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcategory\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value for the \fBCATEGORY\fR parameter. The default value is \fBsystem\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdesc\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value for the \fBDESC\fR parameter.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhotline\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value for the \fBHOTLINE\fR parameter.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value for the \fBNAME\fR parameter. The default value is \fBnone provided\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-The abbreviation for the package being installed. The default value is the name from the FMRI of the package. This is a \fBlegacy\fR action's key attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBvendor\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value for the \fBVENDOR\fR parameter.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBversion\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value for the VERSION parameter. The default value is the version from the FMRI of the package.
-.RE
-
-.SS "Set Actions"
-.sp
-.LP
-The \fBset\fR action represents a package-level attribute, or metadata, such as the package description.
-.sp
-.LP
-The following attributes are recognized:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.RS 9n
-.rt  
-The name of the attribute.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBvalue\fR\fR
-.ad
-.RS 9n
-.rt  
-The value given to the attribute.
-.RE
-
-.sp
-.LP
-The \fBset\fR action can deliver any metadata the package author chooses. However, there are a number of well defined attribute names that have specific meaning to the packaging system.
-.sp
-.ne 2
-.mk
-.na
-\fB\fBinfo.classification\fR\fR
-.ad
-.sp .6
-.RS 4n
-One or more tokens that a \fBpkg\fR(5) client can use to classify the package. The value should have a scheme (such as "org.opensolaris.category.2008" or "org.acm.class.1998") and the actual classification, such as "Applications/Games", separated by a colon (:).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.description\fR\fR
-.ad
-.sp .6
-.RS 4n
-A detailed description of the contents and functionality of the package, typically a paragraph or so in length.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-The name and version of the containing package. See "Package FMRIs and Versions" in the "Description" section.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.human-version\fR\fR
-.ad
-.sp .6
-.RS 4n
-The version scheme used by IPS is strict. See "Package FMRIs and Versions" in the "Description" section. A more flexible version can be provided as the value of the \fBpkg.human-version\fR attribute. The value is displayed by IPS tools such as \fBpkg info\fR, \fBpkg contents\fR, and \fBpkg search\fR. The \fBpkg.human-version\fR value is not used as a basis for version comparison and cannot be used in place of the \fBpkg.fmri\fR version.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.obsolete\fR\fR
-.ad
-.sp .6
-.RS 4n
-When \fBtrue\fR, the package is marked obsolete. An obsolete package can have no actions other than more set actions, and must not be marked renamed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.renamed\fR\fR
-.ad
-.sp .6
-.RS 4n
-When \fBtrue\fR, the package has been renamed. There must be one or more \fBdepend\fR actions in the package as well that point to the package versions to which this package has been renamed. A package cannot be marked both renamed and obsolete, but otherwise can have any number of set actions.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.summary\fR\fR
-.ad
-.sp .6
-.RS 4n
-A short, one-line description of the package.
-.RE
-
-.SS "Group Actions"
-.sp
-.LP
-The \fBgroup\fR action defines a UNIX group as defined in \fBgroup\fR(4). No support is present for group passwords. Groups defined with this action initially have no user list. Users can be added with the \fBuser\fR action. The following attributes are recognized:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroupname\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value for the name of the group.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgid\fR\fR
-.ad
-.sp .6
-.RS 4n
-The group's unique numerical id. The default value is the first free group under 100.
-.RE
-
-.SS "User Actions"
-.sp
-.LP
-The \fBuser\fR action defines a UNIX user as defined in \fB/etc/passwd\fR, \fB/etc/shadow\fR, \fB/etc/group\fR, and \fB/etc/ftpd/ftpusers\fR files. Entries are added to the appropriate files for users defined with this \fBuser\fR action.
-.sp
-.LP
-The \fBuser\fR action is intended to define a user for a daemon or other software to use. Do not use the \fBuser\fR action to define administrative or interactive accounts.
-.sp
-.LP
-The following attributes are recognized:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBusername\fR\fR
-.ad
-.sp .6
-.RS 4n
-The unique name of the user
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpassword\fR\fR
-.ad
-.sp .6
-.RS 4n
-The encrypted password of the user. Default value is \fB*LK*\fR. See \fBshadow\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-The unique uid of the user. Default value is first free value under 100.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR\fR
-.ad
-.sp .6
-.RS 4n
-The name of the user's primary group. Must be found in \fB/etc/group\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgcos-field\fR\fR
-.ad
-.sp .6
-.RS 4n
-The value of the \fBgcos\fR field in \fB/etc/passwd\fR. Default value is \fBusername\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhome-dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-The user's home directory. This directory must be in the system image directories and not under another mount point such as \fB/home\fR. Default value is \fB/\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlogin-shell\fR\fR
-.ad
-.sp .6
-.RS 4n
-The user's default shell. Default value is empty.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup-list\fR\fR
-.ad
-.sp .6
-.RS 4n
-Secondary groups to which the user belongs. See \fBgroup\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBftpuser\fR\fR
-.ad
-.sp .6
-.RS 4n
-Can be set to \fBtrue\fR or \fBfalse\fR. The default value of \fBtrue\fR indicates that the user is permitted to login via FTP. See \fBftpusers\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlastchg\fR\fR
-.ad
-.sp .6
-.RS 4n
-The number of days between January 1, 1970, and the date that the password was last modified. Default value is empty. See \fBshadow\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmin\fR\fR
-.ad
-.sp .6
-.RS 4n
-The minimum number of days required between password changes. This field must be set to 0 or above to enable password aging. Default value is empty. See \fBshadow\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmax\fR\fR
-.ad
-.sp .6
-.RS 4n
-The maximum number of days the password is valid. Default value is empty. See \fBshadow\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwarn\fR\fR
-.ad
-.sp .6
-.RS 4n
-The number of days before password expires that the user is warned. See \fBshadow\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBinactive\fR\fR
-.ad
-.sp .6
-.RS 4n
-The number of days of inactivity allowed for that user. This is counted on a per-machine basis. The information about the last login is taken from the machine's \fBlastlog\fR file. See \fBshadow\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexpire\fR\fR
-.ad
-.sp .6
-.RS 4n
-An absolute date expressed as the number of days since the UNIX Epoch (January 1, 1970). When this number is reached, the login can no longer be used. For example, an expire value of 13514 specifies a login expiration of January 1, 2007. See \fBshadow\fR(4).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBflag\fR\fR
-.ad
-.sp .6
-.RS 4n
-Set to empty. See \fBshadow\fR(4).
-.RE
-
-.SH ACTUATORS
-.sp
-.LP
-In certain contexts, additional operations can be appropriate to execute in preparation for or following the introduction of a particular action. These additional operations are operating system specific and are generally needed only on a live system image. A live image is the image mounted at \fB/\fR of the active, running boot environment of the current zone. When multiple actions involved in a package installation or removal have identical actuators, then the operation corresponding to actuator presence is executed once for that installation or removal.
-.sp
-.LP
-Incorrectly specified actuators can result in package installation failure if the actuator cannot determine a means of making safe installation progress.
-.sp
-.LP
-The following actuators are defined:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBreboot-needed\fR\fR
-.ad
-.sp .6
-.RS 4n
-Can be set to \fBtrue\fR or \fBfalse\fR. This actuator declares that update or removal of the tagged action must be performed in a new boot environment if the package system is operating on a live image. Creation of a new boot environment is controlled by the \fBbe-policy\fR image property. See the "Image Properties" section in the \fBpkg\fR(1) man page for more information about the \fBbe-policy\fR property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdisable_fmri\fR, \fBrefresh_fmri\fR, \fBrestart_fmri\fR, \fBsuspend_fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Each of these actuators takes the value of an FMRI of a service instance to operate on during the package installation or removal. \fBdisable_fmri\fR causes the given FMRI to be disabled prior to action removal, per the \fBdisable\fR subcommand to \fBsvcadm\fR(1M). \fBrefresh_fmri\fR and \fBrestart_fmri\fR cause the given FMRI to be refreshed or restarted after action installation, update, or removal per the respective subcommands of \fBsvcadm\fR(1M). Finally, \fBsuspend_fmri\fR causes the given FMRI to be disabled temporarily prior to the action install phase, and then enabled after the completion of that phase.
-.sp
-The value can contain a pattern that matches multiple service instances. However, it must do so explicitly with a glob as accepted by \fBsvcs\fR(1), rather than doing so implicitly by not indicating any instances.
-.RE
-
-.SH MEDIATIONS
-.sp
-.LP
-A mediator is a name that represents a set of related symbolic or hard links. If two or more link actions have the same path and mediator name, the user or the package system selects the link target based on version, implementation, or priority. See "Link Actions" for information about mediator attributes.
-.sp
-.LP
-The following example shows two different instances of a mediator named \fBjava\fR where the link choices are between versions. These two \fBlink\fR actions would appear in two different packages.
-.sp
-.in +2
-.nf
-link mediator=java mediator-version=1.6 path=usr/java target=jdk/jdk1.6.0_31
-link mediator=java mediator-version=1.7 path=usr/java target=jdk/jdk1.7.0_02
-.fi
-.in -2
-
-.sp
-.LP
-See the \fBset-mediator\fR subcommand in the \fBpkg\fR(1) man page for information about how to select the version you want for this link path. To have a choice of versions, both packages must be installed.
-.SH CONSTRAINTS AND FREEZING
-.sp
-.LP
-When a package is transitioned to a new version, or when it is added to or removed from the system, the version that is chosen, or whether removal is allowed, is determined by a variety of constraints put on the package. Those constraints can be defined by other packages in the form of dependencies, or by the administrator in the form of freezes.
-.sp
-.LP
-The most common form of constraint is delivered by the \fBrequire\fR dependency, as described in "Depend Actions" above. Such a constraint prevents the package from being downgraded or removed.
-.sp
-.LP
-Most parts of the operating system are encapsulated by packages called \fBincorporations\fR. These packages primarily deliver constraints represented by the \fBincorporate\fR dependency.
-.sp
-.LP
-As described above, an incorporated package need not be present on the system, but if it is, then it specifies both an inclusive minimum version and an exclusive maximum version. For example, if the dependent FMRI has a version of 1.4.3, then no version less than 1.4.3 would satisfy the dependency, and neither would any version greater than or equal to 1.4.4. However, versions that merely extended the dotted sequence, such as 1.4.3.7, would be allowed.
-.sp
-.LP
-Incorporations are used to force parts of the system to upgrade synchronously. For some components, such as the C library and the kernel, this is a basic requirement. For others, such as a simple userland component on which nothing else has a dependency, the synchronous upgrade is used merely to provide a known and tested set of package versions that can be referred to by a particular version of the incorporation.
-.sp
-.LP
-Since an incorporation is simply a package, it can be removed, and all the constraints it delivers are therefore relaxed. However, many of the incorporations delivered by Oracle Solaris are required by the packages they incorporate because that relaxation would not be safe.
-.sp
-.LP
-Attempting an upgrade of a package to a version that is not allowed by an installed incorporation will not attempt to find a newer version of the incorporation in order to satisfy the request, but will instead fail. If the constraint itself must be moved, and the incorporation specifying it cannot be removed, then the incorporation must be upgraded to a version that specifies a desired version of the constraint. Upgrading an incorporation causes all of the incorporated packages that would not satisfy the constraints delivered by the new version to be upgraded as well.
-.sp
-.LP
-A system administrator can constrain a package by using the \fBpkg freeze\fR command. The named package is constrained to the version installed on the system if no version is provided. If a versioned package is provided, then this administrative constraint, or freeze, acts as if an incorporate dependency were installed where the \fBfmri\fR attribute had the value of the provided package version.
-.sp
-.LP
-A freeze is never lifted automatically by the packaging system. To relax a constraint, use the \fBpkg unfreeze\fR command.
-.SH PUBLISHERS AND REPOSITORIES
-.sp
-.LP
-As detailed above, a publisher is simply a name that package clients use to identify the provider of packages. Publishers can distribute their packages using package repositories and/or package archives. There are two types of repositories currently supported by the package system: origin repositories and mirror repositories.
-.sp
-.LP
-An \fBorigin\fR is a package repository that contains all of the metadata (such as catalogs, manifests, and search indexes) and content (files) for one or more packages. If multiple origins are configured for a given publisher in an image, the package client API attempts to choose the best origin to retrieve package data from. This is the most common type of repository, and is implicitly created whenever \fBpkgsend\fR or \fBpkgrecv\fR is used on a package repository.
-.sp
-.LP
-A \fBmirror\fR is a package repository that contains only package content (files). If one or more mirrors are configured for a given publisher in an image, the client API prefers the mirrors for package content retrieval and attempts to choose the best one to retrieve package content from. If the mirror is unreachable, does not have the required content, or is slower, the client API retrieves the content from any configured origin repositories. Mirrors are intended for content sharing among a trusted set of clients using the dynamic mirror functionality of \fBpkg.depotd\fR(1M). Mirrors are also intended to be used to authenticate access to package metadata, but distribute the package content without authentication. For example, a client might be configured with an \fBhttps\fR origin that requires an SSL key and certificate pair to access, and with an \fBhttp\fR mirror that provides the package content. In this way, only authorized clients can install or update the packages, while the overhead of authentication for package content retrieval is avoided. A mirror can be created by removing all subdirectories of a repository except those named \fBfile\fR and their parents. An origin repository can be also be provisioned as a mirror by using the mirror mode of \fBpkg.depotd\fR(1M).
-.SH GLOBAL AND NON-GLOBAL ZONE UPDATE
-.sp
-.LP
-The \fBpkg\fR system forces non-global zones to be kept in sync with the global zone. This means that certain packages must be at the same version in the global zone and all non-global zones to ensure the same kernel is run. To do this, \fBpkg\fR uses \fBparent\fR dependencies to impose certain constraints on non-global zones. See "Depend Actions" above for more information about \fBparent\fR dependencies.
-.sp
-.LP
-Because of restrictions that the global zone imposes on non-global zones, the non-global zones must have access to the packages of the global zone and must have a similar publisher configuration. Both of these objectives are achieved by using a \fBsystem repository\fR (see the \fBpkg.sysrepo\fR(1M) man page). The system repository provides access to the publishers configured in the global zone and information about how those publishers are configured. To prevent non-global zones from choosing different packages during installation or update, system publishers are ranked higher in the publisher search order than publishers configured in the non-global zone. See the \fBpkg set-publisher\fR command in the \fBpkg\fR(1) man page for information about publisher search order.
-.sp
-.LP
-To update all non-global zones on the system, use the \fBpkg update\fR command with no arguments in the global zone. This command operates on the global zone and on each non-global zone recursively. The minimal changes necessary are made to non-global zones to bring them in sync with the changes made in the global zone. For example, suppose package \fBfoo\fR is installed at version 1 in both the global zone and non-global zones, and suppose version 2 is available in a system repository. If \fBfoo\fR has a parent dependency, then \fBpkg update foo\fR updates \fBfoo\fR to version 2 in both the global zone and the non-global zones because the \fBparent\fR dependency forces the package to stay in sync. If \fBfoo\fR does not have a parent dependency, then \fBfoo\fR is updated to version 2 in the global zone but remains at version 1 in the non-global zones.
-.SH FACETS AND VARIANTS
-.sp
-.LP
-Software can have components that are optional and components that are mutually exclusive. Examples of optional components include locales and documentation. Examples of mutually exclusive components include SPARC or x86 and debug or non-debug binaries.
-.sp
-.LP
-In IPS, optional components are called \fBfacets\fR and mutually exclusive components are called \fBvariants\fR. Facets and variants are specified as tags on package actions. Each facet and variant tag has a name and a value. A single action can have multiple facet and variant tags. Examples of components with multiple facet and variant tags include an architecture-specific header file that is used by developers, or a component that is only for a SPARC global zone.
-.sp
-.LP
-An example of a variant tag is \fBvariant.arch=sparc\fR. An example of a facet tag is \fBfacet.devel=true\fR. Facets and variants are often referred to without the leading \fBfacet.\fR and \fBvariant.\fR.
-.sp
-.LP
-Facets and variants are special properties of the image and cannot be set on individual packages. To view the current values of the facets and variants set on the image, use the \fBpkg facet\fR and \fBpkg variant\fR commands as shown in the \fBpkg\fR(1) man page. To modify the values of the facets and variants set on the image, use the \fBpkg change-facet\fR and \fBpkg change-variant\fR commands.
-.sp
-.LP
-Facets are treated as boolean values by package clients: Facets can be set only to \fBtrue\fR (enabled) or \fBfalse\fR (disabled) in the image. By default, all facets starting with 'facet.debug.' or 'facet.optional.' are considered to be set to \fBfalse\fR in the image; all others are considered to be set to \fBtrue\fR in the image.
-.sp
-.LP
-Facets can be either set locally within an image using the \fBpkg change-facet\fR command or inherited from a parent image. For example, a non-global zone can inherit a facet from the global zone. Inherited facets are evaluated before, and take priority over, any locally set facets. If the same facet is both inherited and locally set, the inherited facet value masks the locally set value. Masked facets have no effect on facet evaluation and package actions. Facet changes made by using the \fBpkg change-facet\fR command only affect locally set facets. Inherited facets can only be changed by making the change in the parent image. By default, the \fBpkg facet\fR command does not display masked facets.
-.sp
-.LP
-The value of a facet tag on an action can be set to \fBall\fR or \fBtrue\fR to control how clients filter faceted actions. All values other than \fBall\fR or \fBtrue\fR have undefined behavior. See below for a description of the conditions that must exist in the image to install an action that has facet tags.
-.sp
-.LP
-The \fBall\fR value for a facet is useful when more than a single level of filtering is required. In the following example, \fBfoo.txt\fR is installed only if the \fBdoc\fR facet and at least one of the \fBlocale\fR facets is \fBtrue\fR in the image. This enables administrators to exclude documentation, but still enable or disable support for specific locales. In addition, \fBapi.txt\fR is only installed if both the \fBdoc\fR and \fBdevel\fR facets are \fBtrue\fR in the image.
-.sp
-.in +2
-.nf
-file path=usr/share/doc/foo/foo.txt facet.doc=all facet.locale.en_GB=true facet.locale.en_US=true
-file path=usr/share/doc/foo/api.txt facet.doc=all facet.devel=all
-.fi
-.in -2
-
-.sp
-.LP
-A facet set on the image can be a full facet such as \fBdoc.man\fR or a pattern such as \fBlocale.*\fR. This is useful when you want to disable a portion of the facet namespace, and only enable individual facets within it. For example, you could disable all locales and then only enable one or two specific locales, as shown in the following example:
-.sp
-.in +2
-.nf
-# \fBpkg change-facet locale.*=false\fR
+<refentry id="pkg-5">
+<refmeta><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum>
+<refmiscinfo class="date">10 Mar 2015</refmiscinfo>
+<refmiscinfo class="sectdesc">&man5;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2009, 2015, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg</refname><refpurpose>Image Packaging System</refpurpose>
+</refnamediv>
+<refsect1 id="GLHDA" role="description"><title></title>
+<para>The image packaging system, <literal>pkg</literal>(5), is a framework
+that provides for software lifecycle management (installation, upgrade, and
+removal). Image packaging manages software in units of packages, which are
+collections of actions, defined by a set of key/value pairs and possibly a
+data payload. In many cases, actions are files found in a file system, but
+they also represent other installable objects, such as drivers, services,
+and users.</para>
+</refsect1>
+<refsect1 role="other"><title>Package FMRIs and Versions</title>
+<para>Each package is represented by a fault management resource identifier
+(FMRI) with the scheme <literal>pkg:</literal>. The full FMRI for a package
+consists of the scheme, a publisher, the package name, and a version string
+in the following format:</para>
+<screen>pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
+</screen>
+<para><literal>solaris</literal> is the publisher. <literal>system/library/c++-runtime
+</literal> is the package name. Although the namespace is hierarchical and
+arbitrarily deep, there is no enforced containment; the name is essentially
+arbitrary. The publisher information is optional, but must be preceded by <literal>
+pkg://</literal> if present. An FMRI that includes the publisher is often
+referred to as being &ldquo;fully qualified.&rdquo; If publisher information
+is not present, then the package name should generally be preceded by <literal>pkg:/
+</literal>.</para>
+<para>Packaging clients often allow the scheme of an FMRI to be omitted if
+it does not contain publisher information. For example, <literal>pkg:/system/library/c++-runtime
+</literal> can be written as <literal>system/library/c++-runtime</literal>.
+If the scheme is omitted, clients also allow omission of all but the last
+component of a package name for matching purposes. For example, <literal>system/library/c++-runtime
+</literal> could be written as <literal>library/c++-runtime</literal> or <literal>
+c++-runtime</literal>, which would then match packages named <literal>c++-runtime
+</literal> or package names ending in <literal>/c++-runtime</literal>.</para>
+<para>A publisher name identifies a person, group of persons, or an organization
+as the source of one or more packages. To avoid publisher name collisions
+and help identify the publisher, a best practice is to use a domain name that
+represents the entity publishing the packages as a publisher name.</para>
+<para>The version follows the package name, separated by an at sign (@). The
+version consists of four sequences of numbers, separated by punctuation. The
+elements in the first three sequences are separated by dots, and the sequences
+are arbitrarily long. Leading zeros in version components (for example, 01.1
+or 1.01) are not permitted. Trailing zeros (for example, 1.10) are permitted.</para>
+<para>The first part of the version is the component version. For components
+tightly bound to the operating system, this is usually the value of
+<command>uname -r</command> for that version of the operating system. For a
+component with its own development lifecycle, this sequence is a dotted
+release number, such as 2.4.10.</para>
+<para>The second part of the version, which if present must follow a comma
+(,), is the build version. The build version specifies what version of the
+operating system the contents of the package were built on, providing a minimum
+bound on which operating system version the contents can be expected to run
+successfully.</para>
+<para>The third part of the version, which if present must follow a hyphen
+(<literal>-</literal>), is the branch version. The branch version is a versioning
+component that provides vendor-specific information. The branch version can
+be incremented when the packaging metadata is changed, independently of the
+component version. The branch version might contain a build number or other
+information.</para>
+<para>The fourth part of the version, which if present must follow a colon
+(:), is a timestamp. The timestamp represents when the package was published.</para>
+<para>When performing comparisons between versions, no component of the full
+version is considered unless the components to its left are the same. Thus, <literal>
+4.3-1</literal> is greater than <literal>4.2-7</literal> because <literal>4.3</literal> is
+greater than <literal>4.2</literal>, and <literal>4.3-3</literal> is greater
+than <literal>4.3-1</literal> because <literal>3</literal> is greater than <literal>
+1</literal>.</para>
+<para>The <literal>pkg.human-version</literal> attribute can be used to provide
+a human-readable version string. The value of the
+<literal>pkg.human-version</literal> attribute can be provided in addition to
+the package version described above for the package FMRI but cannot replace the
+package FMRI version. The human-readable version string is only used for
+display purposes. See &ldquo;Set Actions&rdquo; for more information.</para>
+<para>Many parts of the system, when appropriate, abridge FMRIs when displaying
+them, and accept input in shorter forms to reduce the volume of information
+displayed or required. Typically, the scheme, publisher, build version, and
+timestamp can be elided. Sometimes all of the versioning information can be
+omitted.</para>
+</refsect1>
+<refsect1 role="other"><title>Actions</title>
+<para>Actions represent the installable objects on a system. Actions are described
+in the manifest of a package. Every action consists primarily of its name
+and a key attribute. Together, these refer to a unique object as it follows
+a version history. Actions can have other attributes. Some attributes are
+interpreted directly by the packaging system. Other attributes might be useful
+only to the system administrator or the end-user.</para>
+<para>Actions have a simple text representation:</para>
+<programlisting><replaceable>action_name</replaceable> <replaceable>attribute1</replaceable>=<replaceable>
+value1</replaceable> <replaceable>attribute2</replaceable>=<replaceable>value2</replaceable> ...
+</programlisting>
+<para>Names of attributes cannot have whitespace, quotation marks, or equals
+signs (=) in them. All characters after the first equals sign belong to the
+value. Values can have all of those, though spaces must be enclosed in single
+or double quotation marks. Single quotation marks do not need to be escaped
+inside a string that is enclosed in double quotation marks, and double quotation
+marks do not need to be escaped inside a string that is enclosed in single
+quotation marks. A quotation mark can be prefixed with a backslash (&bsol;)
+character to avoid terminating the quoted string. A backslash can be escaped
+with a backslash.</para>
+<para>Actions can have multiple attributes. Some attributes can be named multiple
+times with different values for a single action. Multiple attributes with
+the same name are treated as unordered lists.</para>
+<para>Actions with many attributes can create long lines in a manifest file.
+Such lines can be wrapped by terminating each incomplete line with a backslash.
+Note that this continuation character must occur between attribute/value pairs.
+Neither attributes nor their values nor the combination can be split.</para>
+<para>The attributes listed below are not an exhaustive set. In fact, the
+attributes that can be attached to an action are arbitrary, and the standard
+sets of attributes are easy to augment to incorporate future developments.</para>
+<para>Some attributes cause additional operations to be executed outside of
+the packaging context. These attributes are documented in the &ldquo;Actuators&rdquo;
+section below.</para>
+<refsect2><title>File Actions</title>
+<para>The <literal>file</literal> action represents an ordinary file. The <literal>
+file</literal> action references a payload, and has four standard attributes:</para>
+<variablelist>
+<varlistentry><term><literal>path</literal></term>
+<listitem><para>The file system path where the file is installed. This is
+a <literal>file</literal> action's key attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mode</literal></term>
+<listitem><para>The access permissions (in numeric form) of the file. These
+are simple permissions only, not ACLs.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>owner</literal></term>
+<listitem><para>The name of the user that owns the file.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal></term>
+<listitem><para>The name of the group that owns the file.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>The payload is a positional attribute in that it is not named. It is
+the first word after the action name. In a published manifest, it is the <literal>
+SHA-1</literal> hash of the file contents. If present in a manifest that has
+yet to be published, it represents the path where the payload can be found.
+See <command>pkgsend</command>(1). The hash attribute can be used instead
+of the positional attribute, should the value include an equals sign. Both
+can be used in the same action. However, the hashes must be identical.</para>
+<para>The <literal>preserve</literal> and <literal>overlay</literal> attributes
+affect whether and how a <literal>file</literal> action is installed.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>preserve</literal></term>
+<listitem><para>Specifies when and how files are preserved during package
+operations.</para>
+<para>When a package is initially installed, if a file delivered by the package
+has a <literal>preserve</literal> attribute defined with any value and the
+file already exists in the image, the existing file is stored in <filename>/var/pkg/lost+found
+</filename> and the packaged file is installed.</para>
+<para>When a package is initially installed, if a file delivered by the package
+has a <literal>preserve</literal> attribute defined and the file does not
+already exist in the image, whether that file is installed depends on the
+value of the <literal>preserve</literal> attribute:</para>
+<itemizedlist>
+<listitem><para>If the value of <literal>preserve</literal> is <literal>legacy</literal>,
+the packaged file is not installed.</para></listitem>
+<listitem><para>If the value of <literal>preserve</literal> is not <literal>legacy
+</literal>, the packaged file is installed.</para></listitem>
+</itemizedlist>
+<para>When a package is downgraded, if a file delivered by the downgraded
+version of the package has a <literal>preserve</literal> attribute defined
+with any value and all of the following
+conditions are true, the file that currently exists in the image is renamed
+with the extension <filename>.update</filename>, and the file from the
+downgraded package is installed.</para>
+<itemizedlist>
+<listitem><para>The file exists in the image.</para></listitem>
+<listitem><para>The content of the file delivered by the downgraded version
+of the package is different from the content of the file delivered by the
+currently installed version of the package.</para></listitem>
+<listitem><para>The content of the file delivered by the downgraded version
+of the package is different from the content of the file that exists in the
+image.</para></listitem>
+</itemizedlist>
+<para>If any of the above conditions is not true, the file is treated the
+same as if the package is being upgraded, rather than downgraded.</para>
+<para>When a package is upgraded, if a <literal>file</literal> action delivered
+by the upgraded version of the package has a <literal>preserve</literal> attribute
+defined with any value and the <literal>file</literal> action is the same
+as the <literal>file</literal> action delivered by the currently installed
+version of the package, the file is not installed, and the file that exists
+in the image is not modified. Any modifications made since the previous version
+was installed are preserved.</para>
+<para>When a package is upgraded, if a <literal>file</literal> action delivered
+by the upgraded version of the package has a <literal>preserve</literal> attribute
+defined and the <literal>file</literal> action is new or is different from
+the <literal>file</literal> action delivered by the currently installed version
+of the package, the upgrade is done in the following way:</para>
+<itemizedlist>
+<listitem><para>If the file does not exist in the image, the new file is installed.
+</para></listitem>
+<listitem><para>If the file delivered by the upgraded version of the package
+exists in the image, did not exist in the currently installed version of the
+package, and was not renamed or moved by using the <literal>original_name</literal> attribute
+(see below), then the existing file is stored in <filename>/var/pkg/lost+found</filename> and
+the file delivered by the upgraded version of the package is installed.</para>
+</listitem>
+<listitem><para>If the file delivered by the upgraded version of the package
+exists in the image and has different content from the file delivered by the
+currently installed version of the package, the upgrade is done according
+to the value of the <literal>preserve</literal> attribute:</para>
+<itemizedlist>
+<listitem><para>If the file delivered by the upgraded version of the package
+has a <literal>preserve</literal> value of <literal>renameold</literal>, the
+existing file is renamed with the extension <filename>.old</filename>, and
+the new file is installed with updated permissions and timestamp (if present).
+See the <literal>timestamp</literal> attribute description below.</para>
+</listitem>
+<listitem><para>If the file delivered by the upgraded version of the package
+has a <literal>preserve</literal> value of <literal>renamenew</literal>, the
+new file is installed with the extension <filename>.new</filename> and the
+existing file is not modified.</para></listitem>
+<listitem><para>If the file delivered by the upgraded version of the package
+has a <literal>preserve</literal> value of <literal>true</literal>, the new
+file is not installed, but the permissions and timestamp (if present) are
+reset on the existing file.</para></listitem>
+</itemizedlist>
+</listitem>
+<listitem><para>If the file delivered by the upgraded version of the package
+exists in the image, has the same content as the file delivered by the currently
+installed version of the package, and has a <literal>preserve</literal> value
+of either <literal>renameold</literal> or <literal>renamenew</literal>, the
+existing file is replaced by the file delivered by the upgraded version of
+the package, including replacing permissions and timestamp (if present).</para>
+</listitem>
+<listitem><para>If the file delivered by the upgraded version of the package
+exists in the image, has a <literal>preserve</literal> value of <literal>legacy</literal> in
+the upgraded package, and has a different <literal>preserve</literal> value
+in the currently installed version of the package, the existing file is renamed
+with the extension <literal>.legacy</literal>, and the new file is installed
+with updated permissions and timestamp (if present).</para></listitem>
+<listitem><para>If the file delivered by the upgraded version of the package
+exists in the image and has a <literal>preserve</literal> value of <literal>legacy
+</literal> in both the upgraded package and the currently installed version
+of the package, the permissions and timestamp (if present) are reset on the
+existing file.</para></listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>overlay</literal></term>
+<listitem><para>Specifies whether the action allows other packages to deliver
+a file at the same location or whether it delivers a file intended to overlay
+another file. This functionality is intended for use with configuration files
+that do not participate in any self-assembly (for example, <filename>/etc/motd</filename>)
+and that can be safely overwritten.</para>
+<para>If <literal>overlay</literal> is not specified, multiple packages cannot
+deliver files to the same location.</para>
+<para>The <literal>overlay</literal> attribute can have one of the following
+values:</para>
+<variablelist>
+<varlistentry><term><literal>allow</literal></term>
+<listitem><para>One other package is allowed to deliver a file to the same
+location. This value has no effect unless the <literal>preserve</literal> attribute
+is also set.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>true</literal></term>
+<listitem><para>The file delivered by the action overwrites any other action
+that has specified <literal>allow</literal>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Changes to the installed file are preserved based on the value of the <literal>
+preserve</literal> attribute of the overlaying file. On removal, the contents
+of the file are preserved if the action being overlaid is still installed,
+regardless of whether the <literal>preserve</literal> attribute was specified.
+Only one action can overlay another, and the <literal>mode</literal>, <literal>owner
+</literal>, and <literal>group</literal> attributes must match.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>dehydrate</literal></term>
+<listitem><para>Specifies whether this action should be removed when a package publisher's packages are dehydrated or when a dehydrated publisher's packages are modified. The value of the <literal>dehydrate</literal> attribute can be <literal>true</literal> or <literal>false</literal>. If the value of the <literal>dehydrate</literal> attribute is <literal>false</literal>, the action will not be removed during dehydrate operations. Otherwise, the action will be removed. File actions tagged with the <literal>preserve</literal> or <literal>overlay</literal> attributes are implicitly excluded from dehydration operations and do not need this attribute.
+</para>
+<programlisting>file path=etc/zones/SYSdefault.xml dehydrate=false ...</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>The following attributes are recognized for ELF files:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>elfarch</literal></term>
+<listitem><para>The architecture of the ELF file. This is the output of <command>
+uname -p</command> on the architecture for which the file is built.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>elfbits</literal></term>
+<listitem><para>This is <literal>32</literal> or <literal>64</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>elfhash</literal></term>
+<listitem><para>This is the hash of the &ldquo;interesting&rdquo; ELF sections
+in the file. These are the sections that are mapped into memory when the binary
+is loaded. These are the only sections necessary to consider when determining
+whether the executable behavior of two binaries will differ.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>The following additional attributes are recognized for <literal>file</literal> actions:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>original_name</literal></term>
+<listitem><para>This attribute is used to handle editable files moving from
+package to package or from place to place, or both. The form this takes is
+the name of the originating package, followed by a colon and the original
+path to the file. Any file being deleted is recorded either with its package
+and path, or with the value of the <literal>original_name</literal> attribute
+if specified. Any editable file being installed that has the <literal>original_name
+</literal> attribute set uses the file of that name if it is deleted as part
+of the same packaging operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>release-note</literal></term>
+<listitem><para>This attribute is used to indicate that this file contains
+release note text. The value of this attribute is a package FMRI. If the FMRI
+specifies a package name that is present in the original image and a version
+that is newer than the version of the package in the original image, this
+file will be part of the release notes. A special FMRI of <literal>feature/pkg/self
+</literal> refers to the containing package. If the version of <literal>feature/pkg/self
+</literal> is 0, this file will only be part of the release notes on initial
+installation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>revert-tag</literal></term>
+<listitem><para>This attribute is used to tag editable files that should be
+reverted as a set. The value of the <literal>revert-tag</literal> attribute
+is a <replaceable>tagname</replaceable>. Multiple <literal>revert-tag</literal> attributes
+can be specified for a single <literal>file</literal> action. The file reverts
+to its manifest-defined state when <command>pkg revert</command> is invoked
+with any of those tags specified. See the <command>pkg</command>(1) man page
+for information about the <command>pkg revert</command> command.</para>
+<para>The <literal>revert-tag</literal> attribute can also be specified at the directory level. See &ldquo;Directory Actions&rdquo; below.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>sysattr</literal></term>
+<listitem><para>This attribute is used to specify any system attributes that should be set for this file. The value of the <literal>sysattr</literal> attribute can be a comma-separated list of verbose system attributes or a string sequence of compact system attribute options, as shown in the following examples. Supported system attributes are explained in the <literal>chmod</literal>(1) man page. System attributes specified in the manifest are set additionally to system attributes that might have been set by other subsystems of the operating system.</para>
+<programlisting>file path=opt/secret_file sysattr=hidden,sensitive
+file path=opt/secret_file sysattr=HT</programlisting>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>timestamp</literal></term>
+<listitem><para>This attribute is used to set the access and modification
+time on the file. The <literal>timestamp</literal> attribute value must be
+expressed in UTC in ISO-8601 format, omitting the colons and hyphens.</para>
+<para>The <literal>timestamp</literal> attribute is essential when packaging <filename>.pyc</filename> or <filename>.pyo</filename> files for Python. The related <filename>.py</filename> file for the <filename>.pyc</filename> or <filename>.pyo</filename> files must be marked with the timestamp embedded within those files, as shown in the following example:</para>
+<programlisting>file path=usr/lib/python2.7/vendor-packages/pkg/__init__.pyc ...
+file path=usr/lib/python2.7/vendor-packages/pkg/__init__.py &bsol;
+     timestamp=20130311T221521Z ...</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>The following attributes for <literal>file</literal> actions are automatically generated by the system and should not be specified by package developers:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>hash</literal></term>
+<listitem><para>The SHA-1 hash of the uncompressed file.</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>chash</literal></term>
+<listitem><para>The SHA-1 hash of the compressed file.</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.size</literal></term>
+<listitem><para>The size in bytes of the uncompressed file.</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.csize</literal></term>
+<listitem><para>The size in bytes of the compressed file.</para></listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>Directory Actions</title>
+<para>The <literal>dir</literal> action is like the <command>file</command> action in that it
+represents a file system object. The <literal>dir</literal> action represents a directory instead of
+an ordinary file. The <literal>dir</literal> action has the same <literal>path</literal>,
+<literal>mode</literal>, <literal>owner</literal>, and <literal>group</literal> attributes that the
+<literal>file</literal> action has, and <literal>path</literal> is the key attribute. The <literal>dir</literal> action also accepts the <literal>revert-tag</literal> attribute. The value of the <literal>revert-tag</literal> attribute is different for <literal>file</literal> and <literal>dir</literal> actions.</para>
+<para>Directories are reference counted in IPS. When the last package that either explicitly or
+implicitly references a directory no longer does so, that directory is removed. If that directory
+contains unpackaged file system objects, those items are moved into
+<filename>$IMAGE_META/lost+found</filename>. See the &ldquo;Files&rdquo; section for more
+information about <literal>$IMAGE_META</literal>.</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><literal>revert-tag</literal></term>
+<listitem>
+<para>This attribute is used to identify unpackaged files that should be removed as a set. See
+&ldquo;File Actions&rdquo; above for a description of how to specify this attribute for
+<literal>file</literal> actions. For directories, the value of the <literal>revert-tag</literal>
+attribute is
+<replaceable>tagname</replaceable><literal>=</literal><replaceable>pattern</replaceable>. Multiple
+<literal>revert-tag</literal> attributes can be specified for a single <literal>dir</literal>
+action. When <command>pkg revert</command> is invoked with a matching
+<replaceable>tagname</replaceable>, any unpackaged files or directories under this
+<literal>dir</literal> directory that match <replaceable>pattern</replaceable> (using shell globbing
+characters) are removed. See the <command>pkg</command>(1) man page for information about the
+<command>pkg revert</command> command.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>salvage-from</literal></term>
+<listitem><para>This attribute can be used to move unpackaged contents into a new directory. The value of this
+attribute is the name of a directory of salvaged items. A directory with a
+<literal>salvage-from</literal> attribute inherits on creation any contents of the directory named
+in the value of the <literal>salvage-from</literal> attribute.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>Link Actions</title>
+<para>The <literal>link</literal> action represents a symbolic link. The <literal>link</literal>
+action has the following standard attributes:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>path</literal></term>
+<listitem><para>The file system path where the symbolic link is installed.
+This is a <literal>link</literal> action's key attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>target</literal></term>
+<listitem><para>The target of the symbolic link. The file system object to
+which the link resolves.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator</literal></term>
+<listitem><para>Specifies the entry in the mediation namespace shared by all
+path names participating in a given mediation group (for example, <literal>python
+</literal>). Link mediation can be performed based on <literal>mediator-version</literal> and/or <literal>
+mediator-implementation</literal>. All mediated links for a given path name
+must specify the same mediator. However, not all mediator versions and implementations
+need to provide a link at a given path. If a mediation does not provide a
+link, then the link is removed when that mediation is selected. A <literal>mediator
+</literal>, in combination with a specific version and/or implementation represents
+a mediation that can be selected for use by the packaging system.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-version</literal></term>
+<listitem><para>Specifies the version (expressed as a dot-separated sequence
+of nonnegative integers) of the interface described by the <literal>mediator</literal> attribute.
+This attribute is required if <literal>mediator</literal> is specified and <literal>
+mediator-implementation</literal> is not. A local system administrator can
+set the version to use explicitly. The value specified should generally match
+the version of the package delivering the link (for example, <literal>runtime/python-27
+</literal> should use <literal>mediator-version=2.7</literal>), although this
+is not required.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-implementation</literal></term>
+<listitem><para>Specifies the implementation of the mediator for use in addition
+to or instead of the <literal>mediator-version</literal>. Implementation strings
+are not considered to be ordered and a string is arbitrary selected by <literal>pkg
+</literal>(5) if not explicitly specified by a system administrator.</para>
+<para>The value can be a string of arbitrary length composed of alphanumeric
+characters and spaces. If the implementation itself can be versioned or is
+versioned, then the version should be specified at the end of the string,
+after a @ (expressed as a dot-separated sequence of nonnegative integers).
+If multiple versions of an implementation exist, the default behavior is to
+select the implementation with the greatest version.</para>
+<para>If only one instance of an implementation mediation link at a particular
+path is installed on a system, then that one is chosen automatically. If future
+links at the path are installed, the link is not switched unless a vendor,
+site, or local override applies, or if one of the links is version mediated.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-priority</literal></term>
+<listitem><para>When resolving conflicts in mediated links, <literal>pkg</literal>(5)
+normally chooses the link with the greatest value of <literal>mediator-version</literal> or
+based on <literal>mediator-implementation</literal> if that is not possible.
+This attribute is used to specify an override for the normal conflict resolution
+process.</para>
+<para>If this attribute is not specified, the default mediator selection logic
+is applied.</para>
+<para>If the value is <literal>vendor</literal>, the link is preferred over
+those that do not have a <literal>mediator-priority</literal> specified.</para>
+<para>If the value is <literal>site</literal>, the link is preferred over
+those that have a value of <literal>vendor</literal> or that do not have a <literal>
+mediator-priority</literal> specified.</para>
+<para>A local system administrator can override the selection logic described
+above.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>Hardlink Actions</title>
+<para>The <literal>hardlink</literal> action represents a hard link. It has
+the same attributes as the <literal>link</literal> action, and <literal>path</literal> is
+also its key attribute.</para>
+</refsect2>
+<refsect2><title>Driver Actions</title>
+<para>The <literal>driver</literal> action represents a device driver. The <literal>
+driver</literal> action does not reference a payload. The driver files themselves
+must be installed as <literal>file</literal> actions. The following attributes
+are recognized (see <command>add_drv</command>(1M) for more information):</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>name</literal></term>
+<listitem><para>The name of the driver. This is usually, but not always, the
+file name of the driver binary. This is the <literal>driver</literal> action's
+key attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>alias</literal></term>
+<listitem><para>This represents an alias for the driver. A given driver can
+have more than one <literal>alias</literal> attribute. No special quoting
+rules are necessary.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>class</literal></term>
+<listitem><para>This represents a driver class. A given driver can have more
+than one <literal>class</literal> attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>perms</literal></term>
+<listitem><para>This represents the file system permissions for the driver's
+device nodes.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>clone_perms</literal></term>
+<listitem><para>This represents the file system permissions for the clone
+driver's minor nodes for this driver.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>policy</literal></term>
+<listitem><para>This specifies additional security policy for the device.
+A given driver can have more than one <literal>policy</literal> attribute,
+but no minor device specification can be present in more than one attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>privs</literal></term>
+<listitem><para>This specifies privileges used by the driver. A given driver
+can have more than one <literal>privs</literal> attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>devlink</literal></term>
+<listitem><para>This specifies an entry in <filename>/etc/devlink.tab</filename>. The value is the exact line to go into the file, with tabs denoted by <literal>&bsol;t</literal>. See <literal>devlinks</literal>(1M) for more information. A given driver can have more than one <literal>devlink</literal> attribute.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>Depend Actions</title>
+<para>The <command>depend</command> action represents an inter-package dependency.
+A package can depend on another package because the first requires functionality
+in the second for the functionality in the first to work, or even to install.
+Dependencies can be optional. If a dependency is not met at the time of installation,
+the packaging system attempts to install or update the dependent package to
+a sufficiently new version, subject to other constraints.</para>
+<para>The following attributes are recognized:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>fmri</literal></term>
+<listitem><para>The FMRI representing the dependent package. This is the <literal>
+dependency</literal> action's key attribute. The <literal>fmri</literal> value
+must not include the publisher. The package name is assumed to be complete.
+Dependencies of type <literal>require-any</literal> can have multiple <literal>fmri
+</literal> attributes. A version is optional on the <literal>fmri</literal> value,
+though for some types of dependencies, an <literal>fmri</literal> with no
+version has no meaning.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>type</literal></term>
+<listitem><para>The type of the dependency.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>require</literal></term>
+<listitem><para>The dependency is required and must have a version equal to
+or greater than the version specified in the <literal>fmri</literal> attribute.
+If the version is not specified, any version satisfies the dependency. A package
+cannot be installed if any of its required dependencies cannot be satisfied.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>optional</literal></term>
+<listitem><para>The dependency, if present, must be at the specified version
+level or greater.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exclude</literal></term>
+<listitem><para>The containing package cannot be installed if the dependency
+is present at the specified version level or greater. If no version is specified,
+the dependent package cannot be installed concurrently with the package specifying
+the dependency.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>incorporate</literal></term>
+<listitem><para>The dependency is optional, but the version of the dependent
+package is constrained. See &ldquo;Constraints and Freezing&rdquo; below.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-any</literal></term>
+<listitem><para>Any one of multiple dependent packages as specified by multiple <literal>fmri</literal>
+attributes can satisfy the dependency, following the same rules as the <literal>require</literal>
+dependency type.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>conditional</literal></term>
+<listitem><para>The dependency is required only if the package defined by
+the <literal>predicate</literal> attribute is present on the system.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>origin</literal></term>
+<listitem><para>Prior to installation of this package, the dependency target must, if present, be at the
+specified value or greater on the image to be modified. If the value of the
+<literal>root-image</literal> attribute is <literal>true</literal>, the target must be present on
+the image rooted at / in order to install this package. If the value of the
+<literal>root-image</literal> attribute is <literal>true</literal> and the value of the
+<literal>fmri</literal> attribute starts with <literal>pkg:/feature/firmware/</literal>, the
+remainder of the <literal>fmri</literal> value is treated as a command in
+<filename>/usr/lib/fwenum</filename> that evaluates the firmware dependency. See
+<citetitle>Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle>
+for examples.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal></term>
+<listitem><para>The dependency is required unless the package is on the image
+avoid list. Note that obsolete packages silently satisfy the group dependency.
+See the <command>avoid</command> subcommand in <command>pkg</command>(1).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>parent</literal></term>
+<listitem><para>The dependency is ignored if the image is not a child image.
+If the image is a child image then the dependency is required to be present
+in the parent image. The package version matching for a <literal>parent</literal> dependency
+is the same as that used for <literal>incorporate</literal> dependencies.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>predicate</literal></term>
+<listitem><para>The FMRI representing the predicate for <literal>conditional</literal> dependencies.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>root-image</literal></term>
+<listitem><para>Has an effect only for <literal>origin</literal> dependencies
+as mentioned above.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>License Actions</title>
+<para>The <literal>license</literal> action represents a license or other
+informational file associated with the package contents. A package can deliver
+licenses, disclaimers, or other guidance to the package installer through
+the use of the <literal>license</literal> action.</para>
+<para>The payload of the <literal>license</literal> action is delivered into
+the image metadata directory related to the package, and should only contain
+human-readable text data. It should not contain HTML or any other form of
+markup. Through attributes, <literal>license</literal> actions can indicate
+to clients that the related payload must be displayed and/or require acceptance
+of it. The method of display and/or acceptance is at the discretion of clients.</para>
+<para>The following attributes are recognized:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>license</literal></term>
+<listitem><para>This is a <literal>license</literal> action's key attribute.
+This attribute provides a meaningful description for the license to assist
+users in determining the contents without reading the license text itself.
+Some example values include:</para>
+<itemizedlist>
+<listitem><para>ABC Co. Copyright Notice</para></listitem>
+<listitem><para>ABC Co. Custom License</para></listitem>
+<listitem><para>Common Development and Distribution License 1.0 (CDDL)</para>
+</listitem>
+<listitem><para>GNU General Public License 2.0 (GPL)</para></listitem>
+<listitem><para>GNU General Public License 2.0 (GPL) Only</para></listitem>
+<listitem><para>MIT License</para></listitem>
+<listitem><para>Mozilla Public License 1.1 (MPL)</para></listitem>
+<listitem><para>Simplified BSD License</para></listitem>
+</itemizedlist>
+<para>The <literal>license</literal> value must be unique within a package.
+Including the version of the license in the description, as shown in several
+of the examples above, is recommended. If a package has code under multiple
+licenses, use multiple <literal>license</literal> actions. The length of the
+license attribute value should not be more than 64 characters.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>must-accept</literal></term>
+<listitem><para>When <literal>true</literal>, this license must be accepted
+by a user before the related package can be installed or updated. Omission
+of this attribute is equivalent to <literal>false</literal>. The method of
+acceptance (interactive or configuration-based, for example) is at the discretion
+of clients. For package updates, this attribute is ignored if the license
+action or payload has not changed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>must-display</literal></term>
+<listitem><para>When <literal>true</literal>, the action's payload must be
+displayed by clients during packaging operations. Omission of this value is
+equivalent to <literal>false</literal>. This attribute should not be used
+for copyright notices. This attribute should only be used for licenses or
+other material that must be displayed during operations. The method of display
+is at the discretion of clients. For package updates, this attribute is ignored
+if the license action or payload has not changed.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>Legacy Actions</title>
+<para>The <literal>legacy</literal> action represents package data used by
+a legacy packaging system. The attributes associated with this action are
+added into the legacy system's databases so that the tools querying those
+databases can operate as if the legacy package were actually installed. In
+particular, this should be sufficient to convince the legacy system that the
+package named by the <literal>pkg</literal> attribute is installed on the
+system, so that the package can be used to satisfy dependencies.</para>
+<para>The following attributes, named in accordance with the parameters on <literal>
+pkginfo</literal>(4), are recognized:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>category</literal></term>
+<listitem><para>The value for the <literal>CATEGORY</literal> parameter. The
+default value is <literal>system</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>desc</literal></term>
+<listitem><para>The value for the <literal>DESC</literal> parameter.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>hotline</literal></term>
+<listitem><para>The value for the <literal>HOTLINE</literal> parameter.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>name</literal></term>
+<listitem><para>The value for the <literal>NAME</literal> parameter. The default
+value is <literal>none provided</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg</literal></term>
+<listitem><para>The abbreviation for the package being installed. The default
+value is the name from the FMRI of the package. This is a <literal>legacy</literal> action's
+key attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>vendor</literal></term>
+<listitem><para>The value for the <literal>VENDOR</literal> parameter.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>version</literal></term>
+<listitem><para>The value for the VERSION parameter. The default value is
+the version from the FMRI of the package.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>Set Actions</title>
+<para>The <literal>set</literal> action represents a package-level attribute,
+or metadata, such as the package description.</para>
+<para>The following attributes are recognized:</para>
+<variablelist>
+<varlistentry><term><literal>name</literal></term>
+<listitem><para>The name of the attribute.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>value</literal></term>
+<listitem><para>The value given to the attribute.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>The <literal>set</literal> action can deliver any metadata the package
+author chooses. However, there are a number of well defined attribute names
+that have specific meaning to the packaging system.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>info.classification</literal></term>
+<listitem><para>One or more tokens that a <literal>pkg</literal>(5) client
+can use to classify the package. The value should have a scheme (such as &ldquo;org.opensolaris.category.2008&rdquo;
+or &ldquo;org.acm.class.1998&rdquo;) and the actual classification, such as &ldquo;Applications/Games&rdquo;,
+separated by a colon (:).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.description</literal></term>
+<listitem><para>A detailed description of the contents and functionality of
+the package, typically a paragraph or so in length.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.fmri</literal></term>
+<listitem><para>The name and version of the containing package. See
+&ldquo;Package FMRIs and Versions&rdquo; in the &ldquo;Description&rdquo;
+section.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.human-version</literal></term>
+<listitem><para>The version scheme used by IPS is strict. See &ldquo;Package
+FMRIs and Versions&rdquo; in the &ldquo;Description&rdquo; section. A more
+flexible version can be provided as the value of the
+<literal>pkg.human-version</literal> attribute. The value is displayed by IPS
+tools such as <command>pkg info</command>, <command>pkg contents</command>, and
+<command>pkg search</command>. The <literal>pkg.human-version</literal> value
+is not used as a basis for version comparison and cannot be used in place of
+the <literal>pkg.fmri</literal> version.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.obsolete</literal></term>
+<listitem><para>When <literal>true</literal>, the package is marked obsolete.
+An obsolete package can have no actions other than more set actions, and must
+not be marked renamed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.renamed</literal></term>
+<listitem><para>When <literal>true</literal>, the package has been renamed.
+There must be one or more <literal>depend</literal> actions in the package
+as well that point to the package versions to which this package has been
+renamed. A package cannot be marked both renamed and obsolete, but otherwise
+can have any number of set actions.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.summary</literal></term>
+<listitem><para>A short, one-line description of the package.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>Group Actions</title>
+<para>The <literal>group</literal> action defines a UNIX group as defined
+in <literal>group</literal>(4). No support is present for group passwords.
+Groups defined with this action initially have no user list. Users can be
+added with the <literal>user</literal> action. The following attributes are
+recognized:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>groupname</literal></term>
+<listitem><para>The value for the name of the group.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>gid</literal></term>
+<listitem><para>The group's unique numerical id. The default value is the
+first free group under 100.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>User Actions</title>
+<para>The <literal>user</literal> action defines a UNIX user as defined in <filename>
+/etc/passwd</filename>, <filename>/etc/shadow</filename>, <filename>/etc/group</filename>,
+and <filename>/etc/ftpd/ftpusers</filename> files. Entries are added to the
+appropriate files for users defined with this <literal>user</literal> action.</para>
+<para>The <literal>user</literal> action is intended to define a user for
+a daemon or other software to use. Do not use the <literal>user</literal> action
+to define administrative or interactive accounts.</para>
+<para>The following attributes are recognized:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>username</literal></term>
+<listitem><para>The unique name of the user</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>password</literal></term>
+<listitem><para>The encrypted password of the user. Default value is <literal>*LK*
+</literal>. See <literal>shadow</literal>(4).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>uid</literal></term>
+<listitem><para>The unique uid of the user. Default value is first free value
+under 100.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal></term>
+<listitem><para>The name of the user's primary group. Must be found in <filename>
+/etc/group</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>gcos-field</literal></term>
+<listitem><para>The value of the <literal>gcos</literal> field in <filename>/etc/passwd
+</filename>. Default value is <literal>username</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>home-dir</literal></term>
+<listitem><para>The user's home directory. This directory must be in the system
+image directories and not under another mount point such as <filename>/home</filename>.
+Default value is <literal>/</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>login-shell</literal></term>
+<listitem><para>The user's default shell. Default value is empty.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group-list</literal></term>
+<listitem><para>Secondary groups to which the user belongs. See <literal>group</literal>(4).
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>ftpuser</literal></term>
+<listitem><para>Can be set to <literal>true</literal> or <literal>false</literal>.
+The default value of <literal>true</literal> indicates that the user is permitted
+to login via FTP. See <literal>ftpusers</literal>(4).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>lastchg</literal></term>
+<listitem><para>The number of days between January 1, 1970, and the date that
+the password was last modified. Default value is empty. See <literal>shadow</literal>(4).
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>min</literal></term>
+<listitem><para>The minimum number of days required between password changes.
+This field must be set to 0 or above to enable password aging. Default value
+is empty. See <literal>shadow</literal>(4).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>max</literal></term>
+<listitem><para>The maximum number of days the password is valid. Default
+value is empty. See <literal>shadow</literal>(4).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>warn</literal></term>
+<listitem><para>The number of days before password expires that the user is
+warned. See <literal>shadow</literal>(4).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>inactive</literal></term>
+<listitem><para>The number of days of inactivity allowed for that user. This
+is counted on a per-machine basis. The information about the last login is
+taken from the machine's <filename>lastlog</filename> file. See <literal>shadow</literal>(4).
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>expire</literal></term>
+<listitem><para>An absolute date expressed as the number of days since the
+UNIX Epoch (January 1, 1970). When this number is reached, the login can no
+longer be used. For example, an expire value of 13514 specifies a login expiration
+of January 1, 2007. See <literal>shadow</literal>(4).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>flag</literal></term>
+<listitem><para>Set to empty. See <literal>shadow</literal>(4).</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+<refsect1 role="other"><title>Actuators</title>
+<para>In certain contexts, additional operations can be appropriate to execute
+in preparation for or following the introduction of a particular action. These
+additional operations are operating system specific and are generally needed
+only on a live system image. A live image is the image mounted at <literal>/</literal> of
+the active, running boot environment of the current zone. When multiple actions
+involved in a package installation or removal have identical actuators, then
+the operation corresponding to actuator presence is executed once for that
+installation or removal.</para>
+<para>Incorrectly specified actuators can result in package installation failure
+if the actuator cannot determine a means of making safe installation progress.</para>
+<para>The following actuators are defined:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>reboot-needed</literal></term>
+<listitem><para>Can be set to <literal>true</literal> or <literal>false</literal>.
+This actuator declares that update or removal of the tagged action must be
+performed in a new boot environment if the package system is operating on
+a live image. Creation of a new boot environment is controlled by the <literal>be-policy
+</literal> image property. See the &ldquo;Image Properties&rdquo; section
+in the <literal>pkg</literal>(1) man page for more information about the <literal>
+be-policy</literal> property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>disable_fmri</literal>, <literal>refresh_fmri</literal>, <literal>
+restart_fmri</literal>, <literal>suspend_fmri</literal></term>
+<listitem><para>Each of these actuators takes the value of an FMRI of a service
+instance to operate on during the package installation or removal. <literal>disable_fmri
+</literal> causes the given FMRI to be disabled prior to action removal, per
+the <literal>disable</literal> subcommand to <literal>svcadm</literal>(1M). <literal>
+refresh_fmri</literal> and <literal>restart_fmri</literal> cause the given
+FMRI to be refreshed or restarted after action installation, update, or removal
+per the respective subcommands of <literal>svcadm</literal>(1M). Finally, <literal>
+suspend_fmri</literal> causes the given FMRI to be disabled temporarily prior
+to the action install phase, and then enabled after the completion of that
+phase.</para>
+<para>The value can contain a pattern that matches multiple service instances.
+However, it must do so explicitly with a glob as accepted by <literal>svcs</literal>(1),
+rather than doing so implicitly by not indicating any instances.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>Mediations</title>
+<para>A mediator is a name that represents a set of related symbolic or hard
+links. If two or more link actions have the same path and mediator name, the
+user or the package system selects the link target based on version, implementation,
+or priority. See &ldquo;Link Actions&rdquo; for information about mediator
+attributes.</para>
+<para>The following example shows two different instances of a mediator named <literal>
+java</literal> where the link choices are between versions. These two <literal>link
+</literal> actions would appear in two different packages.</para>
+<programlisting>link mediator=java mediator-version=1.6 path=usr/java target=jdk/jdk1.6.0_31
+link mediator=java mediator-version=1.7 path=usr/java target=jdk/jdk1.7.0_02</programlisting>
+<para>See the <command>set-mediator</command> subcommand in the <command>pkg</command>(1)
+man page for information about how to select the version you want for this
+link path. To have a choice of versions, both packages must be installed.</para>
+</refsect1>
+<refsect1 role="other"><title>Constraints and Freezing</title>
+<para>When a package is transitioned to a new version, or when it is added
+to or removed from the system, the version that is chosen, or whether removal
+is allowed, is determined by a variety of constraints put on the package.
+Those constraints can be defined by other packages in the form of dependencies,
+or by the administrator in the form of freezes.</para>
+<para>The most common form of constraint is delivered by the <literal>require</literal> dependency,
+as described in &ldquo;Depend Actions&rdquo; above. Such a constraint prevents
+the package from being downgraded or removed.</para>
+<para>Most parts of the operating system are encapsulated by packages called <emphasis>
+incorporations</emphasis>. These packages primarily deliver constraints represented
+by the <literal>incorporate</literal> dependency.</para>
+<para>As described above, an incorporated package need not be present on the
+system, but if it is, then it specifies both an inclusive minimum version
+and an exclusive maximum version. For example, if the dependent FMRI has a
+version of 1.4.3, then no version less than 1.4.3 would satisfy the dependency,
+and neither would any version greater than or equal to 1.4.4. However, versions
+that merely extended the dotted sequence, such as 1.4.3.7, would be allowed.</para>
+<para>Incorporations are used to force parts of the system to upgrade synchronously.
+For some components, such as the C library and the kernel, this is a basic
+requirement. For others, such as a simple userland component on which nothing
+else has a dependency, the synchronous upgrade is used merely to provide a
+known and tested set of package versions that can be referred to by a particular
+version of the incorporation.</para>
+<para>Since an incorporation is simply a package, it can be removed, and all
+the constraints it delivers are therefore relaxed. However, many of the incorporations
+delivered by Oracle Solaris are required by the packages they incorporate
+because that relaxation would not be safe.</para>
+<para>Attempting an upgrade of a package to a version that is not allowed
+by an installed incorporation will not attempt to find a newer version of
+the incorporation in order to satisfy the request, but will instead fail.
+If the constraint itself must be moved, and the incorporation specifying it
+cannot be removed, then the incorporation must be upgraded to a version that
+specifies a desired version of the constraint. Upgrading an incorporation
+causes all of the incorporated packages that would not satisfy the constraints
+delivered by the new version to be upgraded as well.</para>
+<para>A system administrator can constrain a package by using the
+<command>pkg freeze</command> command. The named package is constrained to the version
+installed on the system if no version is provided. If a versioned package
+is provided, then this administrative constraint, or freeze, acts as if an
+incorporate dependency were installed where the <literal>fmri</literal> attribute
+had the value of the provided package version.</para>
+<para>A freeze is never lifted automatically by the packaging system. To relax
+a constraint, use the <command>pkg unfreeze</command> command.</para>
+</refsect1>
+<refsect1 role="other"><title>Publishers and Repositories</title>
+<para>As detailed above, a publisher is simply a name that package clients
+use to identify the provider of packages. Publishers can distribute their
+packages using package repositories and/or package archives. There are two
+types of repositories currently supported by the package system: origin repositories
+and mirror repositories.</para>
+<para>An <emphasis>origin</emphasis> is a package repository that contains
+all of the metadata (such as catalogs, manifests, and search indexes) and
+content (files) for one or more packages. If multiple origins are configured
+for a given publisher in an image, the package client API attempts to choose
+the best origin to retrieve package data from. This is the most common type
+of repository, and is implicitly created whenever <command>pkgsend</command> or <command>
+pkgrecv</command> is used on a package repository.</para>
+<para>A <emphasis>mirror</emphasis> is a package repository that contains
+only package content (files). If one or more mirrors are configured for a
+given publisher in an image, the client API prefers the mirrors for package
+content retrieval and attempts to choose the best one to retrieve package
+content from. If the mirror is unreachable, does not have the required content,
+or is slower, the client API retrieves the content from any configured origin
+repositories. Mirrors are intended for content sharing among a trusted set
+of clients using the dynamic mirror functionality of <command>pkg.depotd</command>(1M).
+Mirrors are also intended to be used to authenticate access to package metadata,
+but distribute the package content without authentication. For example, a
+client might be configured with an <literal>https</literal> origin that requires
+an SSL key and certificate pair to access, and with an <literal>http</literal> mirror
+that provides the package content. In this way, only authorized clients can
+install or update the packages, while the overhead of authentication for package
+content retrieval is avoided. A mirror can be created by removing all subdirectories
+of a repository except those named <filename>file</filename> and their parents.
+An origin repository can be also be provisioned as a mirror by using the mirror
+mode of <command>pkg.depotd</command>(1M).</para>
+</refsect1>
+<refsect1 role="other"><title>Global and Non-Global Zone Update</title>
+<para>The <literal>pkg</literal> system forces non-global zones to be kept
+in sync with the global zone. This means that certain packages must be at
+the same version in the global zone and all non-global zones to ensure the
+same kernel is run. To do this, <literal>pkg</literal> uses <literal>parent</literal> dependencies
+to impose certain constraints on non-global zones. See &ldquo;Depend Actions&rdquo;
+above for more information about <literal>parent</literal> dependencies.</para>
+<para>Because of restrictions that the global zone imposes on non-global zones,
+the non-global zones must have access to the packages of the global zone and
+must have a similar publisher configuration. Both of these objectives are
+achieved by using a <emphasis role="strong">system repository</emphasis> (see
+the <literal>pkg.sysrepo</literal>(1M) man page). The system repository provides
+access to the publishers configured in the global zone and information about
+how those publishers are configured. To prevent non-global zones from choosing
+different packages during installation or update, system publishers are ranked
+higher in the publisher search order than publishers configured in the non-global
+zone. See the <command>pkg set-publisher</command> command in the <literal>pkg</literal>(1)
+man page for information about publisher search order.</para>
+<para>To update all non-global zones on the system, use the <command>pkg update</command> command
+with no arguments in the global zone. This command operates on the global
+zone and on each non-global zone recursively. The minimal changes necessary
+are made to non-global zones to bring them in sync with the changes made in
+the global zone. For example, suppose package <literal>foo</literal> is installed
+at version 1 in both the global zone and non-global zones, and suppose version
+2 is available in a system repository. If <literal>foo</literal> has a parent
+dependency, then <command>pkg update foo</command> updates <literal>foo</literal> to
+version 2 in both the global zone and the non-global zones because the <literal>parent
+</literal> dependency forces the package to stay in sync. If <literal>foo</literal> does
+not have a parent dependency, then <literal>foo</literal> is updated to version
+2 in the global zone but remains at version 1 in the non-global zones.</para>
+</refsect1>
+<refsect1 role="other"><title>Facets and Variants</title>
+<para>Software can have components that are optional and components that are
+mutually exclusive. Examples of optional components include locales and documentation.
+Examples of mutually exclusive components include SPARC or x86 and debug or
+non-debug binaries.</para>
+<para>In IPS, optional components are called <emphasis>facets</emphasis> and
+mutually exclusive components are called <emphasis>variants</emphasis>. Facets
+and variants are specified as tags on package actions. Each facet and variant
+tag has a name and a value. A single action can have multiple facet and variant
+tags. Examples of components with multiple facet and variant tags include
+an architecture-specific header file that is used by developers, or a component
+that is only for a SPARC global zone.</para>
+<para>An example of a variant tag is <literal>variant.arch=sparc</literal>.
+An example of a facet tag is <literal>facet.devel=true</literal>. Facets and
+variants are often referred to without the leading <literal>facet.</literal> and <literal>
+variant.</literal>.</para>
+<para>Facets and variants are special properties of the image and cannot be
+set on individual packages. To view the current values of the facets and variants
+set on the image, use the <command>pkg facet</command> and <command>pkg variant</command> commands
+as shown in the <command>pkg</command>(1) man page. To modify the values of
+the facets and variants set on the image, use the <command>pkg change-facet</command> and <command>
+pkg change-variant</command> commands.</para>
+<para>Facets are treated as boolean values by package clients: Facets can
+be set only to <literal>true</literal> (enabled) or <literal>false</literal> (disabled)
+in the image. By default, all facets starting with 'facet.debug.' or 'facet.optional.' are considered
+to be set to <literal>false</literal> in the image; all others are considered to be set to <literal>true</literal>
+in the image.</para>
+<para>Facets can be either set locally within an image using the <command>pkg change-facet</command> command or inherited from a parent image. For
+example, a non-global zone can inherit a facet from the global zone. Inherited facets are evaluated
+before, and take priority over, any locally set facets. If the same facet is both inherited and
+locally set, the inherited facet value masks the locally set value. Masked facets have no effect on facet evaluation and package actions. Facet changes made by using the
+<command>pkg change-facet</command> command only affect locally set facets. Inherited facets can only be changed by making the change in the parent image. By default, the <command>pkg facet</command> command does not display masked facets.</para>
+<para>The value of a facet tag on an action can be set to <literal>all</literal> or
+<literal>true</literal> to control how clients filter faceted actions. All values other than
+<literal>all</literal> or <literal>true</literal> have undefined behavior. See below for a
+description of the conditions that must exist in the image to install an action that has facet
+tags.</para>
+<para>The <literal>all</literal> value for a facet is useful when more than
+a single level of filtering is required. In the following example, <literal>foo.txt
+</literal> is installed only if the <literal>doc</literal> facet and at least
+one of the <literal>locale</literal> facets is <literal>true</literal> in
+the image. This enables administrators to exclude documentation, but still
+enable or disable support for specific locales. In addition, <literal>api.txt</literal> is
+only installed if both the <literal>doc</literal> and <literal>devel</literal> facets
+are <literal>true</literal> in the image.</para>
+<programlisting>file path=usr/share/doc/foo/foo.txt facet.doc=all facet.locale.en_GB=true facet.locale.en_US=true
+file path=usr/share/doc/foo/api.txt facet.doc=all facet.devel=all</programlisting>
+<para>A facet set on the image can be a full facet such as <literal>doc.man</literal> or
+a pattern such as <literal>locale.*</literal>. This is useful when you want
+to disable a portion of the facet namespace, and only enable individual facets
+within it. For example, you could disable all locales and then only enable
+one or two specific locales, as shown in the following example:</para>
+<screen># <userinput>pkg change-facet locale.*=false</userinput>
 [output about packages being updated]
-# \fBpkg change-facet locale.en_US=true\fR
-[output about packages being updated]
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Most variants can have any number of values. For example, the \fBarch\fR variant can be set to \fBi386\fR, \fBsparc\fR, \fBppc\fR, \fBarm\fR, or whatever architectures the distribution supports. (Only \fBi386\fR and \fBsparc\fR are used in Oracle Solaris.) The exception are the \fBdebug\fR variants. The \fBdebug\fR variants can only be set to \fBtrue\fR or \fBfalse\fR; other values have undefined behavior. If a file action has both non-debug and debug versions, both versions must have the applicable \fBdebug\fR variant explicitly set, as shown in the following example:
-.sp
-.in +2
-.nf
-file group=sys mode=0644 overlay=allow owner=root \e
-  path=etc/motd pkg.csize=115 pkg.size=103 preserve=true \e
+# <userinput>pkg change-facet locale.en_US=true</userinput>
+[output about packages being updated]</screen>
+<para>Most variants can have any number of values. For example, the
+<literal>arch</literal> variant can be set to <literal>i386</literal>,
+<literal>sparc</literal>, <literal>ppc</literal>, <literal>arm</literal>, or
+whatever architectures the distribution
+supports. (Only <literal>i386</literal> and <literal>sparc</literal> are used
+in Oracle Solaris.) The exception are the <literal>debug</literal> variants.
+The <literal>debug</literal> variants can only be set to <literal>true</literal>
+or <literal>false</literal>; other values have undefined behavior. If a file
+action has both non-debug and debug versions, both versions must have the
+applicable <literal>debug</literal> variant explicitly set, as shown in the
+following example:</para>
+<programlisting>file group=sys mode=0644 overlay=allow owner=root &bsol;
+  path=etc/motd pkg.csize=115 pkg.size=103 preserve=true &bsol;
   variant.debug.osnet=true
 
-file group=sys mode=0644 overlay=allow owner=root \e
-  path=etc/motd pkg.csize=68 pkg.size=48 preserve=true \e
-  variant.debug.osnet=false
-.fi
-.in -2
-
-.sp
-.LP
-The variant value must be set on the image in order for a package using the variant to be installed. The \fBarch\fR and \fBzone\fR variants are set by the program that creates the image and installs its initial contents. The \fBdebug.*\fR variants are \fBfalse\fR in the image by default.
-.sp
-.LP
-The facets and variants set on the image affect whether a particular action is installed.
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Actions with no facet or variant tags are always installed.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Actions with facet tags are installed if the following conditions exist in the image:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-All facet tags on the action that have a value of \fBall\fR are \fBtrue\fR in the image (\fBfalse\fR is the default for all facets starting with 'facet.debug.' or 'facet.optional.'; \fBtrue\fR is the default for all others).
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-If any facet tags on the action have a value of \fBtrue\fR, at least one of those facets is \fBtrue\fR in the image.
-.RE
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Actions with variant tags are installed only if the values of all the variant tags are the same as the values set in the image.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Actions with both facet and variant tags are installed if both the facets and the variants allow the action to be installed.
-.RE
-.sp
-.LP
-You can create custom facet tags and \fBvariant.debug.*\fR variant tags. See \fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR for more information. The following tags are in common use in Oracle Solaris.
-.sp
-
-.sp
-.TS
-tab();
-cw(2.75i) cw(2.75i) 
-lw(2.75i) lw(2.75i) 
-.
-Variant NamePossible Values
-_
-\fBvariant.arch\fR\fBsparc\fR, \fBi386\fR
-\fBvariant.opensolaris.zone\fR\fBglobal\fR, \fBnonglobal\fR
-\fBvariant.debug.*\fR\fBtrue\fR, \fBfalse\fR
-.TE
-
-.sp
-.LP
-The following list shows a small sample of the facet tags that are used in Oracle Solaris:
-.sp
-.in +2
-.nf
-facet.devel             facet.doc
+file group=sys mode=0644 overlay=allow owner=root &bsol;
+  path=etc/motd pkg.csize=68 pkg.size=48 preserve=true &bsol;
+  variant.debug.osnet=false</programlisting>
+<para>The variant value must be set on the image in order for a package using
+the variant to be installed. The <literal>arch</literal> and
+<literal>zone</literal> variants are set by the program that creates the image
+and installs its initial contents. The <literal>debug.*</literal> variants are
+<literal>false</literal> in the image by default.</para>
+<itemizedlist>
+<para>The facets and variants set on the image affect whether a particular
+action is installed.</para>
+<listitem><para>Actions with no facet or variant tags are always installed.</para>
+</listitem>
+<listitem><para>Actions with facet tags are installed if the following
+conditions exist in the image:</para>
+<itemizedlist>
+<listitem><para>All facet tags on the action that have a value of
+<literal>all</literal> are <literal>true</literal> in the image
+(<literal>false</literal> is the default for all facets starting with 'facet.debug.'
+or 'facet.optional.'; <literal>true</literal> is the default for all others).</para>
+</listitem>
+<listitem><para>If any facet tags on the action have a value of
+<literal>true</literal>, at least one of those facets is <literal>true</literal>
+in the image.</para>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem><para>Actions with variant tags are installed only if the values
+of all the variant tags are the same as the values set in the image.</para>
+</listitem>
+<listitem><para>Actions with both facet and variant tags are installed if
+both the facets and the variants allow the action to be installed.</para>
+</listitem>
+</itemizedlist>
+<para>You can create custom facet tags and <literal>variant.debug.*</literal>
+variant tags. See
+<citetitle>Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle>
+for more information. The following tags are in common use in Oracle
+Solaris.</para>
+<informaltable frame="topbot">
+<textobject><simpara>Variants and their possible values.</simpara></textobject>
+<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="50*"/><colspec
+colwidth="50*"/><thead>
+<row rowsep="1">
+<entry>
+<para>Variant Name</para>
+</entry>
+<entry>
+<para>Possible Values</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry>
+<para><literal>variant.arch</literal></para>
+</entry>
+<entry>
+<para><literal>sparc</literal>, <literal>i386</literal></para>
+</entry>
+</row>
+<row>
+<entry>
+<para><literal>variant.opensolaris.zone</literal></para>
+</entry>
+<entry>
+<para><literal>global</literal>, <literal>nonglobal</literal></para>
+</entry>
+</row>
+<row>
+<entry>
+<para><literal>variant.debug.*</literal></para>
+</entry>
+<entry>
+<para><literal>true</literal>, <literal>false</literal></para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<para>The following list shows a small sample of the facet tags that are used
+in Oracle Solaris:</para>
+<programlisting>facet.devel             facet.doc
 facet.doc.html          facet.doc.info
 facet.doc.man           facet.doc.pdf
 facet.locale.de         facet.locale.en_GB
 facet.locale.en_US      facet.locale.fr
-facet.locale.ja_JP      facet.locale.zh_CN
-.fi
-.in -2
-
-.SH IMAGE POLICIES
-.sp
-.LP
-Image policies are defined by image properties with boolean values. See "Image Properties" in the \fBpkg\fR(1) man page for descriptions of the \fBflush-content-cache-on-success\fR and \fBsend-uuid\fR properties and information about how to view and modify their values.
-.SH FILES
-.sp
-.LP
-Since \fBpkg\fR(5) images can be located arbitrarily within a larger file system, the token \fB$IMAGE_ROOT\fR is used to distinguish relative paths. For a typical system installation, \fB$IMAGE_ROOT\fR is equivalent to /.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-Metadata directory for a full or partial image.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-Metadata directory for a user image.
-.RE
-
-.sp
-.LP
-Within the metadata of a particular image, certain files and directories can contain information useful during repair and recovery. The token \fB$IMAGE_META\fR is used to refer to the top-level directory that contains the metadata. \fB$IMAGE_META\fR is typically one of the two paths given above.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/lost+found\fR\fR
-.ad
-.sp .6
-.RS 4n
-Location of conflicting directories and files moved during a package operation.
-.RE
+facet.locale.ja_JP      facet.locale.zh_CN</programlisting>
+</refsect1>
+<refsect1 role="other"><title>Image Policies</title>
+<para>Image policies are defined by image properties with boolean values.
+See &ldquo;Image Properties&rdquo; in the <literal>pkg</literal>(1) man page
+for descriptions of the <literal>flush-content-cache-on-success</literal> and <literal>
+send-uuid</literal> properties and information about how to view and modify
+their values.</para>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para>Since <literal>pkg</literal>(5) images can be located arbitrarily within
+a larger file system, the token <literal>$IMAGE_ROOT</literal> is used to
+distinguish relative paths. For a typical system installation, <literal>$IMAGE_ROOT
+</literal> is equivalent to /.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>Metadata directory for a full or partial image.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>Metadata directory for a user image.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Within the metadata of a particular image, certain files and directories
+can contain information useful during repair and recovery. The token <literal>$IMAGE_META
+</literal> is used to refer to the top-level directory that contains the metadata. <literal>
+$IMAGE_META</literal> is typically one of the two paths given above.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_META/lost+found</filename></term>
+<listitem><para>Location of conflicting directories and files moved during
+a package operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/publisher</filename></term>
+<listitem><para>Contains a directory for each publisher. Each directory stores
+publisher-specific metadata.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Other paths within the <literal>$IMAGE_META</literal> directory hierarchy
+are Private, and are subject to change.</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg.sysrepo-1m"><citerefentry><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="svcs-1"><citerefentry><refentrytitle>svcs</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="svcadm-1m"><citerefentry><refentrytitle>svcadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="AUOSS"><citetitle remap="book">Adding and Updating Software in Oracle Solaris 11.3</citetitle></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><olink targetdoc="PKDEV"><citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Contains a directory for each publisher. Each directory stores publisher-specific metadata.
-.RE
-
-.sp
-.LP
-Other paths within the \fB$IMAGE_META\fR directory hierarchy are Private, and are subject to change.
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(1), \fBpkgsend\fR(1), \fBpkg.depotd\fR(1M), \fBpkg.sysrepo\fR(1M), \fBsvcs\fR(1), \fBsvcadm\fR(1M)
-.sp
-.LP
-\fIAdding and Updating Software in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fICopying and Creating Package Repositories in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkg.depot-config.1m	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkg.depot-config.1m	Wed Jul 01 10:45:55 2015 -0700
@@ -1,363 +1,305 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkg.depot-config 1M "02 Oct 2013" "SunOS 5.11" "System Administration Commands"
-.SH NAME
-pkg.depot-config \- Image Packaging System HTTP depot configuration generator
-.SH SYNOPSIS
-.LP
-.nf
-/usr/lib/pkg.depot-config ( -d \fIrepository_dir\fR | -S )
-    -r \fIruntime_dir\fR [-c \fIcache_dir\fR] [-s \fIcache_size\fR] [-p \fIport\fR]
-    [-h \fIhostname\fR] [-l \fIlogs_dir\fR] [-T \fItemplate_dir\fR]
-    [-A] [-t \fIserver_type\fR] ( ([-F] [-P \fIserver_prefix\fR] ) | [--https
-    ( ( --cert \fIserver_cert_file\fR --key \fIserver_key_file\fR
-    [--cert-chain \fIssl_cert_chain_file\fR] ) |
-    --cert-key-dir \fIcert_key_directory\fR )
-    [ (--ca-cert \fIca_cert_file\fR --ca-key \fIca_key_file\fR ) ]
-    [--smf-fmri \fIsmf_pkg_depot_fmri\fR] ] )
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkg.depot-config\fR generates the configuration files for the Image Packaging System (IPS) depot. The IPS depot provides scalable read-only access to IPS package repositories over HTTP.
-.sp
-.LP
-The IPS depot is configured using the \fBsvc:/application/pkg/depot\fR Service Management Facility (SMF) service in conjunction with one or more instances of the \fBsvc:/application/pkg/server\fR service.
-.sp
-.LP
-\fBpkg.depot-config\fR generates a configuration for use by the \fBpkg/depot\fR service, or the \fBpkg.depot-config\fR command can be invoked on the command line to generate a standalone configuration.
-.sp
-.LP
-To change depot configuration, modify the properties of the \fBpkg/depot\fR service or the appropriate \fBpkg/server\fR service instance and refresh the instance. Modifying \fBpkg/server\fR service instance states can cause the \fBpkg/depot\fR service to be refreshed and the depot configuration files to be regenerated.
-.sp
-.LP
-To serve multiple repositories, you need a separate \fBpkg/server\fR service instance for each repository but only one \fBpkg/depot\fR service instance. Each instance of the \fBpkg/server\fR service maps to an IPS repository specified by the \fBpkg/inst_root\fR service property. The  \fBpkg/server\fR service does one of the following:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Runs an associated \fBpkg.depotd\fR process to serve the content of the repository.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Runs no processes and instead helps to configure the \fBpkg.depot\fR service.
-.RE
-.sp
-.LP
-Each repository is supported by a \fBpkg/server\fR service instance. A repository might also be supported by the \fBpkg/depot:default\fR service. If the \fBpkg/standalone\fR property of a particular \fBpkg/server\fR instance is set to \fBtrue\fR, then the repository is served by the \fBpkg.depotd\fR process. If the \fBpkg/standalone\fR property of a particular \fBpkg/server\fR instance is set to \fBfalse\fR, then the repository is served by the \fBpkg/depot:default\fR service. Each \fBpkg/server\fR instance either runs \fBpkg.depotd\fR or contributes configuration information to \fBpkg/depot:default\fR.
-.sp
-.LP
-When you enable a \fBpkg/server\fR instance for which the \fBpkg/standalone\fR property set to \fBfalse\fR and the \fBpkg/readonly\fR property set to \fBtrue\fR, the \fBpkg/depot:default\fR configuration is refreshed, and that repository is served by the \fBpkg/depot:default\fR service. When you disable that same \fBpkg/server\fR instance, the \fBpkg/depot:default\fR service is refreshed, and that repository is no longer served by the \fBpkg/depot:default\fR service.
-.sp
-.LP
-You can configure the depot manually by using the \fBpkg.depot-config\fR command with the \fB-F\fR option. The \fB-F\fR option produces a web server configuration file that can be added to an existing web server. In this case, the depot runs with reduced functionality: \fBpkg\fR(1) search support and the depot browser user interface are not available. All other \fBpkg\fR(1) functionality required to install and update Oracle Solaris 11 systems is available.
-.sp
-.LP
-Use one of the following methods to pass repository paths and configuration to the depot server:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Use the \fBpkg.depot-config\fR command with the \fB-S\fR option. The \fB-S\fR option causes \fBpkg.depotd\fR to query the system for all instances of the \fBpkg/server\fR service that are marked as \fBonline\fR and have the \fBpkg/standalone\fR property set to \fBfalse\fR and the \fBpkg/readonly\fR property set to \fBtrue\fR.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Use the \fBpkg.depot-config\fR command with the \fB-d\fR option. The \fB-d\fR option provides a path to the \fBpkg\fR(5) repository to use. Multiple \fB-d\fR options are accepted.
-.RE
-.sp
-.LP
-Repositories must have file permissions that permit the files and directories in the repositories to be read by the \fBpkg5srv\fR user.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIprefix\fR=\fIrepository_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the path to a \fBpkg\fR(5) file repository to use. The \fIprefix\fR is used as a prefix into the \fBdepot-config\fR web server namespace where this repository can be accessed. The \fIrepository_dir\fR is a directory that contains a version 4 \fBpkg\fR(5) file repository, which is included in the depot server configuration. The \fB-d\fR option cannot be used with the \fB-S\fR option. At least one \fB-d\fR option is required if the \fB-S\fR option is not used. Multiple \fB-d\fR options are allowed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-S\fR\fR
-.ad
-.sp .6
-.RS 4n
-Query the system for repositories to use. The \fB-S\fR option causes \fBpkg.depotd\fR to query the system for all instances of the \fBpkg/server\fR service that are marked as \fBonline\fR and have the \fBpkg/standalone\fR property set to \fBfalse\fR and the \fBpkg/readonly\fR property set to \fBtrue\fR. These property values allow the depot to run concurrently with \fBpkg/server\fR instances that do not have these properties set. See the \fBpkg.depotd\fR(1M) man page for information about \fBpkg.depotd\fR. The \fB-S\fR option cannot be used with the \fB-d\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR \fIruntime_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the default output directory for configuration files. This directory can also be specified by setting the \fBconfig/runtime_dir\fR property in the \fBpkg/server\fR service. When the \fBconfig/runtime_dir\fR property is used, the contents of this directory are recreated during service startup.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the directory where the depot stores its cache. If the \fB-A\fR option is also used, the cache directory is also used to store server-side \fBpkg\fR(5) search indexes. This directory can also be specified by setting the \fBconfig/cache_dir\fR property in the \fBpkg/server\fR service.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIcache_size\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the maximum cache size for the depot. The \fIcache_size\fR value is an integer number of megabytes. If \fIcache_size\fR is 0, no caching is performed by the web server. The default value of \fIcache_size\fR is 0. If all file repositories served by the depot server are local to the depot server (not accessed over NFS), the default value of 0 is sufficient. This cache size can also be specified by setting the \fBconfig/cache_max\fR property in the \fBpkg/server\fR service.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIport\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the port number that the depot will listen to. The default value of \fIport\fR is 80. This port can also be specified by setting the \fBconfig/port\fR property in the \fBpkg/server\fR service.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR \fIhostname\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the host name to use as the argument to the Apache \fBServerName\fR directive. The default value of \fIhostname\fR is \fB0.0.0.0\fR. This host name can also be specified by setting the \fBconfig/host\fR property in the \fBpkg/server\fR service.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR \fIlogs_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the directory where the depot stores log files. The default value of \fIlogs_dir\fR is \fB/var/log/pkg/depot\fR. This directory can also be specified by setting the \fBconfig/log_dir\fR property in the \fBpkg/server\fR service.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-T\fR \fItemplate_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the directory where the depot builds the depot configuration and stores additional files needed to the run the depot. The default value of \fItemplate_dir\fR is \fB/etc/pkg/depot\fR. This directory can also be specified by setting the \fBconfig/template_dir\fR property in the \fBpkg/server\fR service. This directory should not need to be changed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-A\fR \fR
-.ad
-.sp .6
-.RS 4n
-Refresh any search indices maintained by the depot when \fBpkgrepo refresh\fR is invoked. By default, search indices maintained by the depot are not refreshed when \fBpkgrepo refresh\fR is invoked. This option can also be specified by setting the \fBconfig/allow_refresh\fR property in the \fBpkg/server\fR service. Best practice is to not use the \fB-A\fR option or the \fBconfig/allow_refresh\fR property to refresh the index on production servers because the search index is refreshed automatically when the depot starts.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIserver_type\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the type of web server that \fBpkg.depot-config\fR should output configuration information for. In this release, the value \fBapache2\fR is both the default value and the only accepted value for \fIserver_type\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fR
-.ad
-.sp .6
-.RS 4n
-Produce a partial configuration that enables a web server to serve basic \fBpkg\fR(5) installation operations for clients using an existing web service. For an Apache web server running on the Oracle Solaris OS, the partial configuration file could be placed in \fB/etc/apache2/2.2/conf.d\fR. For other operating systems, consult your OS documentation to determine how to use this partial configuration file. See also the \fB-P\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR \fIserver_prefix\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the prefix used to map the depot into the web server namespace. The \fB-P\fR option is intended to be used with the \fB-F\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--https\fR
-.ad
-.sp .6
-.RS 4n
-Enable the HTTPS service. This option cannot be used with the \fB-F\fR or \fB-P\fR options.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cert\fR \fIserver_cert_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the location of the server certificate file. This option can only be used with the \fB--https\fR option. Either both the \fB--cert\fR and \fB--key\fR options or the \fB--cert-key-dir\fR option must be used with the \fB--https\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIserver_key_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the location of the server key file. This option can only be used with the \fB--https\fR option. Either both the \fB--cert\fR and \fB--key\fR options or the \fB--cert-key-dir\fR option must be used with the \fB--https\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cert-key-dir\fR \fIcert_key_directory\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the directory where the automatically generated certificates and keys should be stored if options \fB--cert\fR and \fB--key\fR are omitted. This option can only be used with the \fB--https\fR option. Either both the \fB--cert\fR and \fB--key\fR options or the \fB--cert-key-dir\fR option must be used with the \fB--https\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ca-cert\fR \fIssl_ca_cert_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the location of the top CA certificate file. This option can only be used with the \fB--https\fR option and must be used with \fB--ca-key\fR option together. The option is only used for automatically generating the server certificate based on this CA certificate and the key specified by \fB--ca-key\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ca-key\fR \fIssl_ca_key_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the location of the top CA key file. This option can only be used with the \fB--https\fR option and must be used with \fB--ca-cert\fR option together. The option is only used for automatically generating the server certificate based on this key and the CA certificate specified by \fB--ca-cert\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cert-chain\fR \fIssl_cert_chain_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-This option can only be used with the \fB--https\fR option. This option is required if the server certificate is not signed by the top level CA directly but is signed by an intermediate authority.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--smf-fmri\fR \fIsmf_pkg_depot_fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the FMRI of the pkg/depot service instance. This option is used to update the corresponding SMF properties of that instance if any certificates or keys are automatically generated for that instance. This option can only be used with the \fB--https\fR option.
-.RE
-
-.SH PROVIDING ADDITIONAL SERVER CONFIGURATION
-.sp
-.LP
-When the \fB-F\fR option is not used, and the default \fB-t apache2\fR is set, the \fBsvc:/application/pkg/depot\fR service looks in \fB/etc/pkg/depot/conf.d\fR at startup for additional Apache configuration files that can be used to extend the server configuration. Consult the Apache web server documentation for details on the directives that are used to configure the web server.
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRShowing How a Repository Is Served
-.sp
-.LP
-The system in this example is running multiple instances of \fBsvc:/application/pkg/server\fR and a single instance of \fBsvc:/application/pkg/depot\fR. The \fBpkg/server:standalone\fR instance has an associated \fBpkg.depotd\fR process. The \fBpkg.depotd\fR process serves the repository configured in the \fBpkg/server:standalone\fR service. The \fBpkg/server:userland\fR instance has no associated processes. The \fBpkg/depot:default\fR service serves the repository configured in the \fBpkg/server:userland\fR service.
-
-.sp
-.in +2
-.nf
-$ \fBsvcs pkg/server\fR
+<refentry id="pkg.depot-config-1m">
+<refmeta><refentrytitle>pkg.depot-config</refentrytitle><manvolnum>1M</manvolnum>
+<refmiscinfo class="date">31 Mar 2014</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1m;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2014, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg.depot-config</refname><refpurpose>Image Packaging System HTTP depot configuration generator</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/lib/pkg.depot-config ( -d <replaceable>repository_dir</replaceable> | -S )
+    -r <replaceable>runtime_dir</replaceable> [-c <replaceable>cache_dir</replaceable>] [-s <replaceable>cache_size</replaceable>] [-p <replaceable>port</replaceable>]
+    [-h <replaceable>hostname</replaceable>] [-l <replaceable>logs_dir</replaceable>] [-T <replaceable>template_dir</replaceable>]
+    [-A] [-t <replaceable>server_type</replaceable>] ( ([-F] [-P <replaceable>server_prefix</replaceable>] ) |
+    [--https ( (--cert <replaceable>server_cert_file</replaceable> --key <replaceable>server_key_file</replaceable>
+    [--cert-chain <replaceable>ssl_cert_chain_file</replaceable>] ) |
+    --cert-key-dir <replaceable>cert_key_directory</replaceable> )
+    [ (--ca-cert <replaceable>ca_cert_file</replaceable> --ca-key <replaceable>ca_key_file</replaceable> ) ]
+    [--smf-fmri <replaceable>smf_pkg_depot_fmri</replaceable>] ] )</synopsis>
+</refsynopsisdiv>
+<refsect1 id="GLHAR" role="description"><title></title>
+<para><command>pkg.depot-config</command> generates the configuration files
+for the Image Packaging System (IPS) depot. The IPS depot provides scalable
+read-only access to IPS package repositories over HTTP.</para>
+<para>The IPS depot is configured using the <literal>svc:/application/pkg/depot</literal> Service
+Management Facility (SMF) service in conjunction with one or more instances
+of the <literal>svc:/application/pkg/server</literal> service.</para>
+<para><command>pkg.depot-config</command> generates a configuration for use
+by the <literal>pkg/depot</literal> service, or the <command>pkg.depot-config</command> command
+can be invoked on the command line to generate a standalone configuration.</para>
+<para>To change depot configuration, modify the properties of the <literal>pkg/depot
+</literal> service or the appropriate <literal>pkg/server</literal> service
+instance and refresh the instance. Modifying <literal>pkg/server</literal> service
+instance states can cause the <literal>pkg/depot</literal> service to be refreshed
+and the depot configuration files to be regenerated.</para>
+<para>To serve multiple repositories, you need a separate
+<literal>pkg/server</literal> service instance for each repository but only one
+<literal>pkg/depot</literal> service instance. Each instance of the
+<literal>pkg/server</literal> service maps to an IPS repository specified by
+the <literal>pkg/inst_root</literal> service property. The 
+<literal>pkg/server</literal> service does one of the following:</para>
+<itemizedlist>
+<listitem><para>Runs an associated <literal>pkg.depotd</literal> process to
+serve the content of the repository.</para></listitem>
+<listitem><para>Runs no processes and instead helps to configure the
+<literal>pkg.depot</literal> service.</para>
+</listitem>
+</itemizedlist>
+<para>Each repository is supported by a <literal>pkg/server</literal> service
+instance. A repository might also be supported by the
+<literal>pkg/depot:default</literal> service. If the
+<literal>pkg/standalone</literal> property of a particular
+<literal>pkg/server</literal> instance is set to <literal>true</literal>, then
+the repository is served by the <literal>pkg.depotd</literal> process. If the
+<literal>pkg/standalone</literal> property of a particular
+<literal>pkg/server</literal> instance is set to <literal>false</literal>, then
+the repository is served by the <literal>pkg/depot:default</literal> service.
+Each <literal>pkg/server</literal> instance either runs
+<literal>pkg.depotd</literal> or contributes configuration information to
+<literal>pkg/depot:default</literal>.</para>
+<para>When you enable a <literal>pkg/server</literal> instance for which the
+<literal>pkg/standalone</literal> property set to <literal>false</literal> and
+the <literal>pkg/readonly</literal> property set to <literal>true</literal>,
+the <literal>pkg/depot:default</literal> configuration is refreshed, and that
+repository is served by the <literal>pkg/depot:default</literal> service. When
+you disable that same <literal>pkg/server</literal> instance, the
+<literal>pkg/depot:default</literal> service is refreshed, and that repository
+is no longer served by the <literal>pkg/depot:default</literal> service.</para>
+<para>You can configure the depot manually by using the
+<command>pkg.depot-config</command> command with the <option>F</option> option.
+The <option>F</option> option
+produces a web server configuration file that can be added to an existing
+web server. In this case, the depot runs with reduced functionality: <literal>pkg
+</literal>(1) search support and the depot browser user interface are not
+available. All other <literal>pkg</literal>(1) functionality required to install
+and update Oracle Solaris 11 systems is available.</para>
+<itemizedlist>
+<para>Use one of the following methods to pass repository paths and configuration
+to the depot server:</para>
+<listitem><para>Use the <command>pkg.depot-config</command> command with the <option>
+S</option> option. The <option>S</option> option causes <literal>pkg.depotd</literal> to
+query the system for all instances of the <literal>pkg/server</literal> service
+that are marked as <literal>online</literal> and have the <literal>pkg/standalone
+</literal> property set to <literal>false</literal> and the <literal>pkg/readonly
+</literal> property set to <literal>true</literal>.</para></listitem>
+<listitem><para>Use the <command>pkg.depot-config</command> command with the <option>
+d</option> option. The <option>d</option> option provides a path to the <literal>
+pkg</literal>(5) repository to use. Multiple <option>d</option> options are
+accepted.</para></listitem>
+</itemizedlist>
+<para>Repositories must have file permissions that permit the files and directories
+in the repositories to be read by the <literal>pkg5srv</literal> user.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>d</option> <replaceable>prefix</replaceable>=<replaceable>
+repository_dir</replaceable></term>
+<listitem><para>Specify the path to a <literal>pkg</literal>(5) file repository
+to use. The <replaceable>prefix</replaceable> is used as a prefix into the <literal>
+depot-config</literal> web server namespace where this repository can be accessed.
+The <replaceable>repository_dir</replaceable> is a directory that contains
+a version 4 <literal>pkg</literal>(5) file repository, which is included in
+the depot server configuration. The <option>d</option> option cannot be used
+with the <option>S</option> option. At least one <option>d</option> option
+is required if the <option>S</option> option is not used. Multiple <option>d</option> options
+are allowed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>S</option></term>
+<listitem><para>Query the system for repositories to use. The <option>S</option>
+option causes <literal>pkg.depotd</literal> to query the system for all
+instances of the <literal>pkg/server</literal> service that are marked as
+<literal>online</literal> and have the <literal>pkg/standalone</literal>
+property set to <literal>false</literal> and the <literal>pkg/readonly</literal>
+property set to <literal>true</literal>. These property values allow the depot
+to run concurrently with <literal>pkg/server</literal> instances that do not
+have these properties set. See the <literal>pkg.depotd</literal>(1M) man page
+for information about <literal>pkg.depotd</literal>. The <option>S</option>
+option cannot be used with the <option>d</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option> <replaceable>runtime_dir</replaceable></term>
+<listitem><para>Specify the default output directory for configuration files.
+This directory can also be specified by setting the <literal>config/runtime_dir</literal> property
+in the <literal>pkg/server</literal> service. When the <literal>config/runtime_dir
+</literal> property is used, the contents of this directory are recreated
+during service startup.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>Specify the directory where the depot stores its cache. If
+the <option>A</option> option is also used, the cache directory is also used
+to store server-side <literal>pkg</literal>(5) search indexes. This directory
+can also be specified by setting the <literal>config/cache_dir</literal> property
+in the <literal>pkg/server</literal> service.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>cache_size</replaceable></term>
+<listitem><para>Specify the maximum cache size for the depot. The <replaceable>cache_size
+</replaceable> value is an integer number of megabytes. If <replaceable>cache_size
+</replaceable> is 0, no caching is performed by the web server. The default
+value of <replaceable>cache_size</replaceable> is 0. If all file repositories
+served by the depot server are local to the depot server (not accessed over
+NFS), the default value of 0 is sufficient. This cache size can also be specified
+by setting the <literal>config/cache_max</literal> property in the <literal>pkg/server
+</literal> service.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
+<listitem><para>Specify the port number that the depot will listen to. The
+default value of <replaceable>port</replaceable> is 80. This port can also
+be specified by setting the <literal>config/port</literal> property in the <literal>
+pkg/server</literal> service.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>h</option> <replaceable>hostname</replaceable></term>
+<listitem><para>Specify the host name to use as the argument to the Apache <literal>
+ServerName</literal> directive. The default value of <replaceable>hostname</replaceable> is <literal>
+0.0.0.0</literal>. This host name can also be specified by setting the <literal>config/host
+</literal> property in the <literal>pkg/server</literal> service.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option> <replaceable>logs_dir</replaceable></term>
+<listitem><para>Specify the directory where the depot stores log files. The
+default value of <replaceable>logs_dir</replaceable> is <filename>/var/log/pkg/depot
+</filename>. This directory can also be specified by setting the <literal>config/log_dir
+</literal> property in the <literal>pkg/server</literal> service.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>T</option> <replaceable>template_dir</replaceable></term>
+<listitem><para>Specify the directory where the depot builds the depot configuration
+and stores additional files needed to the run the depot. The default value
+of <replaceable>template_dir</replaceable> is <filename>/etc/pkg/depot</filename>.
+This directory can also be specified by setting the <literal>config/template_dir</literal> property
+in the <literal>pkg/server</literal> service. This directory should not need
+to be changed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>A</option> </term>
+<listitem><para>Refresh any search indices maintained by the depot when <command>
+pkgrepo refresh</command> is invoked. By default, search indices maintained
+by the depot are not refreshed when <command>pkgrepo refresh</command> is
+invoked. This option can also be specified by setting the <literal>config/allow_refresh
+</literal> property in the <literal>pkg/server</literal> service. Best practice
+is to not use the <option>A</option> option or the <literal>config/allow_refresh</literal> property
+to refresh the index on production servers because the search index is refreshed
+automatically when the depot starts.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>server_type</replaceable></term>
+<listitem><para>Specify the type of web server that <command>pkg.depot-config</command> should
+output configuration information for. In this release, the value <literal>apache2
+</literal> is both the default value and the only accepted value for <replaceable>
+server_type</replaceable>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>F</option></term>
+<listitem><para>Produce a partial configuration that enables a web server
+to serve basic <literal>pkg</literal>(5) installation operations for clients
+using an existing web service. For an Apache web server running on the Oracle
+Solaris OS, the partial configuration file could be placed in <filename>/etc/apache2/2.2/conf.d
+</filename>. For other operating systems, consult your OS documentation to
+determine how to use this partial configuration file. See also the <option>P</option> option.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option> <replaceable>server_prefix</replaceable></term>
+<listitem><para>Specify the prefix used to map the depot into the web server namespace. The <option>P</option> option is intended to be used with the <option>F</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-https</option></term>
+<listitem><para>Enable the HTTPS service. This option cannot be used with the
+<option>F</option> or <option>P</option> options.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-cert</option> <replaceable>server_cert_file</replaceable></term>
+<listitem><para>Specify the location of the server certificate file. This option can only be used with the <option>-https</option> option. Either both the <option>-cert</option> and <option>-key</option> options or the <option>-cert-key-dir</option> option must be used with the <option>-https</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>server_key_file</replaceable></term>
+<listitem><para>Specify the location of the server key file. This option can only be used with the <option>-https</option> option. Either both the <option>-cert</option> and <option>-key</option> options or the <option>-cert-key-dir</option> option must be used with the <option>-https</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-cert-key-dir</option> <replaceable>cert_key_directory</replaceable></term>
+<listitem><para>Specify the directory where the automatically generated certificates and keys should be stored if the <option>-cert</option> and <option>-key</option> options are omitted. This option can only be used with the <option>-https</option> option. Either both the <option>-cert</option> and <option>-key</option> options or the <option>-cert-key-dir</option> option must be used with the <option>-https</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ca-cert</option> <replaceable>ssl_ca_cert_file</replaceable></term>
+<listitem><para>Specify the location of the top CA certificate file. This option can only be used with the <option>-https</option> option and must be used together with the <option>-ca-key</option> option. This option is only used for automatically generating the server certificate based on this CA certificate and the CA key specified by the <option>-ca-key</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ca-key</option> <replaceable>ssl_ca_key_file</replaceable></term>
+<listitem><para>Specify the location of the top CA key file. This option can only be used with the <option>-https</option> option and must be used together with the <option>-ca-cert</option> option. This option is only used for automatically generating the server certificate based on this CA key and the CA certificate specified by the <option>-ca-cert</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-cert-chain</option> <replaceable>ssl_cert_chain_file</replaceable></term>
+<listitem><para>This option can only be used with the <option>-https</option> option. This option is required if the server certificate is not signed by the top level CA directly but is signed by an intermediate authority.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-smf-fmri</option> <replaceable>smf_pkg_depot_fmri</replaceable></term>
+<listitem><para>Specify the FMRI of the <literal>pkg/depot</literal> service instance. This option is used to update the corresponding SMF properties of that instance if any certificates or keys are automatically generated for that instance. This option can only be used with the <option>-https</option> option.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>Providing Additional Server Configuration</title>
+<para>When the <option>F</option> option is not used, and the default <command>-t apache2</command>
+is set, the <literal>svc:/application/pkg/depot</literal> service
+looks in <filename>/etc/pkg/depot/conf.d</filename> at startup for additional
+Apache configuration files that can be used to extend the server configuration.
+Consult the Apache web server documentation for details on the directives
+that are used to configure the web server.</para>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Showing How a Repository Is Served</title>
+<para>The system in this example is running multiple instances of
+<literal>svc:/application/pkg/server</literal> and a single instance of
+<literal>svc:/application/pkg/depot</literal>. The
+<literal>pkg/server:standalone</literal> instance has an associated
+<command>pkg.depotd</command> process. The <command>pkg.depotd</command>
+process serves the repository configured in the
+<literal>pkg/server:standalone</literal> service. The
+<literal>pkg/server:userland</literal> instance has no associated processes. The
+<literal>pkg/depot:default</literal> service serves the repository configured in
+the <literal>pkg/server:userland</literal> service.</para>
+<screen>$ <userinput>svcs pkg/server</userinput>
 STATE    STIME    FMRI
 disabled Feb_06   svc:/application/pkg/server:default
 online   Feb_03   svc:/application/pkg/server:userland
 online   Feb_03   svc:/application/pkg/server:standalone
-$ \fBsvcs pkg/depot\fR
+$ <userinput>svcs pkg/depot</userinput>
 STATE    STIME    FMRI
 online   Feb_07   svc:/application/pkg/depot:default
-$ \fBsvcprop -p pkg/standalone -p pkg/readonly \e\fR
-\fBpkg/server:standalone\fR
+$ <userinput>svcprop -p pkg/standalone -p pkg/readonly &bsol;</userinput>
+<userinput>pkg/server:standalone</userinput>
 true
 true
-$ \fBsvcprop -p pkg/standalone -p pkg/readonly \e\fR
-\fBpkg/server:userland\fR
+$ <userinput>svcprop -p pkg/standalone -p pkg/readonly &bsol;</userinput>
+<userinput>pkg/server:userland</userinput>
 false
 true
-$ \fBsvcs -p svc:/application/pkg/server:standalone\fR
+$ <userinput>svcs -p svc:/application/pkg/server:standalone</userinput>
 STATE    STIME    FMRI
 online   Feb_03   svc:/application/pkg/server:standalone
          Jan_31       1206 pkg.depotd
-$ \fBsvcs -p svc:/application/pkg/server:userland\fR
+$ <userinput>svcs -p svc:/application/pkg/server:userland</userinput>
 STATE    STIME    FMRI
-online   Feb_03   svc:/application/pkg/server:userland
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRShowing Processes Associated With the Depot
-.sp
-.LP
-The following command shows \fBhttpd.worker\fR processes associated with the \fBpkg/depot\fR service.
-
-.sp
-.in +2
-.nf
-$ \fBsvcs -p pkg/depot\fR
+online   Feb_03   svc:/application/pkg/server:userland</screen>
+</example>
+<example id="GMWHD"><title>Showing Processes Associated With the Depot</title>
+<para>The following command shows <literal>httpd.worker</literal> processes
+associated with the <literal>pkg/depot</literal> service.</para>
+<screen>$ <userinput>svcs -p pkg/depot</userinput>
 STATE    STIME    FMRI
 online   16:59:49 svc:/application/pkg/depot:default
          16:59:48     6731 httpd.worker
@@ -365,74 +307,65 @@
          16:59:48     6737 httpd.worker
          16:59:48     6738 httpd.worker
          17:00:05     6744 httpd.worker
-         17:05:59     6915 httpd.worker
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 13n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 13n
-.rt  
-Command failed.
-.RE
+         17:05:59     6915 httpd.worker</screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist termlength="xtranarrow">
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>Command failed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg/depot</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="svcprop-1"><citerefentry><refentrytitle>svcprop</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="svcs-1"><citerefentry><refentrytitle>svcs</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="svcadm-1m"><citerefentry><refentrytitle>svcadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="svccfg-1m"><citerefentry><refentrytitle>svccfg</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 13n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg/depot\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBsvcprop\fR(1), \fBsvcs\fR(1), \fBsvcadm\fR(1M), \fBsvccfg\fR(1M), \fBpkg.depotd\fR(1M), \fBpkg\fR(5)
-.sp
-.LP
-\fICopying and Creating Package Repositories in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkg.depotd.1m	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkg.depotd.1m	Wed Jul 01 10:45:55 2015 -0700
@@ -1,846 +1,540 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkg.depotd 1M "02 Oct 2013" "SunOS 5.11" "System Administration Commands"
-.SH NAME
-pkg.depotd \- Image Packaging System depot server
-.SH SYNOPSIS
-.LP
-.nf
-/usr/lib/pkg.depotd [--cfg \fIsource\fR] [-a \fIaddress\fR]
-    [--content-root \fIroot_dir\fR] [-d \fIinst_root\fR]
-    [--debug \fIfeature_list\fR] [--disable-ops=\fIop\fR[/1][,...]]
-    [--image-root \fIpath\fR] [--log-access \fIdest\fR]
-    [--log-errors \fIdest\fR] [--mirror \fImode\fR] [-p \fIport\fR]
-    [--proxy-base \fIurl\fR] [--readonly \fImode\fR] [-s \fIthreads\fR]
-    [--sort-file-max-size \fIbytes\fR] [--ssl-cert-file \fIsource\fR]
-    [--ssl-dialog \fItype\fR] [--ssl-key-file \fIsource\fR]
-    [-t \fIsocket_timeout\fR] [--writable-root \fIpath\fR]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkg.depotd\fR is the depot server for the Image Packaging System. It provides network access to the data contained within a package repository. Clients that do not support direct access to a repository through the file system, or for which network access is the only available or preferred method of transport, typically use the package depot.
-.sp
-.LP
-Clients such as \fBpkg\fR, the retrieval client, can retrieve a list of packages and package metadata from a repository directly or through the depot server. \fBpkgsend\fR, the publication client, can send new versions of packages to a repository directly or through the depot server. \fBpkgrepo\fR can be used to create repositories for use with the depot server, or to manage them both directly and through the depot server.
-.sp
-.LP
-\fBpkg.depotd\fR is typically run as a service on the system. Package and software developers might want to run private copies for testing.
-.sp
-.LP
-The depot does not provide any access control methods of its own. By default, all of the clients that are able to connect are able to read all package data and publish new package versions. The exception is that when running under Service Management Facility (SMF), the default is to run in read-only mode. The "Notes" section below describes some best practices for maintaining a public depot server with evolving content.
-.SH SMF PROPERTIES
-.sp
-.LP
-The \fBpkg.depotd\fR server is generally configured via the SMF properties associated with its service. The \fBsvc:/application/pkg/server\fR service runs a \fBpkg.depot\fR server process, or contributes configuration to the \fBsvc:/application/pkg/depot\fR service. See the \fBpkg.depot-config\fR(1M) man page and the \fBpkg/standalone\fR property below.
-.sp
-.LP
-See the \fBsmf\fR(5) man page for information about SMF properties. The following properties are recognized:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/address\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBnet_address\fR) The IP address on which to listen for connections. The default value is 0.0.0.0 (\fBINADDR_ANY\fR), which listens on all active interfaces. To listen on all active IPv6 interfaces, use \fB::\fR. Only the first value is used.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/content_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The file system path at which the instance should find its static and other web content. The default value is \fB/usr/share/lib/pkg\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/debug\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) A comma-separated list of debug features to enable. Possible values are:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBheaders\fR\fR
-.ad
-.RS 11n
-.rt  
-Logs the headers of every request to the error log.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/disable_ops\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) A comma-separated list of operations that should be disabled for the depot server. Operations are given as \fIoperation\fR[/\fIversion\fR] (\fBcatalog\fR or \fBsearch_1\fR, for example).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/image_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The path to the image whose file information will be used as a cache for file data.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/inst_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The file system path at which the instance should find its repository data. Required unless \fBPKG_REPO\fR has been provided. The default value is \fB/var/pkgrepo\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/log_access\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The destination for any access related information logged by the depot process. Possible values are: \fBstderr\fR, \fBstdout\fR, \fBnone\fR, or an absolute path name. The default value is \fBstdout\fR if \fBstdout\fR is a \fBtty\fR. If \fBstdout\fR is not a \fBtty\fR, the default value is \fBnone\fR. If you run \fBpkg\fR as a service, the default value for \fBlog_access\fR is \fBnone\fR and output is written to \fB/var/svc/log/application-pkg-server:*\fR. See the \fBlogadm\fR(1M) man page for examples of managing large log files.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/log_errors\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The destination for any errors or other information logged by the depot process. Possible values are: \fBstderr\fR, \fBstdout\fR, \fBnone\fR, or an absolute path name. The default value is \fBstderr\fR. See the \fBlogadm\fR(1M) man page for examples of managing large log files.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/mirror\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBboolean\fR) Sets whether package mirror mode is used. When true, publishing and metadata operations are disabled and only a limited browser user interface is provided. This property cannot be true when the \fBpkg/readonly\fR property is true. The default value is \fBfalse\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/port\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) The port number on which the instance should listen for incoming package requests. If SSL certificate and key information has not been provided, the default value is 80; otherwise, the default value is 443.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/proxy_base\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBuri\fR) This changes the base URL for the depot server and is most useful when running behind Apache or some other web server in a reverse proxy configuration.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/readonly\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBboolean\fR) Sets whether modifying operations, such as those initiated by \fBpkgsend\fR, are disabled. Retrieval operations are still available. This property cannot be true when the \fBpkg/mirror\fR property is true. The default value is \fBtrue\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/socket_timeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) The maximum number of seconds the server should wait for a response from a client before closing a connection. The default value is 60.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/sort_file_max_size\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) The maximum size of the indexer sort file. Used to limit the amount of RAM the depot uses for indexing, or increase it for speed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_cert_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The absolute path name to a PEM-encoded Certificate file. The default value is \fBnone\fR. This property must be used with \fBssl_key_file\fR. The depot only responds to SSL requests if both \fBssl_cert_file\fR and \fB/ssl_key_file\fR are provided.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_dialog\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) Specifies what method should be used to obtain the passphrase used to decrypt the \fBssl_key_file\fR. Possible values are:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbuiltin\fR\fR
-.ad
-.sp .6
-.RS 4n
-Prompt for the passphrase. This is the default value.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexec:\fI/path/to/program\fR\fR\fR
-.ad
-.sp .6
-.RS 4n
-Execute the specified external program to obtain the passphrase. The first argument to the program is \fB\&''\fR, and is reserved. The second argument to the program is the port number of the server. The passphrase is printed to \fBstdout\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsmf:fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Attempt to retrieve the value of the property \fBpkg_secure/ssl_key_passphrase\fR from the service instance related to the FMRI.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_key_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The absolute path name to a PEM-encoded Private Key file. This property must be used with the property \fBssl_cert_file\fR. The depot only responds to SSL requests if both \fB/ssl_key_file\fR and \fBssl_cert_file\fR are provided.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/standalone\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBboolean\fR) To easily serve multiple repositories from a single Apache instance with minimal Apache configuration, set this property to \fBfalse\fR and set the \fBpkg/readonly\fR property of this \fBpkg/server\fR instance to \fBtrue\fR. The default value of \fBpkg/standalone\fR is \fBfalse\fR and the default value of \fBpkg/readonly\fR is \fBtrue\fR. See the \fBpkg.depot-config\fR(1M) man page for more information.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/threads\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) The number of threads started to serve requests. The default value is 60. Suitable only for small deployments. This value should be approximately 20 times the number of concurrent clients. The maximum value of \fBthreads\fR is 5000.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/writable_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The file system path to a directory to which the program has write access. This is used with the \fB-readonly\fR option to enable the depot server to create files, such as search indexes, without needing write access to the package information.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_secure/ssl_key_passphrase\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The password to use to decrypt the \fBpkg/ssl_key_file\fR. This value is read-authorization protected using the attribute \fBsolaris.smf.read.pkg-server\fR.
-.RE
-
-.sp
-.LP
-The presentation and behavior of the Browser User Interface (BUI) of the depot server is controlled using the following properties:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_description\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) A descriptive paragraph for the RSS/Atom feed.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_icon\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The path name of a small image used to visually represent the RSS/Atom feed. The path name should be relative to the \fBcontent_root\fR. The default value is \fBweb/_themes/pkg-block-icon.png\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_logo\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The path name of a large image that will be used to visually brand or identify the RSS/Atom feed. This value should be relative to the \fBcontent_root\fR. The default value is \fBweb/_themes/pkg-block-icon.png\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) A short, descriptive name for RSS/Atom feeds generated by the depot serving the repository. The default value is "package repository feed".
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_window\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) The number of hours before the feed for the repository was last generated, to include when generating the feed.
-.RE
-
-.sp
-.LP
-The package depot is also able to act as a mirror server for local client images from \fBpkg\fR(5). This enables clients that share a subnet on a LAN to mirror their file caches. Clients can download files from one another, thereby reducing load on the package depot server. This functionality is available as an alternate depot service configured by SMF. It uses mDNS and \fBdns-sd\fR for service discovery.
-.sp
-.LP
-The mDNS mirror is generally configured via the SMF properties associated with its service. The following properties are recognized:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/image_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) The path to the image whose file information will be used as a cache for file data. The default value is \fB/\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/port\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) The port number on which the instance should listen for incoming package requests. The default value is 80.
-.RE
-
-.SH OPTIONS
-.sp
-.LP
-\fBpkg.depotd\fR can read its base configuration information from a file or from the property data of an existing SMF service instance.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cfg\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the path name of a file to use when reading and writing configuration data, or a string of the form \fBsmf:\fIfmri\fR\fR where \fIfmri\fR is the service fault management resource identifier (FMRI) of the instance to read configuration data from. See "Depot Configuration" below for details on the format of the file specified.
-.RE
-
-.sp
-.LP
-If no preexisting configuration source is available, or to override values read from a configuration file provided using \fB--cfg\fR, the following options can be used to alter the default behavior of the depot server:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIaddress\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/address\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--content-root\fR \fIroot_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/content_root\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIinst_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/inst_root\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--debug\fR \fIfeature_list\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/debug\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--disable-ops\fR=\fIop\fR[\fB/1\fR][,...]\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/disable_ops\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--image-root\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/image_root\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--log-access\fR \fIdest\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/log_access\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--log-errors\fR \fIdest\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/log_errors\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--mirror\fR \fImode\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/mirror\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIport\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/port\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--proxy-base\fR \fIurl\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/proxy_base\fR above. This option is ignored if an empty value is provided.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--readonly\fR \fImode\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/readonly\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIthreads\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/threads\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sort-file-max-size\fR \fIbytes\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/sort_file_max_size\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-cert-file\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/ssl_cert_file\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-dialog\fR \fItype\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/ssl_dialog\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-key-file\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/ssl_key_file\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIsocket_timeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/socket_timeout\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--writable-root\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-See \fBpkg/writable_root\fR above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.LP
-Additional administrative and management functionality for package repositories is provided by \fBpkgrepo\fR.
-.SH DEPOT CONFIGURATION
-.sp
-.LP
-When a configuration file is provided (instead of an SMF FMRI) by using the \fB--cfg\fR option, the depot server reads and writes all configuration data in a simple text format. The configuration data is described in "SMF Properties" above. The configuration data consists of sections, lead by a \fB[\fIsection\fR]\fR header, and followed by \fBname = \fIvalue\fR\fR entries. Continuations are in the style of RFC 822. Values can be split over multiple lines by beginning continuation lines with whitespace.
-.sp
-.LP
-Any required values not provided in the configuration file must be provided using the option listed in "Options" above. A sample configuration file might look like this:
-.sp
-.in +2
-.nf
-[pkg]
+<refentry id="pkg.depotd-1m">
+<refmeta><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum>
+<refmiscinfo class="date">02 Oct 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1m;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg.depotd</refname><refpurpose>Image Packaging System depot server</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/lib/pkg.depotd [--cfg <replaceable>source</replaceable>] [-a <replaceable>address</replaceable>]
+    [--content-root <replaceable>root_dir</replaceable>] [-d <replaceable>inst_root</replaceable>]
+    [--debug <replaceable>feature_list</replaceable>] [--disable-ops=<replaceable>op</replaceable>[/1][,...]]
+    [--image-root <replaceable>path</replaceable>] [--log-access <replaceable>dest</replaceable>]
+    [--log-errors <replaceable>dest</replaceable>] [--mirror <replaceable>mode</replaceable>] [-p <replaceable>port</replaceable>]
+    [--proxy-base <replaceable>url</replaceable>] [--readonly <replaceable>mode</replaceable>] [-s <replaceable>threads</replaceable>]
+    [--sort-file-max-size <replaceable>bytes</replaceable>] [--ssl-cert-file <replaceable>source</replaceable>]
+    [--ssl-dialog <replaceable>type</replaceable>] [--ssl-key-file <replaceable>source</replaceable>]
+    [-t <replaceable>socket_timeout</replaceable>] [--writable-root <replaceable>path</replaceable>]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="GLHAR" role="description"><title></title>
+<para><command>pkg.depotd</command> is the depot server for the Image Packaging
+System. It provides network access to the data contained within a package
+repository. Clients that do not support direct access to a repository through
+the file system, or for which network access is the only available or preferred
+method of transport, typically use the package depot.</para>
+<para>Clients such as <command>pkg</command>, the retrieval client, can retrieve
+a list of packages and package metadata from a repository directly or through
+the depot server. <command>pkgsend</command>, the publication client, can
+send new versions of packages to a repository directly or through the depot
+server. <command>pkgrepo</command> can be used to create repositories for
+use with the depot server, or to manage them both directly and through the
+depot server.</para>
+<para><command>pkg.depotd</command> is typically run as a service on the system.
+Package and software developers might want to run private copies for testing.</para>
+<para>The depot does not provide any access control methods of its own. By
+default, all of the clients that are able to connect are able to read all
+package data and publish new package versions. The exception is that when
+running under Service Management Facility (SMF), the default is to run in
+read-only mode. The &ldquo;Notes&rdquo; section below describes some best
+practices for maintaining a public depot server with evolving content.</para>
+</refsect1>
+<refsect1 role="other"><title>SMF Properties</title>
+<para>The <literal>pkg.depotd</literal> server is generally configured via
+the SMF properties associated with its service. The
+<literal>svc:/application/pkg/server</literal> service runs a
+<literal>pkg.depot</literal> server process, or contributes configuration to
+the <literal>svc:/application/pkg/depot</literal> service. See
+the <literal>pkg.depot-config</literal>(1M) man page and the
+<literal>pkg/standalone</literal> property below.</para>
+<para>See the <literal>smf</literal>(5) man page for information about SMF
+properties. The following properties are recognized:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg/address</literal></term>
+<listitem><para>(<literal>net_address</literal>) The IP address on which to
+listen for connections. The default value is 0.0.0.0 (<literal>INADDR_ANY</literal>),
+which listens on all active interfaces. To listen on all active IPv6 interfaces,
+use <literal>::</literal>. Only the first value is used.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/content_root</literal></term>
+<listitem><para>(<literal>astring</literal>) The file system path at which
+the instance should find its static and other web content. The default value
+is <filename>/usr/share/lib/pkg</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/debug</literal></term>
+<listitem><para>(<literal>astring</literal>) A comma-separated list of debug
+features to enable. Possible values are:</para>
+<variablelist>
+<varlistentry><term><literal>headers</literal></term>
+<listitem><para>Logs the headers of every request to the error log.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/disable_ops</literal></term>
+<listitem><para>(<literal>astring</literal>) A comma-separated list of operations
+that should be disabled for the depot server. Operations are given as <replaceable>
+operation</replaceable>[/<replaceable>version</replaceable>] (<literal>catalog</literal> or <literal>
+search_1</literal>, for example).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/image_root</literal></term>
+<listitem><para>(<literal>astring</literal>) The path to the image whose file
+information will be used as a cache for file data.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/inst_root</literal></term>
+<listitem><para>(<literal>astring</literal>) The file system path at which the
+instance should find its repository data. Required unless
+<literal>PKG_REPO</literal> has been provided. The default value is
+<filename>/var/pkgrepo</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/log_access</literal></term>
+<listitem><para>(<literal>astring</literal>) The destination for any access related information logged by the depot process. Possible values are: <filename>stderr</filename>, <filename>stdout</filename>, <literal>none</literal>, or an absolute path name. The default value is <filename>stdout</filename> if <filename>stdout</filename> is a <literal>tty</literal>. If <filename>stdout</filename> is not a <literal>tty</literal>, the default value is <literal>none</literal>. If you run <literal>pkg</literal> as a service, the default value for <literal>log_access</literal> is <literal>none</literal> and output is written to <filename>/var/svc/log/application-pkg-server:*</filename>. See the <literal>logadm</literal>(1M) man page for examples of managing large log files.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/log_errors</literal></term>
+<listitem><para>(<literal>astring</literal>) The destination for any errors
+or other information logged by the depot process. Possible values are: <filename>
+stderr</filename>, <filename>stdout</filename>, <literal>none</literal>, or
+an absolute path name. The default value is <filename>stderr</filename>. See
+the <literal>logadm</literal>(1M) man page for examples of managing large
+log files.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/mirror</literal></term>
+<listitem><para>(<literal>boolean</literal>) Sets whether package mirror mode
+is used. When true, publishing and metadata operations are disabled and only
+a limited browser user interface is provided. This property cannot be true
+when the <literal>pkg/readonly</literal> property is true. The default value
+is <literal>false</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/port</literal></term>
+<listitem><para>(<literal>count</literal>) The port number on which the instance
+should listen for incoming package requests. If SSL certificate and key information
+has not been provided, the default value is 80; otherwise, the default value
+is 443.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/proxy_base</literal></term>
+<listitem><para>(<literal>uri</literal>) This changes the base URL for the
+depot server and is most useful when running behind Apache or some other web
+server in a reverse proxy configuration.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/readonly</literal></term>
+<listitem><para>(<literal>boolean</literal>) Sets whether modifying operations,
+such as those initiated by <command>pkgsend</command>, are disabled. Retrieval
+operations are still available. This property cannot be true when the <literal>pkg/mirror
+</literal> property is true. The default value is <literal>true</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/socket_timeout</literal></term>
+<listitem><para>(<literal>count</literal>) The maximum number of seconds the
+server should wait for a response from a client before closing a connection.
+The default value is 60.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/sort_file_max_size</literal></term>
+<listitem><para>(<literal>count</literal>) The maximum size of the indexer
+sort file. Used to limit the amount of RAM the depot uses for indexing, or
+increase it for speed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_cert_file</literal></term>
+<listitem><para>(<literal>astring</literal>) The absolute path name to a PEM-encoded
+Certificate file. The default value is <literal>none</literal>. This property
+must be used with <literal>ssl_key_file</literal>. The depot only responds
+to SSL requests if both <literal>ssl_cert_file</literal> and <literal>/ssl_key_file
+</literal> are provided.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_dialog</literal></term>
+<listitem><para>(<literal>astring</literal>) Specifies what method should
+be used to obtain the passphrase used to decrypt the <literal>ssl_key_file</literal>.
+Possible values are:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>builtin</literal></term>
+<listitem><para>Prompt for the passphrase. This is the default value.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exec:<replaceable>/path/to/program</replaceable></literal></term>
+<listitem><para>Execute the specified external program to obtain the passphrase.
+The first argument to the program is <literal>''</literal>, and is reserved.
+The second argument to the program is the port number of the server. The passphrase
+is printed to <filename>stdout</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>smf:fmri</literal></term>
+<listitem><para>Attempt to retrieve the value of the property <literal>pkg_secure/ssl_key_passphrase
+</literal> from the service instance related to the FMRI.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_key_file</literal></term>
+<listitem><para>(<literal>astring</literal>) The absolute path name to a PEM-encoded
+Private Key file. This property must be used with the property <literal>ssl_cert_file
+</literal>. The depot only responds to SSL requests if both <literal>/ssl_key_file
+</literal> and <literal>ssl_cert_file</literal> are provided.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/standalone</literal></term>
+<listitem><para>(<literal>boolean</literal>) To easily serve multiple
+repositories from a single Apache instance with minimal Apache configuration,
+set this property to <literal>false</literal> and set the
+<literal>pkg/readonly</literal> property of this <literal>pkg/server</literal>
+instance to <literal>true</literal>. The default value of
+<literal>pkg/standalone</literal> is <literal>false</literal> and the default
+value of <literal>pkg/readonly</literal> is <literal>true</literal>. See the
+<literal>pkg.depot-config</literal>(1M) man page for more information.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/threads</literal></term>
+<listitem><para>(<literal>count</literal>) The number of threads started to
+serve requests. The default value is 60. Suitable only for small deployments.
+This value should be approximately 20 times the number of concurrent clients.
+The maximum value of <literal>threads</literal> is 5000.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/writable_root</literal></term>
+<listitem><para>(<literal>astring</literal>) The file system path to a directory
+to which the program has write access. This is used with the <option>readonly</option> option
+to enable the depot server to create files, such as search indexes, without
+needing write access to the package information.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_secure/ssl_key_passphrase</literal></term>
+<listitem><para>(<literal>astring</literal>) The password to use to decrypt
+the <literal>pkg/ssl_key_file</literal>. This value is read-authorization
+protected using the attribute <literal>solaris.smf.read.pkg-server</literal>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>The presentation and behavior of the Browser User Interface (BUI) of
+the depot server is controlled using the following properties:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg_bui/feed_description</literal></term>
+<listitem><para>(<literal>astring</literal>) A descriptive paragraph for the
+RSS/Atom feed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_icon</literal></term>
+<listitem><para>(<literal>astring</literal>) The path name of a small image
+used to visually represent the RSS/Atom feed. The path name should be relative
+to the <literal>content_root</literal>. The default value is <filename>web/_themes/pkg-block-icon.png
+</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_logo</literal></term>
+<listitem><para>(<literal>astring</literal>) The path name of a large image
+that will be used to visually brand or identify the RSS/Atom feed. This value
+should be relative to the <literal>content_root</literal>. The default value
+is <filename>web/_themes/pkg-block-icon.png</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_name</literal></term>
+<listitem><para>(<literal>astring</literal>) A short, descriptive name for
+RSS/Atom feeds generated by the depot serving the repository. The default
+value is &ldquo;package repository feed&rdquo;.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_window</literal></term>
+<listitem><para>(<literal>count</literal>) The number of hours before the
+feed for the repository was last generated, to include when generating the
+feed.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>The package depot is also able to act as a mirror server for local client
+images from <literal>pkg</literal>(5). This enables clients that share a subnet
+on a LAN to mirror their file caches. Clients can download files from one
+another, thereby reducing load on the package depot server. This functionality
+is available as an alternate depot service configured by SMF. It uses mDNS
+and <literal>dns-sd</literal> for service discovery.</para>
+<para>The mDNS mirror is generally configured via the SMF properties associated
+with its service. The following properties are recognized:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg/image_root</literal></term>
+<listitem><para>(<literal>astring</literal>) The path to the image whose file
+information will be used as a cache for file data. The default value is <filename>
+/</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/port</literal></term>
+<listitem><para>(<literal>count</literal>) The port number on which the instance
+should listen for incoming package requests. The default value is 80.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para><command>pkg.depotd</command> can read its base configuration information
+from a file or from the property data of an existing SMF service instance.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-cfg</option> <replaceable>source</replaceable></term>
+<listitem><para>Specify the path name of a file to use when reading and writing
+configuration data, or a string of the form <literal>smf:<replaceable>fmri</replaceable></literal> where <replaceable>
+fmri</replaceable> is the service fault management resource identifier (FMRI)
+of the instance to read configuration data from. See &ldquo;Depot Configuration&rdquo;
+below for details on the format of the file specified.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>If no preexisting configuration source is available, or to override
+values read from a configuration file provided using <option>-cfg</option>,
+the following options can be used to alter the default behavior of the depot
+server:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>a</option> <replaceable>address</replaceable></term>
+<listitem><para>See <literal>pkg/address</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-content-root</option> <replaceable>root_dir</replaceable></term>
+<listitem><para>See <literal>pkg/content_root</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>inst_root</replaceable></term>
+<listitem><para>See <literal>pkg/inst_root</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-debug</option> <replaceable>feature_list</replaceable></term>
+<listitem><para>See <literal>pkg/debug</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-disable-ops</option>=<replaceable>op</replaceable>[<literal>
+/1</literal>][,...]</term>
+<listitem><para>See <literal>pkg/disable_ops</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-image-root</option> <replaceable>path</replaceable></term>
+<listitem><para>See <literal>pkg/image_root</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-log-access</option> <replaceable>dest</replaceable></term>
+<listitem><para>See <literal>pkg/log_access</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-log-errors</option> <replaceable>dest</replaceable></term>
+<listitem><para>See <literal>pkg/log_errors</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-mirror</option> <replaceable>mode</replaceable></term>
+<listitem><para>See <literal>pkg/mirror</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
+<listitem><para>See <literal>pkg/port</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-proxy-base</option> <replaceable>url</replaceable></term>
+<listitem><para>See <literal>pkg/proxy_base</literal> above. This option is
+ignored if an empty value is provided.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-readonly</option> <replaceable>mode</replaceable></term>
+<listitem><para>See <literal>pkg/readonly</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>threads</replaceable></term>
+<listitem><para>See <literal>pkg/threads</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-sort-file-max-size</option> <replaceable>bytes</replaceable></term>
+<listitem><para>See <literal>pkg/sort_file_max_size</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-cert-file</option> <replaceable>source</replaceable></term>
+<listitem><para>See <literal>pkg/ssl_cert_file</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-dialog</option> <replaceable>type</replaceable></term>
+<listitem><para>See <literal>pkg/ssl_dialog</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-key-file</option> <replaceable>source</replaceable></term>
+<listitem><para>See <literal>pkg/ssl_key_file</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>socket_timeout</replaceable></term>
+<listitem><para>See <literal>pkg/socket_timeout</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-writable-root</option> <replaceable>path</replaceable></term>
+<listitem><para>See <literal>pkg/writable_root</literal> above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Additional administrative and management functionality for package repositories
+is provided by <command>pkgrepo</command>.</para>
+</refsect1>
+<refsect1 role="other"><title>Depot Configuration</title>
+<para>When a configuration file is provided (instead of an SMF FMRI) by using
+the <option>-cfg</option> option, the depot server reads and writes all configuration
+data in a simple text format. The configuration data is described in &ldquo;SMF
+Properties&rdquo; above. The configuration data consists of sections, lead
+by a <literal>[<replaceable>section</replaceable>]</literal> header, and followed
+by <literal>name = <replaceable>value</replaceable></literal> entries. Continuations
+are in the style of RFC 822. Values can be split over multiple lines by beginning
+continuation lines with whitespace.</para>
+<para>Any required values not provided in the configuration file must be provided
+using the option listed in &ldquo;Options&rdquo; above. A sample configuration
+file might look like this:</para>
+<programlisting>[pkg]
 port = 80
 inst_root = /export/repo
 
 [pub_example_com]
 feed_description = example.com's software
-  update log
-.fi
-.in -2
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fREnabling the Depot Server
-.sp
-.in +2
-.nf
-# \fBsvcadm enable application/pkg/server\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRChanging the Listening Port of the Server.
-.sp
-.in +2
-.nf
-# \fBsvccfg -s application/pkg/server setprop pkg/port = 10000\fR
-# \fBsvcadm refresh application/pkg/server\fR
-# \fBsvcadm restart application/pkg/server\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 3 \fREnabling the Mirror
-.sp
-.in +2
-.nf
-# \fBsvcadm enable application/pkg/dynamic-mirror\fR
-.fi
-.in -2
-.sp
-
-.SH ENVIRONMENT VARIABLES
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_REPO\fR\fR
-.ad
-.RS 21n
-.rt  
-Specifies the directory that contains the repository to serve. This value is ignored if \fB-d\fR is specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_DEPOT_CONTENT\fR\fR
-.ad
-.RS 21n
-.rt  
-Specifies the directory that contains static content served by the depot. The files listed below under "Files" should be present in this directory, although their content can differ from the supplied default content.
-.RE
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 13n
-.rt  
-Successful operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 13n
-.rt  
-An error occurred.
-.RE
+  update log</programlisting>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Enabling the Depot Server</title>
+<screen># <userinput>svcadm enable application/pkg/server</userinput></screen>
+</example>
+<example id="GLHBM"><title>Changing the Listening Port of the Server.</title>
+<screen># <userinput>svccfg -s application/pkg/server setprop pkg/port = 10000</userinput>
+# <userinput>svcadm refresh application/pkg/server</userinput>
+# <userinput>svcadm restart application/pkg/server</userinput></screen>
+</example>
+<example id="GLHAW"><title>Enabling the Mirror</title>
+<screen># <userinput>svcadm enable application/pkg/dynamic-mirror</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_REPO</envar></term>
+<listitem><para>Specifies the directory that contains the repository to serve.
+This value is ignored if <option>d</option> is specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_DEPOT_CONTENT</envar></term>
+<listitem><para>Specifies the directory that contains static content served
+by the depot. The files listed below under &ldquo;Files&rdquo; should be present
+in this directory, although their content can differ from the supplied default
+content.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist termlength="xtranarrow">
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Successful operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>/usr/share/lib/pkg</filename></term>
+<listitem><para>Default presentation content location. Modify <literal>pkg/content_root
+</literal> to select an alternate location.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg.depot-config-1m"><citerefentry><refentrytitle>pkg.depot-config</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="dns-sd-1m"><citerefentry><refentrytitle>dns-sd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="MDNSD-1M"><citerefentry><refentrytitle>mdnsd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <literal>syslogd</literal>(1M), <olink targetdoc="refman" targetptr="SMF-5"><citerefentry><refentrytitle>smf</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>The <literal>pkd.depotd</literal> service is managed by SMF under the
+service identifier <literal>svc:/application/pkg/server</literal>.</para>
+<para>The mDNS mirror service is managed by SMF under the service identifier
+<literal>svc:/application/pkg/dynamic-mirror</literal>.</para>
+<para>To control read access to the depot, you can use an HTTP reverse proxy
+in combination with authentication methods such as client based SSL certificate
+access, which <command>pkg</command> natively supports.</para>
+<para>To easily serve multiple repositories from a single Apache instance with
+minimal Apache configuration, set the <literal>pkg/standalone</literal> property
+of a particular <literal>pkg/server</literal> instance to
+<literal>false</literal> and set the <literal>pkg/readonly</literal> property of
+that instance to <literal>true</literal>. See the
+<literal>pkg.depot-config</literal>(1M) man page for more information.</para>
+<para>Changes to configuration, or changes to package data using file system
+based operations, require a restart of the depot server process so that the
+changes can be reflected in operations and output. Use one of the following
+methods to restart the depot server process:</para>
+<itemizedlist>
+<listitem><para>Use <command>svcadm</command> to restart the <literal>application/pkg/server
+</literal> instance.</para></listitem>
+<listitem><para>Send a <literal>SIGUSR1</literal> signal to the depot server
+process using <command>kill</command>. This executes a &ldquo;graceful restart&rdquo;
+that leaves the process intact but reloads all configuration, package, and
+search data:</para>
+<screen># <userinput>kill -USR1 <replaceable>pid</replaceable></userinput></screen>
+</listitem>
+</itemizedlist>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 13n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 13n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH FILES
-.sp
-.ne 2
-.mk
-.na
-\fB\fB/usr/share/lib/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-Default presentation content location. Modify \fBpkg/content_root\fR to select an alternate location.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg.depot-config\fR(1M), \fBdns-sd\fR(1M), \fBmdnsd\fR(1M), \fBpkg\fR(1), \fBpkgrepo\fR(1), \fBpkgsend\fR(1), \fBsyslogd\fR(1M), \fBsmf\fR(5)
-.sp
-.LP
-\fICopying and Creating Package Repositories in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH NOTES
-.sp
-.LP
-The \fBpkd.depotd\fR service is managed by SMF under the service identifier \fBsvc:/application/pkg/server\fR.
-.sp
-.LP
-The mDNS mirror service is managed by SMF under the service identifier \fBsvc:/application/pkg/dynamic-mirror\fR.
-.sp
-.LP
-To control read access to the depot, you can use an HTTP reverse proxy in combination with authentication methods such as client based SSL certificate access, which \fBpkg\fR natively supports.
-.sp
-.LP
-To easily serve multiple repositories from a single Apache instance with minimal Apache configuration, set the \fBpkg/standalone\fR property of a particular \fBpkg/server\fR instance to \fBfalse\fR and set the \fBpkg/readonly\fR property of that instance to \fBtrue\fR. See the \fBpkg.depot-config\fR(1M) man page for more information.
-.sp
-.LP
-Changes to configuration, or changes to package data using file system based operations, require a restart of the depot server process so that the changes can be reflected in operations and output. Use one of the following methods to restart the depot server process:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Use \fBsvcadm\fR to restart the \fBapplication/pkg/server\fR instance.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Send a \fBSIGUSR1\fR signal to the depot server process using \fBkill\fR. This executes a "graceful restart" that leaves the process intact but reloads all configuration, package, and search data:
-.sp
-.in +2
-.nf
-# \fBkill -USR1 \fIpid\fR\fR
-.fi
-.in -2
-.sp
-
-.RE
--- a/src/man/pkg.sysrepo.1m	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkg.sysrepo.1m	Wed Jul 01 10:45:55 2015 -0700
@@ -1,171 +1,156 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkg.sysrepo 1M "21 May 2013" "SunOS 5.11" "System Administration Commands"
-.SH NAME
-pkg.sysrepo \- Image Packaging System system repository configuration
-.SH SYNOPSIS
-.LP
-.nf
-/usr/lib/pkg.sysrepo -p \fIport\fR [-c \fIcache_dir\fR] [-s \fIcache_size\fR]
-    [-w \fIhttp_proxy\fR] [-W \fIhttps_proxy\fR]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkg.sysrepo\fR is used to generate the configuration files for the Image Packaging System (IPS) system repository. \fBpkg.sysrepo\fR is called by the \fBsvc:/application/pkg/system-repository\fR Service Management Facility (SMF) service. Changes in configuration should be made to the properties in the SMF service.
-.sp
-.LP
-The system repository is responsible for providing access to the package repositories configured in a reference image through a centralized proxy. Publisher configuration changes made to that reference image are seen immediately by any clients configured to use the system repository.
-.sp
-.LP
-The system repository is primarily used in the global zone to allow non-global zones to access the repositories configured in the global zone. The SMF services \fBsvc:/application/pkg/zones-proxyd\fR and \fBsvc:/application/pkg/zones-proxy-client\fR are responsible for providing the transport between non-global zones and the global zone. This transport is only used by \fBpkg\fR(5).
-.sp
-.LP
-Note that only \fBhttp\fR, \fBhttps\fR, and \fBv4\fR file repositories and \fBp5p\fR archives are supported. Older file repository formats are not supported. See \fBpkgrepo\fR(1) for more information about repository versions.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the absolute path to a directory that should be used by the system repository for caching responses from the publishers configured.
-.sp
-By default, a file-cache is used. However, the special value \fBmemory\fR can be used to indicate the an in-memory cache should be used. The special value \fBNone\fR can be used to indicate that the system repository should not perform any caching. This setting should be configured using the \fBconfig/cache_dir\fR SMF property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIport\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the port that the system repository should use to listen for requests. This setting should be configured using the \fBconfig/port\fR SMF property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIcache_size\fR\fR
-.ad
-.sp .6
-.RS 4n
-An integer value in megabytes that defines the maximum cache size of the system repository. This setting should be configured using the \fBconfig/cache_max\fR SMF property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-w\fR \fIhttp_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-A string of the form \fB\fIscheme\fR://\fIhostname\fR[:\fIport\fR]\fR that defines a web proxy that the system repository can use to access http-based package repositories. This setting can be configured using the \fBconfig/http_proxy\fR SMF property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-W\fR \fIhttps_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-A string of the form \fB\fIscheme\fR://\fIhostname\fR[:\fIport\fR]\fR that defines a web proxy that the system repository can use to access https-based package repositories. This setting can be configured using the \fBconfig/https_proxy\fR SMF property.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.SH EXAMPLES
-.LP
-\fBExample 1 \fREnabling the System Repository
-.sp
-.in +2
-.nf
-$ \fBsvcadm enable svc:/application/pkg/system-repository\fR
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-Command failed to write a valid configuration.
-.RE
+<refentry id="pkg.sysrepo-1m">
+<refmeta><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum>
+<refmiscinfo class="date">21 May 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1m;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg.sysrepo</refname><refpurpose>Image Packaging System system repository configuration</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/lib/pkg.sysrepo -p <replaceable>port</replaceable> [-c <replaceable>
+cache_dir</replaceable>] [-s <replaceable>cache_size</replaceable>]
+    [-w <replaceable>http_proxy</replaceable>] [-W <replaceable>https_proxy</replaceable>]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgsysrepo-1m-desc" role="description"><title></title>
+<para><command>pkg.sysrepo</command> is used to generate the configuration
+files for the Image Packaging System (IPS) system repository. <command>pkg.sysrepo
+</command> is called by the <literal>svc:/application/pkg/system-repository</literal> Service
+Management Facility (SMF) service. Changes in configuration should be made
+to the properties in the SMF service.</para>
+<para>The system repository is responsible for providing access to the package
+repositories configured in a reference image through a centralized proxy.
+Publisher configuration changes made to that reference image are seen immediately
+by any clients configured to use the system repository.</para>
+<para>The system repository is primarily used in the global zone to allow
+non-global zones to access the repositories configured in the global zone.
+The SMF services <literal>svc:/application/pkg/zones-proxyd</literal> and <literal>
+svc:/application/pkg/zones-proxy-client</literal> are responsible for providing
+the transport between non-global zones and the global zone. This transport
+is only used by <literal>pkg</literal>(5).</para>
+<para>Note that only <literal>http</literal>, <literal>https</literal>, and <literal>
+v4</literal> file repositories and <literal>p5p</literal> archives are supported.
+Older file repository formats are not supported. See <command>pkgrepo</command>(1)
+for more information about repository versions.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>Specify the absolute path to a directory that should be used
+by the system repository for caching responses from the publishers configured.</para>
+<para>By default, a file-cache is used. However, the special value <literal>memory
+</literal> can be used to indicate the an in-memory cache should be used.
+The special value <literal>None</literal> can be used to indicate that the
+system repository should not perform any caching. This setting should be configured
+using the <literal>config/cache_dir</literal> SMF property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
+<listitem><para>Specify the port that the system repository should use to
+listen for requests. This setting should be configured using the <literal>config/port
+</literal> SMF property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>cache_size</replaceable></term>
+<listitem><para>An integer value in megabytes that defines the maximum cache
+size of the system repository. This setting should be configured using the <literal>
+config/cache_max</literal> SMF property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>w</option> <replaceable>http_proxy</replaceable></term>
+<listitem><para>A string of the form <literal><replaceable>scheme</replaceable>://<replaceable>
+hostname</replaceable>[:<replaceable>port</replaceable>]</literal> that defines
+a web proxy that the system repository can use to access http-based package
+repositories. This setting can be configured using the <literal>config/http_proxy
+</literal> SMF property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>W</option> <replaceable>https_proxy</replaceable></term>
+<listitem><para>A string of the form <literal><replaceable>scheme</replaceable>://<replaceable>
+hostname</replaceable>[:<replaceable>port</replaceable>]</literal> that defines
+a web proxy that the system repository can use to access https-based package
+repositories. This setting can be configured using the <literal>config/https_proxy
+</literal> SMF property.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Enabling the System Repository</title>
+<screen>$ <userinput>svcadm enable svc:/application/pkg/system-repository</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>Command failed to write a valid configuration.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(1), \fBpkg.depotd\fR(1M), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkgdepend.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgdepend.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,416 +1,289 @@
-'\" te
-.\" Copyright (c) 2007, 2015, Oracle and/or its affiliates. All rights reserved.
-.TH pkgdepend 1 "12 Jul 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgdepend \- Image Packaging System dependency analyzer
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgdepend [\fIoptions\fR] \fIcommand\fR [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgdepend generate [-IMm] -d \fIdir\fR [-d \fIdir\fR]
-    [-D \fIname\fR=\fIvalue\fR] [-k \fIpath\fR] \fImanifest_file\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgdepend resolve [-EmoSv] [-d \fIoutput_dir\fR]
-    [-e \fIexternal_package_file\fR]... [-s \fIsuffix\fR]
-    \fImanifest_file\fR ...
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-The \fBpkgdepend\fR command generates and resolves dependencies for packages. A package might depend on files from other packages. The \fBpkgdepend\fR command is typically used in two passes: file dependency generation and file-to-package resolution.
-.sp
-.LP
-The \fBgenerate\fR subcommand examines the content of a package and determines what external files the package needs.
-.sp
-.LP
-The \fBresolve\fR subcommand takes the list of files from the \fBgenerate\fR step, and searches a reference set of packages to determine the names of the packages that contain those dependent files. The reference set of packages that are searched for the dependent files are the packages that are currently installed on the publisher's system.
-.sp
-.LP
-Several components of delivered files are used as sources of dependency information:
-.sp
-.ne 2
-.mk
-.na
-\fBELF\fR
-.ad
-.RS 14n
-.rt  
-ELF headers in delivered files are analyzed for dependency information, with the \fB-k\fR and \fB-D\fR options modifying the information obtained. For more details on ELF dependencies, see \fBldd\fR and the \fILinker and Libraries Guide\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBScripts\fR
-.ad
-.RS 14n
-.rt  
-Shell scripts that contain \fB#!\fR lines referencing an interpreter result in a dependency on the package that delivers that interpreter.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBPython\fR
-.ad
-.RS 14n
-.rt  
-Python scripts are first analyzed as scripts. In addition, any imports the script declares might also serve as sources of dependency information.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBHard links\fR
-.ad
-.RS 14n
-.rt  
-Hard links in manifests result in a dependency on the package that delivers the link target.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBSMF\fR
-.ad
-.RS 14n
-.rt  
-Delivered SMF service manifests that include \fBrequire_all\fR dependencies result in dependencies on the packages that deliver the SMF manifests that provide those FMRIs.
-.RE
-
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the image rooted at \fIdir\fR. If no directory was specified or determined based on environment, the default is /. See the "Environment Variables" section for more information.
-.RE
-
-.SH SUB-COMMANDS
-.sp
-.LP
-The following subcommands are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgdepend generate\fR [\fB-IMm\fR] \fB-d\fR \fIdir\fR [\fB-d\fR \fIdir\fR] [\fB-D\fR \fIname\fR=\fIvalue\fR] [\fB-k\fR \fIpath\fR] \fImanifest_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-Produce the dependencies on files of the manifest specified by \fImanifest_file\fR.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-Show the dependencies that are satisfied within \fImanifest_file\fR. Do not use the result of \fB-I\fR with \fBpkgdepend resolve\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-M\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a list of file types that could not be analyzed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-Repeat the original manifest with any discovered dependencies added after.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add \fIdir\fR to a list of directories to search for the manifest's files.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-D\fR \fIname\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the \fIvalue\fR as a way to expand the token \fIname\fR in run paths for ELF file dependencies.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the \fIpath\fR to the list of run paths to search for kernel modules. Using the \fB-k\fR option removes the default paths, which are \fB/kernel\fR and \fB/usr/kernel\fR.
-.sp
-Run paths such as those specified by the \fB-k\fR option can also be specified per action or per manifest by using the action or manifest attribute \fBpkg.depend.runpath\fR. The value of the \fBpkg.depend.runpath\fR attribute is a colon-separated string of the paths to use. Setting any \fBpkg.depend.runpath\fR attributes in the manifest or action overrides paths specified with the \fB-k\fR option.
-.sp
-The special token \fB$PKGDEPEND_RUNPATH\fR can be used as one component of the \fBpkg.depend.runpath\fR attribute value in order to include the standard system run path for the file being analyzed.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-In some cases, you might want to prevent automatic generation of dependencies. For example, if a package delivers a sample Python script that imports a set of modules, those modules imported by the sample script are not dependencies for the package that delivers the sample script. Use the action or manifest attribute \fBpkg.depend.bypass-generate\fR to prevent generating dependencies against the specified files.
-.sp
-The \fBpkg.depend.bypass-generate\fR values are Python regular expressions that match file names. The regular expressions are implicitly anchored at the start and end of the file path. The value given in the following example matches \fBthis/that\fR but does not match \fBsomething/this/that/the/other\fR.
-.sp
-.in +2
-.nf
-pkg.depend.bypass-generate=this/that
-.fi
-.in -2
-
-For more information about Python regular expression syntax, use the command \fBpydoc re\fR or see more complete documentation at \fBhttp://docs.python.org/dev/howto/regex.html\fR.
-.sp
-When \fBpkgdepend generate\fR input manifests contain SMF manifest files, any SMF services or instances declared by those SMF manifest files are included in the \fBpkgdepend\fR output. These SMF services or instances are included in the form of a \fBset\fR action with the name \fBorg.opensolaris.smf.fmri\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgdepend resolve\fR [\fB-EmoSv\fR] [\fB-d\fR \fIoutput_dir\fR] [\fB-e\fR \fIexternal_package_file\fR]... [\fB-s\fR \fIsuffix\fR] \fImanifest_file\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Transform dependencies on files into dependencies on the packages that deliver those files. Dependencies are first resolved against the manifests given on the command line and then against the packages installed on the system. By default, the dependencies for each manifest are placed in a file named \fB\fImanifest_file\fR.res\fR.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-e\fR \fIexternal_package_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only resolve against packages from the system whose names match a pattern in \fIexternal_package_file\fR. This option can be specified multiple times. The \fB-e\fR option cannot be used with the \fB-S\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-E\fR\fR
-.ad
-.sp .6
-.RS 4n
-If \fB-e\fR is specified, show the packages that were expected to be external dependencies but were not external dependencies. Packages that were expected to be external dependencies are packages from the system whose names match a pattern in \fIexternal_package_file\fR.
-.sp
-If \fB-e\fR is not specified, show the external dependencies of the resolved packages. External dependencies of the resolved packages are packages not named on the command line that are targets of dependencies in the resolved packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-Repeat the manifest, with any dependencies produced by the \fBgenerate\fR step removed, before adding the resolved dependencies.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR\fR
-.ad
-.sp .6
-.RS 4n
-Write the results to standard output. This option is intended for human consumption. Appending this output to a file might result in an invalid manifest. The \fB-d\fR or \fB-s\fR options are strongly recommended instead of \fB-o\fR for use in a pipeline for manifest processing.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIoutput_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Write the resolved dependencies for each manifest provided in a separate file in \fIoutput_dir\fR. By default, each file has the same base name as the manifest that was the source of the dependencies written to that file.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIsuffix\fR\fR
-.ad
-.sp .6
-.RS 4n
-For each output file, append \fIsuffix\fR to the base name of the file that was the source of the resolved dependencies. If \fIsuffix\fR is not \fI\&.suffix\fR, a period (.) is prepended to \fIsuffix\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-S\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only resolve against the manifests given on the command line and not against the manifests installed on the system.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Include additional package dependency debugging metadata.
-.RE
-
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRGenerate Dependencies
-.sp
-.LP
-Generate the dependencies for the manifest written in \fBfoo\fR, whose content directory is in \fB\&./bar/baz\fR, and store the results in \fBfoo.fdeps.\fR
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d ./bar/baz foo > foo.fdeps\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRResolve Dependencies
-.sp
-.LP
-Resolve the file dependencies in \fBfoo.fdeps\fR and \fBbar.fdeps\fR against each other and against the packages currently installed on the system.
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend resolve foo.fdeps bar.fdeps\fR
-$ \fBls *.res\fR
-foo.fdeps.res    bar.fdeps.res
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 3 \fRGenerate and Resolve Dependencies For Two Manifests
-.sp
-.LP
-Generate the file dependencies for two manifests (\fBfoo\fR and \fBbar\fR) and retain all the information in the original manifests. Then resolve the file dependencies and place the resulting manifests in \fB\&./res\fR. These resulting manifests can be used with \fBpkgsend publish\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d /proto/foo -m foo > ./deps/foo\fR
-$ \fBpkgdepend generate -d /proto/bar -m bar > ./deps/bar\fR
-$ \fBpkgdepend resolve -m -d ./res ./deps/foo ./deps/bar\fR
-$ \fBls ./res\fR
-foo    bar
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 4 \fRAdd Values To Tokens For ELF File Dependencies
-.sp
-.LP
-Replace all \fBPLATFORM\fR tokens in the run paths in ELF files with \fBsun4v\fR and \fBsun4u\fR while generating the dependencies for the manifest written in \fBfoo\fR whose content directory is in /.
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d / -D 'PLATFORM=sun4v' \e\fR
-\fB-D 'PLATFORM=sun4u' foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 5 \fRSpecify a Kernel Module Directory
-.sp
-.LP
-Specify \fB/kmod\fR as the directory in which to find kernel modules when generating the dependencies for the manifest written in \fBfoo\fR whose content directory is in /.
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d / -k /kmod foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 6 \fRBypass Dependency Generation
-.sp
-.LP
-Append \fBopt/python\fR to the standard Python run path for a given Python script, and bypass dependency generation against all Python modules called \fBtest\fR for a file delivered as \fBopt/python/foo/file.py\fR.
-
-.sp
-.LP
-Avoid generating dependencies against any file delivered in \fBusr/lib/python2.7/vendor-packages/xdg\fR.
-
-.sp
-.in +2
-.nf
-$ \fBcat manifest.py\fR
+<refentry id="pkgdepend-1">
+<refmeta><refentrytitle>pkgdepend</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">28 Jan 2015</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgdepend</refname><refpurpose>Image Packaging System dependency analyzer</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgdepend [<replaceable>options</replaceable>] <replaceable>command
+</replaceable> [<replaceable>cmd_options</replaceable>] [<replaceable>operands</replaceable>]
+</synopsis>
+<synopsis>/usr/bin/pkgdepend generate [-IMm] -d <replaceable>dir</replaceable> [-d <replaceable>
+dir</replaceable>]
+    [-D <replaceable>name</replaceable>=<replaceable>value</replaceable>] [-k <replaceable>
+path</replaceable>] <replaceable>manifest_file</replaceable></synopsis>
+<synopsis>/usr/bin/pkgdepend resolve [-EmoSv] [-d <replaceable>output_dir</replaceable>]
+    [-e <replaceable>external_package_file</replaceable>]... [-s <replaceable>suffix
+</replaceable>]
+    <replaceable>manifest_file</replaceable> ...</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgdepend-1-desc" role="description"><title></title>
+<para>The <command>pkgdepend</command> command generates and resolves dependencies
+for packages. A package might depend on files from other packages. The <command>pkgdepend
+</command> command is typically used in two passes: file dependency generation
+and file-to-package resolution.</para>
+<para>The <command>generate</command> subcommand examines the content of a
+package and determines what external files the package needs.</para>
+<para>The <command>resolve</command> subcommand takes the list of files from
+the <command>generate</command> step, and searches a reference set of packages
+to determine the names of the packages that contain those dependent files.
+The reference set of packages that are searched for the dependent files are
+the packages that are currently installed on the publisher's system.</para>
+<para>Several components of delivered files are used as sources of dependency
+information:</para>
+<variablelist>
+<varlistentry><term>ELF</term>
+<listitem><para>ELF headers in delivered files are analyzed for dependency information, with the
+<option>k</option> and <option>D</option> options modifying the information obtained. For more
+details on ELF dependencies, see <command>ldd</command> and the <olink targetdoc="OSLLG"><citetitle
+remap="book">Oracle Solaris 11.3 Linkers and Libraries Guide</citetitle></olink>. </para>
+</listitem>
+</varlistentry>
+<varlistentry><term>Scripts</term>
+<listitem><para>Shell scripts that contain <literal>#!</literal> lines referencing
+an interpreter result in a dependency on the package that delivers that interpreter.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>Python</term>
+<listitem><para>Python scripts are first analyzed as scripts. In addition,
+any imports the script declares might also serve as sources of dependency
+information.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>Hard links</term>
+<listitem><para>Hard links in manifests result in a dependency on the package
+that delivers the link target.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>SMF</term>
+<listitem><para>Delivered SMF service manifests that include <literal>require_all
+</literal> dependencies result in dependencies on the packages that deliver
+the SMF manifests that provide those FMRIs.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term>
+<listitem><para>Operate on the image rooted at <replaceable>dir</replaceable>.
+If no directory was specified or determined based on environment, the default
+is /. See the &ldquo;Environment Variables&rdquo; section for more information.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>The following subcommands are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgdepend generate</command> [<option>IMm</option>] <option>
+d</option> <replaceable>dir</replaceable> [<option>d</option> <replaceable>dir</replaceable>]
+[<option>D</option> <replaceable>name</replaceable>=<replaceable>value</replaceable>]
+[<option>k</option> <replaceable>path</replaceable>] <replaceable>manifest_file</replaceable></term>
+<listitem><para>Produce the dependencies on files of the manifest specified
+by <replaceable>manifest_file</replaceable>.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option></term>
+<listitem><para>Show the dependencies that are satisfied within <replaceable>manifest_file
+</replaceable>. Do not use the result of <option>I</option> with <command>pkgdepend resolve</command>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>M</option></term>
+<listitem><para>Display a list of file types that could not be analyzed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option></term>
+<listitem><para>Repeat the original manifest with any discovered dependencies
+added after.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>dir</replaceable></term>
+<listitem><para>Add <replaceable>dir</replaceable> to a list of directories
+to search for the manifest's files.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>D</option> <replaceable>name</replaceable>=<replaceable>
+value</replaceable></term>
+<listitem><para>Add the <replaceable>value</replaceable> as a way to expand
+the token <replaceable>name</replaceable> in run paths for ELF file dependencies.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>path</replaceable></term>
+<listitem><para>Add the <replaceable>path</replaceable> to the list of run
+paths to search for kernel modules. Using the <option>k</option> option removes
+the default paths, which are <filename>/kernel</filename> and <filename>/usr/kernel
+</filename>.</para>
+<para>Run paths such as those specified by the <option>k</option> option can
+also be specified per action or per manifest by using the action or manifest
+attribute <literal>pkg.depend.runpath</literal>. The value of the <literal>pkg.depend.runpath
+</literal> attribute is a colon-separated string of the paths to use. Setting
+any <literal>pkg.depend.runpath</literal> attributes in the manifest or action
+overrides paths specified with the <option>k</option> option.</para>
+<para>The special token <envar>$PKGDEPEND_RUNPATH</envar> can be used as one
+component of the <literal>pkg.depend.runpath</literal> attribute value in
+order to include the standard system run path for the file being analyzed.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>In some cases, you might want to prevent automatic generation of dependencies.
+For example, if a package delivers a sample Python script that imports a set
+of modules, those modules imported by the sample script are not dependencies
+for the package that delivers the sample script. Use the action or manifest
+attribute <literal>pkg.depend.bypass-generate</literal> to prevent generating
+dependencies against the specified files.</para>
+<para>The <literal>pkg.depend.bypass-generate</literal> values are Python
+regular expressions that match file names. The regular expressions are implicitly
+anchored at the start and end of the file path. The value given in the following
+example matches <literal>this/that</literal> but does not match <literal>something/this/that/the/other
+</literal>.</para>
+<programlisting>pkg.depend.bypass-generate=this/that</programlisting>
+<para>For more information about Python regular expression syntax, use the
+command <command>pydoc re</command> or see more complete documentation at <literal>
+http://docs.python.org/dev/howto/regex.html</literal>.</para>
+<para>When <command>pkgdepend generate</command> input manifests contain SMF
+manifest files, any SMF services or instances declared by those SMF manifest
+files are included in the <command>pkgdepend</command> output. These SMF services
+or instances are included in the form of a <literal>set</literal> action with
+the name <literal>org.opensolaris.smf.fmri</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgdepend resolve</command> [<option>EmoSv</option>]
+[<option>d</option> <replaceable>output_dir</replaceable>] [<option>e</option> <replaceable>
+external_package_file</replaceable>]... [<option>s</option> <replaceable>suffix</replaceable>] <replaceable>
+manifest_file</replaceable> ...</term>
+<listitem><para>Transform dependencies on files into dependencies on the packages
+that deliver those files. Dependencies are first resolved against the manifests
+given on the command line and then against the packages installed on the system.
+By default, the dependencies for each manifest are placed in a file named <filename><replaceable>
+manifest_file</replaceable>.res</filename>.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>e</option> <replaceable>external_package_file</replaceable></term>
+<listitem><para>Only resolve against packages from the system whose names
+match a pattern in <replaceable>external_package_file</replaceable>. This
+option can be specified multiple times. The <option>e</option> option cannot
+be used with the <option>S</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>E</option></term>
+<listitem><para>If <option>e</option> is specified, show the packages that
+were expected to be external dependencies but were not external dependencies.
+Packages that were expected to be external dependencies are packages from
+the system whose names match a pattern in <replaceable>external_package_file</replaceable>.
+</para>
+<para>If <option>e</option> is not specified, show the external dependencies
+of the resolved packages. External dependencies of the resolved packages are
+packages not named on the command line that are targets of dependencies in
+the resolved packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option></term>
+<listitem><para>Repeat the manifest, with any dependencies produced by the <command>
+generate</command> step removed, before adding the resolved dependencies.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option></term>
+<listitem><para>Write the results to standard output. This option is intended
+for human consumption. Appending this output to a file might result in an
+invalid manifest. The <option>d</option> or <option>s</option> options are
+strongly recommended instead of <option>o</option> for use in a pipeline for
+manifest processing.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>output_dir</replaceable></term>
+<listitem><para>Write the resolved dependencies for each manifest provided
+in a separate file in <replaceable>output_dir</replaceable>. By default, each
+file has the same base name as the manifest that was the source of the dependencies
+written to that file.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>suffix</replaceable></term>
+<listitem><para>For each output file, append <replaceable>suffix</replaceable> to
+the base name of the file that was the source of the resolved dependencies.
+If <replaceable>suffix</replaceable> is not <replaceable>.suffix</replaceable>,
+a period (.) is prepended to <replaceable>suffix</replaceable>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>S</option></term>
+<listitem><para>Only resolve against the manifests given on the command line
+and not against the manifests installed on the system.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>Include additional package dependency debugging metadata.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Generate Dependencies</title>
+<para>Generate the dependencies for the manifest written in <filename>foo</filename>,
+whose content directory is in <filename>./bar/baz</filename>, and store the
+results in <filename>foo.fdeps.</filename></para>
+<screen>$ <userinput>pkgdepend generate -d ./bar/baz foo > foo.fdeps</userinput></screen>
+</example>
+<example><title>Resolve Dependencies</title>
+<para>Resolve the file dependencies in <filename>foo.fdeps</filename> and <filename>
+bar.fdeps</filename> against each other and against the packages currently
+installed on the system.</para>
+<screen>$ <userinput>pkgdepend resolve foo.fdeps bar.fdeps</userinput>
+$ <userinput>ls *.res</userinput>
+foo.fdeps.res    bar.fdeps.res</screen>
+</example>
+<example><title>Generate and Resolve Dependencies For Two Manifests</title>
+<para>Generate the file dependencies for two manifests (<literal>foo</literal> and <literal>
+bar</literal>) and retain all the information in the original manifests. Then
+resolve the file dependencies and place the resulting manifests in <filename>./res
+</filename>. These resulting manifests can be used with <command>pkgsend publish</command>.
+</para>
+<screen>$ <userinput>pkgdepend generate -d /proto/foo -m foo > ./deps/foo</userinput>
+$ <userinput>pkgdepend generate -d /proto/bar -m bar > ./deps/bar</userinput>
+$ <userinput>pkgdepend resolve -m -d ./res ./deps/foo ./deps/bar</userinput>
+$ <userinput>ls ./res</userinput>
+foo    bar</screen>
+</example>
+<example><title>Add Values To Tokens For ELF File Dependencies</title>
+<para>Replace all <envar>PLATFORM</envar> tokens in the run paths in ELF files
+with <literal>sun4v</literal> and <literal>sun4u</literal> while generating
+the dependencies for the manifest written in <literal>foo</literal> whose
+content directory is in /.</para>
+<screen>$ <userinput>pkgdepend generate -d / -D 'PLATFORM=sun4v' &bsol;</userinput>
+<userinput>-D 'PLATFORM=sun4u' foo</userinput></screen>
+</example>
+<example><title>Specify a Kernel Module Directory</title>
+<para>Specify <filename>/kmod</filename> as the directory in which to find
+kernel modules when generating the dependencies for the manifest written in <filename>
+foo</filename> whose content directory is in /.</para>
+<screen>$ <userinput>pkgdepend generate -d / -k /kmod foo</userinput></screen>
+</example>
+<example><title>Bypass Dependency Generation</title>
+<para>Append <filename>opt/python</filename> to the standard Python run path
+for a given Python script, and bypass dependency generation against all Python
+modules called <literal>test</literal> for a file delivered as <filename>opt/python/foo/file.py
+</filename>.</para>
+<para>Avoid generating dependencies against any file delivered in <filename>usr/lib/python2.7/vendor-packages/xdg
+</filename>.</para>
+<screen>$ <userinput>cat manifest.py</userinput>
 set name=pkg.fmri value=pkg:/[email protected],1.0
 set name=pkg.summary value="My test package"
 dir path=opt mode=0755 group=sys owner=root
@@ -421,101 +294,85 @@
 #
 # Add runpath and bypass-generate attributes:
 #
-file path=opt/python/foo/file.py mode=0644 group=sys owner=root \e
-    pkg.depend.bypass-generate=.*/test.py.* \e
-    pkg.depend.bypass-generate=.*/testmodule.so \e
-    pkg.depend.bypass-generate=.*/test.so \e
-    pkg.depend.bypass-generate=usr/lib/python2.7/vendor-packages/xdg/.* \e
+file path=opt/python/foo/file.py mode=0644 group=sys owner=root &bsol;
+    pkg.depend.bypass-generate=.*/test.py.* &bsol;
+    pkg.depend.bypass-generate=.*/testmodule.so &bsol;
+    pkg.depend.bypass-generate=.*/test.so &bsol;
+    pkg.depend.bypass-generate=usr/lib/python2.7/vendor-packages/xdg/.* &bsol;
     pkg.depend.runpath=$PKGDEPEND_RUNPATH:/opt/python
 
-$ \fBpkgdepend generate -d proto manifest.py\fR
-.fi
-.in -2
-.sp
-
-.SH ENVIRONMENT VARIABLES
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_IMAGE\fR\fR
-.ad
-.RS 13n
-.rt  
-Specifies the directory that contains the image to use for package operations. This value is ignored if \fB-R\fR is specified.
-.RE
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Everything worked.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
+$ <userinput>pkgdepend generate -d proto manifest.py</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_IMAGE</envar></term>
+<listitem><para>Specifies the directory that contains the image to use for
+package operations. This value is ignored if <option>R</option> is specified.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Everything worked.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg
+</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkgdiff.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgdiff.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,218 +1,167 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgdiff 1 "26 Feb 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgdiff \- compare package manifests
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgdiff [-i \fIattribute\fR]... [-o \fIattribute\fR]
-    [-t \fIaction_name\fR[,\fIaction_name\fR]...]...
-    [-v \fIname\fR=\fIvalue\fR]... (\fIfile1\fR | -) (\fIfile2\fR | -)
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgdiff\fR compares two package manifests and reports differences. One of the manifests can be read from \fBstdin\fR by specifying \fB-\fR in place of the file name. \fBpkgdiff\fR sorts each manifest and action into a consistent order before comparison.
-.sp
-.LP
-Output is in the following form:
-.sp
-.ne 2
-.mk
-.na
-\fB+ \fIcomplete_action\fR\fR
-.ad
-.sp .6
-.RS 4n
-This action is in \fIfile2\fR but not in \fIfile1\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB- \fIcomplete_action\fR\fR
-.ad
-.sp .6
-.RS 4n
-This action is in \fIfile1\fR but not in \fIfile2\fR.
-.RE
-
-.sp
-.in +2
-.nf
-\fIactionname\fR \fIkeyvalue\fR [\fIvariant values, if any\fR]
-.fi
-.in -2
-
-.sp
-.ne 2
-.mk
-.na
-\fB- \fIattribute1\fR=\fIvalue1\fR\fR
-.ad
-.sp .6
-.RS 4n
-This \fIattribute\fR,\fIvalue\fR is in \fIfile1\fR but not in \fIfile2\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB+ \fIattribute2\fR=\fIvalue2\fR\fR
-.ad
-.sp .6
-.RS 4n
-This \fIattribute\fR,\fIvalue\fR is in \fIfile2\fR but not in \fIfile1\fR.
-.RE
-
-.sp
-.LP
-Actions with different variants but the same type and key attribute value are treated as separate actions for purposes of comparison. Thus, actions that change attributes are shown in their complete form rather than as attribute changes.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-Ignore \fIattribute\fR if present during comparisons. File hash values can be ignored with \fB-i\fR \fIhash\fR. This option cannot be used with the \fB-o\fR option. This option can be specified multiple times.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only report differences in \fIattribute\fR. This option cannot be used with the \fB-i\fR option. This option elides any action changes that do not affect \fIattribute\fR on an action.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR[,\fIaction_name\fR]...\fR
-.ad
-.sp .6
-.RS 4n
-Only compare the specified actions. Multiple actions can be specified in a comma-separated list. The value of \fIaction_name\fR is one of the actions listed in "Actions" in the \fBpkg\fR(5) man page. For example, the following values could be specified for \fIaction_name\fR: \fBfile\fR, \fBdir\fR, \fBdriver\fR, \fBdepend\fR, \fBset\fR. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR \fIname\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only compute differences for this variant value. For example, only compute differences for \fBarch=sparc\fR. This variant tag is removed for all actions before comparison. Only one value can be specified per variant. This option can be specified multiple times for different variants.
-.RE
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-No differences were found.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-Differences were found.
-.RE
+<refentry id="pkgdiff-1">
+<refmeta><refentrytitle>pkgdiff</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">26 Feb 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgdiff</refname><refpurpose>compare package manifests</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgdiff [-i <replaceable>attribute</replaceable>]... [-o <replaceable>attribute</replaceable>]
+    [-t <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]...
+    [-v <replaceable>name</replaceable>=<replaceable>value</replaceable>]... (<replaceable>file1</replaceable> | -) (<replaceable>file2</replaceable> | -)
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgdiff-1-desc" role="description"><title></title>
+<para><command>pkgdiff</command> compares two package manifests and reports differences. One of the
+manifests can be read from <literal>stdin</literal> by specifying <literal>-</literal> in place of
+the file name. <command>pkgdiff</command> sorts each manifest and action into a consistent order
+before comparison.</para>
+<para>Output is in the following form:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term>+ <replaceable>complete_action</replaceable></term>
+<listitem><para>This action is in <replaceable>file2</replaceable> but not
+in <replaceable>file1</replaceable>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>- <replaceable>complete_action</replaceable></term>
+<listitem><para>This action is in <replaceable>file1</replaceable> but not
+in <replaceable>file2</replaceable>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<programlisting><replaceable>actionname</replaceable> <replaceable>keyvalue</replaceable> [<replaceable>variant values, if any</replaceable>]</programlisting>
+<variablelist termlength="wholeline">
+<varlistentry><term>- <replaceable>attribute1</replaceable>=<replaceable>value1</replaceable></term>
+<listitem><para>This <replaceable>attribute</replaceable>,<replaceable>value</replaceable> is
+in <replaceable>file1</replaceable> but not in <replaceable>file2</replaceable>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>+ <replaceable>attribute2</replaceable>=<replaceable>value2</replaceable></term>
+<listitem><para>This <replaceable>attribute</replaceable>,<replaceable>value</replaceable> is
+in <replaceable>file2</replaceable> but not in <replaceable>file1</replaceable>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Actions with different variants but the same type and key attribute
+value are treated as separate actions for purposes of comparison. Thus, actions
+that change attributes are shown in their complete form rather than as attribute
+changes.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>attribute</replaceable></term>
+<listitem><para>Ignore <replaceable>attribute</replaceable> if present during comparisons. File hash values
+can be ignored with <option>i</option> <replaceable>hash</replaceable>. This option cannot be used
+with the <option>o</option> option. This option can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>attribute</replaceable></term>
+<listitem><para>Only report differences in <replaceable>attribute</replaceable>.
+This option cannot be used with the <option>i</option> option. This option
+elides any action changes that do not affect <replaceable>attribute</replaceable> on
+an action.</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>t</option> <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...</term>
+<listitem>
+<para>Only compare the specified actions. Multiple actions can be specified in a comma-separated
+list. The value of <replaceable>action_name</replaceable> is one of the actions listed in
+&ldquo;Actions&rdquo; in the <literal>pkg</literal>(5) man page. For example, the following values
+could be specified for <replaceable>action_name</replaceable>: <literal>file</literal>,
+<literal>dir</literal>, <literal>driver</literal>, <literal>depend</literal>,
+<literal>set</literal>. This option can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option> <replaceable>name</replaceable>=<replaceable>value</replaceable></term>
+<listitem><para>Only compute differences for this variant value. For example,
+only compute differences for <literal>arch=sparc</literal>. This variant tag
+is removed for all actions before comparison. Only one value can be specified
+per variant. This option can be specified multiple times for different variants.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>No differences were found.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>Differences were found.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg
+</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkgfmt.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgfmt.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,147 +1,124 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgfmt 1 "21 May 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgfmt \- format a package manifest
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgfmt [-c|-d|-u] [\fIpackage-manifest-file\fR]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgfmt\fR without the \fB-c\fR or \fB-d\fR options formats a package manifest in a consistent manner, including wrapping lines at 80 characters, sorting actions by type, and sorting attributes. Lines that do not parse into actions (such as macros, comments, or transforms) do not appear in sorted order.
-.sp
-.LP
-If no arguments are given, \fBpkgfmt\fR reads \fBstdin\fR until EOF, and then writes the formatted manifest to \fBstdout\fR. Any manifests specified on the command line are formatted in place.
-.sp
-.LP
-\fBpkgfmt\fR with the \fB-c\fR option checks whether the manifests are formatted in \fBpkgfmt\fR style. The \fB-d\fR option displays the differences if the file is not properly formatted.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.RS 10n
-.rt  
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR\fR
-.ad
-.RS 10n
-.rt  
-Check whether the manifest is formatted in the \fBpkgfmt\fR style.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.RS 10n
-.rt  
-Display manifest differences from the formatted version in unified form.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-u\fR\fR
-.ad
-.RS 10n
-.rt  
-Do not wrap lines at 80 characters. This option is useful for applying traditional text processing tools to package manifests.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-The \fB-c\fR or \fB-d\fR options were specified, and one or more manifests are not in \fBpkgfmt\fR normal form, or an error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
+<refentry id="pkgfmt-1">
+<refmeta><refentrytitle>pkgfmt</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">21 May 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgfmt</refname><refpurpose>format a package manifest</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgfmt [-c|-d|-u] [<replaceable>package-manifest-file</replaceable>]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgfmt-1-desc" role="description"><title></title>
+<para><command>pkgfmt</command> without the <option>c</option> or <option>d</option> options
+formats a package manifest in a consistent manner, including wrapping lines
+at 80 characters, sorting actions by type, and sorting attributes. Lines that
+do not parse into actions (such as macros, comments, or transforms) do not
+appear in sorted order.</para>
+<para>If no arguments are given, <command>pkgfmt</command> reads <literal>stdin</literal> until
+EOF, and then writes the formatted manifest to <literal>stdout</literal>.
+Any manifests specified on the command line are formatted in place.</para>
+<para><command>pkgfmt</command> with the <option>c</option> option checks
+whether the manifests are formatted in <command>pkgfmt</command> style. The <option>
+d</option> option displays the differences if the file is not properly formatted.
+</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist>
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option></term>
+<listitem><para>Check whether the manifest is formatted in the <command>pkgfmt</command> style.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term>
+<listitem><para>Display manifest differences from the formatted version in
+unified form.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>u</option></term>
+<listitem><para>Do not wrap lines at 80 characters. This option is useful
+for applying traditional text processing tools to package manifests.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>The <option>c</option> or <option>d</option> options were
+specified, and one or more manifests are not in <command>pkgfmt</command> normal
+form, or an error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkglint.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkglint.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,310 +1,217 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkglint 1 "02 Apr 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkglint \- Image Packaging System package lint
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkglint [-c \fIcache_dir\fR] [-r \fIrepo_uri\fR]... [-p \fIregexp\fR]
-    [-f \fIconfig_file\fR] [-b \fIbuild_no\fR] [-v]
-    [-l \fIlint_uri\fR] | \fImanifest\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkglint -L [-v]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkglint\fR runs a series of checks on one or more package manifests, optionally referencing another repository.
-.sp
-.LP
-\fBpkglint\fR should be used during the package authoring process, prior to package publication. \fBpkglint\fR performs exhaustive testing on the manifests that might be too expensive to perform during normal operation of \fBpkgsend\fR or \fBpkg.depotd\fR. \fBpkglint\fR checks include tests for duplicate actions, missing attributes, and unusual file permissions.
-.sp
-.LP
-Manifests for linting can be passed as a space-separated list of local files on the command line, or manifests can be retrieved from a repository.
-.sp
-.LP
-When retrieving manifests from repositories, on first run \fBpkglint\fR creates and populates \fBpkg\fR(5) user images in the specified cache directory. If the \fB-r\fR option is supplied, a user image named \fIcache_dir\fR\fB/ref_image\fR is created for the reference repository. If the \fB-l\fR option is supplied, a user image named \fIcache_dir\fR\fB/lint_image\fR is created for the lint repository. No content is installed in these images. These images are only used by \fBpkglint\fR to retrieve manifests from the repositories.
-.sp
-.LP
-Subsequent invocations of \fBpkglint\fR can reuse the cache directory and can omit any \fB-r\fR or \fB-l\fR arguments.
-.sp
-.LP
-\fBpkglint\fR provides limited support for configuring publishers in the cache directory. Use \fBpkg\fR to perform more complex publisher configuration on these images.
-.sp
-.LP
-\fBpkglint\fR allows package authors to bypass checks for a given manifest or action. A manifest or action that contains the attribute \fBpkg.linted\fR set to \fBTrue\fR does not produce any lint output for that manifest or action.
-.sp
-.LP
-More granular \fBpkg.linted\fR settings can be made using substrings of \fBpkglint\fR check names. For example, \fBpkg.linted.\fIcheck\fR.\fIid\fR\fR set to \fBTrue\fR bypasses all checks with the name \fB\fIcheck\fR.\fIid\fR\fR for the given manifest or action.
-.sp
-.LP
-The behavior of \fBpkglint\fR can be configured by specifying a\fBpkglintrc\fR file. By default, \fBpkglint\fR searches in \fB/usr/share/lib/pkg/pkglintrc\fR and \fB$HOME/.pkglintrc\fR for configuration options. Use the \fB-f\fR option to specify a different configuration file.
-.sp
-.LP
-During the lint run, any errors or warnings encountered are printed to \fBstderr\fR.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-b\fR \fIbuild_no\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a build number used to narrow the list of packages used during linting from lint and reference repositories. If no \fB-b\fR option is specified, the latest versions of packages are used. See also the \fBversion.pattern\fR configuration property.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a local directory used for caching package metadata from the lint and reference repositories.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR \fIlint_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a URI representing the location of the lint repository. Both HTTP and file system based publication are supported. If you specify \fB-l\fR, then you must also specify \fB-c\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-L\fR\fR
-.ad
-.sp .6
-.RS 4n
-List the known and excluded lint checks and then exit. Display the short name and description of each check. When combined with the \fB-v\fR flag, display the method that implements the check instead of the description.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR \fIconfig_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-Configure the \fBpkglint\fR session using the \fIconfig_file\fR configuration file.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIregexp\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a regular expression used to narrow the list of packages to be checked from the lint repository. All manifests from the reference repository are loaded (assuming they match the value for \fB-b\fR, if supplied), ignoring this pattern.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR \fIrepo_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a URI representing the location of the reference repository. If you specify \fB-r\fR, then you must also specify \fB-c\fR. The \fB-r\fR option can be specified multiple times.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Run \fBpkglint\fR in a verbose mode, overriding any \fBlog_level\fR settings in the configuration file.
-.RE
-
-.SH FILES
-.sp
-.LP
-The \fBpkglintrc\fR configuration file takes the following key/value arguments:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlog_level\fR\fR
-.ad
-.sp .6
-.RS 4n
-The minimum level at which to emit lint messages. Lint messages lower than this level are discarded. The default value is \fBINFO\fR.
-.sp
-Log levels in order of least to most severe are \fBDEBUG\fR, \fBINFO\fR, \fBWARNING\fR, \fBERROR\fR, and \fBCRITICAL\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdo_pub_checks\fR\fR
-.ad
-.sp .6
-.RS 4n
-If \fBTrue\fR, perform checks that might only make sense for published packages. The default value is \fBTrue\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkglint.ext.\fR*\fR
-.ad
-.sp .6
-.RS 4n
-The plugin mechanism of \fBpkglint\fR allows for additional lint modules to be added at runtime. Any key that starts with \fBpkglint.ext.\fR takes a value that must be a fully-specified Python module. See the "Developers" section for more information.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkglint.exclude\fR\fR
-.ad
-.sp .6
-.RS 4n
-A space-separated list of fully specified Python modules, classes, or function names to omit from the set of checks performed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuse_progress_tracker\fR\fR
-.ad
-.sp .6
-.RS 4n
-If \fBTrue\fR, use a progress tracker when iterating over manifests during lint runs. The default value is \fBTrue\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBversion.pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-A version pattern, used when specifying a build number to lint against (\fB-b\fR). If not specified in the configuration file, the \fB-b\fR option uses the pattern \fB*,5.11-0.\fR, matching all components of the 5.11 build, with a branch prefix of 0.
-.RE
-
-.SH DEVELOPERS
-.sp
-.LP
-To extend the set of checks performed by \fBpkglint\fR, subclass \fBpkg.lint.base.Checker\fR and its subclasses, \fBManifestChecker\fR, \fBActionChecker\fR, and \fBContentChecker\fR. Add the Python module name that contains those classes to a new \fBpkglint.ext.\fR key in the configuration file.
-.sp
-.LP
-Instances of those new subclasses are created by \fBpkglint\fR on startup. Methods inside each subclass with the special keyword argument \fBpkglint_id\fR are invoked during the course of the lint session. Those methods should have the same signature as the corresponding \fBcheck()\fR method in the super class. Methods should also be assigned a \fBpkglint_desc\fR attribute, which is used as the description printed by \fBpkglint -L\fR.
-.sp
-.LP
-Parameters are available to \fBChecker\fR subclasses, allowing them to tune their behavior. The recommended parameter naming convention is \fB\fIpkglint_id\fR.\fIname\fR\fR. Parameter values can be stored in the configuration file, or accessed in manifests or actions retrieved using the \fBLintEngine.get_param()\fR method. When accessing parameters from the manifest, the prefix \fBpkg.lint\fR is prepended to the key name to ensure that \fBpkglint\fR parameters do not overlap with any existing action or manifest values.
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRFirst Run on a Particular Repository
-.sp
-.LP
-Running a \fBpkglint\fR session for the first time on a given repository.
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache -r http://localhost:10000 mymanifest.mf\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRSubsequent Run on the Same Repository
-.sp
-.LP
-A subsequent run against the same repository used in Example 1.
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache mymanifest-fixed.mf\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 3 \fRUsing a Lint Repository With a Narrowed Manifest Set
-.sp
-.LP
-Running a \fBpkglint\fR session with a lint repository and specifying a subset of manifests to check.
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/othercache -l http://localhost:10000 \e\fR
-\fB-p '.*firefox.*'\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 4 \fRSpecifying a Build
-.sp
-.LP
-Running a \fBpkglint\fR session against a given build in verbose mode.
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache -r http://localhost:10000 \e\fR
-\fB-l http://localhost:12000 -b 147 -v\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 5 \fRModifying a Configuration File
-.sp
-.LP
-A configuration file with a new lint module, excluding some checks.
-
-.sp
-.in +2
-.nf
-$ \fBcat ~/.pkglintrc\fR
+<refentry id="pkglint-1">
+<refmeta><refentrytitle>pkglint</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">29 Apr 2014</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2014, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkglint</refname><refpurpose>Image Packaging System package lint</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkglint [-c <replaceable>cache_dir</replaceable>] [-r <replaceable>
+repo_uri</replaceable>]... [-p <replaceable>regexp</replaceable>]
+    [-f <replaceable>config_file</replaceable>] [-b <replaceable>build_no</replaceable>] [-v]
+    [-l <replaceable>lint_uri</replaceable>]... | <replaceable>manifest</replaceable> ...
+</synopsis>
+<synopsis>/usr/bin/pkglint -L [-v]</synopsis>
+</refsynopsisdiv>
+<refsect1 role="description"><title></title>
+<para><command>pkglint</command> runs a series of checks on one or more package
+manifests, optionally referencing another repository.</para>
+<para><command>pkglint</command> should be used during the package authoring
+process, prior to package publication. <command>pkglint</command> performs
+exhaustive testing on the manifests that might be too expensive to perform
+during normal operation of <command>pkgsend</command> or <command>pkg.depotd</command>. <command>
+pkglint</command> checks include tests for duplicate actions, missing attributes,
+and unusual file permissions.</para>
+<para>Manifests for linting can be passed as a space-separated list of local
+files on the command line, or manifests can be retrieved from a repository.</para>
+<para>When retrieving manifests from repositories, on first run <command>pkglint</command> creates
+and populates <literal>pkg</literal>(5) user images in the specified cache
+directory. If the <option>r</option> option is supplied, a user image named <replaceable>
+cache_dir</replaceable><literal>/ref_image</literal> is created for the reference
+repository. If the <option>l</option> option is supplied, a user image named <replaceable>
+cache_dir</replaceable><literal>/lint_image</literal> is created for the lint
+repository. No content is installed in these images. These images are only
+used by <command>pkglint</command> to retrieve manifests from the repositories.</para>
+<para>Subsequent invocations of <command>pkglint</command> can reuse the cache
+directory and can omit any <option>r</option> or <option>l</option> arguments.</para>
+<para><command>pkglint</command> provides limited support for configuring
+publishers in the cache directory. Use <command>pkg</command> to perform more
+complex publisher configuration on these images.</para>
+<para><command>pkglint</command> allows package authors to bypass checks for
+a given manifest or action. A manifest or action that contains the attribute <literal>
+pkg.linted</literal> set to <literal>True</literal> does not produce any lint
+output for that manifest or action.</para>
+<para>More granular <literal>pkg.linted</literal> settings can be made using
+substrings of <command>pkglint</command> check names. For example, <literal>pkg.linted.<replaceable>
+check</replaceable>.<replaceable>id</replaceable></literal> set to <literal>True</literal> bypasses
+all checks with the name <literal><replaceable>check</replaceable>.<replaceable>id
+</replaceable></literal> for the given manifest or action.</para>
+<para>The behavior of <command>pkglint</command> can be configured by specifying
+a<filename>pkglintrc</filename> file. By default, <command>pkglint</command> searches
+in <filename>/usr/share/lib/pkg/pkglintrc</filename> and <filename>$HOME/.pkglintrc
+</filename> for configuration options. Use the <option>f</option> option to
+specify a different configuration file.</para>
+<para>During the lint run, any errors or warnings encountered are printed
+to <filename>stderr</filename>.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>b</option> <replaceable>build_no</replaceable></term>
+<listitem><para>Specify a build number used to narrow the list of packages
+used during linting from lint and reference repositories. If no <option>b</option> option
+is specified, the latest versions of packages are used. See also the <literal>version.pattern
+</literal> configuration property.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>Specify a local directory used for caching package metadata
+from the lint and reference repositories.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option> <replaceable>lint_uri</replaceable></term>
+<listitem><para>Specify a URI representing the location of the lint repository.
+Both HTTP and file system based publication are supported. If you specify
+<option>l</option>, then you must also specify <option>c</option>. The
+<option>l</option> option can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>L</option></term>
+<listitem><para>List the known and excluded lint checks and then exit. Display
+the short name and description of each check. When combined with the <option>v</option> flag,
+display the method that implements the check instead of the description.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>f</option> <replaceable>config_file</replaceable></term>
+<listitem><para>Configure the <command>pkglint</command> session using the <replaceable>
+config_file</replaceable> configuration file.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>regexp</replaceable></term>
+<listitem><para>Specify a regular expression used to narrow the list of packages
+to be checked from the lint repository. All manifests from the reference repository
+are loaded (assuming they match the value for <option>b</option>, if supplied),
+ignoring this pattern.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option> <replaceable>repo_uri</replaceable></term>
+<listitem><para>Specify a URI representing the location of the reference repository.
+If you specify <option>r</option>, then you must also specify <option>c</option>.
+The <option>r</option> option can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>Run <command>pkglint</command> in a verbose mode, overriding
+any <literal>log_level</literal> settings in the configuration file.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para>The <filename>pkglintrc</filename> configuration file takes the following
+key/value arguments:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>log_level</literal></term>
+<listitem><para>The minimum level at which to emit lint messages. Lint messages
+lower than this level are discarded. The default value is <literal>INFO</literal>.
+</para>
+<para>Log levels in order of least to most severe are <literal>DEBUG</literal>, <literal>
+INFO</literal>, <literal>WARNING</literal>, <literal>ERROR</literal>, and <literal>
+CRITICAL</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>do_pub_checks</literal></term>
+<listitem><para>If <literal>True</literal>, perform checks that might only
+make sense for published packages. The default value is <literal>True</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkglint.ext.</literal>*</term>
+<listitem><para>The plugin mechanism of <command>pkglint</command> allows
+for additional lint modules to be added at runtime. Any key that starts with <literal>
+pkglint.ext.</literal> takes a value that must be a fully-specified Python
+module. See the &ldquo;Developers&rdquo; section for more information.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkglint.exclude</literal></term>
+<listitem><para>A space-separated list of fully specified Python modules,
+classes, or function names to omit from the set of checks performed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>use_progress_tracker</literal></term>
+<listitem><para>If <literal>True</literal>, use a progress tracker when iterating
+over manifests during lint runs. The default value is <literal>True</literal>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>version.pattern</literal></term>
+<listitem><para>A version pattern, used when specifying a build number to
+lint against (<option>b</option>). If not specified in the configuration file,
+the <option>b</option> option uses the pattern <literal>*,5.11-0.</literal>,
+matching all components of the 5.11 build, with a branch prefix of 0.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>Developers</title>
+<para>To extend the set of checks performed by <command>pkglint</command>,
+subclass <literal>pkg.lint.base.Checker</literal> and its subclasses, <literal>ManifestChecker
+</literal>, <literal>ActionChecker</literal>, and <literal>ContentChecker</literal>.
+Add the Python module name that contains those classes to a new <literal>pkglint.ext.
+</literal> key in the configuration file.</para>
+<para>Instances of those new subclasses are created by <command>pkglint</command> on
+startup. Methods inside each subclass with the special keyword argument <literal>
+pkglint_id</literal> are invoked during the course of the lint session. Those
+methods should have the same signature as the corresponding <function>check</function> method
+in the super class. Methods should also be assigned a <literal>pkglint_desc</literal> attribute,
+which is used as the description printed by <command>pkglint -L</command>.</para>
+<para>Parameters are available to <literal>Checker</literal> subclasses, allowing
+them to tune their behavior. The recommended parameter naming convention is <literal><replaceable>
+pkglint_id</replaceable>.<replaceable>name</replaceable></literal>. Parameter
+values can be stored in the configuration file, or accessed in manifests or
+actions retrieved using the <function>LintEngine.get_param</function> method.
+When accessing parameters from the manifest, the prefix <literal>pkg.lint</literal> is
+prepended to the key name to ensure that <command>pkglint</command> parameters
+do not overlap with any existing action or manifest values.</para>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>First Run on a Particular Repository</title>
+<para>Running a <command>pkglint</command> session for the first time on a
+given repository.</para>
+<screen>$ <userinput>pkglint -c /space/cache -r http://localhost:10000 mymanifest.mf</userinput></screen>
+</example>
+<example><title>Subsequent Run on the Same Repository</title>
+<para>A subsequent run against the same repository used in Example 1.</para>
+<screen>$ <userinput>pkglint -c /space/cache mymanifest-fixed.mf</userinput></screen>
+</example>
+<example><title>Using a Lint Repository With a Narrowed Manifest Set</title>
+<para>Running a <command>pkglint</command> session with a lint repository
+and specifying a subset of manifests to check.</para>
+<screen>$ <userinput>pkglint -c /space/othercache -l http://localhost:10000 &bsol;</userinput>
+<userinput>-p '.*firefox.*'</userinput></screen>
+</example>
+<example><title>Specifying a Build</title>
+<para>Running a <command>pkglint</command> session against a given build in
+verbose mode.</para>
+<screen>$ <userinput>pkglint -c /space/cache -r http://localhost:10000 &bsol;</userinput>
+<userinput>-l http://localhost:12000 -b 147 -v</userinput></screen>
+</example>
+<example><title>Modifying a Configuration File</title>
+<para>A configuration file with a new lint module, excluding some checks.</para>
+<screen>$ <userinput>cat ~/.pkglintrc</userinput>
 [pkglint]
 
 log_level = DEBUG
@@ -314,82 +221,75 @@
 pkglint.ext.opensolaris = pkg.lint.opensolaris
 pkglint.exclude: pkg.lint.opensolaris.OpenSolarisActionChecker
 pkg.lint.pkglint.PkgActionChecker.unusual_perms pkg.lint.pkglint.PkgManifestChecker
-pkg.lint.opensolaris.OpenSolarisManifestChecker
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-One or more package manifests contain lint errors.
-.RE
+pkg.lint.opensolaris.OpenSolarisManifestChecker</screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>One or more package manifests contain lint errors.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>An error occurred that is not a lint error in a manifest. For example, an invalid command line option might have been specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg
+</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink
+targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd
+</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink
+targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle>
+<manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman"
+targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum>
+</citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred that is not a lint error in a manifest. For example, an invalid command line option might have been specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(1), \fBpkg.depotd\fR(1M), \fBpkgsend\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkgmerge.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgmerge.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,468 +1,268 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgmerge 1 "14 Nov 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgmerge \- Image Packaging System package merging utility
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgmerge [-n] -d \fIdest_repo\fR
-    [-p \fIpublisher_prefix\fR]...
-    -s \fIvariant\fR=\fIvalue\fR[,...],\fIsrc_repo\fR ...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgmerge\fR is a package publication tool for creating multi-variant packages. It does this by merging packages with identical names and versions (excluding time stamp), tagging actions that are unique in the versions being merged with the specified variant name and value for the given source, and then publishing the new packages to the target repository. Only the newest version of every package from each source is used.
-.sp
-.LP
-If an action has the attribute \fBpkg.merge.blend\fR set to the name of the variant being merged, that action is copied to the other manifests prior to merging so that the action appears without any added variant tags in the final output. Note that the attribute \fBpkg.merge.blend\fR itself is removed from any actions in the output manifest. This attribute can be repeated with different values for multiple pass merges.
-.sp
-.LP
-Non-identical actions that deliver to the same path in an input manifest result in \fBpkgmerge\fR exiting with an error.
-.sp
-.LP
-After a \fBpkgmerge\fR operation, if your destination repository must support \fBpkg search\fR operations, run \fBpkgrepo refresh\fR on the repository to update search indexes.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIdest_repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the file system path or URI of the target repository to publish the merged packages to. The target repository must already exist. New repositories can be created using \fBpkgrepo\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run with no changes made to the target repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher_prefix\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the name of the publisher from which to merge packages. This option can be specified multiple times.
-.sp
-By default, packages from all publishers in all source repositories are merged.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIvariant\fR=\fIvalue\fR[,...],\fIsrc_repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the variant name and value to use for packages from this source, followed by the file system path or URI of the source repository or package archive to retrieve packages from. Multiple variants can be specified separated by commas. The same variants must be named for all sources. This option can be specified multiple times.
-.RE
-
-.SH OPERANDS
-.sp
-.LP
-The following operand is supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specifies packages to merge. The \fIpkg_fmri_pattern\fR operand can include the \fB?\fR and \fB*\fR characters as \fBglob\fR(3C)-style wildcards to match one or more packages.
-.RE
-
-.SH ENVIRONMENT VARIABLES
-.sp
-.LP
-The following environment variable is supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBTMPDIR\fR\fR
-.ad
-.RS 10n
-.rt  
-The absolute path of the directory where temporary data should be stored during program execution. If not set, the default is to store temporary data in \fB/var/tmp\fR.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRSpecify Variant Name and Value
-.sp
-.LP
-Tag each package found in the specified source with the given variant name and value specified for the source it was retrieved from:
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src.example.com \e\fR
-\fB-d http://dest.example.com\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Sample package:
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Sample package after operation:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+<refentry id="pkgmerge-1">
+<refmeta><refentrytitle>pkgmerge</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">14 Nov 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgmerge</refname><refpurpose>Image Packaging System package merging utility</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgmerge [-n] -d <replaceable>dest_repo</replaceable>
+    [-p <replaceable>publisher_prefix</replaceable>]...
+    -s <replaceable>variant</replaceable>=<replaceable>value</replaceable>[,...],<replaceable>src_repo</replaceable> ...
+    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgmerge-1-desc" role="description"><title></title>
+<para><command>pkgmerge</command> is a package publication tool for creating
+multi-variant packages. It does this by merging packages with identical names
+and versions (excluding time stamp), tagging actions that are unique in the
+versions being merged with the specified variant name and value for the given
+source, and then publishing the new packages to the target repository. Only
+the newest version of every package from each source is used.</para>
+<para>If an action has the attribute <literal>pkg.merge.blend</literal> set
+to the name of the variant being merged, that action is copied to the other
+manifests prior to merging so that the action appears without any added variant
+tags in the final output. Note that the attribute
+<literal>pkg.merge.blend</literal> itself is removed from any actions in the
+output manifest. This attribute can be repeated with different values for
+multiple pass merges.</para>
+<para>Non-identical actions that deliver to the same path in an input manifest
+result in <command>pkgmerge</command> exiting with an error.</para>
+<para>After a <command>pkgmerge</command> operation, if your destination
+repository must support <command>pkg search</command> operations, run
+<command>pkgrepo refresh</command> on the repository to update search indexes.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>dest_repo</replaceable></term>
+<listitem><para>Specify the file system path or URI of the target repository
+to publish the merged packages to. The target repository must already exist.
+New repositories can be created using <command>pkgrepo</command>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run with no changes made to the target repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher_prefix</replaceable></term>
+<listitem><para>Specify the name of the publisher from which to merge packages.
+This option can be specified multiple times.</para>
+<para>By default, packages from all publishers in all source repositories are merged.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>variant</replaceable>=<replaceable>value</replaceable>[,...],<replaceable>src_repo</replaceable></term>
+<listitem><para>Specify the variant name and value to use for packages from
+this source, followed by the file system path or URI of the source repository
+or package archive to retrieve packages from. Multiple variants can be specified
+separated by commas. The same variants must be named for all sources. This
+option can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="operands"><title></title>
+<para>The following operand is supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>Specifies packages to merge. The
+<replaceable>pkg_fmri_pattern</replaceable> operand can include the
+<literal>?</literal> and <literal>*</literal> characters as
+<literal>glob</literal>(3C)-style wildcards to match one or more packages.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<para>The following environment variable is supported:</para>
+<variablelist>
+<varlistentry><term><envar>TMPDIR</envar></term>
+<listitem><para>The absolute path of the directory where temporary data should
+be stored during program execution. If not set, the default is to store temporary
+data in <filename>/var/tmp</filename>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Specify Variant Name and Value</title>
+<para>Tag each package found in the specified source with the given variant
+name and value specified for the source it was retrieved from:</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src.example.com &bsol;</userinput>
+<userinput>-d http://dest.example.com</userinput></screen>
+<para>Sample package:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Sample package after operation:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fBExample 2 \fRMerge and Publish Packages
-.sp
-.LP
-Merge the newest version of each package from the given sources and publish the new packages to the target repository:
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src1.example.com \e\fR
-\fB-s arch=i386,http://src2.example.com \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Sample package from source 1 (SPARC):
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Sample package from source 2 (i386):
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Merged package:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example><title>Merge and Publish Packages</title>
+<para>Merge the newest version of each package from the given sources and
+publish the new packages to the target repository:</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src1.example.com &bsol;</userinput>
+<userinput>-s arch=i386,http://src2.example.com &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>Sample package from source 1 (SPARC):</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Sample package from source 2 (i386):</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Merged package:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc value=i386
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fBExample 3 \fRMerge Debug and Non-Debug Packages for i386 and SPARC Systems
-.sp
-.LP
-Merge the newest version of each package in a set of debug and non-debug repositories for i386 and SPARC systems:
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,debug=false,/repo/sparc-nondebug \e\fR
-\fB-s arch=sparc,debug=true,/repo/sparc-debug \e\fR
-\fB-s arch=i386,debug=false,/repo/i386-nondebug \e\fR
-\fB-s arch=i386,debug=true,/repo/i386-debug \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Sample package from source 1 (SPARC non-debug):
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Sample package from source 2 (SPARC debug):
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121411Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Sample package from source 3 (i386 non-debug):
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Sample package from source 4 (i386 debug):
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Merged package:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example><title>Merge Debug and Non-Debug Packages for i386 and SPARC Systems</title>
+<para>Merge the newest version of each package in a set of debug and non-debug
+repositories for i386 and SPARC systems:</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,debug=false,/repo/sparc-nondebug &bsol;</userinput>
+<userinput>-s arch=sparc,debug=true,/repo/sparc-debug &bsol;</userinput>
+<userinput>-s arch=i386,debug=false,/repo/i386-nondebug &bsol;</userinput>
+<userinput>-s arch=i386,debug=true,/repo/i386-debug &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>Sample package from source 1 (SPARC non-debug):</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Sample package from source 2 (SPARC debug):</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121411Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Sample package from source 3 (i386 non-debug):</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Sample package from source 4 (i386 debug):</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Merged package:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
 set name=variant.arch value=sparc value=i386
 set name=variant.debug value=false value=true
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=false
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=true
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=false
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=true
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fBExample 4 \fRMerge Using \fBpkg.merge.blend\fR
-.sp
-.LP
-Merge packages for two architectures that do not collide, using the \fBpkg.merge.blend\fR attribute.
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src1/example.com \e\fR
-\fB-s arch=i386,http://src2.example.com \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Sample package from source 1 (SPARC):
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root \e
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=false
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=true
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=false
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=true
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example id="GLFDD"><title>Merge Using <literal>pkg.merge.blend</literal></title>
+<para>Merge packages for two architectures that do not collide, using the <literal>
+pkg.merge.blend</literal> attribute.</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src1/example.com &bsol;</userinput>
+<userinput>-s arch=i386,http://src2.example.com &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>Sample package from source 1 (SPARC):</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/sparc/foo pkg.merge.blend=arch
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Sample package from source 2 (i386):
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root \e
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Sample package from source 2 (i386):</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root &bsol;
     group=bin path=usr/bin/i386/foo pkg.merge.blend=arch
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Merged package:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Merged package:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc value=i386
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root \e
+file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root &bsol;
     group=bin path=usr/bin/i386/foo
-file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root \e
+file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/sparc/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fBExample 5 \fRMerge Packages With Different Publisher Prefixes
-.sp
-.LP
-Merge only packages with the \fBdev\fR prefix, even though other packages in these repositories have the \fBexample.com\fR prefix.
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -p dev -s arch=sparc,http://src1.example.com \e
--s arch=i386,http://src2.example.com \e
--d /path/to/target/repository\fR
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkgrepo\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example id="differentpubs"><title>Merge Packages With Different Publisher Prefixes</title>
+<para>Merge only packages with the <literal>dev</literal> prefix, even though other packages in these repositories have the <literal>example.com</literal> prefix.</para>
+<screen>$ <userinput>pkgmerge -p dev -s arch=sparc,http://src1.example.com &bsol;
+-s arch=i386,http://src2.example.com &bsol;
+-d /path/to/target/repository</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="PKDEV"><citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
--- a/src/man/pkgmogrify.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgmogrify.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,624 +1,419 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgmogrify 1 "12 Jul 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgmogrify \- Image Packaging System manifest transmogrifier
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgmogrify [-vi] [-I \fIincludedir\fR]...
-    [-D \fImacro\fR=\fIvalue\fR]... [-O \fIoutputfile\fR]
-    [-P \fIprintfile\fR] [\fIinputfile\fR ...]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgmogrify\fR provides for programmatic editing of package manifests to simplify the typical transformations needed when automating software builds and package publication.
-.sp
-.LP
-\fBpkgmogrify\fR provides the following:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Macro replacement to facilitate sharing of a single manifest across various architectures and platforms.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Inclusion of other manifests or manifest fragments such as standard components and transforms.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Transformation of package actions, including the modification, deletion, or addition of action attributes.
-.RE
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-D\fR \fImacro\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Define \fImacro\fR as a macro, with the value \fIvalue\fR. This option can be specified multiple times. Macros appear in the input file as \fB$(macro)\fR. Substitution is repeated until no more translations are found. Common idioms include:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Elimination of lines in a manifest on other architectures by using an architecture-specific tag at the beginning of the line:
-.sp
-.in +2
-.nf
-$(sparc_ONLY)file ...
-.fi
-.in -2
-
-When processing the SPARC architecture, this macro would be set to the empty string. When processing other architectures, this macro would be set to \fB#\fR on the command line, thus eliminating this action from the manifest on the current architecture.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Specifying platform-specific portions of path names, such as the name of the 64-bit architecture directory for executables and libraries:
-.sp
-.in +2
-.nf
-file path=usr/bin/$(ARCH64)/cputrack ...
-.fi
-.in -2
-
-These macros should be set to the desired value on the command line. There are no predefined macro values.
-.RE
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR \fIincludedir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the specified directory to the search path, both for files specified on the command line and for embedded include directives. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-O\fR \fIoutputfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-Write manifest output to the specified file. The file is not written if an error occurs or if a transform directive causes an abort operation. By default, manifest output is written to \fBstdout\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR \fIprintfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-Write output resulting from transform directive print operations to the specified file. The file is not written if an error occurs or if a transform directive causes an abort operation. By default, print output is written to \fBstdout\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-Ignore include directives in files. Only files specified on the command line (or \fBstdin\fR) are processed.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Write comments into the output manifest showing the effect of transforms. This information can aid in debugging.
-.RE
-
-.SH EMBEDDED DIRECTIVES
-.sp
-.LP
-Two types of directives are supported in manifest files: include directives and transform directives.
-.sp
-.LP
-Include directives are of the form:
-.sp
-.in +2
-.nf
-<include \fIfile\fR>
-.fi
-.in -2
-
-.sp
-.LP
-This directive causes \fBpkgmogrify\fR to search for a file named \fBfile\fR first in the current directory and then in the directories specified with the \fB-I\fR option. If found, the contents of the file are inserted into the manifest at the point at which the directive is encountered. If not found, \fBpkgmogrify\fR exits with an error.
-.sp
-.LP
-Transform directives are of the form:
-.sp
-.in +2
-.nf
-<transform \fImatching-criteria\fR -> \fIoperation\fR>
-.fi
-.in -2
-
-.sp
-.LP
-These directives are accumulated until all inputs have been read into memory, and then applied to the actions in the order in which they were encountered.
-.sp
-.LP
-Matching criteria are of the form:
-.sp
-.in +2
-.nf
-[\fIaction-name\fR ... ] [\fIattribute\fR=<\fIvalue-regexp\fR> ...]
-.fi
-.in -2
-
-.sp
-.LP
-At least one specified \fIaction-name\fR must match. Every specified \fIattribute\fR must match. Action names and attributes are listed in "Actions" in the \fBpkg\fR(5) man page. The regular expression syntax used is that of Python. For more information about Python regular expression syntax, use the command \fBpydoc re\fR or see more complete documentation at \fBhttp://docs.python.org/dev/howto/regex.html\fR. The regular expression is anchored at the beginning but not at the end. Therefore, a regular expression matching files by their extensions must include a leading \fB\&.*\fR and should include a trailing \fB$\fR.
-.sp
-.LP
-Multiple criteria can be specified, separated by spaces.
-.sp
-.LP
-The following operations are available:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBadd\fR\fR
-.ad
-.RS 11n
-.rt  
-Add a value to an attribute. This operation takes two arguments. The first argument is the name of the attribute, and the second is the value.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.RS 11n
-.rt  
-Set the value of an attribute if it doesn't already exist. This operation takes the same two arguments as the \fBadd\fR operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdelete\fR\fR
-.ad
-.RS 11n
-.rt  
-Remove attribute values. This operation takes two arguments. The first argument is the name of the attribute. The second argument is a regular expression to match the attribute values deleted. Unlike the regular expression used to match an action, this expression is unanchored.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdrop\fR\fR
-.ad
-.RS 11n
-.rt  
-Discards this action.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBedit\fR\fR
-.ad
-.RS 11n
-.rt  
-Modifies an attribute of the action. This operation takes three arguments. The first argument is the name of the attribute, and the second is a regular expression matching the attribute value. The third argument is the replacement string substituted for the portion of the value matched by the regular expression. Unlike the regular expression used to match an action, this expression is unanchored. Normal regular expression backreferences, of the form \fB\e1\fR, \fB\e2\fR, and so on, are available in the replacement string if groups are defined in the regular expression.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBemit\fR\fR
-.ad
-.RS 11n
-.rt  
-Emit a line to the manifest output stream. This must be a valid action string, empty (resulting in a blank line), or a comment (a \fB#\fR followed by arbitrary text).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexit\fR\fR
-.ad
-.RS 11n
-.rt  
-Terminate manifest processing. No manifest is output and no \fBprint\fR operations are applied. If one argument is given, it must be an integer, and it is used as the exit code. The default is 0. If two arguments are given, the first is the exit code, and the second is a message to be printed to \fBstderr\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBprint\fR\fR
-.ad
-.RS 11n
-.rt  
-Print a message to the output file specified with \fB-P\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBset\fR\fR
-.ad
-.RS 11n
-.rt  
-Set the value of an attribute. This operation takes the same two arguments as the \fBadd\fR operation.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.LP
-All operations except for \fBdelete\fR and \fBdrop\fR take (possibly optional) arguments whose contents go to the output stream. These strings can contain three different kinds of special tokens which allow the output to contain information that is not based on a fixed transformation of each action.
-.sp
-.LP
-The first kind of substitution allows the operation to refer to the values of attributes of the current action by putting the name of the attribute inside parentheses following a percent sign. For example, \fB%(alias)\fR refers to the value of the action's \fBalias\fR attribute.
-.sp
-.LP
-Several synthetic attributes exist. Two are unique to \fBpkgmogrify\fR:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBpkg.manifest.filename\fR refers to the name of the file in which the action was found.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBpkg.manifest.lineno\fR refers to the line on which the action was found.
-.RE
-.sp
-.LP
-Three synthetic attributes are similar to ones used in \fBpkg\fR:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.hash\fR refers to the hash value of the action if the action carries a payload. For actions with payloads, the \fBset\fR operation can change the hash of the action by operating on the \fBaction.hash\fR attribute.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.key\fR refers to the value of the key attribute.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.name\fR refers to the name of the action.
-.RE
-.sp
-.LP
-If the attribute whose value is requested does not exist, \fBpkgmogrify\fR exits with an error. To prevent exiting with an error, follow the attribute name with \fB;notfound=\fR and a value to substitute in place of the attribute value. For example, \fB%(alias;notfound='no alias')\fR prints the value of the attribute \fBalias\fR if it exists, and prints \fBno alias\fR otherwise.
-.sp
-.LP
-If the attribute whose value is requested is multi-valued, each value is printed, separated by spaces. Similarly to the \fBnotfound\fR token, the tokens \fBprefix\fR, \fBsuffix\fR, and \fBsep\fR can be used to change this behavior. The string denoted by \fBprefix\fR is prepended to each value, the string denoted by \fBsuffix\fR is appended to each value, and \fBsep\fR is placed in between the suffix of one value and the prefix of the next.
-.sp
-.LP
-Similarly to action attributes, \fBpkgmogrify\fR directives can reference package attributes using braces instead of parentheses: \fB%{pkg.fmri}\fR. At the point at which the transform directive is applied, the attribute must have been defined in a \fBset\fR action, or it is treated as \fBnotfound\fR, described above. When the processing reaches the end of the manifest file describing the package, the attributes are cleared for the next package.
-.sp
-.LP
-It is useful not only to reference package attributes as if they were action attributes, but also to match on them, and even temporarily modify them. Therefore a synthetic action name, \fBpkg\fR, is available (only in the context of \fBpkgmogrify\fR) for use in these situations.
-.sp
-.LP
-When \fBpkgmogrify\fR finishes reading a manifest specified on the command line and that manifest defined a \fBpkg.fmri\fR package attribute, \fBpkgmogrify\fR creates this synthetic \fBpkg\fR action, whose attributes are the package's attributes. A \fB<transform>\fR directive can then match on this action, just as it can match on any other action.
-.sp
-.LP
-Operations on a \fBpkg\fR action are special in that they take place only in memory and do not directly affect the emitted manifest. For instance, trying to set an attribute on a \fBpkg\fR action via the \fBadd\fR, \fBdefault\fR, or \fBset\fR operations does not result in a \fBset\fR action being added to the manifest, though it will be available for other \fB<transform>\fR directives to match on. Attempting to \fBemit\fR a \fBpkg\fR action causes an error. To add a package attribute, \fBemit\fR a \fBset\fR action instead.
-.sp
-.LP
-The third kind of substitution is a backreference. This substitution is not like the ones usable in the \fBedit\fR operation, but is a reference to groups listed in the transformation match on the left-hand side of the \fB->\fR. These are indicated by \fB%<1>\fR, \fB%<2>\fR, and so on, in the order seen in the matching criteria.
-.sp
-.LP
-The order of processing is as follows:
-.RS +4
-.TP
-1.
-Lines are read from input files.
-.RE
-.RS +4
-.TP
-2.
-Macros are applied.
-.RE
-.RS +4
-.TP
-3.
-\fB<include ...>\fR and \fB<transform>\fR directives are processed, causing additional files to be found and read.
-.RE
-.RS +4
-.TP
-4.
-Once all input has been accumulated, each line in the input is converted into actions and all transforms applied.
-.RE
-.RS +4
-.TP
-5.
-Once processing is complete and successful, the output is written.
-.RE
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRAdd Tags To SMF Manifests
-.sp
-.LP
-Add tags to Service Management Facility (SMF) manifests so they get imported when the package is installed on a live system.
-
-.sp
-.in +2
-.nf
-<transform file path=(var|lib)/svc/manifest/.*\e.xml -> \e
-    add restart_fmri svc:/system/manifest-import:default>
-.fi
-.in -2
-
-.LP
-\fBExample 2 \fRMove Files
-.sp
-.LP
-Move files from \fBusr/sfw/bin\fR to \fBusr/bin\fR.
-
-.sp
-.in +2
-.nf
-<transform file -> edit path usr/sfw/bin usr/bin>
-.fi
-.in -2
-
-.LP
-\fBExample 3 \fRSpecify Reboot Needed
-.sp
-.LP
-Add \fBreboot-needed\fR tags to files under \fB/kernel\fR that are not \fB\&.conf\fR files. Note that this example leverages how transforms are applied to each action in the order seen in the input files.
-
-.sp
-.in +2
-.nf
-<transform file path=kernel/.* -> set reboot-needed true>
-<transform file path=kernel/.*\e.conf -> delete reboot-needed .*>
-.fi
-.in -2
-
-.sp
-.LP
-This can also be done in a single transform rule with regular expressions.
-
-.LP
-\fBExample 4 \fRConvert FMRI Attribute To Depend Action
-.sp
-.LP
-Convert the package attribute \fBpkg.fmri\fR into a \fBdepend\fR action to become part of an incorporation.
-
-.sp
-.in +2
-.nf
-<transform set name=pkg.fmri -> \e
+<refentry id="pkgmogrify-1">
+<refmeta><refentrytitle>pkgmogrify</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">12 Jul 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgmogrify</refname><refpurpose>Image Packaging System manifest transmogrifier
+</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgmogrify [-vi] [-I <replaceable>includedir</replaceable>]...
+    [-D <replaceable>macro</replaceable>=<replaceable>value</replaceable>]... [-O <replaceable>
+outputfile</replaceable>]
+    [-P <replaceable>printfile</replaceable>] [<replaceable>inputfile</replaceable> ...]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="GKVND" role="description"><title></title>
+<para><command>pkgmogrify</command> provides for programmatic editing of package
+manifests to simplify the typical transformations needed when automating software
+builds and package publication.</para>
+<itemizedlist>
+<para><command>pkgmogrify</command> provides the following:</para>
+<listitem><para>Macro replacement to facilitate sharing of a single manifest
+across various architectures and platforms.</para></listitem>
+<listitem><para>Inclusion of other manifests or manifest fragments such as
+standard components and transforms.</para></listitem>
+<listitem><para>Transformation of package actions, including the modification,
+deletion, or addition of action attributes.</para></listitem>
+</itemizedlist>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>D</option> <replaceable>macro</replaceable>=<replaceable>
+value</replaceable></term>
+<listitem><para>Define <replaceable>macro</replaceable> as a macro, with the
+value <replaceable>value</replaceable>. This option can be specified multiple
+times. Macros appear in the input file as <literal>$(macro)</literal>. Substitution
+is repeated until no more translations are found. Common idioms include:</para>
+<itemizedlist>
+<listitem><para>Elimination of lines in a manifest on other architectures
+by using an architecture-specific tag at the beginning of the line:</para>
+<programlisting>$(sparc_ONLY)file ...</programlisting>
+<para>When processing the SPARC architecture, this macro would be set to the
+empty string. When processing other architectures, this macro would be set
+to <literal>#</literal> on the command line, thus eliminating this action
+from the manifest on the current architecture.</para>
+</listitem>
+<listitem><para>Specifying platform-specific portions of path names, such
+as the name of the 64-bit architecture directory for executables and libraries:</para>
+<programlisting>file path=usr/bin/$(ARCH64)/cputrack ...</programlisting>
+<para>These macros should be set to the desired value on the command line.
+There are no predefined macro values.</para>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>I</option> <replaceable>includedir</replaceable></term>
+<listitem><para>Add the specified directory to the search path, both for files
+specified on the command line and for embedded include directives. This option
+can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>O</option> <replaceable>outputfile</replaceable></term>
+<listitem><para>Write manifest output to the specified file. The file is not
+written if an error occurs or if a transform directive causes an abort operation.
+By default, manifest output is written to <filename>stdout</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option> <replaceable>printfile</replaceable></term>
+<listitem><para>Write output resulting from transform directive print operations
+to the specified file. The file is not written if an error occurs or if a
+transform directive causes an abort operation. By default, print output is
+written to <filename>stdout</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option></term>
+<listitem><para>Ignore include directives in files. Only files specified on
+the command line (or <filename>stdin</filename>) are processed.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>Write comments into the output manifest showing the effect
+of transforms. This information can aid in debugging.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>Embedded Directives</title>
+<para>Two types of directives are supported in manifest files: include directives
+and transform directives.</para>
+<para>Include directives are of the form:</para>
+<programlisting>&lt;include <replaceable>file</replaceable>></programlisting>
+<para>This directive causes <command>pkgmogrify</command> to search for a
+file named <literal>file</literal> first in the current directory and then
+in the directories specified with the <option>I</option> option. If found,
+the contents of the file are inserted into the manifest at the point at which
+the directive is encountered. If not found, <command>pkgmogrify</command> exits
+with an error.</para>
+<para>Transform directives are of the form:</para>
+<programlisting>&lt;transform <replaceable>matching-criteria</replaceable> -> <replaceable>
+operation</replaceable>></programlisting>
+<para>These directives are accumulated until all inputs have been read into
+memory, and then applied to the actions in the order in which they were encountered.
+</para>
+<para>Matching criteria are of the form:</para>
+<programlisting>[<replaceable>action-name</replaceable> ... ] [<replaceable>attribute
+</replaceable>=&lt;<replaceable>value-regexp</replaceable>> ...]</programlisting>
+<para>At least one specified <replaceable>action-name</replaceable> must match.
+Every specified <replaceable>attribute</replaceable> must match. Action names
+and attributes are listed in &ldquo;Actions&rdquo; in the <literal>pkg</literal>(5)
+man page. The regular expression syntax used is that of Python. For more information
+about Python regular expression syntax, use the command <command>pydoc re</command> or
+see more complete documentation at <literal>http://docs.python.org/dev/howto/regex.html
+</literal>. The regular expression is anchored at the beginning but not at
+the end. Therefore, a regular expression matching files by their extensions
+must include a leading <literal>.*</literal> and should include a trailing <literal>
+$</literal>.</para>
+<para>Multiple criteria can be specified, separated by spaces.</para>
+<para>The following operations are available:</para>
+<variablelist>
+<varlistentry><term><literal>add</literal></term>
+<listitem><para>Add a value to an attribute. This operation takes two arguments.
+The first argument is the name of the attribute, and the second is the value.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>Set the value of an attribute if it doesn't already exist.
+This operation takes the same two arguments as the <command>add</command> operation.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>delete</literal></term>
+<listitem><para>Remove attribute values. This operation takes two arguments.
+The first argument is the name of the attribute. The second argument is a
+regular expression to match the attribute values deleted. Unlike the regular
+expression used to match an action, this expression is unanchored.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>drop</literal></term>
+<listitem><para>Discards this action.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>edit</literal></term>
+<listitem><para>Modifies an attribute of the action. This operation takes
+three arguments. The first argument is the name of the attribute, and the
+second is a regular expression matching the attribute value. The third argument
+is the replacement string substituted for the portion of the value matched
+by the regular expression. Unlike the regular expression used to match an
+action, this expression is unanchored. Normal regular expression backreferences,
+of the form <literal>&bsol;1</literal>, <literal>&bsol;2</literal>, and so
+on, are available in the replacement string if groups are defined in the regular
+expression.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>emit</literal></term>
+<listitem><para>Emit a line to the manifest output stream. This must be a
+valid action string, empty (resulting in a blank line), or a comment (a <literal>
+#</literal> followed by arbitrary text).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exit</literal></term>
+<listitem><para>Terminate manifest processing. No manifest is output and no <literal>
+print</literal> operations are applied. If one argument is given, it must
+be an integer, and it is used as the exit code. The default is 0. If two arguments
+are given, the first is the exit code, and the second is a message to be printed
+to <filename>stderr</filename>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>print</literal></term>
+<listitem><para>Print a message to the output file specified with <option>P</option>.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>set</literal></term>
+<listitem><para>Set the value of an attribute. This operation takes the same
+two arguments as the <command>add</command> operation.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>All operations except for <literal>delete</literal> and <literal>drop</literal> take
+(possibly optional) arguments whose contents go to the output stream. These
+strings can contain three different kinds of special tokens which allow the
+output to contain information that is not based on a fixed transformation
+of each action.</para>
+<para>The first kind of substitution allows the operation to refer to the
+values of attributes of the current action by putting the name of the attribute
+inside parentheses following a percent sign. For example, <literal>%(alias)</literal> refers
+to the value of the action's <literal>alias</literal> attribute.</para>
+<itemizedlist>
+<para>Several synthetic attributes exist. Two are unique to <command>pkgmogrify</command>:
+</para>
+<listitem><para><literal>pkg.manifest.filename</literal> refers to the name
+of the file in which the action was found.</para></listitem>
+<listitem><para><literal>pkg.manifest.lineno</literal> refers to the line
+on which the action was found.</para></listitem>
+</itemizedlist>
+<itemizedlist>
+<para>Three synthetic attributes are similar to ones used in <command>pkg</command>:
+</para>
+<listitem><para><literal>action.hash</literal> refers to the hash value of
+the action if the action carries a payload. For actions with payloads, the <literal>
+set</literal> operation can change the hash of the action by operating on
+the <literal>action.hash</literal> attribute.</para></listitem>
+<listitem><para><literal>action.key</literal> refers to the value of the key
+attribute.</para></listitem>
+<listitem><para><literal>action.name</literal> refers to the name of the action.</para>
+</listitem>
+</itemizedlist>
+<para>If the attribute whose value is requested does not exist, <command>pkgmogrify
+</command> exits with an error. To prevent exiting with an error, follow the
+attribute name with <literal>;notfound=</literal> and a value to substitute
+in place of the attribute value. For example, <literal>%(alias;notfound='no
+alias')</literal> prints the value of the attribute <literal>alias</literal> if
+it exists, and prints <literal>no alias</literal> otherwise.</para>
+<para>If the attribute whose value is requested is multi-valued, each value
+is printed, separated by spaces. Similarly to the <literal>notfound</literal> token,
+the tokens <literal>prefix</literal>, <literal>suffix</literal>, and <literal>sep
+</literal> can be used to change this behavior. The string denoted by <literal>prefix
+</literal> is prepended to each value, the string denoted by <literal>suffix</literal> is
+appended to each value, and <literal>sep</literal> is placed in between the
+suffix of one value and the prefix of the next.</para>
+<para>Similarly to action attributes, <command>pkgmogrify</command> directives
+can reference package attributes using braces instead of parentheses: <literal>%{pkg.fmri}
+</literal>. At the point at which the transform directive is applied, the
+attribute must have been defined in a <literal>set</literal> action, or it
+is treated as <literal>notfound</literal>, described above. When the processing
+reaches the end of the manifest file describing the package, the attributes
+are cleared for the next package.</para>
+<para>It is useful not only to reference package attributes as if they were
+action attributes, but also to match on them, and even temporarily modify
+them. Therefore a synthetic action name, <literal>pkg</literal>, is available
+(only in the context of <command>pkgmogrify</command>) for use in these situations.
+</para>
+<para>When <command>pkgmogrify</command> finishes reading a manifest specified
+on the command line and that manifest defined a <literal>pkg.fmri</literal> package
+attribute, <command>pkgmogrify</command> creates this synthetic <literal>pkg</literal> action,
+whose attributes are the package's attributes. A <literal>&lt;transform></literal> directive
+can then match on this action, just as it can match on any other action.</para>
+<para>Operations on a <literal>pkg</literal> action are special in that they
+take place only in memory and do not directly affect the emitted manifest.
+For instance, trying to set an attribute on a <literal>pkg</literal> action
+via the <literal>add</literal>, <literal>default</literal>, or <literal>set</literal> operations
+does not result in a <literal>set</literal> action being added to the manifest,
+though it will be available for other <literal>&lt;transform></literal> directives
+to match on. Attempting to <literal>emit</literal> a <literal>pkg</literal> action
+causes an error. To add a package attribute, <literal>emit</literal> a <literal>set
+</literal> action instead.</para>
+<para>The third kind of substitution is a backreference. This substitution
+is not like the ones usable in the <literal>edit</literal> operation, but
+is a reference to groups listed in the transformation match on the left-hand
+side of the <literal>-></literal>. These are indicated by <literal>%&lt;1></literal>, <literal>
+%&lt;2></literal>, and so on, in the order seen in the matching criteria.</para>
+<orderedlist>
+<para>The order of processing is as follows:</para>
+<listitem><para>Lines are read from input files.</para></listitem>
+<listitem><para>Macros are applied.</para></listitem>
+<listitem><para><literal>&lt;include ...></literal> and <literal>&lt;transform></literal> directives
+are processed, causing additional files to be found and read.</para></listitem>
+<listitem><para>Once all input has been accumulated, each line in the input
+is converted into actions and all transforms applied.</para></listitem>
+<listitem><para>Once processing is complete and successful, the output is
+written.</para></listitem>
+</orderedlist></refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Add Tags To SMF Manifests</title>
+<para>Add tags to Service Management Facility (SMF) manifests so they get
+imported when the package is installed on a live system.</para>
+<programlisting>&lt;transform file path=(var|lib)/svc/manifest/.*&bsol;.xml -> &bsol;
+    add restart_fmri svc:/system/manifest-import:default></programlisting>
+</example>
+<example><title>Move Files</title>
+<para>Move files from <filename>usr/sfw/bin</filename> to <filename>usr/bin</filename>.
+</para>
+<programlisting>&lt;transform file -> edit path usr/sfw/bin usr/bin></programlisting>
+</example>
+<example><title>Specify Reboot Needed</title>
+<para>Add <literal>reboot-needed</literal> tags to files under <filename>/kernel</filename> that
+are not <filename>.conf</filename> files. Note that this example leverages
+how transforms are applied to each action in the order seen in the input files.</para>
+<programlisting>&lt;transform file path=kernel/.* -> set reboot-needed true>
+&lt;transform file path=kernel/.*&bsol;.conf -> delete reboot-needed .*></programlisting>
+<para>This can also be done in a single transform rule with regular expressions.</para>
+</example>
+<example><title>Convert FMRI Attribute To Depend Action</title>
+<para>Convert the package attribute <literal>pkg.fmri</literal> into a <literal>depend
+</literal> action to become part of an incorporation.</para>
+<programlisting>&lt;transform set name=pkg.fmri -> &bsol;
     emit depend type=incorporate fmri=%(value)>
-<transform set name=pkg.fmri -> drop>
-.fi
-.in -2
-
-.LP
-\fBExample 5 \fRPrint a List of Bug Numbers
-.sp
-.LP
-Print a comma-separated list of quoted and prefixed bug numbers.
+&lt;transform set name=pkg.fmri -> drop></programlisting>
+</example>
+<example><title>Print a List of Bug Numbers</title>
+<para>Print a comma-separated list of quoted and prefixed bug numbers.</para>
+<programlisting>set name=bugs value=12345 value=54321 value=13579 value=97531
+&lt;transform set name=bugs -> &bsol;
+    print %(value;sep=",";prefix="bug='";suffix="'")></programlisting>
+</example>
+<example><title>Allow For Missing Attributes</title>
+<para>Safely print a message even when an attribute is missing.</para>
+<programlisting>&lt;transform driver -> print Found aliases: %(alias;notfound=&lt;none>)>
+</programlisting>
+</example>
+<example><title>Set Default Values</title>
+<para>Set default owner, group, and permission values.</para>
+<programlisting>&lt;transform file dir -> default owner root>
+&lt;transform file dir -> default group bin>
+&lt;transform file -> default mode 0444>
+&lt;transform dir -> default mode 0755></programlisting>
+</example>
+<example><title>Add Dependencies To Packages That Are Not Marked Obsolete</title>
+<para>For any package that is not marked obsolete, add a dependency on the
+incorporation for the consolidation that delivers the package. This set of
+transforms must occur after the manifest has been read in, or the dependency
+will always be emitted. Because modifying a <literal>pkg</literal> action
+has no permanent effect, there is no need to clean up attributes matching <literal>
+pkg.obsolete=false</literal>.</para>
+<programlisting>&lt;transform pkg -> default pkg.obsolete false>
+&lt;transform pkg pkg.obsolete=false -> emit depend &bsol;
+    fmri=consolidation/$(CONS)/$(CONS)-incorporation type=require></programlisting>
+</example>
+<example><title>Exit and Print a Message When an Error Is Found</title>
+<para>Error out with a message when an obsolete attribute is found in a manifest.
+</para>
+<programlisting>&lt;transform file dir link hardlink opensolaris.zone=.* -> &bsol;
+    exit 1 The opensolaris.zone attribute is obsolete.></programlisting>
+</example>
+<example><title>Set the Appropriate Locale Facet</title>
+<para>Set the locale facet appropriate for the path name under consideration.</para>
+<programlisting>&lt;transform dir file link hardlink path=.*/locale/([^/]+).* -> &bsol;
+    default facet.locale.%&lt;1> true></programlisting>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Everything worked.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>Something bad but anticipated happened.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>Unexpected processing error.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>/usr/share/pkg/transforms</filename></term>
+<listitem><para>This directory contains files with useful transforms to set
+facets, actuators, and other attributes.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg
+</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink
+targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle>
+<manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-set name=bugs value=12345 value=54321 value=13579 value=97531
-<transform set name=bugs -> \e
-    print %(value;sep=",";prefix="bug='";suffix="'")>
-.fi
-.in -2
-
-.LP
-\fBExample 6 \fRAllow For Missing Attributes
-.sp
-.LP
-Safely print a message even when an attribute is missing.
-
-.sp
-.in +2
-.nf
-<transform driver -> print Found aliases: %(alias;notfound=<none>)>
-.fi
-.in -2
-
-.LP
-\fBExample 7 \fRSet Default Values
-.sp
-.LP
-Set default owner, group, and permission values.
-
-.sp
-.in +2
-.nf
-<transform file dir -> default owner root>
-<transform file dir -> default group bin>
-<transform file -> default mode 0444>
-<transform dir -> default mode 0755>
-.fi
-.in -2
-
-.LP
-\fBExample 8 \fRAdd Dependencies To Packages That Are Not Marked Obsolete
-.sp
-.LP
-For any package that is not marked obsolete, add a dependency on the incorporation for the consolidation that delivers the package. This set of transforms must occur after the manifest has been read in, or the dependency will always be emitted. Because modifying a \fBpkg\fR action has no permanent effect, there is no need to clean up attributes matching \fBpkg.obsolete=false\fR.
-
-.sp
-.in +2
-.nf
-<transform pkg -> default pkg.obsolete false>
-<transform pkg pkg.obsolete=false -> emit depend \e
-    fmri=consolidation/$(CONS)/$(CONS)-incorporation type=require>
-.fi
-.in -2
-
-.LP
-\fBExample 9 \fRExit and Print a Message When an Error Is Found
-.sp
-.LP
-Error out with a message when an obsolete attribute is found in a manifest.
-
-.sp
-.in +2
-.nf
-<transform file dir link hardlink opensolaris.zone=.* -> \e
-    exit 1 The opensolaris.zone attribute is obsolete.>
-.fi
-.in -2
-
-.LP
-\fBExample 10 \fRSet the Appropriate Locale Facet
-.sp
-.LP
-Set the locale facet appropriate for the path name under consideration.
-
-.sp
-.in +2
-.nf
-<transform dir file link hardlink path=.*/locale/([^/]+).* -> \e
-    default facet.locale.%<1> true>
-.fi
-.in -2
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Everything worked.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-Something bad but anticipated happened.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-Unexpected processing error.
-.RE
-
-.SH FILES
-.sp
-.ne 2
-.mk
-.na
-\fB\fB/usr/share/pkg/transforms\fR\fR
-.ad
-.sp .6
-.RS 4n
-This directory contains files with useful transforms to set facets, actuators, and other attributes.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkgrecv.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgrecv.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,378 +1,250 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgrecv 1 "21 Nov 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgrecv \- Image Packaging System content retrieval utility
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgrecv [-aknrv] [-s (\fIsrc_path\fR|\fIsrc_uri\fR)]
-    [-d (\fIdest_path\fR|\fIdest_uri\fR)] [-c \fIcache_dir\fR]
-    [-m \fImatch\fR] [--raw]
-    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR]
-    [--dkey \fIdest_key\fR --dcert \fIdest_cert\fR]
-    (\fIfmri\fR|\fIpattern\fR) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrecv [-s (\fIsrc_path\fR|\fIsrc_uri\fR)] --newest
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrecv [-nv] [-s (\fIsrc_path\fR|\fIsrc_uri\fR)]
-    [-d (\fIdest_path\fR|\fIdest_uri\fR)] [-p \fIpublisher\fR]...
-    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR] --clone
-.fi
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgrecv\fR retrieves all versions of each matching \fIfmri\fR or \fIpattern\fR from the \fBpkg\fR(5) repository or package archive specified by the \fB-s\fR option and optionally republishes the retrieved packages to the package repository or package archive specified by the \fB-d\fR option. By default, packages are retrieved in package repository format suitable for use with \fBpkg\fR, \fBpkg.depotd\fR, and package publication tools.
-.sp
-.LP
-Packages that have not changed are not republished. Therefore, the time to update an existing repository depends on the number of new and changed packages.
-.sp
-.LP
-Use the \fB-m\fR option to specify whether to retrieve all versions of each matching package, or only the newest version of each matching package.
-.sp
-.LP
-If you do not specify \fB\&'*'\fR to be retrieved, you might want to specify the \fB-r\fR option to be sure to retrieve all the dependencies of the specified packages.
-.LP
-Note - 
-.sp
-.RS 2
-Do not use multiple instances of \fBpkgrecv\fR simultaneously to republish packages to the same destination repository or archive. In this case, newly received packages could contain duplicate actions.
-.RE
-.sp
-.LP
-After a \fBpkgrecv\fR operation that retrieves packages into a \fIdest_uri\fR, if the \fIdest_uri\fR repository must support \fBpkg search\fR operations, run \fBpkgrepo refresh\fR on that repository to update search indexes.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-Store the retrieved package data in a \fBpkg\fR(5) archive at the location specified by the \fB-d\fR option. The file specified by \fB-d\fR cannot already exist. The \fB-a\fR option can be used only with file system based destinations. Although not required, using a file extension of \fB\&.p5p\fR (for example, \fBarchive.p5p\fR) is strongly suggested. The \fB-a\fR option cannot be combined with the \fB--raw\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the path to a directory that will be used to cache downloaded content. If this directory is not supplied, the client automatically selects a cache directory. In the case where a download is interrupted, and a cache directory was automatically chosen, use this option to resume the download. See the "Environment Variables" section below for details about how to set the location used for temporary data storage.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR (\fIdest_path\fR|\fIdest_uri\fR)\fR
-.ad
-.sp .6
-.RS 4n
-Specify the file system path or URI where the retrieved packages should be republished. If \fB-a\fR  is specified, this destination must be a package archive that does not already exist. If \fB-a\fR  is not specified, this destination must be a package repository that already exists. Use the \fBpkgrepo\fR command to create a new package repository. If \fB-d\fR is not specified, the value of \fBPKG_DEST\fR is used. See "Environment Variables" below.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR\fR
-.ad
-.sp .6
-.RS 4n
-Keep the retrieved package content compressed. This option is ignored when republishing. Compressed package content should not be used with \fBpkgsend\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR \fImatch\fR\fR
-.ad
-.sp .6
-.RS 4n
-Control which versions of packages are retrieved if \fIpattern\fR is specified or if \fIfmri\fR is not fully specified. For this description, the following four example packages exist in the source specified by the \fB-s\fR option. In these FMRI, the characters between the \fB@\fR and the \fB:\fR denote the numbered package version, and the characters from the \fB:\fR to the end denote the timestamp portion of the version string.
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+<refentry id="pkgrecv-1">
+<refmeta><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">21 Nov 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgrecv</refname>
+<refpurpose>Image Packaging System content retrieval utility</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgrecv [-aknrv] [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)]
+    [-d (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)] [-c <replaceable>cache_dir</replaceable>]
+    [-m <replaceable>match</replaceable>] [--raw]
+    [--key <replaceable>src_key</replaceable> --cert <replaceable>src_cert</replaceable>]
+    [--dkey <replaceable>dest_key</replaceable> --dcert <replaceable>dest_cert</replaceable>]
+    (<replaceable>fmri</replaceable>|<replaceable>pattern</replaceable>) ...</synopsis>
+<synopsis>/usr/bin/pkgrecv [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)] --newest</synopsis>
+<synopsis>/usr/bin/pkgrecv [-nv] [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)]
+    [-d (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)] [-p <replaceable>publisher</replaceable>]...
+    [--key <replaceable>src_key</replaceable> --cert <replaceable>src_cert</replaceable>] --clone
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgrecv-1-desc" role="description"><title></title>
+<para><command>pkgrecv</command> retrieves all versions of each matching
+<replaceable>fmri</replaceable> or <replaceable>pattern</replaceable> from the
+<literal>pkg</literal>(5) repository or package archive specified by the
+<option>s</option> option and optionally republishes the retrieved packages to
+the package repository or package archive specified by the <option>d</option>
+option. By default, packages are retrieved in package repository format suitable
+for use with <command>pkg</command>, <command>pkg.depotd</command>, and package
+publication tools.</para>
+<para>Packages that have not changed are not republished. Therefore, the time
+to update an existing repository depends on the number of new and changed
+packages.</para>
+<para>Use the <option>m</option> option to specify whether to retrieve all
+versions of each matching package, or only the newest version of each matching
+package.</para>
+<para>If you do not specify <literal>'*'</literal> to be retrieved, you might
+want to specify the <option>r</option> option to be sure to retrieve all the
+dependencies of the specified packages.</para>
+<note><para>Do not use multiple instances of <command>pkgrecv</command> simultaneously
+to republish packages to the same destination repository or archive. In this
+case, newly received packages could contain duplicate actions.</para></note>
+<para>After a <command>pkgrecv</command> operation that retrieves packages
+into a <replaceable>dest_uri</replaceable>, if the <replaceable>dest_uri</replaceable> repository
+must support <command>pkg search</command> operations, run <command>pkgrepo refresh</command>
+on that repository to update search indexes.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>Store the retrieved package data in a <literal>pkg</literal>(5)
+archive at the location specified by the <option>d</option> option. The file
+specified by <option>d</option> cannot already exist. The <option>a</option> option
+can be used only with file system based destinations. Although not required,
+using a file extension of <literal>.p5p</literal> (for example, <literal>archive.p5p
+</literal>) is strongly suggested. The <option>a</option> option cannot be
+combined with the <option>-raw</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>Specify the path to a directory that will be used to cache
+downloaded content. If this directory is not supplied, the client automatically
+selects a cache directory. In the case where a download is interrupted, and
+a cache directory was automatically chosen, use this option to resume the
+download. See the &ldquo;Environment Variables&rdquo; section below for details
+about how to set the location used for temporary data storage.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)</term>
+<listitem><para>Specify the file system path or URI where the retrieved packages
+should be republished. If <option>a</option>  is specified, this destination
+must be a package archive that does not already exist. If <option>a</option> 
+is not specified, this destination must be a package repository that already
+exists. Use the <command>pkgrepo</command> command to create a new package
+repository. If <option>d</option> is not specified, the value of <envar>PKG_DEST</envar> is
+used. See &ldquo;Environment Variables&rdquo; below.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option></term>
+<listitem><para>Keep the retrieved package content compressed. This option
+is ignored when republishing. Compressed package content should not be used
+with <command>pkgsend</command>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option> <replaceable>match</replaceable></term>
+<listitem><para>Control which versions of packages are retrieved if
+<replaceable>pattern</replaceable> is specified or if
+<replaceable>fmri</replaceable> is not fully specified. For this description,
+the following four example packages exist in the source specified by the
+<option>s</option> option. In these FMRI, the characters between the
+<literal>@</literal> and the <literal>:</literal> denote the numbered package
+version, and the characters from the <literal>:</literal> to the end denote the
+timestamp portion of the version string.</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120903T170234Z
 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120819T155007Z
-.fi
-.in -2
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBall-timestamps\fR\fR
-.ad
-.sp .6
-.RS 4n
-Retrieve all versions of each matching \fIfmri\fR or \fIpattern\fR (implies \fBall-versions\fR). This is the default behavior if the \fB-m\fR option is not specified. In the example above, all four packages are retrieved.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBall-versions\fR\fR
-.ad
-.sp .6
-.RS 4n
-Retrieve the latest timestamp for each version of each matching \fIfmri\fR or \fIpattern\fR. In the example above, the following two packages are retrieved:
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z
-.fi
-.in -2
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlatest\fR\fR
-.ad
-.sp .6
-.RS 4n
-Retrieve only the newest version of each matching \fIfmri\fR or \fIpattern\fR. In the example above, only the following package is retrieved:
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
-.fi
-.in -2
-
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run with no changes made.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only clone the specified publisher. This option can be specified multiple times. The \fB-p\fR option is valid only with the \fB--clone\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-Recursively retrieve all dependencies for each matching \fIfmri\fR or \fIpattern\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR (\fIsrc_path\fR|\fIsrc_uri\fR)\fR
-.ad
-.sp .6
-.RS 4n
-Specify the file system path or URI of a \fBpkg\fR(5) repository or package archive from which to receive package data. If \fB-s\fR is not specified, the value of \fBPKG_SRC\fR is used. See "Environment Variables" below.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display verbose output, including the number of packages retrieved and their full FMRIs, the number of files retrieved, and the estimated size of the transfer.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIsrc_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a client SSL key file to use for package retrieval from the source HTTPS repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cert\fR \fIsrc_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a client SSL certificate file to use for package retrieval from the source HTTPS repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--dkey\fR \fIdest_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a client SSL key file to use for package publication to the destination HTTPS repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--dcert\fR \fIdest_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify a client SSL certificate file to use for package publication to the destination HTTPS repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--clone\fR\fR
-.ad
-.sp .6
-.RS 4n
-Make an exact copy of the source repository. By default, the clone operation succeeds only if publishers in the source repository are also present in the destination. To limit the clone operation to specified publishers, use the \fB-p\fR option. Publishers specified by using the \fB-p\fR option are added to the destination repository if they are not already present. Packages that are in the destination repository but not in the source repository are removed. The clone operation leaves the destination repository altered if an error occurs. Therefore, the destination repository should be in its own ZFS dataset, and a snapshot should be created prior to performing the clone operation.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--newest\fR\fR
-.ad
-.sp .6
-.RS 4n
-List the most recent versions of the packages available from the repository specified by the \fB-s\fR option. All other options are ignored.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--raw\fR\fR
-.ad
-.sp .6
-.RS 4n
-Retrieve and store the raw package data in a set of directory structures by stem and version at the location specified by \fB-d\fR. The \fB--raw\fR option can be used only with file system based destinations. This package data can be used to conveniently modify and republish packages, perhaps by correcting file contents or providing additional package metadata. The \fB--raw\fR option cannot be combined with \fB-a\fR.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRList Newest Packages
-.sp
-.LP
-List the newest packages available from the repository on the system named \fBtest\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test --newest\fR
+pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120819T155007Z</programlisting>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>all-timestamps</literal></term>
+<listitem><para>Retrieve all versions of each matching <replaceable>fmri</replaceable> or <replaceable>
+pattern</replaceable> (implies <literal>all-versions</literal>). This is the
+default behavior if the <option>m</option> option is not specified. In the
+example above, all four packages are retrieved.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>all-versions</literal></term>
+<listitem><para>Retrieve the latest timestamp for each version of each matching
+<replaceable>fmri</replaceable> or <replaceable>pattern</replaceable>. In the
+example above, the following two packages are retrieved:</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z</programlisting>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>latest</literal></term>
+<listitem><para>Retrieve only the newest version of each matching <replaceable>fmri
+</replaceable> or <replaceable>pattern</replaceable>. In the example above,
+only the following package is retrieved:</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run with no changes made.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Only clone the specified publisher. This option can be specified multiple
+times. The <option>p</option> option is valid only with the
+<option>-clone</option> option.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>Recursively retrieve all dependencies for each matching
+<replaceable>fmri</replaceable> or <replaceable>pattern</replaceable>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)</term>
+<listitem><para>Specify the file system path or URI of a <literal>pkg</literal>(5)
+repository or package archive from which to receive package data. If <option>s</option> is
+not specified, the value of <envar>PKG_SRC</envar> is used. See &ldquo;Environment
+Variables&rdquo; below.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>Display verbose output, including the number of packages retrieved and their full FMRIs, the number of files retrieved, and the estimated size of the transfer.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>src_key</replaceable></term>
+<listitem><para>Specify a client SSL key file to use for package retrieval
+from the source HTTPS repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-cert</option> <replaceable>src_cert</replaceable></term>
+<listitem><para>Specify a client SSL certificate file to use for package retrieval
+from the source HTTPS repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-dkey</option> <replaceable>dest_key</replaceable></term>
+<listitem><para>Specify a client SSL key file to use for package publication
+to the destination HTTPS repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-dcert</option> <replaceable>dest_cert</replaceable></term>
+<listitem><para>Specify a client SSL certificate file to use for package publication
+to the destination HTTPS repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-clone</option></term>
+<listitem><para>Make an exact copy of the source repository. By default, the
+clone operation succeeds only if publishers in the source repository are also
+present in the destination. To limit the clone operation to specified publishers,
+use the <option>p</option> option. Publishers specified by using the <option>p</option> option
+are added to the destination repository if they are not already present. Packages
+that are in the destination repository but not in the source repository are
+removed. The clone operation leaves the destination repository altered if
+an error occurs. Therefore, the destination repository should be in its own
+ZFS dataset, and a snapshot should be created prior to performing the clone
+operation.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-newest</option></term>
+<listitem><para>List the most recent versions of the packages available from
+the repository specified by the <option>s</option> option. All other options
+are ignored.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-raw</option></term>
+<listitem><para>Retrieve and store the raw package data in a set of directory
+structures by stem and version at the location specified by <option>d</option>.
+The <option>-raw</option> option can be used only with file system based destinations.
+This package data can be used to conveniently modify and republish packages,
+perhaps by correcting file contents or providing additional package metadata.
+The <option>-raw</option> option cannot be combined with <option>a</option>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>List Newest Packages</title>
+<para>List the newest packages available from the repository on the system
+named <literal>test</literal>.</para>
+<screen>$ <userinput>pkgrecv -s http://test --newest</userinput>
 pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
 pkg://solaris/system/library/[email protected],5.11-0.175.1.0.0.7.1234:20120109T215840Z
-pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190432Z
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRRetrieve Raw Package Data
-.sp
-.LP
-Receive the \fBc++-runtime\fR package from Example 1 in a format suitable for use with \fBpkgsend publish\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test \e\fR
-\fB-d /local/repo --raw \e\fR
-\[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z\fR
+pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190432Z</screen>
+</example>
+<example><title>Retrieve Raw Package Data</title>
+<para>Receive the <literal>c++-runtime</literal> package from Example 1 in
+a format suitable for use with <command>pkgsend publish</command>.</para>
+<screen>$ <userinput>pkgrecv -s http://test &bsol;</userinput>
+<userinput>-d /local/repo --raw &bsol;</userinput>
+<userinput>[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z</userinput>
 Processing packages for publisher solaris ...
 Retrieving and evaluating 1 package(s)...
 PROCESS       ITEMS     GET (MB)    SEND (MB)
 Completed       1/1      3.5/3.5      0.0/0.0
-$ \fBls /local/repo\fR
-pkg5.repository  publisher  system%2Flibrary%2Fc%2B%2B-runtime
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 3 \fRRetrieve Dependencies From a System
-.sp
-.LP
-Receive the package \fBeditor/vim\fR and all of its dependencies from the system named \fBtest\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d /local/repo -r editor/vim\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 4 \fRRetrieve Only the Latest Version
-.sp
-.LP
-Receive only the latest version of the package \fBeditor/vim\fR from the system named \fBtest\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d /local/repo -m latest -v \e\fR
-\fBeditor/vim\fR
+$ <userinput>ls /local/repo</userinput>
+pkg5.repository  publisher  system%2Flibrary%2Fc%2B%2B-runtime</screen>
+</example>
+<example><title>Retrieve Dependencies From a System</title>
+<para>Receive the package <literal>editor/vim</literal> and all of its dependencies
+from the system named <literal>test</literal>.</para>
+<screen>$ <userinput>pkgrecv -s http://test -d /local/repo -r editor/vim</userinput></screen>
+</example>
+<example><title>Retrieve Only the Latest Version</title>
+<para>Receive only the latest version of the package <literal>editor/vim</literal> from the system named <literal>test</literal>.</para>
+<screen>$ <userinput>pkgrecv -s http://test -d /local/repo -m latest -v &bsol;</userinput>
+<userinput>editor/vim</userinput>
 Processing packages for publisher solaris ...
 Retrieving and evaluating 1 package(s)...
 
@@ -385,225 +257,137 @@
 editor/[email protected],5.11-0.175.1.0.0.24.0:20120904T172128Z
 
 PROCESS                                     ITEMS    GET (MB) SEND (MB)
-Completed                                     1/1     9.2/9.2 25.4/25.4
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 5 \fRRetrieve All Versions and Republish Remotely
-.sp
-.LP
-Receive all versions of the package \fBlibrary/zlib\fR from the system named \fBtest\fR and republish it to a remote repository on the system named \fBremote\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d http://remote:10000 \e\fR
-\fB-m all-versions library/zlib\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 6 \fRRetrieve Dependencies From a Repository
-.sp
-.LP
-Receive the package \fBeditor/gnu-emacs\fR and all of its dependencies from the repository located at \fB/export/repo\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 7 \fRRetrieve Additional Packages and Changed Content
-.sp
-.LP
-Receive all packages that do not already exist and all changed content from the repository located at \fBhttp://pkg.oracle.com/solaris/release/\fR to the repository located at \fB/export/repoSolaris11\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://pkg.oracle.com/solaris/release/ \e\fR
-\fB-d /export/repoSolaris11 -m all-timestamps '*'\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Receive all packages that do not already exist and all changed content from the secure repository located at \fBhttps://pkg.oracle.com/solaris/support/\fR to the repository located at \fB/export/repoSolaris11\fR. 
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s https://pkg.oracle.com/solaris/support/ \e\fR
-\fB-d /export/repoSolaris11 -m all-timestamps \e\fR
-\fB--key /var/pkg/ssl/Oracle_Solaris_11_Support.key.pem \e\fR
-\fB--cert /var/pkg/ssl/Oracle_Solaris_11_Support.certificate.pem '*'\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 8 \fRCreate a Package Archive
-.sp
-.LP
-Create a package archive containing the package \fBeditor/gnu-emacs\fR and all of its dependencies from the repository located at \fBhttp://example.com:10000\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://example.com:10000 -d /my/emacs.p5p -a \e\fR
-\fB-r editor/gnu-emacs\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 9 \fRCopy Packages From an Archive to a Repository
-.sp
-.LP
-Copy all of the packages in a package archive to an existing repository located at \fB/export/repo\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s /my/archive.p5p -d /export/repo '*'\fR
-.fi
-.in -2
-.sp
-
-.SH ENVIRONMENT VARIABLES
-.sp
-.LP
-The following environment variables are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_DEST\fR\fR
-.ad
-.RS 12n
-.rt  
-The path of a directory to save the retrieved package to, or the file system path or URI of a repository or package archive where the packages will be copied.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_SRC\fR\fR
-.ad
-.RS 12n
-.rt  
-A URI or file system path representing the location of a \fBpkg\fR(5) repository or package archive from which to retrieve packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBTMPDIR\fR\fR
-.ad
-.RS 12n
-.rt  
-The absolute path of the directory where temporary data should be stored during program execution. If not set, the default is to store temporary data in \fB/var/tmp\fR.
-.RE
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-Multiple operations were requested, but only some of them succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkgrepo\fR(1), \fBpkgsend\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fICopying and Creating Package Repositories in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH NOTES
-.sp
-.LP
-When using a file system based destination repository, any \fBpkg.depotd\fR processes that are serving that repository must be restarted after package transfer is completed for the changes to be reflected in its web interface or search responses. See \fBpkg.depotd\fR(1M) for more information.
+Completed                                     1/1     9.2/9.2 25.4/25.4</screen>
+</example>
+<example><title>Retrieve All Versions and Republish Remotely</title>
+<para>Receive all versions of the package <literal>library/zlib</literal> from
+the system named <literal>test</literal> and republish it to a remote repository
+on the system named <literal>remote</literal>.</para>
+<screen>$ <userinput>pkgrecv -s http://test -d http://remote:10000 &bsol;</userinput>
+<userinput>-m all-versions library/zlib</userinput></screen>
+</example>
+<example><title>Retrieve Dependencies From a Repository</title>
+<para>Receive the package <literal>editor/gnu-emacs</literal> and all of its
+dependencies from the repository located at <filename>/export/repo</filename>.</para>
+<screen>$ <userinput>pkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs</userinput></screen>
+</example>
+<example><title>Retrieve Additional Packages and Changed Content</title>
+<para>Receive all packages that do not already exist and all changed content
+from the repository located at <literal>http://pkg.oracle.com/solaris/release/</literal> to
+the repository located at <literal>/export/repoSolaris11</literal>.</para>
+<screen>$ <userinput>pkgrecv -s http://pkg.oracle.com/solaris/release/ &bsol;</userinput>
+<userinput>-d /export/repoSolaris11 -m all-timestamps '*'</userinput></screen>
+<para>Receive all packages that do not already exist and all changed content
+from the secure repository located at
+<literal>https://pkg.oracle.com/solaris/support/</literal> to the repository
+located at <literal>/export/repoSolaris11</literal>. </para>
+<screen>$ <userinput>pkgrecv -s https://pkg.oracle.com/solaris/support/ &bsol;</userinput>
+<userinput>-d /export/repoSolaris11 -m all-timestamps &bsol;</userinput>
+<userinput>--key /var/pkg/ssl/Oracle_Solaris_11_Support.key.pem &bsol;</userinput>
+<userinput>--cert /var/pkg/ssl/Oracle_Solaris_11_Support.certificate.pem '*'</userinput></screen>
+</example>
+<example><title>Create a Package Archive</title>
+<para>Create a package archive containing the package <literal>editor/gnu-emacs</literal> and
+all of its dependencies from the repository located at <literal>http://example.com:10000
+</literal>.</para>
+<screen>$ <userinput>pkgrecv -s http://example.com:10000 -d /my/emacs.p5p -a &bsol;</userinput>
+<userinput>-r editor/gnu-emacs</userinput></screen>
+</example>
+<example><title>Copy Packages From an Archive to a Repository</title>
+<para>Copy all of the packages in a package archive to an existing repository
+located at <filename>/export/repo</filename>.</para>
+<screen>$ <userinput>pkgrecv -s /my/archive.p5p -d /export/repo '*'</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<para>The following environment variables are supported:</para>
+<variablelist>
+<varlistentry><term><envar>PKG_DEST</envar></term>
+<listitem><para>The path of a directory to save the retrieved package to,
+or the file system path or URI of a repository or package archive where the
+packages will be copied.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_SRC</envar></term>
+<listitem><para>A URI or file system path representing the location of a <literal>
+pkg</literal>(5) repository or package archive from which to retrieve packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>TMPDIR</envar></term>
+<listitem><para>The absolute path of the directory where temporary data should
+be stored during program execution. If not set, the default is to store temporary
+data in <filename>/var/tmp</filename>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>Multiple operations were requested, but only some of them
+succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>When using a file system based destination repository, any <command>pkg.depotd</command> processes that are serving that repository must be restarted after package transfer is completed for the changes to be reflected in its web interface or search responses. See <command>pkg.depotd</command>(1M) for more information.</para>
+</refsect1>
+</refentry>
--- a/src/man/pkgrepo.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgrepo.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,1191 +1,722 @@
-'\" te
-.\" Copyright (c) 2007, 2014, Oracle and/or its affiliates. All rights reserved.
-.TH pkgrepo 1 "27 Mar 2014" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgrepo \- Image Packaging System repository management utility
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgrepo create [--version \fIver\fR] \fIuri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo add-publisher -s \fIrepo_uri_or_path\fR
-    \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo remove-publisher [-n] [--synchronous]
-    -s \fIrepo_uri_or_path\fR \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo get [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [\fIsection/property\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo info [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo list [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo contents [-m]
-    [-t \fIaction_name\fR[,\fIaction_name\fR]...]... -s \fIrepo_uri_or_path\fR
-    [--key \fIssl_key\fR --cert \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo rebuild [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [--no-catalog] [--no-index]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo refresh [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [--no-catalog] [--no-index]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo remove [-n] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo set [-p \fIpublisher\fR]... -s \fIrepo_uri_or_path\fR
-    \fIsection/property\fR=[\fIvalue\fR] ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo set [-p \fIpublisher\fR]... -s \fIrepo_uri_or_path\fR
-    \fIsection/property\fR=([\fIvalue\fR]) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo verify [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo fix [-v] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo help
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo version
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgrepo\fR provides the ability to create and manage \fBpkg\fR(5) package repositories. Package repositories are a predefined set of directories and files that permit the storage and retrieval of package data by \fBpkg\fR and publication clients such as \fBpkgsend\fR or \fBpkgrecv\fR. In addition, when network-based access to a package repository is needed, \fBpkg.depotd\fR can provide clients access to the repository to store and/or retrieve package data.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.SH SUB-COMMANDS
-.sp
-.LP
-The following subcommands are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo create\fR [\fB--version\fR \fIver\fR] \fIuri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Create a \fBpkg\fR(5) repository at the specified location.
-.sp
-This subcommand can be used only with file system based repositories.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--version\fR\fR
-.ad
-.sp .6
-.RS 4n
-Create a repository in a format compatible with the specified version. By default, version 4 repositories are created. Supported versions are:
-.sp
-.ne 2
-.mk
-.na
-\fB3\fR
-.ad
-.RS 5n
-.rt  
-Supports storage of packages for a single publisher, catalog version 1, and search version 1.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB4\fR
-.ad
-.RS 5n
-.rt  
-Supports storage of packages for multiple publishers, catalog version 1, and search version 1.
-.RE
-
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo add-publisher\fR \fB-s\fR \fIrepo_uri_or_path\fR \fIpublisher\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Add the specified publishers to the repository. The new publishers have no packages or content.
-.sp
-This subcommand can be used only with version 4 file system based repositories.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the repository located at the given URI or file system path.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo remove-publisher\fR [\fB-n\fR] [\fB--synchronous\fR] \fB-s\fR \fIrepo_uri_or_path\fR \fIpublisher\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Remove the specified publishers from the repository. Remove all packages and all other data for the specified publishers.
-.sp
-If the default publisher is removed, and only one publisher remains in the repository, that remaining publisher becomes the default. The \fBpublisher/prefix\fR property of the repository is set to that remaining publisher.
-.sp
-If the default publisher is removed, and multiple publishers remain in the repository, or if the last publisher is removed from the repository, the \fBpublisher/prefix\fR property is unset.
-.sp
-This subcommand can be used only with version 4 file system based repositories.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run of the operation with no publisher changes made. The number of packages to be removed for each publisher is displayed before exiting.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the repository located at the given URI or file system path.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--synchronous\fR\fR
-.ad
-.sp .6
-.RS 4n
-Wait for the operation to complete before returning. If this option is not specified, the command returns immediately while the publisher is removed asynchronously in the background.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo get\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIsection/property\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Display the property information for the repository or its publishers.
-.sp
-By default, each property and its value are printed on separate lines. Empty ASCII string values are represented by a pair of double quotation marks (\fB""\fR). The following Bourne shell metacharacters, and newline, space, and tab, in ASCII string values must be escaped by backslash characters (\fB\e\fR):
-.sp
-.in +2
-.nf
-; & ( ) | ^ < > \e " ' `
-.fi
-.in -2
-
-See the "Examples" section for examples displaying publisher and repository properties.
-.sp
-For a list of properties and the purpose and value of each property, see the \fBset\fR subcommand below.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify an alternative output format. The value of \fIformat\fR can be \fBtsv\fR (Tab Separated Values), \fBjson\fR (JavaScript Object Notation as a single line), or \fBjson-formatted\fR (JavaScript Object Notation, formatted for readability).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-Omit the headers from the listing.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display the property information for the given publisher. The special value \fBall\fR displays the properties for all publishers. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the repository located at the given URI or file system path.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-Use the \fB--key\fR option to specify a client SSL key file to use for package retrieval from an HTTPS repository. Use the \fB--cert\fR option to specify a client SSL certificate file to use for package retrieval from an HTTPS repository. This option pair can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection/property\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display values for only the specified properties, such as \fBpublisher/prefix\fR or \fBrepository/version\fR. See the \fBset\fR subcommand for a complete list of properties.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo info\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]...\fR
-.ad
-.sp .6
-.RS 4n
-Display a listing of the package publishers known by the repository. The listing includes the number of packages for each publisher, when the publisher's package data was last updated, and the status of the publisher's package data (such as whether it is currently being processed).
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only display the data for the given publisher. If not provided, the data for all publishers is displayed. This option can be specified multiple times.
-.RE
-
-For descriptions of all other options, see the \fBpkgrepo get\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo list\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-List the packages in the \fIrepo_uri_or_path\fR repository that match the specified \fIpkg_fmri_pattern\fR patterns. If no patterns are specified, all packages in the repository are listed. The \fIpkg_fmri_pattern\fR pattern can include the \fB?\fR and \fB*\fR characters as \fBglob\fR(3C)-style wildcards to match one or more packages.
-.sp
-In the default output, the first column contains the name of the publisher of the package. The second column contains the name of the package. The third column is a flag that shows the status of the package. A value of \fBo\fR in the status column indicates the package is obsolete. A value of \fBr\fR in the status column indicates the package has been renamed, which is a form of obsoletion. The fourth column contains the release and branch versions of the package. See \fBpkg\fR(5) for information about release and branch versions.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only display the packages for the given publisher. If not provided, the packages for all publishers are listed. This option can be specified multiple times.
-.RE
-
-For descriptions of all other options, see the \fBpkgrepo get\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo contents\fR [\fB-m\fR [\fB-t\fR \fIaction_name\fR[,\fIaction_name\fR]...]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR...]\fR
-.ad
-.sp .6
-.RS 4n
-List all packages in the \fIrepo_uri_or_path\fR repository. If \fIpkg_fmri_pattern\fR is specified, display the contents (action attributes) of all matching packages in the repository.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display all attributes of actions in the specified packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display only the specified actions in the specified packages. The \fB-t\fR option can be specified multiple times, or multiple actions can be specified as the argument to one \fB-t\fR option by separating the action names with commas. The value of \fIaction_name\fR is one of the actions listed in  "Actions" in the \fBpkg\fR(5) man page, such as \fBfile\fR, \fBdir\fR, \fBdriver\fR, \fBdepend\fR, or \fBset\fR.
-.RE
-
-For descriptions of all other options, see the \fBpkgrepo get\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo rebuild\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB--no-catalog\fR] [\fB--no-index\fR]\fR
-.ad
-.sp .6
-.RS 4n
-Discard all catalog, search, and other cached information found in the repository, and then recreate it based on the current contents of the repository.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform the operation only for the given publisher. If not provided, or if the special value \fBall\fR is specified, the operation is performed for all publishers. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not rebuild package data.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not rebuild search indexes.
-.RE
-
-For descriptions of all other options, see the \fBpkgrepo get\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo refresh\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB--no-catalog\fR] [\fB--no-index\fR]\fR
-.ad
-.sp .6
-.RS 4n
-Catalog any new packages found in the repository and update all search indexes. This is intended for use with deferred publication (\fB--no-catalog\fR or \fB--no-index\fR options of \fBpkgsend\fR).
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform the operation only for the given publisher. If not provided, or if the special value \fBall\fR is specified, the operation is performed for all publishers. This option can be specified multiple times.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not add any new packages.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not update search indexes.
-.RE
-
-For descriptions of all other options, see the \fBpkgrepo get\fR command above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo remove\fR [\fB-n\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Remove packages that match the specified \fIpkg_fmri_pattern\fR pattern from the repository, including any files they reference that are not in use by any other package. The \fIpkg_fmri_pattern\fR pattern can include the \fB?\fR and \fB*\fR characters as \fBglob\fR(3C)-style wildcards to match one or more packages.
-.LP
-Note - 
-.sp
-.RS 2
-All search index data for related publishers is removed.
-.RE
-This subcommand can be used only with file system based repositories.
-.LP
-Caution - 
-.sp
-.RS 2
-This operation is not reversible and should not be used while other clients are accessing the repository since it might cause them to fail during retrieval operations.
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run of the operation with no package changes made. A list of the packages to be removed is displayed before exiting.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only remove matching packages for the given publisher. If not provided, any matching packages are removed for all publishers. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the repository located at the given URI or file system path.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo set\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIsection/property\fR=[\fIvalue\fR] ...\fR
-.ad
-.br
-.na
-\fB\fBpkgrepo set\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIsection/property\fR=([\fIvalue\fR]) ...\fR
-.ad
-.sp .6
-.RS 4n
-Set the value of the specified properties for the repository or publisher.
-.sp
-This subcommand can be used only with file system based repositories.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Only set property data for the given publisher. If the publisher does not already exist, it is added. The special value \fBall\fR can be used to set the property for all publishers.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the repository located at the given URI or file system path.
-.RE
-
-Properties and values can be specified using one of the following forms:
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=\fR
-.ad
-.sp .6
-.RS 4n
-Clear the property value.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-Replace the property value with the given value.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=(\fIvalue1\fR \fIvalue2\fR \fIvalueN\fR)\fR
-.ad
-.sp .6
-.RS 4n
-Replace the property value with the list of values.
-.RE
-
-For repository versions 3 and 4, the following properties can be set for the repository:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpublisher/prefix\fR\fR
-.ad
-.sp .6
-.RS 4n
-A string that represents the name of the default publisher. The first character must be a-z, A-Z, or 0-9. The remainder of the string can only contain the characters 0-9, -, ., a-z, and A-Z. This value indicates the publisher that should be used when more than one publisher's packages are present, or when packages are published to the repository and a publisher is not specified.
-.RE
-
-For repository versions 3 and 4, the following properties can be set for individual publishers in the repository. Use the \fB-p\fR option to specify at least one publisher when you set these properties:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpublisher/alias\fR\fR
-.ad
-.sp .6
-.RS 4n
-A string that represents the default alias that clients should use when adding a publisher using the repository's configuration data. The first character must be a-z, A-Z, or 0-9. The remainder of the string can only contain the characters 0-9, -, ., a-z, and A-Z.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/check-certificate-revocation\fR\fR
-.ad
-.sp .6
-.RS 4n
-A boolean to check whether a certificate has been revoked. When this property is set to \fBTrue\fR, the \fBpkgrepo verify\fR and \fBpkgrepo fix\fR commands attempt to contact any CRL distribution points in the certificates used for signature verification to determine whether the certificate has been revoked since being issued. The default value is \fBFalse\fR. This property is only used by the \fBverify\fR and \fBfix\fR subcommands to validate the contents of the repository. This property does not affect client settings. This value should be the same as the corresponding \fBpkg\fR(1) property value.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/collection_type\fR\fR
-.ad
-.sp .6
-.RS 4n
-Can have the value \fBcore\fR or \fBsupplemental\fR, indicating the type of packages offered in this repository.
-.sp
-The \fBcore\fR type indicates that the repository contains all of the dependencies declared by packages in the repository. The \fBcore\fR type is primarily used for operating system repositories.
-.sp
-The \fBsupplemental\fR type indicates that the repository contains packages that rely on or are intended to be used with packages located in another repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/description\fR\fR
-.ad
-.sp .6
-.RS 4n
-A paragraph of plain text that describes the purpose and contents of the repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/detailed_url\fR\fR
-.ad
-.sp .6
-.RS 4n
-A URI that represents the location of a document (such as a web page) that provides additional information about the repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/legal_uris\fR\fR
-.ad
-.sp .6
-.RS 4n
-A list of locations (URIs) for documents that provide additional legal information about the repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/mirrors\fR\fR
-.ad
-.sp .6
-.RS 4n
-A list of locations (URIs) of repositories that contain a copy of the repository's package content but not the package metadata.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/name\fR\fR
-.ad
-.sp .6
-.RS 4n
-A plain text string that contains the name of the repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/origins\fR\fR
-.ad
-.sp .6
-.RS 4n
-A list of locations (URIs) of repositories that contain a complete copy of the repository's package metadata and content.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/refresh_seconds\fR\fR
-.ad
-.sp .6
-.RS 4n
-An integer value that represents the number of seconds clients should wait before checking the repository for updated package data after each update check.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/registration_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-A URI that represents the location of a resource that must be used to obtain credentials for access to the repository. A registration web page is one example.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/related_uris\fR\fR
-.ad
-.sp .6
-.RS 4n
-A list of locations (URIs) of repositories that contain packages that users might be interested in.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/signature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-A list of names that must be seen as common names of certificates while validating the signatures of a package. This property is only used by the \fBverify\fR and \fBfix\fR subcommands to validate the contents of the repository. This property does not affect client settings. These values should be the same as the corresponding \fBpkg\fR(1) property values.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/trust-anchor-directory\fR\fR
-.ad
-.sp .6
-.RS 4n
-The absolute path name of the directory that contains the trust anchors for packages in this repository. If not specified, \fB/etc/certs/CA/\fR is used. This property is only used by the \fBverify\fR and \fBfix\fR subcommands to validate the contents of the repository. This property does not affect client settings. This value should be the same as the corresponding \fBpkg\fR(1) property value.
-.RE
-
-Properties not documented here, but listed in the output of the \fBget\fR subcommand, are reserved for internal use and should not be set.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo verify\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Verify that the following attributes of the package repository contents are correct:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-File checksums
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-File permissions
-.sp
-The path leading to the repository is also checked to ensure that the \fBpkg5srv\fR user can read the repository contents. This check can be necessary for repositories that are made available using the \fBsvc:/application/pkg/server\fR service, or using the \fBsvc:/application/pkg/system-repository\fR service when the system has non-global zones.
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Package manifest permissions
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Package manifest content
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Package signatures
-.sp
-Package manifest signatures are calculated based on the values of the \fBrepository/signature-required-names\fR, \fBrepository/trust-anchor-directory\fR, and \fBrepository/check-certificate-revocation\fR properties.
-.RE
-Errors are emitted to \fBstdout\fR. The \fBpkgrepo\fR command exits with a non-zero return code if any errors are emitted.
-.sp
-This subcommand can be used only with version 4 file system based repositories.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform the operation only for the specified publisher. If no publisher is specified, or if the special value \fBall\fR is specified, the operation is performed for all publishers. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the repository located at the given URI or file system path.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo fix\fR [\fB-v\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Fix the contents of a repository by first verifying the repository, and then moving any invalid repository contents into a quarantine directory within the repository.
-.sp
-If repository errors are found, a repository rebuild is automatically performed. If any errors are found, a message is emitted to \fBstdout\fR showing which packages must be re-imported using \fBpkgsend\fR(1) or \fBpkgrecv\fR(1) in order to restore the repository contents.
-.sp
-This subcommand can be used only with version 4 file system based repositories.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-Include output detailing the errors found during repository verification.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform the operation only for the specified publisher. If no publisher is specified, or if the special value \fBall\fR is specified, the operation is performed for all publishers. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the repository located at the given URI or file system path.
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo version\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a unique string that identifies the version of the \fBpkg\fR(5) system. The values produced by the \fBversion\fR operation are not sortable and are not safe for comparison beyond equality.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRCreate a Package Repository
-.sp
-.in +2
-.nf
-$ \fBpkgrepo create /my/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRDisplay Information
-.sp
-.LP
-Display a summary of publishers and the number of packages in a repository.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo info -s /my/repository\fR
+<refentry id="pkgrepo-1">
+<refmeta><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">26 May 2015</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgrepo</refname><refpurpose>Image Packaging System repository management utility</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgrepo create [--version <replaceable>ver</replaceable>] <replaceable>uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo add-publisher -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>publisher</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo remove-publisher [-n] [--synchronous]
+    -s <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo get [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [<replaceable>section/property</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkgrepo info [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...</synopsis>
+<synopsis>/usr/bin/pkgrepo list [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkgrepo contents [-m]
+    [-t <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]... -s <replaceable>repo_uri_or_path</replaceable>
+    [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable>...]</synopsis>
+<synopsis>/usr/bin/pkgrepo rebuild [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [--no-catalog] [--no-index]</synopsis>
+<synopsis>/usr/bin/pkgrepo refresh [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [--no-catalog] [--no-index]</synopsis>
+<synopsis>/usr/bin/pkgrepo remove [-n] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> <replaceable>pkg_fmri_pattern</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo set [-p <replaceable>publisher</replaceable>]... -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>section/property</replaceable>=[<replaceable>value</replaceable>] ...</synopsis>
+<synopsis>/usr/bin/pkgrepo set [-p <replaceable>publisher</replaceable>]... -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>section/property</replaceable>=([<replaceable>value</replaceable>]) ...</synopsis>
+<synopsis>/usr/bin/pkgrepo verify [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo fix [-v] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo help</synopsis>
+<synopsis>/usr/bin/pkgrepo version</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgrepo-1-desc" role="description"><title></title>
+<para><command>pkgrepo</command> provides the ability to create and manage
+<literal>pkg</literal>(5) package repositories. Package repositories are a
+predefined set of directories and files that permit the storage and retrieval of
+package data by <command>pkg</command> and publication clients such as
+<command>pkgsend</command> or <command>pkgrecv</command>. In addition, when
+network-based access to a package repository is needed,
+<command>pkg.depotd</command> can provide clients access to the repository to
+store and/or retrieve package data.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>The following subcommands are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgrepo create</command> [<option>-version</option> <replaceable>ver</replaceable>] <replaceable>uri_or_path</replaceable></term>
+<listitem><para>Create a <literal>pkg</literal>(5) repository at the specified
+location.</para>
+<para>This subcommand can be used only with file system based repositories.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-version</option></term>
+<listitem><para>Create a repository in a format compatible with the specified
+version. By default, version 4 repositories are created. Supported versions
+are:</para>
+<variablelist>
+<varlistentry><term>3</term>
+<listitem><para>Supports storage of packages for a single publisher, catalog
+version 1, and search version 1.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>4</term>
+<listitem><para>Supports storage of packages for multiple publishers, catalog
+version 1, and search version 1.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo add-publisher</command> <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</term>
+<listitem><para>Add the specified publishers to the repository. The new publishers
+have no packages or content.</para>
+<para>This subcommand can be used only with version 4 file system based repositories.
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Operate on the repository located at the given URI or file
+system path.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo remove-publisher</command> [<option>n</option>] [<option>-synchronous</option>] <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</term>
+<listitem><para>Remove the specified publishers from the repository. Remove all packages and all other data for the specified publishers.</para>
+<para>If the default publisher is removed, and only one publisher remains in the
+repository, that remaining publisher becomes the default. The
+<literal>publisher/prefix</literal> property of the repository is set to that
+remaining publisher.</para>
+<para>If the default publisher is removed, and multiple publishers remain in
+the repository, or if the last publisher is removed from the repository, the
+<literal>publisher/prefix</literal> property is unset.</para>
+<para>This subcommand can be used only with version 4 file system based repositories.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run of the operation with no publisher changes made. The number of packages to be removed for each publisher is displayed before exiting.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Operate on the repository located at the given URI or file
+system path.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-synchronous</option></term>
+<listitem><para>Wait for the operation to complete before returning. If this
+option is not specified, the command returns immediately while the publisher is
+removed asynchronously in the background.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo get</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>section/property</replaceable> ...]</term>
+<listitem><para>Display the property information for the repository or its
+publishers.</para>
+<para>By default, each property and its value are printed on separate lines.
+Empty ASCII string values are represented by a pair of double quotation marks
+(<literal>""</literal>). The following Bourne shell metacharacters, and newline,
+space, and tab, in ASCII string values must be escaped by backslash characters
+(<literal>&bsol;</literal>):</para>
+<programlisting>; &amp; ( ) | ^ &lt; > &bsol; " ' `</programlisting>
+<para>See the &ldquo;Examples&rdquo; section for examples displaying publisher
+and repository properties.</para>
+<para>For a list of properties and the purpose and value of each property,
+see the <command>set</command> subcommand below.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>Specify an alternative output format. The value of <replaceable>format
+</replaceable> can be <literal>tsv</literal> (Tab Separated Values), <literal>json
+</literal> (JavaScript Object Notation as a single line), or <literal>json-formatted
+</literal> (JavaScript Object Notation, formatted for readability).</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>Omit the headers from the listing.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Display the property information for the given publisher.
+The special value <literal>all</literal> displays the properties for all publishers.
+This option can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Operate on the repository located at the given URI or file
+system path.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para>Use the <option>-key</option> option to specify a client SSL
+key file to use for package retrieval from an HTTPS repository. Use the <option>-cert
+</option> option to specify a client SSL certificate file to use for package
+retrieval from an HTTPS repository. This option pair can be specified multiple
+times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section/property</replaceable></term>
+<listitem><para>Display values for only the specified properties, such as <literal>
+publisher/prefix</literal> or <literal>repository/version</literal>. See the <command>
+set</command> subcommand for a complete list of properties.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo info</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]...</term>
+<listitem><para>Display a listing of the package publishers known by the repository.
+The listing includes the number of packages for each publisher, when the publisher's
+package data was last updated, and the status of the publisher's package data
+(such as whether it is currently being processed).</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Only display the data for the given publisher. If not provided,
+the data for all publishers is displayed. This option can be specified multiple
+times.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For descriptions of all other options, see the <command>pkgrepo get</command> command
+above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo list</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para>List the packages in the <replaceable>repo_uri_or_path</replaceable> repository
+that match the specified <replaceable>pkg_fmri_pattern</replaceable> patterns.
+If no patterns are specified, all packages in the repository are listed. The
+<replaceable>pkg_fmri_pattern</replaceable> pattern can include the
+<literal>?</literal> and <literal>*</literal> characters as
+<literal>glob</literal>(3C)-style wildcards to match one or more packages.</para>
+<para>In the default output, the first column contains the name of the publisher
+of the package. The second column contains the name of the package. The third
+column is a flag that shows the status of the package. A value of <literal>o</literal> in
+the status column indicates the package is obsolete. A value of <literal>r</literal> in
+the status column indicates the package has been renamed, which is a form
+of obsoletion. The fourth column contains the release and branch versions
+of the package. See <literal>pkg</literal>(5) for information about release
+and branch versions.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Only display the packages for the given publisher. If not
+provided, the packages for all publishers are listed. This option can be
+specified multiple times.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For descriptions of all other options, see the <command>pkgrepo get</command> command
+above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo contents</command> [<option>m</option> [<option>t</option> <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable>...]</term>
+<listitem><para>List all packages in the
+<replaceable>repo_uri_or_path</replaceable> repository. If
+<replaceable>pkg_fmri_pattern</replaceable> is specified, display the contents
+(action attributes) of all matching packages in the repository.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>m</option></term>
+<listitem><para>Display all attributes of actions in the specified packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>action_name</replaceable></term>
+<listitem><para>Display only the specified actions in the specified packages.
+The <option>t</option> option can be specified multiple times, or multiple
+actions can be specified as the argument to one <option>t</option> option by
+separating the action names with commas. The value of
+<replaceable>action_name</replaceable> is one of the actions listed in 
+&ldquo;Actions&rdquo; in the <literal>pkg</literal>(5) man page, such as
+<literal>file</literal>, <literal>dir</literal>, <literal>driver</literal>, <literal>depend</literal>, or <literal>set</literal>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For descriptions of all other options, see the <command>pkgrepo get</command> command
+above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo rebuild</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>-no-catalog</option>] [<option>-no-index</option>]</term>
+<listitem><para>Discard all catalog, search, and other cached information
+found in the repository, and then recreate it based on the current contents
+of the repository.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Perform the operation only for the given publisher. If not
+provided, or if the special value <literal>all</literal> is specified, the
+operation is performed for all publishers. This option can be specified multiple
+times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>Do not rebuild package data.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>Do not rebuild search indexes.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For descriptions of all other options, see the <command>pkgrepo get</command> command
+above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo refresh</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>-no-catalog</option>] [<option>-no-index</option>]
+</term>
+<listitem><para>Catalog any new packages found in the repository and update
+all search indexes. This is intended for use with deferred publication (<option>-no-catalog
+</option> or <option>-no-index</option> options of <command>pkgsend</command>).</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Perform the operation only for the given publisher. If not
+provided, or if the special value <literal>all</literal> is specified, the
+operation is performed for all publishers. This option can be specified multiple
+times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>Do not add any new packages.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>Do not update search indexes.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For descriptions of all other options, see the <command>pkgrepo get</command> command
+above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo remove</command> [<option>n</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>pkg_fmri_pattern</replaceable> ...</term>
+<listitem><para>Remove packages that match the specified
+<replaceable>pkg_fmri_pattern</replaceable> pattern from the repository,
+including any files they reference that are not in use by any other package.
+The <replaceable>pkg_fmri_pattern</replaceable> pattern can include the
+<literal>?</literal> and <literal>*</literal> characters as
+<literal>glob</literal>(3C)-style wildcards to match one or more packages.</para>
+<note><para>All search index data for related publishers is removed.</para>
+</note>
+<para>This subcommand can be used only with file system based repositories.</para>
+<caution><para>This operation is not reversible and should not be used while
+other clients are accessing the repository since it might cause them to fail
+during retrieval operations.</para></caution>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run of the operation with no package changes
+made. A list of the packages to be removed is displayed before exiting.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Only remove matching packages for the given publisher. If
+not provided, any matching packages are removed for all publishers. This option
+can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Operate on the repository located at the given URI or file
+system path.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo set</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>section/property</replaceable>=[<replaceable>value</replaceable>] ...</term><term><command>pkgrepo set</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>section/property</replaceable>=([<replaceable>value</replaceable>]) ...</term>
+<listitem><para>Set the value of the specified properties for the repository
+or publisher.</para>
+<para>This subcommand can be used only with file system based repositories.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Only set property data for the given publisher. If the publisher
+does not already exist, it is added. The special value <literal>all</literal> can
+be used to set the property for all publishers.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Operate on the repository located at the given URI or file
+system path.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Properties and values can be specified using one of the following forms:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=</term>
+<listitem><para>Clear the property value.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=<replaceable>value</replaceable></term>
+<listitem><para>Replace the property value with the given value.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=(<replaceable>value1</replaceable> <replaceable>value2</replaceable> <replaceable>valueN</replaceable>)</term>
+<listitem><para>Replace the property value with the list of values.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For repository versions 3 and 4, the following properties can be set for
+the repository:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>publisher/prefix</literal></term>
+<listitem><para>A string that represents the name of the default publisher.
+The first character must be a-z, A-Z, or 0-9. The remainder of the string
+can only contain the characters 0-9, -, ., a-z, and A-Z. This value indicates
+the publisher that should be used when more than one publisher's packages
+are present, or when packages are published to the repository and a publisher
+is not specified.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For repository versions 3 and 4, the following properties can be set for
+individual publishers in the repository. Use the <option>p</option> option to
+specify at least one publisher when you set these properties:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>publisher/alias</literal></term>
+<listitem><para>A string that represents the default alias that clients should
+use when adding a publisher using the repository's configuration data. The
+first character must be a-z, A-Z, or 0-9. The remainder of the string can
+only contain the characters 0-9, -, ., a-z, and A-Z.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/check-certificate-revocation</literal></term>
+<listitem><para>A boolean to check whether a certificate has been revoked.
+When this property is set to <literal>True</literal>, the <command>pkgrepo verify</command>
+and <command>pkgrepo fix</command> commands attempt to contact
+any CRL distribution points in the certificates used for signature verification
+to determine whether the certificate has been revoked since being issued.
+The default value is <literal>False</literal>. This property is only used
+by the <command>verify</command> and <command>fix</command> subcommands to
+validate the contents of the repository. This property does not affect client
+settings. This value should be the same as the corresponding <literal>pkg</literal>(1)
+property value.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/collection_type</literal></term>
+<listitem><para>Can have the value <literal>core</literal> or
+<literal>supplemental</literal>, indicating the type of packages offered in this
+repository.</para>
+<para>The <literal>core</literal> type indicates that the repository contains
+all of the dependencies declared by packages in the repository. The
+<literal>core</literal> type is primarily used for operating system
+repositories.</para>
+<para>The <literal>supplemental</literal> type indicates that the repository
+contains packages that rely on or are intended to be used with packages located
+in another repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/description</literal></term>
+<listitem><para>A paragraph of plain text that describes the purpose and contents
+of the repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/detailed_url</literal></term>
+<listitem><para>A URI that represents the location of a document (such as
+a web page) that provides additional information about the repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/legal_uris</literal></term>
+<listitem><para>A list of locations (URIs) for documents that provide additional
+legal information about the repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/mirrors</literal></term>
+<listitem><para>A list of locations (URIs) of repositories that contain a
+copy of the repository's package content but not the package metadata.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/name</literal></term>
+<listitem><para>A plain text string that contains the name of the repository.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/origins</literal></term>
+<listitem><para>A list of locations (URIs) of repositories that contain a
+complete copy of the repository's package metadata and content.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/refresh_seconds</literal></term>
+<listitem><para>An integer value that represents the number of seconds clients
+should wait before checking the repository for updated package data after
+each update check.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/registration_uri</literal></term>
+<listitem><para>A URI that represents the location of a resource that must
+be used to obtain credentials for access to the repository. A registration
+web page is one example.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/related_uris</literal></term>
+<listitem><para>A list of locations (URIs) of repositories that contain packages
+that users might be interested in.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/signature-required-names</literal></term>
+<listitem><para>A list of names that must be seen as common names of certificates
+while validating the signatures of a package. This property is only used by
+the <command>verify</command> and <command>fix</command> subcommands to validate
+the contents of the repository. This property does not affect client settings.
+These values should be the same as the corresponding <literal>pkg</literal>(1)
+property values.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/trust-anchor-directory</literal></term>
+<listitem><para>The absolute path name of the directory that contains the
+trust anchors for packages in this repository. If not specified, <filename>/etc/certs/CA/
+</filename> is used. This property is only used by the <command>verify</command> and <command>
+fix</command> subcommands to validate the contents of the repository. This
+property does not affect client settings. This value should be the same as
+the corresponding <literal>pkg</literal>(1) property value.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>Properties not documented here, but listed in the output of the
+<command>get</command> subcommand, are reserved for internal use and should not
+be set.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo verify</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Verify that the following attributes of the package repository
+contents are correct:</para>
+<itemizedlist>
+<listitem><para>File checksums</para></listitem>
+<listitem><para>File permissions</para><para>The path leading to the repository
+is also checked to ensure that the <literal>pkg5srv</literal> user can read
+the repository contents. This check can be necessary for repositories that
+are made available using the <literal>svc:/application/pkg/server</literal> service,
+or using the <literal>svc:/application/pkg/system-repository</literal> service
+when the system has non-global zones.</para>
+</listitem>
+<listitem><para>Package manifest permissions</para></listitem>
+<listitem><para>Package manifest content</para></listitem>
+<listitem><para>Package signatures</para><para>Package manifest signatures
+are calculated based on the values of the <literal>repository/signature-required-names
+</literal>, <literal>repository/trust-anchor-directory</literal>, and <literal>repository/check-certificate-revocation
+</literal> properties.</para>
+</listitem>
+</itemizedlist>
+<para>Errors are emitted to <literal>stdout</literal>. The <command>pkgrepo</command> command
+exits with a non-zero return code if any errors are emitted.</para>
+<para>This subcommand can be used only with version 4 file system based repositories.
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Perform the operation only for the specified publisher. If
+no publisher is specified, or if the special value <literal>all</literal> is
+specified, the operation is performed for all publishers. This option can
+be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Operate on the repository located at the given URI or file
+system path.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo fix</command> [<option>v</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Fix the contents of a repository by first verifying the repository,
+and then moving any invalid repository contents into a quarantine directory
+within the repository.</para>
+<para>If repository errors are found, a repository rebuild is automatically
+performed. If any errors are found, a message is emitted to
+<literal>stdout</literal> showing which packages must be re-imported using
+<literal>pkgsend</literal>(1) or <literal>pkgrecv</literal>(1) in order to
+restore the repository contents.</para>
+<para>This subcommand can be used only with version 4 file system based repositories.
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>v</option></term>
+<listitem><para>Include output detailing the errors found during repository
+verification.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>Perform the operation only for the specified publisher. If
+no publisher is specified, or if the special value <literal>all</literal> is
+specified, the operation is performed for all publishers. This option can
+be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Operate on the repository located at the given URI or file
+system path.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo help</command></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo version</command></term>
+<listitem><para>Display a unique string that identifies the version of the <literal>pkg</literal>(5) system. The values produced by the <command>version</command> operation are not sortable and are not safe for comparison beyond equality.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Create a Package Repository</title>
+<screen>$ <userinput>pkgrepo create /my/repository</userinput></screen>
+</example>
+<example><title>Display Information</title>
+<para>Display a summary of publishers and the number of packages in a repository.
+</para>
+<screen>$ <userinput>pkgrepo info -s /my/repository</userinput>
 PUBLISHER   PACKAGES STATUS UPDATED
 example.com 5        online 2011-07-22T18:09:09.769106Z
-$ \fBpkgrepo info -s http://pkg.oracle.com/solaris/release/\fR
+$ <userinput>pkgrepo info -s http://pkg.oracle.com/solaris/release/</userinput>
 PUBLISHER PACKAGES STATUS UPDATED
-solaris   3941     online 2010-11-12T19:24:25.967246Z
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 3 \fRRebuild Catalogs and Search Data
-.sp
-.LP
-Rebuild the repository's catalogs and search data.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo rebuild -s /my/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 4 \fRRefresh Catalogs and Search Data
-.sp
-.LP
-Refresh the repository's catalogs and search data.
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo refresh -s /my/repository\fR
-$ \fBpkgrepo refresh -s http://example.com/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 5 \fRDisplay All Repository Properties
-.sp
-.in +2
-.nf
-$ \fBpkgrepo get -s /export/repoSolaris11\fR
+solaris   3941     online 2010-11-12T19:24:25.967246Z</screen>
+</example>
+<example><title>Rebuild Catalogs and Search Data</title>
+<para>Rebuild the repository's catalogs and search data.</para>
+<screen>$ <userinput>pkgrepo rebuild -s /my/repository</userinput></screen>
+</example>
+<example><title>Refresh Catalogs and Search Data</title>
+<para>Refresh the repository's catalogs and search data.</para>
+<screen>$ <userinput>pkgrepo refresh -s /my/repository</userinput>
+$ <userinput>pkgrepo refresh -s http://example.com/repository</userinput></screen>
+</example>
+<example><title>Display All Repository Properties</title>
+<screen>$ <userinput>pkgrepo get -s /export/repoSolaris11</userinput>
 SECTION    PROPERTY    VALUE
 publisher  prefix      solaris
-repository description Local\e copy\e of\e the\e Oracle\e Solaris\e 11\e repository
-repository name        Oracle\e Solaris\e 11
+repository description Local&bsol; copy&bsol; of&bsol; the&bsol; Oracle&bsol; Solaris&bsol; 11&bsol; repository
+repository name        Oracle&bsol; Solaris&bsol; 11
 repository version     4
-$ \fBpkgrepo get -s http://pkg.oracle.com/solaris/release/\fR
+$ <userinput>pkgrepo get -s http://pkg.oracle.com/solaris/release/</userinput>
 SECTION    PROPERTY VALUE
 deployment content  s11_11-11
 deployment pubdate  20111102T222051Z
 publisher  prefix   solaris
-repository version  4
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 6 \fRDisplay All Publisher Properties
-.sp
-.in +2
-.nf
-$ \fBpkgrepo get -s http://pkg.oracle.com/solaris/release/ -p all\fR
+repository version  4</screen>
+</example>
+<example><title>Display All Publisher Properties</title>
+<screen>$ <userinput>pkgrepo get -s http://pkg.oracle.com/solaris/release/ -p all</userinput>
 PUBLISHER SECTION    PROPERTY         VALUE
 solaris   publisher  alias
 solaris   publisher  prefix           solaris
 solaris   repository collection-type  core
-solaris   repository description      This\e repository\e serves\e the\e Oracle\e
-Solaris\e 11\e Package\e repository.
+solaris   repository description      This&bsol; repository&bsol; serves&bsol; the&bsol; Oracle&bsol;
+Solaris&bsol; 11&bsol; Package&bsol; repository.
 solaris   repository legal-uris       ()
 solaris   repository mirrors          (http://pkg-cdn1.oracle.com/solaris.release/)
-solaris   repository name             Oracle\e Solaris\e 11\e Package\e Repository
+solaris   repository name             Oracle&bsol; Solaris&bsol; 11&bsol; Package&bsol; Repository
 solaris   repository origins          ()
 solaris   repository refresh-seconds
 solaris   repository registration-uri ""
-solaris   repository related-uris     ()
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 7 \fRSet the Default Publisher
-.sp
-.in +2
-.nf
-$ \fBpkgrepo set -s /my/repository publisher/prefix=example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 8 \fRSet a Publisher Property
-.sp
-.in +2
-.nf
-$ \fBpkgrepo set -s /my/repository -p example.com \e\fR
-\fBrepository/origins=http://example.com/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 9 \fRAdd a New Publisher To the Repository
-.sp
-.in +2
-.nf
-$ \fBpkgrepo add-publisher -s /my/repository example.com\fR
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-Multiple operations were requested, but only some of them succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB4\fR\fR
-.ad
-.RS 6n
-.rt  
-No changes were made, nothing to do.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(1), \fBpkgrecv\fR(1), \fBpkgsend\fR(1), \fBpkg.depotd\fR(1M), \fBpkg\fR(5)
-.sp
-.LP
-\fICopying and Creating Package Repositories in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH NOTES
-.sp
-.LP
-Most \fBpkgrepo\fR operations are not available for package archives. A package archive is a file, typically with a \fB\&.p5p\fR extension, as described in the \fB-a\fR option in the \fBpkgrecv\fR(1) man page. A package archive contains packages but does not contain repository configuration. However, the \fBpkgrepo list\fR, \fBpkgrepo info\fR, and \fBpkgrepo contents\fR commands work with package archives.
+solaris   repository related-uris     ()</screen>
+</example>
+<example><title>Set the Default Publisher</title>
+<screen>$ <userinput>pkgrepo set -s /my/repository publisher/prefix=example.com</userinput></screen>
+</example>
+<example><title>Set a Publisher Property</title>
+<screen>$ <userinput>pkgrepo set -s /my/repository -p example.com &bsol;</userinput>
+<userinput>repository/origins=http://example.com/repository</userinput></screen>
+</example>
+<example><title>Add a New Publisher To the Repository</title>
+<screen>$ <userinput>pkgrepo add-publisher -s /my/repository example.com</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>Multiple operations were requested, but only some of them
+succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>4</returnvalue></term>
+<listitem><para>No changes were made, nothing to do.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgrecv-1"><citerefentry><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>Most <command>pkgrepo</command> operations are not available for package archives. A package archive is a file, typically with a <filename>.p5p</filename> extension, as described in the <option>a</option> option in the <literal>pkgrecv</literal>(1) man page. A package archive contains packages but does not contain repository configuration. However, the <command>pkgrepo list</command>, <command>pkgrepo info</command>, and <command>pkgrepo contents</command> commands work with package archives.</para>
+</refsect1>
+</refentry>
--- a/src/man/pkgsend.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgsend.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,401 +1,283 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgsend 1 "30 Jul 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgsend \- Image Packaging System publication client
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgsend [\fIoptions\fR] \fIcommand\fR [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgsend generate [-T \fIpattern\fR] [--target \fIfile\fR]
-    \fIsource\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgsend publish [-b \fIbundle\fR]... [-d \fIsource\fR]...
-    [-s \fIrepo_uri_or_path\fR] [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [-T \fIpattern\fR] [--no-catalog] [\fImanifest\fR ...]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgsend\fR enables the publication of new packages and new package versions to an image packaging repository using package manifests. To create or manage repositories, see \fBpkgrepo\fR(1). To create package archives from packages in an existing repository, see \fBpkgrecv\fR(1). For more information about package manifests, see \fBpkg\fR(5).
-.sp
-.LP
-After a \fBpkgsend publish\fR operation, if your \fIrepo_uri_or_path\fR repository must support \fBpkg search\fR operations, run \fBpkgrepo refresh\fR on the repository to update search indexes.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.SH SUB-COMMANDS
-.sp
-.LP
-The following subcommands are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgsend generate\fR [\fB-T\fR \fIpattern\fR] [\fB--target\fR \fIfile\fR] \fIsource\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-Read each \fIsource\fR (such as an SVR4 package, a directory, or a \fBtar\fR file) and emit the manifest that describes the \fIsource\fR to \fBstdout\fR. In the output manifest, \fBfile\fR and \fBdir\fR actions have owner set to \fBroot\fR and group set to \fBbin\fR.
-.sp
-The output manifest can then be annotated, have dependencies added or analyzed using \fBpkgdepend\fR, and have its correctness verified using \fBpkglint\fR before being passed to the \fBpublish\fR subcommand.
-.sp
-.LP
-The following are supported sources:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Filesystem format SVR4 packages
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Datastream format SVR4 packages
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBtar\fR files
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Directories
-.RE
-If the base name of files in the source match the patterns specified with \fB-T\fR, the timestamp of the file is added to the action for that file. The \fIpattern\fR uses shell matching rules:
-.sp
-.ne 2
-.mk
-.na
-\fB*\fR
-.ad
-.RS 10n
-.rt  
-Matches everything.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB?\fR
-.ad
-.RS 10n
-.rt  
-Matches any single character.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB[\fIseq\fR]\fR
-.ad
-.RS 10n
-.rt  
-Matches any character in \fIseq\fR.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB![\fIseq\fR]\fR
-.ad
-.RS 10n
-.rt  
-Matches any character not in \fIseq\fR.
-.RE
-
-When the specified source is a directory, there is no clear way to distinguish a \fBfile\fR action from a \fBhardlink\fR action when there are multiple path names for a single inode. Normally, the first one found in the file system walk is treated as a file and the rest as hardlinks. This can be arbitrary, depending on the implementation of the file system. To specify which path names should be treated as files, pass each path name as an argument to the \fB--target\fR option. This option has no effect on other types of sources because they are capable of expressing which path names are files and which are hardlinks.
-.sp
-When SVR4 packages are provided as a source, \fBpkgsend\fR checks that no files with class action scripts are present and no preinstall, postinstall, preremove, or postremove scripts are present. An exception is made for any SMF manifests installed with the \fBmanifest\fR class. \fBBASEDIR\fR is removed from all relocatable paths.
-.sp
-The SVR4 \fBDESC\fR parameter is converted to a \fBpkg.description\fR value. The SVR4 \fBNAME\fR parameter is converted to a \fBpkg.summary\fR value.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgsend publish\fR [\fB-b\fR \fIbundle\fR]... [\fB-d\fR \fIsource\fR]... [\fB-s\fR \fIrepo_uri_or_path\fR] [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB-T\fR \fIpattern\fR] [\fB--no-catalog\fR] [\fImanifest\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-Publish a package using the specified package manifests to the target package repository, retrieving files for the package from the provided sources. If multiple manifests are specified, they are joined in the order provided. If a manifest is not specified, the manifest is read from \fBstdin\fR.
-.sp
-If not specified, \fBpkgsend publish\fR adds the build version to the package FMRI. The \fBpublish\fR tool also adds the timestamp (the current time in UTC) to the package FMRI. See the \fBpkg\fR(5) man page for information about the version string of a package FMRI.
-.sp
-If multiple \fBpkgsend publish\fR processes might be publishing to the same \fB-s\fR repository simultaneously, specifying the \fB--no-catalog\fR option is recommended. See the description of the \fB--no-catalog\fR option below.
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-b\fR \fIbundle\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the specified bundle to the list of sources to search when looking for files in the manifest. Bundles are sources such as tar files and SVR4 packages. If this option is specified multiple times, sources are searched in the order they appear on the command line. If both \fB-b\fR and \fB-d\fR are specified, \fB-d\fR sources are searched first. For a description of supported bundles and how they are used, refer to the \fBgenerate\fR subcommand above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the specified directory to the list of sources to search when looking for files in the manifest. If this option is specified multiple times, sources are searched in the order they appear on the command line. For a description of supported sources and how they are used, refer to the \fBgenerate\fR subcommand above.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-Publish the package to the repository located at the given URI or file system path. See the "Notes" section below for more information about restrictions and suggestions for publication. See also the "Environment Variables" section.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-Use the \fB--key\fR option to specify a client SSL key file to use for package retrieval from an HTTPS repository. Use the \fB--cert\fR option to specify a client SSL certificate file to use for package retrieval from an HTTPS repository. This option pair can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not add the package to the publisher's catalog. This option is recommended whenever multiple packages are being published at one time because updates to publisher catalogs must be performed serially. Publication performance might be significantly reduced if this option is not used when multiple processes are simultaneously publishing packages. After publication is complete, the new packages can be added to the respective publisher catalogs by using the \fBpkgrepo refresh\fR command.
-.RE
-
-For a description of the \fB-T\fR option, see the \fBgenerate\fR subcommand above.
-.RE
-
-.SH ENVIRONMENT VARIABLES
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_REPO\fR\fR
-.ad
-.RS 12n
-.rt  
-The path or URI of the destination repository.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRGenerate and Publish a Package
-.sp
-.LP
-Create a package using \fBpkgsend generate\fR and publish it.
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend generate /path/to/proto > /path/to/manifests/foo.p5m\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Add the package FMRI for the \fBexample.com\fR publisher to the beginning of \fBfoo.p5m\fR.
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
-.fi
-.in -2
-
-.sp
-.LP
-The resulting manifest should look like this:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
+<refentry id="pkgsend-1">
+<refmeta><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">30 Jul 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgsend</refname><refpurpose>Image Packaging System publication client</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgsend [<replaceable>options</replaceable>] <replaceable>command</replaceable> [<replaceable>cmd_options</replaceable>] [<replaceable>operands</replaceable>]
+</synopsis>
+<synopsis>/usr/bin/pkgsend generate [-T <replaceable>pattern</replaceable>] [--target <replaceable>file</replaceable>]
+    <replaceable>source</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgsend publish [-b <replaceable>bundle</replaceable>]... [-d <replaceable>source</replaceable>]...
+    [-s <replaceable>repo_uri_or_path</replaceable>] [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [-T <replaceable>pattern</replaceable>] [--no-catalog] [<replaceable>manifest</replaceable> ...]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgsend-1-desc" role="description"><title></title>
+<para><command>pkgsend</command> enables the publication of new packages and
+new package versions to an image packaging repository using package manifests.
+To create or manage repositories, see <command>pkgrepo</command>(1). To create
+package archives from packages in an existing repository, see <command>pkgrecv</command>(1).
+For more information about package manifests, see <literal>pkg</literal>(5).</para>
+<para>After a <command>pkgsend publish</command> operation, if your <replaceable>repo_uri_or_path</replaceable> repository must support <command>pkg search</command> operations,
+run <command>pkgrepo refresh</command> on the repository to update search
+indexes.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>The following subcommands are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgsend generate</command> [<option>T</option> <replaceable>pattern</replaceable>] [<option>-target</option> <replaceable>file</replaceable>] <replaceable>source</replaceable> ...</term>
+<listitem><para>Read each <replaceable>source</replaceable> (such as an SVR4
+package, a directory, or a <command>tar</command> file) and emit the manifest
+that describes the <replaceable>source</replaceable> to <filename>stdout</filename>.
+</para>
+<para>The output manifest can then be annotated, have dependencies added or
+analyzed using <command>pkgdepend</command>, and have its correctness verified
+using <command>pkglint</command> before being passed to the <command>publish</command> subcommand.
+</para>
+<itemizedlist>
+<para>The following are supported sources:</para>
+<listitem><para>Filesystem format SVR4 packages</para></listitem>
+<listitem><para>Datastream format SVR4 packages</para></listitem>
+<listitem><para><command>tar</command> files</para></listitem>
+<listitem><para>Directories</para></listitem>
+</itemizedlist>
+<para>If the base name of files in the source match the patterns specified
+with <option>T</option>, the timestamp of the file is added to the action
+for that file. The <replaceable>pattern</replaceable> uses shell matching
+rules:</para>
+<variablelist>
+<varlistentry><term>*</term>
+<listitem><para>Matches everything.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>?</term>
+<listitem><para>Matches any single character.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>[<replaceable>seq</replaceable>]</term>
+<listitem><para>Matches any character in <replaceable>seq</replaceable>.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>![<replaceable>seq</replaceable>]</term>
+<listitem><para>Matches any character not in <replaceable>seq</replaceable>.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>When the specified source is a directory, there is no clear way to distinguish
+a <literal>file</literal> action from a <literal>hardlink</literal> action
+when there are multiple path names for a single inode. Normally, the first
+one found in the file system walk is treated as a file and the rest as hardlinks.
+This can be arbitrary, depending on the implementation of the file system.
+To specify which path names should be treated as files, pass each path name
+as an argument to the <option>-target</option> option. This option has no
+effect on other types of sources because they are capable of expressing which
+path names are files and which are hardlinks.</para>
+<para>When SVR4 packages are provided as a source, <command>pkgsend</command> checks
+that no files with class action scripts are present and no preinstall, postinstall,
+preremove, or postremove scripts are present. An exception is made for any
+SMF manifests installed with the <literal>manifest</literal> class. <literal>BASEDIR
+</literal> is removed from all relocatable paths.</para>
+<para>The SVR4 <literal>DESC</literal> parameter is converted to a <literal>pkg.description
+</literal> value. The SVR4 <literal>NAME</literal> parameter is converted
+to a <literal>pkg.summary</literal> value.</para>
+<para>When generating a manifest based on a directory, the owner and group
+for each file and directory defaults to root and bin respectively.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgsend publish</command> [<option>b</option> <replaceable>bundle</replaceable>]... [<option>d</option> <replaceable>source</replaceable>]... [<option>s</option> <replaceable>repo_uri_or_path</replaceable>] [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>T</option> <replaceable>pattern</replaceable>] [<option>-no-catalog</option>] [<replaceable>manifest</replaceable> ...]</term>
+<listitem><para>Publish a package using the specified package manifests to
+the target package repository, retrieving files for the package from the
+provided sources. If multiple manifests are specified, they are joined in the
+order provided. If a manifest is not specified, the manifest is read from
+<literal>stdin</literal>.</para>
+<para>If not specified, <command>pkgsend publish</command> adds the build
+version to the package FMRI. The <command>publish</command> tool also adds
+the timestamp (the current time in UTC) to the package FMRI. See the
+<literal>pkg</literal>(5) man page for information about the version string of
+a package FMRI.</para>
+<para>If multiple <command>pkgsend publish</command> processes might be
+publishing to the same <option>s</option> repository simultaneously, specifying
+the <option>-no-catalog</option> option is recommended. See the description of
+the <option>-no-catalog</option> option below.</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>b</option> <replaceable>bundle</replaceable></term>
+<listitem><para>Add the specified bundle to the list of sources to search
+when looking for files in the manifest. Bundles are sources such as tar files
+and SVR4 packages. If this option is specified multiple times, sources are
+searched in the order they appear on the command line. If both <option>b</option> and <option>
+d</option> are specified, <option>d</option> sources are searched first. For
+a description of supported bundles and how they are used, refer to the <command>generate
+</command> subcommand above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>source</replaceable></term>
+<listitem><para>Add the specified directory to the list of sources to search
+when looking for files in the manifest. If this option is specified multiple
+times, sources are searched in the order they appear on the command line.
+For a description of supported sources and how they are used, refer to the <command>
+generate</command> subcommand above.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>Publish the package to the repository located at the given
+URI or file system path. See the &ldquo;Notes&rdquo; section below for more
+information about restrictions and suggestions for publication. See also the &ldquo;Environment
+Variables&rdquo; section.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para>Use the <option>-key</option> option to specify a client SSL key file to use for package retrieval from an HTTPS repository. Use the <option>-cert</option> option to specify a client SSL certificate file to use for package retrieval from an HTTPS repository. This option pair can be specified multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>Do not add the package to the publisher's catalog. This option
+is recommended whenever multiple packages are being published at one time
+because updates to publisher catalogs must be performed serially. Publication
+performance might be significantly reduced if this option is not used when
+multiple processes are simultaneously publishing packages. After publication is
+complete, the new packages can be added to the respective publisher catalogs by
+using the <command>pkgrepo refresh</command> command.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>For a description of the <option>T</option> option, see the <command>generate
+</command> subcommand above.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_REPO</envar></term>
+<listitem><para>The path or URI of the destination repository.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Generate and Publish a Package</title>
+<para>Create a package using <command>pkgsend generate</command> and publish
+it.</para>
+<screen>$ <userinput>pkgsend generate /path/to/proto > /path/to/manifests/foo.p5m</userinput></screen>
+<para>Add the package FMRI for the <literal>example.com</literal> publisher
+to the beginning of <filename>foo.p5m</filename>.</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]</programlisting>
+<para>The resulting manifest should look like this:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]
 dir group=sys mode=0755 owner=root path=usr
 dir group=bin mode=0755 owner=root path=usr/bin
-file usr/bin/foo group=bin mode=0555 owner=root path=usr/bin/foo
-.fi
-.in -2
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s http://example.com:10000 -d /path/to/proto \e\fR
-\fB/path/to/manifests/foo.p5m\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRCreate and Publish a Trivial Package
-.sp
-.LP
-Create a manifest for publisher \fBexample.com\fR containing the following lines:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
-file /exdir/foo mode=0555 owner=root group=bin path=/usr/bin/foo
-.fi
-.in -2
-
-.sp
-.LP
-Publish the package:
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s http://example.com:10000 -d /exdir\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 3 \fRUse a Preexisting Manifest
-.sp
-.LP
-Publish a package using file system based publication and a preexisting manifest.
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s /tmp/example_repo -d /tmp/pkg_files \e\fR
-\fB/tmp/pkg_manifest\fR
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
+file usr/bin/foo group=bin mode=0555 owner=root path=usr/bin/foo</programlisting>
+<screen>$ <userinput>pkgsend publish -s http://example.com:10000 -d /path/to/proto &bsol;</userinput>
+<userinput>/path/to/manifests/foo.p5m</userinput></screen>
+</example>
+<example><title>Create and Publish a Trivial Package</title>
+<para>Create a manifest for publisher <literal>example.com</literal> containing
+the following lines:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]
+file /exdir/foo mode=0555 owner=root group=bin path=/usr/bin/foo</programlisting>
+<para>Publish the package:</para>
+<screen>$ <userinput>pkgsend publish -s http://example.com:10000 -d /exdir</userinput></screen>
+</example>
+<example><title>Use a Preexisting Manifest</title>
+<para>Publish a package using file system based publication and a preexisting
+manifest.</para>
+<screen>$ <userinput>pkgsend publish -s /tmp/example_repo -d /tmp/pkg_files &bsol;</userinput>
+<userinput>/tmp/pkg_manifest</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgdepend-1"><citerefentry><refentrytitle>pkgdepend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="PKDEV"><citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>Because of publication protocol limitations, file system based publication
+must be used when publishing individual package files that are greater than
+128 MB in size. File system based publication is also recommended when access
+control for a repository is needed.</para>
+<para>When using file system based publication, any <command>pkg.depotd</command> processes
+that are serving the target repository must be restarted after publication
+is completed for the changes to be reflected in its web interface or search
+responses. See <command>pkg.depotd</command>(1M) for more information.</para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkgdepend\fR(1), \fBpkgrepo\fR(1), \fBpkg.depotd\fR(1M), \fBpkg\fR(5)
-.sp
-.LP
-\fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH NOTES
-.sp
-.LP
-Because of publication protocol limitations, file system based publication must be used when publishing individual package files that are greater than 128 MB in size. File system based publication is also recommended when access control for a repository is needed.
-.sp
-.LP
-When using file system based publication, any \fBpkg.depotd\fR processes that are serving the target repository must be restarted after publication is completed for the changes to be reflected in its web interface or search responses. See \fBpkg.depotd\fR(1M) for more information.
--- a/src/man/pkgsign.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgsign.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,240 +1,184 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgsign 1 "21 May 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgsign \- Image Packaging System signing utility
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgsign [-a \fIhash_algorithm\fR]
-    [-c \fIpath_to_signing_certificate\fR]
-    [-i \fIpath_to_intermediate_cert\fR] ...
-    [-k \fIpath_to_private_key\fR] [-n] -s \fIpath_or_uri\fR
-    [--help] [--no-index] [--no-catalog]
-    (\fIfmri\fR|\fIpattern\fR) ...
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgsign\fR updates the manifest for the given FMRIs in place in the repository by adding a signature action using the provided key and certificates. The modified package retains the original timestamp.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIhash_algorithm\fR\fR
-.ad
-.sp .6
-.RS 4n
-Use the signature algorithm \fIhash_algorithm\fR instead of the default. The default signature algorithm is \fBrsa-sha256\fR. Supported signature algorithms are \fBrsa-sha256\fR, \fBrsa-sha384\fR, \fBrsa-sha512\fR, \fBsha256\fR, \fBsha384\fR, and \fBsha512\fR. A signature algorithm that only specifies a hash algorithm causes the signature value to be the hash of the manifest of the package. A signature algorithm that specifies \fBrsa\fR and a hash algorithm causes the signature value to be the hash of the manifest signed with the private key provided (see the \fB-c\fR and \fB-k\fR options).
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIpath_to_signing_certificate\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the certificate \fIpath_to_signing_certificate\fR as the certificate to use when verifying the value of the signature in the action. The \fB-c\fR option can only be used with the \fB-k\fR option.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIpath_to_intermediate_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-Add the certificate \fIpath_to_intermediate_cert\fR as a certificate to use when validating the certificate \fIpath_to_signing_certificate\fR given as an argument to \fB-c\fR. Multiple certificates can be provided by specifying \fB-i\fR multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIpath_to_private_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-Use the private key stored in \fIpath_to_private_key\fR to sign the manifest. The \fB-k\fR option can only be used with the \fB-c\fR option. If \fB-k\fR is not set, then the signature value is the hash of the manifest.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run that does not change the repository in any way.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-Sign packages in the repository at \fIpath_or_uri\fR.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not update the repository search indexes after the signed manifest has been republished.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-Do not update the repository catalog after the signed manifest has been republished.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRSign Using the Hash Value of the Manifest
-.sp
-.LP
-Sign a package published to \fBhttp://localhost:10000\fR using the hash value of the manifest. This is often useful for testing.
-
-.sp
-.in +2
-.nf
-$ \fBpkgsign -s http://localhost:10000 -a sha256 \e\fR
-\[email protected],5.11-0:20100626T030108Z\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fBExample 2 \fRSign Using a Key and Certificate
-.sp
-.LP
-Sign a package published into the file repository in \fB/foo/bar\fR using \fBrsa-sha384\fR to hash and sign the manifest. The signature key is in \fB/key/usr2.key\fR, its associated certificate is in \fB/key/usr2.cert\fR, and a certificate needed to validate the certificate is in \fB/icerts/usr1.cert\fR.
-
-.sp
-.in +2
-.nf
-$ \fBpkgsign -s file:///foo/bar/ -a rsa-sha384 \e\fR
-\fB-k /key/usr2.key -c /key/usr2.cert -i /icerts/usr1.cert \e\fR
-\[email protected],5.11-0:20100626T031341Z\fR
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
+<refentry id="pkgsign-1">
+<refmeta><refentrytitle>pkgsign</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">21 May 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgsign</refname><refpurpose>Image Packaging System signing utility</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgsign [-a <replaceable>hash_algorithm</replaceable>]
+    [-c <replaceable>path_to_signing_certificate</replaceable>]
+    [-i <replaceable>path_to_intermediate_cert</replaceable>] ...
+    [-k <replaceable>path_to_private_key</replaceable>] [-n] -s <replaceable>path_or_uri
+</replaceable>
+    [--help] [--no-index] [--no-catalog]
+    (<replaceable>fmri</replaceable>|<replaceable>pattern</replaceable>) ...</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgsign-1-desc" role="description"><title></title>
+<para><command>pkgsign</command> updates the manifest for the given FMRIs
+in place in the repository by adding a signature action using the provided
+key and certificates. The modified package retains the original timestamp.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option> <replaceable>hash_algorithm</replaceable></term>
+<listitem><para>Use the signature algorithm <replaceable>hash_algorithm</replaceable> instead
+of the default. The default signature algorithm is <literal>rsa-sha256</literal>.
+Supported signature algorithms are <literal>rsa-sha256</literal>, <literal>rsa-sha384
+</literal>, <literal>rsa-sha512</literal>, <literal>sha256</literal>, <literal>sha384
+</literal>, and <literal>sha512</literal>. A signature algorithm that only
+specifies a hash algorithm causes the signature value to be the hash of the
+manifest of the package. A signature algorithm that specifies <literal>rsa</literal> and
+a hash algorithm causes the signature value to be the hash of the manifest
+signed with the private key provided (see the <option>c</option> and <option>k</option> options).
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>path_to_signing_certificate</replaceable></term>
+<listitem><para>Add the certificate <replaceable>path_to_signing_certificate</replaceable> as
+the certificate to use when verifying the value of the signature in the action.
+The <option>c</option> option can only be used with the <option>k</option> option.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>path_to_intermediate_cert</replaceable></term>
+<listitem><para>Add the certificate <replaceable>path_to_intermediate_cert</replaceable> as
+a certificate to use when validating the certificate <replaceable>path_to_signing_certificate
+</replaceable> given as an argument to <option>c</option>. Multiple certificates
+can be provided by specifying <option>i</option> multiple times.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>path_to_private_key</replaceable></term>
+<listitem><para>Use the private key stored in <replaceable>path_to_private_key</replaceable> to
+sign the manifest. The <option>k</option> option can only be used with the <option>
+c</option> option. If <option>k</option> is not set, then the signature value
+is the hash of the manifest.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run that does not change the repository in
+any way.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>path_or_uri</replaceable></term>
+<listitem><para>Sign packages in the repository at <replaceable>path_or_uri</replaceable>.
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>Do not update the repository search indexes after the signed
+manifest has been republished.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>Do not update the repository catalog after the signed manifest
+has been republished.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Sign Using the Hash Value of the Manifest</title>
+<para>Sign a package published to <literal>http://localhost:10000</literal> using
+the hash value of the manifest. This is often useful for testing.</para>
+<screen>$ <userinput>pkgsign -s http://localhost:10000 -a sha256 &bsol;</userinput>
+<userinput>[email protected],5.11-0:20100626T030108Z</userinput></screen>
+</example>
+<example><title>Sign Using a Key and Certificate</title>
+<para>Sign a package published into the file repository in <literal>/foo/bar</literal> using <literal>
+rsa-sha384</literal> to hash and sign the manifest. The signature key is in <literal>
+/key/usr2.key</literal>, its associated certificate is in <literal>/key/usr2.cert
+</literal>, and a certificate needed to validate the certificate is in <literal>/icerts/usr1.cert
+</literal>.</para>
+<screen>$ <userinput>pkgsign -s file:///foo/bar/ -a rsa-sha384 &bsol;</userinput>
+<userinput>-k /key/usr2.key -c /key/usr2.cert -i /icerts/usr1.cert &bsol;</userinput>
+<userinput>[email protected],5.11-0:20100626T031341Z</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>Multiple operations were requested, but only some of them
+succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkgrecv-1"><citerefentry><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-Multiple operations were requested, but only some of them succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkg\fR(1), \fBpkgrecv\fR(1), \fBpkgsend\fR(1), \fBpkgrepo\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pkgsurf.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pkgsurf.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,261 +1,145 @@
-'\" te
-.\" Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pkgsurf 1 "09 Aug 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pkgsurf \- Image Packaging System repository resurfacing utility
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pkgsurf -s \fItarget_repo\fR -r \fIreference_repo\fR [-n]
-    [-p \fIpublisher_prefix\fR]... [-i \fIname\fR]... [-c \fIpattern\fR]...
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpkgsurf\fR is a package publication tool for replacing packages in a target repository that have not changed since the latest published version in the reference repository. The result is a new version surface of all packages in the target repository.
-.sp
-.LP
-\fBpkgsurf\fR operations are not reversible. In case the \fBpkgsurf\fR operation must be reverted, you should store the target repository in its own ZFS dataset and take a snapshot of the dataset before you run \fBpkgsurf\fR.
-.sp
-.LP
-Packages in the target repository are compared to packages in the reference repository and analyzed for content changes. For each package, if no content change is found, the package manifest is removed from the target repository and replaced with the manifest of the same package from the reference repository.
-.sp
-.LP
-The target repository must be a file system based repository. For optimal performance, the reference repository should also be a file system based repository.
-.sp
-.LP
-The target repository should contain only one version of each package. If the target repository contains a package that is both newer than the latest version in the reference repository and older than the latest version in the target repository, no package manifest replacement is done for that package.
-.sp
-.LP
-The reference repository can contain one or more versions of each package. However, only the latest version will be used for comparison.
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIpattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-Treat every package whose FMRI matches \fIpattern\fR as changed and do not reversion it, even if there is no content change. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIname\fR\fR
-.ad
-.sp .6
-.RS 4n
-Ignore \fBset\fR actions with the \fBname\fR field set to \fIname\fR for determination of content change. The package will be reversioned even if this action differs between target and reference versions. This option can be specified multiple times.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-Perform a trial run of the operation with no changes made to the target repository.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher_prefix\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the name of the publisher to be resurfaced. This option can be specified multiple times.
-.sp
-By default, packages from all publishers found in target and reference repositories are resurfaced.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR \fIreference_repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the URI of the reference repository to be used for manifest comparison. Only the latest version of each package is considered.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fItarget_repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-Specify the path to the target repository. Packages in this repository are reversioned to the versions present in the reference repository according to the comparison results. The target repository should contain only one version of each package. The target repository must be a file system based repository.
-.RE
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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;
+]>
 
-.SH ENVIRONMENT VARIABLES
-.sp
-.LP
-The following environment variable is supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_REPO\fR\fR
-.ad
-.RS 12n
-.rt  
-The absolute path of the target repository.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRResurface a Repository
-.sp
-.LP
-Reversion each package in the target repository that did not have any content change from the same package in the reference repository.
-
-.sp
-.in +2
-.nf
-$ \fBpkgsurf -s /path/to/target -r http://reference.example.com\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-Sample package in the target repository:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]:20381001T163427Z
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Sample package in the reference repository:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]:20381001T163427Z
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-Sample package in the target repository after the \fBpkgsurf\fR operation:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]:20381001T163427Z
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
+<refentry id="pkgsurf-1">
+<refmeta><refentrytitle>pkgsurf</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">09 Aug 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgsurf</refname><refpurpose>Image Packaging System repository resurfacing utility</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgsurf -s <replaceable>target_repo</replaceable> -r <replaceable>reference_repo</replaceable> [-n]
+    [-p <replaceable>publisher_prefix</replaceable>]... [-i <replaceable>name</replaceable>]... [-c <replaceable>pattern</replaceable>]...</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgsurf-1-desc" role="description"><title></title>
+<para><command>pkgsurf</command> is a package publication tool for replacing packages in a target repository that have not changed since the latest published version in the reference repository. The result is a new version surface of all packages in the target repository.</para>
+<para><command>pkgsurf</command> operations are not reversible. In case the <command>pkgsurf</command> operation must be reverted, you should store the target repository in its own ZFS dataset and take a snapshot of the dataset before you run <command>pkgsurf</command>.</para>
+<para>Packages in the target repository are compared to packages in the reference repository and analyzed for content changes. For each package, if no content change is found, the package manifest is removed from the target repository and replaced with the manifest of the same package from the reference repository.</para>
+<para>The target repository must be a file system based repository. For optimal performance, the reference repository should also be a file system based repository.</para>
+<para>The target repository should contain only one version of each package. If the target repository contains a package that is both newer than the latest version in the reference repository and older than the latest version in the target repository, no package manifest replacement is done for that package.
+</para>
+<para>The reference repository can contain one or more versions of each package. However, only the latest version will be used for comparison.</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>?</option></term><term><option>-help</option></term><listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>pattern</replaceable></term>
+<listitem><para>Treat every package whose FMRI matches <replaceable>pattern</replaceable> as changed and do not reversion it, even if there is no content change. This option can be specified multiple times.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>name</replaceable></term>
+<listitem><para>Ignore <literal>set</literal> actions with the <literal>name</literal> field set to <replaceable>name</replaceable> for determination of content change. The package will be reversioned even if this action differs between target and reference versions. This option can be specified multiple times.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>Perform a trial run of the operation with no changes made to the target repository.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher_prefix</replaceable></term>
+<listitem><para>Specify the name of the publisher to be resurfaced. This option can be specified multiple times.</para>
+<para>By default, packages from all publishers found in target and reference repositories are resurfaced.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>r</option> <replaceable>reference_repo</replaceable></term>
+<listitem><para>Specify the URI of the reference repository to be used for manifest comparison. Only the latest version of each package is considered.</para></listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>target_repo</replaceable></term>
+<listitem><para>Specify the path to the target repository. Packages in this repository are reversioned to the versions present in the reference repository according to the comparison results. The target repository should contain only one version of each package. The target repository must be a file system based repository.</para></listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<para>The following environment variable is supported:</para>
+<variablelist>
+<varlistentry><term><envar>PKG_REPO</envar></term>
+<listitem><para>The absolute path of the target repository.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Resurface a Repository</title>
+<para>Reversion each package in the target repository that did not have any content change from the same package in the reference repository.</para>
+<screen>$ <userinput>pkgsurf -s /path/to/target -r http://reference.example.com</userinput></screen>
+<para>Sample package in the target repository:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Sample package in the reference repository:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>Sample package in the target repository after the <command>pkgsurf</command> operation:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Command succeeded.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>An unanticipated exception occurred.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>, <olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP"><citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-Command succeeded.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-An unanticipated exception occurred.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpkgrepo\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fICopying and Creating Package Repositories in Oracle Solaris 11.2\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/pm-updatemanager.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/pm-updatemanager.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,176 +1,133 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
-.TH pm-updatemanager 1 "21 May 2013" "SunOS 5.11" "User Commands"
-.SH NAME
-pm-updatemanager \- application to update packages
-.SH SYNOPSIS
-.LP
-.nf
-/usr/bin/pm-updatemanager [\fIoptions\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pm-updatemanager [-h | --help] [-d | --debug]
-    [-R \fIdir\fR | --image-dir \fIdir\fR]
-.fi
-
-.SH DESCRIPTION
-.sp
-.LP
-\fBpm-updatemanager\fR checks for and installs available updates for the packages installed on the system.
-.LP
-Note - 
-.sp
-.RS 2
-If the \fBpackage/pkg\fR, \fBpackage/pkg/package-manager\fR, or \fBpackage/pkg/update-manager\fR packages need to be updated, \fBpm-updatemanager\fR first updates these packages and then restarts to carry out any remaining updates.
-.RE
-.SH OPTIONS
-.sp
-.LP
-The following options are supported:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-Display a usage message.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.br
-.na
-\fB\fB--debug\fR\fR
-.ad
-.sp .6
-.RS 4n
-Run \fBpm-updatemanager\fR in debug mode.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.br
-.na
-\fB\fB--image-dir\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-Operate on the image rooted at \fIdir\fR, rather than on the image discovered automatically.
-.RE
-
-.SH EXAMPLES
-.LP
-\fBExample 1 \fRUpdate the Current Image
-.sp
-.LP
-Invoke \fBpm-updatemanager\fR on the current image. This checks for and installs all available updates for packages installed in the current image.
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!--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 id="pm-updatemanager-1">
+<!-- %Z%%M% %I% %E% SMI; -->
+<refmeta><refentrytitle>pm-updatemanager</refentrytitle><manvolnum>1</manvolnum>
+<refmiscinfo class="date">21 May 2013</refmiscinfo>
+<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
+<refmiscinfo class="software">&release;</refmiscinfo>
+<refmiscinfo class="arch">generic</refmiscinfo>
+<refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its
+affiliates. All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pm-updatemanager</refname><refpurpose>application to update packages</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pm-updatemanager [<replaceable>options</replaceable>]</synopsis>
+<synopsis>/usr/bin/pm-updatemanager [-h | --help] [-d | --debug]
+    [-R <replaceable>dir</replaceable> | --image-dir <replaceable>dir</replaceable>]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pm-updatemanager-1-desc" role="description"><title></title>
+<para><command>pm-updatemanager</command> checks for and installs available
+updates for the packages installed on the system.</para>
+<note><para>If the <literal>package/pkg</literal>, <literal>package/pkg/package-manager
+</literal>, or <literal>package/pkg/update-manager</literal> packages need
+to be updated, <command>pm-updatemanager</command> first updates these packages
+and then restarts to carry out any remaining updates.</para></note>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>The following options are supported:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>Display a usage message.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term><term><option>-debug</option></term>
+<listitem><para>Run <command>pm-updatemanager</command> in debug mode.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term>
+<term><option>-image-dir</option> <replaceable>dir</replaceable></term>
+<listitem><para>Operate on the image rooted at <replaceable>dir</replaceable>,
+rather than on the image discovered automatically.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>Update the Current Image</title>
+<para>Invoke <command>pm-updatemanager</command> on the current image. This
+checks for and installs all available updates for packages installed in the
+current image.</para>
+<screen>$ <userinput>/usr/lib/pm-launch pm-updatemanager</userinput></screen>
+<para>This is the same command that the desktop menu option System>Administration>Update
+Manager invokes.</para>
+</example>
+<example><title>Update a Specified Image</title>
+<para>Invoke <command>pm-updatemanager</command> on the image stored at <literal>
+/aux0/example_root</literal>.</para>
+<screen>$ <userinput>/usr/lib/pm-launch pm-updatemanager -R /aux0/example_root</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>The following exit values are returned:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>Everything worked.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>An error occurred.</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>Invalid command line options were specified.</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>See <literal>attributes</literal>(5) for descriptions of the following
+attributes:</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*"
+align="left"/><colspec colname="col2" colwidth="198*" align="left"/><thead>
+<row>
+<entry align="center">
+<para>ATTRIBUTE TYPE</para>
+</entry>
+<entry align="center">
+<para>ATTRIBUTE VALUE</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>Availability</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg/update-manager</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>Interface Stability</para>
+</entry>
+<entry align="left">
+<para>Uncommitted</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="packagemanager-1"><citerefentry><refentrytitle>packagemanager</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>,
+<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>When operating on an image you do not own, <command>pm-updatemanager</command> needs
+to be invoked with enough privilege. You will normally invoke <command>pm-updatemanager
+</command> using <literal>/usr/lib/pm-launch</literal> under these circumstances.
+</para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-$ \fB/usr/lib/pm-launch pm-updatemanager\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-This is the same command that the desktop menu option System>Administration>Update Manager invokes.
-
-.LP
-\fBExample 2 \fRUpdate a Specified Image
-.sp
-.LP
-Invoke \fBpm-updatemanager\fR on the image stored at \fB/aux0/example_root\fR.
-
-.sp
-.in +2
-.nf
-$ \fB/usr/lib/pm-launch pm-updatemanager -R /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.SH EXIT STATUS
-.sp
-.LP
-The following exit values are returned:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 5n
-.rt  
-Everything worked.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 5n
-.rt  
-An error occurred.
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 5n
-.rt  
-Invalid command line options were specified.
-.RE
-
-.SH ATTRIBUTES
-.sp
-.LP
-See \fBattributes\fR(5) for descriptions of the following attributes:
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
-_
-Availability\fBpackage/pkg/update-manager\fR
-_
-Interface StabilityUncommitted
-.TE
-
-.SH SEE ALSO
-.sp
-.LP
-\fBpackagemanager\fR(1), \fBpkg\fR(1), \fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH NOTES
-.sp
-.LP
-When operating on an image you do not own, \fBpm-updatemanager\fR needs to be invoked with enough privilege. You will normally invoke \fBpm-updatemanager\fR using \fB/usr/lib/pm-launch\fR under these circumstances.
--- a/src/man/zh_CN/packagemanager.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/packagemanager.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,288 +1,153 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH packagemanager 1 "2013 年 5 月 21 日" "SunOS 5.11" "用户命令"
-.SH 名称
-packagemanager \- 映像包管理系统的 GUI
-.SH 用法概要
-.LP
-.nf
-/usr/bin/packagemanager [\fIoptions\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/packagemanager [-h | --help]
-    [-i | --info-install \fIfile\fR] [-U | --update-all]
-    [-R | --image-dir \fIdir\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/packagemanager [\fIfile\fR]
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpackagemanager\fR 是映像包管理系统软件 \fB pkg\fR(5) 的图形用户界面。
-.sp
-.LP
-使用软件包管理器,您可以执行以下任务:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-搜索、安装和删除软件包。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-添加、删除和修改发布者。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-创建、删除和管理引导环境。
-.RE
-.sp
-.LP
-如果指定了 \fIfile\fR 操作数且其后缀为 \fB\&.p5i\fR,\fBpackagemanager\fR 将在 Web 安装模式下启动,可添加一个或多个发布者并为每个发布者添加多个软件包。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIfile\fR\fR
-.ad
-.br
-.na
-\fB\fB--info-install\fR \fIfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定 \fB\&.p5i\fR 文件以在 Web 安装模式下运行 \fBpackagemanager\fR。\fIfile\fR 必须具有后缀 \fB\&.p5i\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.br
-.na
-\fB\fB--image-dir\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-对根目录为 \fIdir\fR 的映像(而不是自动搜索到的映像)执行操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-U\fR\fR
-.ad
-.br
-.na
-\fB\fB--update-all\fR\fR
-.ad
-.sp .6
-.RS 4n
-更新所有具有可用更新的已安装软件包。
-.LP
-注 - 
-.sp
-.RS 2
-如果 \fBpackage/pkg\fR、\fBpackage/pkg/package-manager \fR 或 \fBpackage/pkg/update-manager\fR 软件包需要更新,则 \fBpackagemanager\fR 首先更新这些软件包,然后重新启动以完成其余所有更新。
-.RE
-.RE
-
-.SH 操作数
-.sp
-.ne 2
-.mk
-.na
-\fB\fIfile\fR\fR
-.ad
-.RS 8n
-.rt  
-Web 安装文件。该文件必须具有后缀 \fB\&.p5i\fR。有关 Web 安装的更多信息,请参见软件包管理器联机帮助。
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR对当前映像执行操作
-.sp
-.LP
-对当前映像调用 \fBpackagemanager\fR。
+<?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="zh" id="packagemanager-1">
+<!-- %Z%%M% %I% %E% SMI; -->
+<refmeta><refentrytitle>packagemanager</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo> 
+</refmeta>
+<refnamediv>
+<refname>packagemanager</refname><refpurpose>映像包管理系统的 GUI</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/packagemanager [<replaceable>options</replaceable>]</synopsis>
+<synopsis>/usr/bin/packagemanager [-h | --help]
+    [-i | --info-install <replaceable>file</replaceable>] [-U | --update-all]
+    [-R | --image-dir <replaceable>dir</replaceable>]</synopsis>
+<synopsis>/usr/bin/packagemanager [<replaceable>file</replaceable>]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="packagemanager-1-desc" role="description"><title></title>
+<para><command>packagemanager</command> 是映像包管理系统软件 <literal> pkg</literal>(5) 的图形用户界面。</para>
+<itemizedlist>
+<para>使用软件包管理器,您可以执行以下任务:</para>
+<listitem><para>搜索、安装和删除软件包。</para></listitem>
+<listitem><para>添加、删除和修改发布者。</para></listitem>
+<listitem><para>创建、删除和管理引导环境。</para></listitem>
+</itemizedlist>
+<para>如果指定了 <replaceable>file</replaceable> 操作数且其后缀为 <literal>.p5i</literal>,<command>packagemanager</command> 将在 Web 安装模式下启动,可添加一个或多个发布者并为每个发布者添加多个软件包。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>支持以下选项:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>file</replaceable></term> <term><option>-info-install</option> <replaceable>file</replaceable></term>
+<listitem><para>指定 <literal>.p5i</literal> 文件以在 Web 安装模式下运行 <command>packagemanager</command>。<replaceable>file</replaceable> 必须具有后缀 <literal>.p5i</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term> <term><option>-image-dir</option> <replaceable>dir</replaceable></term>
+<listitem><para>对根目录为 <replaceable>dir</replaceable> 的映像(而不是自动搜索到的映像)执行操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>U</option></term><term><option>-update-all</option></term>
+<listitem><para>更新所有具有可用更新的已安装软件包。</para>
+<note><para>如果 <literal>package/pkg</literal>、<literal>package/pkg/package-manager </literal> 或 <literal>package/pkg/update-manager</literal> 软件包需要更新,则 <command>packagemanager</command> 首先更新这些软件包,然后重新启动以完成其余所有更新。</para></note>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="operands"><title></title>
+<variablelist>
+<varlistentry><term><replaceable>file</replaceable></term>
+<listitem><para>Web 安装文件。该文件必须具有后缀 <literal>.p5i</literal>。有关 Web 安装的更多信息,请参见软件包管理器联机帮助。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>对当前映像执行操作</title>
+<para>对当前映像调用 <command>packagemanager</command>。</para>
+<screen>$ <userinput>packagemanager</userinput></screen>
+</example>
+<example><title>对指定映像执行操作</title>
+<para>对存储在 <filename>/aux0/example_root </filename> 中的映像调用 <command>packagemanager</command>。</para>
+<screen>$ <userinput>packagemanager -R /aux0/example_root</userinput></screen>
+</example>
+<example><title>在 Web 安装模式下调用</title>
+<para>在 Web 安装模式下调用 <command>packagemanager</command>。</para>
+<screen>$ <userinput>packagemanager ~/test.p5i</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>一切正常工作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para>因为 <literal>pkg</literal>(5) 映像可位于任意一个较大的文件系统内,需要使用标记 <envar>$IMAGE_ROOT</envar> 来区分相对路径。对于典型系统安装,<envar>$IMAGE_ROOT</envar> 等效于 /。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>完整或部分映像的元数据目录。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>用户映像的元数据目录。</para>
+<para>在特定映像的元数据中,某些文件和目录包含修复和恢复期间有用的信息。标记 <envar>$IMAGE_META </envar> 用于指示包含元数据的顶层目录。<envar> $IMAGE_META</envar> 通常是以上给出的两个路径之一。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/gui-cache</filename></term>
+<listitem><para>缓存元数据的位置,<command>packagemanager </command> 维护高速缓存元数据,以便加速程序启动及发布者之间的转换。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><envar>$IMAGE_META</envar> 目录分层结构中的其他路径是专用的,但可以进行更改。</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg/package-manager</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pm-updatemanager-1"><citerefentry><refentrytitle>pm-updatemanager</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para>软件包管理器联机帮助</para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>需要使用足够的特权调用 <command>packagemanager</command> 以便对映像的文件和目录执行操作。</para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-$ \fBpackagemanager\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR对指定映像执行操作
-.sp
-.LP
-对存储在 \fB/aux0/example_root \fR 中的映像调用 \fBpackagemanager\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpackagemanager -R /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 3 \fR在 Web 安装模式下调用
-.sp
-.LP
-在 Web 安装模式下调用 \fBpackagemanager\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpackagemanager ~/test.p5i\fR
-.fi
-.in -2
-.sp
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 5n
-.rt  
-一切正常工作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 5n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 5n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.SH 文件
-.sp
-.LP
-因为 \fBpkg\fR(5) 映像可位于任意一个较大的文件系统内,需要使用标记 \fB$IMAGE_ROOT\fR 来区分相对路径。对于典型系统安装,\fB$IMAGE_ROOT\fR 等效于 /。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-完整或部分映像的元数据目录。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户映像的元数据目录。
-.sp
-在特定映像的元数据中,某些文件和目录包含修复和恢复期间有用的信息。标记 \fB$IMAGE_META \fR 用于指示包含元数据的顶层目录。\fB $IMAGE_META\fR 通常是以上给出的两个路径之一。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/gui-cache\fR\fR
-.ad
-.sp .6
-.RS 4n
-缓存元数据的位置,\fBpackagemanager \fR 维护高速缓存元数据,以便加速程序启动及发布者之间的转换。
-.RE
-
-.sp
-.LP
-\fB$IMAGE_META\fR 目录分层结构中的其他路径是专用的,但可以进行更改。
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg/package-manager\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpm-updatemanager\fR(1)、\fBpkg\fR(1)、\fBpkg\fR(5)
-.sp
-.LP
-软件包管理器联机帮助
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 附注
-.sp
-.LP
-需要使用足够的特权调用 \fBpackagemanager\fR 以便对映像的文件和目录执行操作。
--- a/src/man/zh_CN/pkg.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkg.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,3251 +1,1374 @@
-'\" te
-.\" Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved.
-.TH pkg 1 "2014 年 4 月 7 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkg \- 映像包管理系统的检索客户端
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkg [\fIoptions\fR] command [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
+<?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;
+]>
 
-.LP
-.nf
-/usr/bin/pkg refresh [-q] [--full] [\fIpublisher\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg install [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+<refentry lang="zh" id="pkg-1">
+<refmeta><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2015 年 4 月 22 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg</refname><refpurpose>映像包管理系统的检索客户端</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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg exact-install [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...  \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg uninstall [-nvq] [-C \fIn\fR]
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg update [-fnvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--reject \fIpkg_fmri_pattern\fR]...
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg list [-Hafnqsuv] [-g \fIpath_or_uri\fR]...
-    [--no-refresh] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg info [-lqr] [-g \fIpath_or_uri\fR]... [--license]
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg contents [-Hmr] [-a \fIattribute\fR=\fIpattern\fR]...
-    [-g \fIpath_or_uri\fR]... [-o \fIattribute\fR[,\fIattribute\fR]...]...
-    [-s \fIsort_key\fR] [-t \fIaction_name\fR[,\fIaction_name\fR]...]...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg search [-HIaflpr]
-    [-o \fIattribute\fR[,\fIattribute\fR]...]... [-s \fIrepo_uri\fR] \fIquery\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg verify [-Hqv] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg fix [--accept] [--licenses]
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg revert [-nv] [--no-be-activate]
+    [--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 verify [-Hqv] [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkg fix [-Hnvq] [--no-be-activate]
     [--no-backup-be | --require-backup-be]
-    [--backup-be-name \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    (--tagged \fItag-name\fR ... | \fIpath-to-file\fR ...)
-.fi
-
-.LP
-.nf
-/usr/bin/pkg mediator [-aH] [-F \fIformat\fR] [\fImediator\fR ...]
-.fi
-
-.LP
-.nf
-usr/bin/pkg set-mediator [-nv] [-I \fIimplementation\fR]
-    [-V \fIversion\fR] [--no-be-activate]
+    [--backup-be-name <replaceable>name</replaceable>]
+    [--deny-new-be | --require-new-be] [--be-name <replaceable>name</replaceable>]
+    [--accept] [--licenses] [<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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    \fImediator\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-mediator [-nvIV] [--no-be-activate]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    \fImediator\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg variant [-Haiv] [-F \fIformat\fR] [\fIvariant_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg change-variant [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIvariant_name\fR=\fIvalue\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg facet [-Haim] [-F \fIformat\fR] [\fIfacet_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg change-facet [-nvq] [-C \fIn\fR] [-g \fIpath_or_uri\fR]...
-    [-r [[-z \fIzonename\fR]... | [-Z \fIzonename\fR]... ]]
+    [--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 \fIname\fR]
-    [--deny-new-be | --require-new-be] [--be-name \fIname\fR]
-    [--sync-actuators | --sync-actuators-timeout \fItimeout\fR]
-    \fIfacet_name\fR=(True|False|None) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg avoid [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unavoid [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg freeze [-n] [-c \fIreason\fR] [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unfreeze [-n] [\fIpkg_name_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg property [-H] [\fIpropname\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-property \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg add-property-value \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg remove-property-value \fIpropname\fR \fIpropvalue\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-property \fIpropname\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg publisher [-HPn] [-F \fIformat\fR] [\fIpublisher\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-publisher [-Ped] [-c \fIssl_cert\fR] [-k \fIssl_key\fR]
-    [-g \fIorigin_to_add\fR | --add-origin \fIorigin_to_add\fR]...
-    [-G \fIorigin_to_remove\fR | --remove-origin \fIorigin_to_remove\fR]...
-    [-m \fImirror_to_add\fR | --add-mirror \fImirror_to_add\fR]...
-    [-M \fImirror_to_remove\fR | --remove-mirror \fImirror_to_remove\fR]...
+    [--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 \fIpublisher\fR]
-    [--search-before \fIpublisher\fR] [--search-first]
-    [--approve-ca-cert \fIpath_to_CA\fR]
-    [--revoke-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--unset-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--add-property-value \fIname_of_property\fR=\fIvalue_to_add\fR]
-    [--remove-property-value \fIname_of_property\fR=\fIvalue_to_remove\fR]
-    [--unset-property \fIname_of_property_to_delete\fR]
-    [--proxy \fIproxy_to_use\fR] \fIpublisher\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkg set-publisher -p \fIrepo_uri\fR [-Ped]
-    [-c \fIssl_cert\fR] [-k \fIssl_key\fR] [--non-sticky] [--sticky]
-    [--search-after \fIpublisher\fR] [--search-before \fIpublisher\fR]
-    [--search-first] [--approve-ca-cert \fIpath_to_CA\fR]
-    [--revoke-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--unset-ca-cert \fIhash_of_CA_to_remove\fR]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--add-property-value \fIname_of_property\fR=\fIvalue_to_add\fR]
-    [--remove-property-value \fIname_of_property\fR=\fIvalue_to_remove\fR]
-    [--unset-property \fIname_of_property_to_delete\fR]
-    [--proxy \fIproxy_to_use\fR] [\fIpublisher\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkg unset-publisher \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg history [-HNl]
-    [-n \fInumber\fR] [-o \fIcolumn\fR[,\fIcolumn\fR]...]...
-    [-t \fItime\fR | \fItime\fR-\fItime\fR[,\fItime\fR | \fItime\fR-\fItime\fR]...]...
-.fi
-
-.LP
-.nf
-/usr/bin/pkg purge-history
-.fi
-
-.LP
-.nf
-/usr/bin/pkg rebuild-index
-.fi
-
-.LP
-.nf
-/usr/bin/pkg update-format
-.fi
-
-.LP
-.nf
-/usr/bin/pkg version
-.fi
-
-.LP
-.nf
-/usr/bin/pkg help
-.fi
-
-.LP
-.nf
-/usr/bin/pkg image-create [-FPUfz] [--force]
+    [--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</synopsis>
+<synopsis>/usr/bin/pkg image-create [-FPUfz] [--force]
     [--full | --partial | --user] [--zone]
-    [-c \fIssl_cert\fR] [-k \fIssl_key\fR]
-    [-g \fIpath_or_uri\fR | --origin \fIpath_or_uri\fR]...
-    [-m \fIuri\fR | --mirror \fIuri\fR]...
-    [--facet \fIfacet_name\fR=(True|False)]... [--no-refresh]
-    [--set-property \fIname_of_property\fR=\fIvalue\fR]
-    [--variant \fIvariant_name\fR=\fIvalue\fR]...
-    [(-p | --publisher) [\fIname\fR=]\fIrepo_uri\fR] \fIdir\fR
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpkg\fR 是映像包管理系统的检索客户端。在有效配置下,可以调用 \fBpkg\fR 来为要安装的软件包创建位置(称为“映像”),然后将软件包安装到这些映像中。软件包由发布者发布。发布者可使其软件包在一个或多个系统信息库上可用,或者在软件包归档文件中可用。\fBpkg\fR 从发布者的系统信息库或软件包归档文件中检索软件包,然后将软件包安装到映像中。
-.sp
-.LP
-只能将软件包安装到属于 BE 的文件系统中。例如,在缺省的 Oracle Solaris 11 安装上,软件包操作仅支持 \fBrpool/ROOT/\fIBEname\fR/\fR 下的数据集。
-.sp
-.LP
-发布者名称将个人、个人组或组织标识为一个或多个软件包的源。为避免发布者名称冲突并有帮于标识发布者,最佳做法是使用代表发布软件包实体的域名作为发布者名称。
-.sp
-.LP
-系统信息库是客户端可在其中发布和检索软件包内容(该软件包包含的文件,例如程序和文档)和元数据(有关该软件包的信息,例如其名称和描述)的位置。例如,有一个名为 \fBexample.org\fR 的发布者,其系统信息库位于 URI \fBhttp://example.org/repository\fR。
-.sp
-.LP
-\fBpkg\fR 还可以卸载软件包、刷新发布者元数据(例如可用软件包的列表)、验证映像中的软件包安装,以及查询映像中的各个标记。也可以对 \fBpkg\fR(5) 系统信息库执行这些查询。
-.sp
-.LP
-映像有三种类型:完整映像:能够提供完整的系统;部分映像:与完整映像(父映像)链接,但本身无法提供完整的系统;用户映像。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-对根目录为 \fIdir\fR 的映像进行操作。如果未根据环境指定或确定目录,则缺省值为 /。有关更多信息,请参见“环境变量”部分。
-.RE
-
-.SH 子命令
-.sp
-.LP
-支持以下子命令:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg refresh\fR [\fB-q\fR] [\fB- -full\fR] [\fIpublisher\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-对于所有发布者,更新客户机可用软件包列表和发布者元数据。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅对指定的发布者,更新客户机可用软件包列表和发布者元数据。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-在执行请求的操作期间隐藏进度消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--full\fR\fR
-.ad
-.sp .6
-.RS 4n
-强制完全检索所有发布者元数据(而不是尝试增量更新),并请求操作期间使用的所有代理忽略高速缓存的数据。此选项用于进行故障排除,正常情况下不应使用。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg install\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-安装指定软件包并将其更新到最新版本,该版本与映像中安装的软件包所允许的 \fIpkg_fmri_pattern\fR 匹配。要显式请求安装软件包的最新版本,请在 \fIpkg_fmri_pattern\fR 的版本部分使用 \fBlatest\fR。例如,指定 \fBvim@latest\fR。\fIpkg_fmri_pattern\fR 模式可以包含 \fB?\fR 和 \fB*\fR 字符作为 \fBglob\fR(3C) 式通配符,以匹配一个或多个软件包。
-.sp
-软件包基于发布者搜索顺序和粘性进行选择。有关搜索顺序和粘性的信息,请参见 \fBpkg publisher\fR 和 \fBpkg set-publisher\fR 命令。如果 \fIpkg_fmri_pattern\fR 未指定发布者,则会将第一个提供匹配软件包的发布者用作安装源。如果该发布者未提供可以安装在此映像中的软件包版本,则安装操作将失败。使用 \fBpkg list -a\fR 命令可查看哪些发布者提供可以安装在此映像中的软件包版本。
-.sp
-指定了多个 \fIpkg_fmri_pattern\fR 时,如果指定的软件包中有任何一个无法在此映像中安装,则指定的所有软件包都不会安装。
-.sp
-安装过程中,某些配置文件可能被重命名或替换。有关软件包系统如何确定要保留的文件以及在软件包操作期间如何保留这些文件的更多信息,请参见 \fBpkg\fR(5) 手册页中的“文件操作”。
-.sp
-如果某个软件包在避免列表中,则安装该软件包会将它从该列表中删除。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-C\fR \fIn\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定要并行更新的子映像数。在递归检查子映像(通常为安装的 \fBsolaris\fR 标记非全局区域)时,最多可以并行更新 \fIn\fR 个子映像。并行更新的缺省子映像数为 1。如果 \fIn\fR 为 0 或负数,则并行更新所有子映像。另请参见“环境变量”部分中的 \fBPKG_CONCURRENCY\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-暂时将指定的软件包系统信息库或归档文件添加到从中检索软件包数据的映像的源列表内。需要客户机 SSL 证书的系统信息库不能与此选项一起使用。可以多次指定此选项。
-.sp
-确定要使用的软件包版本时,优先选择映像中配置的发布者,而非指定 \fIpath_or_uri\fR 源中找到的发布者。如果映像中配置的发布者和 \fIpath_or_uri\fR 源都提供要安装的软件包版本,则客户机将从 \fIpath_or_uri\fR 源中检索该软件包的内容。安装或更新后,未在映像中配置的发布者提供的所有软件包都将添加到映像配置中,但添加的这些软件包没有源。使用 \fBpkg publisher\fR 命令可查看在映像中配置的发布者。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-试运行操作而不进行软件包更改。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-在执行请求的操作期间隐藏进度消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-在全局区域以及所有安装的 \fBsolaris\fR 标记非全局区域中运行此操作。对非全局区域的效果与登录每个非全局区域并直接运行该命令类似。如果不指定此选项,则在全局区域中运行 \fBpkg\fR 命令时,仅在使非全局区域与全局区域保持兼容所需的程度上对非全局区域进行修改。如果指定此选项,则除了受 \fB-z\fR 和 \fB-Z\fR 选项限制外,\fBpkg\fR 操作将应用于所有安装的非全局区域。对于 \fB-z\fR 和 \fB-Z\fR 选项排除的区域,如果需要进行更新以保持其与全局区域同步,则仍可以对其进行修改。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-z\fR \fIzonename\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅在指定的非全局区域中运行此操作。可以多次指定 \fB-z\fR 选项。\fB-z\fR 选项只能与 \fB-r\fR 选项一起使用。\fB-z\fR 选项不能与 \fB-Z\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-Z\fR \fIzonename\fR\fR
-.ad
-.sp .6
-.RS 4n
-在除指定区域外的所有非全局区域中运行此操作。可以多次指定 \fB-Z\fR 选项。\fB-Z\fR 选项只能与 \fB-r\fR 选项一起使用。\fB-Z\fR 选项不能与 \fB-z\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-在执行请求的操作期间发出详细进度消息,并显示详细的规划信息(例如更改侧面、中介和变量)。可以多次指定此选项,以增加显示的规划信息量。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-表示同意并接受所更新或安装的软件包的许可证条款。如果存在任何需要您接受的软件包许可证,而您未提供此选项,则安装操作将失败。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--licenses\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示在此操作过程中所安装或更新的软件包的所有许可证。对于更新的软件包,仅当许可证已更改时才显示许可证。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-不在操作成功完成后更新搜索索引。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-不尝试联系映像发布者的系统信息库来检索最新的可用软件包列表和其他元数据。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-be-activate\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果创建了一个引导环境,不将其设置为下次引导时的活动引导环境。有关更多信息,请参见 \fBbeadm\fR(1M) 手册页。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-backup-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-不创建备份引导环境。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--require-backup-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果不创建新的引导环境,则始终创建一个备份引导环境。如果不使用该选项,则根据映像策略创建备份引导环境。有关何时自动创建备份引导环境的说明,请参见下文“映像属性”中的 \fBbe-policy\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--backup-be-name\fR \fIname\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用给定参数命名创建的备份引导环境。使用 \fB--backup-be-name\fR 表示 \fB--require-backup-be\fR。另请参见 \fBbeadm\fR(1M) 手册页。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--deny-new-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-不创建新的引导环境。如果需要新的引导环境,则不执行此操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--require-new-be\fR\fR
-.ad
-.sp .6
-.RS 4n
-始终创建新的引导环境。如果不使用该选项,则根据映像策略创建引导环境。有关何时自动创建引导环境的说明,请参见下文“映像属性”中的 \fBbe-policy\fR。该选项不能与 \fB-require-backup-be\fR 一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--be-name\fR \fIname\fR\fR
-.ad
-.sp .6
-.RS 4n
-将新创建的引导环境重命名为给定的参数。使用 \fB--be-name\fR 表示 \fB--require-new-be\fR。另请参见 \fBbeadm\fR(1M) 手册页。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--reject\fR \fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-阻止安装名称与给定模式匹配的软件包。如果已安装匹配的软件包,则在此操作过程会将其删除。作为组依赖性目标的被拒绝软件包将放置在避免列表中。可以多次指定此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sync-actuators\fR\fR
-.ad
-.sp .6
-.RS 4n
-同步运行 SMF 执行器。除非所有 SMF 执行器在调用了 \fBpkg\fR 的区域(全局区域或非全局区域)中已完成,否则 \fBpkg\fR(1) 命令不会返回。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sync-actuators-timeout\fR \fItimeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-同步运行 SMF 执行器。如果执行器未在给定的 \fItimeout\fR(以秒为单位)内完成,\fBpkg\fR(1) 将继续运行并以返回代码 8 退出。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg exact-install\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-像在裸系统中安装一样安装或更新指定的软件包。将删除未在命令行中指定且不是指定软件包的依赖项的所有之前安装的软件包。此命令将忽略不安装避免列表上的软件包以及不更新冻结列表上的软件包的限制。在其他方面,此 \fBexact-install\fR 子命令的行为与 \fBinstall\fR 子命令的行为相同。要显式请求安装软件包的最新版本,请在 \fIpkg_fmri_pattern\fR 的版本部分使用 \fBlatest\fR。例如,指定 \fBvim@latest\fR。
-.sp
-软件包基于发布者搜索顺序和粘性进行选择。有关搜索顺序和粘性的信息,请参见 \fBpkg publisher\fR 和 \fBpkg set-publisher\fR 命令。如果 \fIpkg_fmri_pattern\fR 未指定发布者,则会将第一个提供匹配软件包的发布者用作安装源。如果该发布者未提供可以安装在此映像中的软件包版本,则安装操作将失败。使用 \fBpkg list -a\fR 命令可查看哪些发布者提供可以安装在此映像中的软件包版本。
-.sp
-指定了多个 \fIpkg_fmri_pattern\fR 时,如果指定的软件包中有任何一个无法在此映像中安装,则指定的所有软件包都不会安装。
-.sp
-安装过程中,某些配置文件可能被重命名或替换。有关软件包系统如何确定要保留的文件以及在软件包操作期间如何保留这些文件的更多信息,请参见 \fBpkg\fR(5) 手册页中的“文件操作”。
-.sp
-如果某个软件包在避免列表中,则安装该软件包会将它从该列表中删除。
-.sp
-有关选项的说明,请参见上述 \fBinstall\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg uninstall\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--ignore-missing\fR] [\fB--no-index\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-删除与 \fIpkg_fmri_pattern\fR 匹配的已安装软件包。
-.sp
-如果某个软件包是组依赖性的主体,则卸载该软件包会将它放置在避免列表中。请参见下文的 \fBavoid\fR 子命令。
-.sp
-在命令输出中,请注意任何指出已创建新引导环境的消息。如果已创建并激活新引导环境,缺省情况下,下次重新引导时会引导该环境。有关管理引导环境的信息,请参见 \fBbeadm\fR(1M) 手册页。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ignore-missing\fR\fR
-.ad
-.sp .6
-.RS 4n
-忽略未安装的软件包。使用此选项可防止 \fBpkg uninstall\fR 在尝试卸载当前未安装的软件包时失败。
-.RE
-
-对于其他所有选项,请参见上面的 \fBinstall\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg update\fR [\fB-fnvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--ignore-missing\fR] [\fB--licenses\fR] [\fB--no-index\fR] [\fB--no-refresh\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--reject\fR \fIpkg_fmri_pattern\fR]... [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-将当前映像中安装的所有软件包更新到最新版本,该版本需符合已安装的软件包和发布者配置对系统施加的约束。
-.sp
-在命令输出中,请注意任何指出已创建新引导环境的消息。如果已创建并激活新引导环境,在未指定 \fB--no-be-activate\fR 选项时,缺省情况下,下次重新引导时会引导该环境。有关管理引导环境的信息,请参见 \fBbeadm\fR(1M) 手册页。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅更新当前映像中安装的指定软件包。如果在所提供的 \fIpkg_fmri_pattern\fR 模式中有一个为星号 (*),则会更新当前映像中安装的所有软件包,就像未提供 \fIpkg_fmri_pattern\fR 一样。
-.sp
-要显式请求安装软件包的最新版本,请在 \fIpkg_fmri_pattern\fR 的版本部分使用 \fBlatest\fR。例如,指定 \fBvim@latest\fR。
-.sp
-可以指定比已安装版本更高或更低的版本,以便对特定软件包执行就地降级或升级。不支持跨越软件包重命名边界或过时边界更新特定的软件包。
-.sp
-作为将要降级的软件包的一部分、自原始版本安装以来更改了的任何保留配置文件,将使用扩展名 \fB\&.update\fR 进行重命名。有关软件包系统如何确定要保留的文件,以及在软件包升级期间如何保留这些文件的更多信息,请参见 \fBpkg\fR(5) 手册页中的“文件操作”。
-.sp
-指定了多个 \fIpkg_fmri_pattern\fR 时,如果指定的软件包中有任何一个无法在此映像中更新,则指定的所有软件包都不会更新。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.sp .6
-.RS 4n
-不在更新已安装的所有软件包时执行客户机最新状态检查。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ignore-missing\fR\fR
-.ad
-.sp .6
-.RS 4n
-忽略未安装的软件包。使用此选项可防止 \fBpkg update\fR 在尝试更新当前未安装的软件包时失败。
-.RE
-
-对于其他所有选项,请参见上面的 \fBinstall\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg list\fR [\fB-Hafnqsuv\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--no-refresh\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-显示当前映像中安装的所有软件包的列表,包括版本和安装状态等信息。缺省情况下,会排除不同体系结构或区域类型的软件包变量。输出通常包括三个列:
-.sp
-.in +2
-.nf
-NAME (PUBLISHER)       VERSION                IFO
+    [-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> 是映像包管理系统的检索客户端。在有效配置下,可以调用 <command>pkg</command> 来为要安装的软件包创建位置(称为“映像”),然后将软件包安装到这些映像中。软件包由发布者发布。发布者可使其软件包在一个或多个系统信息库上可用,或者在软件包归档中可用。<command>pkg</command> 从发布者的系统信息库或软件包归档中检索软件包,然后将软件包安装到映像中。</para>
+<para>只能将软件包安装到属于引导环境的文件系统中。例如,在缺省的 Oracle Solaris 11 安装上,软件包操作仅支持 <filename>rpool/ROOT/<replaceable>BEname</replaceable>/</filename> 下的数据集。</para>
+<para>发布者名称将个人、个人组或组织标识为一个或多个软件包的源。为避免发布者名称冲突并有帮于标识发布者,最佳做法是使用代表发布软件包实体的域名作为发布者名称。</para>
+<para>系统信息库是客户端可在其中发布和检索软件包内容(该软件包包含的文件,例如程序和文档)和元数据(有关该软件包的信息,例如其名称和说明)的位置。例如,有一个名为 <literal>example.org</literal> 的发布者,其系统信息库位于 URI <literal>http://example.org/repository</literal>。</para>
+<para><command>pkg</command> 还可以卸载软件包、刷新发布者元数据(例如可用软件包的列表)、验证映像中的软件包安装,以及查询映像中的各个标记。也可以对 <literal>pkg</literal>(5) 系统信息库执行这些查询。</para>
+<para>映像有三种类型:完整映像:能够提供完整的系统;部分映像:与完整映像(父映像)链接,但本身无法提供完整的系统;用户映像。</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>
+</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>?</literal> 和 <literal>*</literal> 字符作为 <literal>glob</literal>(3C) 式通配符,以匹配一个或多个软件包。</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>(5) 手册页中的“文件操作”。</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> 命令时,仅在使非全局区域与全局区域保持兼容所需的程度上对非全局区域进行修改。如果指定此选项,则除了受 <option>z</option> 和 <option>Z</option> 选项限制外,<literal>pkg</literal> 操作将应用于所有安装的非全局区域。对于 <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>(1M) 手册页。</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>(1M) 手册页。</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>(1M) 手册页。</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 执行器。除非所有 SMF 执行器在调用了 <command>pkg</command> 的区域(全局区域或非全局区域)中已完成,否则 <command>pkg</command>(1) 命令不会返回。</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>(5) 手册页中的“文件操作”。</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>(1M) 手册页。</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>(1M) 手册页。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>仅更新当前映像中安装的指定软件包。如果在所提供的 <replaceable>pkg_fmri_pattern</replaceable> 模式中有一个为星号 (*),则会更新当前映像中安装的所有软件包,就像未提供 <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>(5) 手册页中的“文件操作”。</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>显示当前映像中安装的所有软件包的列表,包括版本和安装状态等信息。缺省情况下,会排除不同体系结构或区域类型的软件包变量。输出通常包括三个列:</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--
-.fi
-.in -2
-
-第一列包含软件包的名称。如果安装(或者提供)该软件包的发布者在发布者搜索顺序上不是第一个,则该发布者名称将列在软件包名称的后面,并括在括号中。第二列包含软件包的发行版本和分支版本。有关发行版本和分支版本以及变量的信息,请参见 \fBpkg\fR(5) 手册页。
-.sp
-.LP
-最后一列包含一组标志,用于显示软件包的状态:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBI\fR 列中的 \fBi\fR 表明软件包已安装。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBF\fR 列中的 \fBf\fR 表明软件包已冻结。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBO\fR 列中的 \fBo\fR 表明软件包已过时。\fBO\fR 列中的 \fBr\fR 表明软件包已重命名(一种形式的过时)。
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅列出指定的软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在列出时省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-列出已安装的软件包并列出未安装但可以安装在此映像中的最新版本的软件包。如果软件包得到已安装的 incorporation 和映像变体的允许,则可以安装软件包。如果指定了一个或多个模式,则会列出与指定模式匹配的、得到任何已安装的 incorporation 和映像变体允许的最新版本。如果不使用 \fB-a\fR,则仅列出已安装的软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-af\fR\fR
-.ad
-.sp .6
-.RS 4n
-列出所有变量的所有软件包的所有版本,而不管 incorporation 约束或安装状态如何。使用这些选项时,要显式列出某个软件包的最新版本,请在 \fIpkg_fmri_pattern\fR 的版本部分使用 \fBlatest\fR。例如,指定 \fBvim@latest\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用指定的软件包系统信息库或归档文件作为操作的软件包数据源。需要客户机 SSL 证书的系统信息库不能与此选项一起使用。可以多次指定此选项。如果未指定 \fB-n\fR,则可使用 \fB-g\fR 表示 \fB-a\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示所有已知软件包的最新版本,而不管安装状态如何。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-发生致命错误时不列出任何软件包,而是返回失败。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示单行短格式,用于提供软件包名称和摘要。此选项可与 \fB-a\fR、\fB-n\fR 或 \fB-u\fR 一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-u\fR\fR
-.ad
-.sp .6
-.RS 4n
-列出具有更新可用版本的已安装软件包。此选项不能与 \fB-g\fR 一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-在第一列中显示完整的软件包 FMRI,包括发布者和完整版本(VERSION 列将消失)。此选项可与 \fB-a\fR、\fB-n\fR 或 \fB-u\fR 一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-不尝试联系映像发布者的系统信息库来检索最新的可用软件包列表。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg info\fR [\fB-lqr\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB--license\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-以用户可读的格式显示当前映像中安装的所有软件包的相关信息。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示指定软件包的相关信息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用指定的软件包系统信息库或归档文件作为操作的软件包数据源。需要客户机 SSL 证书的系统信息库不能与此选项一起使用。可以多次指定此选项。使用 \fB-g\fR 表示 \fB-r\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示已安装的软件包的相关信息。这是缺省值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-发生致命错误时不显示任何软件包信息,而是返回失败。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-根据最新的可用版本匹配软件包,并从包含映像中已配置发布者的系统信息库中检索当前未安装的软件包的相关信息(如有必要)。使用此选项时,必须至少指定一个软件包。如果不指定 \fB-r\fR,则缺省情况下仅显示已安装的软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--license\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示软件包的许可证文本。此选项可与 \fB-l\fR、\fB-q\fR 或 \fB-r\fR 结合使用。如果所有 \fIpkg_fmri_pattern\fR 模式都匹配已知软件包并具有许可证,则返回成功。如果一个或多个模式是不匹配的或者与没有许可证的软件包匹配,则返回失败。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg contents\fR [\fB-Hmr\fR] [\fB-a\fR \fIattribute\fR=\fIpattern\fR]... [\fB-g\fR \fIpath_or_uri\fR]... [\fB-o\fR \fI attribute\fR[,\fIattribute\fR]...]... [\fB-s\fR \fI sort_key\fR] [\fB-t\fR \fIaction_name\fR[,\fI action_name\fR]...]... [\fIpkg_fmri_pattern\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-显示映像中安装的所有软件包的内容(操作属性)。未指定选项时,显示当前映像中安装的操作的 \fBpath\fR 属性值,按属性值的字母顺序排列。有关操作及其属性的信息,请参见 \fBpkg\fR(5) 手册页中的“操作”。另请参见以下伪属性名称列表。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示指定软件包的内容。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在输出中省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIattribute\fR=\fI pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-将输出限制为以下操作:其在选项参数中命名了 \fIattribute \fR 并具有与选项参数中的 (glob) \fIpattern\fR 匹配的值。可以多次指定此选项。如果指定了多个 \fB-a\fR 选项,则会显示与其中任一选项匹配的操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示指定软件包系统信息库或归档文件中可以安装在此映像中的软件包的信息。需要客户机 SSL 证书的系统信息库不能与此选项一起使用。可以安装的软件包包含当前已安装的软件包以及其他满足此映像安装条件(例如变量和侧面限制)的软件包。可以多次指定此选项。使用 \fB-g\fR 表示 \fB-r\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示指定软件包中所有操作的所有属性,包括无法安装在此映像中的操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示指定属性,按列出的第一个属性的值排序。可以多次指定 \fB-o\fR 选项;也可以通过使用逗号分隔属性名称,将多个属性指定为一个 \fB-o\fR 选项的参数。仅显示包含所请求属性的操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示此映像中配置的发布者系统信息库中可以安装在此映像中的软件包的最新可用版本信息。可以安装的软件包包含当前已安装的软件包以及其他满足此映像安装条件(例如变量和侧面限制)的软件包。使用此选项时,必须至少指定一个软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIsort_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-按指定的操作属性对操作进行排序。如果未提供此选项,则缺省设置是按照路径进行排序或者按照 \fB-o\fR 选项指定的第一个属性进行排序。可以多次指定 \fB-s\fR 选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅列出指定的操作。可以多次指定 \fB-t\fR 选项;也可以通过使用逗号分隔操作名称,将多个操作指定为一个 \fB-t\fR 选项的参数。\fIaction_name\fR 的值是 \fBpkg\fR(5) 手册页的“操作”中列出的操作之一,例如 \fBfile\fR、\fBdirectory\fR、\fBdriver\fR、\fBdepend\fR、\fBset\fR。
-.RE
-
-为方便起见,可以使用多个特殊的伪属性名称:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.hash\fR\fR
-.ad
-.sp .6
-.RS 4n
-操作的散列值(如果该操作承载了有效负荷)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.key\fR\fR
-.ad
-.sp .6
-.RS 4n
-该操作的关键属性值。例如,对于 \fBfile\fR 操作,关键属性是文件的路径。某些操作不具备关键属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.name\fR\fR
-.ad
-.sp .6
-.RS 4n
-操作的名称。例如,对于某个文件操作,这是 \fBfile\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBaction.raw\fR\fR
-.ad
-.sp .6
-.RS 4n
-匹配操作的所有属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-包含操作的软件包的完整 FMRI,例如 \fBpkg://solaris/group/feature/[email protected],5.11-0.175.0.0.0.2.1:20120705T153434Z\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.name\fR\fR
-.ad
-.sp .6
-.RS 4n
-包含操作的软件包的名称,例如 \fBweb/amp\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-包含操作的软件包的发布者,例如 \fBsolaris\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.shortfmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-包含操作的软件包的短格式 FMRI,例如 \fBpkg://solaris/group/feature/[email protected],5.11-0.175\fR。
-.RE
-
-\fBcontents\fR 和 \fBsearch\fR 子命令是彼此相关的:两者都可在系统中查询软件包的内容。\fBcontents\fR 子命令显示一个或多个已安装或可安装软件包中的操作,根据指定的选项过滤输出。\fBsearch\fR 子命令从另一个方向处理查询,显示包含用户提供的标记的所有软件包的名称。
-.sp
-每个子命令都能够表达另一个子命令也能表达的某些查询。应该谨慎选择所需的子命令,因为使用其中一个子命令来表达某个给定查询,可能比使用另一个子命令更为自然。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg search\fR [\fB-HIaflpr\fR] [\fB-o\fR \fIattribute\fR[,\fIattribute\fR]...]... [\fB-s\fR \fIrepo_uri\fR] \fIquery\fR\fR
-.ad
-.sp .6
-.RS 4n
-搜索匹配 \fIquery\fR 的操作,并显示匹配的搜索索引、操作名称、操作值和软件包名称。请参见下文的 \fIquery\fR 说明。某些搜索可能会产生重复结果。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在输出中省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用区分大小写的搜索。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-执行搜索并显示有关匹配操作的信息。这是缺省值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示所有结果,而不考虑软件包版本。缺省情况下,\fBsearch\fR 会删改低于当前安装版本的软件包中的结果,以及当前 incorporation 排除的软件包版本中的结果。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-搜索映像的已安装软件包。
-.sp
-可以同时指定 \fB-l\fR 和 \fB-r\fR(或 \fB-s\fR),在此情况下,将会同时执行本地搜索和远程搜索。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定要在输出中包含的列。可以多次指定 \fB-o\fR 选项;也可以通过使用逗号分隔属性名称,将多个属性指定为一个 \fB-o\fR 选项的参数。除了上面概述的伪属性外,还为搜索结果定义了下列属性。这些属性有助于说明匹配特定结果的原因:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsearch.match\fR\fR
-.ad
-.sp .6
-.RS 4n
-与搜索查询匹配的字符串。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsearch.match_type\fR\fR
-.ad
-.sp .6
-.RS 4n
-包含与搜索查询匹配的字符串的属性。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示其某些操作与每个查询词匹配的软件包。使用此选项相当于在查询中的每个词两侧添加尖括号 (\fB<>\fR)。有关 \fB<>\fR 运算符的更多说明,请参见下文的 \fIquery\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-搜索对应于映像发布者的系统信息库。这是缺省值。
-.sp
-可以同时指定 \fB-l\fR 和 \fB-r\fR(或 \fB-s\fR),在此情况下,将会同时执行本地搜索和远程搜索。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-搜索位于给定 URI 的 \fBpkg\fR(5) 系统信息库。可以多次指定此选项。不支持软件包归档。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIquery\fR\fR
-.ad
-.sp .6
-.RS 4n
-缺省情况下,会将 \fIquery\fR 解释为要精确匹配的一系列条件(多个条件用 AND 连接)。
-.sp
-支持 AND 和 OR。
-.sp
-可将 \fB?\fR 和 \fB*\fR 字符用作 \fBglob\fR(3C) 式通配符,以更灵活地获取查询匹配项。
-.sp
-除了支持简单的标记匹配和通配符搜索外,还支持更复杂的查询语言。可通过使用单引号或双引号(\fB\&'\fR 或 \fB"\fR)来搜索短语。请务必考虑所用的 shell,使 \fBpkg\fR 能够真正识别 \fB\&'\fR 或 \fB"\fR。
-.sp
-要为哪些标记建立索引是与操作相关的,不过可以包括内容散列和路径名称。有关操作及其属性的信息,请参见 \fBpkg\fR(5) 手册页中的“操作”。另请参见上面 \fBpkg contents\fR 和 \fB-o\fR 中的伪属性名称列表。
-.sp
-结构化查询支持以下语法:
-.sp
-.in +2
-.nf
-\fIpkg_name\fR:\fIaction_name\fR:\fIindex\fR:\fItoken\fR
-.fi
-.in -2
-
-\fIaction_name\fR 的值是 \fBpkg\fR(5) 手册页的“操作”中列出的操作之一。\fIindex\fR 是操作的属性。\fIindex\fR 的值必须与 \fItoken\fR 匹配。
-.sp
-并非所有操作属性都是可搜索的。例如,\fBmode\fR 是 \fBfile\fR 操作的一个属性,但是 \fBmode\fR 不是 \fIindex\fR 的有效值。
-.sp
-\fIindex\fR 的某些值并不是操作属性,而是从其他属性派生的值。例如,\fIindex\fR 可以是 \fBbasename\fR,其不是任何操作的属性,而是派生自 \fBfile\fR 或 \fBdir\fR 操作的 \fBpath\fR 属性,它采用了路径的最后组成部分。
-.sp
-不同的操作类型有不同的 \fIindex\fR 有效值。本文档并未列出所有可能的值。一些更为有用的 \fIindex\fR 值包括,对应于文件系统操作的 \fBbasename\fR 和 \fBpath\fR、对应于 \fBdepend\fR 操作的依赖性类型(例如 \fBrequire\fR、\fBoptional\fR、\fBgroup\fR),以及对应于 \fBdriver\fR 操作的 \fBdriver_name\fR 和 \fBalias\fR。
-.sp
-\fIindex\fR 的一个特殊值是对应于 \fBset\fR 操作的 \fBname\fR 属性值。在这种情况下,\fItoken\fR 与对应于指定 \fBname\fR 属性的 \fBvalue\fR 属性的值相匹配。例如,以下搜索将查找分类为 "Development/Databases" 或 "System/Databases" 的软件包。请参见“示例”部分中查找 SMF 服务的示例。
-.sp
-.in +2
-.nf
-$ \fBpkg search info.classification:databases\fR
-.fi
-.in -2
-.sp
-
-结构化查询中缺少的字段使用隐式通配符。搜索 \fBbasename:pkg\fR 将会匹配 \fIindex\fR 为 \fBbasename\fR 且与 \fItoken\fR \fBpkg\fR 匹配的所有软件包中的所有操作,如以下部分输出中所示:
-.sp
-.in +2
-.nf
-$ \fBpkg search basename:pkg\fR
+x11/wm/fvwm (fvwm.org) 2.6.5                  i--</programlisting>
+<para>第一列包含软件包的名称。如果安装(或者提供)该软件包的发布者在发布者搜索顺序上不是第一个,则该发布者名称将列在软件包名称的后面,并括在括号中。第二列包含软件包的发行版本和分支版本。有关发行版本和分支版本以及变量的信息,请参见 <literal>pkg</literal>(5) 手册页。</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> 表明软件包已重命名(一种形式的过时)。</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 和映像变体的允许,则可以安装软件包。如果指定了一个或多个模式,则会列出与指定模式匹配的、得到任何已安装的 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>显示单行短格式,用于提供软件包名称和摘要。此选项可与 <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>根据最新的可用版本匹配软件包,并从包含映像中已配置发布者的系统信息库中检索当前未安装的软件包的相关信息(如有必要)。使用此选项时,必须至少指定一个软件包。如果不指定 <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> 模式都匹配已知软件包并具有许可证,则返回成功。如果一个或多个模式是不匹配的或者与没有许可证的软件包匹配,则返回失败。</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>
+<listitem><para>显示映像中安装的所有软件包的内容(操作属性)。未指定选项时,显示当前映像中安装的操作的 <literal>path</literal> 属性值,按属性值的字母顺序排列。有关操作及其属性的信息,请参见 <literal>pkg</literal>(5) 手册页中的“操作”。另请参见以下伪属性名称列表。</para>
+<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>将输出限制为以下操作:其在选项参数中命名了 <replaceable>attribute </replaceable> 并具有与选项参数中的 (glob) <replaceable>pattern</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> 选项;也可以通过使用逗号分隔属性名称,将多个属性指定为一个 <option>o</option> 选项的参数。仅显示包含所请求属性的操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>显示此映像中配置的发布者系统信息库中可以安装在此映像中的软件包的最新可用版本信息。可以安装的软件包包含当前已安装的软件包以及其他满足此映像安装条件(例如变量和侧面限制)的软件包。使用此选项时,必须至少指定一个软件包。</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> 选项;也可以通过使用逗号分隔操作名称,将多个操作指定为一个 <option>t</option> 选项的参数。<replaceable>action_name</replaceable> 的值是 <literal>pkg</literal>(5) 手册页的“操作”中列出的操作之一,例如 <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>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.key</literal></term>
+<listitem><para>该操作的关键属性值。例如,对于 <literal>file</literal> 操作,关键属性是文件的路径。某些操作不具备关键属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.name</literal></term>
+<listitem><para>操作的名称。例如,对于某个文件操作,这是 <literal>file</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>action.raw</literal></term>
+<listitem><para>匹配操作的所有属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.fmri</literal></term>
+<listitem><para>包含操作的软件包的完整 FMRI,例如 <literal>pkg://solaris/group/feature/[email protected],5.11-0.175.0.0.0.2.1:20120705T153434Z</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.name</literal></term>
+<listitem><para>包含操作的软件包的名称,例如 <literal>web/amp</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.publisher</literal></term>
+<listitem><para>包含操作的软件包的发布者,例如 <literal>solaris</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.shortfmri</literal></term>
+<listitem><para>包含操作的软件包的短格式 FMRI,例如 <literal>pkg://solaris/group/feature/[email protected],5.11-0.175</literal>。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><command>contents</command> 和 <command>search</command> 子命令是彼此相关的:两者都可在系统中查询软件包的内容。<command>contents</command> 子命令显示一个或多个已安装或可安装软件包中的操作,根据指定的选项过滤输出。<command>search</command> 子命令从另一个方向处理查询,显示包含用户提供的标记的所有软件包的名称。</para>
+<para>每个子命令都能够表达另一个子命令也能表达的某些查询。应该谨慎选择所需的子命令,因为使用其中一个子命令来表达某个给定查询,可能比使用另一个子命令更为自然。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg search</command> [<option>HIaflpr</option>] [<option>o</option> <replaceable>attribute</replaceable>[,<replaceable>attribute</replaceable>]...]... [<option>s</option> <replaceable>repo_uri</replaceable>] <replaceable>query</replaceable></term>
+<listitem><para>搜索匹配 <replaceable>query</replaceable> 的操作,并显示匹配的搜索索引、操作名称、操作值和软件包名称。请参见下文的 <replaceable>query</replaceable> 说明。某些搜索可能会产生重复结果。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>H</option></term>
+<listitem><para>在输出中省略标题。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>I</option></term>
+<listitem><para>使用区分大小写的搜索。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>执行搜索并显示有关匹配操作的信息。这是缺省值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>f</option></term>
+<listitem><para>显示所有结果,而不考虑软件包版本。缺省情况下,<command>search</command> 会删改低于当前安装版本的软件包中的结果,以及当前 incorporation 排除的软件包版本中的结果。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option></term>
+<listitem><para>搜索映像的已安装软件包。</para>
+<para>可以同时指定 <option>l</option> 和 <option>r</option>(或 <option>s</option>),在此情况下,将会同时执行本地搜索和远程搜索。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>attribute</replaceable></term>
+<listitem><para>指定要在输出中包含的列。可以多次指定 <option>o</option> 选项;也可以通过使用逗号分隔属性名称,将多个属性指定为一个 <option>o</option> 选项的参数。除了上面概述的伪属性外,还为搜索结果定义了下列属性。这些属性有助于说明匹配特定结果的原因:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>search.match</literal></term>
+<listitem><para>与搜索查询匹配的字符串。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>search.match_type</literal></term>
+<listitem><para>包含与搜索查询匹配的字符串的属性。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option></term>
+<listitem><para>显示其某些操作与每个查询词匹配的软件包。使用此选项相当于在查询中的每个词两侧添加尖括号 (<literal>&lt;&gt;</literal>)。有关 <literal>&lt;></literal> 运算符的更多说明,请参见下文的 <replaceable>query</replaceable>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>搜索对应于映像发布者的系统信息库。这是缺省值。</para>
+<para>可以同时指定 <option>l</option> 和 <option>r</option>(或 <option>s</option>),在此情况下,将会同时执行本地搜索和远程搜索。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri</replaceable></term>
+<listitem><para>搜索位于给定 URI 的 <literal>pkg</literal>(5) 系统信息库。可以多次指定此选项。不支持软件包归档。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>query</replaceable></term>
+<listitem><para>缺省情况下,会将 <replaceable>query</replaceable> 解释为要精确匹配的一系列条件(多个条件用 AND 连接)。</para>
+<para>支持 AND 和 OR。</para>
+<para>可将 <literal>?</literal> 和 <literal>*</literal> 字符用作 <literal>glob</literal>(3C) 式通配符,以更灵活地获取查询匹配项。</para>
+<para>除了支持简单的标记匹配和通配符搜索外,还支持更复杂的查询语言。可通过使用单引号或双引号(<literal>'</literal> 或 <literal>"</literal>)来搜索短语。请务必考虑所用的 shell,使 <command>pkg</command> 能够真正识别 <literal>'</literal> 或 <literal>"</literal>。</para>
+<para>要为哪些标记建立索引是与操作相关的,不过可以包括内容散列和路径名称。有关操作及其属性的信息,请参见 <literal>pkg</literal>(5) 手册页中的“操作”。另请参见上面 <command>pkg contents</command> 和 <option>o</option> 中的伪属性名称列表。</para>
+<para>结构化查询支持以下语法:</para>
+<programlisting><replaceable>pkg_name</replaceable>:<replaceable>action_name</replaceable>:<replaceable>
+index</replaceable>:<replaceable>token</replaceable></programlisting>
+<para><replaceable>action_name</replaceable> 的值是 <literal>pkg</literal>(5) 手册页的“操作”中列出的操作之一。<replaceable>index</replaceable> 是操作的属性。<replaceable>index</replaceable> 的值必须与 <replaceable>token</replaceable> 匹配。</para>
+<para>并非所有操作属性都是可搜索的。例如,<literal>mode</literal> 是 <literal>file</literal> 操作的一个属性,但是 <literal>mode</literal> 不是 <replaceable>index</replaceable> 的有效值。</para>
+<para><replaceable>index</replaceable> 的某些值并不是操作属性,而是从其他属性派生的值。例如,<replaceable>index</replaceable> 可以是 <literal>basename</literal>,其不是任何操作的属性,而是派生自 <literal>file</literal> 或 <literal>dir</literal> 操作的 <literal>path</literal> 属性,它采用了路径的最后组成部分。</para>
+<para>不同的操作类型有不同的 <replaceable>index</replaceable> 有效值。本文档并未列出所有可能的值。一些更为有用的 <replaceable>index</replaceable> 值包括,对应于文件系统操作的 <literal>basename</literal> 和 <literal>path</literal>、对应于 <literal>depend</literal> 操作的依赖性类型(例如 <literal>require</literal>、<literal>optional</literal>、<literal>group</literal>),以及对应于 <literal>driver</literal> 操作的 <literal>driver_name</literal> 和 <literal>alias</literal>。</para>
+<para><replaceable>index</replaceable> 的一个特殊值是对应于 <literal>set</literal> 操作的 <literal>name</literal> 属性值。在这种情况下,<replaceable>token</replaceable> 与对应于指定 <literal>name</literal> 属性的 <literal>value</literal> 属性的值相匹配。例如,以下搜索将查找分类为 "Development/Databases" 或 "System/Databases" 的软件包。请参见“示例”部分中查找 SMF 服务的示例。</para>
+<screen>$ <userinput>pkg search info.classification:databases</userinput></screen>
+<para>结构化查询中缺少的字段使用隐式通配符。搜索 <literal>basename:pkg</literal> 将会匹配 <replaceable>index</replaceable> 为 <literal>basename</literal> 且与 <replaceable>token</replaceable> <literal>pkg</literal> 匹配的所有软件包中的所有操作,如以下部分输出中所示:</para>
+<screen>$ <userinput>pkg search basename:pkg</userinput>
 INDEX    ACTION VALUE         PACKAGE
 basename dir    usr/share/pkg pkg:/package/[email protected]
 basename dir    var/sadm/pkg  pkg:/package/[email protected]
 basename dir    var/spool/pkg pkg:/package/[email protected]
-basename file   usr/bin/pkg   pkg:/package/[email protected]
-.fi
-.in -2
-.sp
-
-添加其他字段将会缩小搜索范围,如以下完整输出中所示:
-.sp
-.in +2
-.nf
-$ \fBpkg search file:basename:pkg\fR
+basename file   usr/bin/pkg   pkg:/package/[email protected]</screen>
+<para>添加其他字段将会缩小搜索范围,如以下完整输出中所示:</para>
+<screen>$ <userinput>pkg search file:basename:pkg</userinput>
 INDEX    ACTION VALUE       PACKAGE
-basename file   usr/bin/pkg pkg:/package/[email protected]
-.fi
-.in -2
-.sp
-
-\fIpkg_name\fR 和 \fItoken\fR 字段中支持显式通配符。\fIaction_name\fR 和 \fIindex\fR 必须完全匹配。
-.sp
-有关搜索文件和依赖项的示例,请参见“示例”部分。
-.sp
-要将操作转换为包含这些操作的软件包,请使用 \fB<>\fR,如以下部分输出中所示:
-.sp
-.in +2
-.nf
-$ \fBpkg search \e<pkg\e>\fR
+basename file   usr/bin/pkg pkg:/package/[email protected]</screen>
+<para><replaceable>pkg_name</replaceable> 和 <replaceable>token</replaceable> 字段中支持显式通配符。<replaceable>action_name</replaceable> 和 <replaceable>index</replaceable> 必须完全匹配。</para>
+<para>有关搜索文件和依赖项的示例,请参见“示例”部分。</para>
+<para>要将操作转换为包含这些操作的软件包,请使用 <literal>&lt;></literal>,如以下部分输出中所示:</para>
+<screen>$ <userinput>pkg search &bsol;&lt;pkg&bsol;></userinput>
 PACKAGE                                  PUBLISHER
 pkg:/package/[email protected]  solaris
-pkg:/package/[email protected] solaris
-.fi
-.in -2
-.sp
-
-使用 \fB-a\fR 选项(缺省设置)时,搜索 \fBtoken\fR 会导致返回与 \fBtoken\fR 匹配的操作的信息,而搜索 \fB<token>\fR 会导致返回一个软件包列表,这些软件包包含与 \fBtoken\fR 匹配的操作。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg verify\fR [\fB-Hqv\fR] [\fI pkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-验证当前映像中安装的所有软件包的安装情况。如果相关发布者的当前签名策略不是 \fBignore\fR,则会根据策略验证每个软件包的签名。有关如何应用签名策略的说明,请参见下文“映像属性”中的 \fBsignature-policy\fR。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅验证当前映像中安装的指定软件包的安装情况。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在验证输出中省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-q\fR\fR
-.ad
-.sp .6
-.RS 4n
-隐藏请求的操作过程中的进度消息和所有其他输出。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-包括有关软件包的信息性消息。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg fix\fR [\fB--accept\fR] [\fB--licenses\fR] [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-修复 \fBpkg verify\fR 报告的任何错误。已安装软件包内容的验证基于定制的内容分析,该分析可能会返回与其他程序不同的结果。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅修复 \fBpkg verify\fR 报告的有关当前映像中安装的指定软件包的错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-表示同意并接受所更新或安装的软件包的许可证条款。如果存在任何需要您接受的软件包许可证,而您未提供此选项,则操作将失败。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--licenses\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示在此操作过程中所安装或更新的软件包的所有许可证。对于更新的软件包,仅当许可证已更改时才显示许可证。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg revert\fR [\fB-nv\fR] [\fB- -no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be \fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name \fR \fIname\fR] (\fB--tagged\fR \fI tag-name\fR ... | \fIpath-to-file\fR ...)\fR
-.ad
-.sp .6
-.RS 4n
-将 \fBpkg\fR(5) 软件包提供的文件恢复为其交付时的状态。文件所有权和保护也会得到恢复。
-.LP
-注意 - 
-.sp
-.RS 2
-将某些可编辑文件恢复为其缺省值可能会使系统无法引导,或导致其他故障。
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--tagged\fR \fItag-name\fR\fR
-.ad
-.sp .6
-.RS 4n
-恢复使用 \fItag-name\fR 标记的所有文件,并删除带有此标记的目录下匹配 \fIpattern\fR 的所有未打包的文件或目录。有关 \fBtag-name\fR 和 \fIpattern\fR 的更多信息,请参见 \fBpkg\fR(5) 手册页“文件操作”和“目录操作”中对 \fBrevert-tag\fR 属性的说明。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpath-to-file\fR\fR
-.ad
-.sp .6
-.RS 4n
-恢复指定的文件。
-.RE
-
-对于其他所有选项,请参见上面的 \fBinstall\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg mediator\fR [\fB-aH\fR] [\fB-F\fR \fIformat\fR] [\fImediator\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-显示所有中介的当前选定版本和/或实现。
-.sp
-.ne 2
-.mk
-.na
-\fB\fImediator\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示指定中介的当前选定版本和/或实现。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定备用输出格式。\fIformat\fR 的值可以是 \fBtsv\fR(以制表符分隔的值)、\fBjson\fR(单行 JavaScript 对象表示法)或 json-formatted(格式易于阅读的 JavaScript 对象表示法)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在列出时省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-列出可为当前安装的软件包设置的中介。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-mediator\fR [\fB-nv\fR] [\fB-I\fR \fIimplementation\fR] [\fB-V\fR \fIversion\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] \fImediator\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-设置当前映像中指定中介的版本和/或实现。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR \fIimplementation\fR\fR
-.ad
-.sp .6
-.RS 4n
-设置要使用的中介接口的实现。缺省情况下,如果未指定版本,则允许所有实现版本。要指定一个没有版本的实现,请附加 @ 符号。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR \fIversion\fR\fR
-.ad
-.sp .6
-.RS 4n
-设置要使用的中介接口的版本。
-.RE
-
-如果指定的中介版本和/或实现当前不可用,则会删除使用指定中介的任何链接。
-.sp
-对于其他所有选项,请参见上面的 \fBinstall\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-mediator\fR [\fB-nvIV\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be \fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name \fR \fIname\fR] \fImediator\fR ... \fR
-.ad
-.sp .6
-.RS 4n
-将指定中介的版本和/或实现恢复为系统缺省值。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅恢复中介接口的实现。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-V\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅恢复中介接口的版本。
-.RE
-
-对于其他所有选项,请参见上面的 \fBinstall\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg variant\fR [\fB-Haiv\fR] [\fB-F\fR \fIformat\fR] [\fIvariant_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-显示在此映像中设置的所有变量的当前值。有关变量的更多信息,请参见 \fBpkg\fR(5) 手册页中的“侧面和变量”。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIvariant_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示在此映像中设置的指定变量的当前值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定备用输出格式。有关说明,请参见 \fBpkg mediator\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在列出时省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示映像中显式设置的所有变体以及在已安装软件包中列出的所有变体。\fB-a\fR 选项不能与 \fB-i\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示在已安装软件包中列出的所有变体。\fB-i\fR 选项不能与 \fB-a\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示可为已安装软件包设置的可能变体值。\fB-v\fR 选项可与 \fB-a\fR 或 \fB-i\fR 选项一起使用。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg change-variant\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIvariant_name\fR=\fIvalue\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-更改在当前映像中设置的指定变量的值。
-.sp
-更改变量的值可能会导致删除、更新或安装某些软件包内容。更改变量值还可能会导致安装、更新或删除整个软件包,以满足新的映像配置。有关变量的更多信息,请参见 \fBpkg\fR(5) 手册页中的“侧面和变量”。
-.sp
-有关选项的说明,请参见上述 \fBinstall\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg facet\fR [\fB-Haim\fR] [\fB-F\fR \fIformat\fR] [\fIfacet_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-显示使用 \fBpkg change-facet\fR 命令在此映像中本地设置或从父映像继承(例如非全局区域继承全局区域的侧面设置)的所有侧面的当前值和源。有关侧面的更多信息,请参见 \fBpkg\fR(5) 手册页中的“侧面和变量”。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIfacet_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示在此映像中设置的指定侧面的当前值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定备用输出格式。有关说明,请参见 \fBpkg mediator\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在列出时省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示映像中显式设置的所有侧面以及在已安装软件包中列出的所有侧面。\fB-a\fR 选项不能与 \fB-i\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示在已安装软件包中列出的所有侧面。\fB-i\fR 选项不能与 \fB-a\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-包括在输出中被屏蔽的侧面。显示一列指示被屏蔽的侧面(如果有)。被屏蔽的侧面是在映像中本地设置(使用 \fBpkg change-facet\fR 命令)且被同名的继承侧面隐藏的侧面。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg change-facet\fR [\fB-nvq\fR] [\fB-C\fR \fIn\fR] [\fB-g\fR \fIpath_or_uri\fR]... [\fB-r\fR [[\fB-z\fR \fIzonename\fR]... | [\fB-Z\fR \fIzonename\fR]... ]] [\fB--accept\fR] [\fB--licenses\fR] [\fB--no-be-activate\fR] [\fB--no-backup-be\fR | \fB--require-backup-be\fR] [\fB--backup-be-name\fR \fIname\fR] [\fB--deny-new-be\fR | \fB--require-new-be\fR] [\fB--be-name\fR \fIname\fR] [\fB--sync-actuators\fR | \fB--sync-actuators-timeout\fR \fItimeout\fR] \fIfacet_name\fR=(\fBTrue\fR|\fBFalse\fR|\fBNone\fR) ...\fR
-.ad
-.sp .6
-.RS 4n
-更改当前映像中设置的指定侧面的值。更改也将发生在继承这些侧面的所有映像中,例如非全局区域。
-.sp
-可以将侧面设置为 \fBTrue\fR 或 \fBFalse\fR。将侧面设置为 \fBNone\fR 时,系统会将缺省值 \fBTrue\fR 应用于该侧面;因此将安装任何由此侧面约束的操作。有关操作的信息,请参见 \fBpkg\fR(5) 手册页中的“操作”。
-.sp
-更改侧面的值可能会导致删除、更新或安装某些软件包内容。更改侧面值还可能会导致安装、更新或删除整个软件包,以满足新的映像配置。有关侧面的更多信息,请参见 \fBpkg\fR(5) 手册页中的“侧面和变量”。
-.sp
-有关选项的说明,请参见上述 \fBinstall\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg avoid\fR [\fIpkg_fmri_pattern\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-显示每个避免安装的软件包,以及对该软件包存在组依赖性的任何软件包。
-.sp
-如果需要满足 require 依赖性,则会安装避免列表中的软件包。如果删除了该依赖性,则会卸载相应的软件包。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果指定的软件包是某个组依赖性的目标,则会通过将匹配指定模式的软件包名称放置在避免列表中来避免安装这些软件包。只能避免安装当前尚未安装的软件包。如果某个软件包当前是某个组依赖性的目标,则卸载该软件包会将它放置在避免列表中。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unavoid\fR [\fIpkg_fmri_pattern \fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-显示避免安装的软件包的列表。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-从避免列表中删除指定的软件包。使用此子命令无法删除避免列表中与某个已安装软件包的组依赖性相匹配的软件包。要从避免列表中删除与某个组依赖性相匹配的软件包,请安装该软件包。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg freeze\fR [\fB-n\fR] [\fB-c\fR \fIreason\fR] [\fIpkg_fmri_pattern\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-显示有关当前已冻结软件包的信息:软件包名称、版本、软件包冻结时间以及任何冻结软件包的相关原因。
-.sp
-冻结某个软件包不会阻止删除该软件包。删除软件包时不会显示警告。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-将指定的软件包冻结到指定的版本。如果未提供版本,则必须安装该软件包,然后将它冻结在该已安装版本。冻结一个已经冻结的软件包会将冻结版本替换为新指定的版本。
-.sp
-如果安装或更新冻结的软件包,则其最终版本必须与冻结时使用的版本匹配。例如,如果某个软件包在冻结时的版本为 1.2,则可以将它更新到 1.2.1、1.2.9、1.2.0.0.1,等等。但该软件包的最终版本不能为 1.3 或 1.1。\fIpkg_fmri_pattern\fR 中提供的发布者用于查找匹配的软件包。但是,在冻结过程中不会记录发布者信息。软件包只针对其版本(而不是发布者)进行冻结。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIreason\fR\fR
-.ad
-.sp .6
-.RS 4n
-记录冻结软件包的 \fI原因\fR。当安装或更新因冻结而不能继续进行时,将会显示该原因。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-试运行冻结操作,并显示要冻结的软件包的列表,但不冻结任何软件包。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unfreeze\fR [\fB-n\fR] [\fI pkg_name_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-显示有关当前已冻结软件包的信息:软件包名称、版本、软件包冻结时间以及任何冻结软件包的相关原因。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-从指定的软件包中删除冻结操作施加的约束。将会忽略提供的版本。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-试运行解冻操作,并显示要解冻的软件包的列表,但不解冻任何软件包。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg property\fR [\fB-H\fR] [\fI propname\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-显示所有映像属性的名称和值。有关映像属性的说明,请参见下面的“映像属性”。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpropname\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示指定属性的名称和值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在列出时省略标题。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-property\fR \fIpropname\fR \fI propvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-更新现有映像属性或添加新的映像属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg add-property-value\fR \fIpropname \fR \fIpropvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-向现有映像属性添加值,或添加新的映像属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg remove-property-value\fR \fIpropname \fR \fIpropvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-从现有映像属性中删除值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-property\fR \fIpropname\fR ... \fR
-.ad
-.sp .6
-.RS 4n
-删除一个或多个现有映像属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg publisher\fR [\fB-HPn\fR] [\fB-F\fR \fIformat\fR] [\fIpublisher\fR ...] \fR
-.ad
-.sp .6
-.RS 4n
-按搜索优先顺序显示所有发布者的列表。为每个发布者显示以下信息:名称、属性(例如非粘性和已禁用)、类型(源或镜像)、联机状态、代理和位置 URI。代理信息在标记为 P 的列下仅显示为 T (true) 或 F (false)。要在 P 列中为具有 T 的发布者显示代理值,请使用 \fB-F tsv\fR 选项或指定发布者名称参数。\fBpkg publisher\fR 命令显示的代理是使用 \fBpkg set-publisher\fR 命令的 \fB--proxy\fR 选项来设置的。\fBpkg publisher\fR 命令不显示通过使用 \fBhttp_proxy\fR 环境变量设置的代理。
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示指定发布者的详细配置信息。显示的其他信息包括代理 URI、键和每个源或镜像 URI 的证书、客户机 UUID 以及上次更新目录的时间。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定备用输出格式。有关说明,请参见 \fBpkg mediator\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在列出时省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示发布者搜索顺序中的第一个发布者。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示已启用的发布者。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-publisher\fR [-Ped] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fIssl_key\fR] [\fB-g\fR \fIorigin_to_add\fR | \fB--add-origin\fR \fIorigin_to_add\fR]... [\fB-G\fR \fIorigin_to_remove\fR | \fB--remove-origin\fR \fIorigin_to_remove\fR]... [\fB-m\fR \fImirror_to_add\fR | \fB--add-mirror\fR \fImirror_to_add\fR]... [\fB-M\fR \fImirror_to_remove\fR | \fB--remove-mirror\fR \fImirror_to_remove\fR]... [\fB--disable\fR] [\fB--enable\fR] [\fB--no-refresh\fR] [\fB--reset-uuid\fR] [\fB--non-sticky\fR] [\fB--sticky\fR] [\fB--search-after\fR \fIpublisher\fR] [\fB--search-before\fR \fIpublisher\fR] [\fB--search-first\fR] [\fB--approve-ca-cert\fR \fIpath_to_CA\fR] [\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--add-property-value\fR \fIname_of_property\fR=\fIvalue_to_add\fR] [\fB--remove-property-value\fR \fIname_of_property\fR=\fIvalue_to_remove\fR] [\fB--unset-property\fR \fIname_of_property_to_delete\fR] [\fB--proxy\fR \fIproxy_to_use\fR] \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-更新现有发布者,或添加发布者。如果未指定任何影响搜索顺序的选项,则会将新发布者附加到搜索顺序,因此,会最后搜索这些新发布者。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-G\fR \fIorigin_to_remove\fR\fR
-.ad
-.br
-.na
-\fB\fB--remove-origin\fR \fIorigin_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-从给定发布者的源列表中删除 URI 或路径。可以使用特殊值 \fB*\fR 来删除所有源。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-M\fR \fImirror_to_remove\fR\fR
-.ad
-.br
-.na
-\fB\fB--remove-mirror\fR \fImirror_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-从给定发布者的镜像列表中删除 URI。可以使用特殊值 \fB*\fR 来删除所有镜像。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR\fR
-.ad
-.br
-.na
-\fB\fB--search-first\fR\fR
-.ad
-.sp .6
-.RS 4n
-将指定的发布者设置为搜索顺序中第一个。安装新软件包时,将首先搜索此发布者。对已安装软件包的更新将来自最初提供该软件包的同一发布者,前提是该发布者保持粘滞。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定客户机 SSL 证书。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.br
-.na
-\fB\fB--disable\fR\fR
-.ad
-.sp .6
-.RS 4n
-禁用发布者。填充软件包列表时,或者执行某些软件包操作(安装、卸载和更新)时,将不使用被禁用的发布者。但是,仍可以设置和查看被禁用的发布者的属性。如果只存在一个发布者,则不能将其禁用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-e\fR\fR
-.ad
-.br
-.na
-\fB\fB--enable\fR\fR
-.ad
-.sp .6
-.RS 4n
-启用发布者。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-g\fR \fIorigin_to_add\fR\fR
-.ad
-.br
-.na
-\fB\fB--add-origin\fR \fIorigin_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-将指定的 URI 或路径添加为给定发布者的源。这应该是软件包系统信息库或归档的位置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIssl_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定客户机 SSL 密钥。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR \fImirror_to_add\fR\fR
-.ad
-.br
-.na
-\fB\fB--add-mirror\fR \fImirror_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-将 URI 添加为给定发布者的镜像。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--add-property-value\fR \fIname_of_property \fR=\fIvalue_to_add\fR\fR
-.ad
-.sp .6
-.RS 4n
-向现有发布者属性添加值,或添加新的发布者属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--approve-ca-cert\fR \fIpath_to_CA\fR\fR
-.ad
-.sp .6
-.RS 4n
-为了验证签名的软件包,将指定的证书添加为受信任的 CA 证书。\fBpkg publisher\fR 命令的详细输出中列出了用户批准的 CA 证书的 PEM 表示形式中的散列。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-不尝试联系映像发布者的系统信息库来检索最新的可用软件包列表和其他元数据。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--non-sticky\fR\fR
-.ad
-.sp .6
-.RS 4n
-对于最初从此发布者安装的软件包,更新可以从级别比此发布者更高的发布者处获取。
-.RE
+pkg:/package/[email protected] solaris</screen>
+<para>使用 <option>a</option> 选项(缺省设置)时,搜索 <literal>token</literal> 会导致返回与 <literal>token</literal> 匹配的操作的信息,而搜索 <literal>&lt;token></literal> 会导致返回一个软件包列表,这些软件包包含与 <literal>token</literal> 匹配的操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg verify</command> [<option>Hqv</option>] [<replaceable> pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para>验证当前映像中安装的所有软件包的安装情况。如果相关发布者的当前签名策略不是 <literal>ignore</literal>,则会根据策略验证每个软件包的签名。有关如何应用签名策略的说明,请参见下文“映像属性”中的 <literal>signature-policy</literal>。</para>
+<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>v</option></term>
+<listitem><para>包括有关软件包的信息性消息。另请参见对上述安装命令的 <option>v</option> 选项的说明。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于其他所有选项,请参见上面的 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg fix</command> [<option>Hnvq</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>-accept</option>] [<option>-licenses</option>] [<replaceable>pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para>修复 <command>pkg verify</command> 报告的任何错误。已安装软件包内容的验证基于定制的内容分析,该分析可能会返回与其他程序不同的结果。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>仅修复 <command>pkg verify</command> 报告的有关当前映像中安装的指定软件包的错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>在验证输出中省略标题。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>包括有关软件包的信息性消息。另请参见对上述安装命令的 <option>v</option> 选项的说明。</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>
+</variablelist>
+<para>对于其他所有选项,请参见上面的 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg revert</command> [<option>nv</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>-tagged</option> <replaceable> tag-name</replaceable> ... | <replaceable>path-to-file</replaceable> ...)</term>
+<listitem><para>将 <literal>pkg</literal>(5) 软件包提供的文件恢复为其交付时的状态。文件所有权和保护也会得到恢复。</para>
+<caution><para>将某些可编辑文件恢复为其缺省值可能会使系统无法引导,或导致其他故障。</para></caution>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-tagged</option> <replaceable>tag-name</replaceable></term>
+<listitem><para>恢复使用 <replaceable>tag-name</replaceable> 标记的所有文件,并删除带有此标记的目录下匹配 <replaceable>pattern</replaceable> 的所有未打包的文件或目录。有关 <literal>tag-name</literal> 和 <replaceable>pattern</replaceable> 的更多信息,请参见 <literal>pkg</literal>(5) 手册页“文件操作”和“目录操作”中对 <literal>revert-tag</literal> 属性的说明。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>path-to-file</replaceable></term>
+<listitem><para>恢复指定的文件。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于其他所有选项,请参见上面的 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg mediator</command> [<option>aH</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>mediator</replaceable> ...] </term>
+<listitem><para>显示所有中介的当前选定版本和/或实现。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>mediator</replaceable></term>
+<listitem><para>仅显示指定中介的当前选定版本和/或实现。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>指定备用输出格式。<replaceable>format</replaceable> 的值可以是 <literal>tsv</literal>(以制表符分隔的值)、<literal>json</literal>(单行 JavaScript 对象表示法)或 json-formatted(格式易于阅读的 JavaScript 对象表示法)。</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>在列出时省略标题。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>列出可为当前安装的软件包设置的中介。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-mediator</command> [<option>nv</option>] [<option>I</option> <replaceable>implementation</replaceable>] [<option>V</option> <replaceable>version</replaceable>] [<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>] <replaceable>mediator</replaceable> ...</term>
+<listitem><para>设置当前映像中指定中介的版本和/或实现。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option> <replaceable>implementation</replaceable></term>
+<listitem><para>设置要使用的中介接口的实现。缺省情况下,如果未指定版本,则允许所有实现版本。要指定一个没有版本的实现,请附加 @ 符号。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option> <replaceable>version</replaceable></term>
+<listitem><para>设置要使用的中介接口的版本。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>如果指定的中介版本和/或实现当前不可用,则会删除使用指定中介的任何链接。</para>
+<para>对于其他所有选项,请参见上面的 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-mediator</command> [<option>nvIV</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>] <replaceable>mediator</replaceable> ... </term>
+<listitem><para>将指定中介的版本和/或实现恢复为系统缺省值。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option></term>
+<listitem><para>仅恢复中介接口的实现。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>V</option></term>
+<listitem><para>仅恢复中介接口的版本。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于其他所有选项,请参见上面的 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg variant</command> [<option>Haiv</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>variant_pattern</replaceable> ...]</term>
+<listitem><para>显示在此映像中设置的所有变量的当前值。有关变量的更多信息,请参见 <literal>pkg</literal>(5) 手册页中的“侧面和变量”。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>variant_pattern</replaceable></term>
+<listitem><para>仅显示在此映像中设置的指定变量的当前值。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>指定备用输出格式。有关说明,请参见 <command>pkg mediator</command> 命令。</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>在列出时省略标题。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>a</option></term>
+<listitem>
+<para>显示映像中显式设置的所有变体以及在已安装软件包中列出的所有变体。<option>a</option> 选项不能与 <option>i</option> 选项一起使用。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>i</option></term>
+<listitem>
+<para>显示在已安装软件包中列出的所有变体。<option>i</option> 选项不能与 <option>a</option> 选项一起使用。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>v</option></term>
+<listitem>
+<para>显示可为已安装软件包设置的可能变体值。<option>v</option> 选项可与 <option>a</option> 或 <option>i</option> 选项一起使用。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg change-variant</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-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>variant_name</replaceable>=<replaceable>value</replaceable> ...</term>
+<listitem><para>更改在当前映像中设置的指定变量的值。</para>
+<para>更改变量的值可能会导致删除、更新或安装某些软件包内容。更改变量值还可能会导致安装、更新或删除整个软件包,以满足新的映像配置。有关变量的更多信息,请参见 <literal>pkg</literal>(5) 手册页中的“侧面和变量”。</para>
+<para>有关选项的说明,请参见上述 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg facet</command> [<option>Haim</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>facet_pattern</replaceable> ...]</term>
+<listitem><para>显示使用 <command>pkg change-facet</command> 命令在此映像中本地设置或从父映像继承(例如非全局区域继承全局区域的侧面设置)的所有侧面的当前值和源。有关侧面的更多信息,请参见 <literal>pkg</literal>(5) 手册页中的“侧面和变量”。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>facet_pattern</replaceable></term>
+<listitem><para>仅显示在此映像中设置的指定侧面的当前值。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>指定备用输出格式。有关说明,请参见 <command>pkg mediator</command> 命令。</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><option>H</option></term>
+<listitem>
+<para>在列出时省略标题。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>a</option></term>
+<listitem>
+<para>显示映像中显式设置的所有侧面以及在已安装软件包中列出的所有侧面。<option>a</option> 选项不能与 <option>i</option> 选项一起使用。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>i</option></term>
+<listitem>
+<para>显示在已安装软件包中列出的所有侧面。<option>i</option> 选项不能与 <option>a</option> 选项一起使用。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>m</option></term>
+<listitem>
+<para>包括在输出中被屏蔽的侧面。显示一列指示被屏蔽的侧面(如果有)。被屏蔽的侧面是在映像中本地设置(使用 <command>pkg change-facet</command> 命令)且被同名的继承侧面隐藏的侧面。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg change-facet</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-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>facet_name</replaceable>=(<literal>True</literal>|<literal>False</literal>|<literal>None</literal>) ...</term>
+<listitem><para>更改当前映像中设置的指定侧面的值。更改也将发生在继承这些侧面的所有映像中,例如非全局区域。</para>
+<para>可以将侧面设置为 <literal>True</literal> 或 <literal>False</literal>。将侧面设置为 <literal>None</literal> 时,系统会将缺省值 <literal>True</literal> 应用于该侧面;因此将安装任何由此侧面约束的操作。有关操作的信息,请参见 <literal>pkg</literal>(5) 手册页中的“操作”。</para>
+<para>更改侧面的值可能会导致删除、更新或安装某些软件包内容。更改侧面值还可能会导致安装、更新或删除整个软件包,以满足新的映像配置。有关侧面的更多信息,请参见 <literal>pkg</literal>(5) 手册页中的“侧面和变量”。</para>
+<para>有关选项的说明,请参见上述 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg avoid</command> [<replaceable>pkg_fmri_pattern</replaceable> ...] </term>
+<listitem><para>显示每个避免安装的软件包,以及对该软件包存在组依赖性的任何软件包。</para>
+<para>如果需要满足 require 依赖性,则会安装避免列表中的软件包。如果删除了该依赖性,则会卸载相应的软件包。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>如果指定的软件包是某个组依赖性的目标,则会通过将匹配指定模式的软件包名称放置在避免列表中来避免安装这些软件包。只能避免安装当前尚未安装的软件包。如果某个软件包当前是某个组依赖性的目标,则卸载该软件包会将它放置在避免列表中。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unavoid</command> [<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>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg freeze</command> [<option>n</option>] [<option>c</option> <replaceable>reason</replaceable>] [<replaceable>pkg_fmri_pattern</replaceable> ...] </term>
+<listitem><para>显示有关当前已冻结软件包的信息:软件包名称、版本、软件包冻结时间以及任何冻结软件包的相关原因。</para>
+<para>冻结某个软件包不会阻止删除该软件包。删除软件包时不会显示警告。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>将指定的软件包冻结到指定的版本。如果未提供版本,则必须安装该软件包,然后将它冻结在该已安装版本。冻结一个已经冻结的软件包会将冻结版本替换为新指定的版本。</para>
+<para>如果安装或更新冻结的软件包,则其最终版本必须与冻结时使用的版本匹配。例如,如果某个软件包在冻结时的版本为 1.2,则可以将它更新到 1.2.1、1.2.9、1.2.0.0.1,等等。但该软件包的最终版本不能为 1.3 或 1.1。<replaceable>pkg_fmri_pattern</replaceable> 中提供的发布者用于查找匹配的软件包。但是,在冻结过程中不会记录发布者信息。软件包只针对其版本(而不是发布者)进行冻结。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>reason</replaceable></term>
+<listitem><para>记录冻结软件包的 <replaceable>原因</replaceable>。当安装或更新因冻结而不能继续进行时,将会显示该原因。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>试运行冻结操作,并显示要冻结的软件包的列表,但不冻结任何软件包。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unfreeze</command> [<option>n</option>] [<replaceable> pkg_name_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>n</option></term>
+<listitem><para>试运行解冻操作,并显示要解冻的软件包的列表,但不解冻任何软件包。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg property</command> [<option>H</option>] [<replaceable> propname</replaceable> ...]</term>
+<listitem><para>显示所有映像属性的名称和值。有关映像属性的说明,请参见下面的“映像属性”。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>propname</replaceable></term>
+<listitem><para>仅显示指定属性的名称和值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>在列出时省略标题。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-property</command> <replaceable>propname</replaceable> <replaceable> propvalue</replaceable></term>
+<listitem><para>更新现有映像属性或添加新的映像属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg add-property-value</command> <replaceable>propname </replaceable> <replaceable>propvalue</replaceable></term>
+<listitem><para>向现有映像属性添加值,或添加新的映像属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg remove-property-value</command> <replaceable>propname </replaceable> <replaceable>propvalue</replaceable></term>
+<listitem><para>从现有映像属性中删除值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-property</command> <replaceable>propname</replaceable> ... </term>
+<listitem><para>删除一个或多个现有映像属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg publisher</command> [<option>HPn</option>] [<option>F</option> <replaceable>format</replaceable>] [<replaceable>publisher</replaceable> ...] </term>
+<listitem><para>按搜索优先顺序显示所有发布者的列表。为每个发布者显示以下信息:名称、属性(例如非粘性和已禁用)、类型(源或镜像)、联机状态、代理和位置 URI。代理信息在标记为 P 的列下仅显示为 T (true) 或 F (false)。要在 P 列中为具有 T 的发布者显示代理值,请使用 <literal>-F tsv</literal> 选项或指定发布者名称参数。<command>pkg publisher</command> 命令显示的代理是使用 <command>pkg set-publisher</command> 命令的 <option>-proxy</option> 选项来设置的。<command>pkg publisher</command> 命令不显示通过使用 <envar>http_proxy</envar> 环境变量设置的代理。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>publisher</replaceable></term>
+<listitem><para>仅显示指定发布者的详细配置信息。显示的其他信息包括代理 URI、键和每个源或镜像 URI 的证书、客户机 UUID 以及上次更新目录的时间。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>指定备用输出格式。有关说明,请参见 <command>pkg mediator</command> 命令。</para></listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>在列出时省略标题。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option></term>
+<listitem><para>仅显示发布者搜索顺序中的第一个发布者。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>仅显示已启用的发布者。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-publisher</command> [-Ped] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable>ssl_key</replaceable>] [<option>g</option> <replaceable>origin_to_add</replaceable> | <option>-add-origin</option> <replaceable>origin_to_add</replaceable>]... [<option>G</option> <replaceable>origin_to_remove</replaceable> | <option>-remove-origin</option> <replaceable>origin_to_remove</replaceable>]... [<option>m</option> <replaceable>mirror_to_add</replaceable> | <option>-add-mirror</option> <replaceable>mirror_to_add</replaceable>]... [<option>M</option> <replaceable>mirror_to_remove</replaceable> | <option>-remove-mirror</option> <replaceable>mirror_to_remove</replaceable>]... [<option>-disable</option>] [<option>-enable</option>] [<option>-no-refresh</option>] [<option>-reset-uuid</option>] [<option>-non-sticky</option>] [<option>-sticky</option>] [<option>-search-after</option> <replaceable>publisher</replaceable>] [<option>-search-before</option> <replaceable>publisher</replaceable>] [<option>-search-first</option>] [<option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable>] [<option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-add-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_add</replaceable>] [<option>-remove-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_remove</replaceable>] [<option>-unset-property</option> <replaceable>name_of_property_to_delete</replaceable>] [<option>-proxy</option> <replaceable>proxy_to_use</replaceable>] <replaceable>publisher</replaceable></term>
+<listitem><para>更新现有发布者,或添加发布者。如果未指定任何影响搜索顺序的选项,则会将新发布者附加到搜索顺序,因此,会最后搜索这些新发布者。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>G</option> <replaceable>origin_to_remove</replaceable></term> <term><option>-remove-origin</option> <replaceable>origin_to_remove</replaceable></term>
+<listitem><para>从给定发布者的源列表中删除 URI 或路径。可以使用特殊值 <literal>*</literal> 来删除所有源。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>M</option> <replaceable>mirror_to_remove</replaceable></term> <term><option>-remove-mirror</option> <replaceable>mirror_to_remove</replaceable></term>
+<listitem><para>从给定发布者的镜像列表中删除 URI。可以使用特殊值 <literal>*</literal> 来删除所有镜像。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option></term><term><option>-search-first</option></term>
+<listitem><para>将指定的发布者设置为搜索顺序中第一个。安装新软件包时,将首先搜索此发布者。对已安装软件包的更新将来自最初提供该软件包的同一发布者,前提是该发布者保持粘滞。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para>指定客户机 SSL 证书。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term><term><option>-disable</option></term>
+<listitem><para>禁用发布者。填充软件包列表时,或者执行某些软件包操作(安装、卸载和更新)时,将不使用被禁用的发布者。但是,仍可以设置和查看被禁用的发布者的属性。如果只存在一个发布者,则不能将其禁用。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>e</option></term><term><option>-enable</option></term>
+<listitem><para>启用发布者。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>g</option> <replaceable>origin_to_add</replaceable></term> <term><option>-add-origin</option> <replaceable>origin_to_add</replaceable></term>
+<listitem><para>将指定的 URI 或路径添加为给定发布者的源。这应该是软件包系统信息库或归档的位置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>ssl_key</replaceable></term>
+<listitem><para>指定客户机 SSL 密钥。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option> <replaceable>mirror_to_add</replaceable></term> <term><option>-add-mirror</option> <replaceable>mirror_to_add</replaceable></term>
+<listitem><para>将 URI 添加为给定发布者的镜像。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-add-property-value</option> <replaceable>name_of_property </replaceable>=<replaceable>value_to_add</replaceable></term>
+<listitem><para>向现有发布者属性添加值,或添加新的发布者属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable></term>
+<listitem><para>为了验证签名的软件包,将指定的证书添加为受信任的 CA 证书。<command>pkg publisher</command> 命令的详细输出中列出了用户批准的 CA 证书的 PEM 表示形式中的散列。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-refresh</option></term>
+<listitem><para>不尝试联系映像发布者的系统信息库来检索最新的可用软件包列表和其他元数据。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-non-sticky</option></term>
+<listitem><para>对于最初从此发布者安装的软件包,更新可以从级别比此发布者更高的发布者处获取。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-proxy</option> <replaceable>proxy_to_use</replaceable></term>
+<listitem><para>使用指定的代理 URI 检索指定源 (<option>g</option>) 或镜像 (<option>m</option>) 的内容。代理值被存储为发布者配置的一部分,这意味着子映像所使用的系统信息库是自动更新的。此选项不能用于设置验证代理。<replaceable>proxy_to_use</replaceable> 值不能使用 <literal>protocol://user:password@host</literal> 格式。</para>
+<para>在运行时,<literal>http_proxy</literal> 或相关环境变量会覆盖此代理设置。有关接受的环境变量名列表,请参见 <literal>curl</literal>(1) 手册页的“环境”部分。如果使用环境变量来设置代理 URI,则必须也将 <literal>svc:/application/pkg/system-repository</literal> SMF 服务的相应代理属性设置为同一值。请参见《<citetitle>Adding and Updating Software in Oracle Solaris 11.3</citetitle>》中的 "Specifying a Proxy"。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-remove-property-value</option> <replaceable>name_of_property </replaceable>=<replaceable>value_to_remove</replaceable></term>
+<listitem><para>从现有发布者属性中删除值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-reset-uuid</option></term>
+<listitem><para>选择一个新的唯一标识符,用于向其发布者标识此映像。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove </replaceable></term>
+<listitem><para>为了验证签名的软件包,将具有证书的 PEM 表示形式的给定散列的证书视为已撤销。<command>pkg publisher</command> 命令的详细输出中列出了用户撤销的 CA 证书的散列。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-search-after</option> <replaceable>publisher</replaceable></term>
+<listitem><para>更改发布者搜索顺序,以便在此选项中指定的发布者之后搜索添加或修改的发布者。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-search-before</option> <replaceable>publisher</replaceable></term>
+<listitem><para>更改发布者搜索顺序,以便在此选项中指定的发布者之前搜索添加或修改的发布者。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>更新现有发布者属性或添加新的发布者属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-sticky</option></term>
+<listitem><para>对于从此发布者安装的软件包,更新必须也来自此发布者。这是缺省行为。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove </replaceable></term>
+<listitem><para>为了验证签名的软件包,会从已批准证书列表和已撤销证书列表中删除具有给定散列的证书。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-unset-property</option> <replaceable>name_of_property_to_delete </replaceable></term>
+<listitem><para>删除现有的发布者属性。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg set-publisher</command> <option>p</option> <replaceable>repo_uri</replaceable> [-Ped] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable>ssl_key</replaceable>] [<option>-non-sticky</option>] [<option>-sticky</option>] [<option>-search-after</option> <replaceable>publisher</replaceable>] [<option>-search-before</option> <replaceable>publisher</replaceable>] [<option>-search-first</option>] [<option>-approve-ca-cert</option> <replaceable>path_to_CA</replaceable>] [<option>-revoke-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-unset-ca-cert</option> <replaceable>hash_of_CA_to_remove</replaceable>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-add-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_add</replaceable>] [<option>-remove-property-value</option> <replaceable>name_of_property</replaceable>=<replaceable>value_to_remove</replaceable>] [<option>-unset-property</option> <replaceable>name_of_property_to_delete</replaceable>] [<option>-proxy</option> <replaceable>proxy_to_use</replaceable>] [<replaceable>publisher</replaceable>]</term>
+<listitem><para>从 <replaceable>repo_uri</replaceable> 系统信息库 URI 中检索发布者配置信息。</para>
+<para>如果为此 <command>set-publisher</command> 子命令指定了发布者操作数,则仅添加或更新该发布者。如果未指定发布者,则相应添加或更新 <replaceable>repo_uri</replaceable> 中的所有发布者。</para>
+<para>有关选项的说明,请参见上述 <command>set-publisher</command> 命令。与 <option>p</option> 一起使用时,<option>P</option>、<option>-search-first</option>、<option>-search-before</option> 以及 <option>-search-after</option> 选项仅适用于添加的发布者,而不适用于更新的发布者。</para>
+<para><option>p</option> 选项不能与以下选项结合使用:<option>g</option>、<option>-add-origin</option>、<option>G</option>、<option>-remove-origin</option>、<option>m</option>、<option>-add-mirror</option>、<option>M</option>、<option>-remove-mirror</option>、<option>-disable</option>、<option>-enable</option>、<option>-no-refresh</option> 或 <option>-reset-uuid</option>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg unset-publisher</command> <replaceable>publisher </replaceable> ...</term>
+<listitem><para>删除与一个或多个指定发布者相关联的配置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg history</command> [<option>HNl</option>] [<option>n</option> <replaceable>number</replaceable>] [<option>o</option> <replaceable>column</replaceable>[,<replaceable>column</replaceable>]...]... [<option>t</option> <replaceable>time</replaceable> | <replaceable>time</replaceable>-<replaceable>time</replaceable>[,<replaceable>time</replaceable> | <replaceable>time</replaceable>-<replaceable>time</replaceable>]...]...</term>
+<listitem><para>显示适用映像的命令历史记录。显示操作的开始时间、操作的名称(例如 <literal>install</literal>)、客户机(例如 <literal>pkg</literal>)和操作的结果(成功或失败)。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>H</option></term>
+<listitem><para>在列出时省略标题。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option></term>
+<listitem><para>显示映像的命令历史记录的长格式。显示的其他信息包括客户机的版本、执行操作的用户的名称、是否创建了新引导环境、操作完成时间和花费的总时间、发出的完整命令以及执行命令时遇到的任何错误。对于 <command>update</command> 等操作,显示已更改软件包的完整 FMRI。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>N</option></term>
+<listitem><para>显示发行说明文本。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option> <replaceable>number</replaceable></term>
+<listitem><para>仅显示指定数目的最近条目。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>column</replaceable></term>
+<listitem><para>使用指定的列名称显示输出。可以多次指定 <option>o</option> 选项;也可以通过使用逗号分隔列名称,将多个列名称指定为一个 <option>o</option> 选项的参数。有效的列名为:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>be</literal></term>
+<listitem><para>在其上启动此操作的引导环境的名称。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>be_uuid</literal></term>
+<listitem><para>在其上启动此操作的引导环境的 <literal>uuid</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>client</literal></term>
+<listitem><para>客户端的名称。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>client_ver</literal></term>
+<listitem><para>客户端的版本。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>command</literal></term>
+<listitem><para>用于此操作的命令行。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>finish</literal></term>
+<listitem><para>完成此操作时的时间。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>id</literal></term>
+<listitem><para>启动此操作的用户 ID。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>new_be</literal></term>
+<listitem><para>此操作创建的新引导环境。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>new_be_uuid</literal></term>
+<listitem><para>此操作创建的新引导环境的 <literal>uuid</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>operation</literal></term>
+<listitem><para>操作的名称。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>outcome</literal></term>
+<listitem><para>此操作的结果摘要。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>reason</literal></term>
+<listitem><para>有关此操作的结果的其他信息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>release_note</literal></term>
+<listitem><para>指示此操作是否已生成发行说明。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>snapshot</literal></term>
+<listitem><para>执行此操作期间创建的快照。仅当成功完成操作后未自动删除快照时,才会记录此信息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>start</literal></term>
+<listitem><para>启动此操作时的时间。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>time</literal></term>
+<listitem><para>执行此操作花费的总时间。对于用时不到一秒的操作,将显示 0:00:00。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>user</literal></term>
+<listitem><para>启动此操作的用户名。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>如果指定了 <literal>command</literal> 或 <literal>reason</literal> 列,则它们必须是 <option>o</option> 列表中的最后一项,这样才能让输出字段彼此分隔。这两列不能显示在同一个 <command>history</command> 命令中。</para>
+<para>如果系统上不再存在该引导环境,则在 <literal>be</literal> 或 <literal>new_be</literal> 值的后面会显示一个星号 (*)。</para>
+<para>可通过使用 <literal>be_uuid</literal> 或 <literal>new_be_uuid</literal> 字段查找当前引导环境名称,来获取 <literal>be</literal> 和 <literal>new_be</literal> 的值。如果某个引导环境后来已重命名,随后又被删除,则显示的 <literal>be</literal> 和 <literal>new_be</literal> 值是执行 <command>pkg</command> 操作时记录的值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>time</replaceable></term> <term><option>t</option> <replaceable>time</replaceable>-<replaceable>time</replaceable></term>
+<listitem><para>显示以逗号分隔列表指定的时间戳(格式为 <literal>%Y-%m-%dT%H:%M:%S</literal>)对应的日志记录(请参见 <literal>strftime</literal>(3C) 手册页)。要指定时间范围,请在开始和完成时间戳之间放置连字符 (<literal>-</literal>)。可以将关键字 <literal>now</literal> 用作当前时间的别名。可以多次指定此选项。如果指定的时间戳包含重复的时间戳或重叠的范围,则不显示重复的历史记录事件。仅显示每个历史记录事件的一个实例。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg purge-history</command></term>
+<listitem><para>删除所有现有历史记录信息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg rebuild-index</command></term>
+<listitem><para>重建由 <command>pkg search</command> 使用的索引。这是一项恢复操作,不适用于一般用途。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg update-format</command></term>
+<listitem><para>将映像格式更新到当前版本。完成此操作后,该映像无法再在早期版本的 <literal>pkg</literal>(5) 系统上使用。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg version</command></term>
+<listitem><para>显示一个用于唯一标识 <command>pkg</command> 版本的字符串。不保证在不同版本中,此字符串在任何方面都具有类似性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkg help</command></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--proxy\fR \fIproxy_to_use\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用指定的代理 URI 检索指定源 (\fB-g\fR) 或镜像 (\fB-m\fR) 的内容。代理值被存储为发布者配置的一部分,这意味着子映像所使用的系统信息库是自动更新的。此选项不能用于设置验证代理。\fIproxy_to_use\fR 值不能使用 \fBprotocol://user:password@host\fR 格式。
-.sp
-在运行时,\fBhttp_proxy\fR 或相关环境变量会覆盖此代理设置。有关接受的环境变量名列表,请参见 \fBcurl\fR(1) 手册页的“环境”部分。如果使用环境变量来设置代理 URI,则必须也将 \fBsvc:/application/pkg/system-repository\fR SMF 服务的相应代理属性设置为同一值。请参见《\fIAdding and Updating Software in Oracle Solaris 11.2\fR》中的 "Specifying a Proxy"。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--remove-property-value\fR \fIname_of_property \fR=\fIvalue_to_remove\fR\fR
-.ad
-.sp .6
-.RS 4n
-从现有发布者属性中删除值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--reset-uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-选择一个新的唯一标识符,用于向其发布者标识此映像。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove \fR\fR
-.ad
-.sp .6
-.RS 4n
-为了验证签名的软件包,将具有证书的 PEM 表示形式的给定散列的证书视为已撤销。\fBpkg publisher\fR 命令的详细输出中列出了用户撤销的 CA 证书的散列。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--search-after\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-更改发布者搜索顺序,以便在此选项中指定的发布者之后搜索添加或修改的发布者。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--search-before\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-更改发布者搜索顺序,以便在此选项中指定的发布者之前搜索添加或修改的发布者。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--set-property\fR \fIname_of_property\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-更新现有发布者属性或添加新的发布者属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sticky\fR\fR
-.ad
-.sp .6
-.RS 4n
-对于从此发布者安装的软件包,更新必须也来自此发布者。这是缺省行为。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove \fR\fR
-.ad
-.sp .6
-.RS 4n
-为了验证签名的软件包,会从已批准证书列表和已撤销证书列表中删除具有给定散列的证书。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--unset-property\fR \fIname_of_property_to_delete \fR\fR
-.ad
-.sp .6
-.RS 4n
-删除现有的发布者属性。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg set-publisher\fR \fB-p\fR \fIrepo_uri\fR [-Ped] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fIssl_key\fR] [\fB--non-sticky\fR] [\fB--sticky\fR] [\fB--search-after\fR \fIpublisher\fR] [\fB--search-before\fR \fIpublisher\fR] [\fB--search-first\fR] [\fB--approve-ca-cert\fR \fIpath_to_CA\fR] [\fB--revoke-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--unset-ca-cert\fR \fIhash_of_CA_to_remove\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--add-property-value\fR \fIname_of_property\fR=\fIvalue_to_add\fR] [\fB--remove-property-value\fR \fIname_of_property\fR=\fIvalue_to_remove\fR] [\fB--unset-property\fR \fIname_of_property_to_delete\fR] [\fB--proxy\fR \fIproxy_to_use\fR] [\fIpublisher\fR]\fR
-.ad
-.sp .6
-.RS 4n
-从 \fIrepo_uri\fR 系统信息库 URI 中检索发布者配置信息。
-.sp
-如果为此 \fBset-publisher\fR 子命令指定了发布者操作数,则仅添加或更新该发布者。如果未指定发布者,则相应添加或更新 \fIrepo_uri\fR 中的所有发布者。
-.sp
-有关选项的说明,请参见上述 \fBset-publisher\fR 命令。与 \fB-p\fR 一起使用时,\fB-P\fR、\fB--search-first\fR、\fB--search-before\fR 以及 \fB--search-after\fR 选项仅适用于添加的发布者,而不适用于更新的发布者。
-.sp
-\fB-p\fR 选项不能与以下选项结合使用:\fB-g\fR、\fB--add-origin\fR、\fB-G\fR、\fB--remove-origin\fR、\fB-m\fR、\fB--add-mirror\fR、\fB-M\fR、\fB--remove-mirror\fR、\fB--disable\fR、\fB--enable\fR、\fB--no-refresh\fR 或 \fB--reset-uuid\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg unset-publisher\fR \fIpublisher \fR ...\fR
-.ad
-.sp .6
-.RS 4n
-删除与一个或多个指定发布者相关联的配置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg history\fR [\fB-HNl\fR] [\fB-n\fR \fInumber\fR] [\fB-o\fR \fIcolumn\fR[,\fIcolumn\fR]...]... [\fB-t\fR \fItime\fR | \fItime\fR-\fItime\fR[,\fItime\fR | \fItime\fR-\fItime\fR]...]...\fR
-.ad
-.sp .6
-.RS 4n
-显示适用映像的命令历史记录。显示操作的开始时间、操作的名称(例如 \fBinstall\fR)、客户机(例如 \fBpkg\fR)和操作的结果(成功或失败)。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在列出时省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示映像的命令历史记录的长格式。显示的其他信息包括客户机的版本、执行操作的用户的名称、是否创建了新引导环境、操作完成时间和花费的总时间、发出的完整命令以及执行命令时遇到的任何错误。对于 \fBupdate\fR 等操作,显示已更改软件包的完整 FMRI。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-N\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示发行说明文本。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR \fInumber\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示指定数目的最近条目。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIcolumn\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用指定的列名称显示输出。可以多次指定 \fB-o\fR 选项;也可以通过使用逗号分隔列名称,将多个列名称指定为一个 \fB-o\fR 选项的参数。有效的列名为:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe\fR\fR
-.ad
-.sp .6
-.RS 4n
-在其上启动此操作的引导环境的名称。
-.RE
+<varlistentry><term><command>pkg image-create</command> [<option>FPUfz</option>] [<option>-force</option>] [<option>-full</option> | <option>-partial</option> | <option>-user</option>] [<option>-zone</option>] [<option>c</option> <replaceable>ssl_cert</replaceable>] [<option>k</option> <replaceable> ssl_key</replaceable>] [<option>g</option> <replaceable>path_or_uri</replaceable> | <option>-origin</option> <replaceable>path_or_uri</replaceable>]... [<option>m</option> <replaceable>uri</replaceable> | <option>-mirror</option> <replaceable>uri</replaceable>]... [<option>-facet</option> <replaceable>facet_name</replaceable>=(<literal>True</literal>|<literal>False</literal>)]... [<option>-no-refresh</option>] [<option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable>value</replaceable>] [<option>-variant</option> <replaceable>variant_name</replaceable>=<replaceable>value</replaceable>]... [(<option>p</option> | <option>-publisher</option>) [<replaceable>name</replaceable>=]<replaceable>repo_uri</replaceable>] <replaceable>dir</replaceable></term>
+<listitem><para>在 <replaceable>dir</replaceable> 指定的位置,创建一个适合于软件包操作的映像。无法引导使用 <command>image-create</command> 子命令创建的映像。大多数用户应该将 <option>-be-name</option> 或 <option>-require-new-be</option> 选项与 <command>pkg</command> 命令配合使用,或者使用 <command>beadm</command> 或 <command>zoneadm</command> 命令创建映像。<command>pkg image-create</command> 命令用于维护软件包和操作系统分发等任务。</para>
+<para>缺省的映像类型为“用户”,可以通过使用 <option>U</option> 或 <option>-user</option> 选项来指定。或者,可以将映像类型设置为完整映像(<option>-F</option> 或 <option>-full</option>),或者设置为与完整映像(包括给定的 <option>dir</option> 路径)链接的部分映像(<option>P</option> 或 <replaceable>-partial</replaceable>)。</para>
+<para>可以使用 <option>g</option> 或 <option>-origin</option> 指定其他源。可以使用 <option>m</option> 或 <option>-mirror</option> 指定其他镜像。</para>
+<para>必须使用 <option>p</option> 或 <option>-publisher</option> 选项提供软件包系统信息库 URI。如果还提供了某个发布者名称,则创建映像时仅添加该发布者。如果未提供发布者名称,则会将指定的系统信息库已知的所有发布者添加到映像。完成初始创建操作后,将会尝试检索与此发布者关联的目录。</para>
+<para>对于使用客户端 SSL 验证的发布者,可以通过 <option>c</option> 和 <option>k</option> 选项注册客户端密钥和客户端证书。此密钥和证书用于映像创建期间添加的所有发布者。</para>
+<para>如果要在非全局区域上下文中运行映像,请使用 <option>z</option> (<option>-zone</option>) 选项设置相应的变体。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>f</option></term><term><option>-force</option></term>
+<listitem><para>基于现有映像强制创建一个映像。请慎用此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-facet</option> <replaceable>facet_name</replaceable>=(<literal> True</literal>|<literal>False</literal>)</term>
+<listitem><para>将指定的侧面设置为指示值。有关侧面的更多信息,请参见 <literal>pkg</literal>(5) 手册页中的“侧面和变量”。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-refresh</option></term>
+<listitem><para>不尝试联系映像发布者的系统信息库来检索最新的可用软件包列表和其他元数据。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-set-property</option> <replaceable>name_of_property</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>将指定的映像属性设置为指示值。有关映像属性的说明,请参见下面的“映像属性”。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-variant</option> <replaceable>variant_name</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>将指定的变量设置为指示值。有关变量的更多信息,请参见 <literal>pkg</literal>(5) 手册页中的“侧面和变量”。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe_uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-在其上启动此操作的引导环境的 \fBuuid\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclient\fR\fR
-.ad
-.sp .6
-.RS 4n
-客户端的名称。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclient_ver\fR\fR
-.ad
-.sp .6
-.RS 4n
-客户端的版本。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcommand\fR\fR
-.ad
-.sp .6
-.RS 4n
-用于此操作的命令行。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBfinish\fR\fR
-.ad
-.sp .6
-.RS 4n
-完成此操作时的时间。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBid\fR\fR
-.ad
-.sp .6
-.RS 4n
-启动此操作的用户 ID。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBnew_be\fR\fR
-.ad
-.sp .6
-.RS 4n
-此操作创建的新引导环境。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBnew_be_uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-此操作创建的新引导环境的 \fBuuid\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoperation\fR\fR
-.ad
-.sp .6
-.RS 4n
-操作的名称。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoutcome\fR\fR
-.ad
-.sp .6
-.RS 4n
-此操作的结果摘要。
-.RE
+<varlistentry><term><command>pkg <option>R</option> <replaceable>dir</replaceable> dehydrate</command> [<option>nvq</option>] [<option>p</option> <replaceable>publisher</replaceable>]...</term>
+<listitem><para>从 <option>R</option> 选项指定的映像中删除所有不可编辑的打包文件和打包硬链接,以创建完全冻结的映像。打包文件和打包硬链接是当前安装的软件包版本提供的文件和硬链接。不可编辑的文件不能具有任何 <literal>preserve</literal> 或 <literal>overlay</literal> 属性,因此其 <literal>dehydrate</literal> 属性的值不能为 <literal>false</literal>。</para>
+<para><command>pkg dehydrate</command> 命令仅对备用根运行。使用 <option>R</option> 选项指定备用根。如果备用根属于引导环境,则冻结将使其无法引导。</para>
+<para>如果 <command>pkg dehydrate</command> 命令成功,则在 <option>R</option> 选项指定的 <replaceable>dir</replaceable> 映像上设置名为 <command>dehydrated</command> 的属性。<command>dehydrated</command> 属性的值是在具有已配置软件包系统信息库的 <replaceable>dir</replaceable> 映像中设置的所有发布者的列表。</para>
+<para>对来自已冻结发布者的软件包的软件包安装操作将自动冻结。如果安装已冻结映像中的软件包,则将安装软件包内容,然后将其冻结。软件包安装操作可包括 <command>update</command> 和 <command>change-facet</command> 以及 <command>install</command> 等操作。</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>删除指定的发布者提供的不可编辑文件和硬链接以创建部分冻结的映像。如果指定了映像的所有已配置发布者,则如上所述创建完全冻结的映像。</para>
+<para>如果指定了一个或多个发布者,且未在映像中配置其中任一发布者,则不会从映像中删除任何内容。</para>
+<para>如果 <command>pkg dehydrate</command> 命令成功,则在 <option>R</option> 选项指定的 <replaceable>dir</replaceable> 映像上设置名为 <command>dehydrated</command> 的属性。<command>dehydrated</command> 属性的值是 <option>p</option> 选项指定的所有发布者的列表。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于其他所有选项,请参见上面的 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBreason\fR\fR
-.ad
-.sp .6
-.RS 4n
-有关此操作的结果的其他信息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrelease_note\fR\fR
-.ad
-.sp .6
-.RS 4n
-指示此操作是否已生成发行说明。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsnapshot\fR\fR
-.ad
-.sp .6
-.RS 4n
-执行此操作期间创建的快照。仅当成功完成操作后未自动删除快照时,才会记录此信息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBstart\fR\fR
-.ad
-.sp .6
-.RS 4n
-启动此操作时的时间。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtime\fR\fR
-.ad
-.sp .6
-.RS 4n
-执行此操作花费的总时间。对于用时不到一秒的操作,将显示 0:00:00。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuser\fR\fR
-.ad
-.sp .6
-.RS 4n
-启动此操作的用户名。
-.RE
-
-如果指定了 \fBcommand\fR 或 \fBreason\fR 列,则它们必须是 \fB-o\fR 列表中的最后一项,这样才能让输出字段彼此分隔。这两列不能显示在同一个 \fBhistory\fR 命令中。
-.sp
-如果系统上不再存在该引导环境,则在 \fBbe\fR 或 \fBnew_be\fR 值的后面会显示一个星号 (*)。
-.sp
-可通过使用 \fBbe_uuid\fR 或 \fBnew_be_uuid\fR 字段查找当前引导环境名称,来获取 \fBbe\fR 和 \fBnew_be\fR 的值。如果某个引导环境后来已重命名,随后又被删除,则显示的 \fBbe\fR 和 \fBnew_be\fR 值是执行 \fBpkg\fR 操作时记录的值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fItime\fR\fR
-.ad
-.br
-.na
-\fB\fB-t\fR \fItime\fR-\fItime\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示以逗号分隔列表指定的时间戳(格式为 \fB%Y-%m-%dT%H:%M:%S\fR)对应的日志记录(请参见 \fBstrftime\fR(3C) 手册页)。要指定时间范围,请在开始和完成时间戳之间放置连字符 (\fB-\fR)。可以将关键字 \fBnow\fR 用作当前时间的别名。可以多次指定此选项。如果指定的时间戳包含重复的时间戳或重叠的范围,则不显示重复的历史记录事件。仅显示每个历史记录事件的一个实例。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg purge-history\fR\fR
-.ad
-.sp .6
-.RS 4n
-删除所有现有历史记录信息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg rebuild-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-重建由 \fBpkg search\fR 使用的索引。这是一项恢复操作,不适用于一般用途。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg update-format\fR\fR
-.ad
-.sp .6
-.RS 4n
-将映像格式更新到当前版本。完成此操作后,该映像无法再在早期版本的 \fBpkg\fR(5) 系统上使用。
-.RE
+<varlistentry><term><command>pkg <option>R</option> <replaceable>dir</replaceable> rehydrate</command> [<option>nvq</option>] [<option>p</option> <replaceable>publisher</replaceable>]...</term>
+<listitem><para>重新安装 <command>pkg dehydrate</command> 命令删除的所有文件和硬链接。</para>
+<para><command>pkg rehydrate</command> 命令仅对备用根运行。使用 <option>R</option> 选项指定备用根。</para>
+<para>如果 <command>pkg rehydrate</command> 命令成功,则映像的 <command>dehydrated</command> 属性的值为空。</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>针对指定的发布者,重新安装 <command>pkg dehydrate</command> 命令删除的所有文件和硬链接。</para>
+<para>如果指定了一个或多个发布者,且未在映像中配置其中任一发布者,则不会安装任何内容。</para>
+<para>如果 <command>pkg rehydrate</command> 命令成功,则从映像上设置的 <command>dehydrated</command> 属性的值中删除指定的发布者的名称。<command>rehydrate</command> 命令中未指定的发布者仍列在 <command>dehydrated</command> 属性中,通过这些发布者安装的内容将仍保持冻结状态。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于其他所有选项,请参见上面的 <command>install</command> 命令。</para>
+</listitem>
+</varlistentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg version\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示一个用于唯一标识 \fBpkg\fR 版本的字符串。不保证在不同版本中,此字符串在任何方面都具有类似性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg image-create\fR [\fB-FPUfz\fR] [\fB--force\fR] [\fB--full\fR | \fB--partial\fR | \fB--user\fR] [\fB--zone\fR] [\fB-c\fR \fIssl_cert\fR] [\fB-k\fR \fI ssl_key\fR] [\fB-g\fR \fIpath_or_uri\fR | \fB--origin\fR \fIpath_or_uri\fR]... [\fB-m\fR \fIuri\fR | \fB--mirror\fR \fIuri\fR]... [\fB--facet\fR \fIfacet_name\fR=(\fBTrue\fR|\fBFalse\fR)]... [\fB--no-refresh\fR] [\fB--set-property\fR \fIname_of_property\fR=\fIvalue\fR] [\fB--variant\fR \fIvariant_name\fR=\fIvalue\fR]... [(\fB-p\fR | \fB--publisher\fR) [\fIname\fR=]\fIrepo_uri\fR] \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-在 \fIdir\fR 指定的位置,创建一个适合于软件包操作的映像。无法引导使用 \fBimage-create\fR 子命令创建的映像。大多数用户应该将 \fB--be-name\fR 或 \fB--require-new-be\fR 选项与 \fBpkg\fR 命令配合使用,或者使用 \fBbeadm\fR 或 \fBzoneadm\fR 命令创建映像。\fBpkg image-create\fR 命令用于维护软件包和操作系统分发等任务。
-.sp
-缺省的映像类型为“用户”,可以通过使用 \fB-U\fR 或 \fB--user\fR 选项来指定。或者,可以将映像类型设置为完整映像(\fB--F\fR 或 \fB--full\fR),或者设置为与完整映像(包括给定的 \fB-dir\fR 路径)链接的部分映像(\fB-P\fR 或 \fI-partial\fR)。
-.sp
-可以使用 \fB-g\fR 或 \fB--origin\fR 指定其他源。可以使用 \fB-m\fR 或 \fB--mirror\fR 指定其他镜像。
-.sp
-必须使用 \fB-p\fR 或 \fB--publisher\fR 选项提供软件包系统信息库 URI。如果还提供了某个发布者名称,则创建映像时仅添加该发布者。如果未提供发布者名称,则会将指定的系统信息库已知的所有发布者添加到映像。完成初始创建操作后,将会尝试检索与此发布者关联的目录。
-.sp
-对于使用客户端 SSL 验证的发布者,可以通过 \fB-c\fR 和 \fB-k\fR 选项注册客户端密钥和客户端证书。此密钥和证书用于映像创建期间添加的所有发布者。
-.sp
-如果要在非全局区域上下文中运行映像,请使用 \fB-z\fR (\fB--zone\fR) 选项设置相应的变体。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR\fR
-.ad
-.br
-.na
-\fB\fB--force\fR\fR
-.ad
-.sp .6
-.RS 4n
-基于现有映像强制创建一个映像。请慎用此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--facet\fR \fIfacet_name\fR=(\fB True\fR|\fBFalse\fR)\fR
-.ad
-.sp .6
-.RS 4n
-将指定的侧面设置为指示值。有关侧面的更多信息,请参见 \fBpkg\fR(5) 手册页中的“侧面和变量”。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-refresh\fR\fR
-.ad
-.sp .6
-.RS 4n
-不尝试联系映像发布者的系统信息库来检索最新的可用软件包列表和其他元数据。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--set-property\fR \fIname_of_property\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-将指定的映像属性设置为指示值。有关映像属性的说明,请参见下面的“映像属性”。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--variant\fR \fIvariant_name\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-将指定的变量设置为指示值。有关变量的更多信息,请参见 \fBpkg\fR(5) 手册页中的“侧面和变量”。
-.RE
-
-.RE
-
-.SH 映像属性
-.sp
-.LP
-以下属性可定义映像的特征。这些属性存储有关映像的用途、内容和行为的信息。要查看映像中这些属性的当前值,请使用 \fBpkg property\fR 命令。要修改这些属性的值,请使用 \fBpkg set-property\fR 和 \fBpkg unset-property\fR 命令。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbe-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(字符串)指定在打包操作期间何时创建引导环境。允许使用以下值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.sp .6
-.RS 4n
-应用缺省引导环境创建策略 \fBcreate-backup\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalways-new\fR\fR
-.ad
-.sp .6
-.RS 4n
-所有软件包操作均需要重新引导:在下次引导时设为活动状态的新引导环境中执行这些操作。除非显式请求,否则不创建备份引导环境。
-.sp
-该策略最为安全,但是它比大多数站点的需要更为严格,因为在不重新引导的情况下无法添加任何软件包。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcreate-backup\fR\fR
-.ad
-.sp .6
-.RS 4n
-对于需要重新引导的软件包操作,在下一次引导时,将创建一个新的引导环境并将其设置为活动状态。如果修改了软件包或安装了可能影响内核的内容,并且该操作影响实时引导环境,将创建备份引导环境,但不会将其设置为活动状态。也可以显式请求创建备份引导环境。
-.sp
-仅当新安装的软件导致系统不稳定时(有可能发生,但比较少见),该策略才可能存在风险。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwhen-required\fR\fR
-.ad
-.sp .6
-.RS 4n
-对于需要重新引导的软件包操作,在下一次引导时,将创建一个新的引导环境并将其设置为活动状态。除非显式请求,否则不创建备份引导环境。
-.sp
-该策略的风险最高,因为如果对实时引导环境的打包更改使得以后无法再进行更改,则可能没有可回退的最近引导环境。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBca-path\fR\fR
-.ad
-.sp .6
-.RS 4n
-(字符串)一个路径名称,指向为执行 SSL 操作而将 CA 证书保存到的目录。此目录的格式特定于底层 SSL 实现。要对可信 CA 证书使用替代位置,请将此值更改为指向另一个目录。有关 CA 目录的要求,请参见 \fBSSL_CTX_load_verify_locations\fR(3openssl) 的 \fBCApath\fR 部分。
-.sp
-缺省值:\fB/etc/openssl/certs\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcheck-certificate-revocation\fR\fR
-.ad
-.sp .6
-.RS 4n
-(布尔型)如果此属性设置为 \fBTrue\fR,则软件包客户机将尝试访问用于签名验证的证书中的任何 CRL 分发点,以确定证书自颁发以来是否已被撤销。
-.sp
-缺省值:\fBFalse\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcontent-update-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(字符串)指定在打包操作期间软件包系统何时更新不可编辑的文件。允许使用以下值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.sp .6
-.RS 4n
-始终应用缺省内容更新策略。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalways\fR\fR
-.ad
-.sp .6
-.RS 4n
-始终下载并更新已更改的不可编辑文件。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwhen-required\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅当软件包系统已确定需要进行更新时,才下载并更新已更改的不可编辑文件。
-.RE
-
-缺省值:\fBalways\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBflush-content-cache-on-success\fR\fR
-.ad
-.sp .6
-.RS 4n
-(布尔型)如果此属性设置为 \fBTrue\fR,则映像修改操作成功完成时软件包客户机将删除其内容高速缓存中的文件。对于创建引导环境的操作,将同时从源和目标引导环境中删除内容。
-.sp
-在磁盘空间有限的系统上,可以使用此属性使内容高速缓存保持为较小的大小。此属性可能会导致花费更长的时间来完成操作。
-.sp
-缺省值:\fBTrue\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmirror-discovery\fR\fR
-.ad
-.sp .6
-.RS 4n
-(布尔型)此属性通知客户端使用 mDNS 和 DNS-SD 发现本地链路内容镜像。如果此属性设置为 \fBTrue\fR,则客户机尝试从其动态发现的镜像中下载软件包内容。要运行一个通过 mDNS 通告其内容的镜像,请参见 \fBpkg.depotd\fR(1M) 手册页。
-.sp
-缺省值:\fBFalse\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsend-uuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-(布尔型)执行网络操作时发送映像的通用唯一标识符 (Universally Unique Identifier, UUID)。尽管用户可以禁用此选项,但是某些网络系统信息库可能会拒绝与不提供 UUID 的客户机通信。
-.sp
-缺省值:\fBTrue\fR
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(字符串)确定在映像中安装、更新、修改或验证软件包时,要对清单执行哪些检查。应用于软件包的最终策略取决于映像策略和发布者策略的组合。该策略组合的严格程度至少相当于这两个策略单独执行时较严格的那一个。缺省情况下,软件包客户机不检查证书是否已撤销。要启用这些检查(可能需要客户机访问外部 Internet 站点),请将 \fBcheck-certificate-revocation\fR 映像属性设置为 \fBTrue\fR。允许使用以下值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBignore\fR\fR
-.ad
-.sp .6
-.RS 4n
-忽略所有清单的签名。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBverify\fR\fR
-.ad
-.sp .6
-.RS 4n
-验证所有具有签名的清单的签名是否有效,但不要求签名所有安装的软件包。这是缺省值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-signatures\fR\fR
-.ad
-.sp .6
-.RS 4n
-要求所有新安装的软件包至少具有一个有效签名。如果安装的软件包不具备有效签名,\fBpkg fix\fR 和 \fBpkg verify\fR 命令也会发出警告。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-与 \fBrequire-signatures\fR 遵循相同的要求,但还要求 \fBsignature-required-names\fR 属性中列出的字符串显示为用于验证签名信任链的证书的通用名称。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-(字符串列表)在验证软件包签名时必须视为证书通用名称的名称列表。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtrust-anchor-directory\fR\fR
-.ad
-.sp .6
-.RS 4n
-(字符串)包含映像信任锚的目录的路径名称。此路径是映像的相对路径。缺省值为 \fBignore\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuse-system-repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-(布尔型)此属性指示映像是否应使用系统信息库作为映像和发布者配置的源,以及作为与提供的发布者通信的代理。缺省值为 \fBFalse\fR。有关系统信息库的信息,请参见 \fBpkg.sysrepo\fR(1M) 手册页。
-.RE
-
-.SH 发布者属性
-.sp
-.LP
-以下属性定义了特定发布者的签名策略。具有相同名称的映像属性定义了该映像的签名策略。要查看特定发布者的这些属性的当前值,请使用 \fBpkg publisher\fR \fIpublisher_name\fR 命令。要修改发布者的这些签名策略属性的值,请使用 \fBpkg set-publisher\fR 命令的 \fB--set-property\fR 和 \fB--unset-property\fR 选项。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-policy\fR\fR
-.ad
-.sp .6
-.RS 4n
-(字符串)此属性的作用与同名映像属性的功能相同,不过它仅适用于来自特定发布者的软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsignature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-(字符串列表)此属性的作用与同名映像属性的功能相同,不过它仅适用于来自特定发布者的软件包。
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR在配置了发布者的情况下创建映像
-.sp
-.LP
-使用 \fB/aux0/example_root\fR 中存储的发布者 \fBexample.com\fR 创建一个新的完整映像。
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F -p example.com=http://pkg.example.com:10000 \e\fR
-\fB/aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR创建一个映像并指定附加源和镜像
-.sp
-.LP
-使用发布者 \fBexample.com\fR 创建一个新的完整映像。该映像还有一个附加镜像、两个附加源,并存储在 \fB/aux0/example_root\fR 中。
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F -p example.com=http://pkg.example.com:10000 \e\fR
-\fB-g http://alternate1.example.com:10000/ \e\fR
-\fB-g http://alternate2.example.com:10000/ \e\fR
-\fB-m http://mirror.example.com:10000/ \e\fR
-\fB/aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 3 \fR在未配置发布者的情况下创建映像
-.sp
-.LP
-在未配置发布者的情况下,在 \fB/aux0/example_root\fR 中创建一个新的完整映像。
-
-.sp
-.in +2
-.nf
-$ \fBpkg image-create -F /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 4 \fR安装软件包
-.sp
-.LP
-在当前映像中安装最新版本的 \fBwidget\fR 软件包。
-
-.sp
-.in +2
-.nf
-$ \fBpkg install application/widget\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 5 \fR列出软件包的指定内容
-.sp
-.LP
-列出 \fBsystem/file-system/zfs\fR 软件包的内容。显示操作名称、文件模式(如果已定义)、大小(如果已定义)、路径和目标(如果为链接)。将操作限制为类型 \fBdir\fR、\fBfile\fR、\fBlink\fR 和 \fBhardlink\fR,因为指定可用于所有操作的 \fBaction.name\fR 属性将显示一个列出了所有操作的行,而此处并不需要显示它。
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -t dir,file,link,hardlink \e\fR
-\fB-o action.name,mode,pkg.size,path,target system/file-system/zfs\fR
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>映像属性</title>
+<para>以下属性可定义映像的特征。这些属性存储有关映像的用途、内容和行为的信息。要查看映像中这些属性的当前值,请使用 <command>pkg property</command> 命令。要修改这些属性的值,请使用 <command>pkg set-property</command> 和 <command>pkg unset-property</command> 命令。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>be-policy</literal></term>
+<listitem><para>(字符串)指定在打包操作期间何时创建引导环境。允许使用以下值:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>应用缺省引导环境创建策略 <literal>create-backup</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>always-new</literal></term>
+<listitem><para>所有软件包操作均需要重新引导:在下次引导时设为活动状态的新引导环境中执行这些操作。除非显式请求,否则不创建备份引导环境。</para>
+<para>该策略最为安全,但是它比大多数站点的需要更为严格,因为在不重新引导的情况下无法添加任何软件包。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>create-backup</literal></term>
+<listitem><para>对于需要重新引导的软件包操作,在下一次引导时,将创建一个新的引导环境并将其设置为活动状态。如果修改了软件包或安装了可能影响内核的内容,并且该操作影响实时引导环境,将创建备份引导环境,但不会将其设置为活动状态。也可以显式请求创建备份引导环境。</para>
+<para>仅当新安装的软件导致系统不稳定时(有可能发生,但比较少见),该策略才可能存在风险。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>when-required</literal></term>
+<listitem><para>对于需要重新引导的软件包操作,在下一次引导时,将创建一个新的引导环境并将其设置为活动状态。除非显式请求,否则不创建备份引导环境。</para>
+<para>该策略的风险最高,因为如果对实时引导环境的打包更改使得以后无法再进行更改,则可能没有可回退的最近引导环境。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>ca-path</literal></term>
+<listitem><para>(字符串)一个路径名称,指向为执行 SSL 操作而将 CA 证书保存到的目录。此目录的格式特定于底层 SSL 实现。要对可信 CA 证书使用替代位置,请将此值更改为指向另一个目录。有关 CA 目录的要求,请参见 <literal>SSL_CTX_load_verify_locations</literal>(3openssl) 的 <literal>CApath</literal> 部分。</para>
+<para>缺省值:<literal>/etc/openssl/certs</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>check-certificate-revocation</literal></term>
+<listitem><para>(布尔型)如果此属性设置为 <literal>True</literal>,则软件包客户机将尝试访问用于签名验证的证书中的任何 CRL 分发点,以确定证书自颁发以来是否已被撤销。</para>
+<para>缺省值:<literal>False</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>content-update-policy</literal></term>
+<listitem><para>(字符串)指定在打包操作期间软件包系统何时更新不可编辑的文件。允许使用以下值:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>始终应用缺省内容更新策略。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>always</literal></term>
+<listitem><para>始终下载并更新已更改的不可编辑文件。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>when-required</literal></term>
+<listitem><para>仅当软件包系统已确定需要进行更新时,才下载并更新已更改的不可编辑文件。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>缺省值:<literal>always</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>flush-content-cache-on-success</literal></term>
+<listitem><para>(布尔型)如果此属性设置为 <literal>True</literal>,则映像修改操作成功完成时软件包客户机将删除其内容高速缓存中的文件。对于创建引导环境的操作,将同时从源和目标引导环境中删除内容。</para>
+<para>在磁盘空间有限的系统上,可以使用此属性使内容高速缓存保持为较小的大小。此属性可能会导致花费更长的时间来完成操作。</para>
+<para>缺省值:<literal>True</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mirror-discovery</literal></term>
+<listitem><para>(布尔型)此属性通知客户端使用 mDNS 和 DNS-SD 发现本地链路内容镜像。如果此属性设置为 <literal>True</literal>,则客户机尝试从其动态发现的镜像中下载软件包内容。要运行一个通过 mDNS 通告其内容的镜像,请参见 <command>pkg.depotd</command>(1M) 手册页。</para>
+<para>缺省值:<literal>False</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>send-uuid</literal></term>
+<listitem><para>(布尔型)执行网络操作时发送映像的通用唯一标识符 (Universally Unique Identifier, UUID)。尽管用户可以禁用此选项,但是某些网络系统信息库可能会拒绝与不提供 UUID 的客户机通信。</para>
+<para>缺省值:<literal>True</literal></para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-policy</literal></term>
+<listitem><para>(字符串)确定在映像中安装、更新、修改或验证软件包时,要对清单执行哪些检查。应用于软件包的最终策略取决于映像策略和发布者策略的组合。该策略组合的严格程度至少相当于这两个策略单独执行时较严格的那一个。缺省情况下,软件包客户机不检查证书是否已撤销。要启用这些检查(可能需要客户机访问外部 Internet 站点),请将 <literal>check-certificate-revocation</literal> 映像属性设置为 <literal>True</literal>。允许使用以下值:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>ignore</literal></term>
+<listitem><para>忽略所有清单的签名。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>verify</literal></term>
+<listitem><para>验证所有具有签名的清单的签名是否有效,但不要求签名所有安装的软件包。这是缺省值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-signatures</literal></term>
+<listitem><para>要求所有新安装的软件包至少具有一个有效签名。如果安装的软件包不具备有效签名,<command>pkg fix</command> 和 <command>pkg verify</command> 命令也会发出警告。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-names</literal></term>
+<listitem><para>与 <literal>require-signatures</literal> 遵循相同的要求,但还要求 <literal>signature-required-names</literal> 属性中列出的字符串显示为用于验证签名信任链的证书的通用名称。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-required-names</literal></term>
+<listitem><para>(字符串列表)在验证软件包签名时必须视为证书通用名称的名称列表。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>trust-anchor-directory</literal></term>
+<listitem><para>(字符串)包含映像信任锚的目录的路径名称。此路径是映像的相对路径。缺省值为 <literal>ignore</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>use-system-repo</literal></term>
+<listitem><para>(布尔型)此属性指示映像是否应使用系统信息库作为映像和发布者配置的源,以及作为与提供的发布者通信的代理。缺省值为 <literal>False</literal>。有关系统信息库的信息,请参见 <command>pkg.sysrepo</command>(1M) 手册页。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>发布者属性</title>
+<para>以下属性定义了特定发布者的签名策略。具有相同名称的映像属性定义了该映像的签名策略。要查看特定发布者的这些属性的当前值,请使用 <command>pkg publisher</command> <replaceable>publisher_name</replaceable> 命令。要修改发布者的这些签名策略属性的值,请使用 <command>pkg set-publisher</command> 命令的 <option>-set-property</option> 和 <option>-unset-property</option> 选项。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>signature-policy</literal></term>
+<listitem><para>(字符串)此属性的作用与同名映像属性的功能相同,不过它仅适用于来自特定发布者的软件包。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>signature-required-names</literal></term>
+<listitem><para>(字符串列表)此属性的作用与同名映像属性的功能相同,不过它仅适用于来自特定发布者的软件包。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>在配置了发布者的情况下创建映像</title>
+<para>使用 <literal>/aux0/example_root</literal> 中存储的发布者 <literal>example.com</literal> 创建一个新的完整映像。</para>
+<screen>$ <userinput>pkg image-create -F -p example.com=http://pkg.example.com:10000 &bsol;</userinput>
+<userinput>/aux0/example_root</userinput></screen>
+</example>
+<example id="GLGIN"><title>创建一个映像并指定附加源和镜像</title>
+<para>使用发布者 <literal>example.com</literal> 创建一个新的完整映像。该映像还有一个附加镜像、两个附加源,并存储在 <literal>/aux0/example_root</literal> 中。</para>
+<screen>$ <userinput>pkg image-create -F -p example.com=http://pkg.example.com:10000 &bsol;</userinput>
+<userinput>-g http://alternate1.example.com:10000/ &bsol;</userinput>
+<userinput>-g http://alternate2.example.com:10000/ &bsol;</userinput>
+<userinput>-m http://mirror.example.com:10000/ &bsol;</userinput>
+<userinput>/aux0/example_root</userinput></screen>
+</example>
+<example><title>在未配置发布者的情况下创建映像</title>
+<para>在未配置发布者的情况下,在 <literal>/aux0/example_root</literal> 中创建一个新的完整映像。</para>
+<screen>$ <userinput>pkg image-create -F /aux0/example_root</userinput></screen>
+</example>
+<example><title>安装软件包</title>
+<para>在当前映像中安装最新版本的 <literal>widget</literal> 软件包。</para>
+<screen>$ <userinput>pkg install application/widget</userinput></screen>
+</example>
+<example><title>列出软件包的指定内容</title>
+<para>列出 <literal>system/file-system/zfs</literal> 软件包的内容。显示操作名称、文件模式(如果已定义)、大小(如果已定义)、路径和目标(如果为链接)。将操作限制为类型 <literal>dir</literal>、<literal>file</literal>、<literal>link</literal> 和 <literal>hardlink</literal>,因为指定可用于所有操作的 <literal>action.name</literal> 属性将显示一个列出了所有操作的行,而此处并不需要显示它。</para>
+<screen>$ <userinput>pkg contents -t dir,file,link,hardlink &bsol;</userinput>
+<userinput>-o action.name,mode,pkg.size,path,target system/file-system/zfs</userinput>
 ACTION.NAME MODE PKG.SIZE PATH                 TARGET
 dir         0755          etc
 dir         0755          etc/fs
@@ -3261,42 +1384,22 @@
 dir         0755          kernel/fs
 dir         0755          kernel/fs/amd64
 hardlink                  kernel/fs/amd64/zfs  ../../../kernel/drv/amd64/zfs
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 6 \fR列出两个软件包的指定内容
-.sp
-.LP
-列出 \fBweb/browser/firefox\fR 和 \fBmail/thunderbird \fR 的内容,将显示的内容仅限于软件包名称,以及其 \fBpath\fR 属性以 \fB\&.desktop\fR 或 \fB\&.png\fR 结尾的操作的路径属性。
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -o pkg.name,path -a path=\e*.desktop \e\fR
-\fB-a path=\e*.png web/browser/firefox mail/thunderbird\fR
+...</screen>
+</example>
+<example><title>列出两个软件包的指定内容</title>
+<para>列出 <literal>web/browser/firefox</literal> 和 <literal>mail/thunderbird </literal> 的内容,将显示的内容仅限于软件包名称,以及其 <literal>path</literal> 属性以 <filename>.desktop</filename> 或 <filename>.png</filename> 结尾的操作的路径属性。</para>
+<screen>$ <userinput>pkg contents -o pkg.name,path -a path=&bsol;*.desktop &bsol;</userinput>
+<userinput>-a path=&bsol;*.png web/browser/firefox mail/thunderbird</userinput>
 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
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 7 \fR搜索软件包
-.sp
-.LP
-在软件包数据库中搜索标记 \fBbge\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search bge\fR
+...</screen>
+</example>
+<example><title>搜索软件包</title>
+<para>在软件包数据库中搜索标记 <literal>bge</literal>。</para>
+<screen>$ <userinput>pkg search bge</userinput>
 INDEX       ACTION VALUE                                 PACKAGE
 driver_name driver bge                                   pkg:/driver/network/ethernet/[email protected]
 basename    file   kernel/drv/sparcv9/bge                pkg:/driver/network/ethernet/[email protected]
@@ -3304,81 +1407,36 @@
 basename    file   platform/sun4v/kernel/drv/sparcv9/bge pkg:/system/kernel/[email protected]
 pkg.fmri    set    solaris/driver/network/bge            pkg:/driver/network/[email protected]
 pkg.fmri    set    solaris/driver/network/ethernet/bge   pkg:/driver/network/ethernet/[email protected]
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-该标记在软件包 \fBdriver/network/bge\fR 中,既用作代表 \fB/kernel/drv/\fI arch\fR/bge\fR 的文件操作的基名,又用作驱动程序名称。
-
-.LP
-\fB示例 8 \fR搜索文件
-.sp
-.LP
-要搜索提供某个文件的软件包,请指定该文件的全路径名,包括开头的斜杠字符。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l /usr/bin/vim\fR
+</screen>
+<para>该标记在软件包 <literal>driver/network/bge</literal> 中,既用作代表 <filename>/kernel/drv/<replaceable> arch</replaceable>/bge</filename> 的文件操作的基名,又用作驱动程序名称。</para>
+</example>
+<example id="GMEDQ"><title>搜索文件</title>
+<para>要搜索提供某个文件的软件包,请指定该文件的全路径名,包括开头的斜杠字符。</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l /usr/bin/vim</userinput>
 PATH         PKG.NAME
-usr/bin/vim  editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-要搜索某个文件和提供该文件的软件包,请指定 \fBfile\fR(对于 \fIaction_name\fR)、\fBpath\fR 或 \fBbasename\fR(对于 \fIindex\fR),以及完整或部分文件名(对于 \fItoken\fR)。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l file:basename:vim\fR
+usr/bin/vim  editor/vim/vim-core</screen>
+<para>要搜索某个文件和提供该文件的软件包,请指定 <literal>file</literal>(对于 <replaceable>action_name</replaceable>)、<literal>path</literal> 或 <literal>basename</literal>(对于 <replaceable>index</replaceable>),以及完整或部分文件名(对于 <replaceable>token</replaceable>)。</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l file:basename:vim</userinput>
 PATH         PKG.NAME
-usr/bin/vim  editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 9 \fR搜索文件和目录
-.sp
-.LP
-要搜索文件和目录以及提供它们的软件包,请指定 \fBpath\fR 或 \fBbasename\fR(对于 \fIindex\fR)以及完整或部分文件名(对于 \fItoken\fR)。根据您的 shell,您可能需要对通配符进行转义。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -o path,pkg.name -l path:*/vim\fR
+usr/bin/vim  editor/vim/vim-core</screen>
+</example>
+<example id="GMECW"><title>搜索文件和目录</title>
+<para>要搜索文件和目录以及提供它们的软件包,请指定 <literal>path</literal> 或 <literal>basename</literal>(对于 <replaceable>index</replaceable>)以及完整或部分文件名(对于 <replaceable>token</replaceable>)。根据您的 shell,您可能需要对通配符进行转义。</para>
+<screen>$ <userinput>pkg search -o path,pkg.name -l path:*/vim</userinput>
 PATH           PKG.NAME
 usr/bin/vim    editor/vim/vim-core
 usr/share/vim  editor/vim
 usr/share/vim  editor/vim/vim-core
-$ \fBpkg search -o path,pkg.name -l basename:vim\fR
+$ <userinput>pkg search -o path,pkg.name -l basename:vim</userinput>
 PATH           PKG.NAME
 usr/share/vim  editor/vim
 usr/share/vim  editor/vim/vim-core
-usr/bin/vim    editor/vim/vim-core
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 10 \fR显示哪些软件包提供特定的 SMF 服务
-.sp
-.LP
-要显示哪些软件包提供特定的 SMF 服务,请在结构化搜索中为 \fIindex\fR 指定 \fBorg.opensolaris.smf.fmri\fR 值,并为 \fItoken\fR 指定要查找的服务名称。\fBorg.opensolaris.smf.fmri\fR 值是 \fBset\fR 操作的某个属性的名称。请注意对服务名称中的 : 进行转义。
-
-.sp
-.LP
-例如,要显示哪些 HTTP 服务器可用,请为 \fItoken\fR 指定 \fBsvc:/network/http\fR 值。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search 'org.opensolaris.smf.fmri:svc\e:/network/http*'\fR
+usr/bin/vim    editor/vim/vim-core</screen>
+</example>
+<example id="GMEGA"><title>显示哪些软件包提供特定的 SMF 服务</title>
+<para>要显示哪些软件包提供特定的 SMF 服务,请在结构化搜索中为 <replaceable>index</replaceable> 指定 <literal>org.opensolaris.smf.fmri</literal> 值,并为 <replaceable>token</replaceable> 指定要查找的服务名称。<literal>org.opensolaris.smf.fmri</literal> 值是 <literal>set</literal> 操作的某个属性的名称。请注意对服务名称中的 : 进行转义。</para>
+<para>例如,要显示哪些 HTTP 服务器可用,请为 <replaceable>token</replaceable> 指定 <literal>svc:/network/http</literal> 值。</para>
+<screen>$ <userinput>pkg search 'org.opensolaris.smf.fmri:svc&bsol;:/network/http*'</userinput>
 INDEX                    ACTION VALUE                        PACKAGE
 org.opensolaris.smf.fmri set    svc:/network/http            pkg:/web/server/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http            pkg:/web/proxy/[email protected]
@@ -3390,636 +1448,281 @@
 org.opensolaris.smf.fmri set    svc:/network/http:privoxy    pkg:/web/proxy/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http:squid      pkg:/web/proxy/[email protected]
 org.opensolaris.smf.fmri set    svc:/network/http:tomcat6    pkg:/web/java-servlet/[email protected]
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 11 \fR搜索依赖于指定软件包的软件包
-.sp
-.LP
-搜索依赖于 \fBpackage/pkg\fR 的已安装软件包。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -l depend::package/pkg\fR
+</screen>
+</example>
+<example><title>搜索依赖于指定软件包的软件包</title>
+<para>搜索依赖于 <literal>package/pkg</literal> 的已安装软件包。</para>
+<screen>$ <userinput>pkg search -l depend::package/pkg</userinput>
 INDEX       ACTION VALUE                                    PACKAGE
 incorporate depend package/[email protected]      pkg:/consolidation/ips/[email protected]
-require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/library/[email protected]
-require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/library/[email protected]
 require     depend package/pkg                             pkg:/system/zones/brand/[email protected]
 require     depend pkg:/package/[email protected] pkg:/install/[email protected]
 require     depend pkg:/package/[email protected] pkg:/system/[email protected]
 require     depend pkg:/package/[email protected] pkg:/package/pkg/[email protected]
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 12 \fR搜索依赖性
-.sp
-.LP
-在安装的软件包中搜索所有 \fBincorporate\fR 依赖性。
-
-.sp
-.in +2
-.nf
-$ \fBpkg search -l depend:incorporate:\fR
+</screen>
+</example>
+<example><title>搜索依赖性</title>
+<para>在安装的软件包中搜索所有 <literal>incorporate</literal> 依赖性。</para>
+<screen>$ <userinput>pkg search -l depend:incorporate:</userinput>
 INDEX       ACTION VALUE                                PACKAGE
 incorporate depend pkg:/[email protected]  pkg:/consolidation/osnet/[email protected]
 incorporate depend pkg:/[email protected] pkg:/consolidation/osnet/[email protected]
-\&...
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 13 \fR添加发布者
-.sp
-.LP
-添加新的发布者 \fBexample.com\fR,该发布者的系统信息库位于 \fBhttp://www.example.com/repo\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g http://www.example.com/repo example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 14 \fR添加具有密钥和证书的发布者
-.sp
-.LP
-添加新的发布者 \fBexample.com\fR,该发布者的安全系统信息库位于 \fBhttps://secure.example.com/repo\fR,其密钥和证书存储在目录 \fB/root/creds\fR 中。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -k /root/creds/example.key \e\fR
-\fB-c /root/creds/example.cert -g https://secure.example.com/repo \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 15 \fR添加并自动配置发布者
-.sp
-.LP
-使用自动配置功能添加一个新的发布者,该发布者的系统信息库位于 \fB/export/repo\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -p /export/repo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 16 \fR添加并手动配置发布者
-.sp
-.LP
-使用手动配置功能添加新的发布者 \fBexample.com\fR,该发布者的系统信息库位于 \fB/export/repo/example.com\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g /export/repo example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 17 \fR添加发布者并配置代理
-.sp
-.LP
-添加源为 \fBhttp://server/repo\fR、代理为 \fBhttp://webcache:8080\fR 的新发布者 \fBmypub\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -g http://server/repo \e\fR
-\fB--proxy http://webcache:8080 mypub\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 18 \fR验证所有签名的软件包
-.sp
-.LP
-配置一个映像以验证所有签名的软件包。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-property signature-policy verify\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 19 \fR要求签名所有软件包
-.sp
-.LP
-配置一个映像,以要求签名所有软件包,并要求字符串 \fBexample.com\fR 显示为信任链中某一个证书的通用名称。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-property signature-policy require-names example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 20 \fR要求对来自指定发布者的所有软件包进行签名
-.sp
-.LP
-配置一个映像,以便必须对通过发布者 \fBexample.com\fR 安装的所有软件包进行签名。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --set-property signature-policy=require-signatures \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 21 \fR要求信任链中存在指定的字符串
-.sp
-.LP
-将字符串 \fBfoo\fR 添加到映像的通用名称列表,这些通用名称必须显示在签名的信任链中才能视为有效。
-
-.sp
-.in +2
-.nf
-$ \fBpkg add-property-value signature-require-names foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 22 \fR从指定发布者的信任链中删除某个字符串
-.sp
-.LP
-从通用名称列表中删除字符串 \fBfoo\fR,必须显示这些通用名称才能验证发布者 \fBexample.com\fR 的签名。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --remove-property-value signature-require-names=foo \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 23 \fR添加可信 CA 证书
-.sp
-.LP
-添加 \fB/tmp/example_file.pem\fR 中存储的证书,作为发布者 \fBexample.com\fR 的可信 CA 证书。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --approve-ca-cert /tmp/example_file.pem \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 24 \fR撤销证书
-.sp
-.LP
-撤销发布者 \fBexample.com\fR 的、包含散列 \fBa12345\fR 的证书,防止该证书验证来自 \fBexample.com\fR 的软件包的任何签名。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --revoke-ca-cert a12345 example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 25 \fR忘记针对某个证书执行的操作
-.sp
-.LP
-使 \fBpkg\fR 忘记用户曾经添加或撤销了证书 \fBa12345\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher --unset-ca-cert a12345 example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 26 \fR将软件包降级
-.sp
-.LP
-将安装的软件包 \[email protected]\fR 降级到更低的版本。
-
-.sp
-.in +2
-.nf
-$ \fBpkg update [email protected]\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 27 \fR切换发生冲突的软件包安装
-.sp
-.LP
-当两个软件包发生冲突时,切换所安装的软件包。假定软件包 A 依赖于软件包 B 或软件包 C,而 B 和 C 是互斥的。如果安装了 A 和 B,则使用以下命令即可改为使用 C 而不是 B,且无需卸载 A:
-
-.sp
-.in +2
-.nf
-$ \fBpkg install --reject B C\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 28 \fR列出软件包归档中的软件包
-.sp
-.LP
-列出某个软件包归档中所有软件包的所有版本。
-
-.sp
-.in +2
-.nf
-$ \fBpkg list -f -g /my/archive.p5p\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 29 \fR列出软件包系统信息库中的软件包
-.sp
-.LP
-列出某个系统信息库中所有软件包的所有版本。
-
-.sp
-.in +2
-.nf
-$ \fBpkg list -f -g http://example.com:10000\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 30 \fR显示有关软件包归档中某个软件包的信息
-.sp
-.LP
-显示软件包归档中某个软件包的最新版本的软件包信息。该软件包当前不一定已安装。
-
-.sp
-.in +2
-.nf
-$ \fBpkg info -g /my/archive.p5p pkg_name\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 31 \fR显示软件包归档中某个软件包的内容
-.sp
-.LP
-显示软件包归档中某个软件包的内容。该软件包当前未安装。
-
-.sp
-.in +2
-.nf
-$ \fBpkg contents -g /my/archive.p5p pkg_name\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 32 \fR删除发布者的所有源和镜像
-.sp
-.LP
-删除某个发布者的所有源和镜像,并添加新的源。
-
-.sp
-.in +2
-.nf
-$ \fBpkg set-publisher -G '*' -M '*' -g http://example.com:10000 \e\fR
-\fBexample.com\fR
-.fi
-.in -2
-.sp
-
-.SH 环境变量
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_IMAGE\fR\fR
-.ad
-.sp .6
-.RS 4n
-用于软件包操作的映像所在的目录。如果指定了 \fB-R\fR,则会忽略此属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_CONNECT_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-传输操作期间尝试建立连接时等待的秒数(针对每次尝试),达到此秒数后,客户端会异常中止操作。值 0 表示无限期等待。
-.sp
-缺省值:60
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_LOWSPEED_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-传输操作期间低于 \fBlowspeed\fR 限制(1024 字节/秒)的秒数,达到此秒数后,客户机会异常中止操作。值 0 表示不中止运行。
-.sp
-缺省值:30
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_CONSECUTIVE_ERROR\fR\fR
-.ad
-.sp .6
-.RS 4n
-客户端异常中止操作之前发生瞬态传输错误的最大次数。值 0 表示不中止运行。
-.sp
-缺省值:4
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_REDIRECT\fR\fR
-.ad
-.sp .6
-.RS 4n
-在传输操作期间,异常中止某个连接之前允许的最大 HTTP 或 HTTPS 重定向次数。值 0 表示不中止运行。
-.sp
-缺省值:5
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CONCURRENCY\fR\fR
-.ad
-.sp .6
-.RS 4n
-要并行更新的子映像数。如果指定了 \fB-C\fR 选项,则会忽略此属性。
-.sp
-在递归检查子映像(通常为安装的 \fBsolaris\fR 标记非全局区域)时,最多可以并行更新 \fB$PKG_CONCURRENCY\fR 个子映像。如果 \fB$PKG_CONCURRENCY\fR 为 0 或负数,则并行更新所有子映像。
-.sp
-缺省值:1
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_CLIENT_MAX_TIMEOUT\fR\fR
-.ad
-.sp .6
-.RS 4n
-客户端异常中止操作之前每台主机上的最大传输尝试次数。值 0 表示不中止运行。
-.sp
-缺省值:4
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhttp_proxy\fR、\fBhttps_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-HTTP 或 HTTPS 代理服务器。
-.RE
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-请求了多项操作,但只有一部分操作成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB4\fR\fR
-.ad
-.RS 6n
-.rt  
-未进行更改-没有要执行的操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB5\fR\fR
-.ad
-.RS 6n
-.rt  
-无法对实时映像执行请求的操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB6\fR\fR
-.ad
-.RS 6n
-.rt  
-无法完成请求的操作,因为尚未接受所安装或更新的软件包的许可证。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB7\fR\fR
-.ad
-.RS 6n
-.rt  
-该映像当前已被另一个进程使用,无法修改。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB8\fR\fR
-.ad
-.RS 6n
-.rt  
-一个或多个 SMF 执行器超时。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 文件
-.sp
-.LP
-可将 \fBpkg\fR(5) 映像放置在较大文件系统中的任意位置。在以下文件描述中,标记 \fB$IMAGE_ROOT\fR 用于区分相对路径。对于典型的系统安装,\fB$IMAGE_ROOT\fR 等效于 \fB/\fR。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-完整或部分映像的元数据目录。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户映像的元数据目录。
-.RE
-
-.sp
-.LP
-在特定映像的元数据中,某些文件和目录可能包含修复和恢复期间有用的信息。标记 \fB$IMAGE_META\fR 引用元数据所在的顶层目录。\fB$IMAGE_META\fR 通常是上述两个路径之一。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/lost+found\fR\fR
-.ad
-.sp .6
-.RS 4n
-在软件包操作期间移动的有冲突目录和文件的位置。某个已删除目录的未打包内容的位置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-为每个发布者包含一个目录。每个目录存储特定于发布者的元数据。
-.RE
-
-.sp
-.LP
-\fB$IMAGE_META\fR 目录分层结构中的其他路径是专用的,可能会进行更改。
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkgsend\fR(1)、\fBbeadm\fR(1M)、\fBpkg.depotd\fR(1M)、\fBpkg.sysrepo\fR(1M)、\fBglob\fR(3C)、\fBpkg\fR(5)
-.sp
-.LP
-\fI《Adding and Updating Software in Oracle Solaris 11.2》\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
+...</screen>
+</example>
+<example><title>添加发布者</title>
+<para>添加新的发布者 <literal>example.com</literal>,该发布者的系统信息库位于 <literal>http://www.example.com/repo</literal>。</para>
+<screen>$ <userinput>pkg set-publisher -g http://www.example.com/repo example.com</userinput></screen>
+</example>
+<example><title>添加具有密钥和证书的发布者</title>
+<para>添加新的发布者 <literal>example.com</literal>,该发布者的安全系统信息库位于 <literal>https://secure.example.com/repo</literal>,其密钥和证书存储在目录 <literal>/root/creds</literal> 中。</para>
+<screen>$ <userinput>pkg set-publisher -k /root/creds/example.key &bsol;</userinput>
+<userinput>-c /root/creds/example.cert -g https://secure.example.com/repo &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>添加并自动配置发布者</title>
+<para>使用自动配置功能添加一个新的发布者,该发布者的系统信息库位于 <literal>/export/repo</literal>。</para>
+<screen>$ <userinput>pkg set-publisher -p /export/repo</userinput></screen>
+</example>
+<example><title>添加并手动配置发布者</title>
+<para>使用手动配置功能添加新的发布者 <literal>example.com</literal>,该发布者的系统信息库位于 <literal>/export/repo/example.com</literal>。</para>
+<screen>$ <userinput>pkg set-publisher -g /export/repo example.com</userinput></screen>
+</example>
+<example id="GMFJM"><title>添加发布者并配置代理</title>
+<para>添加源为 <literal>http://server/repo</literal>、代理为 <literal>http://webcache:8080</literal> 的新发布者 <literal>mypub</literal>。</para>
+<screen>$ <userinput>pkg set-publisher -g http://server/repo &bsol;</userinput>
+<userinput>--proxy http://webcache:8080 mypub</userinput></screen>
+</example>
+<example><title>验证所有签名的软件包</title>
+<para>配置一个映像以验证所有签名的软件包。</para>
+<screen>$ <userinput>pkg set-property signature-policy verify</userinput></screen>
+</example>
+<example><title>要求签名所有软件包</title>
+<para>配置一个映像,以要求签名所有软件包,并要求字符串 <literal>example.com</literal> 显示为信任链中某一个证书的通用名称。</para>
+<screen>$ <userinput>pkg set-property signature-policy require-names example.com</userinput></screen>
+</example>
+<example><title>要求对来自指定发布者的所有软件包进行签名</title>
+<para>配置一个映像,以便必须对通过发布者 <literal>example.com</literal> 安装的所有软件包进行签名。</para>
+<screen>$ <userinput>pkg set-publisher --set-property signature-policy=require-signatures &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>要求信任链中存在指定的字符串</title>
+<para>将字符串 <literal>foo</literal> 添加到映像的通用名称列表,这些通用名称必须显示在签名的信任链中才能视为有效。</para>
+<screen>$ <userinput>pkg add-property-value signature-require-names foo</userinput></screen>
+</example>
+<example><title>从指定发布者的信任链中删除某个字符串
+</title>
+<para>从通用名称列表中删除字符串 <literal>foo</literal>,必须显示这些通用名称才能验证发布者 <literal>example.com</literal> 的签名。</para>
+<screen>$ <userinput>pkg set-publisher --remove-property-value signature-require-names=foo &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>添加可信 CA 证书</title>
+<para>添加 <literal>/tmp/example_file.pem</literal> 中存储的证书,作为发布者 <literal>example.com</literal> 的可信 CA 证书。</para>
+<screen>$ <userinput>pkg set-publisher --approve-ca-cert /tmp/example_file.pem &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>撤销证书</title>
+<para>撤销发布者 <literal>example.com</literal> 的、包含散列 <literal>a12345</literal> 的证书,防止该证书验证来自 <literal>example.com</literal> 的软件包的任何签名。</para>
+<screen>$ <userinput>pkg set-publisher --revoke-ca-cert a12345 example.com</userinput></screen>
+</example>
+<example><title>忘记针对某个证书执行的操作</title>
+<para>使 <command>pkg</command> 忘记用户曾经添加或撤销了证书 <literal>a12345</literal>。</para>
+<screen>$ <userinput>pkg set-publisher --unset-ca-cert a12345 example.com</userinput></screen>
+</example>
+<example><title>将软件包降级</title>
+<para>将安装的软件包 <literal>[email protected]</literal> 降级到更低的版本。</para>
+<screen>$ <userinput>pkg update [email protected]</userinput></screen>
+</example>
+<example><title>切换发生冲突的软件包安装</title>
+<para>当两个软件包发生冲突时,切换所安装的软件包。假定软件包 A 依赖于软件包 B 或软件包 C,而 B 和 C 是互斥的。如果安装了 A 和 B,则使用以下命令即可改为使用 C 而不是 B,且无需卸载 A:</para>
+<screen>$ <userinput>pkg install --reject B C</userinput></screen>
+</example>
+<example><title>列出软件包归档中的软件包</title>
+<para>列出某个软件包归档中所有软件包的所有版本。</para>
+<screen>$ <userinput>pkg list -f -g /my/archive.p5p</userinput></screen>
+</example>
+<example><title>列出软件包系统信息库中的软件包</title>
+<para>列出某个系统信息库中所有软件包的所有版本。</para>
+<screen>$ <userinput>pkg list -f -g http://example.com:10000</userinput></screen>
+</example>
+<example><title>显示有关软件包归档中某个软件包的信息</title>
+<para>显示软件包归档中某个软件包的最新版本的软件包信息。该软件包当前不一定已安装。</para>
+<screen>$ <userinput>pkg info -g /my/archive.p5p pkg_name</userinput></screen>
+</example>
+<example><title>显示软件包归档中某个软件包的内容</title>
+<para>显示软件包归档中某个软件包的内容。该软件包当前未安装。</para>
+<screen>$ <userinput>pkg contents -g /my/archive.p5p pkg_name</userinput></screen>
+</example>
+<example><title>删除发布者的所有源和镜像</title>
+<para>删除某个发布者的所有源和镜像,并添加新的源。</para>
+<screen>$ <userinput>pkg set-publisher -G '*' -M '*' -g http://example.com:10000 &bsol;</userinput>
+<userinput>example.com</userinput></screen>
+</example>
+<example><title>冻结和解除冻结映像</title>
+<para>在这些示例中,<literal>/tmp/test_image</literal> 是要冻结和解除冻结的映像。</para>
+<para>因为未指定发布者,所以以下命令作用于 <literal>/tmp/test_image</literal> 映像中启用的所有发布者,进而完全冻结 <literal>/tmp/test_image</literal> 映像。</para>
+<screen>$ <userinput>pkg -R /tmp/test_image dehydrate</userinput></screen>
+<para>因为未指定发布者,所以以下命令作用于 <literal>/tmp/test_image</literal> 映像中配置的所有发布者,以完全恢复 <literal>/tmp/test_image</literal> 映像。</para>
+<screen>$ <userinput>pkg -R /tmp/test_image rehydrate</userinput></screen>
+</example>
+<example><title>冻结和解除冻结指定发布者的映像</title>
+<para>在这些示例中,<literal>/tmp/test_image</literal> 是要冻结和解除冻结的映像,在 <literal>/tmp/test_image</literal> 映像中启用了 <literal>test1</literal> 和 <literal>test2</literal> 发布者且其源提供了必要的内容。</para>
+<para>以下命令仅作用于 <literal>test1</literal> 发布者提供的文件和硬链接。</para>
+<screen>$ <userinput>pkg -R /tmp/test_image dehydrate -p test1</userinput></screen>
+<para>以下命令仅解除冻结 <literal>test1</literal> 发布者提供的文件和硬链接。</para>
+<screen>$ <userinput>pkg -R /tmp/test_image rehydrate -p test1</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><envar>PKG_IMAGE</envar></term>
+<listitem><para>用于软件包操作的映像所在的目录。如果指定了 <option>R</option>,则会忽略此属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_CONNECT_TIMEOUT</envar></term>
+<listitem><para>传输操作期间尝试建立连接时等待的秒数(针对每次尝试),达到此秒数后,客户端会异常中止操作。值 0 表示无限期等待。</para>
+<para>缺省值:60</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_LOWSPEED_TIMEOUT</envar></term>
+<listitem><para>传输操作期间低于 <literal>lowspeed</literal> 限制(1024 字节/秒)的秒数,达到此秒数后,客户机会异常中止操作。值 0 表示不中止运行。</para>
+<para>缺省值:30</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_CONSECUTIVE_ERROR</envar></term>
+<listitem><para>客户端异常中止操作之前发生瞬态传输错误的最大次数。值 0 表示不中止运行。</para>
+<para>缺省值:4</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_REDIRECT</envar></term>
+<listitem><para>在传输操作期间,异常中止某个连接之前允许的最大 HTTP 或 HTTPS 重定向次数。值 0 表示不中止运行。</para>
+<para>缺省值:5</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CONCURRENCY</envar></term>
+<listitem><para>要并行更新的子映像数。如果指定了 <option>C</option> 选项,则会忽略此属性。</para>
+<para>在递归检查子映像(通常为安装的 <literal>solaris</literal> 标记非全局区域)时,最多可以并行更新 <envar>$PKG_CONCURRENCY</envar> 个子映像。如果 <envar>$PKG_CONCURRENCY</envar> 为 0 或负数,则并行更新所有子映像。</para>
+<para>缺省值:1</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_CLIENT_MAX_TIMEOUT</envar></term>
+<listitem><para>客户端异常中止操作之前每台主机上的最大传输尝试次数。值 0 表示不中止运行。</para>
+<para>缺省值:4</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>http_proxy</envar>、<envar>https_proxy</envar></term>
+<listitem><para>HTTP 或 HTTPS 代理服务器。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>请求了多项操作,但只有一部分操作成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>4</returnvalue></term>
+<listitem><para>未进行更改-没有要执行的操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>5</returnvalue></term>
+<listitem><para>无法对实时映像执行请求的操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>6</returnvalue></term>
+<listitem><para>无法完成请求的操作,因为尚未接受所安装或更新的软件包的许可证。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>7</returnvalue></term>
+<listitem><para>该映像当前已被另一个进程使用,无法修改。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>8</returnvalue></term>
+<listitem><para>一个或多个 SMF 执行器超时。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para>可将 <literal>pkg</literal>(5) 映像放置在较大文件系统中的任意位置。在以下文件说明中,标记 <envar>$IMAGE_ROOT</envar> 用于区分相对路径。对于典型的系统安装,<envar>$IMAGE_ROOT</envar> 等效于 <literal>/</literal>。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>完整或部分映像的元数据目录。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>用户映像的元数据目录。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>在特定映像的元数据中,某些文件和目录可能包含修复和恢复期间有用的信息。标记 <envar>$IMAGE_META</envar> 引用元数据所在的顶层目录。<envar>$IMAGE_META</envar> 通常是上述两个路径之一。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_META/lost+found</filename></term>
+<listitem><para>在软件包操作期间移动的有冲突目录和文件的位置。某个已删除目录的未打包内容的位置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/publisher</filename></term>
+<listitem><para>为每个发布者包含一个目录。每个目录存储特定于发布者的元数据。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><envar>$IMAGE_META</envar> 目录分层结构中的其他路径是专用的,可能会进行更改。</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="beadm-1m"><citerefentry><refentrytitle>beadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.sysrepo-1m"><citerefentry><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<literal>glob</literal>(3C)、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="AUOSS">《<citetitle remap="book">在 Oracle Solaris 11.3 中添加和更新软件</citetitle>》</olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
--- a/src/man/zh_CN/pkg.5	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkg.5	Wed Jul 01 10:45:55 2015 -0700
@@ -1,1627 +1,743 @@
-'\" te
-.\" Copyright (c) 2009, 2014, Oracle and/or its affiliates.All rights reserved.
-.TH pkg 5 "2014 年 4 月 10 日" "SunOS 5.11" "标准、环境和宏"
-.SH 名称
-pkg \- 映像包管理系统
-.SH 描述
-.sp
-.LP
-映像包管理系统 \fBpkg\fR(5) 是用于提供软件生命周期管理(安装、升级和删除)的框架。映像包管理以软件包为单位对软件进行管理,软件包是由一组关键字/值对以及可能的数据有效负荷定义的操作的集合。在许多情况下,操作是在文件系统中找到的文件,但它们也表示其他可安装对象,例如驱动程序、服务和用户。
-.SH 软件包 FMRI 和版本
-.sp
-.LP
-每个软件包均由带有机制 \fBpkg:\fR 的故障管理资源标识符 (fault management resource identifier, FMRI) 表示。软件包的完整 FMRI 由机制、发布者、软件包名称和以下格式的版本字符串组成:
-.sp
-.in +2
-.nf
-pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-\fBsolaris\fR 是发布者。\fBsystem/library/c++-runtime\fR 是软件包名称。虽然名称空间是有层次的且可具有任意深度,但不存在强制包含;名称从本质上而言是任意的。发布者信息为可选项,但必须位于 \fBpkg://\fR 之后(如果存在)。包含发布者的 FMRI 通常被称为“全限定”。如果不存在发布者信息,那么软件包名称之前通常应带有 \fBpkg:/\fR。
-.sp
-.LP
-如果 FMRI 不包含发布者信息,打包客户端通常允许省略 FMRI 的机制。例如,\fBpkg:/system/library/c++-runtime\fR 可以写为 \fBsystem/library/c++-runtime\fR。如果省略了机制,客户端也允许省略除软件包名称的最后一个组成部分(用于匹配目的)之外的所有其他内容。例如,\fBsystem/library/c++-runtime\fR 可以写为 \fBlibrary/c++-runtime\fR 或 \fBc++-runtime\fR,这将与名为 \fBc++-runtime\fR 的软件包或以 \fB/c++-runtime\fR 结尾的软件包名称匹配。
-.sp
-.LP
-发布者名称将个人、个人组或组织标识为一个或多个软件包的源。为避免发布者名称冲突并有帮于标识发布者,最佳做法是使用代表发布软件包实体的域名作为发布者名称。
-.sp
-.LP
-版本跟在软件包名称后面,由 @ 符号分隔。版本包含四个数字序列,由标点符号分隔。前三个序列中的元素由圆点分隔,各序列可具有任意长度。不允许版本的组成部分以零开头(例如 01.1 或 1.01)。允许以零结尾(例如 1.10)。
-.sp
-.LP
-版本的第一个部分是组件版本。对于紧密绑定到操作系统上的组件,此序列通常是操作系统中该版本的 \fBuname -r\fR 值。对于具有自己的开发生命周期的组件,此序列是一个由小圆点分隔的发行编号,例如 2.4.10。
-.sp
-.LP
-版本的第二个部分(如果存在)必须跟在逗号 (,) 后面,是内部版本。内部版本指定构建软件包内容的操作系统版本,提供了希望软件包内容可成功运行的最低操作系统版本。
-.sp
-.LP
-版本的第三个部分(如果存在)必须跟在连字符 (\fB-\fR) 后面,是分支版本。分支版本是用于提供特定于供应商的信息的版本控制组件。分支版本可在打包元数据发生更改时增大,独立于组件版本。分支版本可能包含内部版本号或其他信息。
-.sp
-.LP
-版本的第四个部分(如果存在)必须跟在冒号 (:) 后面,是一个时间戳。时间戳表示软件包的发布时间。
-.sp
-.LP
-在版本之间进行比较时,不考虑完整版本的任何组件,除非左侧的组件与其相同。因此,\fB4.3-1\fR 大于 \fB4.2-7\fR,因为 \fB4.3\fR 大于 \fB4.2\fR;\fB4.3-3\fR 大于 \fB4.3-1\fR,因为 \fB3\fR 大于 \fB1\fR。
-.sp
-.LP
-\fBpkg.human-version\fR 属性可以用于提供人工可读的版本字符串。对于软件包 FMRI,除了上文描述的软件包版本外,还可以提供 \fBpkg.human-version\fR 属性值,但该值不能替代软件包 FMRI 版本。人工可读的版本字符串仅用于显示目的。请参见“设置操作”了解更多信息。
-.sp
-.LP
-系统的许多部分(如果适用)会在显示 FMRI 时缩短 FMRI 并接受简短格式的输入,以减少显示的或所需的信息量。通常,可以省略机制、发布者、内部版本和时间戳。有时可以省略所有版本控制信息。
-.SH 操作
-.sp
-.LP
-操作表示系统上的可安装对象。在软件包的清单中对操作进行了描述。每个操作主要由其名称和一个关键属性组成。这些属性共同引用一个唯一的对象,与该对象一样遵循版本历史记录。操作可以具有其他属性。某些属性由包管理系统直接解释。其他属性可能仅对系统管理员或最终用户有用。
-.sp
-.LP
-操作具有一种简单文本表示法:
-.sp
-.in +2
-.nf
-\fIaction_name\fR \fIattribute1\fR=\fIvalue1\fR \fIattribute2\fR=\fIvalue2\fR ...
-.fi
-.in -2
-
-.sp
-.LP
-属性名称中不能包含空格、引号或等号 (=)。第一个等号后的所有字符都属于值。值中可以包含所有这些符号,虽然空格必须括在单引号或双引号中。单引号处于括在双引号中的字符串内时不需要进行转义,双引号处于括在单引号中的字符串内时也不需要进行转义。可使用反斜杠 (\) 字符作为引号的前缀来避免终止带引号的字符串。反斜杠可使用反斜杠进行转义。
-.sp
-.LP
-操作可以具有多个属性。可以针对单个操作使用不同的值来多次命名某些属性。具有相同名称的多个属性将被视为无序列表。
-.sp
-.LP
-具有多个属性的操作可以在清单文件中创建长行。可以通过使用反斜杠终止每个不完整的行来对此类行进行折行。请注意,属性/值对之间必须具有此接续字符。属性、属性值及其组合均不可分离。
-.sp
-.LP
-下面列出的属性不是全部属性。事实上,任意属性都可附加到操作中,标准属性组易于扩大以合并将来的开发。
-.sp
-.LP
-某些属性会导致在打包上下文外部执行其他操作。这些属性记录在下面的“执行器”部分中。
-.SS "文件操作"
-.sp
-.LP
-\fBfile\fR 操作表示普通文件。\fBfile\fR 操作引用有效负荷,具有四个标准属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpath\fR\fR
-.ad
-.RS 9n
-.rt  
-安装文件的文件系统路径。此属性是 \fBfile\fR 操作的关键属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmode\fR\fR
-.ad
-.RS 9n
-.rt  
-文件的访问权限(采用数字格式)。这些只是简单权限,并非 ACL。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBowner\fR\fR
-.ad
-.RS 9n
-.rt  
-拥有文件的用户的名称。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR\fR
-.ad
-.RS 9n
-.rt  
-拥有文件的组的名称。
-.RE
-
-.sp
-.LP
-有效负荷是一个位置属性,因为它未命名。它是操作名称后面的第一个词。在发布的清单中,它是文件内容的 \fBSHA-1\fR 散列。如果存在于尚待发布的清单中,则它表示可以找到有效负荷的路径。请参见 \fBpkgsend\fR(1)。如果值包括一个等号,则可以使用散列属性代替位置属性。这两种属性可用于同一操作中。但是,散列必须完全相同。
-.sp
-.LP
-\fBpreserve\fR 和 \fBoverlay\fR 属性影响是否以及如何安装 \fBfile\fR 操作。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpreserve\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定在软件包操作过程中何时以及如何保留文件。
-.sp
-初始安装软件包时,如果软件包提供的文件使用任何值定义了 \fBpreserve\fR 属性并且该文件已经存在于映像中,则现有文件将存储在 \fB/var/pkg/lost+found \fR 中并且安装打包的文件。
-.sp
-初始安装软件包时,如果软件包提供的文件定义了 \fBpreserve\fR 属性,但该文件尚未存在于映像中,则是否安装该文件取决于 \fBpreserve\fR 属性的值:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果 \fBpreserve\fR 的值是 \fBlegacy\fR,则不安装打包的文件。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果 \fBpreserve\fR 的值不是 \fBlegacy\fR,则安装打包的文件。
-.RE
-软件包降级时,如果软件包的降级版本提供的文件使用任何值定义了 \fBpreserve\fR 属性并且以下所有条件都为 true,将使用扩展名 \fB\&.update\fR 重命名映像中当前存在的文件并安装降级软件包中的文件:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-文件存在于映像中。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-软件包的降级版本提供的文件的内容不同于软件包的当前安装版本提供的文件的内容。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-软件包的降级版本提供的文件的内容不同于映像中存在的文件的内容。
-.RE
-如果以上任一条件不为 true,处理文件的方式与升级(而不是降级)软件包时相同。
-.sp
-升级软件包时,如果软件包的升级版本提供的 \fBfile\fR 操作使用任何值定义了 \fBpreserve\fR 属性并且 \fBfile\fR 操作与软件包的当前安装版本提供的 \fBfile\fR 操作相同,则不安装文件并且不修改映像中存在的文件。将保留自安装先前版本以来进行的所有修改。
-.sp
-升级软件包时,如果软件包的升级版本提供的 \fBfile\fR 操作定义了 \fBpreserve\fR 属性并且 \fBfile\fR 操作是新的或者不同于软件包的当前安装版本提供的 \fBfile\fR 操作,则以下面的方式执行升级:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果文件不存在于映像中,将安装新文件。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果软件包的升级版本提供的文件存在于映像中,不存在于软件包的当前安装版本中并且未使用 \fBoriginal_name\fR 属性进行重命名或移动(请参见下文),则现有文件将存储在 \fB/var/pkg/lost+found\fR 中并且安装软件包的升级版本提供的文件。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果软件包的升级版本提供的文件存在于映像中并且其内容不同于软件包的当前安装版本提供的文件,则根据 \fBpreserve\fR 属性的值进行升级:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果软件包的升级版本提供的文件具有的 \fBpreserve\fR 值为 \fBrenameold\fR,将使用扩展名 \fB\&.old\fR 重命名现有文件并且使用更新的权限和时间戳(如果存在)安装新文件。请参见下文的 \fBtimestamp\fR 属性描述。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果软件包的升级版本提供的文件具有的 \fBpreserve\fR 值为 \fBrenamenew\fR,将使用扩展名 \fB\&.new\fR 安装新文件并且不修改现有文件。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果软件包的升级版本提供的文件具有的 \fBpreserve\fR 值为 \fBtrue\fR,则不安装新文件,但是在现有文件中重置权限和时间戳(如果存在)。
-.RE
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果软件包的升级版本提供的文件存在于映像中,具有的内容与软件包的当前安装版本提供的文件相同并且具有的 \fBpreserve\fR 值为 \fBrenameold\fR 或 \fBrenamenew\fR,则现有文件将替换为软件包的升级版本提供的文件,包括替换权限和时间戳(如果存在)。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果软件包的升级版本提供的文件存在于映像中,在升级的软件包中具有的 \fBpreserve\fR 值为 \fBlegacy\fR,并且在软件包的当前安装版本中具有不同的 \fBpreserve\fR 值,则使用扩展名 \fB\&.legacy\fR 重命名现有文件,并使用更新的权限和时间戳(如果存在)安装新文件。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果软件包的升级版本提供的文件存在于映像中并且在升级的软件包和软件包的当前安装版本中具有的 \fBpreserve\fR 值为 \fBlegacy \fR,则在现有文件中重置权限和时间戳(如果存在)。
-.RE
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoverlay\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定操作是允许其他软件包在同一位置交付文件,还是用交付的文件覆盖其他文件。此功能设计用于不参与任何自组装(例如 \fB/etc/motd\fR)且可安全覆盖的配置文件。
-.sp
-如果未指定 \fBoverlay\fR,多个软件包将无法向同一位置提供文件。
-.sp
-\fBoverlay\fR 属性可以使用以下值之一:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBallow\fR\fR
-.ad
-.RS 9n
-.rt  
-允许另一个软件包将文件交付到同一位置。除非也设置了 \fBpreserve\fR 属性,否则此值没有效果。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtrue\fR\fR
-.ad
-.RS 9n
-.rt  
-该操作交付的文件将覆盖已指定了 \fBallow\fR 的任何其他操作。
-.RE
-
-基于覆盖文件的 \fBpreserve\fR 属性值保留对已安装文件所做的更改。在删除时,如果仍要安装将覆盖的操作,则将保留文件的内容,无论是否指定了 \fBpreserve\fR 属性。只能一个操作覆盖另一个操作,且 \fBmode\fR、\fBowner\fR 和 \fBgroup\fR 属性必须匹配。
-.RE
-
-.sp
-.LP
-对于 ELF 文件,可识别下列属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfarch\fR\fR
-.ad
-.sp .6
-.RS 4n
-ELF 文件的体系结构。此属性是 \fBuname -p\fR 查询文件所基于的体系结构后的输出。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfbits\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性为 \fB32\fR 或 \fB64\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBelfhash\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性是文件中“相关”ELF 部分的散列。这些部分已在装入二进制文件时映射到内存中。在确定两个二进制文件的可执行行为是否将不同时,仅需要考虑这些部分。
-.RE
-
-.sp
-.LP
-对于 \fBfile\fR 操作,可识别下列其他属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoriginal_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性用于处理可编辑文件在软件包之间或在位置之间(或在这两者之间)的移动操作。此属性采用的格式为源软件包的名称后跟一个冒号和文件的原始路径。所删除的任何文件将使用其软件包和路径或 \fBoriginal_name\fR 属性的值(如果指定)进行记录。所安装的已设置 \fBoriginal_name\fR 属性的任何可编辑文件将使用具有该名称的文件(如果它在同一打包操作中被删除)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrelease-note\fR\fR
-.ad
-.sp .6
-.RS 4n
-该属性用于指明此文件包含发行说明文本。该属性的值为软件包 FMRI。如果 FMRI 指定的软件包名称存在于原始映像中,指定的版本比原始映像中的软件包版本更高,则此文件将成为发行说明的一部分。特殊 FMRI \fBfeature/pkg/self\fR 是指包含软件包。如果 \fBfeature/pkg/self\fR 的版本为 0,则此文件仅在初次安装时是发行说明的一部分。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrevert-tag\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性用于标记应恢复为一个组的可编辑文件。\fBrevert-tag\fR 属性的值为 \fItagname\fR。可为单个 \fBfile\fR 操作指定多个 \fBrevert-tag\fR 属性。在使用所指定的任意标记调用 \fBpkg revert\fR 时,文件将恢复为其清单定义的状态。有关 \fBpkg revert\fR 命令的更多信息,请参见 \fBpkg\fR(1) 手册页。
-.sp
-还可以在目录级别指定 \fBrevert-tag\fR 属性。请参见下文中的“目录操作”。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsysattr\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性用于指定应该为此文件设置的任何系统属性。\fBsysattr\fR 属性的值可以是逗号分隔的详细系统属性列表,也可以是精简系统属性选项的字符串序列,如以下示例中所示。支持的系统属性在 \fBchmod\fR(1) 手册页中有介绍。在清单中指定的系统属性是一种额外设置,是对可能已由操作系统的其他子系统设置的系统属性的进一步设置。
-.sp
-.in +2
-.nf
-file path=opt/secret_file sysattr=hidden,sensitive
-file path=opt/secret_file sysattr=HT
-.fi
-.in -2
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtimestamp\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性用于设置文件的访问权限和修改时间。必须以 ISO-8601 格式使用 UTC 表示 \fBtimestamp\fR 属性值,省略冒号和连字符。
-.sp
-为 Python 打包 \fB .pyc\fR 或 \fB\&.pyo\fR 文件时需要 \fBtimestamp\fR 属性。\fB\&.pyc\fR 或 \fB\&.pyo\fR 文件的相关 \fB .py\fR 文件必须使用这些文件内嵌入的时间戳进行标记,如以下示例中所示:
-.sp
-.in +2
-.nf
-file path=usr/lib/python2.6/vendor-packages/pkg/__init__.pyc ...
-file path=usr/lib/python2.6/vendor-packages/pkg/__init__.py \e
-     timestamp=20130311T221521Z ...
-.fi
-.in -2
-
-.RE
-
-.sp
-.LP
-\fBfile\fR 操作的以下属性由系统自动生成,不能由软件包开发者指定:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhash\fR\fR
-.ad
-.sp .6
-.RS 4n
-未压缩文件的 SHA-1 散列。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBchash\fR\fR
-.ad
-.sp .6
-.RS 4n
-压缩文件的 SHA-1 散列。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.size\fR\fR
-.ad
-.sp .6
-.RS 4n
-未压缩文件的大小(字节)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.csize\fR\fR
-.ad
-.sp .6
-.RS 4n
-压缩文件的大小(字节)。
-.RE
-
-.SS "目录操作"
-.sp
-.LP
-\fBdir\fR 操作类似于 \fBfile\fR 操作,因为它表示文件系统对象。但 \fBdir\fR 操作表示目录而不是普通文件。\fBdir\fR 操作具有与 \fBfile\fR 操作相同的 \fBpath\fR、\fBmode\fR、\fBowner\fR 和 \fBgroup\fR 属性,其中 \fBpath\fR 是关键属性。\fBdir\fR 操作也接受 \fBrevert-tag\fR 属性。\fBrevert-tag\fR 属性的值对 \fBfile\fR 和 \fBdir\fR 操作是不同的。
-.sp
-.LP
-目录是 IPS 中包括的引用。当显式或隐式引用某目录的最新软件包不再引用该目录时,将删除该目录。如果该目录包含未打包的文件系统对象,则将这些项移动到 \fB$IMAGE_META/lost+found\fR 中。有关 \fB$IMAGE_META\fR 的更多信息,请参见“文件”部分。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrevert-tag\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性用于标识应作为一个集合删除的未打包文件。有关如何为 \fBfile\fR 操作指定此属性的说明,请参见上文中的“文件操作”。对于目录,\fBrevert-tag\fR 属性的值为 \fItagname\fR\fB=\fR\fIpattern\fR。可为单个 \fBdir\fR 操作指定多个 \fBrevert-tag\fR 属性。在使用匹配的 \fItagname\fR 调用 \fBpkg revert\fR 时,将删除此 \fBdir\fR 目录下匹配 \fIpattern\fR(使用 shell glob 字符)的所有未打包文件或目录。有关 \fBpkg revert\fR 命令的更多信息,请参见 \fBpkg\fR(1) 手册页。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsalvage-from\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性可用于将未打包的内容移动到一个新目录中。此属性的值是所挽救项的目录的名称。创建以 \fBsalvage-from\fR 属性的值命名的目录的任何内容时,具有 \fBsalvage-from\fR 属性的目录会继承。
-.RE
-
-.SS "链接操作"
-.sp
-.LP
-\fBlink\fR 操作表示符号链接。\fBlink\fR 操作具有以下标准属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-安装符号链接的文件系统路径。此属性是 \fBlink\fR 操作的关键属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtarget\fR\fR
-.ad
-.sp .6
-.RS 4n
-符号链接的目标。链接将解析到的文件系统对象。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定由给定中介组(例如 \fBpython\fR)中涉及的所有路径名称共享的中介名称空间中的条目。可基于 \fBmediator-version\fR 和/或 \fBmediator-implementation\fR 执行链接中介。给定路径名称的所有中介链接必须指定同一中介。但是,并非所有中介版本和实现都需要在给定路径上提供链接。如果中介不提供链接,则会在选定该中介时删除链接。\fBmediator\fR 与特定版本和/或实现组合起来表示可选择供包管理系统使用的中介。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-version\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定 \fBmediator\fR 属性描述的接口的版本(表示为非负整数的点分序列)。如果指定了 \fBmediator\fR 而未指定 \fBmediator-implementation\fR,则此属性是必需的。本地系统管理员可以显式设置要使用的版本。指定的值通常应与提供链接的软件包版本相匹配(例如,\fBruntime/python-26\fR 应使用 \fBmediator-version=2.6\fR),尽管这不是必需的。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-implementation\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定除 \fBmediator-version\fR 之外还使用中介实现,或使用中介实现代替 mediator-version。不认为实现字符串应进行排序,如果系统管理员未显式指定,则由 \fBpkg\fR(5) 任意选择一个字符串。
-.sp
-该值可以是由字母数字字符和空格组成的任意长度的字符串。如果实现本身可被版本化或已被版本化,则应在字符串的结尾处在 @ 之后指定版本(表示为非负整数的点分序列)。如果存在实现的多个版本,则缺省行为是选择最高版本的实现。
-.sp
-如果系统上仅安装了特定路径的实现中介链接的一个实例,则会自动选择该实例。如果以后安装了该路径的其他链接,除非应用供应商、站点或本地覆盖或者如果某一链接进行了版本中介,否则不会切换链接。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmediator-priority\fR\fR
-.ad
-.sp .6
-.RS 4n
-在解决中介链接中的冲突时,\fBpkg\fR(5) 通常会选择 \fBmediator-version\fR 值最大的链接,如果不可能,则会基于 \fBmediator-implementation\fR 进行选择。此属性用于为常规冲突解决方案过程指定覆盖。
-.sp
-如果未指定此属性,则会应用缺省中介选择逻辑。
-.sp
-如果值为 \fBvendor\fR,则与未指定 \fBmediator-priority\fR 的链接相比,会优先选择该链接。
-.sp
-如果值为 \fBsite\fR,则与值为 \fBvendor\fR 或未指定 \fBmediator-priority\fR 的链接相比,会优先选择该链接。
-.sp
-本地系统管理员可以覆盖上面所述的选择逻辑。
-.RE
-
-.SS "硬链接操作"
-.sp
-.LP
-\fBhardlink\fR 操作表示硬链接。它具有与 \fBlink\fR 操作相同的属性,\fBpath\fR 也是其关键属性。
-.SS "驱动程序操作"
-.sp
-.LP
-\fBdriver\fR 操作表示设备驱动程序。\fBdriver\fR 操作不引用有效负荷。驱动程序文件自身必须作为 \fBfile\fR 操作进行安装。可识别下列属性(有关更多信息,请参见 \fBadd_drv\fR(1M)):
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.sp .6
-.RS 4n
-驱动程序的名称。这通常是(但并不总是)二进制驱动程序文件的文件名。此属性是 \fBdriver\fR 操作的关键属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBalias\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性表示驱动程序的别名。给定的驱动程序可以具有多个 \fBalias\fR 属性。无需任何特殊的引号规则。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclass\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性表示驱动程序类。给定的驱动程序可以具有多个 \fBclass\fR 属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBperms\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性表示驱动程序的设备节点的文件系统权限。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBclone_perms\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性表示此驱动程序的克隆驱动程序次要节点的文件系统权限。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpolicy\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性指定设备的其他安全策略。给定的驱动程序可以具有多个 \fBpolicy\fR 属性,但次要设备规范不可以存在于多个属性中。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBprivs\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性指定驱动程序所用的特权。给定的驱动程序可以具有多个 \fBprivs\fR 属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdevlink\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性指定 \fB/etc/devlink.tab\fR 中的条目。该值是定义了进入文件的确切行,带有由 \fB\t\fR 表示的制表符。有关更多信息,请参见 \fBdevlinks\fR(1M)。给定的驱动程序可以具有多个 \fBdevlink\fR 属性。
-.RE
-
-.SS "依赖操作"
-.sp
-.LP
-\fBdepend\fR 操作表示软件包间的依赖性。一个软件包可以依赖于另一个软件包,因为第一个软件包需要第二个软件包中的功能才能运行自身包含的功能或者甚至进行安装。依赖性可以是可选的。如果安装时未满足某个依赖性,包管理系统会尝试安装或更新依赖软件包至足够新的版本(受其他约束限制)。
-.sp
-.LP
-可以识别下列属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBfmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-表示依赖软件包的 FMRI。此属性是 \fBdependency\fR 操作的关键属性。\fBfmri\fR 值不得包括发布者。假定软件包名称是完整的。\fBrequire-any\fR 类型的依赖性可具有多个 \fBfmri\fR 属性。\fBfmri\fR 值中的版本是可选项,虽然对于某些类型的依赖性来说,不带版本的 \fBfmri\fR 没有任何意义。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBtype\fR\fR
-.ad
-.sp .6
-.RS 4n
-依赖性的类型。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire\fR\fR
-.ad
-.sp .6
-.RS 4n
-该依赖性是必需的,必须具有等于或高于 \fBfmri\fR 属性中所指定版本的版本。如果未指定版本,则任何版本都满足依赖性。如果不能满足其任一必需依赖性,则无法安装软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBoptional\fR\fR
-.ad
-.sp .6
-.RS 4n
-该依赖性(如果存在)必须处于指定的版本级别或更高级别。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexclude\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果该依赖性存在于指定的版本级别或更高级别,则无法安装包含软件包。如果未指定版本,则依赖软件包无法与指定依赖性的软件包同时安装。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBincorporate\fR\fR
-.ad
-.sp .6
-.RS 4n
-该依赖性是可选项,但是依赖软件包的版本会受到约束。请参见下文的“约束和冻结”。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrequire-any\fR\fR
-.ad
-.sp .6
-.RS 4n
-多个 \fBfmri\fR 属性指定的多个依赖软件包中的任一个都可满足依赖性(遵循与 \fBrequire\fR 依赖性类型相同的规则)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBconditional\fR\fR
-.ad
-.sp .6
-.RS 4n
-该依赖性仅在系统上存在 \fBpredicate\fR 属性定义的软件包时才是必需的。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBorigin\fR\fR
-.ad
-.sp .6
-.RS 4n
-在安装此软件包之前,相关项目标(如果存在)在要修改的映像上必须具有指定值或更大值。如果 \fBroot-image\fR 属性的值为 \fBtrue\fR,则目标必须存在于根目录为 / 的映像上,才能安装此软件包。如果 \fBroot-image\fR 属性的值为 \fBtrue\fR,并且 \fBfmri\fR 属性的值以 \fBpkg:/feature/firmware/\fR 开头,则将剩余的 \fBfmri\fR 值视为 \fB/usr/lib/fwenum\fR 中计算固件依赖项的命令。有关示例,请参见《\fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR》。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR\fR
-.ad
-.sp .6
-.RS 4n
-除非软件包出现在映像避免列表上,否则该依赖性是必需的。请注意,过时软件包会无提示地满足组依赖性。请参见 \fBpkg\fR(1) 中的 \fBavoid\fR 子命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBparent\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果映像不是子映像,会忽略该依赖性。如果映像是子映像,则依赖性必须存在于父映像中。符合 \fBparent\fR 依赖性的软件包版本与用于 \fBincorporate\fR 依赖性的软件包版本相同。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpredicate\fR\fR
-.ad
-.sp .6
-.RS 4n
-表示 \fBconditional\fR 依赖性的谓词的 FMRI。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBroot-image\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅对 \fBorigin\fR 依赖性有影响,如上所述。
-.RE
-
-.SS "许可证操作"
-.sp
-.LP
-\fBlicense\fR 操作表示许可证或其他与软件包内容相关联的信息文件。软件包可以通过 \fBlicense\fR 操作将许可证、免责声明或其他指南提供给软件包安装程序。
-.sp
-.LP
-\fBlicense\fR 操作的有效负荷将提供到与软件包相关的映像元数据目录中,且应仅包含用户可读的文本数据。不应包含 HTML 或任何其他形式的标记。通过各属性,\fBlicense\fR 操作可以向客户端指示必须显示相关的有效负荷并/或要求接受它。显示并/或接受的方法由客户端决定。
-.sp
-.LP
-可以识别下列属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlicense\fR\fR
-.ad
-.sp .6
-.RS 4n
-此属性是 \fBlicense\fR 操作的关键属性。此属性为许可证提供有意义的描述,以帮助用户在无需阅读许可证文本本身的情况下确定内容。其中一些示例值包括:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ABC Co. Copyright Notice
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-ABC Co. Custom License
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Common Development and Distribution License 1.0 (CDDL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-GNU General Public License 2.0 (GPL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-GNU General Public License 2.0 (GPL) Only
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-MIT License
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Mozilla Public License 1.1 (MPL)
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-Simplified BSD License
-.RE
-\fBlicense\fR 值在软件包内必须唯一。建议在说明中包括许可证的版本,如上面的几个示例所示。如果软件包有对应多种不同许可证的代码,请使用多个 \fBlicense\fR 操作。许可证属性值的长度不得超过 64 个字符。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmust-accept\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果为 \fBtrue\fR,则用户必须先接受此许可证,才能安装或更新相关软件包。省略此属性等效于 \fBfalse\fR。接受的方法(例如,交互式或基于配置)由客户端决定。对于软件包更新,如果未更改许可证操作或有效负荷,将忽略此属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmust-display\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果为 \fBtrue\fR,则在执行打包操作期间客户端必须显示操作的有效负荷。省略此值等效于 \fBfalse\fR。此属性不应该用于版权声明。此属性应该仅用于许可证或执行操作期间必须显示的其他材料。显示的方法由客户端决定。对于软件包更新,如果未更改许可证操作或有效负荷,将忽略此属性。
-.RE
-
-.SS "传统操作"
-.sp
-.LP
-\fBlegacy\fR 操作表示由传统包管理系统使用的软件包数据。与此操作相关联的属性将添加到传统系统的数据库中,以便查询这些数据库的工具可以像实际安装了传统软件包一样工作。需特别指出的是,这应足以使传统系统确信系统上已安装了 \fBpkg\fR 属性指定的软件包,如此便可使用软件包来满足依赖性。
-.sp
-.LP
-可识别根据 \fBpkginfo\fR(4) 上的参数指定的下列属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBcategory\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBCATEGORY\fR 参数的值。缺省值为 \fBsystem\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdesc\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBDESC\fR 参数的值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhotline\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBHOTLINE\fR 参数的值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBNAME\fR 参数的值。缺省值为 \fBnone provided\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-要安装的软件包的缩写。缺省值为软件包的 FMRI 中的名称。此属性是 \fBlegacy\fR 操作的关键属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBvendor\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fBVENDOR\fR 参数的值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBversion\fR\fR
-.ad
-.sp .6
-.RS 4n
-VERSION 参数的值。缺省值为软件包的 FMRI 中的版本。
-.RE
-
-.SS "设置操作"
-.sp
-.LP
-\fBset\fR 操作表示软件包级别的属性或元数据,例如软件包描述。
-.sp
-.LP
-可以识别下列属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBname\fR\fR
-.ad
-.RS 9n
-.rt  
-属性的名称。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBvalue\fR\fR
-.ad
-.RS 9n
-.rt  
-提供给属性的值。
-.RE
-
-.sp
-.LP
-\fBset\fR 操作可以提供软件包作者选择的任何元数据。但是,存在大量定义明确的对包管理系统具有特定意义的属性名称。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBinfo.classification\fR\fR
-.ad
-.sp .6
-.RS 4n
-一个 \fBpkg\fR(5) 客户端可以使用一个或多个标记对软件包进行分类。该值应具有一个机制(例如 "org.opensolaris.category.2008" 或 "org.acm.class.1998")和实际分类(例如 "Applications/Games"),由冒号 (:) 分隔。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.description\fR\fR
-.ad
-.sp .6
-.RS 4n
-软件包的内容和功能的详细描述,长度通常约为一个段落。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-包含方软件包的名称和版本。请参见“描述”部分中的“软件包 FMRI 和版本”。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.human-version\fR\fR
-.ad
-.sp .6
-.RS 4n
-IPS 使用的版本方案很严格。请参见“描述”部分中的“软件包 FMRI 和版本”。较灵活的版本可以 \fBpkg.human-version\fR 属性值提供。IPS 工具显示该值,例如 \fBpkg info\fR、\fBpkg contents\fR 和 \fBpkg search\fR。\fBpkg.human-version\fR 值不用作版本比较的基准,并且不能用来替代 \fBpkg.fmri\fR 版本。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.obsolete\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果为 \fBtrue\fR,则将软件包标记为过时。过时的软件包除了设置操作外不能具有任何其他操作,且不得标记为已重命名。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.renamed\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果为 \fBtrue\fR,则软件包已被重命名。软件包中还必须存在一个或多个 \fBdepend\fR 操作,且指向此软件包已重命名到的软件包版本。软件包不能同时标记为已重命名和过时,但在其他情况下可以具有任意多个设置操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg.summary\fR\fR
-.ad
-.sp .6
-.RS 4n
-软件包的一行简短描述。
-.RE
-
-.SS "组操作"
-.sp
-.LP
-\fBgroup\fR 操作定义 UNIX 组,如 \fBgroup\fR(4) 中所定义。不存在对于组口令的支持。使用此操作定义的组最初不具有用户列表。可以使用 \fBuser\fR 操作添加用户。可以识别下列属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroupname\fR\fR
-.ad
-.sp .6
-.RS 4n
-组名的值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgid\fR\fR
-.ad
-.sp .6
-.RS 4n
-组的唯一数字 ID。缺省值为 100 之下的第一个自由组。
-.RE
-
-.SS "用户操作"
-.sp
-.LP
-\fBuser\fR 操作定义 UNIX 用户,如 \fB/etc/passwd\fR、\fB/etc/shadow\fR、\fB/etc/group\fR 和 \fB/etc/ftpd/ftpusers\fR 文件中所定义。将为使用此 \fBuser\fR 操作定义的用户向相应文件添加条目。
-.sp
-.LP
-\fBuser\fR 操作用于为要使用的守护进程或其他软件定义用户。不使用 \fBuser\fR 操作定义管理帐户或交互式帐户。
-.sp
-.LP
-可以识别下列属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBusername\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户的唯一名称
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpassword\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户的加密口令。缺省值为 \fB*LK*\fR。请参见 \fBshadow\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuid\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户的唯一 UID。缺省值为 100 之下的第一个自由值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户的主组名称。必须可在 \fB/etc/group\fR 中找到。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgcos-field\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB/etc/passwd\fR 中 \fBgcos\fR 字段的值。缺省值为 \fBusername\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBhome-dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户的起始目录。此目录必须位于系统映像目录中,不在 \fB/home\fR 等其他挂载点下。缺省值为 \fB/\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlogin-shell\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户的缺省 shell。缺省值为空。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBgroup-list\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户所属的辅助组。请参见 \fBgroup\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBftpuser\fR\fR
-.ad
-.sp .6
-.RS 4n
-可设置为 \fBtrue\fR 或 \fBfalse\fR。缺省值 \fBtrue\fR 指示允许用户通过 FTP 登录。请参见 \fBftpusers\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlastchg\fR\fR
-.ad
-.sp .6
-.RS 4n
-1970 年 1 月 1 日至上次修改口令的日期之间的天数。缺省值为空。请参见 \fBshadow\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmin\fR\fR
-.ad
-.sp .6
-.RS 4n
-所需的相邻两次更改口令之间的最小天数。必须将此字段设置为 0 或更大值才能启用口令有效期。缺省值为空。请参见 \fBshadow\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBmax\fR\fR
-.ad
-.sp .6
-.RS 4n
-口令的最大有效天数。缺省值为空。请参见 \fBshadow\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBwarn\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户在口令到期之前多少天收到警告。请参见 \fBshadow\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBinactive\fR\fR
-.ad
-.sp .6
-.RS 4n
-允许该用户不活动的天数。按每台计算机对此进行计数。可从计算机的 \fBlastlog\fR 文件获取有关上次登录的信息。请参见 \fBshadow\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexpire\fR\fR
-.ad
-.sp .6
-.RS 4n
-表示为自 UNIX 纪元(1970 年 1 月 1 日)后的天数的绝对日期。达到此数字时,将无法再进行登录。例如,到期值为 13514 指定登录将在 2007 年 1 月 1 日失效。请参见 \fBshadow\fR(4)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBflag\fR\fR
-.ad
-.sp .6
-.RS 4n
-设置为空。请参见 \fBshadow\fR(4)。
-.RE
-
-.SH 执行器
-.sp
-.LP
-在某些上下文中,附加操作可能适合在为特定操作做准备时执行或者在引入特定操作后执行。这些附加操作特定于操作系统,通常仅在实时系统映像上才需要。实时映像是在当前区域的活动的、正在运行的引导环境的 \fB/\fR 处挂载的映像。当软件包安装或删除过程中涉及的多个操作具有相同的执行器时,会为该安装或删除过程执行一次与执行器存在情况相对应的操作。
-.sp
-.LP
-错误指定的执行器可能会导致软件包安装失败,如果该执行器无法确定进行安全安装的方法。
-.sp
-.LP
-系统定义了以下执行器:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBreboot-needed\fR\fR
-.ad
-.sp .6
-.RS 4n
-可设置为 \fBtrue\fR 或 \fBfalse\fR。此执行器声明:如果软件包系统在实时映像上操作,则必须在新引导环境中更新或删除标记的操作。\fBbe-policy\fR 映像属性控制新引导环境的创建。有关 \fBbe-policy\fR 属性的更多信息,请参见 \fBpkg\fR(1) 手册页的“映像属性”部分。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdisable_fmri\fR、\fBrefresh_fmri\fR、\fBrestart_fmri\fR、\fBsuspend_fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-其中每个执行器在软件包安装或删除过程中均使用服务实例的 FMRI 值进行操作。根据 \fBsvcadm\fR(1M) 的 \fBdisable\fR 子命令,\fBdisable_fmri\fR 会导致给定的 FMRI 在删除操作之前被禁用。根据 \fBsvcadm\fR(1M) 的各个子命令,\fBrefresh_fmri\fR 和 \fBrestart_fmri\fR 会导致给定的 FMRI 在安装、更新或删除操作后被刷新或重新启动。最后,\fBsuspend_fmri\fR 会导致给定的 FMRI 在安装操作阶段之前被临时禁用,并在该阶段完成后被重新启用。
-.sp
-该值可以包含与多个服务实例匹配的模式。但是,它必须使用 \fBsvcs\fR(1) 所接受的 glob 显式执行此操作,而不是通过不指示任何实例来隐式执行此操作。
-.RE
-
-.SH 中介
-.sp
-.LP
-中介是代表一组相关符号链接或硬链接的名称。如果两个或更多个链接操作拥有相同的路径和中介名称,则用户或软件包系统会根据版本、实现或优先级选择链接目标。有关中介属性的信息,请参见“链接操作”。
-.sp
-.LP
-以下示例显示名为 \fBjava\fR 的中介的两个不同实例(其中,链接选择的区别为版本)。这两个 \fBlink\fR 操作会显示在两个不同软件包中。
-.sp
-.in +2
-.nf
-link mediator=java mediator-version=1.6 path=usr/java target=jdk/jdk1.6.0_31
-link mediator=java mediator-version=1.7 path=usr/java target=jdk/jdk1.7.0_02
-.fi
-.in -2
-
-.sp
-.LP
-有关如何为此链接路径选择所需版本的信息,请参见 \fBpkg\fR(1) 手册页中的 \fBset-mediator\fR 子命令。要选择版本,必须安装两个软件包。
-.SH 约束和冻结
-.sp
-.LP
-在将软件包转换为新版本、添加到系统中或从系统中删除时,所选的版本或是否允许删除由对软件包施加的各种约束确定。这些约束可由其他软件包以依赖性的形式进行定义,或者由管理员以冻结的形式进行定义。
-.sp
-.LP
-最常见的约束形式由 \fBrequire\fR 依赖性提供,如上面的“依赖操作”中所述。此类约束可防止软件包被降级或删除。
-.sp
-.LP
-操作系统的大多数部分由名为 \fB incorporation\fR 的软件包进行封装。这些软件包主要提供由 \fBincorporate\fR 依赖性表示的约束。
-.sp
-.LP
-如上所述,合并的软件包不需要存在于系统上,但如果存在,它将同时指定一个非独占最低版本和一个独占最高版本。例如,如果依赖性的 FMRI 具有版本 1.4.3,则低于 1.4.3 的版本不能满足依赖性,且任何高于或等于 1.4.4 的版本也不能满足依赖性。但是,可以允许仅仅扩展了点分序列的版本,如 1.4.3.7。
-.sp
-.LP
-Incorporation 用于强制系统的各部分进行同步升级。对于某些组件(例如 C 库和内核),这是一项基本要求。对于其他组件(例如,不具有任何其他依赖性的简单用户级组件),同步升级仅仅用来提供一组经过测试的已知软件包版本,这些软件包版本可由 incorporation 的特定版本进行引用。
-.sp
-.LP
-因为 incorporation 只是一个软件包,所以可将其删除,它提供的所有约束也将随之解除。但是,Oracle Solaris 提供的许多 incorporation 是其合并的软件包所必需的,因为解除其约束可能会不安全。
-.sp
-.LP
-尝试将软件包升级到已安装的 incorporation 所不允许的版本,将不会尝试查找更高的 incorporation 版本来满足该请求,反而会失败。如果必须移动约束本身,而又无法删除指定它的 incorporation,则必须将 incorporation 升级到指定所需约束版本的版本。升级 incorporation 会导致不能满足新版本提供的约束的所有合并软件包也进行升级。
-.sp
-.LP
-系统管理员可以使用 \fBpkg freeze\fR 命令约束软件包。在未提供版本的情况下,将指定软件包约束为系统上已安装的版本。如果提供了版本化软件包,则此管理约束或冻结会像已安装了合并依赖性(其中 \fBfmri\fR 属性具有所提供的软件包版本值)一样进行操作。
-.sp
-.LP
-包管理系统永远不会自动解除冻结。要解除约束,请使用 \fBpkg unfreeze\fR 命令。
-.SH 发布者和系统信息库
-.sp
-.LP
-如上所述,发布者只是软件包客户端用来标识软件包提供者的一个名称。发布者可使用软件包系统信息库和/或软件包归档来发行其软件包。软件包系统当前支持以下两种类型的系统信息库:源系统信息库和镜像系统信息库。
-.sp
-.LP
-\fB源\fR是包含一个或多个软件包的所有元数据(例如,目录、清单和搜索索引)和内容(文件)的软件包系统信息库。如果在一个映像中为给定发布者配置了多个源,则软件包客户端 API 会尝试选择从其检索软件包数据的最佳源。这是最常见的系统信息库类型,当每次在软件包系统信息库上使用 \fBpkgsend\fR 或 \fBpkgrecv\fR 时进行隐式创建。
-.sp
-.LP
-\fBmirror\fR 是仅包含软件包内容(文件)的软件包系统信息库。如果在一个映像中为给定发布者配置了一个或多个镜像,则客户端 API 会优先使用镜像进行软件包内容检索并尝试选择从其检索软件包内容的最佳镜像。如果镜像不可访问、不具有所需内容或者运行缓慢,客户端 API 将从任何已配置的源系统信息库检索内容。镜像设计用于通过 \fBpkg.depotd\fR(1M) 的动态镜像功能在一组可信客户端之间共享内容。镜像还设计用于验证对软件包元数据的访问,但发行软件包内容不需要进行验证。例如,客户端可能配置有需要具有 SSL 密钥和证书对才能访问的 \fBhttps\fR 源,以及提供软件包内容的 \fBhttp\fR 镜像。这样,只有经过授权的客户端才可以安装或更新软件包,同时避免了验证软件包内容检索的开销。通过删除系统信息库中除名为 \fBfile\fR 的子目录及其父目录之外的所有子目录可创建镜像。通过使用 \fBpkg.depotd\fR(1M) 的镜像模式还可将源系统信息库置备为镜像。
-.SH 全局和非全局区域更新
-.sp
-.LP
-\fBpkg\fR 系统会强制使非全局区域与全局区域保持同步。这表示某些软件包在全局区域和所有非全局区域中必须处于同一版本,以确保运行相同的内核。为此,\fBpkg\fR 会使用 \fBparent\fR 依赖性对非全局区域施加某些约束。有关 \fBparent\fR 依赖性的更多信息,请参见“依赖操作”。
-.sp
-.LP
-由于全局区域对非全局区域施加的限制,非全局区域必须可以访问全局区域的软件包且必须具有相似的发布者配置。使用\fB系统信息库\fR可实现上述两个目标(请参见 \fBpkg.sysrepo\fR(1M) 手册页)。系统信息库可提供全局区域中配置的发布者的访问权,以及有关如何配置这些发布者的信息。要阻止非全局区域在安装或更新期间选择不同软件包,在发布者搜索顺序中系统发布者的排列顺序需要高于非全局区域中配置的发布者的顺序。有关发布者搜索顺序的信息,请参见 \fBpkg\fR(1) 手册页中的 \fBpkg set-publisher\fR 命令。
-.sp
-.LP
-要更新系统上的所有非全局区域,请使用不带全局区域中参数的 \fBpkg update\fR 命令。此命令会在全局区域上执行并以递归方式在每个非全局区域上执行。将对非全局区域仅进行最少的必要更改,以使其与全局区域中所进行的更改同步。例如,假设全局区域和非全局区域中都安装了版本 1 的软件包 \fBfoo\fR,并假设系统信息库中存在版本 2。如果 \fBfoo\fR 具有父项依赖性,则 \fBpkg update foo\fR 会在全局区域和非全局区域中将 \fBfoo\fR 更新至版本 2,这是因为 \fBparent\fR 依赖性会强制使软件包保持同步。如果 \fBfoo\fR 不具有父项依赖性,则 \fBfoo\fR 在全局区域中会更新至版本 2,但在非全局区域中仍为版本 1。
-.SH 侧面和变量
-.sp
-.LP
-软件可以具有可选组件和互斥组件。可选组件的示例包括语言环境和文档。互斥组件的示例包括 SPARC 或 x86 和调试或非调试二进制文件。
-.sp
-.LP
-在 IPS 中,可选组件称为\fB侧面\fR,互斥组件称为\fB变量\fR。侧面和变量指定为软件包操作中的标记。每个侧面和变量标记都有一个名称和值。单个操作可以具有多个侧面和变量标记。具有多个侧面和变量标记的组件有多种,例如供开发者使用的特定于体系结构的头文件,或仅用于 SPARC 全局区域的组件。
-.sp
-.LP
-以下是变量标记的一个示例 \fBvariant.arch=sparc\fR。以下是侧面标记的一个示例 \fBvariant.arch=sparc\fR。引用侧面和变量时,通常不带前导字符串 \fBfacet.\fR 和 \fBvariant.\fR。
-.sp
-.LP
-侧面和变量是映像的特殊属性,无法在单个软件包上设置。要查看映像上设置的侧面和变量的当前值,请按 \fBpkg\fR(1) 手册页中所示,使用 \fBpkg facet\fR 和 \fBpkg variant\fR 命令。要修改映像上设置的侧面和变量的值,请使用 \fBpkg change-facet\fR 和 \fBpkg change-variant\fR 命令。
-.sp
-.LP
-软件包客户机将侧面处理为布尔值:侧面在映像中仅能设置为 \fBtrue\fR(启用)或 \fBfalse\fR(禁用)。缺省情况下,映像中的所有侧面都被视为 \fBtrue\fR。
-.sp
-.LP
-可以使用 \fBpkg change-facet\fR 命令在映像内本地设置侧面,也可从父映像继承侧面。例如,非全局区域可从全局区域继承侧面。继承的侧面会在本地设置的侧面之前计算结果,并且优先于本地设置的侧面。如果同一个侧面既是继承的,又是本地设置的,则继承的侧面值会屏蔽本地设置的值。屏蔽的侧面不会影响侧面计算结果和软件包操作。使用 \fBpkg change-facet\fR 命令所做的侧面更改仅影响本地设置的侧面。只能通过更改父映像来更改继承的侧面。缺省情况下,\fBpkg facet\fR 命令不显示屏蔽的侧面。
-.sp
-.LP
-操作的侧面标记值可以设置为 \fBall\fR 或 \fB true\fR,以控制客户机如何过滤有侧面标记的操作。除 \fBall\fR 或 \fBtrue\fR 之外的所有值都具有未定义的行为。有关要安装具有侧面标记的操作而必须在镜像中存在的条件的描述,请参见下文。
-.sp
-.LP
-需要多个级别的过滤时,侧面的 \fBall\fR 值非常有用。在以下示例中,仅当 \fBdoc\fR 侧面和至少一个 \fBlocale\fR 侧面在映像中为 \fBtrue\fR 时,才安装 \fBfoo.txt \fR。这样允许管理员排除文档,但是仍启用或禁用特定语言环境支持。此外,仅当 \fBdoc\fR 和 \fBdevel\fR 侧面在映像中都为 \fBtrue\fR 时,才安装 \fBapi.txt\fR。
-.sp
-.in +2
-.nf
-file path=usr/share/doc/foo/foo.txt facet.doc=all facet.locale.en_GB=true facet.locale.en_US=true
-file path=usr/share/doc/foo/api.txt facet.doc=all facet.devel=all
-.fi
-.in -2
-
-.sp
-.LP
-映像上设置的侧面可以为完整侧面(如 \fBdoc.man\fR)或模式(如 \fBlocale.*\fR)。要禁用侧面名称空间的一部分,仅启用其中的几个侧面时,此方式很有用。例如,您可以禁用所有语言环境,然后仅启用一个或两个特定语言环境,如以下示例所示:
-.sp
-.in +2
-.nf
-# \fBpkg change-facet locale.*=false\fR
+<refentry lang="zh" id="pkg-5">
+<refmeta><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum> <refmiscinfo class="date">2015 年 3 月 10日</refmiscinfo> <refmiscinfo class="sectdesc">&man5;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2009, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg</refname><refpurpose>映像包管理系统</refpurpose>
+</refnamediv>
+<refsect1 id="GLHDA" role="description"><title></title>
+<para>映像包管理系统 <literal>pkg</literal>(5) 是用于提供软件生命周期管理(安装、升级和删除)的框架。映像包管理以软件包为单位对软件进行管理,软件包是由一组关键字/值对以及可能的数据有效负荷定义的操作的集合。在许多情况下,操作是在文件系统中找到的文件,但它们也表示其他可安装对象,例如驱动程序、服务和用户。</para>
+</refsect1>
+<refsect1 role="other"><title>软件包 FMRI 和版本</title>
+<para>每个软件包均由带有机制 <literal>pkg:</literal> 的故障管理资源标识符 (fault management resource identifier, FMRI) 表示。软件包的完整 FMRI 由机制、发布者、软件包名称和以下格式的版本字符串组成:</para>
+<screen>pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
+</screen>
+<para><literal>solaris</literal> 是发布者。<literal>system/library/c++-runtime</literal> 是软件包名称。虽然名称空间是有层次的且可具有任意深度,但不存在强制包含;名称从本质上而言是任意的。发布者信息为可选项,但必须位于 <literal>pkg://</literal> 之后(如果存在)。包含发布者的 FMRI 通常被称为“全限定”。如果不存在发布者信息,那么软件包名称之前通常应带有 <literal>pkg:/</literal>。</para>
+<para>如果 FMRI 不包含发布者信息,打包客户端通常允许省略 FMRI 的机制。例如,<literal>pkg:/system/library/c++-runtime</literal> 可以写为 <literal>system/library/c++-runtime</literal>。如果省略了机制,客户端也允许省略除软件包名称的最后一个组成部分(用于匹配目的)之外的所有其他内容。例如,<literal>system/library/c++-runtime</literal> 可以写为 <literal>library/c++-runtime</literal> 或 <literal>c++-runtime</literal>,这将与名为 <literal>c++-runtime</literal> 的软件包或以 <literal>/c++-runtime</literal> 结尾的软件包名称匹配。</para>
+<para>发布者名称将个人、个人组或组织标识为一个或多个软件包的源。为避免发布者名称冲突并有帮于标识发布者,最佳做法是使用代表发布软件包实体的域名作为发布者名称。</para>
+<para>版本跟在软件包名称后面,由 @ 符号分隔。版本包含四个数字序列,由标点符号分隔。前三个序列中的元素由圆点分隔,各序列可具有任意长度。不允许版本的组成部分以零开头(例如 01.1 或 1.01)。允许以零结尾(例如 1.10)。</para>
+<para>版本的第一个部分是组件版本。对于紧密绑定到操作系统上的组件,此序列通常是操作系统中该版本的 <command>uname -r</command> 值。对于具有自己的开发生命周期的组件,此序列是一个由小圆点分隔的发行编号,例如 2.4.10。</para>
+<para>版本的第二个部分(如果存在)必须跟在逗号 (,) 后面,是内部版本。内部版本指定构建软件包内容的操作系统版本,提供了希望软件包内容可成功运行的最低操作系统版本。</para>
+<para>版本的第三个部分(如果存在)必须跟在连字符 (<literal>-</literal>) 后面,是分支版本。分支版本是用于提供特定于供应商的信息的版本控制组件。分支版本可在打包元数据发生更改时增大,独立于组件版本。分支版本可能包含内部版本号或其他信息。</para>
+<para>版本的第四个部分(如果存在)必须跟在冒号 (:) 后面,是一个时间戳。时间戳表示软件包的发布时间。</para>
+<para>在版本之间进行比较时,不考虑完整版本的任何组件,除非左侧的组件与其相同。因此,<literal>4.3-1</literal> 大于 <literal>4.2-7</literal>,因为 <literal>4.3</literal> 大于 <literal>4.2</literal>;<literal>4.3-3</literal> 大于 <literal>4.3-1</literal>,因为 <literal>3</literal> 大于 <literal>1</literal>。</para>
+<para><literal>pkg.human-version</literal> 属性可以用于提供人工可读的版本字符串。对于软件包 FMRI,除了上文描述的软件包版本外,还可以提供 <literal>pkg.human-version</literal> 属性值,但该值不能替代软件包 FMRI 版本。人工可读的版本字符串仅用于显示目的。请参见“设置操作”了解更多信息。</para>
+<para>系统的许多部分(如果适用)会在显示 FMRI 时缩短 FMRI 并接受简短格式的输入,以减少显示的或所需的信息量。通常,可以省略机制、发布者、内部版本和时间戳。有时可以省略所有版本控制信息。</para>
+</refsect1>
+<refsect1 role="other"><title>操作</title>
+<para>操作表示系统上的可安装对象。在软件包的清单中对操作进行了描述。每个操作主要由其名称和一个关键属性组成。这些属性共同引用一个唯一的对象,与该对象一样遵循版本历史记录。操作可以具有其他属性。某些属性由包管理系统直接解释。其他属性可能仅对系统管理员或最终用户有用。</para>
+<para>操作具有一种简单文本表示法:</para>
+<programlisting><replaceable>action_name</replaceable> <replaceable>attribute1</replaceable>=<replaceable>
+value1</replaceable> <replaceable>attribute2</replaceable>=<replaceable>value2</replaceable> ...
+</programlisting>
+<para>属性名称中不能包含空格、引号或等号 (=)。第一个等号后的所有字符都属于值。值中可以包含所有这些符号,虽然空格必须括在单引号或双引号中。单引号处于括在双引号中的字符串内时不需要进行转义,双引号处于括在单引号中的字符串内时也不需要进行转义。可使用反斜杠 (\) 字符作为引号的前缀来避免终止带引号的字符串。反斜杠可使用反斜杠进行转义。</para>
+<para>操作可以具有多个属性。可以针对单个操作使用不同的值来多次命名某些属性。具有相同名称的多个属性将被视为无序列表。</para>
+<para>具有多个属性的操作可以在清单文件中创建长行。可以通过使用反斜杠终止每个不完整的行来对此类行进行折行。请注意,属性/值对之间必须具有此接续字符。属性、属性值及其组合均不可分离。</para>
+<para>下面列出的属性不是全部属性。事实上,任意属性都可附加到操作中,标准属性组易于扩大以合并将来的开发。</para>
+<para>某些属性会导致在打包上下文外部执行其他操作。这些属性记录在下面的“执行器”部分中。</para>
+<refsect2><title>文件操作</title>
+<para><literal>file</literal> 操作表示普通文件。<literal>file</literal> 操作引用有效负荷,具有四个标准属性:</para>
+<variablelist>
+<varlistentry><term><literal>path</literal></term>
+<listitem><para>安装文件的文件系统路径。此属性是 <literal>file</literal> 操作的关键属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mode</literal></term>
+<listitem><para>文件的访问权限(采用数字格式)。这些只是简单权限,并非 ACL。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>owner</literal></term>
+<listitem><para>拥有文件的用户的名称。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal></term>
+<listitem><para>拥有文件的组的名称。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>有效负荷是一个位置属性,因为它未命名。它是操作名称后面的第一个词。在发布的清单中,它是文件内容的 <literal>SHA-1</literal> 散列。如果存在于尚待发布的清单中,则它表示可以找到有效负荷的路径。请参见 <command>pkgsend</command>(1)。如果值包括一个等号,则可以使用散列属性代替位置属性。这两种属性可用于同一操作中。但是,散列必须完全相同。</para>
+<para><literal>preserve</literal> 和 <literal>overlay</literal> 属性影响是否以及如何安装 <literal>file</literal> 操作。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>preserve</literal></term>
+<listitem><para>指定在软件包操作过程中何时以及如何保留文件。</para>
+<para>初始安装软件包时,如果软件包提供的文件使用任何值定义了 <literal>preserve</literal> 属性并且该文件已经存在于映像中,则现有文件将存储在 <filename>/var/pkg/lost+found </filename> 中并且安装打包的文件。</para>
+<para>初始安装软件包时,如果软件包提供的文件定义了 <literal>preserve</literal> 属性,但该文件尚未存在于映像中,则是否安装该文件取决于 <literal>preserve</literal> 属性的值:</para>
+<itemizedlist>
+<listitem><para>如果 <literal>preserve</literal> 的值是 <literal>legacy</literal>,则不安装打包的文件。</para></listitem>
+<listitem><para>如果 <literal>preserve</literal> 的值不是 <literal>legacy</literal>,则安装打包的文件。</para></listitem>
+</itemizedlist>
+<para>软件包降级时,如果软件包的降级版本提供的文件使用任何值定义了 <literal>preserve</literal> 属性并且以下所有条件都为 true,将使用扩展名 <filename>.update</filename> 重命名映像中当前存在的文件并安装降级软件包中的文件。</para>
+<itemizedlist>
+<listitem><para>文件存在于映像中。</para></listitem>
+<listitem><para>软件包的降级版本提供的文件的内容不同于软件包的当前安装版本提供的文件的内容。</para></listitem>
+<listitem><para>软件包的降级版本提供的文件的内容不同于映像中存在的文件的内容。</para></listitem>
+</itemizedlist>
+<para>如果以上任一条件不为 true,处理文件的方式与升级(而不是降级)软件包时相同。</para>
+<para>升级软件包时,如果软件包的升级版本提供的 <literal>file</literal> 操作使用任何值定义了 <literal>preserve</literal> 属性并且 <literal>file</literal> 操作与软件包的当前安装版本提供的 <literal>file</literal> 操作相同,则不安装文件并且不修改映像中存在的文件。将保留自安装先前版本以来进行的所有修改。</para>
+<para>升级软件包时,如果软件包的升级版本提供的 <literal>file</literal> 操作定义了 <literal>preserve</literal> 属性并且 <literal>file</literal> 操作是新的或者不同于软件包的当前安装版本提供的 <literal>file</literal> 操作,则以下面的方式执行升级:</para>
+<itemizedlist>
+<listitem><para>如果文件不存在于映像中,将安装新文件。
+</para></listitem>
+<listitem><para>如果软件包的升级版本提供的文件存在于映像中,不存在于软件包的当前安装版本中并且未使用 <literal>original_name</literal> 属性进行重命名或移动(请参见下文),则现有文件将存储在 <filename>/var/pkg/lost+found</filename> 中并且安装软件包的升级版本提供的文件。</para>
+</listitem>
+<listitem><para>如果软件包的升级版本提供的文件存在于映像中并且其内容不同于软件包的当前安装版本提供的文件,则根据 <literal>preserve</literal> 属性的值进行升级:</para>
+<itemizedlist>
+<listitem><para>如果软件包的升级版本提供的文件具有的 <literal>preserve</literal> 值为 <literal>renameold</literal>,将使用扩展名 <filename>.old</filename> 重命名现有文件并且使用更新的权限和时间戳(如果存在)安装新文件。请参见下文的 <literal>timestamp</literal> 属性说明。</para>
+</listitem>
+<listitem><para>如果软件包的升级版本提供的文件具有的 <literal>preserve</literal> 值为 <literal>renamenew</literal>,将使用扩展名 <filename>.new</filename> 安装新文件并且不修改现有文件。</para></listitem>
+<listitem><para>如果软件包的升级版本提供的文件具有的 <literal>preserve</literal> 值为 <literal>true</literal>,则不安装新文件,但是在现有文件中重置权限和时间戳(如果存在)。</para></listitem>
+</itemizedlist>
+</listitem>
+<listitem><para>如果软件包的升级版本提供的文件存在于映像中,具有的内容与软件包的当前安装版本提供的文件相同并且具有的 <literal>preserve</literal> 值为 <literal>renameold</literal> 或 <literal>renamenew</literal>,则现有文件将替换为软件包的升级版本提供的文件,包括替换权限和时间戳(如果存在)。</para>
+</listitem>
+<listitem><para>如果软件包的升级版本提供的文件存在于映像中,在升级的软件包中具有的 <literal>preserve</literal> 值为 <literal>legacy</literal>,并且在软件包的当前安装版本中具有不同的 <literal>preserve</literal> 值,则使用扩展名 <literal>.legacy</literal> 重命名现有文件,并使用更新的权限和时间戳(如果存在)安装新文件。</para></listitem>
+<listitem><para>如果软件包的升级版本提供的文件存在于映像中并且在升级的软件包和软件包的当前安装版本中具有的 <literal>preserve</literal> 值为 <literal>legacy </literal>,则在现有文件中重置权限和时间戳(如果存在)。</para></listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>overlay</literal></term>
+<listitem><para>指定操作是允许其他软件包在同一位置交付文件,还是用交付的文件覆盖其他文件。此功能设计用于不参与任何自组装(例如 <filename>/etc/motd</filename>)且可安全覆盖的配置文件。</para>
+<para>如果未指定 <literal>overlay</literal>,多个软件包将无法向同一位置提供文件。</para>
+<para><literal>overlay</literal> 属性可以使用以下值之一:</para>
+<variablelist>
+<varlistentry><term><literal>allow</literal></term>
+<listitem><para>允许另一个软件包将文件交付到同一位置。除非也设置了 <literal>preserve</literal> 属性,否则此值没有效果。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>true</literal></term>
+<listitem><para>该操作交付的文件将覆盖已指定了 <literal>allow</literal> 的任何其他操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>基于覆盖文件的 <literal>preserve</literal> 属性值保留对已安装文件所做的更改。在删除时,如果仍要安装将覆盖的操作,则将保留文件的内容,无论是否指定了 <literal>preserve</literal> 属性。只能一个操作覆盖另一个操作,且 <literal>mode</literal>、<literal>owner</literal> 和 <literal>group</literal> 属性必须匹配。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>dehydrate</literal></term>
+<listitem><para>指定软件包发布者的软件包已冻结时或已冻结发布者的软件包已修改时是否应删除此操作。<literal>dehydrate</literal> 属性的值可以为 <literal>true</literal> 或 <literal>false</literal>。如果 <literal>dehydrate</literal> 属性的值为 <literal>false</literal>,则冻结操作过程中将不删除该操作。否则,将删除该操作。标记有 <literal>preserve</literal> 或 <literal>overlay</literal> 属性的文件操作将从冻结操作中隐式排除且不需要此属性。
+</para>
+<programlisting>file path=etc/zones/SYSdefault.xml dehydrate=false ...</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于 ELF 文件,可识别下列属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>elfarch</literal></term>
+<listitem><para>ELF 文件的体系结构。此属性是 <command>uname -p</command> 查询文件所基于的体系结构后的输出。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>elfbits</literal></term>
+<listitem><para>此属性为 <literal>32</literal> 或 <literal>64</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>elfhash</literal></term>
+<listitem><para>此属性是文件中“相关”ELF 部分的散列。这些部分已在装入二进制文件时映射到内存中。在确定两个二进制文件的可执行行为是否将不同时,仅需要考虑这些部分。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于 <literal>file</literal> 操作,可识别下列其他属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>original_name</literal></term>
+<listitem><para>此属性用于处理可编辑文件在软件包之间或在位置之间(或在这两者之间)的移动操作。此属性采用的格式为源软件包的名称后跟一个冒号和文件的原始路径。所删除的任何文件将使用其软件包和路径或 <literal>original_name</literal> 属性的值(如果指定)进行记录。所安装的已设置 <literal>original_name</literal> 属性的任何可编辑文件将使用具有该名称的文件(如果它在同一打包操作中被删除)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>release-note</literal></term>
+<listitem><para>该属性用于指明此文件包含发行说明文本。该属性的值为软件包 FMRI。如果 FMRI 指定的软件包名称存在于原始映像中,指定的版本比原始映像中的软件包版本更高,则此文件将成为发行说明的一部分。特殊 FMRI <literal>feature/pkg/self</literal> 是指包含软件包。如果 <literal>feature/pkg/self</literal> 的版本为 0,则此文件仅在初次安装时是发行说明的一部分。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>revert-tag</literal></term>
+<listitem><para>此属性用于标记应恢复为一个组的可编辑文件。<literal>revert-tag</literal> 属性的值为 <replaceable>tagname</replaceable>。可为单个 <literal>file</literal> 操作指定多个 <literal>revert-tag</literal> 属性。在使用所指定的任意标记调用 <command>pkg revert</command> 时,文件将恢复为其清单定义的状态。有关 <command>pkg revert</command> 命令的更多信息,请参见 <command>pkg</command>(1) 手册页。</para>
+<para>还可以在目录级别指定 <literal>revert-tag</literal> 属性。请参见下文中的“目录操作”。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>sysattr</literal></term>
+<listitem><para>此属性用于指定应该为此文件设置的任何系统属性。<literal>sysattr</literal> 属性的值可以是逗号分隔的详细系统属性列表,也可以是精简系统属性选项的字符串序列,如以下示例中所示。支持的系统属性在 <literal>chmod</literal>(1) 手册页中有介绍。在清单中指定的系统属性是一种额外设置,是对可能已由操作系统的其他子系统设置的系统属性的进一步设置。</para>
+<programlisting>file path=opt/secret_file sysattr=hidden,sensitive
+file path=opt/secret_file sysattr=HT</programlisting>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>timestamp</literal></term>
+<listitem><para>此属性用于设置文件的访问权限和修改时间。必须以 ISO-8601 格式使用 UTC 表示 <literal>timestamp</literal> 属性值,省略冒号和连字符。</para>
+<para>为 Python 打包 <filename> .pyc</filename> 或 <filename>.pyo</filename> 文件时需要 <literal>timestamp</literal> 属性。<filename>.pyc</filename> 或 <filename>.pyo</filename> 文件的相关 <filename> .py</filename> 文件必须使用这些文件内嵌入的时间戳进行标记,如以下示例中所示:</para>
+<programlisting>file path=usr/lib/python2.7/vendor-packages/pkg/__init__.pyc ...
+file path=usr/lib/python2.7/vendor-packages/pkg/__init__.py &bsol;
+     timestamp=20130311T221521Z ...</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>file</literal> 操作的以下属性由系统自动生成,不能由软件包开发者指定:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>hash</literal></term>
+<listitem><para>未压缩文件的 SHA-1 散列。</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>chash</literal></term>
+<listitem><para>压缩文件的 SHA-1 散列。</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.size</literal></term>
+<listitem><para>未压缩文件的大小(字节)。</para></listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.csize</literal></term>
+<listitem><para>压缩文件的大小(字节)。</para></listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>目录操作</title>
+<para><literal>dir</literal> 操作类似于 <command>file</command> 操作,因为它表示文件系统对象。但 <literal>dir</literal> 操作表示目录而不是普通文件。<literal>dir</literal> 操作具有与 <literal>file</literal> 操作相同的 <literal>path</literal>、<literal>mode</literal>、<literal>owner</literal> 和 <literal>group</literal> 属性,其中 <literal>path</literal> 是关键属性。<literal>dir</literal> 操作也接受 <literal>revert-tag</literal> 属性。<literal>revert-tag</literal> 属性的值对 <literal>file</literal> 和 <literal>dir</literal> 操作是不同的。</para>
+<para>目录是 IPS 中包括的引用。当显式或隐式引用某目录的最新软件包不再引用该目录时,将删除该目录。如果该目录包含未打包的文件系统对象,则将这些项移动到 <filename>$IMAGE_META/lost+found</filename> 中。有关 <literal>$IMAGE_META</literal> 的更多信息,请参见“文件”部分。</para>
+<variablelist termlength="wholeline">
+<varlistentry>
+<term><literal>revert-tag</literal></term>
+<listitem>
+<para>此属性用于标识应作为一个集合删除的未打包文件。有关如何为 <literal>file</literal> 操作指定此属性的说明,请参见上文中的“文件操作”。对于目录,<literal>revert-tag</literal> 属性的值为 <replaceable>tagname</replaceable><literal>=</literal><replaceable>pattern</replaceable>。可为单个 <literal>dir</literal> 操作指定多个 <literal>revert-tag</literal> 属性。在使用匹配的 <replaceable>tagname</replaceable> 调用 <command>pkg revert</command> 时,将删除此 <literal>dir</literal> 目录下匹配 <replaceable>pattern</replaceable>(使用 shell glob 字符)的所有未打包文件或目录。有关 <command>pkg revert</command> 命令的更多信息,请参见 <command>pkg</command>(1) 手册页。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>salvage-from</literal></term>
+<listitem><para>此属性可用于将未打包的内容移动到一个新目录中。此属性的值是所挽救项的目录的名称。创建以 <literal>salvage-from</literal> 属性的值命名的目录的任何内容时,具有 <literal>salvage-from</literal> 属性的目录会继承。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>链接操作</title>
+<para><literal>link</literal> 操作表示符号链接。<literal>link</literal> 操作具有以下标准属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>path</literal></term>
+<listitem><para>安装符号链接的文件系统路径。此属性是 <literal>link</literal> 操作的关键属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>target</literal></term>
+<listitem><para>符号链接的目标。链接将解析到的文件系统对象。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator</literal></term>
+<listitem><para>指定由给定中介组(例如 <literal>python</literal>)中涉及的所有路径名称共享的中介名称空间中的条目。可基于 <literal>mediator-version</literal> 和/或 <literal>mediator-implementation</literal> 执行链接中介。给定路径名称的所有中介链接必须指定同一中介。但是,并非所有中介版本和实现都需要在给定路径上提供链接。如果中介不提供链接,则会在选定该中介时删除链接。<literal>mediator</literal> 与特定版本和/或实现组合起来表示可选择供包管理系统使用的中介。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-version</literal></term>
+<listitem><para>指定 <literal>mediator</literal> 属性描述的接口的版本(表示为非负整数的点分序列)。如果指定了 <literal>mediator</literal> 而未指定 <literal>mediator-implementation</literal>,则此属性是必需的。本地系统管理员可以显式设置要使用的版本。指定的值通常应与提供链接的软件包版本相匹配(例如,<literal>runtime/python-27</literal> 应使用 <literal>mediator-version=2.7</literal>),尽管这不是必需的。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-implementation</literal></term>
+<listitem><para>指定除 <literal>mediator-version</literal> 之外还使用中介实现,或使用中介实现代替 mediator-version。不认为实现字符串应进行排序,如果系统管理员未显式指定,则由 <literal>pkg</literal>(5) 任意选择一个字符串。</para>
+<para>该值可以是由字母数字字符和空格组成的任意长度的字符串。如果实现本身可被版本化或已被版本化,则应在字符串的结尾处在 @ 之后指定版本(表示为非负整数的点分序列)。如果存在实现的多个版本,则缺省行为是选择最高版本的实现。</para>
+<para>如果系统上仅安装了特定路径的实现中介链接的一个实例,则会自动选择该实例。如果以后安装了该路径的其他链接,除非应用供应商、站点或本地覆盖或者如果某一链接进行了版本中介,否则不会切换链接。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>mediator-priority</literal></term>
+<listitem><para>在解决中介链接中的冲突时,<literal>pkg</literal>(5) 通常会选择 <literal>mediator-version</literal> 值最大的链接,如果不可能,则会基于 <literal>mediator-implementation</literal> 进行选择。此属性用于为常规冲突解决方案过程指定覆盖。</para>
+<para>如果未指定此属性,则会应用缺省中介选择逻辑。</para>
+<para>如果值为 <literal>vendor</literal>,则与未指定 <literal>mediator-priority</literal> 的链接相比,会优先选择该链接。</para>
+<para>如果值为 <literal>site</literal>,则与值为 <literal>vendor</literal> 或未指定 <literal>mediator-priority</literal> 的链接相比,会优先选择该链接。</para>
+<para>本地系统管理员可以覆盖上面所述的选择逻辑。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>硬链接操作</title>
+<para><literal>hardlink</literal> 操作表示硬链接。它具有与 <literal>link</literal> 操作相同的属性,<literal>path</literal> 也是其关键属性。</para>
+</refsect2>
+<refsect2><title>驱动程序操作</title>
+<para><literal>driver</literal> 操作表示设备驱动程序。<literal>driver</literal> 操作不引用有效负荷。驱动程序文件自身必须作为 <literal>file</literal> 操作进行安装。可识别下列属性(有关更多信息,请参见 <command>add_drv</command>(1M)):</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>name</literal></term>
+<listitem><para>驱动程序的名称。这通常是(但并不总是)二进制驱动程序文件的文件名。此属性是 <literal>driver</literal> 操作的关键属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>alias</literal></term>
+<listitem><para>此属性表示驱动程序的别名。给定的驱动程序可以具有多个 <literal>alias</literal> 属性。无需任何特殊的引号规则。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>class</literal></term>
+<listitem><para>此属性表示驱动程序类。给定的驱动程序可以具有多个 <literal>class</literal> 属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>perms</literal></term>
+<listitem><para>此属性表示驱动程序的设备节点的文件系统权限。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>clone_perms</literal></term>
+<listitem><para>此属性表示此驱动程序的克隆驱动程序次要节点的文件系统权限。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>policy</literal></term>
+<listitem><para>此属性指定设备的其他安全策略。给定的驱动程序可以具有多个 <literal>policy</literal> 属性,但次要设备规范不可以存在于多个属性中。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>privs</literal></term>
+<listitem><para>此属性指定驱动程序所用的特权。给定的驱动程序可以具有多个 <literal>privs</literal> 属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>devlink</literal></term>
+<listitem><para>此属性指定 <filename>/etc/devlink.tab</filename> 中的条目。该值是定义了进入文件的确切行,带有由 <literal>\t</literal> 表示的制表符。有关更多信息,请参见 <literal>devlinks</literal>(1M)。给定的驱动程序可以具有多个 <literal>devlink</literal> 属性。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>依赖操作</title>
+<para><command>depend</command> 操作表示软件包间的依赖性。一个软件包可以依赖于另一个软件包,因为第一个软件包需要第二个软件包中的功能才能运行自身包含的功能或者甚至进行安装。依赖性可以是可选的。如果安装时未满足某个依赖性,包管理系统会尝试安装或更新依赖软件包至足够新的版本(受其他约束限制)。</para>
+<para>可以识别下列属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>fmri</literal></term>
+<listitem><para>表示依赖软件包的 FMRI。此属性是 <literal>dependency</literal> 操作的关键属性。<literal>fmri</literal> 值不得包括发布者。假定软件包名称是完整的。<literal>require-any</literal> 类型的依赖性可具有多个 <literal>fmri</literal> 属性。<literal>fmri</literal> 值中的版本是可选项,虽然对于某些类型的依赖性来说,不带版本的 <literal>fmri</literal> 没有任何意义。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>type</literal></term>
+<listitem><para>依赖性的类型。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>require</literal></term>
+<listitem><para>该依赖性是必需的,必须具有等于或高于 <literal>fmri</literal> 属性中所指定版本的版本。如果未指定版本,则任何版本都满足依赖性。如果不能满足其任一必需依赖性,则无法安装软件包。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>optional</literal></term>
+<listitem><para>该依赖性(如果存在)必须处于指定的版本级别或更高级别。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exclude</literal></term>
+<listitem><para>如果该依赖性存在于指定的版本级别或更高级别,则无法安装包含软件包。如果未指定版本,则依赖软件包无法与指定依赖性的软件包同时安装。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>incorporate</literal></term>
+<listitem><para>该依赖性是可选项,但是依赖软件包的版本会受到约束。请参见下文的“约束和冻结”。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>require-any</literal></term>
+<listitem><para>多个 <literal>fmri</literal> 属性指定的多个依赖软件包中的任一个都可满足依赖性(遵循与 <literal>require</literal> 依赖性类型相同的规则)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>conditional</literal></term>
+<listitem><para>该依赖性仅在系统上存在 <literal>predicate</literal> 属性定义的软件包时才是必需的。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>origin</literal></term>
+<listitem><para>在安装此软件包之前,相关项目标(如果存在)在要修改的映像上必须具有指定值或更大值。如果 <literal>root-image</literal> 属性的值为 <literal>true</literal>,则目标必须存在于根目录为 / 的映像上,才能安装此软件包。如果 <literal>root-image</literal> 属性的值为 <literal>true</literal>,并且 <literal>fmri</literal> 属性的值以 <literal>pkg:/feature/firmware/</literal> 开头,则将剩余的 <literal>fmri</literal> 值视为 <filename>/usr/lib/fwenum</filename> 中计算固件依赖项的命令。有关示例,请参见《<citetitle>在 Oracle Solaris 11.3 中使用映像打包系统打包和交付软件</citetitle>》。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal></term>
+<listitem><para>除非软件包出现在映像避免列表上,否则该依赖性是必需的。请注意,过时软件包会无提示地满足组依赖性。请参见 <command>pkg</command>(1) 中的 <command>avoid</command> 子命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>parent</literal></term>
+<listitem><para>如果映像不是子映像,会忽略该依赖性。如果映像是子映像,则依赖性必须存在于父映像中。符合 <literal>parent</literal> 依赖性的软件包版本与用于 <literal>incorporate</literal> 依赖性的软件包版本相同。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>predicate</literal></term>
+<listitem><para>表示 <literal>conditional</literal> 依赖性的谓词的 FMRI。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>root-image</literal></term>
+<listitem><para>仅对 <literal>origin</literal> 依赖性有影响,如上所述。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>许可证操作</title>
+<para><literal>license</literal> 操作表示许可证或其他与软件包内容相关联的信息文件。软件包可以通过 <literal>license</literal> 操作将许可证、免责声明或其他指南提供给软件包安装程序。</para>
+<para><literal>license</literal> 操作的有效负荷将提供到与软件包相关的映像元数据目录中,且应仅包含用户可读的文本数据。不应包含 HTML 或任何其他形式的标记。通过各属性,<literal>license</literal> 操作可以向客户端指示必须显示相关的有效负荷并/或要求接受它。显示并/或接受的方法由客户端决定。</para>
+<para>可以识别下列属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>license</literal></term>
+<listitem><para>此属性是 <literal>license</literal> 操作的关键属性。此属性为许可证提供有意义的说明,以帮助用户在无需阅读许可证文本本身的情况下确定内容。其中一些示例值包括:</para>
+<itemizedlist>
+<listitem><para>ABC Co. Copyright Notice</para></listitem>
+<listitem><para>ABC Co. Custom License</para></listitem>
+<listitem><para>Common Development and Distribution License 1.0 (CDDL)</para>
+</listitem>
+<listitem><para>GNU General Public License 2.0 (GPL)</para></listitem>
+<listitem><para>GNU General Public License 2.0 (GPL) Only</para></listitem>
+<listitem><para>MIT License</para></listitem>
+<listitem><para>Mozilla Public License 1.1 (MPL)</para></listitem>
+<listitem><para>Simplified BSD License</para></listitem>
+</itemizedlist>
+<para><literal>license</literal> 值在软件包内必须唯一。建议在说明中包括许可证的版本,如上面的几个示例所示。如果软件包有对应多种不同许可证的代码,请使用多个 <literal>license</literal> 操作。许可证属性值的长度不得超过 64 个字符。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>must-accept</literal></term>
+<listitem><para>如果为 <literal>true</literal>,则用户必须先接受此许可证,才能安装或更新相关软件包。省略此属性等效于 <literal>false</literal>。接受的方法(例如,交互式或基于配置)由客户端决定。对于软件包更新,如果未更改许可证操作或有效负荷,将忽略此属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>must-display</literal></term>
+<listitem><para>如果为 <literal>true</literal>,则在执行打包操作期间客户端必须显示操作的有效负荷。省略此值等效于 <literal>false</literal>。此属性不应该用于版权声明。此属性应该仅用于许可证或执行操作期间必须显示的其他材料。显示的方法由客户端决定。对于软件包更新,如果未更改许可证操作或有效负荷,将忽略此属性。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>传统操作</title>
+<para><literal>legacy</literal> 操作表示由传统包管理系统使用的软件包数据。与此操作相关联的属性将添加到传统系统的数据库中,以便查询这些数据库的工具可以像实际安装了传统软件包一样工作。需特别指出的是,这应足以使传统系统确信系统上已安装了 <literal>pkg</literal> 属性指定的软件包,如此便可使用软件包来满足依赖性。</para>
+<para>可识别根据 <literal>pkginfo</literal>(4) 上的参数指定的下列属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>category</literal></term>
+<listitem><para><literal>CATEGORY</literal> 参数的值。缺省值为 <literal>system</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>desc</literal></term>
+<listitem><para><literal>DESC</literal> 参数的值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>hotline</literal></term>
+<listitem><para><literal>HOTLINE</literal> 参数的值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>name</literal></term>
+<listitem><para><literal>NAME</literal> 参数的值。缺省值为 <literal>none provided</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg</literal></term>
+<listitem><para>要安装的软件包的缩写。缺省值为软件包的 FMRI 中的名称。此属性是 <literal>legacy</literal> 操作的关键属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>vendor</literal></term>
+<listitem><para><literal>VENDOR</literal> 参数的值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>version</literal></term>
+<listitem><para>VERSION 参数的值。缺省值为软件包的 FMRI 中的版本。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>设置操作</title>
+<para><literal>set</literal> 操作表示软件包级别的属性或元数据,例如软件包说明。</para>
+<para>可以识别下列属性:</para>
+<variablelist>
+<varlistentry><term><literal>name</literal></term>
+<listitem><para>属性的名称。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>value</literal></term>
+<listitem><para>提供给属性的值。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>set</literal> 操作可以提供软件包作者选择的任何元数据。但是,存在大量定义明确的对包管理系统具有特定意义的属性名称。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>info.classification</literal></term>
+<listitem><para>一个 <literal>pkg</literal>(5) 客户端可以使用一个或多个标记对软件包进行分类。该值应具有一个机制(例如 "org.opensolaris.category.2008" 或 "org.acm.class.1998")和实际分类(例如 "Applications/Games"),由冒号 (:) 分隔。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.description</literal></term>
+<listitem><para>软件包的内容和功能的详细说明,长度通常约为一个段落。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.fmri</literal></term>
+<listitem><para>包含方软件包的名称和版本。请参见“说明”部分中的“软件包 FMRI 和版本”。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.human-version</literal></term>
+<listitem><para>IPS 使用的版本方案很严格。请参见“说明”部分中的“软件包 FMRI 和版本”。较灵活的版本可以 <literal>pkg.human-version</literal> 属性值提供。IPS 工具显示该值,例如 <command>pkg info</command>、<command>pkg contents</command> 和 <command>pkg search</command>。<literal>pkg.human-version</literal> 值不用作版本比较的基准,并且不能用来替代 <literal>pkg.fmri</literal> 版本。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.obsolete</literal></term>
+<listitem><para>如果为 <literal>true</literal>,则将软件包标记为过时。过时的软件包除了设置操作外不能具有任何其他操作,且不得标记为已重命名。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.renamed</literal></term>
+<listitem><para>如果为 <literal>true</literal>,则软件包已被重命名。软件包中还必须存在一个或多个 <literal>depend</literal> 操作,且指向此软件包已重命名到的软件包版本。软件包不能同时标记为已重命名和过时,但在其他情况下可以具有任意多个设置操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg.summary</literal></term>
+<listitem><para>一行简短的软件包说明。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>组操作</title>
+<para><literal>group</literal> 操作定义 UNIX 组,如 <literal>group</literal>(4) 中所定义。不存在对于组口令的支持。使用此操作定义的组最初不具有用户列表。可以使用 <literal>user</literal> 操作添加用户。可以识别下列属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>groupname</literal></term>
+<listitem><para>组名的值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>gid</literal></term>
+<listitem><para>组的唯一数字 ID。缺省值为 100 之下的第一个自由组。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+<refsect2><title>用户操作</title>
+<para><literal>user</literal> 操作定义 UNIX 用户,如 <filename>/etc/passwd</filename>、<filename>/etc/shadow</filename>、<filename>/etc/group</filename> 和 <filename>/etc/ftpd/ftpusers</filename> 文件中所定义。将为使用此 <literal>user</literal> 操作定义的用户向相应文件添加条目。</para>
+<para><literal>user</literal> 操作用于为要使用的守护进程或其他软件定义用户。不使用 <literal>user</literal> 操作定义管理帐户或交互式帐户。</para>
+<para>可以识别下列属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>username</literal></term>
+<listitem><para>用户的唯一名称</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>password</literal></term>
+<listitem><para>用户的加密口令。缺省值为 <literal>*LK*</literal>。请参见 <literal>shadow</literal>(4)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>uid</literal></term>
+<listitem><para>用户的唯一 UID。缺省值为 100 之下的第一个自由值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group</literal></term>
+<listitem><para>用户的主组名称。必须可在 <filename>/etc/group</filename> 中找到。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>gcos-field</literal></term>
+<listitem><para><filename>/etc/passwd</filename> 中 <literal>gcos</literal> 字段的值。缺省值为 <literal>username</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>home-dir</literal></term>
+<listitem><para>用户的起始目录。此目录必须位于系统映像目录中,不在 <filename>/home</filename> 等其他挂载点下。缺省值为 <literal>/</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>login-shell</literal></term>
+<listitem><para>用户的缺省 shell。缺省值为空。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>group-list</literal></term>
+<listitem><para>用户所属的辅助组。请参见 <literal>group</literal>(4)。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>ftpuser</literal></term>
+<listitem><para>可设置为 <literal>true</literal> 或 <literal>false</literal>。缺省值 <literal>true</literal> 指示允许用户通过 FTP 登录。请参见 <literal>ftpusers</literal>(4)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>lastchg</literal></term>
+<listitem><para>1970 年 1 月 1 日至上次修改口令的日期之间的天数。缺省值为空。请参见 <literal>shadow</literal>(4)。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>min</literal></term>
+<listitem><para>所需的相邻两次更改口令之间的最小天数。必须将此字段设置为 0 或更大值才能启用口令有效期。缺省值为空。请参见 <literal>shadow</literal>(4)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>max</literal></term>
+<listitem><para>口令的最大有效天数。缺省值为空。请参见 <literal>shadow</literal>(4)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>warn</literal></term>
+<listitem><para>用户在口令到期之前多少天收到警告。请参见 <literal>shadow</literal>(4)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>inactive</literal></term>
+<listitem><para>允许该用户不活动的天数。按每台计算机对此进行计数。可从计算机的 <filename>lastlog</filename> 文件获取有关上次登录的信息。请参见 <literal>shadow</literal>(4)。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>expire</literal></term>
+<listitem><para>表示为自 UNIX 纪元(1970 年 1 月 1 日)后的天数的绝对日期。达到此数字时,将无法再进行登录。例如,到期值为 13514 指定登录将在 2007 年 1 月 1 日失效。请参见 <literal>shadow</literal>(4)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>flag</literal></term>
+<listitem><para>设置为空。请参见 <literal>shadow</literal>(4)。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect2>
+</refsect1>
+<refsect1 role="other"><title>执行器</title>
+<para>在某些上下文中,附加操作可能适合在为特定操作做准备时执行或者在引入特定操作后执行。这些附加操作特定于操作系统,通常仅在实时系统映像上才需要。实时映像是在当前区域的活动的、正在运行的引导环境的 <literal>/</literal> 处挂载的映像。当软件包安装或删除过程中涉及的多个操作具有相同的执行器时,会为该安装或删除过程执行一次与执行器存在情况相对应的操作。</para>
+<para>错误指定的执行器可能会导致软件包安装失败,如果该执行器无法确定进行安全安装的方法。</para>
+<para>系统定义了以下执行器:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>reboot-needed</literal></term>
+<listitem><para>可设置为 <literal>true</literal> 或 <literal>false</literal>。此执行器声明:如果软件包系统在实时映像上操作,则必须在新引导环境中更新或删除标记的操作。<literal>be-policy</literal> 映像属性控制新引导环境的创建。有关 <literal>be-policy</literal> 属性的更多信息,请参见 <literal>pkg</literal>(1) 手册页的“映像属性”部分。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>disable_fmri</literal>、<literal>refresh_fmri</literal>、<literal>restart_fmri</literal>、<literal>suspend_fmri</literal></term>
+<listitem><para>其中每个执行器在软件包安装或删除过程中均使用服务实例的 FMRI 值进行操作。根据 <literal>svcadm</literal>(1M) 的 <literal>disable</literal> 子命令,<literal>disable_fmri</literal> 会导致给定的 FMRI 在删除操作之前被禁用。根据 <literal>svcadm</literal>(1M) 的各个子命令,<literal>refresh_fmri</literal> 和 <literal>restart_fmri</literal> 会导致给定的 FMRI 在安装、更新或删除操作后被刷新或重新启动。最后,<literal>suspend_fmri</literal> 会导致给定的 FMRI 在安装操作阶段之前被临时禁用,并在该阶段完成后被重新启用。</para>
+<para>该值可以包含与多个服务实例匹配的模式。但是,它必须使用 <literal>svcs</literal>(1) 所接受的 glob 显式执行此操作,而不是通过不指示任何实例来隐式执行此操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>中介</title>
+<para>中介是代表一组相关符号链接或硬链接的名称。如果两个或更多个链接操作拥有相同的路径和中介名称,则用户或软件包系统会根据版本、实现或优先级选择链接目标。有关中介属性的信息,请参见“链接操作”。</para>
+<para>以下示例显示名为 <literal>java</literal> 的中介的两个不同实例(其中,链接选择的区别为版本)。这两个 <literal>link</literal> 操作会显示在两个不同软件包中。</para>
+<programlisting>link mediator=java mediator-version=1.6 path=usr/java target=jdk/jdk1.6.0_31
+link mediator=java mediator-version=1.7 path=usr/java target=jdk/jdk1.7.0_02</programlisting>
+<para>有关如何为此链接路径选择所需版本的信息,请参见 <command>pkg</command>(1) 手册页中的 <command>set-mediator</command> 子命令。要选择版本,必须安装两个软件包。</para>
+</refsect1>
+<refsect1 role="other"><title>约束和冻结</title>
+<para>在将软件包转换为新版本、添加到系统中或从系统中删除时,所选的版本或是否允许删除由对软件包施加的各种约束确定。这些约束可由其他软件包以依赖性的形式进行定义,或者由管理员以冻结的形式进行定义。</para>
+<para>最常见的约束形式由 <literal>require</literal> 依赖性提供,如上面的“依赖操作”中所述。此类约束可防止软件包被降级或删除。</para>
+<para>操作系统的大多数部分由名为 <emphasis> incorporation</emphasis> 的软件包进行封装。这些软件包主要提供由 <literal>incorporate</literal> 依赖性表示的约束。</para>
+<para>如上所述,合并的软件包不需要存在于系统上,但如果存在,它将同时指定一个非独占最低版本和一个独占最高版本。例如,如果依赖性的 FMRI 具有版本 1.4.3,则低于 1.4.3 的版本不能满足依赖性,且任何高于或等于 1.4.4 的版本也不能满足依赖性。但是,可以允许仅仅扩展了点分序列的版本,如 1.4.3.7。</para>
+<para>Incorporation 用于强制系统的各部分进行同步升级。对于某些组件(例如 C 库和内核),这是一项基本要求。对于其他组件(例如,不具有任何其他依赖性的简单用户级组件),同步升级仅仅用来提供一组经过测试的已知软件包版本,这些软件包版本可由 incorporation 的特定版本进行引用。</para>
+<para>因为 incorporation 只是一个软件包,所以可将其删除,它提供的所有约束也将随之解除。但是,Oracle Solaris 提供的许多 incorporation 是其合并的软件包所必需的,因为解除其约束可能会不安全。</para>
+<para>尝试将软件包升级到已安装的 incorporation 所不允许的版本,将不会尝试查找更高的 incorporation 版本来满足该请求,反而会失败。如果必须移动约束本身,而又无法删除指定它的 incorporation,则必须将 incorporation 升级到指定所需约束版本的版本。升级 incorporation 会导致不能满足新版本提供的约束的所有合并软件包也进行升级。</para>
+<para>系统管理员可以使用 <command>pkg freeze</command> 命令约束软件包。在未提供版本的情况下,将指定软件包约束为系统上已安装的版本。如果提供了版本化软件包,则此管理约束或冻结会像已安装了合并依赖性(其中 <literal>fmri</literal> 属性具有所提供的软件包版本值)一样进行操作。</para>
+<para>包管理系统永远不会自动解除冻结。要解除约束,请使用 <command>pkg unfreeze</command> 命令。</para>
+</refsect1>
+<refsect1 role="other"><title>发布者和系统信息库</title>
+<para>如上所述,发布者只是软件包客户端用来标识软件包提供者的一个名称。发布者可使用软件包系统信息库和/或软件包归档来发行其软件包。软件包系统当前支持以下两种类型的系统信息库:源系统信息库和镜像系统信息库。</para>
+<para><emphasis>源</emphasis>是包含一个或多个软件包的所有元数据(例如,目录、清单和搜索索引)和内容(文件)的软件包系统信息库。如果在一个映像中为给定发布者配置了多个源,则软件包客户端 API 会尝试选择从其检索软件包数据的最佳源。这是最常见的系统信息库类型,当每次在软件包系统信息库上使用 <command>pkgsend</command> 或 <command>pkgrecv</command> 时进行隐式创建。</para>
+<para><emphasis>mirror</emphasis> 是仅包含软件包内容(文件)的软件包系统信息库。如果在一个映像中为给定发布者配置了一个或多个镜像,则客户端 API 会优先使用镜像进行软件包内容检索并尝试选择从其检索软件包内容的最佳镜像。如果镜像不可访问、不具有所需内容或者运行缓慢,客户端 API 将从任何已配置的源系统信息库检索内容。镜像设计用于通过 <command>pkg.depotd</command>(1M) 的动态镜像功能在一组可信客户端之间共享内容。镜像还设计用于验证对软件包元数据的访问,但发行软件包内容不需要进行验证。例如,客户端可能配置有需要具有 SSL 密钥和证书对才能访问的 <literal>https</literal> 源,以及提供软件包内容的 <literal>http</literal> 镜像。这样,只有经过授权的客户端才可以安装或更新软件包,同时避免了验证软件包内容检索的开销。通过删除系统信息库中除名为 <filename>file</filename> 的子目录及其父目录之外的所有子目录可创建镜像。通过使用 <command>pkg.depotd</command>(1M) 的镜像模式还可将源系统信息库置备为镜像。</para>
+</refsect1>
+<refsect1 role="other"><title>全局和非全局区域更新</title>
+<para><literal>pkg</literal> 系统会强制使非全局区域与全局区域保持同步。这表示某些软件包在全局区域和所有非全局区域中必须处于同一版本,以确保运行相同的内核。为此,<literal>pkg</literal> 会使用 <literal>parent</literal> 依赖性对非全局区域施加某些约束。有关 <literal>parent</literal> 依赖性的更多信息,请参见“依赖操作”。</para>
+<para>由于全局区域对非全局区域施加的限制,非全局区域必须可以访问全局区域的软件包且必须具有相似的发布者配置。使用<emphasis role="strong">系统信息库</emphasis>可实现上述两个目标(请参见 <literal>pkg.sysrepo</literal>(1M) 手册页)。系统信息库可提供全局区域中配置的发布者的访问权,以及有关如何配置这些发布者的信息。要阻止非全局区域在安装或更新期间选择不同软件包,在发布者搜索顺序中系统发布者的排列顺序需要高于非全局区域中配置的发布者的顺序。有关发布者搜索顺序的信息,请参见 <literal>pkg</literal>(1) 手册页中的 <command>pkg set-publisher</command> 命令。</para>
+<para>要更新系统上的所有非全局区域,请使用不带全局区域中参数的 <command>pkg update</command> 命令。此命令会在全局区域上执行并以递归方式在每个非全局区域上执行。将对非全局区域仅进行最少的必要更改,以使其与全局区域中所进行的更改同步。例如,假设全局区域和非全局区域中都安装了版本 1 的软件包 <literal>foo</literal>,并假设系统信息库中存在版本 2。如果 <literal>foo</literal> 具有父项依赖性,则 <command>pkg update foo</command> 会在全局区域和非全局区域中将 <literal>foo</literal> 更新至版本 2,这是因为 <literal>parent</literal> 依赖性会强制使软件包保持同步。如果 <literal>foo</literal> 不具有父项依赖性,则 <literal>foo</literal> 在全局区域中会更新至版本 2,但在非全局区域中仍为版本 1。</para>
+</refsect1>
+<refsect1 role="other"><title>侧面和变量</title>
+<para>软件可以具有可选组件和互斥组件。可选组件的示例包括语言环境和文档。互斥组件的示例包括 SPARC 或 x86 和调试或非调试二进制文件。</para>
+<para>在 IPS 中,可选组件称为<emphasis>侧面</emphasis>,互斥组件称为<emphasis>变量</emphasis>。侧面和变量指定为软件包操作中的标记。每个侧面和变量标记都有一个名称和值。单个操作可以具有多个侧面和变量标记。具有多个侧面和变量标记的组件有多种,例如供开发者使用的特定于体系结构的头文件,或仅用于 SPARC 全局区域的组件。</para>
+<para>以下是变量标记的一个示例 <literal>variant.arch=sparc</literal>。以下是侧面标记的一个示例 <literal>variant.arch=sparc</literal>。引用侧面和变量时,通常不带前导字符串 <literal>facet.</literal> 和 <literal>variant.</literal>。</para>
+<para>侧面和变量是映像的特殊属性,无法在单个软件包上设置。要查看映像上设置的侧面和变量的当前值,请按 <command>pkg</command>(1) 手册页中所示,使用 <command>pkg facet</command> 和 <command>pkg variant</command> 命令。要修改映像上设置的侧面和变量的值,请使用 <command>pkg change-facet</command> 和 <command>pkg change-variant</command> 命令。</para>
+<para>软件包客户机将侧面处理为布尔值:侧面在映像中仅能设置为 <literal>true</literal>(启用)或 <literal>false</literal>(禁用)。缺省情况下,以 'facet.debug.' 或 'facet.optional.' 开头的所有侧面在映像中均被视为设置为 <literal>false</literal>;所有其他侧面在映像中均被视为设置为 <literal>true</literal>。</para>
+<para>可以使用 <command>pkg change-facet</command> 命令在映像内本地设置侧面,也可从父映像继承侧面。例如,非全局区域可从全局区域继承侧面。继承的侧面会在本地设置的侧面之前计算结果,并且优先于本地设置的侧面。如果同一个侧面既是继承的,又是本地设置的,则继承的侧面值会屏蔽本地设置的值。屏蔽的侧面不会影响侧面计算结果和软件包操作。使用 <command>pkg change-facet</command> 命令所做的侧面更改仅影响本地设置的侧面。只能通过更改父映像来更改继承的侧面。缺省情况下,<command>pkg facet</command> 命令不显示屏蔽的侧面。</para>
+<para>操作的侧面标记值可以设置为 <literal>all</literal> 或 <literal> true</literal>,以控制客户机如何过滤有侧面标记的操作。除 <literal>all</literal> 或 <literal>true</literal> 之外的所有值都具有未定义的行为。有关要安装具有侧面标记的操作而必须在镜像中存在的条件的说明,请参见下文。</para>
+<para>需要多个级别的过滤时,侧面的 <literal>all</literal> 值非常有用。在以下示例中,仅当 <literal>doc</literal> 侧面和至少一个 <literal>locale</literal> 侧面在映像中为 <literal>true</literal> 时,才安装 <literal>foo.txt </literal>。这样允许管理员排除文档,但是仍启用或禁用特定语言环境支持。此外,仅当 <literal>doc</literal> 和 <literal>devel</literal> 侧面在映像中都为 <literal>true</literal> 时,才安装 <literal>api.txt</literal>。</para>
+<programlisting>file path=usr/share/doc/foo/foo.txt facet.doc=all facet.locale.en_GB=true facet.locale.en_US=true
+file path=usr/share/doc/foo/api.txt facet.doc=all facet.devel=all</programlisting>
+<para>映像上设置的侧面可以为完整侧面(如 <literal>doc.man</literal>)或模式(如 <literal>locale.*</literal>)。要禁用侧面名称空间的一部分,仅启用其中的几个侧面时,此方式很有用。例如,您可以禁用所有语言环境,然后仅启用一个或两个特定语言环境,如以下示例所示:</para>
+<screen># <userinput>pkg change-facet locale.*=false</userinput>
 [output about packages being updated]
-# \fBpkg change-facet locale.en_US=true\fR
-[output about packages being updated]
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-大多数变量可以具有任意数量的值。例如,\fBarch\fR 变量可以设置为 \fBi386\fR、\fBsparc\fR、\fBppc\fR、\fBarm\fR 或分发支持的任何体系结构。(Oracle Solaris 中仅使用 \fBi386\fR 和 \fBsparc\fR。)但 \fBdebug\fR 变量例外。\fBdebug\fR 变量只能设置为 \fBtrue\fR 或 \fBfalse\fR;其他值的行为不确定。如果文件操作同时具有非调试和调试版本,则必须针对这两个版本明确设置适用的 \fBdebug\fR 变量,如以下示例所示:
-.sp
-.in +2
-.nf
-file group=sys mode=0644 overlay=allow owner=root \e
-  path=etc/motd pkg.csize=115 pkg.size=103 preserve=true \e
+# <userinput>pkg change-facet locale.en_US=true</userinput>
+[output about packages being updated]</screen>
+<para>大多数变量可以具有任意数量的值。例如,<literal>arch</literal> 变量可以设置为 <literal>i386</literal>、<literal>sparc</literal>、<literal>ppc</literal>、<literal>arm</literal> 或分发支持的任何体系结构。(Oracle Solaris 中仅使用 <literal>i386</literal> 和 <literal>sparc</literal>。)但 <literal>debug</literal> 变量例外。<literal>debug</literal> 变量只能设置为 <literal>true</literal> 或 <literal>false</literal>;其他值的行为不确定。如果文件操作同时具有非调试和调试版本,则必须针对这两个版本明确设置适用的 <literal>debug</literal> 变量,如以下示例所示:</para>
+<programlisting>file group=sys mode=0644 overlay=allow owner=root &bsol;
+  path=etc/motd pkg.csize=115 pkg.size=103 preserve=true &bsol;
   variant.debug.osnet=true
 
-file group=sys mode=0644 overlay=allow owner=root \e
-  path=etc/motd pkg.csize=68 pkg.size=48 preserve=true \e
-  variant.debug.osnet=false
-.fi
-.in -2
-
-.sp
-.LP
-要安装使用变量的软件包,必须在映像上设置变量值。\fBarch\fR 和 \fBzone\fR 变量由创建映像和安装其初始内容的程序设置。缺省情况下,\fBdebug.*\fR 变量在映像中设置为 \fBfalse\fR。
-.sp
-.LP
-映像中设置的侧面和变量会影响是否安装特定操作。
-.RS +4
-.TP
-.ie t \(bu
-.el o
-始终会安装不带侧面或变量标记的操作。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果以下条件存在于映像中,将安装具有侧面标记的操作:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-操作上具有 \fBall\fR 值的所有侧面标记在映像中都为 \fB true\fR(\fBtrue\fR 是缺省值)。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果操作上的任何侧面标记具有值 \fBtrue\fR,则这些侧面中的至少一个侧面在映像中为 \fBtrue\fR。
-.RE
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-仅当所有变量标记的值与映像中设置的值相同时,才会安装带这些变量标记的操作。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-如果侧面和变量都允许安装操作,则会安装带有这两种标记的操作。
-.RE
-.sp
-.LP
-可以创建定制侧面标记和 \fBvariant.debug.*\fR 变体标记。有关更多信息,请参见《\fIPackaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2\fR》。以下是 Oracle Solaris 中的常用标记。
-.sp
-
-.sp
-.TS
-tab();
-cw(2.75i) cw(2.75i) 
-lw(2.75i) lw(2.75i) 
-.
-变量名可能值
-_
-\fBvariant.arch\fR\fBsparc\fR, \fBi386\fR
-\fBvariant.opensolaris.zone\fR\fBglobal\fR, \fBnonglobal\fR
-\fBvariant.debug.*\fR\fBtrue\fR、\fBfalse\fR
-.TE
-
-.sp
-.LP
-以下列表描述了 Oracle Solaris 中使用的一小部分侧面标记:
-.sp
-.in +2
-.nf
-facet.devel             facet.doc
+file group=sys mode=0644 overlay=allow owner=root &bsol;
+  path=etc/motd pkg.csize=68 pkg.size=48 preserve=true &bsol;
+  variant.debug.osnet=false</programlisting>
+<para>要安装使用变量的软件包,必须在映像上设置变量值。<literal>arch</literal> 和 <literal>zone</literal> 变量由创建映像和安装其初始内容的程序设置。缺省情况下,<literal>debug.*</literal> 变量在映像中设置为 <literal>false</literal>。</para>
+<itemizedlist>
+<para>映像中设置的侧面和变量会影响是否安装特定操作。</para>
+<listitem><para>始终会安装不带侧面或变量标记的操作。</para>
+</listitem>
+<listitem><para>如果以下条件存在于映像中,将安装具有侧面标记的操作:</para>
+<itemizedlist>
+<listitem><para>操作上值为 <literal>all</literal> 的所有侧面标记在映像中均为 <literal>true</literal>(<literal>false</literal> 是以 'facet.debug.' 或 'facet.optional.' 开头的所有侧面的缺省设置;<literal>true</literal> 是所有其他侧面的缺省设置)。</para>
+</listitem>
+<listitem><para>如果操作上的任何侧面标记具有值 <literal>true</literal>,则这些侧面中的至少一个侧面在映像中为 <literal>true</literal>。</para>
+</listitem>
+</itemizedlist>
+</listitem>
+<listitem><para>仅当所有变量标记的值与映像中设置的值相同时,才会安装带这些变量标记的操作。</para>
+</listitem>
+<listitem><para>如果侧面和变量都允许安装操作,则会安装带有这两种标记的操作。</para>
+</listitem>
+</itemizedlist>
+<para>可以创建定制侧面标记和 <literal>variant.debug.*</literal> 变体标记。有关更多信息,请参见《<citetitle>在 Oracle Solaris 11.3 中使用映像打包系统打包和交付软件</citetitle>》。以下是 Oracle Solaris 中的常用标记。</para>
+<informaltable frame="topbot">
+<textobject><simpara>变量及其可能值。</simpara></textobject>
+<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="50*" /><colspec colwidth="50*" /><thead>
+<row rowsep="1">
+<entry>
+<para>变量名</para>
+</entry>
+<entry>
+<para>可能值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry>
+<para><literal>variant.arch</literal></para>
+</entry>
+<entry>
+<para><literal>sparc</literal>, <literal>i386</literal></para>
+</entry>
+</row>
+<row>
+<entry>
+<para><literal>variant.opensolaris.zone</literal></para>
+</entry>
+<entry>
+<para><literal>global</literal>, <literal>nonglobal</literal></para>
+</entry>
+</row>
+<row>
+<entry>
+<para><literal>variant.debug.*</literal></para>
+</entry>
+<entry>
+<para><literal>true</literal>、<literal>false</literal></para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable>
+<para>以下列表描述了 Oracle Solaris 中使用的一小部分侧面标记:</para>
+<programlisting>facet.devel             facet.doc
 facet.doc.html          facet.doc.info
 facet.doc.man           facet.doc.pdf
 facet.locale.de         facet.locale.en_GB
 facet.locale.en_US      facet.locale.fr
-facet.locale.ja_JP      facet.locale.zh_CN
-.fi
-.in -2
-
-.SH 映像策略
-.sp
-.LP
-映像策略由具有布尔值的映像属性所定义。有关 \fBflush-content-cache-on-success\fR 和 \fBsend-uuid\fR 属性的说明以及如何查看和修改其值的信息,请参见 \fBpkg\fR(1) 手册页中的“映像属性”。
-.SH 文件
-.sp
-.LP
-因为 \fBpkg\fR(5) 映像可位于任意一个较大的文件系统内,需要使用标记 \fB$IMAGE_ROOT\fR 来区分相对路径。对于典型的系统安装,\fB$IMAGE_ROOT\fR 等效于 /。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/var/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-完整或部分映像的元数据目录。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_ROOT/.org.opensolaris,pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-用户映像的元数据目录。
-.RE
-
-.sp
-.LP
-在特定映像的元数据中,某些文件和目录可能包含修复和恢复期间有用的信息。标记 \fB$IMAGE_META \fR 用于指示包含元数据的顶层目录。\fB $IMAGE_META\fR 通常是以上给出的两个路径之一。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/lost+found\fR\fR
-.ad
-.sp .6
-.RS 4n
-在软件包操作期间移动的有冲突目录和文件的位置。
-.RE
+facet.locale.ja_JP      facet.locale.zh_CN</programlisting>
+</refsect1>
+<refsect1 role="other"><title>映像策略</title>
+<para>映像策略由具有布尔值的映像属性所定义。有关 <literal>flush-content-cache-on-success</literal> 和 <literal>send-uuid</literal> 属性的说明以及如何查看和修改其值的信息,请参见 <literal>pkg</literal>(1) 手册页中的“映像属性”。</para>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para>因为 <literal>pkg</literal>(5) 映像可位于任意一个较大的文件系统内,需要使用标记 <literal>$IMAGE_ROOT</literal> 来区分相对路径。对于典型的系统安装,<literal>$IMAGE_ROOT</literal> 等效于 /。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_ROOT/var/pkg</filename></term>
+<listitem><para>完整或部分映像的元数据目录。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_ROOT/.org.opensolaris,pkg</filename></term>
+<listitem><para>用户映像的元数据目录。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>在特定映像的元数据中,某些文件和目录可能包含修复和恢复期间有用的信息。标记 <literal>$IMAGE_META </literal> 用于指示包含元数据的顶层目录。<literal> $IMAGE_META</literal> 通常是以上给出的两个路径之一。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>$IMAGE_META/lost+found</filename></term>
+<listitem><para>在软件包操作期间移动的有冲突目录和文件的位置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><filename>$IMAGE_META/publisher</filename></term>
+<listitem><para>为每个发布者包含一个目录。每个目录存储特定于发布者的元数据。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para><literal>$IMAGE_META</literal> 目录分层结构中的其他路径是专用的,但可以进行更改。</para>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.sysrepo-1m"><citerefentry><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="svcs-1"><citerefentry><refentrytitle>svcs</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="svcadm-1m"><citerefentry><refentrytitle>svcadm</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="AUOSS">《<citetitle remap="book">在 Oracle Solaris 11.3 中添加和更新软件</citetitle>》</olink></para>
+<para><olink targetdoc="CCOSP">《<citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle>》</olink></para>
+<para><olink targetdoc="PKDEV">《<citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle>》</olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB$IMAGE_META/publisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-为每个发布者包含一个目录。每个目录存储特定于发布者的元数据。
-.RE
-
-.sp
-.LP
-\fB$IMAGE_META\fR 目录分层结构中的其他路径是专用的,但可以进行更改。
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(1)、\fBpkgsend\fR(1)、\fBpkg.depotd\fR(1M)、\fBpkg.sysrepo\fR(1M)、\fBsvcs\fR(1)、\fBsvcadm\fR(1M)
-.sp
-.LP
-\fI《Adding and Updating Software in Oracle Solaris 11.2》\fR
-.sp
-.LP
-\fI《Copying and Creating Package Repositories in Oracle Solaris 11.2》\fR
-.sp
-.LP
-\fI《Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2》\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/zh_CN/pkg.depotd.1m	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkg.depotd.1m	Wed Jul 01 10:45:55 2015 -0700
@@ -1,846 +1,386 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkg.depotd 1M "2013 年 10 月 2 日" "SunOS 5.11" "系统管理命令"
-.SH 名称
-pkg.depotd \- 映像包管理系统 depot 服务器
-.SH 用法概要
-.LP
-.nf
-/usr/lib/pkg.depotd [--cfg \fIsource\fR] [-a \fIaddress\fR]
-    [--content-root \fIroot_dir\fR] [-d \fIinst_root\fR]
-    [--debug \fIfeature_list\fR] [--disable-ops=\fIop\fR[/1][,...]]
-    [--image-root \fIpath\fR] [--log-access \fIdest\fR]
-    [--log-errors \fIdest\fR] [--mirror \fImode\fR] [-p \fIport\fR]
-    [--proxy-base \fIurl\fR] [--readonly \fImode\fR] [-s \fIthreads\fR]
-    [--sort-file-max-size \fIbytes\fR] [--ssl-cert-file \fIsource\fR]
-    [--ssl-dialog \fItype\fR] [--ssl-key-file \fIsource\fR]
-    [-t \fIsocket_timeout\fR] [--writable-root \fIpath\fR]
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpkg.depotd\fR 是映像包管理系统的 depot 服务器。它提供对包含在软件包系统信息库中的数据的网络访问。对于不支持通过文件系统直接访问系统信息库的客户机,或网络访问是唯一可用或希望使用的传输方法的客户机,通常使用软件包库 (depot)。
-.sp
-.LP
-诸如 \fBpkg\fR 之类的检索客户机可直接从系统信息库或通过 depot 服务器检索软件包和软件包元数据列表。发布客户机 \fBpkgsend\fR 可将新版本的软件包直接或通过 depot 服务器发送到系统信息库。\fBpkgrepo\fR 可用于创建系统信息库供 depot 服务器使用,或用于直接以及通过 depot 服务器管理它们。
-.sp
-.LP
-\fBpkg.depotd\fR 通常在系统上作为服务运行。软件包和软件开发者可能希望运行专用副本进行测试。
-.sp
-.LP
-库不提供任何自己的访问控制方法。缺省情况下,所有能够连接的客户机都能够读取所有软件包数据和发布新的软件包版本。在服务管理工具 (Service Management Facility, SMF) 下运行时例外,缺省情况为在只读模式中运行。下列“附注”部分描述了维护具有不断变化内容的公共 depot 服务器的一些最佳做法。
-.SH SMF 属性
-.sp
-.LP
-\fBpkg.depotd\fR 服务器通常通过与其服务关联的 SMF 属性配置。\fBsvc:/application/pkg/server\fR 服务运行一个 \fBpkg.depot\fR 服务器进程,或者为 \fBsvc:/application/pkg/depot\fR 服务提供配置。请参见 \fBpkg.depot-config\fR(1M) 手册页和下文中的 \fBpkg/standalone\fR 属性。
-.sp
-.LP
-有关 SMF 属性的信息,请参见 \fBsmf\fR(5) 手册页。可以识别以下属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/address\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBnet_address\fR) 在其上侦听连接的 IP 地址。缺省值为 0.0.0.0 (\fBINADDR_ANY\fR),该地址侦听所有活动接口。要侦听所有活动的 IPv6 接口,请使用 \fB::\fR。只使用第一个值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/content_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 实例应在其中找到其静态 Web 内容以及其他 Web 内容的文件系统路径。缺省值为 \fB/usr/share/lib/pkg\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/debug\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 以逗号分隔的要启用的调试功能列表。可能的值为:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBheaders\fR\fR
-.ad
-.RS 11n
-.rt  
-将每个请求的标题记录到错误日志。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/disable_ops\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 以逗号分隔的应该为 depot 服务器禁用的操作列表。操作以 \fI operation\fR[/\fIversion\fR] 形式提供(例如 \fBcatalog\fR 或 \fB search_1\fR)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/image_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 其文件信息将用作文件数据高速缓存的映像的路径。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/inst_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 实例应在其中找到其系统信息库数据的文件系统路径。必需,除非已提供了 \fBPKG_REPO\fR。缺省值为 \fB/var/pkgrepo\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/log_access\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 库进程记录的任何与访问相关的信息的目标。可能的值为:\fBstderr\fR、\fBstdout\fR、\fBnone\fR 或绝对路径名称。如果 \fBstdout\fR 是 \fBtty\fR,则缺省值为 \fBstdout\fR。如果 \fBstdout\fR 不是 \fBtty\fR,则缺省值为 \fBnone\fR。如果您将 \fBpkg\fR 作为服务运行,则 \fBlog_access\fR 的缺省值为 \fBnone\fR,且输出将写入 \fB/var/svc/log/application-pkg-server:* \fR 中。有关管理大日志文件的示例,请参见 \fBlogadm\fR(1M) 手册页。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/log_errors\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 库进程记录的任何错误或其他信息的目标。可能的值为:\fBstderr\fR、\fBstdout\fR、\fBnone\fR 或绝对路径名称。缺省值为 \fBstderr\fR。有关管理大日志文件的示例,请参见 \fBlogadm\fR(1M) 手册页。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/mirror\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBboolean\fR) 设置是否使用软件包镜像模式。为 true 时,禁用发布和元数据操作,只提供受限制的浏览器用户界面。当 \fBpkg/readonly\fR 属性为 true 时,该属性不能为 true。缺省值为 \fBfalse\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/port\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 实例应侦听传入软件包请求的端口号。如果未提供 SSL 证书和密钥信息,则缺省值为 80;否则,缺省值为 443。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/proxy_base\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBuri\fR) 该属性更改 depot 服务器的基 URL,当在 Apache 或反向代理配置中的某个其他 Web 服务器后运行时最有用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/readonly\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBboolean\fR) 设置是否禁用修改操作,例如由 \fBpkgsend\fR 启动的那些操作。检索操作仍可用。当 \fBpkg/mirror \fR 属性为 true 时,该属性不能为 true。缺省值为 \fBtrue\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/socket_timeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 在断开连接之前服务器应该等待客户机响应的最大秒数。缺省值为 60。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/sort_file_max_size\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 索引器排序文件的最大大小。用于限制库用来创建索引的 RAM 数量,或增加数量以提高速度。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_cert_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) PEM 编码的证书文件的绝对路径名称。缺省值为 \fBnone\fR。此属性必须与 \fBssl_key_file\fR 一起使用。如果同时提供 \fBssl_cert_file\fR 和 \fB/ssl_key_file \fR,则库只响应 SSL 请求。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_dialog\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 指定应使用何种方法来获取用于对 \fBssl_key_file\fR 进行解密的口令短语。可能的值为:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBbuiltin\fR\fR
-.ad
-.sp .6
-.RS 4n
-提示输入口令短语。这是缺省值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexec:\fI/path/to/program\fR\fR\fR
-.ad
-.sp .6
-.RS 4n
-执行指定的外部程序来获取口令短语。程序的第一个参数为 \fB\&''\fR,并保留该参数。程序的第二个参数是服务器的端口号。口令短语输出到 \fBstdout\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBsmf:fmri\fR\fR
-.ad
-.sp .6
-.RS 4n
-尝试从与 FMRI 相关的服务实例中检索属性 \fBpkg_secure/ssl_key_passphrase \fR 的值。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/ssl_key_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) PEM 编码的私钥文件的绝对路径名称。此属性必须与 \fBssl_cert_file \fR 属性一起使用。如果同时提供 \fB/ssl_key_file \fR 和 \fBssl_cert_file\fR,则库只响应 SSL 请求。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/standalone\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBboolean\fR) 要轻松地通过具有最低 Apache 配置的单个 Apache 实例为多个系统信息库提供服务,请将此属性设置为 \fBfalse\fR 并将此 \fBpkg/server\fR 实例的 \fBpkg/readonly\fR 属性设置为 \fBtrue\fR。\fBpkg/standalone\fR 的缺省值为 \fBfalse\fR,\fBpkg/readonly\fR 的缺省值为 \fBtrue\fR。有关更多信息,请参见 \fBpkg.depot-config\fR(1M) 手册页。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/threads\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 启动以为请求提供服务的线程数。缺省值为 60。只适用于小型部署。该值应该为并发客户机数量的 20 倍左右。\fBthreads\fR 的最大值为 5000。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/writable_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 程序对其具有写入访问权限的目录的文件系统路径。此属性可与 \fB-readonly\fR 选项一起使用,以便 depot 服务器无需具有对软件包信息的写入访问权限即可创建文件(如搜索索引)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_secure/ssl_key_passphrase\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 用于对 \fBpkg/ssl_key_file\fR 进行解密的口令。该值受读取授权保护(使用属性 \fBsolaris.smf.read.pkg-server\fR)。
-.RE
-
-.sp
-.LP
-使用以下属性控制 depot 服务器的浏览器用户界面 (Browser User Interface, BUI) 的显示和行为:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_description\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) RSS/Atom 源的描述性段落。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_icon\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 用于以可视方式表示 RSS/Atom 源的小型图像的路径名称。路径名称应相对于 \fBcontent_root\fR。缺省值为 \fBweb/_themes/pkg-block-icon.png\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_logo\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 将用于以可视方式标记或标识 RSS/Atom 源的大型图像的路径名称。该值应相对于 \fBcontent_root\fR。缺省值为 \fBweb/_themes/pkg-block-icon.png\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 由为系统信息库提供服务的库生成的 RSS/Atom 源的简短描述性名称。缺省值为 "package repository feed"。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg_bui/feed_window\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 系统信息库的源最后生成之前的小时数,以包括生成源的时间。
-.RE
-
-.sp
-.LP
-软件包库还可以用作来自 \fBpkg\fR(5) 的本地客户机映像的镜像服务器。这使得在 LAN 上共享一个子网的客户机可以对它们的文件高速缓存进行镜像。客户机可以相互下载文件,从而减少软件包 depot 服务器上的负载。此功能是作为由 SMF 配置的替代 depot 服务提供的。它为服务发现使用 mDNS 和 \fBdns-sd\fR。
-.sp
-.LP
-mDNS 镜像通常是通过与其服务关联的 SMF 属性配置的。可以识别以下属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/image_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBastring\fR) 其文件信息将用作文件数据高速缓存的映像的路径。缺省值为 \fB/\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkg/port\fR\fR
-.ad
-.sp .6
-.RS 4n
-(\fBcount\fR) 实例应侦听传入软件包请求的端口号。缺省值为 80。
-.RE
-
-.SH 选项
-.sp
-.LP
-\fBpkg.depotd\fR 可从文件或从现有 SMF 服务实例的属性数据读取其基本配置信息。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cfg\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定读取和写入配置数据时要使用的文件的路径名,或格式为 \fBsmf:\fIfmri\fR\fR 的字符串,其中 \fIfmri\fR 是从中读取配置数据的实例的服务故障管理资源标识符 (fault management resource identifier, FMRI)。有关指定文件的格式的详细信息,请参见下文的“库配置”。
-.RE
-
-.sp
-.LP
-如果没有可用的已存在的配置源,或者要覆盖从使用 \fB--cfg\fR 提供的配置文件中读取的值,则可以使用下列选项来更改 depot 服务器的缺省行为:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIaddress\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/address\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--content-root\fR \fIroot_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/content_root\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIinst_root\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/inst_root\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--debug\fR \fIfeature_list\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/debug\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--disable-ops\fR=\fIop\fR[\fB /1\fR][,...]\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/disable_ops\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--image-root\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上面的 \fBpkg/image_root\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--log-access\fR \fIdest\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/log_access\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--log-errors\fR \fIdest\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/log_errors\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--mirror\fR \fImode\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/mirror\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIport\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/port\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--proxy-base\fR \fIurl\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/proxy_base\fR。如果提供空值,则忽略该选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--readonly\fR \fImode\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/readonly\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIthreads\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/threads\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--sort-file-max-size\fR \fIbytes\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/sort_file_max_size\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-cert-file\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/ssl_cert_file\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-dialog\fR \fItype\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/ssl_dialog\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--ssl-key-file\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/ssl_key_file\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIsocket_timeout\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/socket_timeout\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--writable-root\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-请参见上述 \fBpkg/writable_root\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.LP
-针对软件包系统信息库的其他管理功能是由 \fBpkgrepo\fR 提供的。
-.SH 库配置
-.sp
-.LP
-如果使用 \fB--cfg\fR 选项提供了配置文件(而非 SMF FMRI),则 depot 服务器将以简单的文本格式读取和写入所有配置数据。在上述“SMF 属性”中描述了配置数据。配置数据包含各个部分,以 \fB[\fIsection\fR]\fR 标题开始,后跟 \fBname = \fIvalue\fR\fR 条目。后续部分为 RFC 822 样式。可以跨多个行拆分数据,以空格开始后续行即可。
-.sp
-.LP
-必须使用上述“选项”中列出的选项提供配置文件中未提供的任何所需值。样例配置文件可能类似如下:
-.sp
-.in +2
-.nf
-[pkg]
+<refentry lang="zh" id="pkg.depotd-1m">
+<refmeta><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum> <refmiscinfo class="date">2013 年 10 月 2 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1m;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg.depotd</refname><refpurpose>映像包管理系统 depot 服务器</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/lib/pkg.depotd [--cfg <replaceable>source</replaceable>] [-a <replaceable>address</replaceable>]
+    [--content-root <replaceable>root_dir</replaceable>] [-d <replaceable>inst_root</replaceable>]
+    [--debug <replaceable>feature_list</replaceable>] [--disable-ops=<replaceable>op</replaceable>[/1][,...]]
+    [--image-root <replaceable>path</replaceable>] [--log-access <replaceable>dest</replaceable>]
+    [--log-errors <replaceable>dest</replaceable>] [--mirror <replaceable>mode</replaceable>] [-p <replaceable>port</replaceable>]
+    [--proxy-base <replaceable>url</replaceable>] [--readonly <replaceable>mode</replaceable>] [-s <replaceable>threads</replaceable>]
+    [--sort-file-max-size <replaceable>bytes</replaceable>] [--ssl-cert-file <replaceable>source</replaceable>]
+    [--ssl-dialog <replaceable>type</replaceable>] [--ssl-key-file <replaceable>source</replaceable>]
+    [-t <replaceable>socket_timeout</replaceable>] [--writable-root <replaceable>path</replaceable>]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="GLHAR" role="description"><title></title>
+<para><command>pkg.depotd</command> 是映像包管理系统的 depot 服务器。它提供对包含在软件包系统信息库中的数据的网络访问。对于不支持通过文件系统直接访问系统信息库的客户机,或网络访问是唯一可用或希望使用的传输方法的客户机,通常使用软件包库 (depot)。</para>
+<para>诸如 <command>pkg</command> 之类的检索客户机可直接从系统信息库或通过 depot 服务器检索软件包和软件包元数据列表。发布客户机 <command>pkgsend</command> 可将新版本的软件包直接或通过 depot 服务器发送到系统信息库。<command>pkgrepo</command> 可用于创建系统信息库供 depot 服务器使用,或用于直接以及通过 depot 服务器管理它们。</para>
+<para><command>pkg.depotd</command> 通常在系统上作为服务运行。软件包和软件开发者可能希望运行专用副本进行测试。</para>
+<para>库不提供任何自己的访问控制方法。缺省情况下,所有能够连接的客户机都能够读取所有软件包数据和发布新的软件包版本。在服务管理工具 (Service Management Facility, SMF) 下运行时例外,缺省情况为在只读模式中运行。下列“附注”部分描述了维护具有不断变化内容的公共 depot 服务器的一些最佳做法。</para>
+</refsect1>
+<refsect1 role="other"><title>SMF 属性</title>
+<para><literal>pkg.depotd</literal> 服务器通常通过与其服务关联的 SMF 属性配置。<literal>svc:/application/pkg/server</literal> 服务运行一个 <literal>pkg.depot</literal> 服务器进程,或者为 <literal>svc:/application/pkg/depot</literal> 服务提供配置。请参见 <literal>pkg.depot-config</literal>(1M) 手册页和下文中的 <literal>pkg/standalone</literal> 属性。</para>
+<para>有关 SMF 属性的信息,请参见 <literal>smf</literal>(5) 手册页。可以识别以下属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg/address</literal></term>
+<listitem><para>(<literal>net_address</literal>) 在其上侦听连接的 IP 地址。缺省值为 0.0.0.0 (<literal>INADDR_ANY</literal>),该地址侦听所有活动接口。要侦听所有活动的 IPv6 接口,请使用 <literal>::</literal>。只使用第一个值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/content_root</literal></term>
+<listitem><para>(<literal>astring</literal>) 实例应在其中找到其静态 Web 内容以及其他 Web 内容的文件系统路径。缺省值为 <filename>/usr/share/lib/pkg</filename>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/debug</literal></term>
+<listitem><para>(<literal>astring</literal>) 以逗号分隔的要启用的调试功能列表。可能的值为:</para>
+<variablelist>
+<varlistentry><term><literal>headers</literal></term>
+<listitem><para>将每个请求的标题记录到错误日志。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/disable_ops</literal></term>
+<listitem><para>(<literal>astring</literal>) 以逗号分隔的应该为 depot 服务器禁用的操作列表。操作以 <replaceable> operation</replaceable>[/<replaceable>version</replaceable>] 形式提供(例如 <literal>catalog</literal> 或 <literal> search_1</literal>)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/image_root</literal></term>
+<listitem><para>(<literal>astring</literal>) 其文件信息将用作文件数据高速缓存的映像的路径。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/inst_root</literal></term>
+<listitem><para>(<literal>astring</literal>) 实例应在其中找到其系统信息库数据的文件系统路径。必需,除非已提供了 <literal>PKG_REPO</literal>。缺省值为 <filename>/var/pkgrepo</filename>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/log_access</literal></term>
+<listitem><para>(<literal>astring</literal>) 库进程记录的任何与访问相关的信息的目标。可能的值为:<filename>stderr</filename>、<filename>stdout</filename>、<literal>none</literal> 或绝对路径名称。如果 <filename>stdout</filename> 是 <literal>tty</literal>,则缺省值为 <filename>stdout</filename>。如果 <filename>stdout</filename> 不是 <literal>tty</literal>,则缺省值为 <literal>none</literal>。如果您将 <literal>pkg</literal> 作为服务运行,则 <literal>log_access</literal> 的缺省值为 <literal>none</literal>,且输出将写入 <filename>/var/svc/log/application-pkg-server:* </filename> 中。有关管理大日志文件的示例,请参见 <literal>logadm</literal>(1M) 手册页。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/log_errors</literal></term>
+<listitem><para>(<literal>astring</literal>) 库进程记录的任何错误或其他信息的目标。可能的值为:<filename>stderr</filename>、<filename>stdout</filename>、<literal>none</literal> 或绝对路径名称。缺省值为 <filename>stderr</filename>。有关管理大日志文件的示例,请参见 <literal>logadm</literal>(1M) 手册页。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/mirror</literal></term>
+<listitem><para>(<literal>boolean</literal>) 设置是否使用软件包镜像模式。为 true 时,禁用发布和元数据操作,只提供受限制的浏览器用户界面。当 <literal>pkg/readonly</literal> 属性为 true 时,该属性不能为 true。缺省值为 <literal>false</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/port</literal></term>
+<listitem><para>(<literal>count</literal>) 实例应侦听传入软件包请求的端口号。如果未提供 SSL 证书和密钥信息,则缺省值为 80;否则,缺省值为 443。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/proxy_base</literal></term>
+<listitem><para>(<literal>uri</literal>) 该属性更改 depot 服务器的基 URL,当在 Apache 或反向代理配置中的某个其他 Web 服务器后运行时最有用。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/readonly</literal></term>
+<listitem><para>(<literal>boolean</literal>) 设置是否禁用修改操作,例如由 <command>pkgsend</command> 启动的那些操作。检索操作仍可用。当 <literal>pkg/mirror </literal> 属性为 true 时,该属性不能为 true。缺省值为 <literal>true</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/socket_timeout</literal></term>
+<listitem><para>(<literal>count</literal>) 在断开连接之前服务器应该等待客户机响应的最大秒数。缺省值为 60。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/sort_file_max_size</literal></term>
+<listitem><para>(<literal>count</literal>) 索引器排序文件的最大大小。用于限制库用来创建索引的 RAM 数量,或增加数量以提高速度。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_cert_file</literal></term>
+<listitem><para>(<literal>astring</literal>) PEM 编码的证书文件的绝对路径名称。缺省值为 <literal>none</literal>。此属性必须与 <literal>ssl_key_file</literal> 一起使用。如果同时提供 <literal>ssl_cert_file</literal> 和 <literal>/ssl_key_file </literal>,则库只响应 SSL 请求。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_dialog</literal></term>
+<listitem><para>(<literal>astring</literal>) 指定应使用何种方法来获取用于对 <literal>ssl_key_file</literal> 进行解密的口令短语。可能的值为:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>builtin</literal></term>
+<listitem><para>提示输入口令短语。这是缺省值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exec:<replaceable>/path/to/program</replaceable></literal></term>
+<listitem><para>执行指定的外部程序来获取口令短语。程序的第一个参数为 <literal>''</literal>,并保留该参数。程序的第二个参数是服务器的端口号。口令短语输出到 <filename>stdout</filename>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>smf:fmri</literal></term>
+<listitem><para>尝试从与 FMRI 相关的服务实例中检索属性 <literal>pkg_secure/ssl_key_passphrase </literal> 的值。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/ssl_key_file</literal></term>
+<listitem><para>(<literal>astring</literal>) PEM 编码的私钥文件的绝对路径名称。此属性必须与 <literal>ssl_cert_file </literal> 属性一起使用。如果同时提供 <literal>/ssl_key_file </literal> 和 <literal>ssl_cert_file</literal>,则库只响应 SSL 请求。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/standalone</literal></term>
+<listitem><para>(<literal>boolean</literal>) 要轻松地通过具有最低 Apache 配置的单个 Apache 实例为多个系统信息库提供服务,请将此属性设置为 <literal>false</literal> 并将此 <literal>pkg/server</literal> 实例的 <literal>pkg/readonly</literal> 属性设置为 <literal>true</literal>。<literal>pkg/standalone</literal> 的缺省值为 <literal>false</literal>,<literal>pkg/readonly</literal> 的缺省值为 <literal>true</literal>。有关更多信息,请参见 <literal>pkg.depot-config</literal>(1M) 手册页。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/threads</literal></term>
+<listitem><para>(<literal>count</literal>) 启动以为请求提供服务的线程数。缺省值为 60。只适用于小型部署。该值应该为并发客户机数量的 20 倍左右。<literal>threads</literal> 的最大值为 5000。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/writable_root</literal></term>
+<listitem><para>(<literal>astring</literal>) 程序对其具有写入访问权限的目录的文件系统路径。此属性可与 <option>readonly</option> 选项一起使用,以便 depot 服务器无需具有对软件包信息的写入访问权限即可创建文件(如搜索索引)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_secure/ssl_key_passphrase</literal></term>
+<listitem><para>(<literal>astring</literal>) 用于对 <literal>pkg/ssl_key_file</literal> 进行解密的口令。该值受读取授权保护(使用属性 <literal>solaris.smf.read.pkg-server</literal>)。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>使用以下属性控制 depot 服务器的浏览器用户界面 (Browser User Interface, BUI) 的显示和行为:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg_bui/feed_description</literal></term>
+<listitem><para>(<literal>astring</literal>) RSS/Atom 源的描述性段落。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_icon</literal></term>
+<listitem><para>(<literal>astring</literal>) 用于以可视方式表示 RSS/Atom 源的小型图像的路径名称。路径名称应相对于 <literal>content_root</literal>。缺省值为 <filename>web/_themes/pkg-block-icon.png</filename>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_logo</literal></term>
+<listitem><para>(<literal>astring</literal>) 将用于以可视方式标记或标识 RSS/Atom 源的大型图像的路径名称。该值应相对于 <literal>content_root</literal>。缺省值为 <filename>web/_themes/pkg-block-icon.png</filename>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_name</literal></term>
+<listitem><para>(<literal>astring</literal>) 由为系统信息库提供服务的库生成的 RSS/Atom 源的简短描述性名称。缺省值为 "package repository feed"。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg_bui/feed_window</literal></term>
+<listitem><para>(<literal>count</literal>) 系统信息库的源最后生成之前的小时数,以包括生成源的时间。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>软件包库还可以用作来自 <literal>pkg</literal>(5) 的本地客户机映像的镜像服务器。这使得在 LAN 上共享一个子网的客户机可以对它们的文件高速缓存进行镜像。客户机可以相互下载文件,从而减少软件包 depot 服务器上的负载。此功能是作为由 SMF 配置的替代 depot 服务提供的。它为服务发现使用 mDNS 和 <literal>dns-sd</literal>。</para>
+<para>mDNS 镜像通常是通过与其服务关联的 SMF 属性配置的。可以识别以下属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>pkg/image_root</literal></term>
+<listitem><para>(<literal>astring</literal>) 其文件信息将用作文件数据高速缓存的映像的路径。缺省值为 <filename>/</filename>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkg/port</literal></term>
+<listitem><para>(<literal>count</literal>) 实例应侦听传入软件包请求的端口号。缺省值为 80。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para><command>pkg.depotd</command> 可从文件或从现有 SMF 服务实例的属性数据读取其基本配置信息。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-cfg</option> <replaceable>source</replaceable></term>
+<listitem><para>指定读取和写入配置数据时要使用的文件的路径名,或格式为 <literal>smf:<replaceable>fmri</replaceable></literal> 的字符串,其中 <replaceable>fmri</replaceable> 是从中读取配置数据的实例的服务故障管理资源标识符 (fault management resource identifier, FMRI)。有关指定文件的格式的详细信息,请参见下文的“库配置”。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>如果没有可用的已存在的配置源,或者要覆盖从使用 <option>-cfg</option> 提供的配置文件中读取的值,则可以使用下列选项来更改 depot 服务器的缺省行为:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>a</option> <replaceable>address</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/address</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-content-root</option> <replaceable>root_dir</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/content_root</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>inst_root</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/inst_root</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-debug</option> <replaceable>feature_list</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/debug</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-disable-ops</option>=<replaceable>op</replaceable>[<literal> /1</literal>][,...]</term>
+<listitem><para>请参见上述 <literal>pkg/disable_ops</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-image-root</option> <replaceable>path</replaceable></term>
+<listitem><para>请参见上面的 <literal>pkg/image_root</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-log-access</option> <replaceable>dest</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/log_access</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-log-errors</option> <replaceable>dest</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/log_errors</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-mirror</option> <replaceable>mode</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/mirror</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/port</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-proxy-base</option> <replaceable>url</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/proxy_base</literal>。如果提供空值,则忽略该选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-readonly</option> <replaceable>mode</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/readonly</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>threads</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/threads</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-sort-file-max-size</option> <replaceable>bytes</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/sort_file_max_size</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-cert-file</option> <replaceable>source</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/ssl_cert_file</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-dialog</option> <replaceable>type</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/ssl_dialog</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-ssl-key-file</option> <replaceable>source</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/ssl_key_file</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>socket_timeout</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/socket_timeout</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-writable-root</option> <replaceable>path</replaceable></term>
+<listitem><para>请参见上述 <literal>pkg/writable_root</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>针对软件包系统信息库的其他管理功能是由 <command>pkgrepo</command> 提供的。</para>
+</refsect1>
+<refsect1 role="other"><title>库配置</title>
+<para>如果使用 <option>-cfg</option> 选项提供了配置文件(而非 SMF FMRI),则 depot 服务器将以简单的文本格式读取和写入所有配置数据。在上述“SMF 属性”中描述了配置数据。配置数据包含各个部分,以 <literal>[<replaceable>section</replaceable>]</literal> 标题开始,后跟 <literal>name = <replaceable>value</replaceable></literal> 条目。后续部分为 RFC 822 样式。可以跨多个行拆分数据,以空格开始后续行即可。</para>
+<para>必须使用上述“选项”中列出的选项提供配置文件中未提供的任何所需值。样例配置文件可能类似如下:</para>
+<programlisting>[pkg]
 port = 80
 inst_root = /export/repo
 
 [pub_example_com]
 feed_description = example.com's software
-  update log
-.fi
-.in -2
-
-.SH 示例
-.LP
-\fB示例 1 \fR启用 depot 服务器
-.sp
-.in +2
-.nf
-# \fBsvcadm enable application/pkg/server\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR更改服务器的侦听端口。
-.sp
-.in +2
-.nf
-# \fBsvccfg -s application/pkg/server setprop pkg/port = 10000\fR
-# \fBsvcadm refresh application/pkg/server\fR
-# \fBsvcadm restart application/pkg/server\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 3 \fR启用镜像
-.sp
-.in +2
-.nf
-# \fBsvcadm enable application/pkg/dynamic-mirror\fR
-.fi
-.in -2
-.sp
-
-.SH 环境变量
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_REPO\fR\fR
-.ad
-.RS 21n
-.rt  
-指定包含要提供的系统信息库的目录。如果指定 \fB-d\fR,则忽略该值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_DEPOT_CONTENT\fR\fR
-.ad
-.RS 21n
-.rt  
-指定包含库提供的静态内容的目录。该目录中应该有列在下方“文件”下的文件,虽然其中的内容可能与提供的缺省内容不同。
-.RE
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 13n
-.rt  
-操作成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 13n
-.rt  
-出现错误。
-.RE
+  update log</programlisting>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>启用 depot 服务器</title>
+<screen># <userinput>svcadm enable application/pkg/server</userinput></screen>
+</example>
+<example id="GLHBM"><title>更改服务器的侦听端口。</title>
+<screen># <userinput>svccfg -s application/pkg/server setprop pkg/port = 10000</userinput>
+# <userinput>svcadm refresh application/pkg/server</userinput>
+# <userinput>svcadm restart application/pkg/server</userinput></screen>
+</example>
+<example id="GLHAW"><title>启用镜像</title>
+<screen># <userinput>svcadm enable application/pkg/dynamic-mirror</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_REPO</envar></term>
+<listitem><para>指定包含要提供的系统信息库的目录。如果指定 <option>d</option>,则忽略该值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_DEPOT_CONTENT</envar></term>
+<listitem><para>指定包含库提供的静态内容的目录。该目录中应该有列在下方“文件”下的文件,虽然其中的内容可能与提供的缺省内容不同。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist termlength="xtranarrow">
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>操作成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>/usr/share/lib/pkg</filename></term>
+<listitem><para>缺省显示内容的位置。修改 <literal>pkg/content_root </literal> 以选择备用位置。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg.depot-config-1m"><citerefentry><refentrytitle>pkg.depot-config</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="dns-sd-1m"><citerefentry><refentrytitle>dns-sd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="MDNSD-1M"><citerefentry><refentrytitle>mdnsd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<literal>syslogd</literal>(1M)、<olink targetdoc="refman" targetptr="SMF-5"><citerefentry><refentrytitle>smf</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP">《<citetitle remap="book">在 Oracle Solaris 11.3 中复制和创建软件包系统信息库</citetitle>》</olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para><literal>pkd.depotd</literal> 服务由 SMF 管理,在服务标识符 <literal>svc:/application/pkg/server</literal> 下。</para>
+<para>mDNS 镜像服务由 <literal>svc:/application/pkg/dynamic-mirror</literal> 服务标识符下的 SMF 管理。</para>
+<para>要控制对库的读取访问权限,可以将 HTTP 反向代理与验证方法(例如 <command>pkg</command> 本身就支持的基于客户机的 SSL 证书访问权限)结合使用。</para>
+<para>要轻松地通过具有最低 Apache 配置的单个 Apache 实例为多个系统信息库提供服务,请将特定 <literal>pkg/server</literal> 实例的 <literal>pkg/standalone</literal> 属性设置为 <literal>false</literal>,并将该实例的 <literal>pkg/readonly</literal> 属性设置为 <literal>true</literal>。有关更多信息,请参见 <literal>pkg.depot-config</literal>(1M) 手册页。</para>
+<para>配置的更改,或使用基于文件系统的操作对软件包数据的更改,需要重新启动 depot 服务器进程,从而使更改能够反映在操作和输出中。使用下列方法之一来重新启动 depot 服务器进程:</para>
+<itemizedlist>
+<listitem><para>使用 <command>svcadm</command> 重新启动 <literal>application/pkg/server</literal> 实例。</para></listitem>
+<listitem><para>使用 <command>kill</command> 向 depot 服务器进程发送一个 <literal>SIGUSR1</literal> 信号。这样可执行正常的重新启动,使进程保持不变,但重新加载所有配置、软件包和搜索数据:</para>
+<screen># <userinput>kill -USR1 <replaceable>pid</replaceable></userinput></screen>
+</listitem>
+</itemizedlist>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 13n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 13n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 文件
-.sp
-.ne 2
-.mk
-.na
-\fB\fB/usr/share/lib/pkg\fR\fR
-.ad
-.sp .6
-.RS 4n
-缺省显示内容的位置。修改 \fBpkg/content_root \fR 以选择备用位置。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg.depot-config\fR(1M)、\fBdns-sd\fR(1M)、\fBmdnsd\fR(1M)、\fBpkg\fR(1)、\fBpkgrepo\fR(1)、\fBpkgsend\fR(1)、\fBsyslogd\fR(1M)、\fBsmf\fR(5)
-.sp
-.LP
-《\fI《Copying and Creating Package Repositories in Oracle Solaris 11.2》\fR》
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 附注
-.sp
-.LP
-\fBpkd.depotd\fR 服务由 SMF 管理,在服务标识符 \fBsvc:/application/pkg/server\fR 下。
-.sp
-.LP
-mDNS 镜像服务由 \fBsvc:/application/pkg/dynamic-mirror\fR 服务标识符下的 SMF 管理。
-.sp
-.LP
-要控制对库的读取访问权限,可以将 HTTP 反向代理与验证方法(例如 \fBpkg\fR 本身就支持的基于客户机的 SSL 证书访问权限)结合使用。
-.sp
-.LP
-要轻松地通过具有最低 Apache 配置的单个 Apache 实例为多个系统信息库提供服务,请将特定 \fBpkg/server\fR 实例的 \fBpkg/standalone\fR 属性设置为 \fBfalse\fR,并将该实例的 \fBpkg/readonly\fR 属性设置为 \fBtrue\fR。有关更多信息,请参见 \fBpkg.depot-config\fR(1M) 手册页。
-.sp
-.LP
-配置的更改,或使用基于文件系统的操作对软件包数据的更改,需要重新启动 depot 服务器进程,从而使更改能够反映在操作和输出中。使用下列方法之一来重新启动 depot 服务器进程:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-使用 \fBsvcadm\fR 重新启动 \fBapplication/pkg/server\fR 实例。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-使用 \fBkill\fR 向 depot 服务器进程发送一个 \fBSIGUSR1\fR 信号。这样可执行正常的重新启动,使进程保持不变,但重新加载所有配置、软件包和搜索数据:
-.sp
-.in +2
-.nf
-# \fBkill -USR1 \fIpid\fR\fR
-.fi
-.in -2
-.sp
-
-.RE
--- a/src/man/zh_CN/pkg.sysrepo.1m	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkg.sysrepo.1m	Wed Jul 01 10:45:55 2015 -0700
@@ -1,171 +1,115 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkg.sysrepo 1M "2013 年 5 月 21 日" "SunOS 5.11" "系统管理命令"
-.SH 名称
-pkg.sysrepo \- 映像包管理系统的系统信息库配置
-.SH 用法概要
-.LP
-.nf
-/usr/lib/pkg.sysrepo -p \fIport\fR [-c \fIcache_dir\fR] [-s \fIcache_size\fR]
-    [-w \fIhttp_proxy\fR] [-W \fIhttps_proxy\fR]
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpkg.sysrepo\fR 用于生成映像包管理系统 (Image Packaging System, IPS) 系统信息库的配置文件。\fBpkg.sysrepo \fR 由 \fBsvc:/application/pkg/system-repository\fR 服务管理工具 (Service Management Facility, SMF) 服务调用。应对 SMF 服务中的属性进行配置更改。
-.sp
-.LP
-系统信息库负责提供对通过集中代理在参考映像中配置的软件包系统信息库的访问权限。配置为使用系统信息库的任何客户机可立即看到对该参考映像所做的发布者配置更改。
-.sp
-.LP
-系统信息库主要用于全局区域,以允许非全局区域访问在全局区域中配置的系统信息库。SMF 服务 \fBsvc:/application/pkg/zones-proxyd\fR 和 \fB svc:/application/pkg/zones-proxy-client\fR 负责提供非全局区域和全局区域之间的传输。只有 \fBpkg\fR(5) 使用该传输。
-.sp
-.LP
-请注意,只有 \fBhttp\fR、\fBhttps\fR 和 \fBv4\fR 文件系统信息库以及 \fBp5p\fR 归档受支持。较旧的文件系统信息库格式不受支持。有关系统信息库版本的更多信息,请参见 \fBpkgrepo\fR(1)。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定系统信息库在缓存来自所配置的发布者的响应时应使用的目录的绝对路径。
-.sp
-缺省情况下,使用文件高速缓存。但是,可以使用特殊值 \fBmemory \fR 来表示应使用内存高速缓存。特殊值 \fBNone\fR 可用于表示系统信息库不应执行任何缓存。应使用 \fBconfig/cache_dir\fR SMF 属性配置该设置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIport\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定系统信息库应当用来侦听请求的端口。应使用 \fBconfig/port\fR SMF 属性配置该设置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIcache_size\fR\fR
-.ad
-.sp .6
-.RS 4n
-定义系统信息库的最大高速缓存大小的整数值 (MB)。应使用 \fB config/cache_max\fR SMF 属性配置该设置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-w\fR \fIhttp_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB\fIscheme\fR://\fIhostname\fR[:\fIport\fR]\fR 格式的字符串,用于定义一个 Web 代理服务器,系统信息库可以使用该 Web 代理服务器来访问基于 http 的软件包系统信息库。可以使用 \fBconfig/http_proxy\fR SMF 属性配置此设置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-W\fR \fIhttps_proxy\fR\fR
-.ad
-.sp .6
-.RS 4n
-\fB\fIscheme\fR://\fI hostname\fR[:\fIport\fR]\fR 格式的字符串,用于定义一个 Web 代理服务器,系统信息库可以使用该 Web 代理服务器来访问基于 https 的软件包系统信息库。可以使用 \fBconfig/https_proxy\fR SMF 属性配置此设置。
-.RE
+<?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;
+]>
 
-.SH 示例
-.LP
-\fB示例 1 \fR启用系统信息库
-.sp
-.in +2
-.nf
-$ \fBsvcadm enable svc:/application/pkg/system-repository\fR
-.fi
-.in -2
-.sp
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-命令无法写入有效配置。
-.RE
+<refentry lang="zh" id="pkg.sysrepo-1m">
+<refmeta><refentrytitle>pkg.sysrepo</refentrytitle><manvolnum>1M</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1m;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkg.sysrepo</refname><refpurpose>映像包管理系统的系统信息库配置</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/lib/pkg.sysrepo -p <replaceable>port</replaceable> [-c <replaceable>
+cache_dir</replaceable>] [-s <replaceable>cache_size</replaceable>]
+    [-w <replaceable>http_proxy</replaceable>] [-W <replaceable>https_proxy</replaceable>]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgsysrepo-1m-desc" role="description"><title></title>
+<para><command>pkg.sysrepo</command> 用于生成映像包管理系统 (Image Packaging System, IPS) 系统信息库的配置文件。<command>pkg.sysrepo </command> 由 <literal>svc:/application/pkg/system-repository</literal> 服务管理工具 (Service Management Facility, SMF) 服务调用。应对 SMF 服务中的属性进行配置更改。</para>
+<para>系统信息库负责提供对通过集中代理在参考映像中配置的软件包系统信息库的访问权限。配置为使用系统信息库的任何客户机可立即看到对该参考映像所做的发布者配置更改。</para>
+<para>系统信息库主要用于全局区域,以允许非全局区域访问在全局区域中配置的系统信息库。SMF 服务 <literal>svc:/application/pkg/zones-proxyd</literal> 和 <literal> svc:/application/pkg/zones-proxy-client</literal> 负责提供非全局区域和全局区域之间的传输。只有 <literal>pkg</literal>(5) 使用该传输。</para>
+<para>请注意,只有 <literal>http</literal>、<literal>https</literal> 和 <literal>v4</literal> 文件系统信息库以及 <literal>p5p</literal> 归档受支持。较旧的文件系统信息库格式不受支持。有关系统信息库版本的更多信息,请参见 <command>pkgrepo</command>(1)。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>支持以下选项:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>指定系统信息库在缓存来自所配置的发布者的响应时应使用的目录的绝对路径。</para>
+<para>缺省情况下,使用文件高速缓存。但是,可以使用特殊值 <literal>memory </literal> 来表示应使用内存高速缓存。特殊值 <literal>None</literal> 可用于表示系统信息库不应执行任何缓存。应使用 <literal>config/cache_dir</literal> SMF 属性配置该设置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>port</replaceable></term>
+<listitem><para>指定系统信息库应当用来侦听请求的端口。应使用 <literal>config/port</literal> SMF 属性配置该设置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>cache_size</replaceable></term>
+<listitem><para>定义系统信息库的最大高速缓存大小的整数值 (MB)。应使用 <literal> config/cache_max</literal> SMF 属性配置该设置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>w</option> <replaceable>http_proxy</replaceable></term>
+<listitem><para><literal><replaceable>scheme</replaceable>://<replaceable>hostname</replaceable>[:<replaceable>port</replaceable>]</literal> 格式的字符串,用于定义一个 Web 代理服务器,系统信息库可以使用该 Web 代理服务器来访问基于 http 的软件包系统信息库。可以使用 <literal>config/http_proxy</literal> SMF 属性配置此设置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>W</option> <replaceable>https_proxy</replaceable></term>
+<listitem><para><literal><replaceable>scheme</replaceable>://<replaceable> hostname</replaceable>[:<replaceable>port</replaceable>]</literal> 格式的字符串,用于定义一个 Web 代理服务器,系统信息库可以使用该 Web 代理服务器来访问基于 https 的软件包系统信息库。可以使用 <literal>config/https_proxy</literal> SMF 属性配置此设置。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>启用系统信息库</title>
+<screen>$ <userinput>svcadm enable svc:/application/pkg/system-repository</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>命令无法写入有效配置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(1)、\fBpkg.depotd\fR(1M)、\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/zh_CN/pkgdepend.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgdepend.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,416 +1,186 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgdepend 1 "2013 年 7 月 12 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgdepend \- 映像包管理系统依赖项分析器
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgdepend [\fIoptions\fR] \fIcommand\fR [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgdepend generate [-IMm] -d \fIdir\fR [-d \fIdir\fR]
-    [-D \fIname\fR=\fIvalue\fR] [-k \fIpath\fR] \fImanifest_file\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgdepend resolve [-EmoSv] [-d \fIoutput_dir\fR]
-    [-e \fIexternal_package_file\fR]... [-s \fIsuffix\fR]
-    \fImanifest_file\fR ...
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpkgdepend\fR 命令生成并解析软件包的依赖项。某个软件包可能会依赖于其他软件包中的文件。\fBpkgdepend\fR 命令通常使用两次:一次用于文件依赖项生成和一次用于文件到软件包的解析。
-.sp
-.LP
-\fBgenerate\fR 子命令将检查软件包的内容,并确定该软件包所需的外部文件。
-.sp
-.LP
-\fBresolve\fR 子命令使用执行 \fBgenerate\fR 步骤后输出的文件列表,然后搜索软件包的引用集来确定包含这些依赖文件的软件包的名称。为依赖文件搜索的软件包的引用集为当前在发布者的系统上安装的软件包。
-.sp
-.LP
-提供的文件的多个组件用作依赖项信息的源:
-.sp
-.ne 2
-.mk
-.na
-\fBELF\fR
-.ad
-.RS 13n
-.rt  
-分析提供的文件中的 ELF 头以获取依赖项信息,\fB-k\fR 和 \fB-D\fR 选项可用于修改获取的信息。有关 ELF 依赖项的更多详细信息,请参见 \fBldd\fR 和\fI《Oracle Solaris 11.2 Linkers and Libraries Guide》\fR。 
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB脚本\fR
-.ad
-.RS 13n
-.rt  
-包含引用某个解释程序的 \fB#!\fR 行的 Shell 脚本会导致对提供该解释程序的程序包出现依赖项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBPython\fR
-.ad
-.RS 13n
-.rt  
-Python 脚本首先作为脚本进行分析。此外,脚本声明的任何导入可能还会充当依赖项信息的源。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB硬链接\fR
-.ad
-.RS 13n
-.rt  
-清单中的硬链接会导致对提供链接目标的软件包出现依赖项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fBSMF\fR
-.ad
-.RS 13n
-.rt  
-提供的包含 \fBrequire_all \fR 依赖项的 SMF 服务清单会导致对提供 SMF 清单(这些清单提供这些 FMRI)的软件包出现依赖项。
-.RE
-
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-对根目录为 \fIdir\fR 的映像进行操作。如果未根据环境指定或确定目录,则缺省值为 /。有关更多信息,请参见“环境变量”部分。
-.RE
-
-.SH 子命令
-.sp
-.LP
-支持以下子命令:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgdepend generate\fR [\fB-IMm\fR] \fB- d\fR \fIdir\fR [\fB-d\fR \fIdir\fR] [\fB-D\fR \fIname\fR=\fIvalue\fR] [\fB-k\fR \fIpath\fR] \fImanifest_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-生成由 \fImanifest_file\fR 指定的清单文件的依赖项。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示 \fImanifest_file\fR 中满足条件的依赖项。请勿使用带 \fB-I\fR 选项的 \fBpkgdepend resolve\fR 命令产生的结果。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-M\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示无法分析的文件类型的列表。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-重复显示原始清单,并在其后添加发现的任何依赖项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-将 \fIdir\fR 添加到搜索清单文件的目录列表。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-D\fR \fIname\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-添加 \fIvalue\fR,将其作为在 ELF 文件依赖项的运行路径中扩展标记 \fIname\fR 的一种方法。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIpath\fR\fR
-.ad
-.sp .6
-.RS 4n
-将 \fIpath\fR 添加到搜索内核模块的运行路径列表。使用 \fB-k\fR 选项会删除缺省路径 \fB/kernel\fR 和 \fB/usr/kernel\fR。
-.sp
-运行路径(例如 \fB-k\fR 选项指定的那些运行路径)也可以通过使用操作或清单属性 \fBpkg.depend.runpath\fR 来按操作或清单指定。\fBpkg.depend.runpath \fR 属性的值是要使用的路径的冒号分隔字符串。在清单或操作中设置任何 \fBpkg.depend.runpath\fR 属性时均会覆盖使用 \fB-k\fR 选项指定的路径。
-.sp
-特殊标记 \fB$PKGDEPEND_RUNPATH\fR 可用作 \fBpkg.depend.runpath\fR 属性值的一个组件,以包括所分析文件的标准系统运行路径。
-.RE
+<?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;
+]>
 
-在某些情况下,您可能需要防止自动生成依赖项。例如,如果软件包提供了一个用于导入一组模块的样例 Python 脚本,则该样例脚本导入的那些模块不是提供该样例脚本的软件包的依赖项。使用操作或清单属性 \fBpkg.depend.bypass-generate\fR 可以防止针对指定的文件生成依赖项。
-.sp
-\fBpkg.depend.bypass-generate\fR 值是与文件名匹配的 Python 正则表达式。正则表达式隐式固定在文件路径的开头和结尾。以下示例中提供的值与 \fBthis/that\fR 匹配,但与 \fBsomething/this/that/the/other\fR 不匹配。
-.sp
-.in +2
-.nf
-pkg.depend.bypass-generate=this/that
-.fi
-.in -2
-
-有关 Python 正则表达式语法的更多信息,请使用命令 \fBpydoc re\fR 或参见 \fBhttp://docs.python.org/dev/howto/regex.html\fR 中更为完整的文档。
-.sp
-当 \fBpkgdepend generate\fR 输入清单包含 SMF 清单文件时,由这些 SMF 清单文件声明的任何 SMF 服务或实例都将包括在 \fBpkgdepend\fR 输出中。这些 SMF 服务或实例以名称为 \fBorg.opensolaris.smf.fmri\fR 的 \fBset\fR 操作的形式包括在输出中。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgdepend resolve\fR [\fB-EmoSv\fR] [\fB-d\fR \fIoutput_dir\fR] [\fB-e\fR \fI external_package_file\fR]... [\fB-s\fR \fIsuffix\fR] \fI manifest_file\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-将文件中的依赖项转换为提供这些文件的软件包中的依赖项。先根据命令行中给定的清单解析依赖项,然后再根据系统上安装的软件包进行解析。缺省情况下,每个清单的依赖项放置在名为 \fB\fImanifest_file\fR.res\fR 的文件中。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-e\fR \fIexternal_package_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅从其名称与 \fIexternal_package_file\fR 中的模式相匹配的系统针对软件包进行解析。可以多次指定此选项。\fB-e\fR 选项不能与 \fB-S\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-E\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果指定 \fB-e\fR,则显示应当是外部依赖项但却不是外部依赖项的软件包。应当是外部依赖项的软件包是来自其名称与 \fIexternal_package_file\fR 中的模式相匹配的系统的那些软件包。
-.sp
-如果未指定 \fB-e\fR,则显示已解析软件包的外部依赖项。已解析软件包的外部依赖项是未在命令行上命名的那些软件包,是已解析软件包中依赖项的目标。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-将重复清单,删除 \fBgenerate\fR 步骤生成的任何依赖项,然后添加已解析的依赖项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR\fR
-.ad
-.sp .6
-.RS 4n
-将结果写入到标准输出。该选项旨在供用户使用。将此输出附加到某个文件可能会导致产生无效的清单。在用于清单处理的管道中使用时,强烈建议使用 \fB-d\fR 或 \fB-s\fR 选项,而不要使用 \fB-o\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIoutput_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-将单独文件中提供的每个清单的已解析依赖项写入 \fIoutput_dir\fR 中。缺省情况下,每个文件与清单(该清单是写入该文件的依赖项的源)具有相同的基名。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIsuffix\fR\fR
-.ad
-.sp .6
-.RS 4n
-对于每个输出文件,将 \fIsuffix\fR 附加到文件(该文件是解析的依赖项的源)的基名。如果 \fIsuffix\fR 不是 \fI\&.suffix\fR 格式,则会将句点 (.) 附加到 \fIsuffix\fR 的前面。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-S\fR\fR
-.ad
-.sp .6
-.RS 4n
-只根据命令行上指定的清单进行解析,而不根据系统上安装的清单进行解析。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-将包括其他软件包依赖项调试元数据。
-.RE
-
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR生成依赖项
-.sp
-.LP
-为 \fBfoo\fR 中写入的清单(其内容目录在 \fB\&./bar/baz\fR 中)生成依赖项,并将结果存储在 \fBfoo fdeps\fR 中。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d ./bar/baz foo > foo.fdeps\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR解析依赖项
-.sp
-.LP
-根据彼此的情况和当前系统上安装的软件包来解析 \fBfoo.fdeps\fR 和 \fB bar.fdeps\fR 中的文件依赖项。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend resolve foo.fdeps bar.fdeps\fR
-$ \fBls *.res\fR
-foo.fdeps.res    bar.fdeps.res
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 3 \fR生成并解析两个清单的依赖项
-.sp
-.LP
-生成两个清单(\fBfoo\fR 和 \fB bar\fR)的文件依赖项,并保留原始清单中的所有信息。然后解析文件依赖项,并将生成的清单放置在 \fB\&./res \fR中。这些生成的清单可以和 \fBpkgsend publish\fR 一起使用。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d /proto/foo -m foo > ./deps/foo\fR
-$ \fBpkgdepend generate -d /proto/bar -m bar > ./deps/bar\fR
-$ \fBpkgdepend resolve -m -d ./res ./deps/foo ./deps/bar\fR
-$ \fBls ./res\fR
-foo    bar
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 4 \fR将值添加到 ELF 文件依赖项的标记
-.sp
-.LP
-在为 \fBfoo\fR 中写入的清单(其内容目录在 / 中)生成依赖项时,将 ELF 文件中运行路径内的所有 \fBPLATFORM\fR 标记替换为 \fBsun4v\fR 和 \fBsun4u\fR。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d / -D 'PLATFORM=sun4v' \e\fR
-\fB-D 'PLATFORM=sun4u' foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 5 \fR指定内核模块目录
-.sp
-.LP
-在为 \fB foo\fR 中写入的清单(其内容目录在 / 中)生成依赖项时,将 \fB/kmod\fR 指定为要在其中查找内核模块的目录。
-
-.sp
-.in +2
-.nf
-$ \fBpkgdepend generate -d / -k /kmod foo\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 6 \fR绕过依赖项生成
-.sp
-.LP
-将 \fBopt/python\fR 附加到给定 Python 脚本的标准 Python 运行路径,然后根据名称为 \fBtest\fR 的所有 Python 模块绕过作为 \fBopt/python/foo/file.py \fR 提供的文件的依赖项生成。
-
-.sp
-.LP
-避免针对 \fBusr/lib/python2.6/vendor-packages/xdg \fR 中提供的任何文件生成依赖项。
-
-.sp
-.in +2
-.nf
-$ \fBcat manifest.py\fR
+<refentry lang="zh" id="pkgdepend-1">
+<refmeta><refentrytitle>pkgdepend</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2015 年 1 月 28 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgdepend</refname><refpurpose>映像包管理系统依赖项分析器</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgdepend [<replaceable>options</replaceable>] <replaceable>command
+</replaceable> [<replaceable>cmd_options</replaceable>] [<replaceable>operands</replaceable>]
+</synopsis>
+<synopsis>/usr/bin/pkgdepend generate [-IMm] -d <replaceable>dir</replaceable> [-d <replaceable>
+dir</replaceable>]
+    [-D <replaceable>name</replaceable>=<replaceable>value</replaceable>] [-k <replaceable>
+path</replaceable>] <replaceable>manifest_file</replaceable></synopsis>
+<synopsis>/usr/bin/pkgdepend resolve [-EmoSv] [-d <replaceable>output_dir</replaceable>]
+    [-e <replaceable>external_package_file</replaceable>]... [-s <replaceable>suffix
+</replaceable>]
+    <replaceable>manifest_file</replaceable> ...</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgdepend-1-desc" role="description"><title></title>
+<para><command>pkgdepend</command> 命令生成并解析软件包的依赖项。某个软件包可能会依赖于其他软件包中的文件。<command>pkgdepend</command> 命令通常使用两次:一次用于文件依赖项生成和一次用于文件到软件包的解析。</para>
+<para><command>generate</command> 子命令将检查软件包的内容,并确定该软件包所需的外部文件。</para>
+<para><command>resolve</command> 子命令使用执行 <command>generate</command> 步骤后输出的文件列表,然后搜索软件包的引用集来确定包含这些依赖文件的软件包的名称。为依赖文件搜索的软件包的引用集为当前在发布者的系统上安装的软件包。</para>
+<para>提供的文件的多个组件用作依赖项信息的源:</para>
+<variablelist>
+<varlistentry><term>ELF</term>
+<listitem><para>分析提供的文件中的 ELF 头以获取依赖项信息,<option>k</option> 和 <option>D</option> 选项可用于修改获取的信息。有关 ELF 依赖项的更多详细信息,请参见 <command>ldd</command> 和<olink targetdoc="OSLLG">《<citetitle remap="book">Oracle Solaris 11.3 链接程序和库指南</citetitle>》</olink>。 </para>
+</listitem>
+</varlistentry>
+<varlistentry><term>脚本</term>
+<listitem><para>包含引用某个解释程序的 <literal>#!</literal> 行的 Shell 脚本会导致对提供该解释程序的程序包出现依赖项。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>Python</term>
+<listitem><para>Python 脚本首先作为脚本进行分析。此外,脚本声明的任何导入可能还会充当依赖项信息的源。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>硬链接</term>
+<listitem><para>清单中的硬链接会导致对提供链接目标的软件包出现依赖项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>SMF</term>
+<listitem><para>提供的包含 <literal>require_all </literal> 依赖项的 SMF 服务清单会导致对提供 SMF 清单(这些清单提供这些 FMRI)的软件包出现依赖项。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</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>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>支持以下子命令:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgdepend generate</command> [<option>IMm</option>] <option> d</option> <replaceable>dir</replaceable> [<option>d</option> <replaceable>dir</replaceable>] [<option>D</option> <replaceable>name</replaceable>=<replaceable>value</replaceable>] [<option>k</option> <replaceable>path</replaceable>] <replaceable>manifest_file</replaceable></term>
+<listitem><para>生成由 <replaceable>manifest_file</replaceable> 指定的清单文件的依赖项。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>I</option></term>
+<listitem><para>显示 <replaceable>manifest_file</replaceable> 中满足条件的依赖项。请勿使用带 <option>I</option> 选项的 <command>pkgdepend resolve</command> 命令产生的结果。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>M</option></term>
+<listitem><para>显示无法分析的文件类型的列表。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option></term>
+<listitem><para>重复显示原始清单,并在其后添加发现的任何依赖项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>dir</replaceable></term>
+<listitem><para>将 <replaceable>dir</replaceable> 添加到搜索清单文件的目录列表。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>D</option> <replaceable>name</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>添加 <replaceable>value</replaceable>,将其作为在 ELF 文件依赖项的运行路径中扩展标记 <replaceable>name</replaceable> 的一种方法。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>path</replaceable></term>
+<listitem><para>将 <replaceable>path</replaceable> 添加到搜索内核模块的运行路径列表。使用 <option>k</option> 选项会删除缺省路径 <filename>/kernel</filename> 和 <filename>/usr/kernel</filename>。</para>
+<para>运行路径(例如 <option>k</option> 选项指定的那些运行路径)也可以通过使用操作或清单属性 <literal>pkg.depend.runpath</literal> 来按操作或清单指定。<literal>pkg.depend.runpath </literal> 属性的值是要使用的路径的冒号分隔字符串。在清单或操作中设置任何 <literal>pkg.depend.runpath</literal> 属性时均会覆盖使用 <option>k</option> 选项指定的路径。</para>
+<para>特殊标记 <envar>$PKGDEPEND_RUNPATH</envar> 可用作 <literal>pkg.depend.runpath</literal> 属性值的一个组件,以包括所分析文件的标准系统运行路径。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>在某些情况下,您可能需要防止自动生成依赖项。例如,如果软件包提供了一个用于导入一组模块的样例 Python 脚本,则该样例脚本导入的那些模块不是提供该样例脚本的软件包的依赖项。使用操作或清单属性 <literal>pkg.depend.bypass-generate</literal> 可以防止针对指定的文件生成依赖项。</para>
+<para><literal>pkg.depend.bypass-generate</literal> 值是与文件名匹配的 Python 正则表达式。正则表达式隐式固定在文件路径的开头和结尾。以下示例中提供的值与 <literal>this/that</literal> 匹配,但与 <literal>something/this/that/the/other</literal> 不匹配。</para>
+<programlisting>pkg.depend.bypass-generate=this/that</programlisting>
+<para>有关 Python 正则表达式语法的更多信息,请使用命令 <command>pydoc re</command> 或参见 <literal>http://docs.python.org/dev/howto/regex.html</literal> 中更为完整的文档。</para>
+<para>当 <command>pkgdepend generate</command> 输入清单包含 SMF 清单文件时,由这些 SMF 清单文件声明的任何 SMF 服务或实例都将包括在 <command>pkgdepend</command> 输出中。这些 SMF 服务或实例以名称为 <literal>org.opensolaris.smf.fmri</literal> 的 <literal>set</literal> 操作的形式包括在输出中。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgdepend resolve</command> [<option>EmoSv</option>] [<option>d</option> <replaceable>output_dir</replaceable>] [<option>e</option> <replaceable> external_package_file</replaceable>]... [<option>s</option> <replaceable>suffix</replaceable>] <replaceable> manifest_file</replaceable> ...</term>
+<listitem><para>将文件中的依赖项转换为提供这些文件的软件包中的依赖项。先根据命令行中给定的清单解析依赖项,然后再根据系统上安装的软件包进行解析。缺省情况下,每个清单的依赖项放置在名为 <filename><replaceable>manifest_file</replaceable>.res</filename> 的文件中。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>e</option> <replaceable>external_package_file</replaceable></term>
+<listitem><para>仅从其名称与 <replaceable>external_package_file</replaceable> 中的模式相匹配的系统针对软件包进行解析。可以多次指定此选项。<option>e</option> 选项不能与 <option>S</option> 选项一起使用。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>E</option></term>
+<listitem><para>如果指定 <option>e</option>,则显示应当是外部依赖项但却不是外部依赖项的软件包。应当是外部依赖项的软件包是来自其名称与 <replaceable>external_package_file</replaceable> 中的模式相匹配的系统的那些软件包。
+</para>
+<para>如果未指定 <option>e</option>,则显示已解析软件包的外部依赖项。已解析软件包的外部依赖项是未在命令行上命名的那些软件包,是已解析软件包中依赖项的目标。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option></term>
+<listitem><para>将重复清单,删除 <command>generate</command> 步骤生成的任何依赖项,然后添加已解析的依赖项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option></term>
+<listitem><para>将结果写入到标准输出。该选项旨在供用户使用。将此输出附加到某个文件可能会导致产生无效的清单。在用于清单处理的管道中使用时,强烈建议使用 <option>d</option> 或 <option>s</option> 选项,而不要使用 <option>o</option>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>output_dir</replaceable></term>
+<listitem><para>将单独文件中提供的每个清单的已解析依赖项写入 <replaceable>output_dir</replaceable> 中。缺省情况下,每个文件与清单(该清单是写入该文件的依赖项的源)具有相同的基名。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>suffix</replaceable></term>
+<listitem><para>对于每个输出文件,将 <replaceable>suffix</replaceable> 附加到文件(该文件是解析的依赖项的源)的基名。如果 <replaceable>suffix</replaceable> 不是 <replaceable>.suffix</replaceable> 格式,则会将句点 (.) 附加到 <replaceable>suffix</replaceable> 的前面。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>S</option></term>
+<listitem><para>只根据命令行上指定的清单进行解析,而不根据系统上安装的清单进行解析。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>将包括其他软件包依赖项调试元数据。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>生成依赖项</title>
+<para>为 <filename>foo</filename> 中写入的清单(其内容目录在 <filename>./bar/baz</filename> 中)生成依赖项,并将结果存储在 <filename>foo fdeps</filename> 中。</para>
+<screen>$ <userinput>pkgdepend generate -d ./bar/baz foo > foo.fdeps</userinput></screen>
+</example>
+<example><title>解析依赖项</title>
+<para>根据彼此的情况和当前系统上安装的软件包来解析 <filename>foo.fdeps</filename> 和 <filename> bar.fdeps</filename> 中的文件依赖项。</para>
+<screen>$ <userinput>pkgdepend resolve foo.fdeps bar.fdeps</userinput>
+$ <userinput>ls *.res</userinput>
+foo.fdeps.res    bar.fdeps.res</screen>
+</example>
+<example><title>生成并解析两个清单的依赖项</title>
+<para>生成两个清单(<literal>foo</literal> 和 <literal> bar</literal>)的文件依赖项,并保留原始清单中的所有信息。然后解析文件依赖项,并将生成的清单放置在 <filename>./res </filename>中。这些生成的清单可以和 <command>pkgsend publish</command> 一起使用。
+</para>
+<screen>$ <userinput>pkgdepend generate -d /proto/foo -m foo > ./deps/foo</userinput>
+$ <userinput>pkgdepend generate -d /proto/bar -m bar > ./deps/bar</userinput>
+$ <userinput>pkgdepend resolve -m -d ./res ./deps/foo ./deps/bar</userinput>
+$ <userinput>ls ./res</userinput>
+foo    bar</screen>
+</example>
+<example><title>将值添加到 ELF 文件依赖项的标记</title>
+<para>在为 <literal>foo</literal> 中写入的清单(其内容目录在 / 中)生成依赖项时,将 ELF 文件中运行路径内的所有 <envar>PLATFORM</envar> 标记替换为 <literal>sun4v</literal> 和 <literal>sun4u</literal>。</para>
+<screen>$ <userinput>pkgdepend generate -d / -D 'PLATFORM=sun4v' &bsol;</userinput>
+<userinput>-D 'PLATFORM=sun4u' foo</userinput></screen>
+</example>
+<example><title>指定内核模块目录</title>
+<para>在为 <filename> foo</filename> 中写入的清单(其内容目录在 / 中)生成依赖项时,将 <filename>/kmod</filename> 指定为要在其中查找内核模块的目录。</para>
+<screen>$ <userinput>pkgdepend generate -d / -k /kmod foo</userinput></screen>
+</example>
+<example><title>绕过依赖项生成</title>
+<para>将 <filename>opt/python</filename> 附加到给定 Python 脚本的标准 Python 运行路径,然后根据名称为 <literal>test</literal> 的所有 Python 模块绕过作为 <filename>opt/python/foo/file.py </filename> 提供的文件的依赖项生成。</para>
+<para>避免针对 <filename>usr/lib/python2.7/vendor-packages/xdg</filename> 中提供的任何文件生成依赖项。</para>
+<screen>$ <userinput>cat manifest.py</userinput>
 set name=pkg.fmri value=pkg:/[email protected],1.0
 set name=pkg.summary value="My test package"
 dir path=opt mode=0755 group=sys owner=root
@@ -421,101 +191,81 @@
 #
 # Add runpath and bypass-generate attributes:
 #
-file path=opt/python/foo/file.py mode=0644 group=sys owner=root \e
-    pkg.depend.bypass-generate=.*/test.py.* \e
-    pkg.depend.bypass-generate=.*/testmodule.so \e
-    pkg.depend.bypass-generate=.*/test.so \e
-    pkg.depend.bypass-generate=usr/lib/python2.6/vendor-packages/xdg/.* \e
+file path=opt/python/foo/file.py mode=0644 group=sys owner=root &bsol;
+    pkg.depend.bypass-generate=.*/test.py.* &bsol;
+    pkg.depend.bypass-generate=.*/testmodule.so &bsol;
+    pkg.depend.bypass-generate=.*/test.so &bsol;
+    pkg.depend.bypass-generate=usr/lib/python2.7/vendor-packages/xdg/.* &bsol;
     pkg.depend.runpath=$PKGDEPEND_RUNPATH:/opt/python
 
-$ \fBpkgdepend generate -d proto manifest.py\fR
-.fi
-.in -2
-.sp
-
-.SH 环境变量
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_IMAGE\fR\fR
-.ad
-.RS 13n
-.rt  
-指定包含要用于软件包操作的映像的目录。如果指定 \fB-R\fR,则忽略该值。
-.RE
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-一切正常工作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-出现错误。
-.RE
+$ <userinput>pkgdepend generate -d proto manifest.py</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_IMAGE</envar></term>
+<listitem><para>指定包含要用于软件包操作的映像的目录。如果指定 <option>R</option>,则忽略该值。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>一切正常工作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg </refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/zh_CN/pkgdiff.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgdiff.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,218 +1,136 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgdiff 1 "2013 年 2 月 26 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgdiff \- 比较软件包清单
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgdiff [-i \fIattribute\fR]... [-o \fIattribute\fR]
-    [-t \fIaction_name\fR[,\fIaction_name\fR]...]...
-    [-v \fIname\fR=\fIvalue\fR]... (\fIfile1\fR | -) (\fIfile2\fR | -)
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpkgdiff\fR 比较两个软件包清单并报告差异。其中一个清单可从 \fBstdin\fR(在文件名位置指定 \fB-\fR)读取。\fBpkgdiff\fR 在比较之前会将每个清单和操作按一致的顺序排序。
-.sp
-.LP
-输出采用以下格式:
-.sp
-.ne 2
-.mk
-.na
-\fB+ \fIcomplete_action\fR\fR
-.ad
-.sp .6
-.RS 4n
-此操作在 \fIfile2\fR 中而不在 \fIfile1\fR 中。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB- \fIcomplete_action\fR\fR
-.ad
-.sp .6
-.RS 4n
-此操作在 \fIfile1\fR 中而不在 \fIfile2\fR 中。
-.RE
-
-.sp
-.in +2
-.nf
-\fIactionname\fR \fIkeyvalue\fR [\fIvariant values, if any\fR]
-.fi
-.in -2
-
-.sp
-.ne 2
-.mk
-.na
-\fB- \fIattribute1\fR=\fIvalue1\fR\fR
-.ad
-.sp .6
-.RS 4n
-此 \fIattribute\fR,\fIvalue\fR 在 \fIfile1\fR 中而不在 \fIfile2\fR 中。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB+ \fIattribute2\fR=\fIvalue2\fR\fR
-.ad
-.sp .6
-.RS 4n
-此 \fIattribute\fR,\fIvalue\fR 在 \fIfile2\fR 中而不在 \fIfile1\fR 中。
-.RE
-
-.sp
-.LP
-为了完成比较,带有不同变体、但带有相同类型和关键属性值的操作将被视为不同的操作。因此,可更改属性的操作将以其完整格式显示,而不是作为属性更改显示。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-比较期间将忽略 \fIattribute\fR(如果存在)。可以使用 \fB-i\fR\fI hash\fR 忽略文件散列值。该选项不能与 \fB-o\fR 选项一起使用。可以多次指定此选项。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-o\fR \fIattribute\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅报告 \fIattribute\fR 的差异。该选项不能与 \fB-i\fR 选项一起使用。该选项会省略不影响操作 \fIattribute\fR 的任何操作更改。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR[,\fIaction_name\fR]...\fR
-.ad
-.sp .6
-.RS 4n
-仅比较指定的操作。可以在一个逗号分隔的列表中指定多个操作。\fIaction_name\fR 的值是 \fBpkg\fR(5) 手册页的“操作”中列出的操作之一。例如,可以为 \fIaction_name\fR 指定以下值:\fBfile\fR、\fBdir\fR、\fBdriver\fR、\fBdepend\fR、\fBset\fR。可以多次指定此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR \fIname\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅计算该变体值的差异。例如,只计算 \fBarch=sparc\fR 的差异。在进行比较之前,将删除所有操作的该变体标记。只能为每个变体指定一个值。可以为不同变体多次指定此选项。
-.RE
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-未找到差异。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-找到了差异。
-.RE
+<refentry lang="zh" id="pkgdiff-1">
+<refmeta><refentrytitle>pkgdiff</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 2 月 26 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgdiff</refname><refpurpose>比较软件包清单</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgdiff [-i <replaceable>attribute</replaceable>]... [-o <replaceable>attribute</replaceable>]
+    [-t <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]...
+    [-v <replaceable>name</replaceable>=<replaceable>value</replaceable>]... (<replaceable>file1</replaceable> | -) (<replaceable>file2</replaceable> | -)
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgdiff-1-desc" role="description"><title></title>
+<para><command>pkgdiff</command> 比较两个软件包清单并报告差异。其中一个清单可从 <literal>stdin</literal>(在文件名位置指定 <literal>-</literal>)读取。<command>pkgdiff</command> 在比较之前会将每个清单和操作按一致的顺序排序。</para>
+<para>输出采用以下格式:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term>+ <replaceable>complete_action</replaceable></term>
+<listitem><para>此操作在 <replaceable>file2</replaceable> 中而不在 <replaceable>file1</replaceable> 中。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>- <replaceable>complete_action</replaceable></term>
+<listitem><para>此操作在 <replaceable>file1</replaceable> 中而不在 <replaceable>file2</replaceable> 中。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<programlisting><replaceable>actionname</replaceable> <replaceable>keyvalue</replaceable> [<replaceable>variant values, if any</replaceable>]</programlisting>
+<variablelist termlength="wholeline">
+<varlistentry><term>- <replaceable>attribute1</replaceable>=<replaceable>value1</replaceable></term>
+<listitem><para>此 <replaceable>attribute</replaceable>,<replaceable>value</replaceable> 在 <replaceable>file1</replaceable> 中而不在 <replaceable>file2</replaceable> 中。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>+ <replaceable>attribute2</replaceable>=<replaceable>value2</replaceable></term>
+<listitem><para>此 <replaceable>attribute</replaceable>,<replaceable>value</replaceable> 在 <replaceable>file2</replaceable> 中而不在 <replaceable>file1</replaceable> 中。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>为了完成比较,带有不同变体、但带有相同类型和关键属性值的操作将被视为不同的操作。因此,可更改属性的操作将以其完整格式显示,而不是作为属性更改显示。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>支持以下选项:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-help</option></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>attribute</replaceable></term>
+<listitem><para>比较期间将忽略 <replaceable>attribute</replaceable>(如果存在)。可以使用 <option>i</option><replaceable> hash</replaceable> 忽略文件散列值。该选项不能与 <option>o</option> 选项一起使用。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>o</option> <replaceable>attribute</replaceable></term>
+<listitem><para>仅报告 <replaceable>attribute</replaceable> 的差异。该选项不能与 <option>i</option> 选项一起使用。该选项会省略不影响操作 <replaceable>attribute</replaceable> 的任何操作更改。</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term><option>t</option> <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...</term>
+<listitem>
+<para>仅比较指定的操作。可以在一个逗号分隔的列表中指定多个操作。<replaceable>action_name</replaceable> 的值是 <literal>pkg</literal>(5) 手册页的“操作”中列出的操作之一。例如,可以为 <replaceable>action_name</replaceable> 指定以下值:<literal>file</literal>、<literal>dir</literal>、<literal>driver</literal>、<literal>depend</literal>、<literal>set</literal>。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option> <replaceable>name</replaceable>=<replaceable>value</replaceable></term>
+<listitem><para>仅计算该变体值的差异。例如,只计算 <literal>arch=sparc</literal> 的差异。在进行比较之前,将删除所有操作的该变体标记。只能为每个变体指定一个值。可以为不同变体多次指定此选项。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>未找到差异。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>找到了差异。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg </refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/zh_CN/pkgfmt.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgfmt.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,147 +1,104 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgfmt 1 "2013 年 5 月 21 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgfmt \- 格式化软件包清单
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgfmt [-c|-d|-u] [\fIpackage-manifest-file\fR]
-.fi
-
-.SH 描述
-.sp
-.LP
-不带 \fB-c\fR 或 \fB-d\fR 选项的 \fBpkgfmt\fR 将以一致的方式对软件包清单进行格式化,包括每 80 个字符自动换行,按类型对操作排序,以及对属性排序。未解析成操作(如宏、注释或转换)的行不会按排序顺序显示。
-.sp
-.LP
-如果未提供参数,\fBpkgfmt\fR 将会读取 \fBstdin\fR,直到遇到 EOF,然后将格式化的清单写入 \fBstdout\fR。在命令行上指定的任何清单将在原位格式化。
-.sp
-.LP
-带 \fB-c\fR 选项的 \fBpkgfmt\fR 将会检查清单是否格式化为 \fBpkgfmt\fR 样式。如果文件未正确格式化,\fB- d\fR 选项将显示差异。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.RS 10n
-.rt  
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR\fR
-.ad
-.RS 10n
-.rt  
-检查清单是否格式化为 \fBpkgfmt\fR 样式。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.RS 10n
-.rt  
-以统一格式显示与格式化版本的清单差异。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-u\fR\fR
-.ad
-.RS 10n
-.rt  
-达到 80 个字符时不自动换行。将传统的文本处理工具应用到软件包清单时,该选项十分有用。
-.RE
+<?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;
+]>
 
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-指定了 \fB-c\fR 或 \fB-d\fR 选项,并且一个或多个清单不处于 \fBpkgfmt\fR 正常格式,或出现了错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
+<refentry lang="zh" id="pkgfmt-1">
+<refmeta><refentrytitle>pkgfmt</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgfmt</refname><refpurpose>格式化软件包清单</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgfmt [-c|-d|-u] [<replaceable>package-manifest-file</replaceable>]
+</synopsis></refsynopsisdiv>
+<refsect1 id="pkgfmt-1-desc" role="description"><title></title>
+<para>不带 <option>c</option> 或 <option>d</option> 选项的 <command>pkgfmt</command> 将以一致的方式对软件包清单进行格式化,包括每 80 个字符自动换行,按类型对操作排序,以及对属性排序。未解析成操作(如宏、注释或转换)的行不会按排序顺序显示。</para>
+<para>如果未提供参数,<command>pkgfmt</command> 将会读取 <literal>stdin</literal>,直到遇到 EOF,然后将格式化的清单写入 <literal>stdout</literal>。在命令行上指定的任何清单将在原位格式化。</para>
+<para>带 <option>c</option> 选项的 <command>pkgfmt</command> 将会检查清单是否格式化为 <command>pkgfmt</command> 样式。如果文件未正确格式化,<option> d</option> 选项将显示差异。
+</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>支持以下选项:</para>
+<variablelist>
+<varlistentry><term><option>?</option></term><term><option>-help</option></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option></term>
+<listitem><para>检查清单是否格式化为 <command>pkgfmt</command> 样式。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term>
+<listitem><para>以统一格式显示与格式化版本的清单差异。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>u</option></term>
+<listitem><para>达到 80 个字符时不自动换行。将传统的文本处理工具应用到软件包清单时,该选项十分有用。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>指定了 <option>c</option> 或 <option>d</option> 选项,并且一个或多个清单不处于 <command>pkgfmt</command> 正常格式,或出现了错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/zh_CN/pkglint.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkglint.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,310 +1,135 @@
-'\" te
-.\" Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved.
-.TH pkglint 1 "2014 年 1 月 14 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkglint \- 映像包管理系统软件包 lint
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkglint [-c \fIcache_dir\fR] [-r \fIrepo_uri\fR]... [-p \fIregexp\fR]
-    [-f \fIconfig_file\fR] [-b \fIbuild_no\fR] [-v]
-    [-l \fIlint_uri\fR] | \fImanifest\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkglint -L [-v]
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpkglint\fR 对一个或多个软件包清单运行一系列检查,并有选择性地引用其他系统信息库。
-.sp
-.LP
-应该在发布软件包之前,在软件包构建期间使用 \fBpkglint\fR。\fBpkglint\fR 将对清单执行全面的测试,在 \fBpkgsend\fR 或 \fBpkg.depotd\fR 正常操作期间,执行这种测试可能会消耗过多的资源。\fB pkglint\fR 检查包括对重复操作、缺少的属性和非正常文件权限的测试。
-.sp
-.LP
-可以在命令行上将用于 lint 的清单作为本地文件的空格分隔列表进行传递,也可以从系统信息库检索清单。
-.sp
-.LP
-从系统信息库检索清单时,首次运行时 \fBpkglint\fR 将在指定的高速缓存目录中创建并填充 \fBpkg\fR(5) 用户映像。如果提供了 \fB-r\fR 选项,则为引用系统信息库创建名为 \fI cache_dir\fR\fB/ref_image\fR 的用户映像。如果提供了 \fB-l\fR 选项,则为 lint 系统信息库创建名为 \fI cache_dir\fR\fB/lint_image\fR 的用户映像。不会在这些映像中安装任何内容。\fBpkglint\fR 只使用这些映像从系统信息库中检索清单。
-.sp
-.LP
-\fBpkglint\fR 的后续调用可以重新使用高速缓存目录,并可以省略任何 \fB-r\fR 或 \fB-l\fR 参数。
-.sp
-.LP
-\fBpkglint\fR 对在高速缓存目录中配置发布者提供有限的支持。使用 \fBpkg\fR 可对这些映像执行更复杂的发布者配置。
-.sp
-.LP
-\fBpkglint\fR 使软件包作者能够绕过对给定清单或操作进行的检查。其中的属性 \fB pkg.linted\fR 设置为 \fBTrue\fR 的清单或操作不会为该清单或操作生成任何 lint 输出。
-.sp
-.LP
-使用 \fBpkglint\fR 检查名称的子字符串可以进行更高粒度的 \fBpkg.linted\fR 设置。例如,设置为 \fBTrue\fR 的 \fBpkg.linted.\fI check\fR.\fIid\fR\fR 将对给定的清单或操作绕过名称为 \fB\fIcheck\fR.\fIid \fR\fR 的所有检查。
-.sp
-.LP
-可通过指定一个 \fBpkglintrc\fR 文件来配置 \fBpkglint\fR 的行为。缺省情况下,\fBpkglint\fR 在 \fB/usr/share/lib/pkg/pkglintrc\fR 和 \fB$HOME/.pkglintrc \fR 中搜索配置选项。使用 \fB-f\fR 选项可以指定其他配置文件。
-.sp
-.LP
-lint 运行期间,遇到的任何错误或警告将输出到 \fBstderr\fR。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-b\fR \fIbuild_no\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定内部版本号,用于细化从 lint 和引用系统信息库执行 lint 期间使用的软件包列表。如果不指定 \fB-b\fR 选项,将使用最新版本的软件包。另请参见 \fBversion.pattern \fR 配置属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定用于从 lint 和引用系统信息库高速缓存软件包元数据的本地目录。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-l\fR \fIlint_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定表示 lint 系统信息库位置的 URI。支持基于 HTTP 和基于文件系统的发布。如果指定 \fB- l\fR,则还必须指定 \fB-c\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-L\fR\fR
-.ad
-.sp .6
-.RS 4n
-列出已知的和排除的 lint 检查,然后退出。显示每个检查的短名称和描述。与 \fB-v\fR 标志结合使用时,将显示实现检查的方法而不显示描述。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-f\fR \fIconfig_file\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用 \fI config_file\fR 配置文件来配置 \fBpkglint\fR 会话。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIregexp\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定正则表达式,用于细化要从 lint 系统信息库检查的软件包列表。将会装入来自引用系统信息库的所有清单(假定它们与提供的 \fB-b\fR 值匹配),并忽略此模式。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR \fIrepo_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定表示引用系统信息库位置的 URI。如果指定 \fB-r\fR,则还必须指定 \fB-c\fR。可以多次指定 \fB-r\fR 选项。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-以详细模式运行 \fBpkglint\fR,覆盖配置文件中的任何 \fBlog_level\fR 设置。
-.RE
-
-.SH 文件
-.sp
-.LP
-\fBpkglintrc\fR 配置文件采用以下键/值参数:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlog_level\fR\fR
-.ad
-.sp .6
-.RS 4n
-发出 lint 消息的最低级别。低于该级别的 lint 消息将被放弃。缺省值为 \fBINFO\fR。
-.sp
-严重性从低到高的日志级别依次为 \fBDEBUG\fR、\fB INFO\fR、\fBWARNING\fR、\fBERROR\fR 和 \fB CRITICAL\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdo_pub_checks\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果为 \fBTrue\fR,则执行可能只对已发布的软件包有意义的检查。缺省值为 \fBTrue\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkglint.ext.\fR*\fR
-.ad
-.sp .6
-.RS 4n
-\fBpkglint\fR 的插件机制允许在运行时添加其他 lint 模块。以 \fB pkglint.ext.\fR 开头的任何键采用必须是完全指定的 Python 模块的值。有关更多信息,请参见“开发工具”一节。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkglint.exclude\fR\fR
-.ad
-.sp .6
-.RS 4n
-要从执行的检查集中省略的完全指定的 Python 模块、类或函数名称的空格分隔列表。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBuse_progress_tracker\fR\fR
-.ad
-.sp .6
-.RS 4n
-如果为 \fBTrue\fR,则在 lint 运行期间迭代清单时,会使用进度跟踪器。缺省值为 \fBTrue\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBversion.pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定内部版本号以针对 (\fB-b\fR) 执行 lint 时使用的版本模式。如果未在配置文件中指定,则 \fB-b\fR 选项将使用模式 \fB*,5.11-0.\fR,并使用分支前缀 0 来匹配 5.11 内部版本的所有组件。
-.RE
-
-.SH 开发工具
-.sp
-.LP
-扩展 \fBpkglint\fR、子类 \fBpkg.lint.base.Checker\fR 及其子类 \fBManifestChecker \fR、\fBActionChecker\fR 和 \fBContentChecker\fR 执行的检查集。将包含这些类的 Python 模块名称添加到配置文件中的新 \fBpkglint.ext.\fR 键。
-.sp
-.LP
-这些新子类的实例由 \fBpkglint\fR 在启动时创建。lint 会话过程中,将会调用带有特殊关键字参数 \fB pkglint_id\fR 的每个子类中的方法。这些方法应该与超类中的相应 \fBcheck()\fR 方法具有相同的签名。还应该为方法指定一个 \fBpkglint_desc\fR 属性,该属性用作 \fBpkglint -L\fR 输出的描述。
-.sp
-.LP
-参数可用于 \fBChecker\fR 子类,使这些子类能够调优其行为。建议的参数命名约定为 \fB\fI pkglint_id\fR.\fIname\fR\fR。参数值可以存储在配置文件中,或者在使用 \fBLintEngine.get_param()\fR 方法检索的清单或操作中访问。从清单访问参数时,将在键名的前面附加前缀 \fBpkg.lint\fR,以确保 \fBpkglint\fR 参数不会与任何现有的操作或清单值重叠。
-.SH 示例
-.LP
-\fB示例 1 \fR对特定系统信息库的首次运行
-.sp
-.LP
-对给定系统信息库上首次运行 \fBpkglint\fR 会话。
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache -r http://localhost:10000 mymanifest.mf\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR对相同系统信息库的后续运行
-.sp
-.LP
-针对示例 1 中使用的同一系统信息库的后续运行。
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache mymanifest-fixed.mf\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 3 \fR将 Lint 系统信息库和细化的清单集一起使用
-.sp
-.LP
-将 \fBpkglint\fR 会话和 lint 系统信息库结合运行,并指定要检查的清单的子集。
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/othercache -l http://localhost:10000 \e\fR
-\fB-p '.*firefox.*'\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 4 \fR指定内部版本
-.sp
-.LP
-在详细模式下针对给定的内部版本运行 \fBpkglint\fR 会话。
-
-.sp
-.in +2
-.nf
-$ \fBpkglint -c /space/cache -r http://localhost:10000 \e\fR
-\fB-l http://localhost:12000 -b 147 -v\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 5 \fR修改配置文件
-.sp
-.LP
-带有新的 lint 模块的配置文件,排除某些检查。
-
-.sp
-.in +2
-.nf
-$ \fBcat ~/.pkglintrc\fR
+<refentry lang="zh" id="pkglint-1">
+<refmeta><refentrytitle>pkglint</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2014 年 4 月 29 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkglint</refname><refpurpose>映像包管理系统软件包 lint</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkglint [-c <replaceable>cache_dir</replaceable>] [-r <replaceable>
+repo_uri</replaceable>]... [-p <replaceable>regexp</replaceable>]
+    [-f <replaceable>config_file</replaceable>] [-b <replaceable>build_no</replaceable>] [-v]
+    [-l <replaceable>lint_uri</replaceable>]... | <replaceable>manifest</replaceable> ...
+</synopsis>
+<synopsis>/usr/bin/pkglint -L [-v]</synopsis>
+</refsynopsisdiv>
+<refsect1 role="description"><title></title>
+<para><command>pkglint</command> 对一个或多个软件包清单运行一系列检查,并有选择性地引用其他系统信息库。</para>
+<para>应该在发布软件包之前,在软件包构建期间使用 <command>pkglint</command>。<command>pkglint</command> 将对清单执行全面的测试,在 <command>pkgsend</command> 或 <command>pkg.depotd</command> 正常操作期间,执行这种测试可能会消耗过多的资源。<command> pkglint</command> 检查包括对重复操作、缺少的属性和非正常文件权限的测试。</para>
+<para>可以在命令行上将用于 lint 的清单作为本地文件的空格分隔列表进行传递,也可以从系统信息库检索清单。</para>
+<para>从系统信息库检索清单时,首次运行时 <command>pkglint</command> 将在指定的高速缓存目录中创建并填充 <literal>pkg</literal>(5) 用户映像。如果提供了 <option>r</option> 选项,则为引用系统信息库创建名为 <replaceable> cache_dir</replaceable><literal>/ref_image</literal> 的用户映像。如果提供了 <option>l</option> 选项,则为 lint 系统信息库创建名为 <replaceable> cache_dir</replaceable><literal>/lint_image</literal> 的用户映像。不会在这些映像中安装任何内容。<command>pkglint</command> 只使用这些映像从系统信息库中检索清单。</para>
+<para><command>pkglint</command> 的后续调用可以重新使用高速缓存目录,并可以省略任何 <option>r</option> 或 <option>l</option> 参数。</para>
+<para><command>pkglint</command> 对在高速缓存目录中配置发布者提供有限的支持。使用 <command>pkg</command> 可对这些映像执行更复杂的发布者配置。</para>
+<para><command>pkglint</command> 使软件包作者能够绕过对给定清单或操作进行的检查。其中的属性 <literal> pkg.linted</literal> 设置为 <literal>True</literal> 的清单或操作不会为该清单或操作生成任何 lint 输出。</para>
+<para>使用 <command>pkglint</command> 检查名称的子字符串可以进行更高粒度的 <literal>pkg.linted</literal> 设置。例如,设置为 <literal>True</literal> 的 <literal>pkg.linted.<replaceable> check</replaceable>.<replaceable>id</replaceable></literal> 将对给定的清单或操作绕过名称为 <literal><replaceable>check</replaceable>.<replaceable>id </replaceable></literal> 的所有检查。</para>
+<para>可通过指定一个 <filename>pkglintrc</filename> 文件来配置 <command>pkglint</command> 的行为。缺省情况下,<command>pkglint</command> 在 <filename>/usr/share/lib/pkg/pkglintrc</filename> 和 <filename>$HOME/.pkglintrc </filename> 中搜索配置选项。使用 <option>f</option> 选项可以指定其他配置文件。</para>
+<para>lint 运行期间,遇到的任何错误或警告将输出到 <filename>stderr</filename>。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>支持以下选项:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>b</option> <replaceable>build_no</replaceable></term>
+<listitem><para>指定内部版本号,用于细化从 lint 和引用系统信息库执行 lint 期间使用的软件包列表。如果不指定 <option>b</option> 选项,将使用最新版本的软件包。另请参见 <literal>version.pattern </literal> 配置属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>指定用于从 lint 和引用系统信息库高速缓存软件包元数据的本地目录。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>l</option> <replaceable>lint_uri</replaceable></term>
+<listitem><para>指定表示 lint 系统信息库位置的 URI。支持基于 HTTP 和基于文件系统的发布。如果指定 <option>l</option>,则必须还要指定 <option>c</option>。可以多次指定 <option>l</option> 选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>L</option></term>
+<listitem><para>列出已知的和排除的 lint 检查,然后退出。显示每个检查的短名称和说明。与 <option>v</option> 标志结合使用时,将显示实现检查的方法而不显示说明。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>f</option> <replaceable>config_file</replaceable></term>
+<listitem><para>使用 <replaceable> config_file</replaceable> 配置文件来配置 <command>pkglint</command> 会话。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>regexp</replaceable></term>
+<listitem><para>指定正则表达式,用于细化要从 lint 系统信息库检查的软件包列表。将会装入来自引用系统信息库的所有清单(假定它们与提供的 <option>b</option> 值匹配),并忽略此模式。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option> <replaceable>repo_uri</replaceable></term>
+<listitem><para>指定表示引用系统信息库位置的 URI。如果指定 <option>r</option>,则还必须指定 <option>c</option>。可以多次指定 <option>r</option> 选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>以详细模式运行 <command>pkglint</command>,覆盖配置文件中的任何 <literal>log_level</literal> 设置。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<para><filename>pkglintrc</filename> 配置文件采用以下键/值参数:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>log_level</literal></term>
+<listitem><para>发出 lint 消息的最低级别。低于该级别的 lint 消息将被放弃。缺省值为 <literal>INFO</literal>。
+</para>
+<para>严重性从低到高的日志级别依次为 <literal>DEBUG</literal>、<literal> INFO</literal>、<literal>WARNING</literal>、<literal>ERROR</literal> 和 <literal> CRITICAL</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>do_pub_checks</literal></term>
+<listitem><para>如果为 <literal>True</literal>,则执行可能只对已发布的软件包有意义的检查。缺省值为 <literal>True</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkglint.ext.</literal>*</term>
+<listitem><para><command>pkglint</command> 的插件机制允许在运行时添加其他 lint 模块。以 <literal> pkglint.ext.</literal> 开头的任何键采用必须是完全指定的 Python 模块的值。有关更多信息,请参见“开发工具”一节。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>pkglint.exclude</literal></term>
+<listitem><para>要从执行的检查集中省略的完全指定的 Python 模块、类或函数名称的空格分隔列表。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>use_progress_tracker</literal></term>
+<listitem><para>如果为 <literal>True</literal>,则在 lint 运行期间迭代清单时,会使用进度跟踪器。缺省值为 <literal>True</literal>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>version.pattern</literal></term>
+<listitem><para>指定内部版本号以针对 (<option>b</option>) 执行 lint 时使用的版本模式。如果未在配置文件中指定,则 <option>b</option> 选项将使用模式 <literal>*,5.11-0.</literal>,并使用分支前缀 0 来匹配 5.11 内部版本的所有组件。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>开发工具</title>
+<para>扩展 <command>pkglint</command>、子类 <literal>pkg.lint.base.Checker</literal> 及其子类 <literal>ManifestChecker </literal>、<literal>ActionChecker</literal> 和 <literal>ContentChecker</literal> 执行的检查集。将包含这些类的 Python 模块名称添加到配置文件中的新 <literal>pkglint.ext.</literal> 键。</para>
+<para>这些新子类的实例由 <command>pkglint</command> 在启动时创建。lint 会话过程中,将会调用带有特殊关键字参数 <literal> pkglint_id</literal> 的每个子类中的方法。这些方法应该与超类中的相应 <function>check</function> 方法具有相同的签名。还应该为方法指定一个 <literal>pkglint_desc</literal> 属性,该属性用作 <command>pkglint -L</command> 输出的说明。</para>
+<para>参数可用于 <literal>Checker</literal> 子类,使这些子类能够调优其行为。建议的参数命名约定为 <literal><replaceable> pkglint_id</replaceable>.<replaceable>name</replaceable></literal>。参数值可以存储在配置文件中,或者在使用 <function>LintEngine.get_param</function> 方法检索的清单或操作中访问。从清单访问参数时,将在键名的前面附加前缀 <literal>pkg.lint</literal>,以确保 <command>pkglint</command> 参数不会与任何现有的操作或清单值重叠。</para>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>对特定系统信息库的首次运行</title>
+<para>对给定系统信息库上首次运行 <command>pkglint</command> 会话。</para>
+<screen>$ <userinput>pkglint -c /space/cache -r http://localhost:10000 mymanifest.mf</userinput></screen>
+</example>
+<example><title>对相同系统信息库的后续运行</title>
+<para>针对示例 1 中使用的同一系统信息库的后续运行。</para>
+<screen>$ <userinput>pkglint -c /space/cache mymanifest-fixed.mf</userinput></screen>
+</example>
+<example><title>将 Lint 系统信息库和细化的清单集一起使用</title>
+<para>将 <command>pkglint</command> 会话和 lint 系统信息库结合运行,并指定要检查的清单的子集。</para>
+<screen>$ <userinput>pkglint -c /space/othercache -l http://localhost:10000 &bsol;</userinput>
+<userinput>-p '.*firefox.*'</userinput></screen>
+</example>
+<example><title>指定内部版本</title>
+<para>在详细模式下针对给定的内部版本运行 <command>pkglint</command> 会话。</para>
+<screen>$ <userinput>pkglint -c /space/cache -r http://localhost:10000 &bsol;</userinput>
+<userinput>-l http://localhost:12000 -b 147 -v</userinput></screen>
+</example>
+<example><title>修改配置文件</title>
+<para>带有新的 lint 模块的配置文件,排除某些检查。</para>
+<screen>$ <userinput>cat ~/.pkglintrc</userinput>
 [pkglint]
 
 log_level = DEBUG
@@ -314,82 +139,66 @@
 pkglint.ext.opensolaris = pkg.lint.opensolaris
 pkglint.exclude: pkg.lint.opensolaris.OpenSolarisActionChecker
 pkg.lint.pkglint.PkgActionChecker.unusual_perms pkg.lint.pkglint.PkgManifestChecker
-pkg.lint.opensolaris.OpenSolarisManifestChecker
-.fi
-.in -2
-.sp
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-一个或多个软件包清单包含 lint 错误。
-.RE
+pkg.lint.opensolaris.OpenSolarisManifestChecker</screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>一个或多个软件包清单包含 lint 错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>清单中出现 lint 错误以外的错误。例如,可能指定了无效的命令行选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg </refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd </refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle> <manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum> </citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-清单中出现 lint 错误以外的错误。例如,可能指定了无效的命令行选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(1)、\fBpkg.depotd\fR(1M)、\fBpkgsend\fR(1)、\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/zh_CN/pkgmerge.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgmerge.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,468 +1,231 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgmerge 1 "2013 年 11 月 14 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgmerge \- 映像包管理系统软件包合并实用程序
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgmerge [-n] -d \fIdest_repo\fR
-    [-p \fIpublisher_prefix\fR]...
-    -s \fIvariant\fR=\fIvalue\fR[,...],\fIsrc_repo\fR ...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpkgmerge\fR 是一种用于创建多变量软件包的软件包发布工具。它通过合并具有相同名称和版本的软件包(时间戳除外),使用给定源的指定变量名称和值标记合并的版本中的唯一操作,然后将新的软件包发布到目标系统信息库,从而实现此操作。仅使用每个源中各软件包的最新版本。
-.sp
-.LP
-如果将某一操作的 \fBpkg.merge.blend\fR 属性设置为要合并变量的名称,则在合并之前将该操作复制到其他清单,以便在最终输出中显示该操作时不显示任何已添加的变量标记。请注意,属性 \fBpkg.merge.blend\fR 本身已从输出清单的所有操作中删除。对于多个传递合并,可以使用不同的值重复该属性。
-.sp
-.LP
-在输入清单中交付到同一路径的不同操作将导致 \fBpkgmerge\fR 因错误而退出。
-.sp
-.LP
-完成 \fBpkgmerge\fR 操作后,如果您的目标系统信息库必须支持 \fBpkg search\fR 操作,则在系统信息库上运行 \fBpkgrepo refresh\fR 以更新搜索索引。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIdest_repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定要将合并软件包发布到的目标系统信息库的文件系统路径或 URI。目标系统信息库必须已存在。可以使用 \fBpkgrepo\fR 创建新的系统信息库。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-执行试运行,不对目标系统信息库进行任何更改。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher_prefix\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定要合并其软件包的发布者的名称。可以多次指定此选项。
-.sp
-缺省情况下,将合并所有源系统信息库中所有发布者的软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIvariant\fR=\fIvalue\fR[,...],\fIsrc_repo\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定用于该源的软件包的变量名称和值,后跟要从中检索软件包的源系统信息库或软件包归档文件的文件系统路径或 URI。可指定多个变量,以逗号分隔。必须为所有源命名相同的变量。可以多次指定此选项。
-.RE
-
-.SH 操作数
-.sp
-.LP
-支持下列操作数:
-.sp
-.ne 2
-.mk
-.na
-\fB\fIpkg_fmri_pattern\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定要合并的软件包。\fIpkg_fmri_pattern\fR 操作数可以包含 \fB?\fR 和 \fB*\fR 字符作为 \fBglob\fR(3C) 式通配符,以匹配一个或多个软件包。
-.RE
-
-.SH 环境变量
-.sp
-.LP
-支持以下环境变量:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBTMPDIR\fR\fR
-.ad
-.RS 10n
-.rt  
-在程序执行期间用于存储临时数据的目录的绝对路径。如果未设置,则存储临时数据的缺省路径为 \fB/var/tmp\fR。
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR指定变量名称和值
-.sp
-.LP
-使用为从中检索到软件包的源指定的给定变量名称和值标记在指定源中发现的每个软件包:
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src.example.com \e\fR
-\fB-d http://dest.example.com\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-样例软件包:
+<?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;
+]>
 
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-操作后的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+<refentry lang="zh" id="pkgmerge-1">
+<refmeta><refentrytitle>pkgmerge</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 11 月 14 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgmerge</refname><refpurpose>映像包管理系统软件包合并实用程序</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgmerge [-n] -d <replaceable>dest_repo</replaceable>
+    [-p <replaceable>publisher_prefix</replaceable>]...
+    -s <replaceable>variant</replaceable>=<replaceable>value</replaceable>[,...],<replaceable>src_repo</replaceable> ...
+    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgmerge-1-desc" role="description"><title></title>
+<para><command>pkgmerge</command> 是一种用于创建多变量软件包的软件包发布工具。它通过合并具有相同名称和版本的软件包(时间戳除外),使用给定源的指定变量名称和值标记合并的版本中的唯一操作,然后将新的软件包发布到目标系统信息库,从而实现此操作。仅使用每个源中各软件包的最新版本。</para>
+<para>如果将某一操作的 <literal>pkg.merge.blend</literal> 属性设置为要合并变量的名称,则在合并之前将该操作复制到其他清单,以便在最终输出中显示该操作时不显示任何已添加的变量标记。请注意,属性 <literal>pkg.merge.blend</literal> 本身已从输出清单的所有操作中删除。对于多个传递合并,可以使用不同的值重复该属性。</para>
+<para>在输入清单中交付到同一路径的不同操作将导致 <command>pkgmerge</command> 因错误而退出。</para>
+<para>完成 <command>pkgmerge</command> 操作后,如果您的目标系统信息库必须支持 <command>pkg search</command> 操作,则在系统信息库上运行 <command>pkgrepo refresh</command> 以更新搜索索引。</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>d</option> <replaceable>dest_repo</replaceable></term>
+<listitem><para>指定要将合并软件包发布到的目标系统信息库的文件系统路径或 URI。目标系统信息库必须已存在。可以使用 <command>pkgrepo</command> 创建新的系统信息库。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>执行试运行,不对目标系统信息库进行任何更改。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher_prefix</replaceable></term>
+<listitem><para>指定要合并其软件包的发布者的名称。可以多次指定此选项。</para>
+<para>缺省情况下,将合并所有源系统信息库中所有发布者的软件包。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>variant</replaceable>=<replaceable>value</replaceable>[,...],<replaceable>src_repo</replaceable></term>
+<listitem><para>指定用于该源的软件包的变量名称和值,后跟要从中检索软件包的源系统信息库或软件包归档文件的文件系统路径或 URI。可指定多个变量,以逗号分隔。必须为所有源命名相同的变量。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="operands"><title></title>
+<para>支持下列操作数:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>pkg_fmri_pattern</replaceable></term>
+<listitem><para>指定要合并的软件包。<replaceable>pkg_fmri_pattern</replaceable> 操作数可以包含 <literal>?</literal> 和 <literal>*</literal> 字符作为 <literal>glob</literal>(3C) 式通配符,以匹配一个或多个软件包。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<para>支持以下环境变量:</para>
+<variablelist>
+<varlistentry><term><envar>TMPDIR</envar></term>
+<listitem><para>在程序执行期间用于存储临时数据的目录的绝对路径。如果未设置,则存储临时数据的缺省路径为 <filename>/var/tmp</filename>。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>指定变量名称和值</title>
+<para>使用为从中检索到软件包的源指定的给定变量名称和值标记在指定源中发现的每个软件包:</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src.example.com &bsol;</userinput>
+<userinput>-d http://dest.example.com</userinput></screen>
+<para>样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>操作后的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fB示例 2 \fR合并和发布软件包
-.sp
-.LP
-合并给定源中每个软件包的最新版本并将新软件包发布到目标系统信息库:
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src1.example.com \e\fR
-\fB-s arch=i386,http://src2.example.com \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-源 1 (SPARC) 中的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-源 2 (i386) 中的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-合并软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example><title>合并和发布软件包</title>
+<para>合并给定源中每个软件包的最新版本并将新软件包发布到目标系统信息库:</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src1.example.com &bsol;</userinput>
+<userinput>-s arch=i386,http://src2.example.com &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>源 1 (SPARC) 中的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>源 2 (i386) 中的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>合并软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc value=i386
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fB示例 3 \fR合并 i386 和 SPARC 系统的调试和非调试软件包
-.sp
-.LP
-在一组用于 i386 和 SPARC 系统的调试及非调试系统信息库中,合并每个软件包的最新版本:
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,debug=false,/repo/sparc-nondebug \e\fR
-\fB-s arch=sparc,debug=true,/repo/sparc-debug \e\fR
-\fB-s arch=i386,debug=false,/repo/i386-nondebug \e\fR
-\fB-s arch=i386,debug=true,/repo/i386-debug \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-源 1(SPARC 非调试)中的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-源 2(SPARC 调试)中的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121411Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-源 3(i386 非调试)中的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-源 4(i386 调试)中的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-合并软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example><title>合并 i386 和 SPARC 系统的调试和非调试软件包</title>
+<para>在一组用于 i386 和 SPARC 系统的调试及非调试系统信息库中,合并每个软件包的最新版本:</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,debug=false,/repo/sparc-nondebug &bsol;</userinput>
+<userinput>-s arch=sparc,debug=true,/repo/sparc-debug &bsol;</userinput>
+<userinput>-s arch=i386,debug=false,/repo/i386-nondebug &bsol;</userinput>
+<userinput>-s arch=i386,debug=true,/repo/i386-debug &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>源 1(SPARC 非调试)中的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>源 2(SPARC 调试)中的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121411Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>源 3(i386 非调试)中的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>源 4(i386 调试)中的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>合并软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163428Z
 set name=variant.arch value=sparc value=i386
 set name=variant.debug value=false value=true
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=false
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=true
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=false
-file \fIid\fR mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=true
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fB示例 4 \fR使用 \fBpkg.merge.blend\fR 合并
-.sp
-.LP
-使用 \fB pkg.merge.blend\fR 属性合并两个不相互冲突的体系结构的软件包。
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -s arch=sparc,http://src1/example.com \e\fR
-\fB-s arch=i386,http://src2.example.com \e\fR
-\fB-d /\fIpath/to/target/repository\fR\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-源 1 (SPARC) 中的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
-file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root \e
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=false
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=sparc variant.debug=true
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=false
+file <replaceable>id</replaceable> mode=0555 owner=root group=bin path=usr/bin/foo variant.arch=i386 variant.debug=true
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example id="GLFDD"><title>使用 <literal>pkg.merge.blend</literal> 合并</title>
+<para>使用 <literal> pkg.merge.blend</literal> 属性合并两个不相互冲突的体系结构的软件包。</para>
+<screen>$ <userinput>pkgmerge -s arch=sparc,http://src1/example.com &bsol;</userinput>
+<userinput>-s arch=i386,http://src2.example.com &bsol;</userinput>
+<userinput>-d /<replaceable>path/to/target/repository</replaceable></userinput></screen>
+<para>源 1 (SPARC) 中的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T121410Z
+file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/sparc/foo pkg.merge.blend=arch
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-源 2 (i386) 中的样例软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
-file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root \e
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>源 2 (i386) 中的样例软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root &bsol;
     group=bin path=usr/bin/i386/foo pkg.merge.blend=arch
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.sp
-.LP
-合并软件包:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+<para>合并软件包:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected],5.11-0.200:20381001T163427Z
 set name=variant.arch value=sparc value=i386
-file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root \e
+file d285ada5f3cae14ea00e97a8d99bd3e357caadc0 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/foo
-file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root \e
+file a285ada5f3cae14ea00e97a8d99bd3e357cb0dca mode=0555 owner=root &bsol;
     group=bin path=usr/bin/i386/foo
-file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root \e
+file 1d5eac1aab628317f9c088d21e4afda9c754bb76 mode=0555 owner=root &bsol;
     group=bin path=usr/bin/sparc/foo
-dir group=sys mode=0755 owner=root path=usr
-.fi
-.in -2
-
-.LP
-\fB示例 5 \fR合并带有不同发布者前缀的软件包
-.sp
-.LP
-仅合并带有 \fBdev\fR 前缀的软件包,即使这些系统信息库中的其他软件包带有 \fBexample.com\fR 前缀也是如此。
-
-.sp
-.in +2
-.nf
-$ \fBpkgmerge -p dev -s arch=sparc,http://src1.example.com \e
--s arch=i386,http://src2.example.com \e
--d /path/to/target/repository\fR
-.fi
-.in -2
-.sp
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkgrepo\fR(1)、\fBpkg\fR(5)
-.sp
-.LP
-\fI《Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2》\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
+dir group=sys mode=0755 owner=root path=usr</programlisting>
+</example>
+<example id="differentpubs"><title>合并带有不同发布者前缀的软件包</title>
+<para>仅合并带有 <literal>dev</literal> 前缀的软件包,即使这些系统信息库中的其他软件包带有 <literal>example.com</literal> 前缀也是如此。</para>
+<screen>$ <userinput>pkgmerge -p dev -s arch=sparc,http://src1.example.com &bsol;
+-s arch=i386,http://src2.example.com &bsol;
+-d /path/to/target/repository</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="PKDEV">《<citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle>》</olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
--- a/src/man/zh_CN/pkgmogrify.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgmogrify.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,624 +1,286 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgmogrify 1 "2013 年 7 月 12 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgmogrify \- 映像包管理系统清单变换程序
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgmogrify [-vi] [-I \fIincludedir\fR]...
-    [-D \fImacro\fR=\fIvalue\fR]... [-O \fIoutputfile\fR]
-    [-P \fIprintfile\fR] [\fIinputfile\fR ...]
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpkgmogrify\fR 允许对软件包清单进行编程式编辑,以简化自动生成软件和自动发布软件包时所需的典型变换。
-.sp
-.LP
-\fBpkgmogrify\fR 提供:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-宏替换,以便于在各种体系结构和平台间共享单个清单。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-包含其他清单或清单片段,例如标准组件和变换。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-变换软件包操作,包括修改、删除或添加操作属性。
-.RE
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-D\fR \fImacro\fR=\fI value\fR\fR
-.ad
-.sp .6
-.RS 4n
-将 \fImacro\fR 定义为一个宏,其值为 \fIvalue\fR。可以多次指定此选项。宏在输入文件中显示为 \fB $(macro)\fR。将重复执行替换操作,直到再也找不到变换。常见用语包括:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-通过在行的开头使用特定于体系结构的标记来删除其他体系结构清单中的行。
-.sp
-.in +2
-.nf
-$(sparc_ONLY)file ...
-.fi
-.in -2
-
-处理 SPARC 体系结构时,该宏将被设置为空字符串。而处理其他体系结构时,该宏在命令行中会被设置为 \fB#\fR,从而从当前体系结构的清单中删除此操作。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-指定路径名称中特定于平台的部分,例如,可执行文件和库的 64 位体系结构目录的名称:
-.sp
-.in +2
-.nf
-file path=usr/bin/$(ARCH64)/cputrack ...
-.fi
-.in -2
-
-应当将这些宏设置为命令行中所需的值。不存在预定义的宏值。
-.RE
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-I\fR \fIincludedir\fR\fR
-.ad
-.sp .6
-.RS 4n
-将指定目录添加到在命令行上和为嵌入式 include 指令指定的文件的搜索路径中。可以多次指定此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-O\fR \fIoutputfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-将清单输出写入指定的文件中。如果出现错误或 transform 指令引起中止操作,则不会写入该文件。缺省情况下,清单输出会写入 \fBstdout\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-P\fR \fIprintfile\fR\fR
-.ad
-.sp .6
-.RS 4n
-将 transform 指令输出操作生成的输出写入指定的文件。如果出现错误或 transform 指令引起中止操作,则不会写入该文件。缺省情况下,输出会写入 \fBstdout\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR\fR
-.ad
-.sp .6
-.RS 4n
-忽略文件中的 include 指令。仅处理在命令行(或 \fBstdin\fR)中指定的文件。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-将注释写入显示变换效果的输出清单。该信息可以帮助调试。
-.RE
-
-.SH 嵌入式指令
-.sp
-.LP
-清单文件支持两种类型的指令:include 指令和 transform 指令。
-.sp
-.LP
-Include 指令的格式为:
-.sp
-.in +2
-.nf
-<include \fIfile\fR>
-.fi
-.in -2
-
-.sp
-.LP
-该指令能够使 \fBpkgmogrify\fR 首先在当前目录中搜索名为 \fBfile\fR 的文件,然后在 \fB-I\fR 选项指定的目录中搜索该文件。如果找到,则会将该文件的内容插入清单中遇到该指令的位置。如果未找到,\fBpkgmogrify\fR 将退出并显示错误。
-.sp
-.LP
-Transform 指令的格式为:
-.sp
-.in +2
-.nf
-<transform \fImatching-criteria\fR -> \fIoperation\fR>
-.fi
-.in -2
-
-.sp
-.LP
-这些指令会进行累积(直到将所有输入都读入内存中),然后按遇到这些指令的顺序应用到操作。
-.sp
-.LP
-匹配条件的格式为:
-.sp
-.in +2
-.nf
-[\fIaction-name\fR ... ] [\fIattribute\fR=<\fIvalue-regexp\fR> ...]
-.fi
-.in -2
-
-.sp
-.LP
-必须至少匹配一个指定的 \fIaction-name\fR。必须匹配指定的每个 \fIattribute\fR。操作名称和属性列在 \fBpkg\fR(5) 手册页的“操作”中。使用的正则表达式语法是 Python 语法。有关 Python 正则表达式语法的更多信息,请使用命令 \fBpydoc re\fR 或请参见 \fBhttp://docs.python.org/dev/howto/regex.html \fR 中更为完整的文档。该正则表达式固定于开头而非结尾。因此,通过文件扩展名进行匹配的正则表达式匹配文件必须包含前导 \fB\&.*\fR,且应当包含尾随 \fB $\fR。
-.sp
-.LP
-可以指定多个条件,以空格分隔。
-.sp
-.LP
-有以下操作可用:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBadd\fR\fR
-.ad
-.RS 11n
-.rt  
-将值添加到属性中。此操作使用两个参数。第一个参数是属性的名称,第二个参数是对应值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdefault\fR\fR
-.ad
-.RS 11n
-.rt  
-如果不存在属性值,则设置该属性值。此操作与 \fBadd\fR 操作使用相同的两个参数。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdelete\fR\fR
-.ad
-.RS 11n
-.rt  
-删除属性值。此操作使用两个参数。第一个参数是属性的名称。第二个参数是要与删除的属性值匹配的正则表达式。与用于匹配操作的正则表达式不同,该正则表达式并不是固定的。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBdrop\fR\fR
-.ad
-.RS 11n
-.rt  
-放弃该操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBedit\fR\fR
-.ad
-.RS 11n
-.rt  
-修改操作的属性。此操作使用三个参数。第一个参数是属性的名称,第二个参数是与属性值匹配的正则表达式。第三个参数是用于替换正则表达式匹配的部分值的替换字符串。与用于匹配操作的正则表达式不同,该正则表达式并不是固定的。如果在正则表达式中定义了组,则在替换字符串中可以使用 \fB\e1\fR、\fB\e2\fR 等格式的一般正则表达式向后引用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBemit\fR\fR
-.ad
-.RS 11n
-.rt  
-向清单输出流中发出一行。此行必须是有效操作字符串、为空(导致空白行)或注释(\fB #\fR 后面跟有任意文本)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBexit\fR\fR
-.ad
-.RS 11n
-.rt  
-终止清单处理过程。不输出任何清单,也不应用任何 \fB print\fR 操作。如果给定一个参数,该参数必须是整数并且用作退出代码。缺省为 0。如果给定两个参数,则第一个参数是退出代码,第二个参数是要输出到 \fBstderr\fR 的消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBprint\fR\fR
-.ad
-.RS 11n
-.rt  
-将消息输出到 \fB-P\fR 指定的输出文件中。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBset\fR\fR
-.ad
-.RS 11n
-.rt  
-设置属性的值。此操作与 \fBadd\fR 操作使用相同的两个参数。
-.RE
+<?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;
+]>
 
-.sp
-.LP
-除了 \fBdelete\fR 和 \fBdrop\fR 以外的所有操作都使用其内容输出到输出流的参数(可能是可选的)。这些字符串可能包含三种不同类型的特殊标记,这些标记允许输出包含不基于每种操作的固定变换的信息。
-.sp
-.LP
-第一种替换通过将属性的名称放置在括号内(跟随在百分号后面),允许操作引用当前操作的属性值。例如,\fB%(alias)\fR 引用操作的 \fBalias\fR 属性的值。
-.sp
-.LP
-存在几个合成属性。以下两个对 \fBpkgmogrify\fR 而言是唯一的:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBpkg.manifest.filename\fR 引用在其中找到操作的文件的名称。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBpkg.manifest.lineno\fR 引用在其中找到操作的行。
-.RE
-.sp
-.LP
-以下三个合成属性类似于 \fBpkg\fR 中使用的属性:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.hash\fR 引用操作的散列值(如果该操作携带有效负荷)。对于携带有效负荷的操作,\fB set\fR 操作可以通过对 \fBaction.hash\fR 属性进行操作来更改该操作的散列。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.key\fR 引用关键属性的值。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBaction.name\fR 引用操作的名称。
-.RE
-.sp
-.LP
-如果请求其值的属性不存在,\fBpkgmogrify \fR 将退出并显示错误。为防止出现错误退出,请在属性名称后面附加 \fB;notfound=\fR 以及要用于替换属性值的值。例如,如果存在 \fBalias\fR 属性,则 \fB%(alias;notfound='no alias')\fR 输出该属性的值,否则输出 \fBno alias\fR。
-.sp
-.LP
-如果请求其值的属性具有多个值,则输出每个值,以空格隔开。与 \fBnotfound\fR 标记类似,标记 \fBprefix\fR、\fBsuffix\fR 和 \fBsep \fR 也可用于更改此行为。由 \fBprefix \fR 表示的字符串放置在每个值之前,由 \fBsuffix\fR 表示的字符串放置在每个值之后,而 \fBsep\fR 放置在某个值的后缀与下一个值的前缀之间。
-.sp
-.LP
-与操作属性类似,\fBpkgmogrify\fR 指令也可以使用花括 (而非圆括号)引用 件包属性:\fB%{pkg.fmri}\fR。应用 transform 指令时,必须已在 \fBset\fR 操作中定义了属性,否则会将其视为 \fBnotfound\fR,如上所述。当处理过程到达清单文件(介绍软件包)的结尾处时,将清除下一个软件包的属性。
-.sp
-.LP
-这不仅在将软件包属性视为操作属性来引用方面,而且在匹配甚至暂时修改这些属性方面,都很有用。因此,在这些情况下都可以使用合成属性名称 \fBpkg\fR(仅在 \fBpkgmogrify\fR 上下文中)。
-.sp
-.LP
-如果 \fBpkgmogrify\fR 完成读取在命令行中指定的清单并且该清单定义了 \fBpkg.fmri\fR 软件包属性,\fBpkgmogrify\fR 会创建此合成 \fBpkg\fR 操作,其属性为软件包的属性。\fB<transform>\fR 指令随后会对此操作进行匹配,正如它会对任何其他操作进行匹配一样。
-.sp
-.LP
-\fBpkg\fR 操作中的操作是特殊的,它们仅在内存中进行,不会直接影响发出的清单。例如,尝试通过 \fBadd\fR、\fBdefault\fR 或 \fBset\fR 操作设置 \fBpkg\fR 操作的属性时,不会使 \fBset\fR 操作添加到清单中,虽然该操作将可用于其他 \fB<transform>\fR 指令进行匹配。尝试 \fBemit\fR\fBpkg\fR 操作会导致错误。要添加软件包属性,改为 \fBemit\fR\fBset \fR 操作。
-.sp
-.LP
-第三种替换是逆向引用功能。该替换与在 \fBedit\fR 操作中可使用的替换不同,它是对 \fB->\fR 左侧的变换匹配中列出组的引用。它们由 \fB%<1>\fR、\fB %<2>\fR 等表示(以在匹配条件中显示的顺序)。
-.sp
-.LP
-处理顺序如下所示:
-.RS +4
-.TP
-1.
-从输入文件中读取行。
-.RE
-.RS +4
-.TP
-2.
-应用宏。
-.RE
-.RS +4
-.TP
-3.
-处理 \fB<include ...>\fR 和 \fB<transform>\fR 指令,从而找到并读取更多文件。
-.RE
-.RS +4
-.TP
-4.
-累积所有输入之后,输出中的每行都会转换为操作并应用所有变换。
-.RE
-.RS +4
-.TP
-5.
-成功完成处理后,写入输出。
-.RE
-.SH 示例
-.LP
-\fB示例 1 \fR将标记添加到 SMF 清单中
-.sp
-.LP
-将标记添加到服务管理工具 (Service Management Facility, SMF) 清单中,以便在活动系统上安装软件包时导入这些标记。
-
-.sp
-.in +2
-.nf
-<transform file path=(var|lib)/svc/manifest/.*\e.xml -> \e
-    add restart_fmri svc:/system/manifest-import:default>
-.fi
-.in -2
-
-.LP
-\fB示例 2 \fR移动文件
-.sp
-.LP
-将文件从 \fBusr/sfw/bin\fR 移至 \fBusr/bin\fR。
-
-.sp
-.in +2
-.nf
-<transform file -> edit path usr/sfw/bin usr/bin>
-.fi
-.in -2
-
-.LP
-\fB示例 3 \fR指定需要重新引导
-.sp
-.LP
-将 \fBreboot-needed\fR 标记添加到 \fB/kernel\fR 下 \fB\&.conf\fR 文件以外的文件中。请注意,以下示例利用了按照在输入文件中看见的顺序将变换应用到每个操作的方式。
-
-.sp
-.in +2
-.nf
-<transform file path=kernel/.* -> set reboot-needed true>
-<transform file path=kernel/.*\e.conf -> delete reboot-needed .*>
-.fi
-.in -2
-
-.sp
-.LP
-这还可以通过包含正则表达式的单个变换规则完成。
-
-.LP
-\fB示例 4 \fR将 FMRI 属性转换为 Depend 操作
-.sp
-.LP
-将软件包属性 \fBpkg.fmri\fR 转换为 \fBdepend\fR 操作,使其成为 incorporation 的一部分。
-
-.sp
-.in +2
-.nf
-<transform set name=pkg.fmri -> \e
+<refentry lang="zh" id="pkgmogrify-1">
+<refmeta><refentrytitle>pkgmogrify</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 7 月 12 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgmogrify</refname><refpurpose>映像包管理系统清单变换程序</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgmogrify [-vi] [-I <replaceable>includedir</replaceable>]...
+    [-D <replaceable>macro</replaceable>=<replaceable>value</replaceable>]... [-O <replaceable>
+outputfile</replaceable>]
+    [-P <replaceable>printfile</replaceable>] [<replaceable>inputfile</replaceable> ...]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="GKVND" role="description"><title></title>
+<para><command>pkgmogrify</command> 允许对软件包清单进行编程式编辑,以简化自动生成软件和自动发布软件包时所需的典型变换。</para>
+<itemizedlist>
+<para><command>pkgmogrify</command> 提供:</para>
+<listitem><para>宏替换,以便于在各种体系结构和平台间共享单个清单。</para></listitem>
+<listitem><para>包含其他清单或清单片段,例如标准组件和变换。</para></listitem>
+<listitem><para>变换软件包操作,包括修改、删除或添加操作属性。</para></listitem>
+</itemizedlist>
+</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>D</option> <replaceable>macro</replaceable>=<replaceable> value</replaceable></term>
+<listitem><para>将 <replaceable>macro</replaceable> 定义为一个宏,其值为 <replaceable>value</replaceable>。可以多次指定此选项。宏在输入文件中显示为 <literal> $(macro)</literal>。将重复执行替换操作,直到再也找不到变换。常见用语包括:</para>
+<itemizedlist>
+<listitem><para>通过在行的开头使用特定于体系结构的标记来删除其他体系结构清单中的行。</para>
+<programlisting>$(sparc_ONLY)file ...</programlisting>
+<para>处理 SPARC 体系结构时,该宏将被设置为空字符串。而处理其他体系结构时,该宏在命令行中会被设置为 <literal>#</literal>,从而从当前体系结构的清单中删除此操作。</para>
+</listitem>
+<listitem><para>指定路径名称中特定于平台的部分,例如,可执行文件和库的 64 位体系结构目录的名称:</para>
+<programlisting>file path=usr/bin/$(ARCH64)/cputrack ...</programlisting>
+<para>应当将这些宏设置为命令行中所需的值。不存在预定义的宏值。</para>
+</listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>I</option> <replaceable>includedir</replaceable></term>
+<listitem><para>将指定目录添加到在命令行上和为嵌入式 include 指令指定的文件的搜索路径中。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>O</option> <replaceable>outputfile</replaceable></term>
+<listitem><para>将清单输出写入指定的文件中。如果出现错误或 transform 指令引起中止操作,则不会写入该文件。缺省情况下,清单输出会写入 <filename>stdout</filename>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>P</option> <replaceable>printfile</replaceable></term>
+<listitem><para>将 transform 指令输出操作生成的输出写入指定的文件。如果出现错误或 transform 指令引起中止操作,则不会写入该文件。缺省情况下,输出会写入 <filename>stdout</filename>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option></term>
+<listitem><para>忽略文件中的 include 指令。仅处理在命令行(或 <filename>stdin</filename>)中指定的文件。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>将注释写入显示变换效果的输出清单。该信息可以帮助调试。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="other"><title>嵌入式指令</title>
+<para>清单文件支持两种类型的指令:include 指令和 transform 指令。</para>
+<para>Include 指令的格式为:</para>
+<programlisting>&lt;include <replaceable>file</replaceable>></programlisting>
+<para>该指令能够使 <command>pkgmogrify</command> 首先在当前目录中搜索名为 <literal>file</literal> 的文件,然后在 <option>I</option> 选项指定的目录中搜索该文件。如果找到,则会将该文件的内容插入清单中遇到该指令的位置。如果未找到,<command>pkgmogrify</command> 将退出并显示错误。</para>
+<para>Transform 指令的格式为:</para>
+<programlisting>&lt;transform <replaceable>matching-criteria</replaceable> -> <replaceable>
+operation</replaceable>></programlisting>
+<para>这些指令会进行累积(直到将所有输入都读入内存中),然后按遇到这些指令的顺序应用到操作。
+</para>
+<para>匹配条件的格式为:</para>
+<programlisting>[<replaceable>action-name</replaceable> ... ] [<replaceable>attribute
+</replaceable>=&lt;<replaceable>value-regexp</replaceable>> ...]</programlisting>
+<para>必须至少匹配一个指定的 <replaceable>action-name</replaceable>。必须匹配指定的每个 <replaceable>attribute</replaceable>。操作名称和属性列在 <literal>pkg</literal>(5) 手册页的“操作”中。使用的正则表达式语法是 Python 语法。有关 Python 正则表达式语法的更多信息,请使用命令 <command>pydoc re</command> 或请参见 <literal>http://docs.python.org/dev/howto/regex.html </literal> 中更为完整的文档。该正则表达式固定于开头而非结尾。因此,通过文件扩展名进行匹配的正则表达式匹配文件必须包含前导 <literal>.*</literal>,且应当包含结尾 <literal> $</literal>。</para>
+<para>可以指定多个条件,以空格分隔。</para>
+<para>有以下操作可用:</para>
+<variablelist>
+<varlistentry><term><literal>add</literal></term>
+<listitem><para>将值添加到属性中。此操作使用两个参数。第一个参数是属性的名称,第二个参数是对应值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>default</literal></term>
+<listitem><para>如果不存在属性值,则设置该属性值。此操作与 <command>add</command> 操作使用相同的两个参数。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>delete</literal></term>
+<listitem><para>删除属性值。此操作使用两个参数。第一个参数是属性的名称。第二个参数是要与删除的属性值匹配的正则表达式。与用于匹配操作的正则表达式不同,该正则表达式并不是固定的。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>drop</literal></term>
+<listitem><para>放弃该操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>edit</literal></term>
+<listitem><para>修改操作的属性。此操作使用三个参数。第一个参数是属性的名称,第二个参数是与属性值匹配的正则表达式。第三个参数是用于替换正则表达式匹配的部分值的替换字符串。与用于匹配操作的正则表达式不同,该正则表达式并不是固定的。如果在正则表达式中定义了组,则在替换字符串中可以使用 <literal>\1</literal>、<literal>\2</literal> 等格式的一般正则表达式向后引用。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>emit</literal></term>
+<listitem><para>向清单输出流中发出一行。此行必须是有效操作字符串、为空(导致空白行)或注释(<literal> #</literal> 后面跟有任意文本)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>exit</literal></term>
+<listitem><para>终止清单处理过程。不输出任何清单,也不应用任何 <literal> print</literal> 操作。如果给定一个参数,该参数必须是整数并且用作退出代码。缺省为 0。如果给定两个参数,则第一个参数是退出代码,第二个参数是要输出到 <filename>stderr</filename> 的消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>print</literal></term>
+<listitem><para>将消息列显到 <option>P</option> 指定的输出文件中。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>set</literal></term>
+<listitem><para>设置属性的值。此操作与 <command>add</command> 操作使用相同的两个参数。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>除了 <literal>delete</literal> 和 <literal>drop</literal> 以外的所有操作都使用其内容输出到输出流的参数(可能是可选的)。这些字符串可能包含三种不同类型的特殊标记,这些标记允许输出包含不基于每种操作的固定变换的信息。</para>
+<para>第一种替换通过将属性的名称放置在括号内(跟随在百分号后面),允许操作引用当前操作的属性值。例如,<literal>%(alias)</literal> 引用操作的 <literal>alias</literal> 属性的值。</para>
+<itemizedlist>
+<para>存在几个合成属性。以下两个对 <command>pkgmogrify</command> 而言是唯一的:
+</para>
+<listitem><para><literal>pkg.manifest.filename</literal> 引用在其中找到操作的文件的名称。</para></listitem>
+<listitem><para><literal>pkg.manifest.lineno</literal> 引用在其中找到操作的行。</para></listitem>
+</itemizedlist>
+<itemizedlist>
+<para>以下三个合成属性类似于 <command>pkg</command> 中使用的属性:
+</para>
+<listitem><para><literal>action.hash</literal> 引用操作的散列值(如果该操作携带有效负荷)。对于携带有效负荷的操作,<literal> set</literal> 操作可以通过对 <literal>action.hash</literal> 属性进行操作来更改该操作的散列。</para></listitem>
+<listitem><para><literal>action.key</literal> 引用关键属性的值。</para></listitem>
+<listitem><para><literal>action.name</literal> 引用操作的名称。</para>
+</listitem>
+</itemizedlist>
+<para>如果请求其值的属性不存在,<command>pkgmogrify </command> 将退出并显示错误。为防止出现错误退出,请在属性名称后面附加 <literal>;notfound=</literal> 以及要用于替换属性值的值。例如,如果存在 <literal>alias</literal> 属性,则 <literal>%(alias;notfound='no alias')</literal> 输出该属性的值,否则输出 <literal>no alias</literal>。</para>
+<para>如果请求其值的属性具有多个值,则输出每个值,以空格隔开。与 <literal>notfound</literal> 标记类似,标记 <literal>prefix</literal>、<literal>suffix</literal> 和 <literal>sep </literal> 也可用于更改此行为。由 <literal>prefix </literal> 表示的字符串放置在每个值之前,由 <literal>suffix</literal> 表示的字符串放置在每个值之后,而 <literal>sep</literal> 放置在某个值的后缀与下一个值的前缀之间。</para>
+<para>与操作属性类似,<command>pkgmogrify</command> 指令也可以使用花括 (而非圆括号)引用 件包属性:<literal>%{pkg.fmri}</literal>。应用 transform 指令时,必须已在 <literal>set</literal> 操作中定义了属性,否则会将其视为 <literal>notfound</literal>,如上所述。当处理过程到达清单文件(介绍软件包)的结尾处时,将清除下一个软件包的属性。</para>
+<para>这不仅在将软件包属性视为操作属性来引用方面,而且在匹配甚至暂时修改这些属性方面,都很有用。因此,在这些情况下都可以使用合成属性名称 <literal>pkg</literal>(仅在 <command>pkgmogrify</command> 上下文中)。
+</para>
+<para>如果 <command>pkgmogrify</command> 完成读取在命令行中指定的清单并且该清单定义了 <literal>pkg.fmri</literal> 软件包属性,<command>pkgmogrify</command> 会创建此合成 <literal>pkg</literal> 操作,其属性为软件包的属性。<literal>&lt;transform></literal> 指令随后会对此操作进行匹配,正如它会对任何其他操作进行匹配一样。</para>
+<para><literal>pkg</literal> 操作中的操作是特殊的,它们仅在内存中进行,不会直接影响发出的清单。例如,尝试通过 <literal>add</literal>、<literal>default</literal> 或 <literal>set</literal> 操作设置 <literal>pkg</literal> 操作的属性时,不会使 <literal>set</literal> 操作添加到清单中,虽然该操作将可用于其他 <literal>&lt;transform&gt;</literal> 指令进行匹配。尝试 <literal>emit</literal><literal>pkg</literal> 操作会导致错误。要添加软件包属性,改为 <literal>emit</literal><literal>set </literal> 操作。</para>
+<para>第三种替换是逆向引用功能。该替换与在 <literal>edit</literal> 操作中可使用的替换不同,它是对 <literal>-&gt;</literal> 左侧的变换匹配中列出组的引用。它们由 <literal>%&lt;1&gt;</literal>、<literal> %&lt;2&gt;</literal> 等表示(以在匹配条件中显示的顺序)。</para>
+<orderedlist>
+<para>处理顺序如下所示:</para>
+<listitem><para>从输入文件中读取行。</para></listitem>
+<listitem><para>应用宏。</para></listitem>
+<listitem><para>处理 <literal>&lt;include ...&gt;</literal> 和 <literal>&lt;transform&gt;</literal> 指令,从而找到并读取更多文件。</para></listitem>
+<listitem><para>累积所有输入之后,输出中的每行都会转换为操作并应用所有变换。</para></listitem>
+<listitem><para>成功完成处理后,写入输出。</para></listitem>
+</orderedlist></refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>将标记添加到 SMF 清单中</title>
+<para>将标记添加到服务管理工具 (Service Management Facility, SMF) 清单中,以便在活动系统上安装软件包时导入这些标记。</para>
+<programlisting>&lt;transform file path=(var|lib)/svc/manifest/.*&bsol;.xml -> &bsol;
+    add restart_fmri svc:/system/manifest-import:default></programlisting>
+</example>
+<example><title>移动文件</title>
+<para>将文件从 <filename>usr/sfw/bin</filename> 移至 <filename>usr/bin</filename>。
+</para>
+<programlisting>&lt;transform file -> edit path usr/sfw/bin usr/bin></programlisting>
+</example>
+<example><title>指定需要重新引导</title>
+<para>将 <literal>reboot-needed</literal> 标记添加到 <filename>/kernel</filename> 下 <filename>.conf</filename> 文件以外的文件中。请注意,以下示例利用了按照在输入文件中看见的顺序将变换应用到每个操作的方式。</para>
+<programlisting>&lt;transform file path=kernel/.* -> set reboot-needed true>
+&lt;transform file path=kernel/.*&bsol;.conf -> delete reboot-needed .*></programlisting>
+<para>这还可以通过包含正则表达式的单个变换规则完成。</para>
+</example>
+<example><title>将 FMRI 属性转换为 Depend 操作</title>
+<para>将软件包属性 <literal>pkg.fmri</literal> 转换为 <literal>depend</literal> 操作,使其成为 incorporation 的一部分。</para>
+<programlisting>&lt;transform set name=pkg.fmri -> &bsol;
     emit depend type=incorporate fmri=%(value)>
-<transform set name=pkg.fmri -> drop>
-.fi
-.in -2
-
-.LP
-\fB示例 5 \fR输出错误编号列表
-.sp
-.LP
-输出带有双引号和前缀的错误编号的逗号分隔列表。
+&lt;transform set name=pkg.fmri -> drop></programlisting>
+</example>
+<example><title>列显错误编号列表</title>
+<para>列显带有双引号和前缀的错误编号的逗号分隔列表。</para>
+<programlisting>set name=bugs value=12345 value=54321 value=13579 value=97531
+&lt;transform set name=bugs -> &bsol;
+    print %(value;sep=",";prefix="bug='";suffix="'")></programlisting>
+</example>
+<example><title>允许丢失属性</title>
+<para>即使是在丢失属性时,也可以安全输出消息。</para>
+<programlisting>&lt;transform driver -> print Found aliases: %(alias;notfound=&lt;none>)>
+</programlisting>
+</example>
+<example><title>设置缺省值</title>
+<para>设置缺省所有者、组以及权限的值。</para>
+<programlisting>&lt;transform file dir -> default owner root>
+&lt;transform file dir -> default group bin>
+&lt;transform file -> default mode 0444>
+&lt;transform dir -> default mode 0755></programlisting>
+</example>
+<example><title>将依赖项添加到未标记为已过时的软件包中</title>
+<para>对于未标记为已过时的任何软件包,为提供软件包的合并添加对 incorporation 的依赖。必须在读入清单后执行该组变换,否则始终发出依赖项。因为修改 <literal>pkg</literal> 操作不会永久起作用,所以无需清除匹配 <literal> pkg.obsolete=false</literal> 的属性。</para>
+<programlisting>&lt;transform pkg -> default pkg.obsolete false>
+&lt;transform pkg pkg.obsolete=false -> emit depend &bsol;
+    fmri=consolidation/$(CONS)/$(CONS)-incorporation type=require></programlisting>
+</example>
+<example><title>发现问题时退出并输出消息</title>
+<para>在清单中发现已过时属性时退出并输出错误消息。
+</para>
+<programlisting>&lt;transform file dir link hardlink opensolaris.zone=.* -> &bsol;
+    exit 1 The opensolaris.zone attribute is obsolete.></programlisting>
+</example>
+<example><title>设置合适的语言环境侧面</title>
+<para>设置适用于正在考虑的路径名称的语言环境侧面。</para>
+<programlisting>&lt;transform dir file link hardlink path=.*/locale/([^/]+).* -> &bsol;
+    default facet.locale.%&lt;1> true></programlisting>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>一切正常工作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现预料中的错误情况。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>意外的处理错误。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="files"><title></title>
+<variablelist termlength="wholeline">
+<varlistentry><term><filename>/usr/share/pkg/transforms</filename></term>
+<listitem><para>该目录包含使用有用变换设置侧面、执行器和其他属性的文件。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg </refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle> <manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-set name=bugs value=12345 value=54321 value=13579 value=97531
-<transform set name=bugs -> \e
-    print %(value;sep=",";prefix="bug='";suffix="'")>
-.fi
-.in -2
-
-.LP
-\fB示例 6 \fR允许丢失属性
-.sp
-.LP
-即使是在丢失属性时,也可以安全输出消息。
-
-.sp
-.in +2
-.nf
-<transform driver -> print Found aliases: %(alias;notfound=<none>)>
-.fi
-.in -2
-
-.LP
-\fB示例 7 \fR设置缺省值
-.sp
-.LP
-设置缺省所有者、组以及权限的值。
-
-.sp
-.in +2
-.nf
-<transform file dir -> default owner root>
-<transform file dir -> default group bin>
-<transform file -> default mode 0444>
-<transform dir -> default mode 0755>
-.fi
-.in -2
-
-.LP
-\fB示例 8 \fR将依赖项添加到未标记为已过时的软件包中
-.sp
-.LP
-对于未标记为已过时的任何软件包,为提供软件包的合并添加对 incorporation 的依赖。必须在读入清单后执行该组变换,否则始终发出依赖项。因为修改 \fBpkg\fR 操作不会永久起作用,所以无需清除匹配 \fB pkg.obsolete=false\fR 的属性。
-
-.sp
-.in +2
-.nf
-<transform pkg -> default pkg.obsolete false>
-<transform pkg pkg.obsolete=false -> emit depend \e
-    fmri=consolidation/$(CONS)/$(CONS)-incorporation type=require>
-.fi
-.in -2
-
-.LP
-\fB示例 9 \fR发现问题时退出并输出消息
-.sp
-.LP
-在清单中发现已过时属性时退出并输出错误消息。
-
-.sp
-.in +2
-.nf
-<transform file dir link hardlink opensolaris.zone=.* -> \e
-    exit 1 The opensolaris.zone attribute is obsolete.>
-.fi
-.in -2
-
-.LP
-\fB示例 10 \fR设置合适的语言环境侧面
-.sp
-.LP
-设置适用于正在考虑的路径名称的语言环境侧面。
-
-.sp
-.in +2
-.nf
-<transform dir file link hardlink path=.*/locale/([^/]+).* -> \e
-    default facet.locale.%<1> true>
-.fi
-.in -2
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-一切正常工作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-出现预料中的错误情况。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-意外的处理错误。
-.RE
-
-.SH 文件
-.sp
-.ne 2
-.mk
-.na
-\fB\fB/usr/share/pkg/transforms\fR\fR
-.ad
-.sp .6
-.RS 4n
-该目录包含使用有用变换设置侧面、执行器和其他属性的文件。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(1)、\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/zh_CN/pkgrecv.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgrecv.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,378 +1,164 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgrecv 1 "2013 年 11 月 21 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgrecv \- 映像包管理系统内容检索实用程序
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgrecv [-aknrv] [-s (\fIsrc_path\fR|\fIsrc_uri\fR)]
-    [-d (\fIdest_path\fR|\fIdest_uri\fR)] [-c \fIcache_dir\fR]
-    [-m \fImatch\fR] [--raw]
-    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR]
-    [--dkey \fIdest_key\fR --dcert \fIdest_cert\fR]
-    (\fIfmri\fR|\fIpattern\fR) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrecv [-s (\fIsrc_path\fR|\fIsrc_uri\fR)] --newest
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrecv [-nv] [-s (\fIsrc_path\fR|\fIsrc_uri\fR)]
-    [-d (\fIdest_path\fR|\fIdest_uri\fR)] [-p \fIpublisher\fR]...
-    [--key \fIsrc_key\fR --cert \fIsrc_cert\fR] --clone
-.fi
+<?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;
+]>
 
-.SH 描述
-.sp
-.LP
-\fBpkgrecv\fR 从 \fB-s\fR 选项指定的 \fBpkg\fR(5) 系统信息库或软件包归档文件检索每个匹配 \fIfmri\fR 或 \fIpattern\fR 的软件包的所有版本,并且可以将检索到的软件包重新发布到 \fB-d\fR 选项指定的软件包系统信息库或软件包归档文件。缺省情况下,会以 \fBpkg\fR、\fBpkg.depotd\fR 以及软件包发布工具可使用的软件包系统信息库格式检索软件包。
-.sp
-.LP
-不重新发布未更改的软件包。因此,更新现有系统信息库的时间取决于新的和已更改软件包的数量。
-.sp
-.LP
-使用 \fB-m\fR 选项可指定是检索每个匹配软件包的所有版本还是每个匹配软件包的最新版本。
-.sp
-.LP
-如果未指定要检索的 \fB\&'*'\fR,则可以指定 \fB-r\fR 选项来确保检索指定软件包的所有依赖项。
-.LP
-注 - 
-.sp
-.RS 2
-不要同时使用 \fBpkgrecv\fR 的多个实例来将软件包重新发布到同一目标系统信息库或归档文件。在这种情况下,新检索的软件包可以包含重复操作。
-.RE
-.sp
-.LP
-在将软件包检索到 \fIdest_uri\fR 中的 \fBpkgrecv\fR 操作后,如果 \fIdest_uri\fR 系统信息库必须支持 \fBpkg search\fR 操作,则在该系统信息库上运行 \fBpkgrepo refresh\fR 以更新搜索索引。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR\fR
-.ad
-.sp .6
-.RS 4n
-将检索的软件包数据存储在 \fB-d\fR 选项指定的位置中的 \fBpkg\fR(5) 归档文件中。\fB-d\fR 指定的文件不能已经存在。\fB-a\fR 选项仅可以与基于文件系统的目标一起使用。尽管不要求,但还是强烈建议使用文件扩展名 \fB\&.p5p\fR(例如:\fB archive.p5p\fR)。\fB-a\fR 选项不能与 \fB--raw\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIcache_dir\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定将用于缓存已下载内容的目录的路径。如果没有提供此目录,客户机将自动选择一个高速缓存目录。如果下载中断并且已自动选择了一个高速缓存目录,可使用该选项继续执行下载。有关如何设置用于存储临时数据的位置的详细信息,请参见下文的“环境变量”部分。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR (\fIdest_path\fR|\fIdest_uri\fR)\fR
-.ad
-.sp .6
-.RS 4n
-指定应重新发布检索的软件包的文件系统路径或 URI。如果指定 \fB-a\fR,此目标必须是尚未存在的软件包归档文件。如果未指定 \fB-a\fR,此目标必须是已经存在的软件包系统信息库。使用 \fBpkgrepo\fR 命令创建新软件包系统信息库。如果未指定 \fB-d\fR,则使用值 \fBPKG_DEST\fR。请参见下面的“环境变量”。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR\fR
-.ad
-.sp .6
-.RS 4n
-使检索的软件包内容保持压缩状态。重新发布时会忽略该选项。压缩的软件包内容不得与 \fBpkgsend\fR 一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR \fImatch\fR\fR
-.ad
-.sp .6
-.RS 4n
-在指定 \fIpattern\fR 或未充分指定 \fIfmri\fR 时控制要检索哪些软件包版本。在下面的说明中,\fB-s\fR 选项所指定的源中存在下面的四个示例软件包。在这些 FMRI 中,\fB@\fR 与 \fB:\fR 之间的字符表示已编号的软件包版本,\fB:\fR 至结尾的字符表示版本字符串的时间戳部分。
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+<refentry lang="zh" id="pkgrecv-1">
+<refmeta><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 11 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgrecv</refname> <refpurpose>映像包管理系统内容检索实用程序</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgrecv [-aknrv] [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)]
+    [-d (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)] [-c <replaceable>cache_dir</replaceable>]
+    [-m <replaceable>match</replaceable>] [--raw]
+    [--key <replaceable>src_key</replaceable> --cert <replaceable>src_cert</replaceable>]
+    [--dkey <replaceable>dest_key</replaceable> --dcert <replaceable>dest_cert</replaceable>]
+    (<replaceable>fmri</replaceable>|<replaceable>pattern</replaceable>) ...</synopsis>
+<synopsis>/usr/bin/pkgrecv [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)] --newest</synopsis>
+<synopsis>/usr/bin/pkgrecv [-nv] [-s (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)]
+    [-d (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)] [-p <replaceable>publisher</replaceable>]...
+    [--key <replaceable>src_key</replaceable> --cert <replaceable>src_cert</replaceable>] --clone
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgrecv-1-desc" role="description"><title></title>
+<para><command>pkgrecv</command> 从 <option>s</option> 选项指定的 <literal>pkg</literal>(5) 系统信息库或软件包归档文件检索每个匹配 <replaceable>fmri</replaceable> 或 <replaceable>pattern</replaceable> 的软件包的所有版本,并且可以将检索到的软件包重新发布到 <option>d</option> 选项指定的软件包系统信息库或软件包归档文件。缺省情况下,会以 <command>pkg</command>、<command>pkg.depotd</command> 以及软件包发布工具可使用的软件包系统信息库格式检索软件包。</para>
+<para>不重新发布未更改的软件包。因此,更新现有系统信息库的时间取决于新的和已更改软件包的数量。</para>
+<para>使用 <option>m</option> 选项可指定是检索每个匹配软件包的所有版本还是每个匹配软件包的最新版本。</para>
+<para>如果未指定要检索的 <literal>'*'</literal>,则可以指定 <option>r</option> 选项来确保检索指定软件包的所有依赖项。</para>
+<note><para>不要同时使用 <command>pkgrecv</command> 的多个实例来将软件包重新发布到同一目标系统信息库或归档文件。在这种情况下,新检索的软件包可以包含重复操作。</para></note>
+<para>在将软件包检索到 <replaceable>dest_uri</replaceable> 中的 <command>pkgrecv</command> 操作后,如果 <replaceable>dest_uri</replaceable> 系统信息库必须支持 <command>pkg search</command> 操作,则在该系统信息库上运行 <command>pkgrepo refresh</command> 以更新搜索索引。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>支持以下选项:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option></term>
+<listitem><para>将检索的软件包数据存储在 <option>d</option> 选项指定的位置中的 <literal>pkg</literal>(5) 归档文件中。<option>d</option> 指定的文件不能已经存在。<option>a</option> 选项仅可以与基于文件系统的目标一起使用。尽管不要求,但还是强烈建议使用文件扩展名 <literal>.p5p</literal>(例如:<literal> archive.p5p</literal>)。<option>a</option> 选项不能与 <option>-raw</option> 选项一起使用。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>cache_dir</replaceable></term>
+<listitem><para>指定将用于缓存已下载内容的目录的路径。如果没有提供此目录,客户机将自动选择一个高速缓存目录。如果下载中断并且已自动选择了一个高速缓存目录,可使用该选项继续执行下载。有关如何设置用于存储临时数据的位置的详细信息,请参见下文的“环境变量”部分。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> (<replaceable>dest_path</replaceable>|<replaceable>dest_uri</replaceable>)</term>
+<listitem><para>指定应重新发布检索的软件包的文件系统路径或 URI。如果指定 <option>a</option>,此目标必须是尚未存在的软件包归档文件。如果未指定 <option>a</option>,此目标必须是已经存在的软件包系统信息库。使用 <command>pkgrepo</command> 命令创建新软件包系统信息库。如果未指定 <option>d</option>,则使用值 <envar>PKG_DEST</envar>。请参见下面的“环境变量”。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option></term>
+<listitem><para>使检索的软件包内容保持压缩状态。重新发布时会忽略该选项。压缩的软件包内容不得与 <command>pkgsend</command> 一起使用。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>m</option> <replaceable>match</replaceable></term>
+<listitem><para>在指定 <replaceable>pattern</replaceable> 或未充分指定 <replaceable>fmri</replaceable> 时控制要检索哪些软件包版本。在下面的说明中,<option>s</option> 选项所指定的源中存在下面的四个示例软件包。在这些 FMRI 中,<literal>@</literal> 与 <literal>:</literal> 之间的字符表示已编号的软件包版本,<literal>:</literal> 至结尾的字符表示版本字符串的时间戳部分。</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120903T170234Z
 pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120819T155007Z
-.fi
-.in -2
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBall-timestamps\fR\fR
-.ad
-.sp .6
-.RS 4n
-检索匹配 \fIfmri\fR 或\fI pattern\fR 的每个软件包的所有版本(隐式的 \fBall-versions\fR)。如果未指定 \fB-m\fR 选项,这将是缺省行为。在上面的例子中,将检索到全部四个软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBall-versions\fR\fR
-.ad
-.sp .6
-.RS 4n
-检索匹配 \fIfmri\fR 或 \fIpattern\fR 的每个软件包的每个版本的最新时间戳。在上面的例子中,将检索到下面两个软件包:
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z
-.fi
-.in -2
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBlatest\fR\fR
-.ad
-.sp .6
-.RS 4n
-只检索匹配 \fIfmri\fR 或 \fIpattern\fR 的每个软件包的最新版本。在上面的例子中,将检索到下面的软件包:
-.sp
-.in +2
-.nf
-pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
-.fi
-.in -2
-
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-执行试运行,不进行任何更改。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-只克隆指定的发布者。可以多次指定此选项。\fB-p\fR 选项只有在与 \fB--clone\fR 选项一起使用时才有效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-r\fR\fR
-.ad
-.sp .6
-.RS 4n
-递归检索每个匹配的 \fIfmri\fR 或 \fIpattern\fR 的所有依赖项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR (\fIsrc_path\fR|\fIsrc_uri\fR)\fR
-.ad
-.sp .6
-.RS 4n
-指定要从中接收软件包数据的 \fBpkg\fR(5) 系统信息库或软件包归档文件的文件系统路径或 URI。如果未指定 \fB-s\fR,则使用值 \fBPKG_SRC\fR。请参见下面的“环境变量”。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示详细输出,包括检索到的软件包个数及其完整 FMRI、检索到的文件个数以及估计的传输大小。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIsrc_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定用于从源 HTTPS 系统信息库进行软件包检索的客户机 SSL 密钥文件。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--cert\fR \fIsrc_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定用于从源 HTTPS 系统信息库进行软件包检索的客户机 SSL 证书文件。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--dkey\fR \fIdest_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定用于向目标 HTTPS 系统信息库发布软件包的客户机 SSL 密钥文件。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--dcert\fR \fIdest_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定用于向目标 HTTPS 系统信息库发布软件包的客户机 SSL 证书文件。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--clone\fR\fR
-.ad
-.sp .6
-.RS 4n
-为源系统信息库创建完全一致的副本。缺省情况下,仅当源系统信息库中的发布者也存在于目标中时,克隆操作才会成功。要限制仅对指定的发布者使用克隆操作,请使用 \fB-p\fR 选项。使用 \fB-p\fR 选项指定的发布者如果不在目标系统信息库中,则会将其添加到其中。存在于目标系统信息库中但不在源系统信息库中的软件包将被删除。如果发生错误,克隆操作会导致目标系统信息库更改。因此,目标系统信息库应位于自己的 ZFS 数据集中,并且在执行克隆操作之前应创建一个快照。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--newest\fR\fR
-.ad
-.sp .6
-.RS 4n
-列出 \fB-s\fR 选项指定的系统信息库中提供的最新版本的软件包。将忽略所有其他选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--raw\fR\fR
-.ad
-.sp .6
-.RS 4n
-按主干和版本,检索一组目录结构中的原始软件包数据并将其存储在 \fB-d\fR 指定的位置中。\fB--raw\fR 选项仅可以与基于文件系统的目标一起使用。此软件包数据可用于方便地修改和重新发布软件包,也许通过更正文件内容,也许通过提供附加的软件包元数据。\fB--raw\fR 选项不能与 \fB-a\fR 一起使用。
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR列出最新的软件包
-.sp
-.LP
-列出名为 \fBtest\fR 的系统上的系统信息库中的最新软件包。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test --newest\fR
+pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120819T155007Z</programlisting>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>all-timestamps</literal></term>
+<listitem><para>检索匹配 <replaceable>fmri</replaceable> 或<replaceable> pattern</replaceable> 的每个软件包的所有版本(隐式的 <literal>all-versions</literal>)。如果未指定 <option>m</option> 选项,这将是缺省行为。在上面的例子中,将检索到全部四个软件包。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>all-versions</literal></term>
+<listitem><para>检索匹配 <replaceable>fmri</replaceable> 或 <replaceable>pattern</replaceable> 的每个软件包的每个版本的最新时间戳。在上面的例子中,将检索到下面两个软件包:</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+pkg://solaris/package/[email protected],5.11-0.175.1.0.0.23.0:20120820T165108Z</programlisting>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>latest</literal></term>
+<listitem><para>只检索匹配 <replaceable>fmri</replaceable> 或 <replaceable>pattern</replaceable> 的每个软件包的最新版本。在上面的例子中,将检索到下面的软件包:</para>
+<programlisting>pkg://solaris/package/[email protected],5.11-0.175.1.0.0.24.0:20120904T180335Z
+</programlisting>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>执行试运行,不进行任何更改。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>只克隆指定的发布者。可以多次指定此选项。<option>p</option> 选项只有在与 <option>-clone</option> 选项一起使用时才有效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>r</option></term>
+<listitem><para>递归检索每个匹配的 <replaceable>fmri</replaceable> 或 <replaceable>pattern</replaceable> 的所有依赖项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> (<replaceable>src_path</replaceable>|<replaceable>src_uri</replaceable>)</term>
+<listitem><para>指定要从中接收软件包数据的 <literal>pkg</literal>(5) 系统信息库或软件包归档文件的文件系统路径或 URI。如果未指定 <option>s</option>,则使用值 <envar>PKG_SRC</envar>。请参见下面的“环境变量”。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>v</option></term>
+<listitem><para>显示详细输出,包括检索到的软件包个数及其完整 FMRI、检索到的文件个数以及估计的传输大小。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>src_key</replaceable></term>
+<listitem><para>指定用于从源 HTTPS 系统信息库进行软件包检索的客户机 SSL 密钥文件。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-cert</option> <replaceable>src_cert</replaceable></term>
+<listitem><para>指定用于从源 HTTPS 系统信息库进行软件包检索的客户机 SSL 证书文件。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-dkey</option> <replaceable>dest_key</replaceable></term>
+<listitem><para>指定用于向目标 HTTPS 系统信息库发布软件包的客户机 SSL 密钥文件。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-dcert</option> <replaceable>dest_cert</replaceable></term>
+<listitem><para>指定用于向目标 HTTPS 系统信息库发布软件包的客户机 SSL 证书文件。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-clone</option></term>
+<listitem><para>为源系统信息库创建完全一致的副本。缺省情况下,仅当源系统信息库中的发布者也存在于目标中时,克隆操作才会成功。要限制仅对指定的发布者使用克隆操作,请使用 <option>p</option> 选项。使用 <option>p</option> 选项指定的发布者如果不在目标系统信息库中,则会将其添加到其中。存在于目标系统信息库中但不在源系统信息库中的软件包将被删除。如果发生错误,克隆操作会导致目标系统信息库更改。因此,目标系统信息库应位于自己的 ZFS 数据集中,并且在执行克隆操作之前应创建一个快照。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-newest</option></term>
+<listitem><para>列出 <option>s</option> 选项指定的系统信息库中提供的最新版本的软件包。将忽略所有其他选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-raw</option></term>
+<listitem><para>按主干和版本,检索一组目录结构中的原始软件包数据并将其存储在 <option>d</option> 指定的位置中。<option>-raw</option> 选项仅可以与基于文件系统的目标一起使用。此软件包数据可用于方便地修改和重新发布软件包,也许通过更正文件内容,也许通过提供附加的软件包元数据。<option>-raw</option> 选项不能与 <option>a</option> 一起使用。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>列出最新的软件包</title>
+<para>列出名为 <literal>test</literal> 的系统上的系统信息库中的最新软件包。</para>
+<screen>$ <userinput>pkgrecv -s http://test --newest</userinput>
 pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z
 pkg://solaris/system/library/[email protected],5.11-0.175.1.0.0.7.1234:20120109T215840Z
-pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190432Z
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR检索原始软件包数据
-.sp
-.LP
-以能够与 \fBpkgsend publish\fR 结合使用的合适格式从示例 1 中接收 \fBc++-runtime\fR 软件包。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test \e\fR
-\fB-d /local/repo --raw \e\fR
-\[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z\fR
+pkg://solaris/system/library/[email protected],5.11-0.175.0.0.0.2.1:20120921T190432Z</screen>
+</example>
+<example><title>检索原始软件包数据</title>
+<para>以能够与 <command>pkgsend publish</command> 结合使用的合适格式从示例 1 中接收 <literal>c++-runtime</literal> 软件包。</para>
+<screen>$ <userinput>pkgrecv -s http://test &bsol;</userinput>
+<userinput>-d /local/repo --raw &bsol;</userinput>
+<userinput>[email protected],5.11-0.175.0.0.0.2.1:20120921T190358Z</userinput>
 Processing packages for publisher solaris ...
 Retrieving and evaluating 1 package(s)...
 PROCESS       ITEMS     GET (MB)    SEND (MB)
 Completed       1/1      3.5/3.5      0.0/0.0
-$ \fBls /local/repo\fR
-pkg5.repository  publisher  system%2Flibrary%2Fc%2B%2B-runtime
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 3 \fR从系统中检索依赖项
-.sp
-.LP
-从名为 \fBtest\fR 的系统中接收软件包 \fBeditor/vim\fR 及其所有依赖项。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d /local/repo -r editor/vim\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 4 \fR仅检索最新版本
-.sp
-.LP
-仅从名为 \fBtest\fR 的系统中接收软件包 \fBeditor/vim\fR 的最新版本。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d /local/repo -m latest -v \e\fR
-\fBeditor/vim\fR
+$ <userinput>ls /local/repo</userinput>
+pkg5.repository  publisher  system%2Flibrary%2Fc%2B%2B-runtime</screen>
+</example>
+<example><title>从系统中检索依赖项</title>
+<para>从名为 <literal>test</literal> 的系统中接收软件包 <literal>editor/vim</literal> 及其所有依赖项。</para>
+<screen>$ <userinput>pkgrecv -s http://test -d /local/repo -r editor/vim</userinput></screen>
+</example>
+<example><title>仅检索最新版本</title>
+<para>仅从名为 <literal>test</literal> 的系统中接收软件包 <literal>editor/vim</literal> 的最新版本。</para>
+<screen>$ <userinput>pkgrecv -s http://test -d /local/repo -m latest -v &bsol;</userinput>
+<userinput>editor/vim</userinput>
 Processing packages for publisher solaris ...
 Retrieving and evaluating 1 package(s)...
 
@@ -385,225 +171,118 @@
 editor/[email protected],5.11-0.175.1.0.0.24.0:20120904T172128Z
 
 PROCESS                                     ITEMS    GET (MB) SEND (MB)
-Completed                                     1/1     9.2/9.2 25.4/25.4
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 5 \fR检索所有版本并远程重新发布
-.sp
-.LP
-从名为 \fBtest\fR 的系统中接收软件包 \fBlibrary/zlib\fR 的所有版本,然后将其重新发布到名为 \fBremote\fR 的系统上的远程系统信息库中。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://test -d http://remote:10000 \e\fR
-\fB-m all-versions library/zlib\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 6 \fR从系统信息库中检索依赖项
-.sp
-.LP
-从位于 \fB/export/repo\fR 的系统信息库中接收软件包 \fBeditor/gnu-emacs\fR 及其所有依赖项。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 7 \fR检索其他软件包和更改的内容
-.sp
-.LP
-从位于 \fBhttp://pkg.oracle.com/solaris/release/\fR 的系统信息库中将并非已存在的所有软件包和所有已更改内容接收到位于 \fB/export/repoSolaris11\fR 的系统信息库。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://pkg.oracle.com/solaris/release/ \e\fR
-\fB-d /export/repoSolaris11 -m all-timestamps '*'\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-将位于 \fBhttps://pkg.oracle.com/solaris/support/\fR的安全系统信息库中的所有尚不存在的软件包和所有更改内容接收到位于 \fB/export/repoSolaris11\fR 的系统信息库。 
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s https://pkg.oracle.com/solaris/support/ \e\fR
-\fB-d /export/repoSolaris11 -m all-timestamps \e\fR
-\fB--key /var/pkg/ssl/Oracle_Solaris_11_Support.key.pem \e\fR
-\fB--cert /var/pkg/ssl/Oracle_Solaris_11_Support.certificate.pem '*'\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 8 \fR创建软件包归档文件
-.sp
-.LP
-根据位于 \fBhttp://example.com:10000 \fR 的系统信息库创建包含软件包 \fBeditor/gnu-emacs\fR 及其所有依赖项的软件包归档文件。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s http://example.com:10000 -d /my/emacs.p5p -a \e\fR
-\fB-r editor/gnu-emacs\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 9 \fR将软件包从归档文件复制到系统信息库中
-.sp
-.LP
-将软件包归档文件中的所有软件包复制到位于 \fB/export/repo\fR 中的现有系统信息库。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrecv -s /my/archive.p5p -d /export/repo '*'\fR
-.fi
-.in -2
-.sp
-
-.SH 环境变量
-.sp
-.LP
-支持以下环境变量:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_DEST\fR\fR
-.ad
-.RS 12n
-.rt  
-要将检索到的软件包保存到的目录的路径,或者要复制软件包的系统信息库或软件包归档文件的文件系统路径或 URI。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_SRC\fR\fR
-.ad
-.RS 12n
-.rt  
-URI 或文件系统路径代表要从中检索软件包的 \fB pkg\fR(5) 系统信息库或软件包归档文件的位置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBTMPDIR\fR\fR
-.ad
-.RS 12n
-.rt  
-在程序执行期间用于存储临时数据的目录的绝对路径。如果未设置,则存储临时数据的缺省路径为 \fB/var/tmp\fR。
-.RE
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-请求了多项操作,但只有一部分操作成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkgrepo\fR(1)、\fBpkgsend\fR(1)、\fBpkg\fR(5)
-.sp
-.LP
-\fI《Copying and Creating Package Repositories in Oracle Solaris 11.2》\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 附注
-.sp
-.LP
-当使用基于文件系统的目标系统信息库时,在完成软件包传输后必须重新启动提供该系统信息库服务的任何 \fBpkg.depotd\fR 进程,以便在其 Web 界面或搜索响应中反映更改。有关更多信息,请参见 \fBpkg.depotd\fR(1M)。
+Completed                                     1/1     9.2/9.2 25.4/25.4</screen>
+</example>
+<example><title>检索所有版本并远程重新发布</title>
+<para>从名为 <literal>test</literal> 的系统中接收软件包 <literal>library/zlib</literal> 的所有版本,然后将其重新发布到名为 <literal>remote</literal> 的系统上的远程系统信息库中。</para>
+<screen>$ <userinput>pkgrecv -s http://test -d http://remote:10000 &bsol;</userinput>
+<userinput>-m all-versions library/zlib</userinput></screen>
+</example>
+<example><title>从系统信息库中检索依赖项</title>
+<para>从位于 <filename>/export/repo</filename> 的系统信息库中接收软件包 <literal>editor/gnu-emacs</literal> 及其所有依赖项。</para>
+<screen>$ <userinput>pkgrecv -s /export/repo -d /local/repo -r editor/gnu-emacs</userinput></screen>
+</example>
+<example><title>检索其他软件包和更改的内容</title>
+<para>从位于 <literal>http://pkg.oracle.com/solaris/release/</literal> 的系统信息库中将并非已存在的所有软件包和所有已更改内容接收到位于 <literal>/export/repoSolaris11</literal> 的系统信息库。</para>
+<screen>$ <userinput>pkgrecv -s http://pkg.oracle.com/solaris/release/ &bsol;</userinput>
+<userinput>-d /export/repoSolaris11 -m all-timestamps '*'</userinput></screen>
+<para>将位于 <literal>https://pkg.oracle.com/solaris/support/</literal>的安全系统信息库中的所有尚不存在的软件包和所有更改内容接收到位于 <literal>/export/repoSolaris11</literal> 的系统信息库。 </para>
+<screen>$ <userinput>pkgrecv -s https://pkg.oracle.com/solaris/support/ &bsol;</userinput>
+<userinput>-d /export/repoSolaris11 -m all-timestamps &bsol;</userinput>
+<userinput>--key /var/pkg/ssl/Oracle_Solaris_11_Support.key.pem &bsol;</userinput>
+<userinput>--cert /var/pkg/ssl/Oracle_Solaris_11_Support.certificate.pem '*'</userinput></screen>
+</example>
+<example><title>创建软件包归档文件</title>
+<para>根据位于 <literal>http://example.com:10000 </literal> 的系统信息库创建包含软件包 <literal>editor/gnu-emacs</literal> 及其所有依赖项的软件包归档文件。</para>
+<screen>$ <userinput>pkgrecv -s http://example.com:10000 -d /my/emacs.p5p -a &bsol;</userinput>
+<userinput>-r editor/gnu-emacs</userinput></screen>
+</example>
+<example><title>将软件包从归档文件复制到系统信息库中</title>
+<para>将软件包归档文件中的所有软件包复制到位于 <filename>/export/repo</filename> 中的现有系统信息库。</para>
+<screen>$ <userinput>pkgrecv -s /my/archive.p5p -d /export/repo '*'</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<para>支持以下环境变量:</para>
+<variablelist>
+<varlistentry><term><envar>PKG_DEST</envar></term>
+<listitem><para>要将检索到的软件包保存到的目录的路径,或者要复制软件包的系统信息库或软件包归档文件的文件系统路径或 URI。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>PKG_SRC</envar></term>
+<listitem><para>URI 或文件系统路径代表要从中检索软件包的 <literal> pkg</literal>(5) 系统信息库或软件包归档文件的位置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><envar>TMPDIR</envar></term>
+<listitem><para>在程序执行期间用于存储临时数据的目录的绝对路径。如果未设置,则存储临时数据的缺省路径为 <filename>/var/tmp</filename>。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>请求了多项操作,但只有一部分操作成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP">《<citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle>》</olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>当使用基于文件系统的目标系统信息库时,在完成软件包传输后必须重新启动提供该系统信息库服务的任何 <command>pkg.depotd</command> 进程,以便在其 Web 界面或搜索响应中反映更改。有关更多信息,请参见 <command>pkg.depotd</command>(1M)。</para>
+</refsect1>
+</refentry>
--- a/src/man/zh_CN/pkgrepo.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgrepo.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,1191 +1,540 @@
-'\" te
-.\" Copyright (c) 2007, 2014, Oracle and/or its affiliates.All rights reserved.
-.TH pkgrepo 1 "2014 年 3 月 27 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgrepo \- 映像包管理系统的系统信息库管理实用程序
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgrepo create [--version \fIver\fR] \fIuri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo add-publisher -s \fIrepo_uri_or_path\fR
-    \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo remove-publisher [-n] [--synchronous]
-    -s \fIrepo_uri_or_path\fR \fIpublisher\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo get [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [\fIsection/property\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo info [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo list [-F \fIformat\fR] [-H] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [\fIpkg_fmri_pattern\fR ...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo contents [-m]
-    [-t \fIaction_name\fR[,\fIaction_name\fR]...]... -s \fIrepo_uri_or_path\fR
-    [--key \fIssl_key\fR --cert \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR...]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo rebuild [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [--no-catalog] [--no-index]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo refresh [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [--no-catalog] [--no-index]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo remove [-n] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR \fIpkg_fmri_pattern\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo set [-p \fIpublisher\fR]... -s \fIrepo_uri_or_path\fR
-    \fIsection/property\fR=[\fIvalue\fR] ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo set [-p \fIpublisher\fR]... -s \fIrepo_uri_or_path\fR
-    \fIsection/property\fR=([\fIvalue\fR]) ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo verify [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo fix [-v] [-p \fIpublisher\fR]...
-    -s \fIrepo_uri_or_path\fR
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo help
-.fi
-
-.LP
-.nf
-/usr/bin/pkgrepo version
-.fi
-
-.SH 描述
-.sp
-.LP
-通过 \fBpkgrepo\fR 可以创建和管理 \fB pkg\fR(5) 软件包系统信息库。软件包系统信息库是一组预定义的目录和文件,允许 \fBpkg\fR 和发布客户机(例如 \fBpkgsend \fR 或 \fBpkgrecv\fR)存储和检索软件包数据。此外,当需要对软件包系统信息库进行基于网络的访问时,\fBpkg.depotd\fR 可以提供对该系统信息库的客户机访问权限,以存储和/或检索软件包数据。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.SH 子命令
-.sp
-.LP
-支持以下子命令:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo create\fR [\fB--version\fR \fIver\fR] \fIuri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-在指定的位置创建 \fBpkg\fR(5) 系统信息库。
-.sp
-该子命令仅可以与基于文件系统的系统信息库一起使用。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--version\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用与指定版本兼容的格式创建系统信息库。缺省情况下,会创建版本为 4 的系统信息库。支持的版本包括:
-.sp
-.ne 2
-.mk
-.na
-\fB3\fR
-.ad
-.RS 5n
-.rt  
-支持为单个发布者存储软件包,目录版本为 1 ,搜索版本为 1。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB4\fR
-.ad
-.RS 5n
-.rt  
-支持为多个发布者存储软件包,目录版本为 1 ,搜索版本为 1。
-.RE
-
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo add-publisher\fR \fB-s\fR \fIrepo_uri_or_path\fR \fIpublisher\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-将指定的发布者添加到系统信息库中。新的发布者没有软件包或内容。
-.sp
-该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-对位于给定 URI 或文件系统路径的系统信息库进行操作。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo remove-publisher\fR [\fB-n\fR] [\fB--synchronous\fR] \fB-s\fR \fIrepo_uri_or_path\fR \fIpublisher\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-从系统信息库中删除指定的发布者。删除指定发布者的所有软件包和其他所有数据。
-.sp
-如果删除了缺省发布者,并且系统信息库中只剩余了一个发布者,则剩余的发布者将成为缺省发布者。系统信息库的 \fBpublisher/prefix\fR 属性将设置为该剩余发布者。
-.sp
-如果删除了缺省发布者,但系统信息库中剩余多个发布者,或者从系统信息库中删除了最后一个发布者,则将取消设置 \fBpublisher/prefix\fR 属性。
-.sp
-该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-试运行操作而不更改发布者。在退出之前,会显示要删除的每个发布者的软件包个数。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-对位于给定 URI 或文件系统路径的系统信息库进行操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--synchronous\fR\fR
-.ad
-.sp .6
-.RS 4n
-等待操作完成,然后返回。如果未指定此选项,命令将立即返回并在后台异步删除发布者。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo get\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIsection/property\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-显示系统信息库或其发布者的属性信息。
-.sp
-缺省情况下,会在单独的行中显示每个属性及其值。空的 ASCII 字符串值用一对双引号 (\fB""\fR) 表示。ASCII 字符串值中的以下 Bourne shell 元字符以及换行符、空格符和制表符都必须使用反斜杠 (\fB\\fR) 进行转义:
-.sp
-.in +2
-.nf
-; & ( ) | ^ < > \e " ' `
-.fi
-.in -2
-
-有关显示发布者和系统信息库属性的示例,请参见“示例”部分。
-.sp
-有关属性列表以及每个属性的用途和值,请参见下文的 \fBset\fR 子命令。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-F\fR \fIformat\fR\fR
-.ad
-.sp .6
-.RS 4n
-指定备用输出格式。\fIformat\fR 的值可以是 \fBtsv\fR(以制表符分隔的值)、\fBjson\fR(单行 JavaScript 对象表示法)或 \fBjson-formatted\fR(格式易于阅读的 JavaScript 对象表示法)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-H\fR\fR
-.ad
-.sp .6
-.RS 4n
-在列出时省略标题。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示给定发布者的属性信息。特殊值 \fBall\fR 显示所有发布者的属性。可以多次指定此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-对位于给定 URI 或文件系统路径的系统信息库进行操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用 \fB--key\fR 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 密钥文件。使用 \fB--cert\fR 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 证书文件。可以多次指定此选项对。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection/property\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示指定属性的值,例如 \fB publisher/prefix\fR 或 \fBrepository/version\fR。有关完整的属性列表,请参见 \fB set\fR 子命令。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo info\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]...\fR
-.ad
-.sp .6
-.RS 4n
-显示系统信息库已知的软件包发布者的列表。该列表包括每个发布者的软件包数量、最后一次更新发布者的软件包数据的时间以及发布者的软件包数据的状态(例如当前是否处于正在处理状态)。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示给定发布者的数据。如果没有提供该选项,将显示所有发布者的数据。可以多次指定此选项。
-.RE
-
-有关其他所有选项的描述,请参见上面的 \fBpkgrepo get\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo list\fR [\fB-F\fR \fIformat\fR] [\fB-H\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-列出 \fIrepo_uri_or_path\fR 系统信息库中与指定 \fIpkg_fmri_pattern\fR 模式匹配的软件包。如果未指定任何模式,将列出系统信息库中的所有软件包。\fIpkg_fmri_pattern\fR 模式可以包含 \fB?\fR 和 \fB*\fR 字符作为 \fBglob\fR(3C) 式通配符,以匹配一个或多个软件包。
-.sp
-在缺省输出中,第一列包含软件包发布者的名称。第二列包含软件包的名称。第三列是显示软件包状态的标志。状态列中的 \fBo\fR 值表示软件包已过时。状态列中的 \fBr\fR 值表示已重命名软件包,但格式已过时。第四列包含软件包的发行版本和分支版本。有关发行版本和分支版本的信息,请参见 \fBpkg\fR(5)。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示给定发布者的软件包。如果没有提供该选项,将列出所有发布者的软件包。可以多次指定此选项。
-.RE
-
-有关其他所有选项的描述,请参见上面的 \fBpkgrepo get\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo contents\fR [\fB-m\fR [\fB-t\fR \fIaction_name\fR[,\fIaction_name\fR]...]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fIpkg_fmri_pattern\fR...]\fR
-.ad
-.sp .6
-.RS 4n
-列出 \fIrepo_uri_or_path\fR 系统信息库中的所有软件包。如果指定了 \fIpkg_fmri_pattern\fR,将显示系统信息库中所有匹配软件包的内容(操作属性)。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-m\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示指定软件包中操作的所有属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-t\fR \fIaction_name\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅显示指定软件包中的指定操作。可以多次指定 \fB-t\fR 选项;也可以通过使用逗号分隔操作名称,将多个操作指定为一个 \fB-t\fR 选项的参数。\fIaction_name\fR 的值是 \fBpkg\fR(5) 手册页的“操作”中列出的操作之一,例如 \fBfile\fR、\fBdir\fR、\fBdriver\fR、\fBdepend\fR 或 \fBset\fR。
-.RE
-
-有关其他所有选项的描述,请参见上面的 \fBpkgrepo get\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo rebuild\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB--no-catalog\fR] [\fB--no-index\fR]\fR
-.ad
-.sp .6
-.RS 4n
-放弃在系统信息库中找到的所有目录、搜索以及其他缓存信息,然后根据系统信息库的当前内容重新创建这些信息。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅针对给定发布者执行操作。如果没有提供该选项或者指定了特定值 \fBall\fR,则对所有发布者执行操作。可以多次指定此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-不重新生成软件包数据。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-不重新生成搜索索引。
-.RE
-
-有关其他所有选项的描述,请参见上面的 \fBpkgrepo get\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo refresh\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB--no-catalog\fR] [\fB--no-index\fR] \fR
-.ad
-.sp .6
-.RS 4n
-将在系统信息库中找到的所有新软件包编入目录并更新所有搜索索引。这主要供延迟的发布使用(\fBpkgsend\fR 的 \fB--no-catalog \fR 或 \fB--no-index\fR 选项)。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅针对给定发布者执行操作。如果没有提供该选项或者指定了特定值 \fBall\fR,则对所有发布者执行操作。可以多次指定此选项。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-不添加任何新软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-不更新搜索索引。
-.RE
-
-有关其他所有选项的描述,请参见上面的 \fBpkgrepo get\fR 命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo remove\fR [\fB-n\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIpkg_fmri_pattern\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-从系统信息库中删除与指定的 \fIpkg_fmri_pattern\fR 模式匹配的软件包,其中包括这些软件包所引用的且未被其他任何软件包使用的所有文件。\fIpkg_fmri_pattern\fR 模式可以包含 \fB?\fR 和 \fB*\fR 字符作为 \fBglob\fR(3C) 式通配符,以匹配一个或多个软件包。
-.LP
-注 - 
-.sp
-.RS 2
-删除关联发布者的所有搜索索引数据。
-.RE
-该子命令仅可以与基于文件系统的系统信息库一起使用。
-.LP
-注意 - 
-.sp
-.RS 2
-此操作不可逆并且不得在其他客户机正在访问系统信息库时使用,因为这样会使得它们在执行检索操作期间出现故障。
-.RE
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-试运行操作而不进行软件包更改。在退出之前,会显示要删除的软件包的列表。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅删除给定发布者的匹配软件包。如果没有提供该选项,会删除所有发布者的所有匹配软件包。可以多次指定此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-对位于给定 URI 或文件系统路径的系统信息库进行操作。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo set\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIsection/property\fR=[\fIvalue\fR] ...\fR
-.ad
-.br
-.na
-\fB\fBpkgrepo set\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR \fIsection/property\fR=([\fIvalue\fR]) ...\fR
-.ad
-.sp .6
-.RS 4n
-为系统信息库或发布者设置指定属性的值。
-.sp
-该子命令仅可以与基于文件系统的系统信息库一起使用。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅为给定发布者设置属性数据。如果发布者尚未存在,将添加该发布者。特殊值 \fB all\fR 可用于设置所有发布者的属性。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-对位于给定 URI 或文件系统路径的系统信息库进行操作。
-.RE
-
-可以使用以下格式之一指定属性和值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=\fR
-.ad
-.sp .6
-.RS 4n
-清除属性值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=\fIvalue\fR\fR
-.ad
-.sp .6
-.RS 4n
-将属性值替换为给定值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fIsection\fR/\fIproperty\fR=(\fIvalue1\fR \fIvalue2\fR \fIvalueN\fR)\fR
-.ad
-.sp .6
-.RS 4n
-将属性值替换为值列表。
-.RE
-
-对于系统信息库第 3 和 4 版,可以为系统信息库设置以下属性:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpublisher/prefix\fR\fR
-.ad
-.sp .6
-.RS 4n
-代表缺省发布者名称的字符串。第一个字符必须是 a-z、A-Z 或 0-9。该字符串的剩余部分只能包含字符 0-9、-、.、a-z 以及 A-Z。该值指示存在多个发布者的软件包时或者将软件包发布到系统信息库但没有指定发布者时,应当使用的发布者。
-.RE
-
-对于系统信息库第 3 版和第 4 版,可以为系统信息库中的各发布者设置以下属性。设置这些属性时应使用 \fB-p\fR 选项至少指定一个发布者。
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpublisher/alias\fR\fR
-.ad
-.sp .6
-.RS 4n
-字符串,代表在使用系统信息库的配置数据添加发布者时客户机应当使用的缺省别名。第一个字符必须是 a-z、A-Z 或 0-9。该字符串的剩余部分只能包含字符 0-9、-、.、a-z 以及 A-Z。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/check-certificate-revocation\fR\fR
-.ad
-.sp .6
-.RS 4n
-用于检查证书是否已撤销的布尔值。如果此属性设置为 \fBTrue\fR,则 \fBpkgrepo verify\fR 和 \fBpkgrepo fix\fR 命令将尝试访问用于签名验证的证书中的任何 CRL 分发点,以确定证书自颁发以来是否已被撤销。缺省值为 \fBFalse\fR。此属性仅由 \fBverify\fR 和 \fBfix\fR 子命令用来验证系统信息库的内容。此属性不影响客户机设置。此值应该与相应的 \fBpkg\fR(1) 属性值相同。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/collection_type\fR\fR
-.ad
-.sp .6
-.RS 4n
-可以使用值 \fBcore\fR 或 \fBsupplemental\fR,表明此系统信息库中提供的软件包类型。
-.sp
-\fBcore\fR 类型表明系统信息库包含该库中的软件包所声明的所有依赖项。\fBcore\fR 类型主要用于操作系统的系统信息库。
-.sp
-\fBsupplemental\fR 类型表明系统信息库包含依赖于另一个系统信息库中的软件包或要与另一个系统信息库中软件包一起使用的软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/description\fR\fR
-.ad
-.sp .6
-.RS 4n
-纯文本段落,描述系统信息库的用途和内容。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/detailed_url\fR\fR
-.ad
-.sp .6
-.RS 4n
-URI,代表提供更多有关系统信息库信息的文档的位置(例如网页)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/legal_uris\fR\fR
-.ad
-.sp .6
-.RS 4n
-文档的位置列表 (URI),提供关于系统信息库的其他法律信息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/mirrors\fR\fR
-.ad
-.sp .6
-.RS 4n
-系统信息库的位置列表 (URI),这些系统信息库包含系统信息库的软件包内容的副本但不包含软件包元数据。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/name\fR\fR
-.ad
-.sp .6
-.RS 4n
-纯文本字符串,包含系统信息库的名称。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/origins\fR\fR
-.ad
-.sp .6
-.RS 4n
-系统信息库的位置列表 (URI),这些系统信息库包含该系统信息库的软件包元数据和内容的完整副本。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/refresh_seconds\fR\fR
-.ad
-.sp .6
-.RS 4n
-整数值,表示客户机在每次更新检查之后和检查系统信息库以查找更新的软件包数据之前应当等待的秒数。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/registration_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-代表资源位置的 URI,必须使用该位置才能获取访问系统信息库的证书。注册网页就是一个示例。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/related_uris\fR\fR
-.ad
-.sp .6
-.RS 4n
-系统信息库的位置列表 (URI),这些系统信息库包含用户可能感兴趣的软件包。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/signature-required-names\fR\fR
-.ad
-.sp .6
-.RS 4n
-在验证软件包签名时必须视为证书通用名称的名称列表。此属性仅由 \fBverify\fR 和 \fBfix\fR 子命令用来验证系统信息库的内容。此属性不影响客户机设置。这些值应该与相应的 \fBpkg\fR(1) 属性值相同。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBrepository/trust-anchor-directory\fR\fR
-.ad
-.sp .6
-.RS 4n
-目录的绝对路径名称,包含此系统信息库中的软件包的信任锚。如果未指定,将使用 \fB/etc/certs/CA/\fR。此属性仅由 \fBverify\fR 和 \fBfix\fR 子命令用来验证系统信息库的内容。此属性不影响客户机设置。此值应该与相应的 \fBpkg\fR(1) 属性值相同。
-.RE
-
-此处没有记录但列在 \fBget\fR 子命令输出中的属性均保留供内部使用,不应对其进行设置。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo verify\fR [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-验证软件包系统信息库内容的以下属性是否正确:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-文件校验和
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-文件权限
-.sp
-还将检查指向系统信息库的路径,确保 \fBpkg5srv\fR 用户可以读取系统信息库内容。对于在系统具有非全局区域时使用 \fBsvc:/application/pkg/server\fR 服务或使用 \fBsvc:/application/pkg/system-repository\fR 服务变为可用的系统信息库,需要进行此检查。
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-软件包清单权限
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-软件包清单内容
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-软件包签名
-.sp
-基于 \fBrepository/signature-required-names\fR、\fBrepository/trust-anchor-directory\fR 和 \fBrepository/check-certificate-revocation\fR 属性的值计算软件包清单签名。
-.RE
-相应错误将发送到 \fBstdout\fR。如果发送任何错误,则 \fBpkgrepo\fR 命令将退出并显示非零返回代码。
-.sp
-该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅针对指定发布者执行操作。如果没有指定发布者或者指定了特定值 \fBall\fR,则对所有发布者执行操作。可以多次指定此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-对位于给定 URI 或文件系统路径的系统信息库进行操作。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo fix\fR [\fB-v\fR] [\fB-p\fR \fIpublisher\fR]... \fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-通过以下方法修复系统信息库的内容:首先验证系统信息库,然后将所有无效系统信息库内容移至系统信息库内的隔离目录。
-.sp
-如果发现系统信息库错误,将自动执行系统信息库重新生成操作。如果发现任何错误,将向 \fBstdout\fR 发送消息,说明必须使用 \fBpkgsend\fR(1) 或 \fBpkgrecv\fR(1) 重新导入哪些软件包以便恢复系统信息库内容。
-.sp
-该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-v\fR\fR
-.ad
-.sp .6
-.RS 4n
-包括详细说明系统信息库验证过程中发现的错误的输出。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-p\fR \fIpublisher\fR\fR
-.ad
-.sp .6
-.RS 4n
-仅针对指定发布者执行操作。如果没有指定发布者或者指定了特定值 \fBall\fR,则对所有发布者执行操作。可以多次指定此选项。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-对位于给定 URI 或文件系统路径的系统信息库进行操作。
-.RE
-
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgrepo version\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示一个用于唯一标识 \fBpkg\fR(5) 系统版本的字符串。由 \fBversion\fR 操作生成的值不能进行排序,并且对于在不平等情况下的比较而言是不安全的。
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR创建软件包系统信息库
-.sp
-.in +2
-.nf
-$ \fBpkgrepo create /my/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR显示信息
-.sp
-.LP
-显示发布者摘要以及系统信息库中软件包的数量。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo info -s /my/repository\fR
+<refentry lang="zh" id="pkgrepo-1">
+<refmeta><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2015 年 5 月 26 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgrepo</refname><refpurpose>映像包管理系统的系统信息库管理实用程序</refpurpose></refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgrepo create [--version <replaceable>ver</replaceable>] <replaceable>uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo add-publisher -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>publisher</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo remove-publisher [-n] [--synchronous]
+    -s <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo get [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [<replaceable>section/property</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkgrepo info [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...</synopsis>
+<synopsis>/usr/bin/pkgrepo list [-F <replaceable>format</replaceable>] [-H] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>
+<synopsis>/usr/bin/pkgrepo contents [-m]
+    [-t <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]... -s <replaceable>repo_uri_or_path</replaceable>
+    [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable>...]</synopsis>
+<synopsis>/usr/bin/pkgrepo rebuild [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [--no-catalog] [--no-index]</synopsis>
+<synopsis>/usr/bin/pkgrepo refresh [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [--no-catalog] [--no-index]</synopsis>
+<synopsis>/usr/bin/pkgrepo remove [-n] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable> <replaceable>pkg_fmri_pattern</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgrepo set [-p <replaceable>publisher</replaceable>]... -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>section/property</replaceable>=[<replaceable>value</replaceable>] ...</synopsis>
+<synopsis>/usr/bin/pkgrepo set [-p <replaceable>publisher</replaceable>]... -s <replaceable>repo_uri_or_path</replaceable>
+    <replaceable>section/property</replaceable>=([<replaceable>value</replaceable>]) ...</synopsis>
+<synopsis>/usr/bin/pkgrepo verify [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo fix [-v] [-p <replaceable>publisher</replaceable>]...
+    -s <replaceable>repo_uri_or_path</replaceable></synopsis>
+<synopsis>/usr/bin/pkgrepo help</synopsis>
+<synopsis>/usr/bin/pkgrepo version</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgrepo-1-desc" role="description"><title></title>
+<para>通过 <command>pkgrepo</command> 可以创建和管理 <literal> pkg</literal>(5) 软件包系统信息库。软件包系统信息库是一组预定义的目录和文件,允许 <command>pkg</command> 和发布客户机(例如 <command>pkgsend </command> 或 <command>pkgrecv</command>)存储和检索软件包数据。此外,当需要对软件包系统信息库进行基于网络的访问时,<command>pkg.depotd</command> 可以提供对该系统信息库的客户机访问权限,以存储和/或检索软件包数据。</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>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>支持以下子命令:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgrepo create</command> [<option>-version</option> <replaceable>ver</replaceable>] <replaceable>uri_or_path</replaceable></term>
+<listitem><para>在指定的位置创建 <literal>pkg</literal>(5) 系统信息库。</para>
+<para>该子命令仅可以与基于文件系统的系统信息库一起使用。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-version</option></term>
+<listitem><para>使用与指定版本兼容的格式创建系统信息库。缺省情况下,会创建版本为 4 的系统信息库。支持的版本包括:</para>
+<variablelist>
+<varlistentry><term>3</term>
+<listitem><para>支持为单个发布者存储软件包,目录版本为 1 ,搜索版本为 1。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>4</term>
+<listitem><para>支持为多个发布者存储软件包,目录版本为 1 ,搜索版本为 1。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo add-publisher</command> <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</term>
+<listitem><para>将指定的发布者添加到系统信息库中。新的发布者没有软件包或内容。</para>
+<para>该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>对位于给定 URI 或文件系统路径的系统信息库进行操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo remove-publisher</command> [<option>n</option>] [<option>-synchronous</option>] <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>publisher</replaceable> ...</term>
+<listitem><para>从系统信息库中删除指定的发布者。删除指定发布者的所有软件包和其他所有数据。</para>
+<para>如果删除了缺省发布者,并且系统信息库中只剩余了一个发布者,则剩余的发布者将成为缺省发布者。系统信息库的 <literal>publisher/prefix</literal> 属性将设置为该剩余发布者。</para>
+<para>如果删除了缺省发布者,但系统信息库中剩余多个发布者,或者从系统信息库中删除了最后一个发布者,则将取消设置 <literal>publisher/prefix</literal> 属性。</para>
+<para>该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>n</option></term>
+<listitem><para>试运行操作而不更改发布者。在退出之前,会显示要删除的每个发布者的软件包个数。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>对位于给定 URI 或文件系统路径的系统信息库进行操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-synchronous</option></term>
+<listitem><para>等待操作完成,然后返回。如果未指定此选项,命令将立即返回并在后台异步删除发布者。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo get</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>section/property</replaceable> ...]</term>
+<listitem><para>显示系统信息库或其发布者的属性信息。</para>
+<para>缺省情况下,会在单独的行中列显每个属性及其值。空的 ASCII 字符串值用一对双引号 (<literal>""</literal>) 表示。ASCII 字符串值中的以下 Bourne shell 元字符以及换行符、空格符和制表符都必须使用反斜杠 (<literal>\</literal>) 进行转义:</para>
+<programlisting>; &amp; ( ) | ^ &lt; > &bsol; " ' `</programlisting>
+<para>有关显示发布者和系统信息库属性的示例,请参见“示例”部分。</para>
+<para>有关属性列表以及每个属性的用途和值,请参见下文的 <command>set</command> 子命令。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>F</option> <replaceable>format</replaceable></term>
+<listitem><para>指定备用输出格式。<replaceable>format</replaceable> 的值可以是 <literal>tsv</literal>(以制表符分隔的值)、<literal>json</literal>(单行 JavaScript 对象表示法)或 <literal>json-formatted</literal>(格式易于阅读的 JavaScript 对象表示法)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>H</option></term>
+<listitem><para>在列出时省略标题。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>显示给定发布者的属性信息。特殊值 <literal>all</literal> 显示所有发布者的属性。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>对位于给定 URI 或文件系统路径的系统信息库进行操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para>使用 <option>-key</option> 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 密钥文件。使用 <option>-cert</option> 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 证书文件。可以多次指定此选项对。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section/property</replaceable></term>
+<listitem><para>仅显示指定属性的值,例如 <literal> publisher/prefix</literal> 或 <literal>repository/version</literal>。有关完整的属性列表,请参见 <command> set</command> 子命令。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo info</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]...</term>
+<listitem><para>显示系统信息库已知的软件包发布者的列表。该列表包括每个发布者的软件包数量、最后一次更新发布者的软件包数据的时间以及发布者的软件包数据的状态(例如当前是否处于正在处理状态)。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>仅显示给定发布者的数据。如果没有提供该选项,将显示所有发布者的数据。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>有关其他所有选项的说明,请参见上面的 <command>pkgrepo get</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo list</command> [<option>F</option> <replaceable>format</replaceable>] [<option>H</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable> ...]</term>
+<listitem><para>列出 <replaceable>repo_uri_or_path</replaceable> 系统信息库中与指定 <replaceable>pkg_fmri_pattern</replaceable> 模式匹配的软件包。如果未指定任何模式,将列出系统信息库中的所有软件包。<replaceable>pkg_fmri_pattern</replaceable> 模式可以包含 <literal>?</literal> 和 <literal>*</literal> 字符作为 <literal>glob</literal>(3C) 式通配符,以匹配一个或多个软件包。</para>
+<para>在缺省输出中,第一列包含软件包发布者的名称。第二列包含软件包的名称。第三列是显示软件包状态的标志。状态列中的 <literal>o</literal> 值表示软件包已过时。状态列中的 <literal>r</literal> 值表示已重命名软件包,但格式已过时。第四列包含软件包的发行版本和分支版本。有关发行版本和分支版本的信息,请参见 <literal>pkg</literal>(5)。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>仅显示给定发布者的软件包。如果没有提供该选项,将列出所有发布者的软件包。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>有关其他所有选项的说明,请参见上面的 <command>pkgrepo get</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo contents</command> [<option>m</option> [<option>t</option> <replaceable>action_name</replaceable>[,<replaceable>action_name</replaceable>]...]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<replaceable>pkg_fmri_pattern</replaceable>...]</term>
+<listitem><para>列出 <replaceable>repo_uri_or_path</replaceable> 系统信息库中的所有软件包。如果指定了 <replaceable>pkg_fmri_pattern</replaceable>,将显示系统信息库中所有匹配软件包的内容(操作属性)。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>m</option></term>
+<listitem><para>显示指定软件包中操作的所有属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>t</option> <replaceable>action_name</replaceable></term>
+<listitem><para>仅显示指定软件包中的指定操作。可以多次指定 <option>t</option> 选项;也可以通过使用逗号分隔操作名称,将多个操作指定为一个 <option>t</option> 选项的参数。<replaceable>action_name</replaceable> 的值是 <literal>pkg</literal>(5) 手册页的“操作”中列出的操作之一,例如 <literal>file</literal>、<literal>dir</literal>、<literal>driver</literal>、<literal>depend</literal> 或 <literal>set</literal>。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>有关其他所有选项的说明,请参见上面的 <command>pkgrepo get</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo rebuild</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>-no-catalog</option>] [<option>-no-index</option>]</term>
+<listitem><para>放弃在系统信息库中找到的所有目录、搜索以及其他缓存信息,然后根据系统信息库的当前内容重新创建这些信息。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>仅针对给定发布者执行操作。如果没有提供该选项或者指定了特定值 <literal>all</literal>,则对所有发布者执行操作。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>不重新生成软件包数据。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>不重新生成搜索索引。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>有关其他所有选项的说明,请参见上面的 <command>pkgrepo get</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo refresh</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>-no-catalog</option>] [<option>-no-index</option>] </term>
+<listitem><para>将在系统信息库中找到的所有新软件包编入目录并更新所有搜索索引。这主要供延迟的发布使用(<command>pkgsend</command> 的 <option>-no-catalog </option> 或 <option>-no-index</option> 选项)。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>仅针对给定发布者执行操作。如果没有提供该选项或者指定了特定值 <literal>all</literal>,则对所有发布者执行操作。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>不添加任何新软件包。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>不更新搜索索引。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>有关其他所有选项的说明,请参见上面的 <command>pkgrepo get</command> 命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo remove</command> [<option>n</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>pkg_fmri_pattern</replaceable> ...</term>
+<listitem><para>从系统信息库中删除与指定的 <replaceable>pkg_fmri_pattern</replaceable> 模式匹配的软件包,其中包括这些软件包所引用的且未被其他任何软件包使用的所有文件。<replaceable>pkg_fmri_pattern</replaceable> 模式可以包含 <literal>?</literal> 和 <literal>*</literal> 字符作为 <literal>glob</literal>(3C) 式通配符,以匹配一个或多个软件包。</para>
+<note><para>删除关联发布者的所有搜索索引数据。</para>
+</note>
+<para>该子命令仅可以与基于文件系统的系统信息库一起使用。</para>
+<caution><para>此操作不可逆并且不得在其他客户机正在访问系统信息库时使用,因为这样会使得它们在执行检索操作期间出现故障。</para></caution>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>n</option></term>
+<listitem><para>试运行操作而不进行软件包更改。在退出之前,会显示要删除的软件包的列表。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>仅删除给定发布者的匹配软件包。如果没有提供该选项,会删除所有发布者的所有匹配软件包。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>对位于给定 URI 或文件系统路径的系统信息库进行操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo set</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>section/property</replaceable>=[<replaceable>value</replaceable>] ...</term><term><command>pkgrepo set</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable> <replaceable>section/property</replaceable>=([<replaceable>value</replaceable>]) ...</term>
+<listitem><para>为系统信息库或发布者设置指定属性的值。</para>
+<para>该子命令仅可以与基于文件系统的系统信息库一起使用。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>仅为给定发布者设置属性数据。如果发布者尚未存在,将添加该发布者。特殊值 <literal> all</literal> 可用于设置所有发布者的属性。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>对位于给定 URI 或文件系统路径的系统信息库进行操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>可以使用以下格式之一指定属性和值:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=</term>
+<listitem><para>清除属性值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=<replaceable>value</replaceable></term>
+<listitem><para>将属性值替换为给定值。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><replaceable>section</replaceable>/<replaceable>property</replaceable>=(<replaceable>value1</replaceable> <replaceable>value2</replaceable> <replaceable>valueN</replaceable>)</term>
+<listitem><para>将属性值替换为值列表。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于系统信息库第 3 和 4 版,可以为系统信息库设置以下属性:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>publisher/prefix</literal></term>
+<listitem><para>代表缺省发布者名称的字符串。第一个字符必须是 a-z、A-Z 或 0-9。该字符串的剩余部分只能包含字符 0-9、-、.、a-z 以及 A-Z。该值指示存在多个发布者的软件包时或者将软件包发布到系统信息库但没有指定发布者时,应当使用的发布者。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>对于系统信息库第 3 版和第 4 版,可以为系统信息库中的各发布者设置以下属性。设置这些属性时应使用 <option>p</option> 选项至少指定一个发布者。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><literal>publisher/alias</literal></term>
+<listitem><para>字符串,代表在使用系统信息库的配置数据添加发布者时客户机应当使用的缺省别名。第一个字符必须是 a-z、A-Z 或 0-9。该字符串的剩余部分只能包含字符 0-9、-、.、a-z 以及 A-Z。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/check-certificate-revocation</literal></term>
+<listitem><para>用于检查证书是否已撤销的布尔值。如果此属性设置为 <literal>True</literal>,则 <command>pkgrepo verify</command> 和 <command>pkgrepo fix</command> 命令将尝试访问用于签名验证的证书中的任何 CRL 分发点,以确定证书自颁发以来是否已被撤销。缺省值为 <literal>False</literal>。此属性仅由 <command>verify</command> 和 <command>fix</command> 子命令用来验证系统信息库的内容。此属性不影响客户机设置。此值应该与相应的 <literal>pkg</literal>(1) 属性值相同。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/collection_type</literal></term>
+<listitem><para>可以使用值 <literal>core</literal> 或 <literal>supplemental</literal>,表明此系统信息库中提供的软件包类型。</para>
+<para><literal>core</literal> 类型表明系统信息库包含该库中的软件包所声明的所有依赖项。<literal>core</literal> 类型主要用于操作系统的系统信息库。</para>
+<para><literal>supplemental</literal> 类型表明系统信息库包含依赖于另一个系统信息库中的软件包或要与另一个系统信息库中软件包一起使用的软件包。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/description</literal></term>
+<listitem><para>纯文本段落,描述系统信息库的用途和内容。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/detailed_url</literal></term>
+<listitem><para>URI,代表提供更多有关系统信息库信息的文档的位置(例如网页)。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/legal_uris</literal></term>
+<listitem><para>文档的位置列表 (URI),提供关于系统信息库的其他法律信息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/mirrors</literal></term>
+<listitem><para>系统信息库的位置列表 (URI),这些系统信息库包含系统信息库的软件包内容的副本但不包含软件包元数据。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/name</literal></term>
+<listitem><para>纯文本字符串,包含系统信息库的名称。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/origins</literal></term>
+<listitem><para>系统信息库的位置列表 (URI),这些系统信息库包含该系统信息库的软件包元数据和内容的完整副本。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/refresh_seconds</literal></term>
+<listitem><para>整数值,表示客户机在每次更新检查之后和检查系统信息库以查找更新的软件包数据之前应当等待的秒数。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/registration_uri</literal></term>
+<listitem><para>代表资源位置的 URI,必须使用该位置才能获取访问系统信息库的证书。注册网页就是一个示例。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/related_uris</literal></term>
+<listitem><para>系统信息库的位置列表 (URI),这些系统信息库包含用户可能感兴趣的软件包。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/signature-required-names</literal></term>
+<listitem><para>在验证软件包签名时必须视为证书通用名称的名称列表。此属性仅由 <command>verify</command> 和 <command>fix</command> 子命令用来验证系统信息库的内容。此属性不影响客户机设置。这些值应该与相应的 <literal>pkg</literal>(1) 属性值相同。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><literal>repository/trust-anchor-directory</literal></term>
+<listitem><para>目录的绝对路径名称,包含此系统信息库中的软件包的信任锚。如果未指定,将使用 <filename>/etc/certs/CA/</filename>。此属性仅由 <command>verify</command> 和 <command>fix</command> 子命令用来验证系统信息库的内容。此属性不影响客户机设置。此值应该与相应的 <literal>pkg</literal>(1) 属性值相同。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>此处没有记录但列在 <command>get</command> 子命令输出中的属性均保留供内部使用,不应对其进行设置。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo verify</command> [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>验证软件包系统信息库内容的以下属性是否正确:</para>
+<itemizedlist>
+<listitem><para>文件校验和</para></listitem>
+<listitem><para>文件权限</para><para>还将检查指向系统信息库的路径,确保 <literal>pkg5srv</literal> 用户可以读取系统信息库内容。对于在系统具有非全局区域时使用 <literal>svc:/application/pkg/server</literal> 服务或使用 <literal>svc:/application/pkg/system-repository</literal> 服务变为可用的系统信息库,需要进行此检查。</para>
+</listitem>
+<listitem><para>软件包清单权限</para></listitem>
+<listitem><para>软件包清单内容</para></listitem>
+<listitem><para>软件包签名</para><para>基于 <literal>repository/signature-required-names</literal>、<literal>repository/trust-anchor-directory</literal> 和 <literal>repository/check-certificate-revocation</literal> 属性的值计算软件包清单签名。</para>
+</listitem>
+</itemizedlist>
+<para>相应错误将发送到 <literal>stdout</literal>。如果发送任何错误,则 <command>pkgrepo</command> 命令将退出并显示非零返回代码。</para>
+<para>该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>仅针对指定发布者执行操作。如果没有指定发布者或者指定了特定值 <literal>all</literal>,则对所有发布者执行操作。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>对位于给定 URI 或文件系统路径的系统信息库进行操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo fix</command> [<option>v</option>] [<option>p</option> <replaceable>publisher</replaceable>]... <option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>通过以下方法修复系统信息库的内容:首先验证系统信息库,然后将所有无效系统信息库内容移至系统信息库内的隔离目录。</para>
+<para>如果发现系统信息库错误,将自动执行系统信息库重新生成操作。如果发现任何错误,将向 <literal>stdout</literal> 发送消息,说明必须使用 <literal>pkgsend</literal>(1) 或 <literal>pkgrecv</literal>(1) 重新导入哪些软件包以便恢复系统信息库内容。</para>
+<para>该子命令仅可以与基于第 4 版文件系统的系统信息库一起使用。
+</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>v</option></term>
+<listitem><para>包括详细说明系统信息库验证过程中发现的错误的输出。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>p</option> <replaceable>publisher</replaceable></term>
+<listitem><para>仅针对指定发布者执行操作。如果没有指定发布者或者指定了特定值 <literal>all</literal>,则对所有发布者执行操作。可以多次指定此选项。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>对位于给定 URI 或文件系统路径的系统信息库进行操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo help</command></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgrepo version</command></term>
+<listitem><para>显示一个用于唯一标识 <literal>pkg</literal>(5) 系统版本的字符串。由 <command>version</command> 操作生成的值不能进行排序,并且对于在不平等情况下的比较而言是不安全的。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>创建软件包系统信息库</title>
+<screen>$ <userinput>pkgrepo create /my/repository</userinput></screen>
+</example>
+<example><title>显示信息</title>
+<para>显示发布者摘要以及系统信息库中软件包的数量。
+</para>
+<screen>$ <userinput>pkgrepo info -s /my/repository</userinput>
 PUBLISHER   PACKAGES STATUS UPDATED
 example.com 5        online 2011-07-22T18:09:09.769106Z
-$ \fBpkgrepo info -s http://pkg.oracle.com/solaris/release/\fR
+$ <userinput>pkgrepo info -s http://pkg.oracle.com/solaris/release/</userinput>
 PUBLISHER PACKAGES STATUS UPDATED
-solaris   3941     online 2010-11-12T19:24:25.967246Z
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 3 \fR重新生成目录和搜索数据
-.sp
-.LP
-重新生成系统信息库的目录和搜索数据。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo rebuild -s /my/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 4 \fR刷新目录和搜索数据
-.sp
-.LP
-刷新系统信息库的目录和搜索数据。
-
-.sp
-.in +2
-.nf
-$ \fBpkgrepo refresh -s /my/repository\fR
-$ \fBpkgrepo refresh -s http://example.com/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 5 \fR显示所有系统信息库属性
-.sp
-.in +2
-.nf
-$ \fBpkgrepo get -s /export/repoSolaris11\fR
+solaris   3941     online 2010-11-12T19:24:25.967246Z</screen>
+</example>
+<example><title>重新生成目录和搜索数据</title>
+<para>重新生成系统信息库的目录和搜索数据。</para>
+<screen>$ <userinput>pkgrepo rebuild -s /my/repository</userinput></screen>
+</example>
+<example><title>刷新目录和搜索数据</title>
+<para>刷新系统信息库的目录和搜索数据。</para>
+<screen>$ <userinput>pkgrepo refresh -s /my/repository</userinput>
+$ <userinput>pkgrepo refresh -s http://example.com/repository</userinput></screen>
+</example>
+<example><title>显示所有系统信息库属性</title>
+<screen>$ <userinput>pkgrepo get -s /export/repoSolaris11</userinput>
 SECTION    PROPERTY    VALUE
 publisher  prefix      solaris
-repository description Local\e copy\e of\e the\e Oracle\e Solaris\e 11\e repository
-repository name        Oracle\e Solaris\e 11
+repository description Local&bsol; copy&bsol; of&bsol; the&bsol; Oracle&bsol; Solaris&bsol; 11&bsol; repository
+repository name        Oracle&bsol; Solaris&bsol; 11
 repository version     4
-$ \fBpkgrepo get -s http://pkg.oracle.com/solaris/release/\fR
+$ <userinput>pkgrepo get -s http://pkg.oracle.com/solaris/release/</userinput>
 SECTION    PROPERTY VALUE
 deployment content  s11_11-11
 deployment pubdate  20111102T222051Z
 publisher  prefix   solaris
-repository version  4
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 6 \fR显示所有发布者属性
-.sp
-.in +2
-.nf
-$ \fBpkgrepo get -s http://pkg.oracle.com/solaris/release/ -p all\fR
+repository version  4</screen>
+</example>
+<example><title>显示所有发布者属性</title>
+<screen>$ <userinput>pkgrepo get -s http://pkg.oracle.com/solaris/release/ -p all</userinput>
 PUBLISHER SECTION    PROPERTY         VALUE
 solaris   publisher  alias
 solaris   publisher  prefix           solaris
 solaris   repository collection-type  core
-solaris   repository description      This\e repository\e serves\e the\e Oracle\e
-Solaris\e 11\e Package\e repository.
+solaris   repository description      This&bsol; repository&bsol; serves&bsol; the&bsol; Oracle&bsol;
+Solaris&bsol; 11&bsol; Package&bsol; repository.
 solaris   repository legal-uris       ()
 solaris   repository mirrors          (http://pkg-cdn1.oracle.com/solaris.release/)
-solaris   repository name             Oracle\e Solaris\e 11\e Package\e Repository
+solaris   repository name             Oracle&bsol; Solaris&bsol; 11&bsol; Package&bsol; Repository
 solaris   repository origins          ()
 solaris   repository refresh-seconds
 solaris   repository registration-uri ""
-solaris   repository related-uris     ()
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 7 \fR设置缺省发布者
-.sp
-.in +2
-.nf
-$ \fBpkgrepo set -s /my/repository publisher/prefix=example.com\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 8 \fR设置发布者属性
-.sp
-.in +2
-.nf
-$ \fBpkgrepo set -s /my/repository -p example.com \e\fR
-\fBrepository/origins=http://example.com/repository\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 9 \fR将新的发布者添加到系统信息库中
-.sp
-.in +2
-.nf
-$ \fBpkgrepo add-publisher -s /my/repository example.com\fR
-.fi
-.in -2
-.sp
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-请求了多项操作,但只有一部分操作成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB4\fR\fR
-.ad
-.RS 6n
-.rt  
-没有进行更改时,无需执行任何操作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(1)、\fBpkgrecv\fR(1)、\fBpkgsend\fR(1)、\fBpkg.depotd\fR(1M)、\fBpkg\fR(5)
-.sp
-.LP
-\fI《Copying and Creating Package Repositories in Oracle Solaris 11.2》\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 附注
-.sp
-.LP
-大多数 \fBpkgrepo\fR 操作不可用于软件包归档文件。软件包归档文件是一个文件,通常带有 \fB\&.p5p\fR 扩展名,如 \fBpkgrecv\fR(1) 手册页中的 \fB-a\fR 选项所述。软件包归档文件包含软件包但不包含系统信息库配置。但是,\fBpkgrepo list\fR、\fBpkgrepo info\fR 和 \fBpkgrepo contents\fR 命令适用于软件包归档文件。
+solaris   repository related-uris     ()</screen>
+</example>
+<example><title>设置缺省发布者</title>
+<screen>$ <userinput>pkgrepo set -s /my/repository publisher/prefix=example.com</userinput></screen>
+</example>
+<example><title>设置发布者属性</title>
+<screen>$ <userinput>pkgrepo set -s /my/repository -p example.com &bsol;</userinput>
+<userinput>repository/origins=http://example.com/repository</userinput></screen>
+</example>
+<example><title>将新的发布者添加到系统信息库中</title>
+<screen>$ <userinput>pkgrepo add-publisher -s /my/repository example.com</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>请求了多项操作,但只有一部分操作成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>4</returnvalue></term>
+<listitem><para>没有进行更改时,无需执行任何操作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgrecv-1"><citerefentry><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="CCOSP">《<citetitle remap="book">Copying and Creating Package Repositories in Oracle Solaris 11.3</citetitle>》</olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>大多数 <command>pkgrepo</command> 操作不可用于软件包归档文件。软件包归档文件是一个文件,通常带有 <filename>.p5p</filename> 扩展名,如 <literal>pkgrecv</literal>(1) 手册页中的 <option>a</option> 选项所述。软件包归档文件包含软件包但不包含系统信息库配置。但是,<command>pkgrepo list</command>、<command>pkgrepo info</command> 和 <command>pkgrepo contents</command> 命令适用于软件包归档文件。</para>
+</refsect1>
+</refentry>
--- a/src/man/zh_CN/pkgsend.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgsend.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,401 +1,207 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgsend 1 "2013 年 7 月 30 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgsend \- 映像包管理系统发布客户机
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgsend [\fIoptions\fR] \fIcommand\fR [\fIcmd_options\fR] [\fIoperands\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pkgsend generate [-T \fIpattern\fR] [--target \fIfile\fR]
-    \fIsource\fR ...
-.fi
-
-.LP
-.nf
-/usr/bin/pkgsend publish [-b \fIbundle\fR]... [-d \fIsource\fR]...
-    [-s \fIrepo_uri_or_path\fR] [--key \fIssl_key\fR --cert \fIssl_cert\fR]...
-    [-T \fIpattern\fR] [--no-catalog] [\fImanifest\fR ...]
-.fi
-
-.SH 描述
-.sp
-.LP
-通过 \fBpkgsend\fR,可使用软件包清单将新软件包和新软件包版本发布到映像包管理系统信息库。要创建或管理系统信息库,请参见 \fBpkgrepo\fR(1)。要从现有系统信息库的软件包中创建软件包归档文件,请参见 \fBpkgrecv\fR(1)。有关软件包清单的更多信息,请参见 \fBpkg\fR(5)。
-.sp
-.LP
-完成 \fBpkgsend publish\fR 操作后,如果您的 \fI repo_uri_or_path\fR 系统信息库必须支持 \fBpkg search\fR 操作,请在系统信息库上运行 \fBpkgrepo refresh\fR 以更新搜索索引。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-?\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.SH 子命令
-.sp
-.LP
-支持以下子命令:
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgsend generate\fR [\fB-T\fR \fIpattern\fR] [\fB--target\fR \fIfile\fR] \fIsource\fR ...\fR
-.ad
-.sp .6
-.RS 4n
-读取每个 \fIsource\fR(例如,SVR4 软件包、目录或 \fBtar\fR 文件)并将介绍 \fIsource\fR 的清单发送到 \fBstdout\fR。在输出清单中,\fBfile\fR 和 \fBdir\fR 操作将所有者设置为 \fBroot\fR,并将组设置为 \fBbin\fR。
-.sp
-然后可以注释输出清单,使用 \fBpkgdepend\fR 添加或分析依赖项,并在将其传递到 \fBpublish\fR 子命令之前使用 \fB pkglint\fR 验证它的正确性。
-.sp
-.LP
-以下是支持的源:
-.RS +4
-.TP
-.ie t \(bu
-.el o
-文件系统格式 SVR4 软件包
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-数据流格式 SVR4 软件包
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-\fBtar\fR 文件
-.RE
-.RS +4
-.TP
-.ie t \(bu
-.el o
-目录
-.RE
-如果源中文件的基本名称与使用 \fB-T\fR 指定的模式匹配,则将文件的时间戳添加到该文件的操作中。\fIpattern\fR 使用 shell 匹配规则:
-.sp
-.ne 2
-.mk
-.na
-\fB*\fR
-.ad
-.RS 10n
-.rt  
-匹配所有内容。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB?\fR
-.ad
-.RS 10n
-.rt  
-匹配任何单个字符。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB[\fIseq\fR]\fR
-.ad
-.RS 10n
-.rt  
-匹配 \fIseq\fR 中的任何字符。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB![\fIseq\fR]\fR
-.ad
-.RS 10n
-.rt  
-匹配不在 \fIseq\fR 中的任何字符。
-.RE
-
-如果指定源是一个目录,当单个 inode 具有多个路径名称时,则没有明确的方式区分 \fBfile\fR 操作与 \fBhardlink\fR 操作。通常,在文件系统遍历中发现的第一个视为文件,其余的视为硬链接。这可以是任意的,具体取决于文件系统的实现方式。要指定哪些路径名称应视为文件,请将每个路径名称作为参数传递到 \fB--target\fR 选项。该选项不会影响其他类型的源,因为它们可以表明哪些路径名称是文件,哪些是硬链接。
-.sp
-当提供 SVR4 软件包作为源时,\fBpkgsend\fR 会确认不存在具有类操作脚本的文件,以及不存在安装前、安装后、删除前或删除后脚本。但与 \fBmanifest\fR 类一起安装的任何 SMF 清单除外。将从所有可重定位路径中删除 \fBBASEDIR \fR。
-.sp
-SVR4 \fBDESC\fR 参数将转换为 \fBpkg.description \fR 值。SVR4 \fBNAME\fR 参数将转换为 \fBpkg.summary\fR 值。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fBpkgsend publish\fR [\fB-b\fR \fIbundle\fR]... [\fB-d\fR \fIsource\fR]... [\fB-s\fR \fIrepo_uri_or_path\fR] [\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR]... [\fB-T\fR \fIpattern\fR] [\fB--no-catalog\fR] [\fImanifest\fR ...]\fR
-.ad
-.sp .6
-.RS 4n
-将使用指定软件包清单的软件包发布到目标软件包系统信息库,并从提供的源中检索该软件包的文件。如果指定了多个清单,它们将以提供的顺序联接。如果未指定清单,则将从 \fBstdin\fR 中读取清单。
-.sp
-如果未指定,则 \fBpkgsend publish\fR 向软件包 FMRI 添加内部版本。\fBpublish\fR 工具还向软件包 FMRI 添加时间戳(UTC 中的当前时间)。有关软件包 FMRI 的版本字符串的信息,请参见 \fBpkg\fR(5) 手册页。
-.sp
-如果可能会有多个 \fBpkgsend publish\fR 进程同时发布到同一 \fB-s\fR 系统信息库,建议指定 \fB--no-catalog\fR 选项。请参见下文对 \fB--no-catalog\fR 选项的说明。
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-b\fR \fIbundle\fR\fR
-.ad
-.sp .6
-.RS 4n
-将指定的包添加到源列表,以便在查找清单中的文件时搜索该包。包是 tar 文件和 SVR4 软件包等源。如果多次指定该选项,则以在命令行显示的顺序对源进行搜索。如果同时指定 \fB- b\fR 和 \fB-d\fR,则首先搜索 \fB-d\fR 源。有关支持的包及其使用方法的说明,请参见以上的 \fBgenerate\fR 子命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR \fIsource\fR\fR
-.ad
-.sp .6
-.RS 4n
-将指定的目录添加到源列表,以便在查找清单中的文件时搜索该目录。如果多次指定该选项,则以在命令行显示的顺序对源进行搜索。有关支持的源及其使用方法的说明,请参见以上的 \fBgenerate\fR 子命令。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIrepo_uri_or_path\fR\fR
-.ad
-.sp .6
-.RS 4n
-将软件包发布到位于给定 URI 或文件系统路径的系统信息库。有关发布限制和建议的更多信息,请参见下文的“附注”部分。另请参见“环境变量”部分。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--key\fR \fIssl_key\fR \fB--cert\fR \fIssl_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用 \fB--key\fR 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 密钥文件。使用 \fB--cert\fR 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 证书文件。可以多次指定此选项对。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-不将软件包添加到发布者的目录。当由于必须连续执行对发布者目录的更新而一次发布多个软件包时,建议使用此选项。当多个进程同时发布软件包时,如果不使用此选项,发布性能会显著降低。完成发布后,可使用 \fBpkgrepo refresh\fR 命令将新软件包添加到相应的发布者目录。
-.RE
-
-有关 \fB-T\fR 选项的说明,请参见以上的 \fBgenerate\fR 子命令。
-.RE
-
-.SH 环境变量
-.sp
-.ne 2
-.mk
-.na
-\fB\fBPKG_REPO\fR\fR
-.ad
-.RS 12n
-.rt  
-目标系统信息库的路径或 URI。
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR生成并发布软件包
-.sp
-.LP
-使用 \fBpkgsend generate\fR 创建软件包并将其发布。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend generate /path/to/proto > /path/to/manifests/foo.p5m\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-将 \fBexample.com\fR 发布者的软件包 FMRI 添加到 \fBfoo.p5m\fR 的开头。
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
-.fi
-.in -2
-
-.sp
-.LP
-结果清单应类似于以下内容:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
+<refentry lang="zh" id="pkgsend-1">
+<refmeta><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 7 月 30 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2015, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgsend</refname><refpurpose>映像包管理系统发布客户机</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgsend [<replaceable>options</replaceable>] <replaceable>command</replaceable> [<replaceable>cmd_options</replaceable>] [<replaceable>operands</replaceable>]
+</synopsis>
+<synopsis>/usr/bin/pkgsend generate [-T <replaceable>pattern</replaceable>] [--target <replaceable>file</replaceable>]
+    <replaceable>source</replaceable> ...</synopsis>
+<synopsis>/usr/bin/pkgsend publish [-b <replaceable>bundle</replaceable>]... [-d <replaceable>source</replaceable>]...
+    [-s <replaceable>repo_uri_or_path</replaceable>] [--key <replaceable>ssl_key</replaceable> --cert <replaceable>ssl_cert</replaceable>]...
+    [-T <replaceable>pattern</replaceable>] [--no-catalog] [<replaceable>manifest</replaceable> ...]</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pkgsend-1-desc" role="description"><title></title>
+<para>通过 <command>pkgsend</command>,可使用软件包清单将新软件包和新软件包版本发布到映像包管理系统信息库。要创建或管理系统信息库,请参见 <command>pkgrepo</command>(1)。要从现有系统信息库的软件包中创建软件包归档文件,请参见 <command>pkgrecv</command>(1)。有关软件包清单的更多信息,请参见 <literal>pkg</literal>(5)。</para>
+<para>完成 <command>pkgsend publish</command> 操作后,如果您的 <replaceable> repo_uri_or_path</replaceable> 系统信息库必须支持 <command>pkg search</command> 操作,请在系统信息库上运行 <command>pkgrepo refresh</command> 以更新搜索索引。</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>
+</variablelist>
+</refsect1>
+<refsect1 role="subcommands"><title></title>
+<para>支持以下子命令:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><command>pkgsend generate</command> [<option>T</option> <replaceable>pattern</replaceable>] [<option>-target</option> <replaceable>file</replaceable>] <replaceable>source</replaceable> ...</term>
+<listitem><para>读取每个 <replaceable>source</replaceable>(例如,SVR4 软件包、目录或 <command>tar</command> 文件)并将介绍 <replaceable>source</replaceable> 的清单发送到 <filename>stdout</filename>。
+</para>
+<para>然后可以注释输出清单,使用 <command>pkgdepend</command> 添加或分析依赖项,并在将其传递到 <command>publish</command> 子命令之前使用 <command> pkglint</command> 验证它的正确性。
+</para>
+<itemizedlist>
+<para>以下是支持的源:</para>
+<listitem><para>文件系统格式 SVR4 软件包</para></listitem>
+<listitem><para>数据流格式 SVR4 软件包</para></listitem>
+<listitem><para><command>tar</command> 文件</para></listitem>
+<listitem><para>目录</para></listitem>
+</itemizedlist>
+<para>如果源中文件的基本名称与使用 <option>T</option> 指定的模式匹配,则将文件的时间戳添加到该文件的操作中。<replaceable>pattern</replaceable> 使用 shell 匹配规则:</para>
+<variablelist>
+<varlistentry><term>*</term>
+<listitem><para>匹配所有内容。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>?</term>
+<listitem><para>匹配任何单个字符。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>[<replaceable>seq</replaceable>]</term>
+<listitem><para>匹配 <replaceable>seq</replaceable> 中的任何字符。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term>![<replaceable>seq</replaceable>]</term>
+<listitem><para>匹配不在 <replaceable>seq</replaceable> 中的任何字符。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>如果指定源是一个目录,当单个 inode 具有多个路径名称时,则没有明确的方式区分 <literal>file</literal> 操作与 <literal>hardlink</literal> 操作。通常,在文件系统遍历中发现的第一个视为文件,其余的视为硬链接。这可以是任意的,具体取决于文件系统的实现方式。要指定哪些路径名称应视为文件,请将每个路径名称作为参数传递到 <option>-target</option> 选项。该选项不会影响其他类型的源,因为它们可以表明哪些路径名称是文件,哪些是硬链接。</para>
+<para>当提供 SVR4 软件包作为源时,<command>pkgsend</command> 会确认不存在具有类操作脚本的文件,以及不存在安装前、安装后、删除前或删除后脚本。但与 <literal>manifest</literal> 类一起安装的任何 SMF 清单除外。将从所有可重定位路径中删除 <literal>BASEDIR </literal>。</para>
+<para>SVR4 <literal>DESC</literal> 参数将转换为 <literal>pkg.description </literal> 值。SVR4 <literal>NAME</literal> 参数将转换为 <literal>pkg.summary</literal> 值。</para>
+<para>基于目录生成清单时,每个文件和目录的所有者和组分别缺省为根和 bin。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><command>pkgsend publish</command> [<option>b</option> <replaceable>bundle</replaceable>]... [<option>d</option> <replaceable>source</replaceable>]... [<option>s</option> <replaceable>repo_uri_or_path</replaceable>] [<option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable>]... [<option>T</option> <replaceable>pattern</replaceable>] [<option>-no-catalog</option>] [<replaceable>manifest</replaceable> ...]</term>
+<listitem><para>将使用指定软件包清单的软件包发布到目标软件包系统信息库,并从提供的源中检索该软件包的文件。如果指定了多个清单,它们将以提供的顺序联接。如果未指定清单,则将从 <literal>stdin</literal> 中读取清单。</para>
+<para>如果未指定,则 <command>pkgsend publish</command> 向软件包 FMRI 添加内部版本。<command>publish</command> 工具还向软件包 FMRI 添加时间戳(UTC 中的当前时间)。有关软件包 FMRI 的版本字符串的信息,请参见 <literal>pkg</literal>(5) 手册页。</para>
+<para>如果可能会有多个 <command>pkgsend publish</command> 进程同时发布到同一 <option>s</option> 系统信息库,建议指定 <option>-no-catalog</option> 选项。请参见下文对 <option>-no-catalog</option> 选项的说明。</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>b</option> <replaceable>bundle</replaceable></term>
+<listitem><para>将指定的包添加到源列表,以便在查找清单中的文件时搜索该包。包是 tar 文件和 SVR4 软件包等源。如果多次指定该选项,则以在命令行显示的顺序对源进行搜索。如果同时指定 <option> b</option> 和 <option>d</option>,则首先搜索 <option>d</option> 源。有关支持的包及其使用方法的说明,请参见以上的 <command>generate</command> 子命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option> <replaceable>source</replaceable></term>
+<listitem><para>将指定的目录添加到源列表,以便在查找清单中的文件时搜索该目录。如果多次指定该选项,则以在命令行显示的顺序对源进行搜索。有关支持的源及其使用方法的说明,请参见以上的 <command>generate</command> 子命令。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>repo_uri_or_path</replaceable></term>
+<listitem><para>将软件包发布到位于给定 URI 或文件系统路径的系统信息库。有关发布限制和建议的更多信息,请参见下文的“附注”部分。另请参见“环境变量”部分。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-key</option> <replaceable>ssl_key</replaceable> <option>-cert</option> <replaceable>ssl_cert</replaceable></term>
+<listitem><para>使用 <option>-key</option> 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 密钥文件。使用 <option>-cert</option> 选项指定用于从 HTTPS 系统信息库进行软件包检索的客户机 SSL 证书文件。可以多次指定此选项对。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>不将软件包添加到发布者的目录。当由于必须连续执行对发布者目录的更新而一次发布多个软件包时,建议使用此选项。当多个进程同时发布软件包时,如果不使用此选项,发布性能会显著降低。完成发布后,可使用 <command>pkgrepo refresh</command> 命令将新软件包添加到相应的发布者目录。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+<para>有关 <option>T</option> 选项的说明,请参见以上的 <command>generate</command> 子命令。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="environment-variables"><title></title>
+<variablelist>
+<varlistentry><term><envar>PKG_REPO</envar></term>
+<listitem><para>目标系统信息库的路径或 URI。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>生成并发布软件包</title>
+<para>使用 <command>pkgsend generate</command> 创建软件包并将其发布。</para>
+<screen>$ <userinput>pkgsend generate /path/to/proto > /path/to/manifests/foo.p5m</userinput></screen>
+<para>将 <literal>example.com</literal> 发布者的软件包 FMRI 添加到 <filename>foo.p5m</filename> 的开头。</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]</programlisting>
+<para>结果清单应类似于以下内容:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]
 dir group=sys mode=0755 owner=root path=usr
 dir group=bin mode=0755 owner=root path=usr/bin
-file usr/bin/foo group=bin mode=0555 owner=root path=usr/bin/foo
-.fi
-.in -2
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s http://example.com:10000 -d /path/to/proto \e\fR
-\fB/path/to/manifests/foo.p5m\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR创建和发布普通软件包
-.sp
-.LP
-为包含以下行的发布者 \fBexample.com\fR 创建清单:
-
-.sp
-.in +2
-.nf
-set name=pkg.fmri value=pkg://example.com/[email protected]
-file /exdir/foo mode=0555 owner=root group=bin path=/usr/bin/foo
-.fi
-.in -2
-
-.sp
-.LP
-发布软件包:
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s http://example.com:10000 -d /exdir\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 3 \fR使用已经存在的清单
-.sp
-.LP
-使用基于文件系统的发布和已经存在的清单发布软件包。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsend publish -s /tmp/example_repo -d /tmp/pkg_files \e\fR
-\fB/tmp/pkg_manifest\fR
-.fi
-.in -2
-.sp
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
+file usr/bin/foo group=bin mode=0555 owner=root path=usr/bin/foo</programlisting>
+<screen>$ <userinput>pkgsend publish -s http://example.com:10000 -d /path/to/proto &bsol;</userinput>
+<userinput>/path/to/manifests/foo.p5m</userinput></screen>
+</example>
+<example><title>创建和发布普通软件包</title>
+<para>为包含以下行的发布者 <literal>example.com</literal> 创建清单:</para>
+<programlisting>set name=pkg.fmri value=pkg://example.com/[email protected]
+file /exdir/foo mode=0555 owner=root group=bin path=/usr/bin/foo</programlisting>
+<para>发布软件包:</para>
+<screen>$ <userinput>pkgsend publish -s http://example.com:10000 -d /exdir</userinput></screen>
+</example>
+<example><title>使用已经存在的清单</title>
+<para>使用基于文件系统的发布和已经存在的清单发布软件包。</para>
+<screen>$ <userinput>pkgsend publish -s /tmp/example_repo -d /tmp/pkg_files &bsol;</userinput>
+<userinput>/tmp/pkg_manifest</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkgdepend-1"><citerefentry><refentrytitle>pkgdepend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg.depotd-1m"><citerefentry><refentrytitle>pkg.depotd</refentrytitle><manvolnum>1M</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><olink targetdoc="PKDEV">《<citetitle remap="book">Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.3</citetitle>》</olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>由于发布协议限制,当发布大小超过 128 MB 的单个软件包文件时,必须使用基于文件系统的发布。当需要系统信息库的访问控制时,也建议使用基于文件系统的发布。</para>
+<para>当使用基于文件系统的发布时,在完成发布后必须重新启动提供目标系统信息库服务的任何 <command>pkg.depotd</command> 进程,以便在其 Web 界面或搜索响应中反映更改。有关更多信息,请参见 <command>pkg.depotd</command>(1M)。</para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkgdepend\fR(1)、\fBpkgrepo\fR(1)、\fBpkg.depotd\fR(1M)、\fBpkg\fR(5)
-.sp
-.LP
-\fI《Packaging and Delivering Software With the Image Packaging System in Oracle Solaris 11.2》\fR
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 附注
-.sp
-.LP
-由于发布协议限制,当发布大小超过 128 MB 的单个软件包文件时,必须使用基于文件系统的发布。当需要系统信息库的访问控制时,也建议使用基于文件系统的发布。
-.sp
-.LP
-当使用基于文件系统的发布时,在完成发布后必须重新启动提供目标系统信息库服务的任何 \fBpkg.depotd\fR 进程,以便在其 Web 界面或搜索响应中反映更改。有关更多信息,请参见 \fBpkg.depotd\fR(1M)。
--- a/src/man/zh_CN/pkgsign.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pkgsign.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,240 +1,145 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pkgsign 1 "2013 年 5 月 21 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pkgsign \- 映像包管理系统签名实用程序
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pkgsign [-a \fIhash_algorithm\fR]
-    [-c \fIpath_to_signing_certificate\fR]
-    [-i \fIpath_to_intermediate_cert\fR] ...
-    [-k \fIpath_to_private_key\fR] [-n] -s \fIpath_or_uri\fR
-    [--help] [--no-index] [--no-catalog]
-    (\fIfmri\fR|\fIpattern\fR) ...
-.fi
-
-.SH 描述
-.sp
-.LP
-通过使用提供的密钥和证书添加签名操作,\fBpkgsign\fR 可在系统信息库中更新给定 FMRI 的清单。修改后的软件包保留原来的时间戳。
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-a\fR \fIhash_algorithm\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用签名算法 \fIhash_algorithm \fR 而不是缺省值。缺省签名算法为 \fB rsa-sha256\fR。支持的签名算法包括 \fBrsa-sha256\fR、\fBrsa-sha384\fR、\fBrsa-sha512\fR、\fBsha256\fR、\fBsha384\fR 和 \fBsha512\fR。仅指定散列算法的签名算法会导致签名值为软件包清单的散列。指定 \fBrsa \fR 和散列算法的签名算法会导致签名值为使用提供的私钥进行签名的清单的散列(请参见 \fB-c\fR 和 \fB- k\fR 选项)。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-c\fR \fIpath_to_signing_certificate\fR\fR
-.ad
-.sp .6
-.RS 4n
-添加证书 \fIpath_to_signing_certificate\fR 作为验证操作中的签名值时所使用的证书。\fB-c\fR 选项仅可以与 \fB-k\fR 选项一起使用。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-i\fR \fIpath_to_intermediate_cert\fR\fR
-.ad
-.sp .6
-.RS 4n
-添加证书 \fIpath_to_intermediate_cert\fR 作为验证证书 \fIpath_to_signing_certificate \fR(作为参数提供给 \fB-c\fR)时所使用的证书。通过多次指定 \fB-i\fR,可提供多个证书。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-k\fR \fIpath_to_private_key\fR\fR
-.ad
-.sp .6
-.RS 4n
-使用存储在 \fIpath_to_private_key \fR 中的私钥对清单进行签名。\fB-k\fR 选项只能与 \fB-c\fR 选项一起使用。如果未设置 \fB-k\fR,则签名值为清单的散列。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-n\fR\fR
-.ad
-.sp .6
-.RS 4n
-执行试运行,不以任何方式更改系统信息库。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-s\fR \fIpath_or_uri\fR\fR
-.ad
-.sp .6
-.RS 4n
-对位于 \fIpath_or_uri \fR 的系统信息库中的软件包进行签名。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-index\fR\fR
-.ad
-.sp .6
-.RS 4n
-在重新发布已签名的清单后不更新系统信息库搜索索引。
-.RE
+<?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;
+]>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB--no-catalog\fR\fR
-.ad
-.sp .6
-.RS 4n
-在重新发布已签名的清单后不更新系统信息库目录。
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR使用清单的散列值进行签名
-.sp
-.LP
-使用清单的散列值对发布到 \fBhttp://localhost:10000\fR 的软件包进行签名。这通常用于测试。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsign -s http://localhost:10000 -a sha256 \e\fR
-\[email protected],5.11-0:20100626T030108Z\fR
-.fi
-.in -2
-.sp
-
-.LP
-\fB示例 2 \fR使用密钥和证书进行签名
-.sp
-.LP
-使用 \fBrsa-sha384\fR 对发布到位于 \fB/foo/bar\fR 的文件系统信息库的软件包进行签名,以便对清单执行散列和签名操作。签名密钥位于 \fB/key/usr2.key\fR 中,其关联的证书位于 \fB/key/usr2.cert\fR 中,而用于验证证书的证书位于 \fB/icerts/usr1.cert\fR 中。
-
-.sp
-.in +2
-.nf
-$ \fBpkgsign -s file:///foo/bar/ -a rsa-sha384 \e\fR
-\fB-k /key/usr2.key -c /key/usr2.cert -i /icerts/usr1.cert \e\fR
-\[email protected],5.11-0:20100626T031341Z\fR
-.fi
-.in -2
-.sp
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 6n
-.rt  
-命令成功。
-.RE
+<refentry lang="zh" id="pkgsign-1">
+<refmeta><refentrytitle>pkgsign</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>pkgsign</refname><refpurpose>映像包管理系统签名实用程序</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pkgsign [-a <replaceable>hash_algorithm</replaceable>]
+    [-c <replaceable>path_to_signing_certificate</replaceable>]
+    [-i <replaceable>path_to_intermediate_cert</replaceable>] ...
+    [-k <replaceable>path_to_private_key</replaceable>] [-n] -s <replaceable>path_or_uri
+</replaceable>
+    [--help] [--no-index] [--no-catalog]
+    (<replaceable>fmri</replaceable>|<replaceable>pattern</replaceable>) ...</synopsis></refsynopsisdiv>
+<refsect1 id="pkgsign-1-desc" role="description"><title></title>
+<para>通过使用提供的密钥和证书添加签名操作,<command>pkgsign</command> 可在系统信息库中更新给定 FMRI 的清单。修改后的软件包保留原来的时间戳。</para>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>支持以下选项:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>-help</option></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>a</option> <replaceable>hash_algorithm</replaceable></term>
+<listitem><para>使用签名算法 <replaceable>hash_algorithm </replaceable> 而不是缺省值。缺省签名算法为 <literal> rsa-sha256</literal>。支持的签名算法包括 <literal>rsa-sha256</literal>、<literal>rsa-sha384</literal>、<literal>rsa-sha512</literal>、<literal>sha256</literal>、<literal>sha384</literal> 和 <literal>sha512</literal>。仅指定散列算法的签名算法会导致签名值为软件包清单的散列。指定 <literal>rsa </literal> 和散列算法的签名算法会导致签名值为使用提供的私钥进行签名的清单的散列(请参见 <option>c</option> 和 <option> k</option> 选项)。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>c</option> <replaceable>path_to_signing_certificate</replaceable></term>
+<listitem><para>添加证书 <replaceable>path_to_signing_certificate</replaceable> 作为验证操作中的签名值时所使用的证书。<option>c</option> 选项仅可以与 <option>k</option> 选项一起使用。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>i</option> <replaceable>path_to_intermediate_cert</replaceable></term>
+<listitem><para>添加证书 <replaceable>path_to_intermediate_cert</replaceable> 作为验证证书 <replaceable>path_to_signing_certificate </replaceable>(作为参数提供给 <option>c</option>)时所使用的证书。通过多次指定 <option>i</option>,可提供多个证书。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>k</option> <replaceable>path_to_private_key</replaceable></term>
+<listitem><para>使用存储在 <replaceable>path_to_private_key </replaceable> 中的私钥对清单进行签名。<option>k</option> 选项只能与 <option>c</option> 选项一起使用。如果未设置 <option>k</option>,则签名值为清单的散列。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>n</option></term>
+<listitem><para>执行试运行,不以任何方式更改系统信息库。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>s</option> <replaceable>path_or_uri</replaceable></term>
+<listitem><para>对位于 <replaceable>path_or_uri </replaceable> 的系统信息库中的软件包进行签名。
+</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-index</option></term>
+<listitem><para>在重新发布已签名的清单后不更新系统信息库搜索索引。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>-no-catalog</option></term>
+<listitem><para>在重新发布已签名的清单后不更新系统信息库目录。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>使用清单的散列值进行签名</title>
+<para>使用清单的散列值对发布到 <literal>http://localhost:10000</literal> 的软件包进行签名。这通常用于测试。</para>
+<screen>$ <userinput>pkgsign -s http://localhost:10000 -a sha256 &bsol;</userinput>
+<userinput>[email protected],5.11-0:20100626T030108Z</userinput></screen>
+</example>
+<example><title>使用密钥和证书进行签名</title>
+<para>使用 <literal>rsa-sha384</literal> 对发布到位于 <literal>/foo/bar</literal> 的文件系统信息库的软件包进行签名,以便对清单执行散列和签名操作。签名密钥位于 <literal>/key/usr2.key</literal> 中,其关联的证书位于 <literal>/key/usr2.cert</literal> 中,而用于验证证书的证书位于 <literal>/icerts/usr1.cert</literal> 中。</para>
+<screen>$ <userinput>pkgsign -s file:///foo/bar/ -a rsa-sha384 &bsol;</userinput>
+<userinput>-k /key/usr2.key -c /key/usr2.cert -i /icerts/usr1.cert &bsol;</userinput>
+<userinput>[email protected],5.11-0:20100626T031341Z</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>命令成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>3</returnvalue></term>
+<listitem><para>请求了多项操作,但只有一部分操作成功。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>99</returnvalue></term>
+<listitem><para>发生了意外的异常。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgrecv-1"><citerefentry><refentrytitle>pkgrecv</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgsend-1"><citerefentry><refentrytitle>pkgsend</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkgrepo-1"><citerefentry><refentrytitle>pkgrepo</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+</refentry>
 
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 6n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 6n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB3\fR\fR
-.ad
-.RS 6n
-.rt  
-请求了多项操作,但只有一部分操作成功。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB99\fR\fR
-.ad
-.RS 6n
-.rt  
-发生了意外的异常。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpkg\fR(1)、\fBpkgrecv\fR(1)、\fBpkgsend\fR(1)、\fBpkgrepo\fR(1)、\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
--- a/src/man/zh_CN/pm-updatemanager.1	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/man/zh_CN/pm-updatemanager.1	Wed Jul 01 10:45:55 2015 -0700
@@ -1,176 +1,111 @@
-'\" te
-.\" Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.
-.TH pm-updatemanager 1 "2013 年 5 月 21 日" "SunOS 5.11" "用户命令"
-.SH 名称
-pm-updatemanager \- 用于更新软件包的应用程序
-.SH 用法概要
-.LP
-.nf
-/usr/bin/pm-updatemanager [\fIoptions\fR]
-.fi
-
-.LP
-.nf
-/usr/bin/pm-updatemanager [-h | --help] [-d | --debug]
-    [-R \fIdir\fR | --image-dir \fIdir\fR]
-.fi
-
-.SH 描述
-.sp
-.LP
-\fBpm-updatemanager\fR 检查系统上安装的软件包是否存在可用更新并安装这些更新。
-.LP
-注 - 
-.sp
-.RS 2
-如果 \fBpackage/pkg\fR、\fBpackage/pkg/package-manager \fR 或 \fBpackage/pkg/update-manager\fR 软件包需要更新,则 \fBpm-updatemanager\fR 首先更新这些软件包,然后重新启动以完成其余所有更新。
-.RE
-.SH 选项
-.sp
-.LP
-支持以下选项:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-h\fR\fR
-.ad
-.br
-.na
-\fB\fB--help\fR\fR
-.ad
-.sp .6
-.RS 4n
-显示用法消息。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-d\fR\fR
-.ad
-.br
-.na
-\fB\fB--debug\fR\fR
-.ad
-.sp .6
-.RS 4n
-在调试模式下运行 \fBpm-updatemanager\fR。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB-R\fR \fIdir\fR\fR
-.ad
-.br
-.na
-\fB\fB--image-dir\fR \fIdir\fR\fR
-.ad
-.sp .6
-.RS 4n
-对根目录为 \fIdir\fR 的映像(而不是自动搜索到的映像)执行操作。
-.RE
-
-.SH 示例
-.LP
-\fB示例 1 \fR更新当前映像
-.sp
-.LP
-对当前映像调用 \fBpm-updatemanager\fR。这会检查当前映像中安装的软件包的所有可用更新并安装这些更新。
+<?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="zh" id="pm-updatemanager-1">
+<!-- %Z%%M% %I% %E% SMI; -->
+<refmeta><refentrytitle>pm-updatemanager</refentrytitle><manvolnum>1</manvolnum> <refmiscinfo class="date">2013 年 5 月 21 日</refmiscinfo> <refmiscinfo class="sectdesc">&man1;</refmiscinfo> <refmiscinfo class="software">&release;</refmiscinfo> <refmiscinfo class="arch">generic</refmiscinfo> <refmiscinfo class="copyright">Copyright (c) 2007, 2013, Oracle and/or its affiliates.All rights reserved.</refmiscinfo> 
+</refmeta>
+<refnamediv>
+<refname>pm-updatemanager</refname><refpurpose>用于更新软件包的应用程序</refpurpose>
+</refnamediv>
+<refsynopsisdiv><title></title>
+<synopsis>/usr/bin/pm-updatemanager [<replaceable>options</replaceable>]</synopsis>
+<synopsis>/usr/bin/pm-updatemanager [-h | --help] [-d | --debug]
+    [-R <replaceable>dir</replaceable> | --image-dir <replaceable>dir</replaceable>]
+</synopsis>
+</refsynopsisdiv>
+<refsect1 id="pm-updatemanager-1-desc" role="description"><title></title>
+<para><command>pm-updatemanager</command> 检查系统上安装的软件包是否存在可用更新并安装这些更新。</para>
+<note><para>如果 <literal>package/pkg</literal>、<literal>package/pkg/package-manager </literal> 或 <literal>package/pkg/update-manager</literal> 软件包需要更新,则 <command>pm-updatemanager</command> 首先更新这些软件包,然后重新启动以完成其余所有更新。</para></note>
+</refsect1>
+<refsect1 role="options"><title></title>
+<para>支持以下选项:</para>
+<variablelist termlength="wholeline">
+<varlistentry><term><option>h</option></term><term><option>-help</option></term>
+<listitem><para>显示用法消息。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>d</option></term><term><option>-debug</option></term>
+<listitem><para>在调试模式下运行 <command>pm-updatemanager</command>。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><option>R</option> <replaceable>dir</replaceable></term> <term><option>-image-dir</option> <replaceable>dir</replaceable></term>
+<listitem><para>对根目录为 <replaceable>dir</replaceable> 的映像(而不是自动搜索到的映像)执行操作。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="examples"><title></title>
+<example><title>更新当前映像</title>
+<para>对当前映像调用 <command>pm-updatemanager</command>。这会检查当前映像中安装的软件包的所有可用更新并安装这些更新。</para>
+<screen>$ <userinput>/usr/lib/pm-launch pm-updatemanager</userinput></screen>
+<para>这是桌面菜单选项“系统”&#62;“管理”&#62; &#34;Update Manager&#34; 调用的同一命令。</para>
+</example>
+<example><title>更新指定映像</title>
+<para>对存储在 <literal> /aux0/example_root</literal> 中的映像调用 <command>pm-updatemanager</command>。</para>
+<screen>$ <userinput>/usr/lib/pm-launch pm-updatemanager -R /aux0/example_root</userinput></screen>
+</example>
+</refsect1>
+<refsect1 role="exit-status"><title></title>
+<para>将返回以下退出值:</para>
+<variablelist>
+<varlistentry><term><returnvalue>0</returnvalue></term>
+<listitem><para>一切正常工作。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>1</returnvalue></term>
+<listitem><para>出现错误。</para>
+</listitem>
+</varlistentry>
+<varlistentry><term><returnvalue>2</returnvalue></term>
+<listitem><para>指定的命令行选项无效。</para>
+</listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+<refsect1 role="attributes"><title></title>
+<para>有关下列属性的说明,请参见 <literal>attributes</literal>(5):</para>
+<informaltable frame="all" orient="port">
+<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="col1" colwidth="198*" align="left" /><colspec colname="col2" colwidth="198*" align="left" /><thead>
+<row>
+<entry align="center">
+<para>属性类型</para>
+</entry>
+<entry align="center">
+<para>属性值</para>
+</entry>
+</row>
+</thead>
+<tbody>
+<row>
+<entry align="left">
+<para>可用性</para>
+</entry>
+<entry align="left">
+<para><literal>package/pkg/update-manager</literal></para>
+</entry>
+</row>
+<row>
+<entry align="left">
+<para>接口稳定性</para>
+</entry>
+<entry align="left">
+<para>Uncommitted(未确定)</para>
+</entry>
+</row>
+</tbody>
+</tgroup>
+</informaltable></refsect1>
+<refsect1 role="see-also"><title></title>
+<para><olink targetdoc="refman" targetptr="packagemanager-1"><citerefentry><refentrytitle>packagemanager</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-1"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum></citerefentry></olink>、<olink targetdoc="refman" targetptr="pkg-5"><citerefentry><refentrytitle>pkg</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink></para>
+<para><literal>https://java.net/projects/ips/pages/Home</literal></para>
+</refsect1>
+<refsect1 role="notes"><title></title>
+<para>对您不具有的映像执行操作时,需要具有足够的特权才能调用 <command>pm-updatemanager</command>。在这些情况下,通常使用 <literal>/usr/lib/pm-launch</literal> 调用 <command>pm-updatemanager </command>。
+</para>
+</refsect1>
+</refentry>
 
-.sp
-.in +2
-.nf
-$ \fB/usr/lib/pm-launch pm-updatemanager\fR
-.fi
-.in -2
-.sp
-
-.sp
-.LP
-这是桌面菜单选项“系统”>“管理”> "Update Manager" 调用的同一命令。
-
-.LP
-\fB示例 2 \fR更新指定映像
-.sp
-.LP
-对存储在 \fB /aux0/example_root\fR 中的映像调用 \fBpm-updatemanager\fR。
-
-.sp
-.in +2
-.nf
-$ \fB/usr/lib/pm-launch pm-updatemanager -R /aux0/example_root\fR
-.fi
-.in -2
-.sp
-
-.SH 退出状态
-.sp
-.LP
-将返回以下退出值:
-.sp
-.ne 2
-.mk
-.na
-\fB\fB0\fR\fR
-.ad
-.RS 5n
-.rt  
-一切正常工作。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB1\fR\fR
-.ad
-.RS 5n
-.rt  
-出现错误。
-.RE
-
-.sp
-.ne 2
-.mk
-.na
-\fB\fB2\fR\fR
-.ad
-.RS 5n
-.rt  
-指定的命令行选项无效。
-.RE
-
-.SH 属性
-.sp
-.LP
-有关下列属性的说明,请参见 \fBattributes\fR(5):
-.sp
-
-.sp
-.TS
-tab() box;
-cw(2.75i) |cw(2.75i) 
-lw(2.75i) |lw(2.75i) 
-.
-属性类型属性值
-_
-可用性\fBpackage/pkg/update-manager\fR
-_
-接口稳定性Uncommitted(未确定)
-.TE
-
-.SH 另请参见
-.sp
-.LP
-\fBpackagemanager\fR(1)、\fBpkg\fR(1)、\fBpkg\fR(5)
-.sp
-.LP
-\fBhttps://java.net/projects/ips/pages/Home\fR
-.SH 附注
-.sp
-.LP
-对您不具有的映像执行操作时,需要具有足够的特权才能调用 \fBpm-updatemanager\fR。在这些情况下,通常使用 \fB/usr/lib/pm-launch\fR 调用 \fBpm-updatemanager \fR。
--- a/src/pkg/external_deps.txt	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/pkg/external_deps.txt	Wed Jul 01 10:45:55 2015 -0700
@@ -5,6 +5,7 @@
     pkg:/developer/base-developer-utilities
     pkg:/developer/build/make
     pkg:/developer/build/onbld
+    pkg:/developer/documentation-tool/xml2roff
     pkg:/developer/gnome/gettext
     pkg:/developer/gnome/gnome-doc-utils
     pkg:/developer/python/pylint
--- a/src/pkg/manifests/developer:opensolaris:pkg5.p5m	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/pkg/manifests/developer:opensolaris:pkg5.p5m	Wed Jul 01 10:45:55 2015 -0700
@@ -31,6 +31,7 @@
 depend type=require fmri=pkg:/developer/base-developer-utilities
 depend type=require fmri=pkg:/developer/build/make
 depend type=require fmri=pkg:/developer/build/onbld
+depend type=require fmri=pkg:/developer/documentation-tool/xml2roff
 depend type=require fmri=pkg:/developer/gnome/gettext
 depend type=require fmri=pkg:/developer/gnome/gnome-doc-utils
 depend type=require fmri=pkg:/developer/python/pylint
--- a/src/setup.py	Tue Jun 23 10:48:54 2015 +0530
+++ b/src/setup.py	Wed Jul 01 10:45:55 2015 -0700
@@ -239,76 +239,105 @@
         "unknown": scripts_sunos,
         }
 
-man1_files = [
-        'man/packagemanager.1',
-        'man/pkg.1',
-        'man/pkgdepend.1',
-        'man/pkgdiff.1',
-        'man/pkgfmt.1',
-        'man/pkglint.1',
-        'man/pkgmerge.1',
-        'man/pkgmogrify.1',
-        'man/pkgsend.1',
-        'man/pkgsign.1',
-        'man/pkgsurf.1',
-        'man/pkgrecv.1',
-        'man/pkgrepo.1',
-        'man/pm-updatemanager.1',
-        ]
+MANPAGE_OUTPUT_ROOT = "man/nroff"
+
+man1_files = [ 
+    MANPAGE_OUTPUT_ROOT + '/man1/' + f
+    for f in [
+        'packagemanager.1',
+        'pkg.1',
+        'pkgdepend.1',
+        'pkgdiff.1',
+        'pkgfmt.1',
+        'pkglint.1',
+        'pkgmerge.1',
+        'pkgmogrify.1',
+        'pkgsend.1',
+        'pkgsign.1',
+        'pkgsurf.1',
+        'pkgrecv.1',
+        'pkgrepo.1',
+        'pm-updatemanager.1',
+    ]
+]
 man1m_files = [
-        'man/pkg.depotd.1m',
-        'man/pkg.depot-config.1m',
-        'man/pkg.sysrepo.1m'
-        ]
+    MANPAGE_OUTPUT_ROOT + '/man1m/' + f
+    for f in [
+        'pkg.depotd.1m',
+        'pkg.depot-config.1m',
+        'pkg.sysrepo.1m',
+    ]
+]
 man5_files = [
-        'man/pkg.5'
-        ]
+    MANPAGE_OUTPUT_ROOT + '/man5/' + f
+    for f in [
+        'pkg.5'
+    ]
+]
 
 man1_ja_files = [
-        'man/ja_JP/packagemanager.1',
-        'man/ja_JP/pkg.1',
-        'man/ja_JP/pkgdepend.1',
-        'man/ja_JP/pkgdiff.1',
-        'man/ja_JP/pkgfmt.1',
-        'man/ja_JP/pkglint.1',
-        'man/ja_JP/pkgmerge.1',
-        'man/ja_JP/pkgmogrify.1',
-        'man/ja_JP/pkgsend.1',
-        'man/ja_JP/pkgsign.1',
-        'man/ja_JP/pkgrecv.1',
-        'man/ja_JP/pkgrepo.1',
-        'man/ja_JP/pm-updatemanager.1',
-        ]
+    MANPAGE_OUTPUT_ROOT + '/ja_JP.UTF-8/man1/' + f
+    for f in [
+        'packagemanager.1',
+        'pkg.1',
+        'pkgdepend.1',
+        'pkgdiff.1',
+        'pkgfmt.1',
+        'pkglint.1',
+        'pkgmerge.1',
+        'pkgmogrify.1',
+        'pkgrecv.1',
+        'pkgrepo.1',
+        'pkgsend.1',
+        'pkgsign.1',
+        'pm-updatemanager.1',
+    ]
+]
 man1m_ja_files = [
-        'man/ja_JP/pkg.depotd.1m',
-        'man/ja_JP/pkg.sysrepo.1m'
-        ]
+    MANPAGE_OUTPUT_ROOT + '/ja_JP.UTF-8/man1m/' + f
+    for f in [
+        'pkg.depotd.1m',
+        'pkg.sysrepo.1m',
+    ]
+]
 man5_ja_files = [
-        'man/ja_JP/pkg.5'
-        ]
+    MANPAGE_OUTPUT_ROOT + '/ja_JP.UTF-8/man5/' + f
+    for f in [
+        'pkg.5'
+    ]
+]
 
 man1_zh_CN_files = [
-        'man/zh_CN/packagemanager.1',
-        'man/zh_CN/pkg.1',
-        'man/zh_CN/pkgdepend.1',
-        'man/zh_CN/pkgdiff.1',
-        'man/zh_CN/pkgfmt.1',
-        'man/zh_CN/pkglint.1',
-        'man/zh_CN/pkgmerge.1',
-        'man/zh_CN/pkgmogrify.1',
-        'man/zh_CN/pkgsend.1',
-        'man/zh_CN/pkgsign.1',
-        'man/zh_CN/pkgrecv.1',
-        'man/zh_CN/pkgrepo.1',
-        'man/zh_CN/pm-updatemanager.1',
-        ]
+    MANPAGE_OUTPUT_ROOT + '/zh_CN.UTF-8/man1/' + f
+    for f in [
+        'packagemanager.1',
+        'pkg.1',
+        'pkgdepend.1',
+        'pkgdiff.1',
+        'pkgfmt.1',
+        'pkglint.1',
+        'pkgmerge.1',
+        'pkgmogrify.1',
+        'pkgrecv.1',
+        'pkgrepo.1',
+        'pkgsend.1',
+        'pkgsign.1',
+        'pm-updatemanager.1',
+    ]
+]
 man1m_zh_CN_files = [
-        'man/zh_CN/pkg.depotd.1m',
-        'man/zh_CN/pkg.sysrepo.1m'
-        ]
+    MANPAGE_OUTPUT_ROOT + '/zh_CN.UTF-8/man1m/' + f
+    for f in [
+        'pkg.depotd.1m',
+        'pkg.sysrepo.1m',
+    ]
+]
 man5_zh_CN_files = [
-        'man/zh_CN/pkg.5'
-        ]
+    MANPAGE_OUTPUT_ROOT + '/zh_CN.UTF-8/man5/' + f
+    for f in [
+        'pkg.5'
+    ]
+]
 
 packages = [
         'pkg',
@@ -1371,6 +1400,45 @@
 
                 return dst, copied
 
+def manpage_input_dir(path):
+        """Convert a manpage output path to the directory where its source lives."""
+
+        patharr = path.split("/")
+        if len(patharr) == 4:
+                loc = ""
+        elif len(patharr) == 5:
+                loc = patharr[-3].split(".")[0]
+        else:
+                raise RuntimeError("bad manpage path")
+        return os.path.join(patharr[0], loc).rstrip("/")
+
+def xml2roff(files):
+        """Convert XML manpages to ROFF for delivery.
+
+        The input should be a list of the output file paths.  The corresponding
+        inputs will be generated from this.  We do it in this way so that we can
+        share the paths with the install code.
+
+        All paths should have a common manpath root.  In particular, pages
+        belonging to different localizations should be run through this function
+        separately.
+        """
+
+        input_dir = manpage_input_dir(files[0])
+        do_files = [
+            os.path.join(input_dir, os.path.basename(f))
+            for f in files
+            if dep_util.newer(os.path.join(input_dir, os.path.basename(f)), f)
+        ]
+        if do_files:
+                # Get the output dir by removing the filename and the manX
+                # directory
+                output_dir = os.path.join(*files[0].split("/")[:-2])
+                args = ["/usr/share/xml/xsolbook/python/xml2roff.py", "-o", output_dir]
+                args += do_files
+                print " ".join(args)
+                run_cmd(args, os.getcwd())
+
 class build_data_func(Command):
         description = "build data files whose source isn't in deliverable form"
         user_options = []
@@ -1417,6 +1485,10 @@
                 if not os.path.exists(locomf):
                     os.symlink("package-manager-C.omf", locomf)
 
+                xml2roff(man1_files + man1m_files + man5_files)
+                xml2roff(man1_ja_files + man1m_ja_files + man5_ja_files)
+                xml2roff(man1_zh_CN_files + man1m_zh_CN_files + man5_zh_CN_files)
+
 def rm_f(filepath):
         """Remove a file without caring whether it exists."""
 
@@ -1454,6 +1526,8 @@
                 rm_f("gui/help/package-manager-__LOCALE__.omf")
                 rm_f("po/i18n_errs.txt")
 
+                shutil.rmtree(MANPAGE_OUTPUT_ROOT, True)
+
 class clobber_func(Command):
         user_options = []
         description = "Deletes any and all files created by setup"