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