pkgtrans(1)              USER COMMANDS                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 for-
                  mats.

     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/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



                                                                1

pkgtrans(1)              USER COMMANDS                pkgtrans(1)



     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 destina-
     tion device is a datastream.

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 data stream
     format.  pkgtrans -e /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).




































                                                                2