pkgtrans(1) pkgtrans(1)
NAME
pkgtrans - translate package format
SYNOPSIS
pkgtrans [-ions] [-z blocksize] device1 device2 [pkginst1 [pkginst2 [. . .]]]
DESCRIPTION
pkgtrans translates an installable package from one format to
another. It translates:
a file system format to a datastream
a datastream to a file system format
a file system format to another file system format
For removable file system media, pkgtrans will optionally
allow the user to format and place a file system on the media,
and write a label on the media before transferring the package
to the media.
The options and arguments for this command are:
-i Copies the pkginfo and pkgmap files. If the
package's category is defined as set, for Set
Installation Packages (SIPs) [see setinfo(4)],
then that package's setinfo file is also copied.
-o Overwrites the same instance on the destination
device, package instance will be overwritten if
it already exists.
-n Creates a new instance if any instance of this
package already exists.
-s Indicates that the package should be written to
device2 as a datastream rather than as a file
system. The default behavior is to write to
device2 in the file system format.
-z blocksize Indicates the blocksize to be used when
transferring to cartridge tape. Packages that
have been written to tape using the -z option and
a value not equal to 512 are always read using a
blocksize of 32768. Thus, the -z option is not
applicable when reading from cartridge tape.
Copyright 1994 Novell, Inc. Page 1
pkgtrans(1) pkgtrans(1)
device1 Indicates the source device. Can be "-" which
specifies package(s) in datastream format read
from standard input. The package or packages on
this device will be translated and placed on
device2.
device2 Indicates the destination device. Can be "-"
which specifies package(s)written to standard
output in datastream format. Translated packages
will be placed on this device.
pkginst Specifies which package instance or instances on
device1 should be translated. The token all may
be used to indicate all packages. pkginst.* can
be used to indicate all instances of a package.
If no packages are defined, a prompt shows all
packages on the device and asks which to
translate. If a set is being transferred to
datastream format, the pkginst arguments should
begin with the SIP and be followed by the
packages listed in the SIP's setinfo file, in the
order in which they appear in that file.
Exit Codes
0 Successful completion of script.
1 Fatal error. Installation process is terminated at this
point.
NOTICES
Device specifications can be either the special node name
(/dev/diskette) or the device alias (diskette1). The device
spool indicates the default spool directory. Source and
destination devices may not be the same.
By default, pkgtrans will not transfer any instance of a
package if any instance of that package already exists on the
destination device. Use of the -n option will create a new
instance if an instance of this package already exists. Use
of the -o option will overwrite the same instance if it
already exists. Neither of these options are useful if the
destination device is a datastream, since the entire
datastream is overwritten anyway.
Copyright 1994 Novell, Inc. Page 2
pkgtrans(1) pkgtrans(1)
pkgtrans will optionally create packages on either ufs or s5
file systems, with ufs being the default.
pkgtrans depends on the integrity of the /etc/device.tab file
to determine whether a device can support a datastream and/or
file system formats. Problems in transferring a device in a
particular format could mean corruption of /etc/device.tab.
EXAMPLES
The following example translates all packages located on drive
device and places the translations on /tmp.
pkgtrans device /tmp all
The next example translates packages pkg1 and pkg2 located on
/tmp and places their translations on diskette1 in file system
format.
pkgtrans /tmp diskette1 pkg1 pkg2
The next example translates pkg1 and pkg2 on tmp and places
them on device in a datastream format.
pkgtrans -s /tmp device pkg1 pkg2
FILES
/etc/device.tab
/usr/lib/locale/locale/LC_MESSAGES/uxpkg
language-specific message file [See LANG on environ(5).]
REFERENCES
installf(1M), pkgadd(1M), pkgask(1M), pkginfo(1), pkginfo(4),
pkgmk(1), pkgparam(1), pkgproto(1), pkgrm(1M), removef(1M)
Copyright 1994 Novell, Inc. Page 3