<?xml version="1.0" encoding="iso-8859-1"?>

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

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

%ent;

]>

<refentry id="pkg-1">

<refmeta><refentrytitle>pkg</refentrytitle><manvolnum>1</manvolnum>

<refmiscinfo class="date">3 Nov 2016</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">Copyright (c) 2007, 2016, 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 <replaceable>name</replaceable>]

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

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

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

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

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

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

[--no-be-activate]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<synopsis>/usr/bin/pkg verify [-Hqv] [-p <replaceable>path</replaceable>]... [--parsable <replaceable>version</replaceable>]

[--unpackaged] [--unpackaged-only] [<replaceable>pkg_fmri_pattern</replaceable> ...]</synopsis>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

</refsynopsisdiv>

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

<para><command>pkg</command> 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>(7) 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>

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

<listitem><para>Request that any network servers (such as proxies) used during

the operation ignore cached data. Use this option to troubleshoot problems that

may be caused by caching proxies between the package client and network-based

package repositories.</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>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>(7) man page.</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>(7) 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>(8) 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>(8) 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>(8) 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>(7) 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>(8) 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>(8)

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>(7) 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--</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>(7) 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. If the <option>o</option> option is not specified, the key attributes, as described in <literal>pkg</literal>(7), of the related action name will be displayed instead. In addition, 'depend' actions will also include the 'type' attribute, and 'set' actions will include the 'value' attribute.</para>

<para>When more than one action name is specified, the default attributes are

the set of all attributes, as described above, of all the specified actions. For information about actions and their attributes, see &ldquo;Actions&rdquo; in the <literal>pkg</literal>(7) 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>(7) 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/amp@0.5.11,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/amp@0.5.11,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