PREV UP NEXT The Ftape Tools Manual - Invoking Vtblc


8.2.2: Vtblc Options

-f, --file=FILE

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


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

Print help information to STDOUT.


-V, --version

Print version information to STDOUT


-d, --debug

Unused yet.


-v, --verbose

Unused yet.


-#, --vtbl-entry=NR

Specify the volume number for --print and --modify.


-p, --print[=parsable]

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 parsable 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.


-a, --append

Append an entry to the end of the volume table.


-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.

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. Only VTBL is allowed yet.


START STARTSEG

First segment of this volume.


END ENDSEG

Last segment of this volume.


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

Ignored by ftape.


FLAG_MULTI_CARTRIDGE VAL

Ignored by ftape.


FLAG_NOT_VERIFIED VAL

Ignored by ftape.


FLAG_REDIRECTION_INHIBIT VAL

Ignored by ftape.


FLAG_SEGMENT_SPANNING VAL

Ignored by ftape.


FLAG_DIRECTORY_LAST VAL

Ignored by ftape.


FLAG_RESERVED_6 VAL

Ignored by ftape.


FLAG_RESERVED_7 VAL

Ignored by ftape.


MULTI_CARTRIDGE_COUNT VAL

Ignored by ftape.


VENDOR_EXTENSION HEX

Vendor extension data. HEX is a string of hexadecimal byte values, e.g. 0x01 0x4f ... Don't touch, these fields are used by ftape.


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 4 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)