Provided by: dvdtape_1.6-2_amd64 bug

NAME

       dvdtape - Write a DLT tape for manufacturing a Digital Versatile Disc.

SYNOPSIS

       dvdtape --inputfile=file [options]...

DESCRIPTION

       dvdtape should be used to write directly to a Digital Linear Tape to send to a DVD factory
       for manufacturing.  It writes all of the extra data that the factory  needs  in  just  the
       format  that  is  expected.   This  includes  ANSI  tape  headers,  DDP information, DDPMS
       information, "lead in", and the DVD data itself.

       --combined-length=length
              When producing the first layer of a  two  layer  opposite  spiral  track  DVD,  the
              dvdtape  needs  to  know the combined length of both layers to record the length of
              the second layer in the leadin area of the first layer (opposite track  DVD's  only
              have  one  leadin  area for both tracks).  This parameter provides a way to specify
              that value.  If this value is not specified and is needed, it is inferred from  the
              image  contents,  based  on  the  assumption that the data being written is a "fat"
              ISO-9660 file system.

       --controlfile=file
              The file from which the DVD leadin data should be read.  The  DVD  leadin  data  is
              normally  32,768  bytes of data that contains information about the physical layout
              of the DVD-ROM, such as the number of layers, number of sides,  and  so  on.   This
              information does not appear as data sectors to programs reading the DVD-ROM, but is
              used internally by the DVD-ROM drive.  If this parameter is not specified,  dvdtape
              will  attempt  to  create  its  own  leadin  data by a possibly incorrect algorithm
              written from experiments on a proprietary program that creates leadin  data.   Note
              also  that  leadin  deliberately  omitted  for  the  second  layer of an oppositely
              oriented dvd track.

       --diameter=8cm or --diameter=12cm
              The physical diameter of the disc being made.  12 centimeters is the default.

       --inputfile=file
              The file from which the DVD contents should be read.  This file usually contains an
              ISO-9660  or  UDF  file  system.   This  parameter is mandatory.  It has no default
              value.

       --layer=0 or --layer=1
              The layer number being written.  The 4.7 gigabyte first  layer  is  layer  0.   The
              optional  3.7  gigabyte  second  layer  is  layer  1.   Note that you must create a
              separate physical tape for each layer.  (DLT tapes have enough space to  hold  both
              layers, but the standard specifies two tapes.)  The default is layer=0.

       --layers=1 or --layers=2
              The  total  number of layers that the finished disc will comprise.  The tape itself
              only contains information about one layer, but the total number of layers is stored
              in  the  header  information  on  each  tape.  The default behavior is to guess the
              number of layers by assuming that the  image  is  a  "fat"  ISO-9660  file  system,
              determining the file system size, and setting layers=1 if the image will fit on one
              layer, and layers=2 otherwise.

       --length=NNNNNNNN
              The number of bytes to write for this layer of the DVD file system.  This data will
              be  padded with nulls to make its size a multiple of 32768 (the required block size
              for the image section of the tape).  If length is not specified, the default is  to
              read  the  length,  based  on the assumption that the data is a "fat" ISO-9660 file
              system.

       --master-id=string
              Set the master ID to the specified string, which can be  up  to  48  characters  in
              length.   This  string  is  a field in the tape header information, which sometimes
              displayed on the operator's console when the disc is being made.  It is useful  for
              identifying tapes at the factor, and apparently has no other purpose.

       --offset=NNNNNNNN
              Skip  this  many bytes before starting to read the DVD image.  This is usually used
              for continuing a file system image on a second layer.  The default offset is  0  if
              layer=0 and 4699979776 (the size of layer 0) if layer=1.

       --outputfile=tape_device
              Write the output to tape_device.  You can write the output to a plain file, but the
              size of the tape blocks are 128 bytes in some sections and 32768 bytes  in  others,
              so  you  cannot  write a proper tape later by simplying copying that file to a tape
              device.  The default is /dev/st0.

       --owner=string
              Fill in the "owner" field in the tape.  This option appears to be  useful  only  if
              you want some specific information to appear before the operator who is running the
              disc manufacturing equipment.  The default is an empty string.

       --readout-speed=2 or --readout-speed=5 or --readout-speed=10
              The leadin data contains a parameter that  specifies  a  minimum  required  readout
              speed  for  the  DVD-ROM.  It can be 2.52, 5.04 or 10.08 megabits per second, which
              you can select by setting this argument to 2, 5, or 10, respectively.  The  default
              is 2.52 megabits per second.  As far as this author can tell, there does not appear
              to be a way in the leadin  format  to  specify  no  minimum  readout  speed.   This
              argument is only used when dvdtape generates its own leadin data.

       --side=0 or --side=1
              The  side  number  being  written.   The  first side is side 0.  Note that you must
              create a separate physical tape for each side.  (DLT tapes  have  enough  space  to
              hold both sides, but the standard is two tapes.)  The default value is 0.

       --sides=1 or --sides=2
              The  total  number  of sides that the finished disc will comprise.  The tape itself
              only contains information about one side, but the total number of sides  is  stored
              in the header information on each tape.  The default value is 1.

       --track-path=directionfR
              The  direction of translation of the second layer in the DVD.  This argument should
              have no effect for a single layer DVD, although it does fill in  the  corresponding
              field  in the DVD header information.  For the standard parallel layer arrangement,
              direction can be specified by the synonyms "opposite",  "out"  or  "outward".   For
              opposite  track  arrangment,  direction  can  be "parallel", "in" or "inward".  The
              default is parallel if there is only one  layer  and  opposite  if  there  are  two
              layers.  The legality of opposite orientation and only one layer is unclear.

       --usertext=string
              Fill  in  the "user text" field in the tape.  This option appears to be useful only
              if you want some specific information to appear before the operator who is  running
              the disc manufacturing equipment.  The default value is an empty string.

EXAMPLES

       dvdtape --inputfile=mydvd.iso-image
              Writes layer 0 to the tape on /dev/st0.

       dvdtape --inputfile=mydvd.iso-image --side=1
              Writes layer 1 to the tape on /dev/st0.  You only need to do this for an image that
              is too large to fit on one layer.

COPYRIGHT

       Copyright 1999, 2000 Yggdrasil Computing, Inc.  dvdtape may be copied under the terms  and
       conditions  of  version  2  of  the  GNU  General Public License, as published by the Free
       Software Foundation (Cambridge, MA, USA).

AUTHOR

       Written by Adam J. Richter (adam@yggdrasil.com)