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
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 Options controlling
where to read from Where Options.
'--bin-file [FILENAME]'
'-b [FILENAME]'
Specifies a BIN CD-ROM disk image to read from. See Reading
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 Reading 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 Reading 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
Reading 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 Reading from wherever
Intelligent Input.
The options below control how much output you get and described in
general in Output 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 Entries 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 Entries Section Entries.
'data'
A complete list of the entries. See lines 6-9. of the
example in Entries 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 Entries 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
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
Entries Section Entries.
'--show-filesystem'
'-F'
List everything in the filesystem section. For information about
what is in this section, see ISO-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 Disc 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
Disc Information Info.
'cc'
user data cc. See line 14 of the example in Disc
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
Disc 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 Disc Information Info.
'ofm'
offset multiplier. Value is given is in hexadecimal. See
line 20 of the example in Disc 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
Info Section Info.
'lidn'
Maximum LID number. See line 21 of the example in Info
Section Info.
'pal'
bit set of 98 PAL(=set)/NTSC flags. See lines 8-9 of the
example in Disc 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 Disc 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 Disc Information
Info.
'psds'
PSD size. See line 18 of the example in Disc
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
Disc Information Info.
'segn'
Max segment number. See line 22 of the example in Disc
Information Info.
'segs'
The name of file containing segment information. VCD/INFO.VCD
or SVCD/INFO.SVD. See line 1 of the example in Disc
Information Info.
'spec'
Special info is encoded into the pictures. A boolean value.
See line 13 of the example in Disc 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
Disc Information Info.
'vers'
0x01 for SVCD and VCD1._x_; 0x02 - VCD2.0. A hexadecimal
number. See line 3 of the example in Disc Information
Info.
'vol'
The volume number. The XML tag for this is <volume-number>.
See line 7 of the example in Disc Information Info.
'--show-lot'
'-L'
List everything in the LOT section. See LID Offset Table
(LOT) Section) Section LOT.
'--show-psd'
'-p'
List everything in the PSD section. See Program 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 Primary
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
Primary Volume Descriptor (PVD) Section PVD.
'id'
Some sort of string ID. See line 2 of the example in
Primary Volume Descriptor (PVD) Section PVD.
'iso'
ISO size in blocks. See line 10 of the example in
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
Primary Volume Descriptor (PVD) Section PVD.
'pub'
publisher id. The XML tag for this is <publisher-id>. See
line 7 of the example in Primary 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
Primary Volume Descriptor (PVD) Section PVD.
'vers'
The version ID. A decimal number. See line 3 of the example
in Primary Volume Descriptor (PVD) Section PVD.
'vol'
The volume ID. The XML tag for this is <volume-id>. See line
5 of the example in Primary Volume Descriptor (PVD)
Section PVD.
'volset'
Volume set id. See line 5 of the example in Primary
Volume Descriptor (PVD) Section PVD.
'xa'
A boolean indicating whether the XA marker is present or not.
See line 11 of the example in Primary 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 Tracks Section
Tracks.