pkgcat(1M) pkgcat(1M)
NAME
pkgcat - copy software from a server to standard output
SYNOPSIS
pkgcat [-v] [-n tcp|spx] -s source package
DESCRIPTION
The pkgcat command copies a software package from a server to
standard output. In conjunction with pkgadd(1M), pkgcat can
be used to install a package whose contents reside on another
system in the network.
Flags
-v turns on verbose output mode and causes additional
description of pkgcat 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, pkgcat 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, pkgcat exits.
If the -n option is not used, pkgcat 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, pkgcat exits.
-s source
specifies the software source for the copy. 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 pkgcat is invoked) is assumed.
Copyright 1994 Novell, Inc. Page 1
pkgcat(1M) pkgcat(1M)
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
your system.
device
Indicates the device or directory where the
package(s) reside. 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
provides the short name, as returned by the pkginfo(1)
command, of the software package to distribute. If the
path specified in the source is a device or file
containing a data stream in pkgadd format, then the
package parameter may be omitted.
This feature works the same as in pkgtrans(1), which is
the underlying mechanism used by pkgcat.
Output
pkgcat messages are written to the /var/sadm/dist/log log
file.
Exit Codes
The pkgcat 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
Copyright 1994 Novell, Inc. Page 2
pkgcat(1M) pkgcat(1M)
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.
USAGE
Examples
Copy the terminf package from the /var/spool/dist directory on
the myhost system to the /tmp/terminf.dstream file on your
local host:
pkgcat -s myhost: terminf > /tmp/terminf.dstream
Install on the local host the kdb package from a cartridge
tape image that is spooled on the myhost system
pkgcat -s myhost:/dev/rmt/ctape1 | pkgadd -d - kdb
REFERENCES
installsrv(1M), pkgcopy(1M), pkginfo(1), pkginstall(1M),
pkglist(1M), pkgtrans(1)
Copyright 1994 Novell, Inc. Page 3