pkgtrans(1)                    DG/UX R4.11MU05                   pkgtrans(1)


NAME
       pkgtrans - translate package format

SYNOPSIS
       pkgtrans [-ions] 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

       The options and arguments for this command are:

       -i           Copies only the pkginfo and pkgmap files.


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

       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.

       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.

EXAMPLE
       The following example translates all packages on the floppy drive
       /dev/diskette and places the translations on /tmp.

              pkgtrans /dev/diskette /tmp all

       The next 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 /dev/diskette pkg1 pkg2

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

NOTES
       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.


Licensed material--property of copyright holder(s)