pkglist(1M)


pkglist -- list available software packages on a remote host

Synopsis

pkglist [-v] [-n tcp] [-c category1[,category2[,. . .]]] [-s source] package(s)

Description

The pkglist command displays information about software available on a remote host.

Flags


-v
turns on verbose output mode and causes additional description of pkglist events to be written to the /var/sadm/dist/log log file.

-n tcp
Specifies TCP/IP (default).

-c category
displays information about packages that belong to category. (Categories are defined in the category field of the pkginfo file. See pkginfo(4) for details.) More than one category may be specified, in a comma-separated list. The package-to-category match is not case-sensitive. If the category specified is set, pkglist will display information about Set Installation Packages (SIPs).

-s source
specifies the software source for the listing. The format for the source location is either:

host:[device] or [host]:device

where:


host
is the name or Internet address (IP) of the host where the package(s) reside (that is, the IP address of the Install Server). When the host argument is omitted, the local host (the system where pkglist is invoked) is assumed.

device
Indicates the device or directory where the software resides. Alternatively, the device argument may be a file containing a data stream in pkgadd format. The full path name of the device (for example, /dev/rmt/c0s0), directory, or file must be used.

When the device argument is omitted, the /var/spool/dist directory is used.


package(s)
selects which software package(s) are listed. To specify package(s), use the short package name(s) as returned by the pkginfo(1) command. The token all may be used instead to request that all the packages available from source be listed.

Output

pkglist messages are written to the /var/sadm/dist/log log file.

Exit codes

The pkglist command exits with one of the following values:

0
Success

101
Usage error

102
Bad system call

103
No such file or directory

104
No such file or directory on server

105
No file permissions

106
Bad network connection

107
Protocol was misused

108
Invalid option specified

109
Invalid host in location specification

110
Execution was interrupted by user

111
Invalid source specification

112
Invalid target specification

113
Data stream closed by client

Diagnostics

Each session (on both the server and client side) generates a log which is appended to the system-wide logfile /var/sadm/dist/log after completion. The session log is also mailed to root.

Examples

List all the packages available for installation or distribution in the default spool directory /var/spool/dist on the myhost host system:

pkglist -s myhost: all

or

pkglist -s myhost:/var/spool/dist all

List information about the nics and terminf packages that are available for installation or distribution in the default spool directory /var/spool/dist on the myhost host system:

pkglist -s myhost: nics terminf

or

pkglist -s myhost:/var/spool/dist nics terminf

References

installsrv(1M), pkgcat(1M), pkgcopy(1M), pkginfo(1), pkginfo(4), pkginstall(1M), pkgtrans(1)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004