pkgcopy(1M) pkgcopy(1M)
NAME
pkgcopy - copy software from a server to a target host
SYNOPSIS
pkgcopy [-v] [-n tcp|spx] -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|spx
Specifies the preferred networking protocol.
If the -n option is used, pkgcopy attempts a network
connection between the target and source hosts 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, pkgcopy exits.
If the -n option is not used, pkgcopy attempts a network
connection between the target and source hosts using the
first available protocol (TCP/IP or IPX/SPX). If a
connection cannot be made using this protocol, pkgcopy
exits.
-s source
specifies the software source for the copy. The format
for the source location is either:
host[:device] or [host:]device
Copyright 1994 Novell, Inc. Page 1
pkgcopy(1M) pkgcopy(1M)
where:
host is the name or Internet address (IP) of the host
where the package(s) to be distributed reside.
When the host argument is omitted, the local host
(the system where pkgcopy 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
your system.
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 path
specified in the source is a device or file containing a
data stream in pkgadd format, then the package parameter
may be omitted. 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
Copyright 1994 Novell, Inc. Page 2
pkgcopy(1M) pkgcopy(1M)
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
Copyright 1994 Novell, Inc. Page 3
pkgcopy(1M) pkgcopy(1M)
REFERENCES
installsrv(1M), pkgcat(1M), pkginfo(1), pkginstall(1M),
pkglist(1M), pkgtrans(1)
Copyright 1994 Novell, Inc. Page 4