pkgcat(1M)
pkgcat --
copy software from a server to standard output
Synopsis
pkgcat [-v] [-n tcp] -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-
Specifies TCP/IP (default).
-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
(that is,
the IP address of the Install Server).
When the host argument is omitted,
the local host (the system where pkgcat is invoked) is assumed.
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 source directory is a directory containing package(s),
then you must specify the package option.
If the source device is a package datastream,
then you do not need to specify the package option.
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
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)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004