vcd-info: All Options

 
 2.3 A complete list of options
 ==============================
 
 First some general-purpose options.  These you might find on other
 programs.
 
 '--help'
      This option give a list of options type '--help'.  '-?' is an
      abbreviation however you will probably have to "escape" the
      question mark so that the shell doesn't interpret this; i.e.  you
      may have to type '-\?'.
 
 '--usage'
      This option shows an abbreviated usage message
 
 '--debug DEBUG LEVEL'
 '-d DEBUG LEVEL'
      This option gives more verbose, debugging output.  The higher the
      number given, the more the output.  A value of 3 or greater
      includes library informative messages and a value of 4 or greater
      includes library debugging messages.
 
 '--terse'
 '-t'
      This option is the same as giving the combined options '--no-header
      --no-banner --no-delimiter'.  This option can be useful if this
      program is getting called for information from another program and
      you don't want to have filter this information out.
 
 '--quiet'
 '-q'
      Show only critical messages
 
 '--version'
 '-V'
      Display version and copyright information (the stuff that is
      suppressed by '--no-banner' and exit after displaying this
      information.  Sometimes, you just wanna know what version you got.
 
    Next we have some miscellaneous options that don't fall into another
 particular category.
 
 '--access-mode'
      This option probably makes sense only if you are reading from a
      CD-ROM. This overrides the default way that we read from the
      CD-ROM. The possible values allowed depend on the CD-ROM driver.
      Some values which work on some drivers are "IOCTL", "READ_10," and
      "READ_CD."
 
 '--no-banner'
 '-B'
      Do not show program banner header and CVS Id line.  This would be
      useful in a regression test program where you want to check the
      output but know that the version information is going to change
      over time.
 
 '--no-delimiter'
 '-D'
      Do not show delimiter lines around various the sections of See
      Output Sections Output Sections.
 
 '--sector-2336'
      This option only makes sense if you are reading from a BIN CD disk
      image.  This indicates to 'vcd-info' to assume a 2336-byte sector
      mode for image file.  _Note: This option is slated to disappear._
 
    Use at most one option in an invocation from the following list.
 These options are described in general in SeeOptions controlling
 where to read from Where Options.
 
 '--bin-file [FILENAME]'
 '-b [FILENAME]'
      Specifies a BIN CD-ROM disk image to read from.  See SeeReading
      from a file containing a CD disk image CD Images.
 
 '--cdrom-device [DEVICE-NAME]'
 '-C [DEVICE-NAME]'
      Specifies a CD-ROM device to read from.  See SeeReading from
      CD-ROM Device CD-ROM Device.
 
 '--cue-file [FILENAME]'
 '-c [FILENAME]'
      Specifies a CUE file to read from.  Preferred over a BIN file if
      available.  See SeeReading from a file containing a CD disk
      image CD Images.
 
 '--nrg-file [FILENAME]'
 '-N [FILENAME]'
      Specifies a Nero NRG-format CD-ROM disk image to read from.  See
      SeeReading from a file containing a CD disc image CD Images.
 
 '--input [FILE OR DEVICE NAME]'
 '-i [FILE OR DEVICE NAME]'
      This option is insensitive to whether the thing reading from is a
      CD-ROM device or a file.  See SeeReading from wherever
      Intelligent Input.
 
    The options below control how much output you get and described in
 general in SeeOutput Sections Output Sections.
 
 '--no-ext-psd'
      If the Video CD is in format VCD 2.0, there can be an optional
      "extended" PSD which contains information in the PSD and area
      highlighting and selection information.  To suppress reading and
      printing this information use this option.  The option is only
      meaningful if the VCD format is 2.0.
 
 '--show-entries-all'
 '-E'
      List everything in the Entries section.  See SeeEntries Section
      Entries.
 
 '--show-entries SUB-OPTION'
 
      Sub-options are: "count", "data", "id", "prof", or "vers".
 
      'count'
           The number of entries.  A number.  See line 5 of the example
           in SeeEntries Section Entries.
      'data'
           A complete list of the entries.  See lines 6-9.  of the
           example in SeeEntries Section Entries.
      'id'
           An 8 characters name, probably "ENTRYVCD". The name may also
           be "ENTRYSVD" but this is deprecated.  Some DVD players may
           require one or the other to play SVCDs.  See line 2 of the
           example in SeeEntries Section Entries.  The XML tag for
           this is <option name="svcd vcd30 entrysvd" value="true"/> or
           <option name="svcd vcd30 mpegav" value="true"/> or the tag can
           be left out in which case you'll get ENTRYVCD.
      'prof'
           System profile tag.  See line 4 of the example in See
           Entries Section Entries.  If the format is HQSVCD the value
           will be 1.  If the format is SVCD the value will be 0.
      'vers'
           A 2-hex digit version number.  See line 3 of the example in
           SeeEntries Section Entries.
 
 '--show-filesystem'
 '-F'
      List everything in the filesystem section.  For information about
      what is in this section, see SeeISO-9660 section Filesystem.
 
 '--show-format'
 '-f'
      Show the format that the Video CD is in.  The value will be one of
      "VCD 1.1", "VCD 2.0", "SVCD", or "HQVCD". Note that 'vcd-info' does
      not validate that the CD image conforms rigorously to any set of
      standards.  However this does suggest what it might most closely
      conform to.
 
 '--show-info-all'
      List everything in the Info section.  See SeeDisc Information
      Info.
 
 '--show-info SUBOPTION'
 '-I [SUB-OPTION]'
 
      Sub-options are: album, cc, count, id, ofm, lid2, lidn, pal, pbc,
      prof, psds, res, seg, segn, segs, spec, start, st2, vers, or vol.
 
      'album'
           A description of the album; it could be an album id.  The XML
           tag for this is <album-id>.  It is a fixed-length blank-padded
           string of 16 characters.  See line 5 of the example in See
           Disc Information Info.
      'cc'
           user data cc.  See line 14 of the example in SeeDisc
           Information Info.
      'count'
           The number of disks in the volume, an integer.  The XML tag
           for this is <volume-count>.  See line 6 of the example in
           SeeDisc Information Info.
      'id'
           A string representing the Video CD format.  "VIDEO_CD" for VCD
           1.0, VCD 1.1, or VCD 2.0, "SUPERVCD" for SVCD, XVCD, CVD, and
           "HQ-VCD" for HQVCD. A Maximum of 8 characters.  See line 2 of
           the example in SeeDisc Information Info.
      'ofm'
           offset multiplier.  Value is given is in hexadecimal.  See
           line 20 of the example in SeeDisc Information Info.
      'lid2'
           start lid #2.  A boolean value.  The XML tag for this is
           <next-volume-use-lid2>.  See line 15 of the example in See
           Info Section Info.
      'lidn'
           Maximum LID number.  See line 21 of the example in SeeInfo
           Section Info.
      'pal'
           bit set of 98 PAL(=set)/NTSC flags.  See lines 8-9 of the
           example in SeeDisc Information Info.
      'pbc'
           Show the field called "extended pbc" or "reserved2" A boolean
           value.  If the image format is SVCD or HQVCD, this will be
           labeled "reserved2" rather than "extended pbc."  Furthermore
           if the format is VCD 2.0, checks for for extended playback
           control files (EXT/LOT_X.VCD and EXT_PSD_X.VCD) will be made.
           If both files exist then VCD2.0 extended playback is probably
           used.  See line 17 of SeeDisc Information Info.
      'prof'
           System profile tag.  Used to define the set of mandatory parts
           to be applied for compatibility.  Tag, 0x00 for "SUPERVCD",
           0x01 for "HQ-VCD", 0x0_n_ for VCD_x_._n_.  A hexadecimal
           number.  See line 4 of the example in SeeDisc Information
           Info.
      'psds'
           PSD size.  See line 18 of the example in SeeDisc
           Information Info.
      'res'
           Restriction number, e.g.  "unsuitable for kids"; 0 is
           unrestricted, 1 is restricted category 1, 2 is restricted
           category 2, 3 is restricted category 3.  The XML tag for this
           is <restriction>.
      'seg'
           First segment MSF address.  See line 19 of the example in
           SeeDisc Information Info.
      'segn'
           Max segment number.  See line 22 of the example in SeeDisc
           Information Info.
      'segs'
           The name of file containing segment information.  VCD/INFO.VCD
           or SVCD/INFO.SVD. See line 1 of the example in SeeDisc
           Information Info.
      'spec'
           Special info is encoded into the pictures.  A boolean value.
           See line 13 of the example in SeeDisc Information Info.
      'start'
           start time offset.  Only relevant if SVCD or HQVCD. The XML
           tag for this is <start-time-offset>.
      'st2'
           start track #2.  A boolean value.  The XML tag for this is
           <next-volume-use-sequence2>.  See line 16 of the example in
           SeeDisc Information Info.
      'vers'
           0x01 for SVCD and VCD1._x_; 0x02 - VCD2.0.  A hexadecimal
           number.  See line 3 of the example in SeeDisc Information
           Info.
      'vol'
           The volume number.  The XML tag for this is <volume-number>.
           See line 7 of the example in SeeDisc Information Info.
 
 '--show-lot'
 '-L'
 
      List everything in the LOT section.  See SeeLID Offset Table
      (LOT) Section) Section LOT.
 
 '--show-psd'
 '-p'
 
      List everything in the PSD section.  See SeeProgram Segment
      Descriptors (PSD) Section PSD.
 
 '--show-pvd-all'
      List everything in the PVD section.  For an example of this section
      and some additional information, see the listing SeePrimary
      Volume Descriptor (PVD) Section PVD.
 
 '--show-pvd SUBOPTION'
 '-P [SUB-OPTION]'
 
      Sub-options are: app, id, iso, prep, pub, sys, vers, vol, volset,
      or xa.
 
      'app'
           The application id; a string of at most 128 characters and
           often indicates the program used to create the CD. The XML tag
           for this is <application-id>.  See line 9 of the example in
           SeePrimary Volume Descriptor (PVD) Section PVD.
      'id'
           Some sort of string ID. See line 2 of the example in See
           Primary Volume Descriptor (PVD) Section PVD.
      'iso'
           ISO size in blocks.  See line 10 of the example in See
           Primary Volume Descriptor (PVD) Section PVD.
      'prep'
           preparer id; a string of at most 128 characters.  The XML tag
           for this is <preparer-id>.  See line 7 of the example in See
           Primary Volume Descriptor (PVD) Section PVD.
      'pub'
           publisher id.  The XML tag for this is <publisher-id>.  See
           line 7 of the example in SeePrimary Volume Descriptor (PVD)
           Section PVD.
      'sys'
           The system ID; a string of at most 32 characters.  The XML tag
           for this is <system-id>.  See line 4 of the example in See
           Primary Volume Descriptor (PVD) Section PVD.
      'vers'
           The version ID. A decimal number.  See line 3 of the example
           in SeePrimary Volume Descriptor (PVD) Section PVD.
      'vol'
           The volume ID. The XML tag for this is <volume-id>.  See line
           5 of the example in SeePrimary Volume Descriptor (PVD)
           Section PVD.
      'volset'
           Volume set id.  See line 5 of the example in SeePrimary
           Volume Descriptor (PVD) Section PVD.
      'xa'
           A boolean indicating whether the XA marker is present or not.
           See line 11 of the example in SeePrimary Volume Descriptor
           (PVD) Section PVD.
 
 '--show-scandata'
      This option is relevant only if the program streams are MPEG2's.
      That is the Video CD image is not VCD 1.0, VCD 1.1 VCD 2.0.
 
 '-s'
 
 '--show-search'
 '-X'
      This option is relevant only if the program streams are MPEG2's.
      That is the VCD image is not VCD 1.0, VCD 1.1 VCD 2.0.
 
 '--show-source'
 '-S'
 
      Just list out where you are reading from and the size of the image.
 
      Here's an example of the output of this:
 
           Source: image file `/src/dvdrip/dumbo/dumbo.cue'
           Image size: 275792 sectors
 
 '--show-tracks'
 '-T'
 
      List everything in the Tracks section.  See SeeTracks Section
      Tracks.