pkgtrans(1M)                                                   pkgtrans(1M)

NAME
     pkgtrans - translate package format

SYNOPSIS
     pkgtrans [-ionsc] device1 device2 [pkginst1 [pkginst2 [...]]]

DESCRIPTION
     pkgtrans translates installable packages 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

     If the target is a datastream, one datastream is generated from all
     translated package instances.

OPTIONS
     -i        Copies only the pkginfo and pkgmap files.

     -o        Overwrites the same instance on the destination device.

     -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 a file system format on devices that
               support both formats.

     -c        When creating a data stream, the -H odc option is used for
               an internal cpio call [see cpio(1)]. This ensures exchange
               with external systems.

     device1   Indicates the source device. The package or packages on this
               device will be translated and placed on device2.

     device2   Indicates the destination device. Translated packages will
               be placed on this device. If device2 is a filename for a
               plain file, the package is written as a datastream.

     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.






Page 1                       Reliant UNIX 5.44                Printed 11/98

pkgtrans(1M)                                                   pkgtrans(1M)

NOTES
     Device specifications can be either a special node name or a device
     alias. 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.

EXAMPLES
     The following example translates packages pkg1 and pkg2 on /tmp and
     places their translations (i.e. a datastream) on the 9track1 output
     device.

          pkgtrans /tmp 9track1 pkg1 pkg2

     The next example translates pkg1 and pkg2 on /tmp and places them on
     the diskette in a datastream format.

          pkgtrans -s /tmp diskette0 pkg1 pkg2

SEE ALSO
     cpio(1), installf(1M), pkgadd(1M), pkgask(1M), pkginfo(1M), pkgmk(1M),
     pkgparam(1M), pkgproto(1M), pkgrm(1M), removef(1M).



























Page 2                       Reliant UNIX 5.44                Printed 11/98