PKGADM(8) Maintenance Commands and Procedures PKGADM(8)

pkgadm - manage packaging system

pkgadm dbstatus [-R rootpath]

pkgadm sync [-R rootpath] [-q]

pkgadm -V

pkgadm -?

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


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

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.

The following options are supported:


(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).


Print version associated with packaging tools.


Print help message.

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


successful completion


fatal error

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

Interface Stability Evolving

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)

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


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.

March 2, 2017 OmniOS