pkgcopy(1M)


pkgcopy -- copy software from a server to a target host

Synopsis

pkgcopy [-v] [-n tcp] -s source package

Description

The pkgcopy command copies a software package from a server to the /var/spool/dist directory on the local host. Once a package is copied, that instance of the package can be installed or distributed on other hosts via the pkginstall(1M) and pkgcopy commands, respectively. This feature allows administrators to set up multiple hosts as originating hosts for software.

Another way to create a package image that can be installed or distributed to other hosts is by use of the pkgtrans(1) command.

Flags


-v
turns on verbose output mode and causes additional description of pkgcopy 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) to be distributed reside (that is, the IP address of the Install Server). When the host argument is omitted, the local host (the system where pkgcopy is invoked) is assumed.

device
Indicates the device or directory where the software that is being copied 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.

package
provides the short name, as returned by the pkginfo(1) command, of the software package to copy.

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. If the package option is omitted, you are prompted for which set(s) or package(s) you want to copy from that data stream.

This feature works the same as in pkgtrans(1), which is the underlying mechanism used by pkgcopy for copying software.

Output

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

Exit codes

The pkgcopy 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 all the packages from a cartridge tape drive on the myhost system to the /var/spool/dist directory on the local host:

pkgcopy -s myhost:/dev/rmt/ctape1

Copy the terminf package from the /var/spool/dist directory on the myhost system to the /var/spool/dist directory on the local host:

pkgcopy -s myhost:/var/spool/dist

References

installsrv(1M), pkgcat(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