pkglist(1M) pkglist(1M)
NAME
pkglist - list available software packages on a remote host
SYNOPSIS
pkglist [-v] [-n tcp|spx] [-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|spx
Specifies the preferred networking protocol.
If the -n option is used, pkglist attempts a network
connection to the source host using the requested
networking protocol (-n tcp for TCP/IP and -n spx for
IPX/SPX). If a connection cannot be made using the
requested protocol, pkglist exits.
If the -n option is not used, pkglist attempts a network
connection to the source host using the first available
protocol (TCP/IP or IPX/SPX). If a connection cannot be
made using this protocol, pkglist exits.
-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. When the host
argument is omitted, the local host (the system
where pkglist is invoked) is assumed.
If the host IP address is given then TCP/IP
networking must be used. This can be accomplished
by either including -n tcp on the command line or
by having only TCP/IP and not IPX/SPX available on
Copyright 1994 Novell, Inc. Page 1
pkglist(1M) pkglist(1M)
your system.
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
Copyright 1994 Novell, Inc. Page 2
pkglist(1M) pkglist(1M)
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.
USAGE
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),
pkginstall(1M), pkgtrans(1)
Copyright 1994 Novell, Inc. Page 3