xref: /illumos-gate/usr/src/man/man8/pkgadm.8 (revision 42b53e0fbc5c05289c3d334bb864b784fafe5ce4)
te
Copyright (c) 2017 Peter Tribble.
Copyright (c) 2003, Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
PKGADM 8 "Mar 2, 2017"
NAME
pkgadm - manage packaging system
SYNOPSIS

pkgadm dbstatus [-R rootpath]

pkgadm sync [-R rootpath] [-q]

pkgadm -V

pkgadm -?
DESCRIPTION

The pkgadm utility is used for managing the packaging system. It has several subcommands that perform various operations relating to packaging. sync

Writes the contents file and rolls the contents log file. With use of the -q option, forces the contents file server to quit.

"Internal Install Database"

The Solaris operating system relies upon enhanced System V revision 4 (SVr4) packages as the basis for its software installation and revision management. The package maintenance software stores information about installed packages in an internal database. The pkgadm subcommand dbstatus is used to determine how the package internal database is implemented. The dbstatus command returns a string that indicates the type of internal database in use. In the current implementation, the dbstatus command always returns the string text, which indicates that the contents(5) package database is in use. Future releases of Solaris might supply alternative database implementations.

OPTIONS

The following options are supported: -q

(Applies to sync subcommand.) Shuts down the contents file cache daemon.

-R rootpath

Defines the full name of a directory to use as the root (/) path.

Note -

The root file system of any non-global zones must not be referenced with the -R option. Doing so might damage the global zone's file system, might compromise the security of the global zone, and might damage the non-global zone's file system. See zones(7).

-V

Print version associated with packaging tools.

-?

Print help message.

EXAMPLES

Example 1 Synchronizing the contents file

The following example forces any pending changes to the contents(5) file to be flushed and the pkgserv daemon to shut down.

example% pkgadm sync -q
EXIT STATUS
0

successful completion

non-zero

fatal error

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Evolving
SEE ALSO

pkginfo (1), pkgmk (1), pkgparam (1), pkgproto (1), pkgtrans (1), svcs (1), admin (5), contents (5), exec_attr (5), pkginfo (5), attributes (7), rbac (7), smf (7), installf (8), pkgadd (8), pkgask (8), pkgrm (8), removef (8), svcadm (8)

NOTES

The service for pkgadm is managed by the service management facility, smf(7), under the service identifier:

svc:/system/pkgserv

Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using svcadm(8). The service's status can be queried using the svcs(1) command.