DVDTAPE(1)

πŸ’Ώ dvdtape β€” the manual page, but make it fashion πŸ’Ώ

okay so bestie, welcome to DVDTAPE(1), from the Yggdrasil manual pages. this is the little tool that burns your DVD master onto a DLT tape so a factory can physically press your disc. it's giving ✨ manufacturing pipeline ✨ and honestly? iconic.


✨ NAME ✨

dvdtape β€” write a DLT tape for manufacturing a Digital Versatile Disc.


πŸŽ€ SYNOPSIS πŸŽ€

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

πŸ¦‹ DESCRIPTION πŸ¦‹

so like. you use dvdtape to write directly to a Digital Linear Tape that you then mail off to a DVD factory so they can manufacture your disc. it handles all the extra data the factory needs, in exactly the format they expect. no cap. and that includes:

  • ANSI tape headers
  • DDP information
  • DDPMS information
  • "lead in"
  • and the DVD data itself πŸ’…

here's every single option, no skips, no shortcuts:

  • --combined-length=length β€” when you're producing the first layer of a two-layer opposite-spiral-track DVD, dvdtape needs to know the combined length of both layers so it can record the length of the second layer in the leadin area of the first layer (opposite-track DVDs only have one leadin area for both tracks, periodt). this parameter is how you hand over that value. if you don't specify it and it's needed, it gets 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 the DVD leadin data should be read from. the DVD leadin data is normally 32,768 bytes of data containing info about the physical layout of the DVD-ROM, like the number of layers, number of sides, and so on. this info doesn't show up as data sectors to programs reading the DVD-ROM β€” it's used internally by the DVD-ROM drive. if you don't specify this parameter, dvdtape will try to create its own leadin data using a possibly incorrect algorithm written from experiments on a proprietary program that creates leadin data πŸ™ˆ. also note that leadin is 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 the DVD contents should be read from. 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. heads up bestie: you have to create a separate physical tape for each layer. (DLT tapes have enough space to hold both layers, but the standard specifies two tapes, so that's the vibe.) the default is layer=0.
  • --layers=1 or --layers=2 β€” the total number of layers 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 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 isn't 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 is sometimes displayed on the operator's console when the disc is being made. it's 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 simply 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 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 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 arrangement, 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. slay.

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. (yes it says "layer 1" while passing --side=1, that's the original wording, don't @ me πŸ’€)


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)


and that's the whole page, bestie β€” every flag, every default, every byte of leadin accounted for πŸŽ€ this was Yggdrasil DVD Tools, February 2000, DVDTAPE(1) β€” go forth and manufacture some discs, you absolute main character πŸ’…βœ¨

πŸ“¦ where this page comes from