PREV UP NEXT The Ftape Tools Manual - Invoking Vtblc


8.2.2: Vtblc Options

-#, --vtbl-entry=NR

Specify the volume number for the --modify option. Note: The option --print always displays the entire volume table regardless what has been specified with the --vtbl-entry option.


-a, --append

Append an entry to the end of the volume table.


-b, --bsm

Print the bad sector map and quit.


-d, --debug

Unused yet.


-f, --file=FILE

Tape device to use. Default is `/dev/rawft0'.


-h, -?, --help, --usage

Print help information to stdout.


-m, --modify

Modify the volume table entry given by --vtbl-entry. If --vtbl-entry has been omitted then the last entry is modified. --append and --modify understand the following sub-options:

label=LABEL

The description for this volume table entry. LABEL will be truncated to 44 bytes.


date[=DATE]

The time stamp for this entry. DATE is parsed by strptime(3) using the %T %D format (same as %H:%M:%S %m/%d/%y). If DATE is omitted the current local time is used instead.


start=SEG_ID

The starting segment for this volume table entry.


end=SEG_ID

The final segment for this volume table entry.


tagged

Read the complete volume table entry from STDIN in a tagged format. The input stream consists of pairs of keywords and values, one pair per line. The keywords are separated from the values by space characters (SPACE or TAB). Actually, with the `tagged' option given there is no difference between --append and --modify anymore.

The valid tag - value pairs are listed below.


-p[tagged], --print[=tagged]

Print the volume table entry given by --vtbl-entry or the entire table if --vtbl-entry has been omitted. If no other action is specified then --print is the default.

If the argument tagged is given, produce output in a tagged format, less readable, but easier to parse by graphical front ends. The output is in the same keyword - value format that is accepted as input by the --modify and --append options. See below.


-t, --truncate[=SIZE]

Truncate the volume table to SIZE entries by filling the remainder with zero bytes. If SIZE is omitted then the last entry is deleted.


-V, --version

Print version information to stdout


-v, --verbose

Be verbose.

vtblc interpretes the following keywords - values pairs with the --append and --modify options:

#

The `#' letter is a comment character. Lines starting with `#' are ignored. The `#' has to appear as the first character in a line, comments occupying only parts of a line are not allowed.


VTBL START
VTBL END

The entire volume table piped to vtblc has to be surrounded by a VTBL START - VTBL END pair.


ENTRY NUM

Starts the description for the volume NUM. This may be omitted if the --vtbl-entry=NUM has been given. BUG: this is wrong. vtblc always needs the ENTRY keyword.


ENTRY END

Here END is not a placeholder, but means the word `END' literally. Ends the description for the volume table entry previously started by ENTRY NUM. Everything between ENTRY NUM and ENTRY END modifies the volume number NUM. This provides means to modify multiple volume table entries in a single run by simply concatenating volume table entry specifications surrounded by ENTRY NUM - ENTRY END pairs.


SIGNATURE SIG

Valid signature string. Must be one out of VTBL, XTBL, EXVT and UTID. If this tag is used it MUST be the first entry after the ENTRY tag. If the SIGNATURE tag is missing, VTBL is assumed.

The EXVT tag is recognized, but vtblc does not make use of the volume table overflow extension.

If any other signature than VTBL was given, then the only other tag recoginized is

ENTRY_DATA HEX

Data for the volume table entry. HEX is a string of hexadecimal byte values, e.g. "0x01 0x4f ..." of length at most 124 (i.e. 128 minus length of signature). If less bytes are presented the entry will be padded with zeroes. The string must be surrounded by double quotes. The hexadecimal values have to be separated by spaces.

The following entries are allowed for the signature vtbl:


START STARTSEG

First segment of this volume.


END ENDSEG

Last segment of this volume.


NUM_SEGMENTS NUM

Number of segments occupied by this volume. This has no effect for cartridges with less or equal than 2^16=65536 segments. For larger cartridges this value is stored in the volume table entry.


DESCRIPTION DESC

Description for this volume table. Will be truncated to 44 characters.


DATE DATESTR

Date for the volume. If DATESTR is omitted, then the current local time is used. See --modify date[=DATE] for further explanations.


FLAG_VENDOR_SPECIFIC VAL

For cartridges with more than 2^16=65536 segments signals that the remainder of the volume table entry is vendor specific.

For cartridges with less segments signals that remainder of volume table entry conforms to QIC-113 if the value of QIC_MAJOR is 113. Otherwise signals that the remainder of the volume table entry is vendor specific.

If the remainder of the volume table entry has been flagged `vendor specific' (see description of FLAG_VENDOR_SPECIFIC above) then the other additional recogized tag is

VENDOR_DATA HEX

A string of hexadecimal values of lenght at most 72 to fill the remainder of the volume table entry. Smaller strings will be padded with zero bytes. The string must be surrounded by double quotes, e.g. "0x01 0x02 ...".

If FLAG_VENDOR_SPECIFIC is not set, then the following additional tags are allowed:


FLAG_MULTI_CARTRIDGE VAL
FLAG_NOT_VERIFIED VAL
FLAG_REDIRECTION_INHIBIT VAL
FLAG_SEGMENT_SPANNING VAL
FLAG_DIRECTORY_LAST VAL
FLAG_RESERVED_6 VAL
FLAG_RESERVED_7 VAL
MULTI_CARTRIDGE_COUNT VAL
QIC_MAJOR VAL

Major number of QIC spec cartridge conforms to, only for cartridges with more than 65536 segments. VAL should be 113 for all cases.


QIC_MINOR VAL

Minor revision number of QIC spec. Only for cartridges with more thatn 65536 segments. At the time of this writing, QIC-113, Rev. G, is is the latest one, so VAL should be 7.


VENDOR_EXTENSION HEX

Vendor extension data. HEX is a string of hexadecimal byte values surrounded by double quotes, e.g. "0x01 0x4f ...".


PASSWORD HEX

Password. HEX as above. Ignored by ftape.


DIRECTORY_SIZE VAL

Ignored by ftape.


DATA_SIZE VAL64

64 bit value (a decimal count).


OS_VERSION HEX

Here HEX is a hexadecimal 2 bytes value.


SOURCE_DRIVE DRVSTR

Source drive. DRVSTR is a 16 byte string. Ignored by ftape.


DEVICE HEXBYTE

A single byte in hexadecimal notation. Ignored by ftape.


RESERVED_1 HEXBYTE

Ignored by ftape.


COMPRESSION_FLAGS HEXBYTE
FORMAT HEXBYTE
RESERVED_2 HEXBYTE
RESERVED_3 HEXBYTE

Strings with spaces have to be surrounded by double quotes like this: `"word1 word2"'. VAL is some decimal number. HEXBYTE is a two digit hexadecimal value.


ftape logo Use these buttons to jump to the top menu

TOP (previous node) TOP (parent node) TOP (next node) TOP (this node)