translate package format
/usr/bin/pkgtrans [-ions] [-z blocksize]
device1 device2 [pkginst1 [pkginst2
pkgtrans translates an installable package from one format
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:
If the package's category is defined as set,
for Set Installation
Packages (SIPs) as described on
then that package's setinfo file is also copied.
Overwrites the same instance on the destination device. The
package instance will be overwritten if it already exists.
Creates a new instance of the package on the destination device.
If the package instance already exists on the destination device, it will
be left unchanged and a new instance will be created. The new instance
will have a sequence number attached to distinguish it from the
existing instance. For example, assume the destination device already contained
an instance of package X. If you use pkgtrans with the -n
option to write a new instance of package X to the device, the
existing instance of package X will remain on the destination device,
and a new instance, called X.2, would be created on the device.
If you executed pkgtrans again with the -n option, a third
instance, called X.3, would be created.
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.
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.
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.
If device1 is a regular file or directory, you must use the absolute
pathname, rather than a relative pathname.
Indicates the destination device.
Can be ``"-"'' which specifies package(s)written to standard output
in datastream format.
Translated packages will be placed on this
If device2 is a regular file or directory, you must specify it as an
absolute pathname, rather than a relative pathname.
Specifies which package
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.
Successful completion of script.
Fatal error. Installation process is terminated at this point.
Differences between versions
For SCO OpenServer Release 5.0.5a and later releases,
this command is identical to the UnixWare 7 command
of the same name.
For earlier SCO OpenServer releases,
the -z option and the ``"-"'' value
for the device1 and device2 arguments
are not supported.
language-specific message file; see LANG on
The following example translates all packages located on
drive device and places the translations on
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
You cannot run pkgtrans from csh (see
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.
Regular files and directories must be specified by their absolute pathname,
rather than a relative pathname.
By default, pkgtrans will not transfer
any instance of a package if any
instance of that package already exists on the destination device.
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.
these options are useful if the destination device is a datastream,
since the entire datastream is overwritten anyway.
When creating file system format package instances on removable media,
pkgtrans will optionally allow you to format the media and create a
file system on it. The file system type used and the file system size
will depend on the attributes defined for the device in /etc/device.tab.
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.
File system format packages containing files with names longer than 14
characters should not be created on or copied to an
s5 file system.
Since the underlying s5 file system type does not support
long file names, all file names are truncated to 14 characters.
If the resultant 14-character file name is not unique, both the
pkgadd and pkgtrans commands will fail to install
or process the contents of the file system format package correctly.
© 2007 The SCO Group, Inc. All rights reserved.
SCO OpenServer Release 6.0.0 -- 05 June 2007