pkgtrans(1)                (Essential Utilities)                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 will translate the following:

               -     a directory to a datastream,

               -     a datastream to a directory.

         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.

   NOTES
         Device specifications can be either the special node name
         (/dev/rmt/ctape) or the device alias (ctape1).  The device spool
         indicates the default spool directory.  Source and destination
         devices may not be the same.





   9/91                                                                 Page 1

   pkgtrans(1)                (Essential Utilities)                pkgtrans(1)


         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.

   EXAMPLE
         The following example translates all packages on the tape drive
         /dev/rmt/ctape and places the translations on /tmp.

         pkgtrans /dev/rmt/ctape /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 tape in a data stream format.

         pkgtrans -s /tmp /dev/rmt/ctape pkg1 pkg2

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



























   Page 2                                                                 9/91