User Commandspm-updatemanager(1)NAMEpm-updatemanager - application to update packages.
SYNOPSIS
/usr/bin/pm-updatemanager [options]
/usr/bin/pm-updatemanager [-hdnacR] [--help] [--debug] [--nice]
[--checkupdates-all][--checkupdates-cache] [--image-dir dir]
DESCRIPTIONpm-updatemanager is a program which you can use to check for and install available
updates for the installed packages on your system.
Note: when pm-updatemanager is run and the packages containing package/pkg,
package/pkg/packagemanger or package/pkg/updatemanager need to be updated before
doing any updates, pm-updatemanager first updates these packages and then restarts
to carry out any remaining updates.
OPTIONS
The following options are supported:
--help or -h
Displays a usage message.
--debug or -d
Run pm-updatemanger in debug mode.
--nice or -n
Run pm-updatemanger at nice level 20.
--checkupdates-all or -a
Check for updates from cache and image, writing the result to the cache
(no output to stdout).
--checkupdates-cache or -c
Check for updates from cache outputing results to stdout.
---image-dir or -R dir
Operate on the image rooted at dir, rather than the one discovered
automatically.
EXAMPLES
Example 1: Invoke pm-updatemanager on the current image. This checks for and
installs all available Updates for the current image and is how it is invoked from
the menu item under Administration-> Update Manager.
$ /usr/lib/pm-launch pm-updatemanager
Example 2: Invoke pm-updatemanager on image stored at /aux0/example_root.
$ /usr/lib/pm-launch pm-updatemanager-R /aux0/example_root
Example 3: Check for available updates in the current image and cache. This is
how it is invoked in the script /usr/lib/update-manager/update-refresh.sh which is
called by a cron job and is used to cache if updates are available.
$ /usr/lib/pm-launch /usr/bin/pm-updatemanager --nice -a -d
Example 4: Check for available updates in the current cache only. The is how
it is invoked by /usr/lib/updatemanagernotifier which is used to check for updates
and if any are available notify the user with a popup notification and icon in the
notification panel.
$ /usr/bin/pm-updatemanager --nice -c -d
EXIT STATUS
The following exit values are returned:
0 Everything worked.
1 Something bad happened.
2 Invalid command line options were specified.
FILES
None
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWipkg-um |
| Interface Stability | None / Under Development |
|_____________________________|_____________________________|
SEE ALSOpackagemanager(1), pkg(1), attributes(5), pkg(5)NOTES
The image packaging system is an under-development feature.
Command names, invocation, formats, and operations are all subject
to change. Development is hosted in the OpenSolaris community
at:
http://opensolaris.org/os/project/pkg/
When operating on an image you do not own pm-updatemanager needs to be invoked
with enough privilege. You will normally invoke pm-updatemanager using
/usr/lib/pm-launch under these circumstances.
