vcdimager: Adding Files to the Video CD
2.1.3.1 Adding Files to the Video CD
....................................
Files can be added to the ISO file-system, that is the first track of
the Video CD, by making use of the command-line options
'--add-file=FILE,ISO_FILENAME' and '--add-file-2336=FILE,ISO_FILENAME'.
The latter option allows you to include files containing the complete
user data of mode 2 CD-ROM sectors (1).
The path name given as ISO_FILENAME determines where to link the file
in the file-system of the Video CD. The given path name must be a valid
ISO-9660 file name with the following restrictions:
* The Character set is restricted to upper case letters, numbers,
underscore '_', dot '.' and slash '/', ISO646 d-Characters.
* The maximum file name length is restricted to 31 characters, the
directory nesting level is restricted to 8 and the maximum path
length is limited to 255 characters.
* File names must contain exactly one dot.(2)
* ISO-9660 conformance level 1 restrictions apply, i.e. file names
are restricted to 8.3 characters.
* The path-name must not begin or end with a slash nor should it
contain slashes following directly each other.
If the parent directory for a file entry does not exist it will be
created automatically on demand.
---------- Footnotes ----------
(1) 8 bytes for sub-header, 2324 bytes payload (which contains 276
bytes ECC for form 1) and finally 4 bytes for EDC
(2) if no file name extension is supposed to exist the dot must be
placed as a trailing dot.