DVD

开发平台：

Visual C++

FreeburnHelpText.cpp：源码内容

" -quietn"
" This makes mkisofs even less verbose. No progress out-n"
" put will be provided.n"
"n"
" -R Generate SUSP and RR records using the Rock Ridge pro-n"
" tocol to further describe the files on the iso9660n"
" filesystem.n"
"n"
" -r This is like the -R option, but file ownership andn"
" modes are set to more useful values. The uid and gidn"
" are set to zero, because they are usually only usefuln"
" on the author's system, and not useful to the client.n"
" All the file read bits are set true, so that files andn"
" directories are globally readable on the client. Ifn"
" any execute bit is set for a file, set all of the exe-n"
" cute bits, so that executables are globally executablen"
" on the client. If any search bit is set for a direc-n"
" tory, set all of the search bits, so that directoriesn"
" are globally searchable on the client. All write bitsn"
" are cleared, because the CD-Rom will be mounted read-n"
" only in any case. If any of the special mode bits aren"
" set, clear them, because file locks are not useful on an"
" read-only file system, and set-id bits are not desir-n"
" able for uid 0 or gid 0. When used on Win32, then"
" execute bit is set on all files. This is a result ofn"
" the lack of file permissions on Win32 and the Cygwinn"
" POSIX emulation layer. See also -uid -gid, -dir-mode,n"
" -file-mode and -new-dir-mode.n"
"n"
" -relaxed-filenamesn"
" The option -relaxed-filenames allows ISO9660 filenamesn"
" to include digits, uppercase characters and all other 7n"
" bit ASCII characters (resp. anything except lowercasen"
" characters).n"
" This violates the ISO9660 standard, but it happens ton"
" work on many systems. Use with caution.n"
"n"
" -sort sort filen"
" Sort file locations on the media. Sorting is controlledn"
" by a file that contains pairs of filenames and sortingn"
" offset weighting. If the weighting is higher, the filen"
" will be located closer to the beginning of the media,n"
" if the weighting is lower, the file will be locatedn"
" closer to the end of the media. There must be only onen"
" space or tabs character between the filename and then"
" weight and the weight must be the last characters on an"
" line. The filename is taken to include all the charac-n"
" ters up to, but not including the last space or tabn"
" character on a line. This is to allow for space charac-n"
" ters to be in, or at the end of a filename. Seen"
" README.sort for more details.n"
"n"
" -sysid IDn"
" Specifies the system ID. This parameter can also ben"
" set in the file .mkisofsrc with SYSI=system_id. Ifn"
" specified in both places, the command line version isn"
" used.n"
"n"
" -T Generate a file TRANS.TBL in each directory on then"
" CDROM, which can be used on non-Rock Ridge capable sys-n"
" tems to help establish the correct file names. Theren"
" is also information present in the file that indicatesn"
" the major and minor numbers for block and charactern"
" devices, and each symlink has the name of the link filen"
" given.n"
"n"
" -table-name TABLE_NAMEn"
" Alternative translation table file name (see above).n"
" Implies the -T option. If you are creating a multi-n"
" session image you must use the same name as in the pre-n"
" vious session.n"
"n"
" -ucs-level leveln"
" Set Unicode conformance level in the Joliet SVD. Then"
" default level is 3. It may be set to 1..3 using thisn"
" option.n"
"n"
" -uid uidn"
" Overrides the uid read from the source files to then"
" value of uid. Specifying this option automaticallyn"
" enables Rock Ridge extensions.n"
"n"
" -use-fileversionn"
" The option -use-fileversion allows mkisofs to use filen"
" version numbers from the filesystem. If the option isn"
" not specified, mkisofs creates a version if 1 for alln"
" files. File versions are strings in the range ;1 ton"
" ;32767 This option is the default on VMS.n"
"n"
" -U Allows "Untranslated" filenames, completely violatingn"
" the iso9660 standards described above. Forces on then"
" -d, -l, -L, -N, -relaxed-filenames, -allow-lowercase,n"
" -allow-multidot and -no-iso-translate flags. It allowsn"
" more than one '.' character in the filename, as well asn"
" mixed case filenames. This is useful on HP-UX system,n"
" where the built-in CDFS filesystem does not recognizen"
" ANY extensions. Use with extreme caution.n"
"n"
" -no-iso-translaten"
" Do not translate the characters '#' and '~' which aren"
" invalid for iso9660 filenames. These characters aren"
" though invalid often used by Microsoft systems.n"
" This violates the ISO9660 standard, but it happens ton"
" work on many systems. Use with caution.n"
"n"
" -V volidn"
" Specifies the volume ID (volume name or label) to ben"
" written into the master block. This parameter can alson"
" be set in the file .mkisofsrc with VOLI=id. If speci-n"
" fied in both places, the command line version is used.n"
" Note that if you assign a volume ID, this is the namen"
" that will be used as the mount point used by then"
" Solaris volume management system and the name that isn"
" assigned to the disc on a Microsoft Win32 or Apple Macn"
" platform.n"
"n"
" -volset IDn"
" Specifies the volset ID. This parameter can also ben"
" set in the file .mkisofsrc with VOLS=volset_id. Ifn"
" specified in both places, the command line version isn"
" used.n"
"n"
" -volset-size #n"
" Sets the volume set size to #. The volume set size isn"
" the number of CD's that are in a CD set. The -volset-n"
" size option may be used to create CD's that are part ofn"
" e.g. a Operation System installation set of CD's. Then"
" option -volset-size must be specified before -volset-n"
" seqno on each command line.n"
"n"
" -volset-seqno #n"
" Sets the volume set sequence number to #. The volumen"
" set sequence number is the index number of the currentn"
" CD in a CD set. The option -volset-size must be speci-n"
" fied before -volset-seqno on each command line.n"
"n"
" -v Verbose execution. If given twice on the command line,n"
" extra debug information will be printed.n"
"n"
" -x pathn"
" Exclude path from being written to CDROM. path must ben"
" the complete pathname that results from concatenatingn"
" the pathname given as command line argument and then"
" path relative to this directory. Multiple paths may ben"
" excluded. Example:n"
"n"
" mkisofs -o cd -x /local/dir1 -x /local/dir2 /localn"
"n"
" NOTE: The -m and -x option description should both ben"
" updated, they are wrong. Both now work identical andn"
" use filename globbing. A file is excluded if either then"
" last component matches or the whole path matches.n"
"n"
" -z Generate special SUSP records for transparentlyn"
" compressed files. This is only of use and interest forn"
" hosts that support transparent decompression. This isn"
" an experimental feature, and no hosts yet support this,n"
" but there are ALPHA patches for Linux that can make usen"
" of this feature.n"
"n"
"HFS OPTIONSn"
" -hfs Create an ISO9660/HFS hybrid CD. This option should ben"
" used in conjunction with the -map, (Reg.)and/or then"
" various double dash options given below.n"
"n"
" -applen"
" Create an ISO9660 CD with Apple's extensions. Similarn"
" to the -hfs option, except that the Apple Extensions ton"
" ISO9660 are added instead of creating an HFS hybridn"
" volume.n"
"n"
" -map mapping_filen"
" Use the mapping_file to set the CREATOR and TYPE infor-n"
" mation for a file based on the filename's extension. An"
" filename is mapped only if it is not one of the known"
" Apple/Unix file formats. See the HFS CREATOR/TYPE sec-n"
" tion below.n"
"n"
" -magic magic_filen"
" The CREATOR and TYPE information is set by using an"
" file's magic number (usually the first few bytes of an"
" file). The magic_file is only used if a file is not onen"
" of the known Apple/Unix file formats, or the filenamen"
" extension has not been mapped using the -map option.n"
" See the HFS CREATOR/TYPE section below for moren"
" details.n"
"n"
" -hfs-creator CREATORn"
" Set the default CREATOR for all files. Must be exactlyn"
" 4 characters. See the HFS CREATOR/TYPE section belown"
" for more details.n"
"n"
" -hfs-type TYPEn"
" Set the default TYPE for all files. Must be exactly 4n"
" characters. See the HFS CREATOR/TYPE section below forn"
" more details.n"
"n"
" -proben"
" Search the contents of files for all the knownn"
" Apple/Unix file formats. See the HFS MACINTOSH FILEn"
" FORMATS section below for more about these formats.n"
" However, the only way to check for MacBinary andn"
" AppleSingle files is to open and read them. Thereforen"
" this option may increase processing time. It is bettern"
" to use one or more double dash options given below ifn"
" the Apple/Unix formats in use are known.n"
"n"
" -no-desktopn"
" Do not create (empty) Desktop files. New HFS Desktopn"
" files will be created when the CD is used on a Macin-n"
" tosh (and stored in the System Folder). By default,n"
" empty Desktop files are added to the HFS volume.n"
"n"
" -mac-namen"
" Use the HFS filename as the starting point for then"
" ISO9660, Joliet and Rock Ridge file names. See the HFSn"
" MACINTOSH FILE NAMES section below for more informa-n"
" tion.n"
"n"
" -boot-hfs-file driver_filen"
" Installs the driver_file that may make the CD bootablen"
" on a Macintosh. See the HFS BOOT DRIVER section below.n"
" (Alpha).n"
"n"
" -partn"
" Generate an HFS partition table. By default, no parti-n"
" tion table is generated, but some older Macintosh CDROMn"
" drivers need an HFS partition table on the CDROM to ben"
" able to recognize a hybrid CDROM.n"
"n"
" -auto AutoStart_filen"
" Make the HFS CD use the QuickTime 2.0 Autostart featuren"
" to launch an application or document. The givenn"
" filename must be the name of a document or applicationn"
" located at the top level of the CD. The filename mustn"
" be less than 12 characters. (Alpha).n"
"n"
" -cluster-size sizen"
" Set the size in bytes of the cluster or allocationn"
" units of PC Exchange files. Implies the --exchangen"
" option. See the HFS MACINTOSH FILE FORMATS sectionn"
" below.n"
"n"
" -hide-hfs globn"
" Hide glob from the HFS volume. The file or directoryn"
" will still exist in the ISO9660 and/or Joliet direc-n"
" tory. glob is a shell wild-card-style pattern thatn"
" must match any part of the filename Multiple globs mayn"
" be excluded. Example:n"
"n"
" mkisofs -o rom -hfs -hide-hfs '*.o' -hide-hfs foobarn"
"n"
" would exclude all files ending in ".o" or calledn"
" "foobar" from the HFS volume. Note that if you had an"
" directory called "foobar" it too (and of course all itsn"
" descendants) would be excluded. The glob can also be an"
" path name relative to the source directories given onn"
" the command line. Example:n"
"n"
" mkisofs -o rom -hfs -hide-hfs src/html srcn"
"n"
" would exclude just the file or directory called "html"n"
" from the "src" directory. Any other file or directoryn"
" called "html" in the tree will not be excluded. Shouldn"
" be used with the -hide and/or -hide-joliet options. Inn"
" order to match a directory name, make sure the pathnamen"
" does not include a trailing '/' character.n"
"n"
" -hide-hfs-list filen"
" A file containing a list of globs to be hidden asn"
" above.n"
"n"
" -hfs-volid hfs_volidn"
" Volume name for the HFS partition. This is the namen"
" that is assigned to the disc on a Macintosh andn"
" replaces the volid used with the -V optionn"
"n"
" -icon-positionn"
" Use the icon position information, if it exists, fromn"
" the Apple/Unix file. The icons will appear in the samen"
" position as they would on a Macintosh desktop. Foldern"
" location and size on screen, its scroll positions,n"
" folder View (view as Icons, Small Icons, etc.) are alson"
" preserved. This option may become set by default inn"
" the future. (Alpha).n"
"n"
" -root-info filen"
" Set the location, size on screen, scroll positions,n"
" folder View etc. for the root folder of an HFS volume.n"
" See README.rootinfo for more information. (Alpha)n"
"n"
" -prep-boot FILEn"
" PReP boot image file. Up to 4 are allowed. Seen"
" README.prep_boot (Alpha)n"
"n"
" -input-hfs-charset charsetn"
" Input charset that defines the characters used in HFSn"
" file names when used with the -mac-name option. Then"
" default charset is cp10000 (Mac Roman) cp10000 (Macn"
" Roman) See CHARACTER SETS and HFS MACINTOSH FILE NAMESn"
" sections below for more details.n"
"n"
" -output-hfs-charset charsetn"
" Output charset that defines the characters that will ben"
" used in the HFS file names. Defaults to the input char-n"
" set. See CHARACTER SETS section below for more details.n"
"n"
" -hfs-unlockn"
" By default, mkisofs will create an HFS volume that isn"
" locked. This option leaves the volume unlocked so thatn"
" other applications (e.g. hfsutils) can modify then"
" volume. See the HFS PROBLEMS/LIMITATIONS section belown"
" for warnings about using this option.n"
"n"
" -hfs-bless folder_namen"
" "Bless" the given directory (folder). This is usuallyn"
" the System Folder and is used in creating HFS bootablen"
" CDs. The name of the directory must be the whole pathn"
" name as mkisofs sees it. e.g. if the given pathspec isn"
" ./cddata and the required folder is called Systemn"
" Folder, then the whole path name is "./cddata/Systemn"
" Folder" (remember to use quotes if the name containsn"
" spaces).n"
"n"
" --capn"
" Look for AUFS CAP Macintosh files. Search for CAPn"
" Apple/Unix file formats only. Searching for the othern"
" possible Apple/Unix file formats is disabled, unlessn"
" other double dash options are given.n"
"n"
" --netatalkn"
" Look for NETATALK Macintosh filesn"
"n"
" --doublen"
" Look for AppleDouble Macintosh filesn"
"n"
" --ethersharen"
" Look for Helios EtherShare Macintosh filesn"
"n"
" --usharen"
" Look for IPT UShare Macintosh filesn"
"n"
" --exchangen"
" Look for PC Exchange Macintosh filesn"
"n"
" --sgin"
" Look for SGI Macintosh filesn"
"n"
" --xinetn"
" Look for XINET Macintosh filesn"
"n"
" --macbinn"
" Look for MacBinary Macintosh filesn"
"n"
" --singlen"
" Look for AppleSingle Macintosh filesn"
"n"
" --daven"
" Look for Thursby Software Systems DAVE Macintosh filesn"
"n"
" --sfmn"
" Look for Microsoft's Services for Macintosh files (NTn"
" only) (Alpha)n"
"n"
"CHARACTER SETSn"
" mkisofs processes file names in a POSIX compliant way asn"
" strings of 8-bit characters. To represent all codings forn"
" all languages, 8-bit characters are not sufficient. Unicoden"
" or ISO-10646 define character codings that need at least 21n"
" bits to represent all known languages. They may ben"
" represented with UTF-32, UTF-16 or UTF-8 coding. UTF-32n"
" uses a plain 32-bit coding but seems to be uncommon. UTF-16n"
" is used by Microsoft with Win32 with the disadvantage thatn"
" it only supports a subset of all codes and that 16-bit char-n"
" acters are not compliant with the POSIX filesystem inter-n"
" face.n"
"n"
" Modern UNIX operating systems use UTF-8 coding forn"
" filenames. This coding allows to use the complete Unicoden"
" code set. Each 32-bit character is represented by one orn"
" more 8-bit characters. If a character is coded in ISO-n"
" 8859-1 (used in Central Europe and North America) is mapsn"
" 1:1 to a Unicode character. Character codes that cannot ben"
" represented as a single byte in UTF-8 (typically if then"
" value is > 0x7F) use escape sequences that map to more thann"
" one 8-bit character.n"
"n"
" If all operating systems would use UTF-8 coding, mkisofsn"
" would not need to recode characters in file names. Unfor-n"
" tunately, Apple uses completely nonstandard codings andn"
" Microsoft uses a Unicode coding that is not compatible withn"
" the POSIX filename interface.n"
"n"
" For all non UTF-8 coded operating systems, the actual char-n"
" acter that each byte represents depends on the character setn"
" or codepage (which is the name used by Microsoft) used byn"
" the local operating system in use - the characters in an"
" character set will reflect the region or natural languagen"
" used by the user.n"
"n"
" Usually character codes 0x00-0x1f are control characters,n"
" codes 0x20-0x7f are the 7 bit ASCII characters and (on PC'sn"
" and Mac's) 0x80-0xff are used for other characters. Unfor-n"
" tunately even this does not follow ISO standards thatn"
" reserve the range 0x80-0x9f for control characters and onlyn"
" allow 0xa0-0xff for other characters.n"
"n"
" As there is a lot more than 256 characters/symbols in use,n"
" only a small subset are represented in a character set.n"
" Therefore the same character code may represent a differentn"
" character in different character sets. So a file name gen-n"
" erated, say in central Europe, may not display the samen"
" character when viewed on a machine in, say eastern Europe.n"
"n"
" To make matters more complicated, different operating sys-n"
" tems use different character sets for the region orn"
" language. For example the character code for "small e withn"
" acute accent" may be character code 0x82 on a PC, code 0x8en"
" on a Macintosh and code 0xe9 on a UNIX system. Note whilen"
" the codings used on a PC or Mac are nonstandard, Unicoden"
" codes this character as 0x00000000e9 which is basically then"
" same value as the value used by most UNIX systems.n"
"n"
" As long as not all operating systems and applications willn"
" use the Unicode character set as the basis for file names inn"
" a unique way, it may be necessary to specify which charactern"
" set your file names use in and which character set the filen"
" names should appear on the CD.n"
"n"
" There are four options to specify the character sets youn"
" want to use:n"
"n"
" -input-charsetn"
" Defines the local character set you are using on yourn"
" host machine. Any character set conversions that taken"
" place will use this character set as the staring point.n"
" The default input character sets are cp437 on DOS basedn"
" systems and iso8859-1 on all other systems.n"
"n"
" If the -J option is given, then the Unicode equivalentsn"
" of the input character set will be used in the Jolietn"
" directory. Using the -jcharset option is the same asn"
" using the -input-charset and -J options.n"
"n"
" -output-charsetn"
" Defines the character set that will be used with forn"
" the Rock Ridge names on the CD. Defaults to the inputn"
" character set. Only likely to be useful if used on an"
" non-Unix platform. e.g. using mkisofs on a Microsoftn"
" Win32 machine to create Rock Ridge CDs. If you aren"
" using mkisofs on a Unix machine, it is likely that then"
" output character set will be the same as the inputn"
" character set.n"
"n"
" -input-hfs-charsetn"
" Defines the HFS character set used for HFS file namesn"
" decoded from any of the various Apple/Unix file for-n"
" mats. Only useful when used with -mac-name option. Seen"
" the HFS MACINTOSH FILE NAMES for more information.n"
" Defaults to cp10000 (Mac Roman).n"
"n"
" -output-hfs-charsetn"
" Defines the HFS character set used to create HFS filen"
" names from the input character set in use. In mostn"
" cases this will be from the character set given withn"
" the -input-charset option. Defaults to the input HFSn"
" character set.n"
"n"
" There are a number of character sets built in to mkisofs.n"
" To get a listing, use mkisofs -input-charset help.n"
"n"
" Additional character sets can be read from file for any ofn"
" the character set options by giving a filename as the argu-n"
" ment to the options. The given file will only be read if itsn"
" name does not match one of the built in character sets.n"
"n"
" The format of the character set files is the same as then"
" mapping files available fromn"
" http://www.unicode.org/Public/MAPPINGS The format of thesen"
" files is:n"
"n"
" Column #1 is the input byte code (in hex as 0xXX)n"
" Column #2 is the Unicode (in hex as 0xXXXX)n"
" Rest of the line is ignored.n"
"n"
" Any blank line, line without two (or more) columns in then"
" above format or comments lines (starting with the # charac-n"
" ter) are ignored without any warnings. Any missing inputn"
" code is mapped to Unicode character 0x0000.n"
"n"
" Note that there is no support for 16 bit UNICODE (UTF-16) orn"
" 32 bit UNICODE (UTF-32) coding because this coding is notn"
" POSIX compliant. There should be support for UTF-8 UNICODEn"
" coding which is compatible to POSIX filenames and supportedn"
" by moder UNIX implementations such as Solaris.n"
"n"
" A 1:1 character set mapping can be defined by using the key-n"
" word default as the argument to any of the character setn"
" options. This is the behaviour of older (v1.12) versions ofn"
" mkisofs.n"
"n"
" The ISO9660 file names generated from the input filenamesn"
" are not converted from the input character set. The ISO9660n"
" character set is a very limited subset of the ASCII charac-n"
" ters, so any conversion would be pointless.n"
"n"
" Any character that mkisofs can not convert will be replacedn"
" with a '_' character.n"
"n"
"HFS CREATOR/TYPEn"
" A Macintosh file has two properties associated with it whichn"
" define which application created the file, the CREATOR andn"
" what data the file contains, the TYPE. Both are (exactly) 4n"
" letter strings. Usually this allows a Macintosh user ton"
" double-click on a file and launch the correct applicationn"
" etc. The CREATOR and TYPE of a particular file can be foundn"
" by using something like ResEdit (or similar) on a Macintosh.n"
"n"
" The CREATOR and TYPE information is stored in all the vari-n"
" ous Apple/Unix encoded files. For other files it is possi-n"
" ble to base the CREATOR and TYPE on the filename's extensionn"
" using a mapping file (the -map option) and/or using then"
" magic number (usually a signature in the first few bytes) ofn"
" a file (the -magic option). If both these options are given,n"
" then their order on the command line is important. If then"
" -map option is given first, then a filename extension matchn"
" is attempted before a magic number match. However, if then"
" -magic option is given first, then a magic number match isn"
" attempted before a filename extension match.n"
"n"
" If a mapping or magic file is not used, or no match is foundn"
" then the default CREATOR and TYPE for all regular files cann"
" be set by using entries in the .mkisofsrc file or using then"
" -hfs-creator and/or -hfs-type options, otherwise the defaultn"
" CREATOR and TYPE are 'unix' and 'TEXT'.n"
"n"
" The format of the mapping file is the same afpfile format asn"
" used by aufs. This file has five columns for the extension,n"
" file translation, CREATOR, TYPE and Comment. Lines startingn"
" with the '#' character are comment lines and are ignored. Ann"
" example file would be like:n"
"n"
" # Example filename mapping filen"
" #n"
" # EXTN XLate CREATOR TYPE Commentn"
" .tif Raw '8BIM' 'TIFF' "Photoshop TIFF image"n"
" .hqx Ascii 'BnHq' 'TEXT' "BinHex file"n"
" .doc Raw 'MSWD' 'WDBN' "Word file"n"
" .mov Raw 'TVOD' 'MooV' "QuickTime Movie"n"
" * Ascii 'ttxt' 'TEXT' "Text file"n"
"n"
" Where:n"
"n"
" The first column EXTN defines the Unix filename exten-n"
" sion to be mapped. The default mapping for any filenamen"
" extension that doesn't match is defined with the "*"n"
" character.n"
"n"
" The Xlate column defines the type of text translationn"
" between the Unix and Macintosh file it is ignored byn"
" mkisofs, but is kept to be compatible with aufs(1).n"
" Although mkisofs does not alter the contents of a file,n"
" if a binary file has it's TYPE set as 'TEXT', it may ben"
" read incorrectly on a Macintosh. Therefore a bettern"
" choice for the default TYPE may be '????'n"
"n"
" The CREATOR and TYPE keywords must be 4 characters longn"
" and enclosed in single quotes.n"
"n"
" The comment field is enclosed in double quotes - it isn"
" ignored by mkisofs, but is kept to be compatible withn"
" aufs.n"
"n"
" The format of the magic file is almost identical to then"
" magic(4) file used by the Linux file(1) command - the rou-n"
" tines for reading and decoding the magic file are based onn"
" the Linux file(1) command.n"
"n"
" This file has four tab separated columns for the byten"
" offset, type, test and message. Lines starting with the '#'n"
" character are comment lines and are ignored. An example filen"
" would be like:n"
"n"
" # Example magic filen"
" #n"
" # off type test messagen"
" 0 string GIF8 8BIM GIFf GIF imagen"
" 0 beshort 0xffd8 8BIM JPEG image datan"
" 0 string SIT! SIT! SIT! StuffIt Archiven"
" 0 string 37235 LZIV ZIVU standard unix compressn"
" 0 string 37213 GNUz ZIVU gzip compressed datan"
" 0 string %! ASPS TEXT Postscriptn"
" 0 string 04%! ASPS TEXT PC Postscript with a ^D to startn"
" 4 string moov txtt MooV QuickTime movie file (moov)n"
" 4 string mdat txtt MooV QuickTime movie file (mdat)n"
"n"
" The format of the file is described in the magic(4) mann"
" page. The only difference here is that for each entry in then"
" magic file, the message for the initial offset must be 4n"
" characters for the CREATOR followed by 4 characters for then"
" TYPE - white space is optional between them. Any other char-n"
" acters on this line are ignored. Continuation lines (start-n"
" ing with a '>') are also ignored i.e. only the initialn"
" offset lines are used.n"
"n"
" Using the -magic option may significantly increase process-n"
" ing time as each file has to opened and read to find it'sn"
" magic number.n"
"n"
" In summary, for all files, the default CREATOR is 'unix' andn"
" the default TYPE is 'TEXT'. These can be changed by usingn"
" entries in the .mkisofsrc file or by using the -hfs-creatorn"
" and/or -hfs-type options.n"
"n"
" If the a file is in one of the known Apple/Unix formats (andn"
" the format has been selected), then the CREATOR and TYPE aren"
" taken from the values stored in the Apple/Unix file.n"
"n"
" Other files can have their CREATOR and TYPE set from theirn"
" file name extension (the -map option), or their magic numbern"
" (the -magic option). If the default match is used in then"
" mapping file, then these values override the default CREATORn"
" and TYPE.n"
"n"
" A full CREATOR/TYPE database can be found atn"
" http://www.angelfire.com/il/szekely/index.htmln"
"n"
"HFS MACINTOSH FILE FORMATSn"
" Macintosh files have two parts called the Data and Resourcen"
" fork. Either may be empty. Unix (and many other OSs) cann"
" only cope with files having one part (or fork). To add ton"
" this, Macintosh files have a number of attributes associatedn"
" with them - probably the most important are the TYPE andn"
" CREATOR. Again Unix has no concept of these types of attri-n"
" butes.n"
"n"
" e.g. a Macintosh file may be a JPEG image where the image isn"
" stored in the Data fork and a desktop thumbnail stored inn"
" the Resource fork. It is usually the information in the datan"
" fork that is useful across platforms.n"
"n"
" Therefore to store a Macintosh file on a Unix filesystem, an"
" way has to be found to cope with the two forks and the extran"
" attributes (which are referred to as the finder info).n"
" Unfortunately, it seems that every software package thatn"
" stores Macintosh files on Unix has chosen a completely dif-n"
" ferent storage method.n"
"n"
"n"
" The Apple/Unix formats that mkisofs (partially) supportsn"
" are:n"
"n"
" CAP AUFS formatn"
" Data fork stored in a file. Resource fork in subdirec-n"
" tory .resource with same filename as data fork. Findern"
" info in .finderinfo subdirectory with same filename.n"
"n"
" AppleDouble/Netatalkn"
" Data fork stored in a file. Resource fork stored in an"
" file with same name prefixed with "%". Finder info alson"
" stored in same "%" file. Netatalk uses the same format,n"
" but the resource fork/finderinfo stored in subdirectoryn"
" .AppleDouble with same name as data fork.n"
"n"
" AppleSinglen"
" Data structures similar to above, except both forks andn"
" finder info are stored in one file.n"
"n"
" Helios EtherSharen"
" Data fork stored in a file. Resource fork and findern";
const char fbHelpMkisofsText2[] =
" info together in subdirectory .rsrc with same filenamen"
" as data fork.n"
"n"
" IPT USharen"
" Very similar to the EtherShare format, but the findern"
" info is stored slightly differently.n"
"n"
" MacBinaryn"
" Both forks and finder info stored in one file.n"
"n"
" Apple PC Exchangen"
" Used by Macintoshes to store Apple files on DOS (FAT)n"
" disks. Data fork stored in a file. Resource fork inn"
" subdirectory resource.frk (or RESOURCE.FRK). Findern"
" info as one record in file finder.dat (or FINDER.DAT).n"
" Separate finder.dat for each data fork directory.n"
"n"
" Note: mkisofs needs to know the native FAT cluster sizen"
" of the disk that the PC Exchange files are on (or haven"
" been copied from). This size is given by the -cluster-n"
" size option. The cluster or allocation size can ben"
" found by using the DOS utility CHKDSK.n"
"n"
" May not work with PC Exchange v2.2 or higher filesn"
" (available with MacOS 8.1). DOS media containing PCn"
" Exchange files should be mounted as type msdos (notn"
" vfat) when using Linux.n"
"n"
" SGI/XINETn"
" Used by SGI machines when they mount HFS disks. Datan"
" fork stored in a file. Resource fork in subdirectoryn"
" .HSResource with same name. Finder info as one recordn"
" in file .HSancillary. Separate .HSancillary for eachn"
" data fork directory.n"
"n"
" Thursby Software Systems DAVEn"
" Allows Macintoshes to store Apple files on SMB servers.n"
" Data fork stored in a file. Resource fork in subdirec-n"
" tory resource.frk. Uses the AppleDouble format to storen"
" resource fork.n"
"n"
" Services for Macintoshn"
" Format of files stored by NT Servers on NTFS filesys-n"
" tems. Data fork is stored as "filename". Resource forkn"
" stored as a NTFS stream called "filename:AFP_Resource".n"
" The finder info is stored as a NTFS stream calledn"
" "filename:Afp_AfpInfo". These streams are normallyn"
" invisible to the user.n"
"n"
" Warning: mkisofs only partially supports the SFM for-n"
" mat. If an HFS file or folder stored on the NT servern"
" contains an illegal NT character in its name, then NTn"
" converts these characters to Private Use Unicode char-n"
" acters. The characters are: " * / < > ? | also a spacen"
" or period if it is the last character of the file name,n"
" character codes 0x01 to 0x1f (control characters) andn"
" Apple' apple logo.n"
"n"
" Unfortunately, these private Unicode characters are notn"
" readable by the mkisofs NT executable. Therefore anyn"
" file or directory name containing these characters willn"
" be ignored - including the contents of any such direc-n"
" tory.n"
"n"
" mkisofs will attempt to set the CREATOR, TYPE, date and pos-n"
" sibly other flags from the finder info. Additionally, if itn"
" exists, the Macintosh filename is set from the finder info,n"
" otherwise the Macintosh name is based on the Unix filename -n"
" see the HFS MACINTOSH FILE NAMES section below.n"
"n"
" When using the -apple option, the TYPE and CREATOR aren"
" stored in the optional System Use or SUSP field in then"
" ISO9660 Directory Record - in much the same way as the Rockn"
" Ridge attributes are. In fact to make life easy, the Applen"
" extensions are added at the beginning of the existing Rockn"
" Ridge attributes (i.e. to get the Apple extensions you getn"
" the Rock Ridge extensions as well).n"
"n"
" The Apple extensions require the resource fork to be storedn"
" as an ISO9660 associated file. This is just like any normaln"
" file stored in the ISO9660 filesystem except that the asso-n"
" ciated file flag is set in the Directory Record (bit 2).n"
" This file has the same name as the data fork (the file seenn"
" by non-Apple machines). Associated files are normallyn"
" ignored by other OSsn"
"n"
" When using the -hfs option, the TYPE and CREATOR plus othern"
" finder info, are stored in a separate HFS directory, notn"
" visible on the ISO9660 volume. The HFS directory referencesn"
" the same data and resource fork files described above.n"
"n"
" In most cases, it is better to use the -hfs option insteadn"
" of the -apple option, as the latter imposes the limitedn"
" ISO9660 characters allowed in filenames. However, the Applen"
" extensions do give the advantage that the files are packedn"
" on the disk more efficiently and it may be possible to fitn"
" more files on a CD - important when the total size of then"
" source files is approaching 650MB.n"
"n"
"HFS MACINTOSH FILE NAMESn"
" Where possible, the HFS filename that is stored with ann"
" Apple/Unix file is used for the HFS part of the CD. However,n"
" not all the Apple/Unix encodings store the HFS filename withn"
" the finderinfo. In these cases, the Unix filename is used -n"
" with escaped special characters. Special characters includen"
" '/' and characters with codes over 127.n"
"n"
" Aufs escapes these characters by using ":" followed by then"
" character code as two hex digits. Netatalk and EtherSharen"
" have a similar scheme, but uses "%" instead of a ":".n"
"n"
" If mkisofs can't find an HFS filename, then it uses the Unixn"
" name, with any %xx or :xx characters (xx == two hex digits)n"
" converted to a single character code. If "xx" are not hexn"
" digits ([0-9a-fA-F]), then they are left alone - althoughn"
" any remaining ":" is converted to "%" as colon is the HFSn"
" directory separator. Care must be taken, as an ordinary Unixn"
" file with %xx or :xx will also be converted. e.g.n"
"n"
" This:2fFile converted to This/Filen"
"n"
" This:File converted to This%Filen"
"n"
" This:t7File converted to This%t7Filen"
"n"
" Although HFS filenames appear to support upper and lowern"
" case letters, the filesystem is case insensitive. i.e. then"
" filenames "aBc" and "AbC" are the same. If a file is foundn"
" in a directory with the same HFS name, then mkisofs willn"
" attempt, where possible, to make a unique name by adding '_'n"
" characters to one of the filenames.n"
"n"
" If an HFS filename exists for a file, then mkisofs can usen"
" this name as the starting point for the ISO9660, Joliet andn"
" Rock Ridge filenames using the -mac-name option. Normal Unixn"
" files without an HFS name will still use their Unix name.n"
" e.g.n"
"n"
" If a MacBinary (or PC Exchange) file is stored asn"
" someimage.gif.bin on the Unix filesystem, but contains a HFSn"
" file called someimage.gif, then this is the name that wouldn"
" appear on the HFS part of the CD. However, as mkisofs usesn"
" the Unix name as the starting point for the other names,n"
" then the ISO9660 name generated will probably ben"
" SOMEIMAG.BIN and the Joliet/Rock Ridge would ben"
" someimage.gif.bin. Although the actual data (in this case)n"
" is a GIF image. This option will use the HFS filename as then"
" starting point and the ISO9660 name will probably ben"
" SOMEIMAG.GIF and the Joliet/Rock Ridge would ben"
" someimage.gif.n"
"n"
" Using the -mac-name option will not currently work with then"
" -T option - the Unix name will be used in the TRANS.TBLn"
" file, not the Macintosh name.n"
"n"
" The character set used to convert any HFS file name to an"
" Joliet/Rock Ridge file name defaults to cp10000 (Mac Roman).n"
" The character set used can be specified using the -input-n"
" hfs-charset option. Other built in HFS character sets are:n"
" cp10006 (MacGreek), cp10007 (MacCyrillic), cp10029 (MacLa-n"
" tin2), cp10079 (MacIcelandandic) and cp10081 (MacTurkish).n"
"n"
" Note: the character codes used by HFS file names taken fromn"
" the various Apple/Unix formats will not be converted as theyn"
" are assumed to be in the correct Apple character set. Onlyn"
" the Joliet/Rock Ridge names derived from the HFS file namesn"
" will be converted.n"
"n"
" The existing mkisofs code will filter out any illegal char-n"
" acters for the ISO9660 and Joliet filenames, but as mkisofsn"
" expects to be dealing directly with Unix names, it leavesn"
" the Rock Ridge names as is. But as '/' is a legal HFSn"
" filename character, the -mac-name option converts '/' to an"
" '_' in Rock Ridge filenames.n"
"n"
" If the Apple extensions are used, then only the ISO9660n"
" filenames will appear on the Macintosh. However, as then"
" Macintosh ISO9660 drivers can use Level 2 filenames, thenn"
" you can use options like -allow-multidot without problems onn"
" a Macintosh - still take care over the names, for examplen"
" this.file.name will be converted to THIS.FILE i.e. only haven"
" one '.', also filename abcdefgh will be seen as ABCDEFGH butn"
" abcdefghi will be seen as ABCDEFGHI. i.e. with a '.' at then"
" end - don't know if this is a Macintosh problem orn"
" mkisofs/mkhybrid problem. All filenames will be in uppercasen"
" when viewed on a Macintosh. Of course, DOS/Win3.X machinesn"
" will not be able to see Level 2 filenames...n"
"n"
"HFS CUSTOM VOLUME/FOLDER ICONSn"
" To give a HFS CD a custom icon, make sure the root (topn"
" level) folder includes a standard Macintosh volume iconn"
" file. To give a volume a custom icon on a Macintosh, an iconn"
" has to be pasted over the volume's icon in the "Get Info"n"
" box of the volume. This creates an invisible file calledn"
" 'Iconr' ('r' is the 'carriage return' character) in then"
" root folder.n"
"n"
" A custom folder icon is very similar - an invisible filen"
" called 'Iconr' exits in the folder itself.n"
"n"
" Probably the easiest way to create a custom icon thatn"
" mkisofs can use, is to format a blank HFS floppy disk on an"
" Mac, paste an icon to its "Get Info" box. If using Linuxn"
" with the HFS module installed, mount the floppy using some-n"
" thing like:n"
"n"
" mount -t hfs /dev/fd0 /mnt/floppyn"
"n"
" The floppy will be mounted as a CAP file system by default.n"
" Then run mkisofs using something like:n"
"n"
" mkisofs --cap -o output source_dir /mnt/floppyn"
"n"
" If you are not using Linux, then you can use the hfsutils ton"
" copy the icon file from the floppy. However, care has to ben"
" taken, as the icon file contains a control character. e.g.n"
"n"
" hmount /dev/fd0n"
" hdir -an"
" hcopy -m Icon^V^M icon_dir/iconn"
"n"
" Where '^V^M' is control-V followed by control-M. Then runn"
" mkisofs by using something like:n"
"n"
" mkisofs --macbin -o output source_dir icon_dirn"
"n"
" The procedure for creating/using custom folder icons is veryn"
" similar - paste an icon to folder's "Get Info" box andn"
" transfer the resulting 'Iconr' file to the relevant direc-n"
" tory in the mkisofs source tree.n"
"n"
" You may want to hide the icon files from the ISO9660 andn"
" Joliet trees.n"
"n"
" To give a custom icon to a Joliet CD, follow the instruc-n"
" tions found at:n"
" http://www.fadden.com/cdrfaq/faq03.html#[3-21]n"
"n"
"HFS BOOT DRIVERn"
" It may be possible to make the hybrid CD bootable on an"
" Macintosh.n"
"n"
" A bootable HFS CD requires an Apple CD-ROM (or compatible)n"
" driver, a bootable HFS partition and the necessary System,n"
" Finder, etc. files.n"
"n"
" A driver can be obtained from any other Macintosh bootablen"
" CD-ROM using the apple_driver utility. This file can then ben"
" used with the -boot-hfs-file option.n"
"n"
" The HFS partition (i.e. the hybrid disk in our case) mustn"
" contain a suitable System Folder, again from another CD-ROMn"
" or disk.n"
"n"
" For a partition to be bootable, it must have it's boot blockn"
" set. The boot block is in the first two blocks of a parti-n"
" tion. For a non-bootable partition the boot block is full ofn"
" zeros. Normally, when a System file is copied to partitionn"
" on a Macintosh disk, the boot block is filled with a numbern"
" of required settings - unfortunately I don't know the fulln"
" spec for the boot block, so I'm guessing that the followingn"
" will work OK.n"
"n"
" Therefore, the utility apple_driver also extracts the bootn"
" block from the first HFS partition it finds on the givenn"
" CD-ROM and this is used for the HFS partition created byn"
" mkisofs.n"
"n"
" PLEASE NOTEn"
" By using a driver from an Apple CD and copying Applen"
" software to your CD, you become liable to obey Applen"
" Computer, Inc. Software License Agreements.n"
"n"
"EL TORITO BOOT INFORMATION TABLEn"
" When the -boot-info-table option is given, mkisofs willn"
" modify the boot file specified by the -b option by insertingn"
" a 56-byte "boot information table" at offset 8 in the file.n"
" This modification is done in the source filesystem, so maken"
" sure you use a copy if this file is not easily recreated!n"
" This file contains pointers which may not be easily or reli-n"
" ably obtained at boot time.n"
"n"
" The format of this table is as follows; all integers are inn"
" section 7.3.1 ("little endian") format.n"
"n"
" Offset Name Size Meaningn"
" 8 bi_pvd 4 bytes LBA of primary volume descriptorn"
" 12 bi_file 4 bytes LBA of boot filen"
" 16 bi_length 4 bytes Boot file length in bytesn"
" 20 bi_csum 4 bytes 32-bit checksumn"
" 24 bi_reserved 40 bytes Reservedn"
"n"
" The 32-bit checksum is the sum of all the 32-bit words inn"
" the boot file starting at byte offset 64. All linear blockn"
" addresses (LBAs) are given in CD sectors (normally 2048n"
" bytes).n"
"n"
"CONFIGURATIONn"
" mkisofs looks for the .mkisofsrc file, first in the currentn"
" working directory, then in the user's home directory, andn"
" then in the directory in which the mkisofs binary is stored.n"
" This file is assumed to contain a series of lines of then"
" form TAG=value, and in this way you can specify certainn"
" options. The case of the tag is not significant. Somen"
" fields in the volume header are not settable on the commandn"
" line, but can be altered through this facility. Commentsn"
" may be placed in this file, using lines which start with an"
" hash (#) character.n"
"n"
" APPI The application identifier should describe the applica-n"
" tion that will be on the disc. There is space on then"
" disc for 128 characters of information. May be over-n"
" ridden using the -A command line option.n"
"n"
" COPY The copyright information, often the name of a file onn"
" the disc containing the copyright notice. There isn"
" space in the disc for 37 characters of information.n"
" May be overridden using the -copyright command linen"
" option.n"
"n"
" ABST The abstract information, often the name of a file onn"
" the disc containing an abstract. There is space in then"
" disc for 37 characters of information. May be overrid-n"
" den using the -abstract command line option.n"
"n"
" BIBL The bibliographic information, often the name of a filen"
" on the disc containing a bibliography. There is spacen"
" in the disc for 37 characters of information. May ben"
" overridden using the -bilio command line option.n"
"n"
" PREP This should describe the preparer of the CDROM, usuallyn"
" with a mailing address and phone number. There isn"
" space on the disc for 128 characters of information.n"
" May be overridden using the -p command line option.n"
"n"
" PUBL This should describe the publisher of the CDROM, usu-n"
" ally with a mailing address and phone number. There isn"
" space on the disc for 128 characters of information.n"
" May be overridden using the -P command line option.n"
"n"
" SYSI The System Identifier. There is space on the disc forn"
" 32 characters of information. May be overridden usingn"
" the -sysid command line option.n"
"n"
" VOLI The Volume Identifier. There is space on the disc forn"
" 32 characters of information. May be overridden usingn"
" the -V command line option.n"
"n"
" VOLS The Volume Set Name. There is space on the disc forn"
" 128 characters of information. May be overridden usingn"
" the -volset command line option.n"
"n"
" HFS_TYPEn"
" The default TYPE for Macintosh files. Must be exactly 4n"
" characters. May be overridden using the -hfs-type com-n"
" mand line option.n"
"n"
" HFS_CREATORn"
" The default CREATOR for Macintosh files. Must ben"
" exactly 4 characters. May be overridden using then"
" -hfs-creator command line option.n"
"n"
" mkisofs can also be configured at compile time with defaultsn"
" for many of these fields. See the file defaults.h.n"
"n"
"EXAMPLESn"
" To create a vanilla ISO-9660 filesystem image in the filen"
" cd.iso, where the directory cd_dir will become the rootn"
" directory if the CD, call:n"
"n"
" % mkisofs -o cd.iso cd_dirn"
"n"
" To create a CD with Rock Ridge extensions of the sourcen"
" directory cd_dir:n"
"n"
" % mkisofs -o cd.iso -R cd_dirn"
"n"
" To create a CD with Rock Ridge extensions of the sourcen"
" directory cd_dir where all files have at least read permis-n"
" sion and all files are owned by root, call:n"
"n"
" % mkisofs -o cd.iso -r cd_dirn"
"n"
" To create a HFS hybrid CD with the Joliet and Rock Ridgen"
" extensions of the source directory cd_dir:n"
"n"
" % mkisofs -o cd.iso -R -J -hfs cd_dirn"
"n"
" To create a HFS hybrid CD from the source directory cd_dirn"
" that contains Netatalk Apple/Unix files:n"
"n"
" % mkisofs -o cd.iso --netatalk cd_dirn"
"n"
" To create a HFS hybrid CD from the source directory cd_dir,n"
" giving all files CREATOR and TYPES based on just theirn"
" filename extensions listed in the file "mapping".:n"
"n"
" % mkisofs -o cd.iso -map mapping cd_dirn"
"n"
" To create a CD with the 'Apple Extensions to ISO9660', fromn"
" the source directories cd_dir and another_dir. Files in alln"
" the known Apple/Unix format are decoded and any other filesn"
" are given CREATOR and TYPE based on their magic number givenn"
" in the file "magic":n"
"n"
" % mkisofs -o cd.iso -apple -magic magic -probe \n"
" cd_dir another_dirn"
"n"
" The following example puts different files on the CD thatn"
" all have the name README, but have different contents whenn"
" seen as a ISO9660/RockRidge, Joliet or HFS CD.n"
"n"
" Current directory contains:n"
"n"
" % ls -Fn"
" README.hfs README.joliet README.unix cd_dir/n"
"n"
" The following command puts the contents of the directoryn"
" cd_dir on the CD along with the three README files - butn"
" only one will be seen from each of the three filesystems:n"
"n"
" % mkisofs -o cd.iso -hfs -J -r -graft-points \n"
" -hide README.hfs -hide README.joliet \n"
" -hide-joliet README.hfs -hide-joliet README.unix \n"
" -hide-hfs README.joliet -hide-hfs README.unix \n"
" README=README.hfs README=README.joliet \n"
" README=README.unix cd_dirn"
"n"
" i.e. the file README.hfs will be seen as README on the HFSn"
" CD and the other two README files will be hidden. Similarlyn"
" for the Joliet and ISO9660/RockRidge CD.n"
"n"
" There are probably all sorts of strange results possiblen"
" with combinations of the hide options ...n"
"n"
"AUTHORn"
" mkisofs is not based on the standard mk*fs tools for unix,n"
" because we must generate a complete copy of an existingn"
" filesystem on a disk in the iso9660 filesystem. The namen"
" mkisofs is probably a bit of a misnomer, since it not onlyn"
" creates the filesystem, but it also populates it as well.n"
" However, the appropriate tool name for a UNIX tool thatn"
" creates populated filesystems - mkproto - is not well known.n"
"n"
" Eric Youngdale or n"
" wrote the first versions (1993 ... 1998) of the mkisofsn"
" utility. The copyright for old versions of the mkisofsn"
" utility is held by Yggdrasil Computing, Incorporated. Joergn"
" Schilling wrote the SCSI transport library and it's adapta-n"
" tion layer to mkisofs and newer parts (starting from 1999)n"
" 2001 Joerg Schilling.n"
"n"
" 1999, 2000, 2001n"
" 1990, 1991, 1992, 1994, 1995.n"
"n"
"NOTESn"
" Mkisofs may safely be installed suid root. This may ben"
" needed to allow mkisofs to read the previous session whenn"
" creating a multi session image.n"
"n"
" If mkisofs is creating a filesystem image with Rock Ridgen"
" attributes and the directory nesting level of the sourcen"
" directory tree is too much for ISO-9660, mkisofs will don"
" deep directory relocation. This results in a directoryn"
" called RR_MOVED in the root directory of the CD. You cannotn"
" avoid this directory.n"
"n"
"BUGSn"
" o Any files that have hard links to files not in the treen"
" being copied to the iso9660 filesystem will have ann"
" incorrect file reference count.n"
"n"
" o Does not check for SUSP record(s) in "." entry of then"
" root directory to verify the existence of Rock Ridgen"
" enhancements.n"
"n"
" This problem is present when reading old sessions whilen"
" adding data in multi-session mode.n"
"n"
" o Does not properly read relocated directories in multi-n"
" session mode when adding data.n"
"n"
" Any relocated deep directory is lost if the new sessionn"
" does not include the deep directory.n"
"n"
" Repeat by: create first session with deep directoryn"
" relocation then add new session with a single dir thatn"
" differs from the old deep path.n"
"n"
" o Does not re-use RR_MOVED when doing multi-session fromn"
" TRANS.TBLn"
"n"
" o Does not create whole_name entry for RR_MOVED inn"
" multi-session mode.n"
"n"
" There may be some other ones. Please, report them to then"
" author.n"
"n"
"HFS PROBLEMS/LIMITATIONSn"
" I have had to make several assumptions on how I expect then"
" modified libhfs routines to work, however there may ben"
" situations that either I haven't thought of, or come acrossn"
" when these assumptions fail. Therefore I can't guaranteen"
" that mkisofs will work as expected (although I haven't had an"
" major problem yet). Most of the HFS features work fine, how-n"
" ever, some are not fully tested. These are marked as Alphan"
" above.n"
"n"
" Although HFS filenames appear to support upper and lowern"
" case letters, the filesystem is case insensitive. i.e. then"
" filenames "aBc" and "AbC" are the same. If a file is foundn"
" in a directory with the same HFS name, then mkisofs willn"
" attempt, where possible, to make a unique name by adding '_'n"
" characters to one of the filenames.n"
"n"
" HFS file/directory names that share the first 31 charactersn"
" have _N' (N == decimal number) substituted for the last fewn"
" characters to generate unique names.n"
"n"
" Care must be taken when "grafting" Apple/Unix files orn"
" directories (see above for the method and syntax involved).n"
" It is not possible to use a new name for an Apple/Unixn"
" encoded file/directory. e.g. If a Apple/Unix encoded filen"
" called "oldname" is to added to the CD, then you can not usen"
" the command line:n"
"n"
" mkisofs -o output.raw -hfs -graft-pointsn"
" newname=oldname cd_dirn"
"n"
" mkisofs will be unable to decode "oldname". However, you cann"
" graft Apple/Unix encoded files or directories as long as youn"
" do not attempt to give them new names as above.n"
"n"
" When creating an HFS volume with the multisession options,n"
" -M and -C, only files in the last session will be in the HFSn"
" volume. i.e. mkisofs can not add existing files from previ-n"
" ous sessions to the HFS volume.n"
"n"
" Symbolic links (as with all other non-regular files) are notn"
" added to the HFS directory.n"
"n"
" Hybrid volumes may be larger than pure ISO9660 volumes con-n"
" taining the same data.n"
" The resulting hybrid volume can be accessed on a Unixn"
" machine by using the hfsutils routines. However, no changesn"
" can be made to the volume as it is set as locked. The optionn"
" -hfs-unlock will create an output image that is unlocked -n"
" however no changes should be made to the contents of then"
" volume (unless you really know what you are doing) as it'sn"
" not a "real" HFS volume.n"
"n"
" Using the -mac-name option will not currently work with then"
" -T option - the Unix name will be used in the TRANS.TBLn"
" file, not the Macintosh name.n"
"n"
" Although mkisofs does not alter the contents of a file, if an"
" binary file has it's TYPE set as 'TEXT', it may be readn"
" incorrectly on a Macintosh. Therefore a better choice forn"
" the default TYPE may be '????'n"
"n"
" The -mac-boot-file option may not work at all...n"
"n"
" May not work with PC Exchange v2.2 or higher files (avail-n"
" able with MacOS 8.1). DOS media containing PC Exchangen"
" files should be mounted as type msdos (not vfat) when usingn"
" Linux.n"
"n"
" The SFM format is only partially supported - see HFS MACIN-n"
" TOSH FILE FORMATS section above.n"
"n"
" It is not possible to use the the -sparc-boot or -generic-n"
" boot options with the -boot-hfs-file or -prep-boot options.n"
"n"
"SEE ALSOn"
" cdrecord(1) magic(5), apple_driver(8)n"
"n"
"FUTURE IMPROVEMENTSn"
" Some sort of gui interface.n"
"n"
"AVAILABILITYn"
" mkisofs is available as part of the cdrecord package fromn"
" ftp://ftp.fokus.gmd.de/pub/unix/cdrecord/ hfsutils fromn"
" ftp://ftp.mars.org/pub/hfsn"
"n"
"MAILING LISTSn"
" If you want to actively take part on the development ofn"
" mkisofs, and/or mkhybrid, you may join the cdwriting mailingn"
" list by sending mail to:n"
"n"
" other-cdwrite-request@lists.debian.orgn"
"n"
" and include the word subscribe in the body. The mailn"
" address of the list is:n"
" cdwrite@lists.debian.orgn"
"n"
"MAINTAINERn"
" Joerg Schillingn"
" Seestr. 110n"
" D-13353 Berlinn"
" Germanyn"
"n"
"HFS MKHYBRID MAINTAINERn"
" James Pearsonn"
"n"
" j.pearson@ge.ucl.ac.ukn"
"n"
"n"
" If you have support questions, send them to:n"
"n"
" cdrecord-support@berlios.den"
" or other-cdwrite@lists.debian.orgn"
"n"
" Of you definitly found a bug, send a mail to:n"
"n"
" cdrecord-developers@berlios.den"
" or schilling@fokus.gmd.den"
"n"
" To subscribe, use:n"
"n"
" http://lists.berlios.de/mailman/listinfo/cdrecord-developersn"
" or http://lists.berlios.de/mailman/listinfo/cdrecord-supportn"
"n";
const char fbHelpCdrdaoText[] =
"NAMEn"
" cdrdao - writes audio CD-Rs in disc-at-once moden"
"n"
"SYNOPSISn"
" cdrdao {show-toc|read-toc|read-cd|read-cddb|show-data|read-n"
" test|disk-info|msinfo|unlock|simulate|write|copy} [--devicen"
" device] [--source-device device] [--driver driver-id] [--n"
" source-driver driver-id] [--simulate] [--speed writing-n"
" speed] [--datafile file] [--read-raw] [--tao-source] [--n"
" tao-source-adjust link-blocks] [--fast-toc] [--buffersn"
" buffer-count] [--multi] [--overburn] [--eject] [--swap] [--n"
" session] [--force] [--reload] [--keepimage] [--on-the-fly]n"
" [--paranoia-mode mode] [--with-cddb] [--cddb-serversn"
" server-list] [--cddb-timeout timeout] [--cddb-directoryn"
" directory] [--save] [-n] [-v verbose-level] toc-filen"
"n"
"DESCRIPTIONn"
" cdrdao creates audio and data CD-Rs in disk-at-once (DAO)n"
" mode driven by a description file called toc-file. In DAOn"
" mode it is possible to create non standard track pre-gapsn"
" that have other lengths than 2 seconds and contain nonzeron"
" audio data. This is for example useful to divide liven"
" recordings into tracks where 2 second gaps would be kind ofn"
" irritating.n"
"n"
" Instead of a toc-file a cue file (used by a famousn"
" DOS/Windows mastering tool) may be used. See the CUE FILESn"
" section for more details.n"
"n"
"COMMANDSn"
" The first argument must be one of the following commands:n"
"n"
" show-tocn"
" Print out a summary about what will be written to then"
" CD-R.n"
"n"
" read-tocn"
" Analyze each track of the inserted CD and create an"
" toc-file that can be used to make a more or less exactn"
" copy of the CD. This command does not read out then"
" audio or data tracks, use read-cd for this purpose.n"
"n"
" You can specify a filename for the data file via the -n"
" -datafile option.n"
"n"
" read-cdn"
" Copies all tracks of the inserted CD to an image filen"
" and creates a corresponding toc-file. The name of then"
" image file defaults to "data.bin" if no --datafilen"
" option is given.n"
"n"
" read-cddbn"
" Tries to retrieve title and artist data from a CDDBn"
" server for the CD represented by the given toc-file.n"
" The retrieved data is added as CD-TEXT data forn"
" language 0 to the toc-file. Existing CD-TEXT data forn"
" language 0 will be overwritten.n"
"n"
" show-datan"
" Print out all samples that would be written to the CD-n"
" R. Each line contains the sample number (starting at 0)n"
" and the decimal sample value for the left and rightn"
" channel. Useful to check if the byte order of audion"
" files is correct.n"
"n"
" read-testn"
" Check if all data can be read from the audio files thatn"
" are defined in the toc-file. This will also check then"
" communication with the slave process that is responsi-n"
" ble for writing the audio data to the CD-recorder.n"
" Mainly used for testing.n"
"n"
" disk-infon"
" Shows information about the inserted CD-R. If the CD-Rn"
" has an open session it will also print the start of then"
" last and current session which is used by mkisofs ton"
" create an image for a second or higher session.n"
"n"
" msinfon"
" Shows information required for creating multi sessionn"
" disks with mkisofs. The output is meant for processingn"
" by scripts.n"
"n"
" unlockn"
" Tries to unlock the recorder device after a failedn"
" write or simulation run. If you cannot eject the CDn"
" after a cdrdao run try this command.n"
"n"
" simulaten"
" Like write but laser stays cold. It is a shortcut forn"
" write--simulate.n"
"n"
" writen"
" Write the CD-R according to the specifications in then"
" toc-file.n"
"n"
" copy Performs all steps to copy a CD. The device containingn"
" the source CD must be specified with option --source-n"
" device and the recorder device with option --device.n"
" If only a single device is available the option --n"
" source-device must be omitted and cdrdao will prompt ton"
" insert the CD-R after an image of the source CD wasn"
" created.n"
" The image file with name "cddata.bin" will ben"
" created in the current working directory if no --n"
" datafile option is given. The created image will ben"
" removed after it has been written.n"
"n"
" If option --on-the-fly is given no image file isn"
" created and the data will be directly piped from then"
" reading device to the CD recorder.n"
"n"
"OPTIONSn"
" --device bus,id,lunn"
" Sets the SCSI address of the CD-recorder in form of an"
" bus/id/lun triple, e.g. '0,2,0' for the logical unit 0n"
" of SCSI device with ID 2 on bus 0. On some systems an"
" device node may be specified directly, e.g. '/dev/sg0'n"
" on Linux systems.n"
"n"
" --source-device bus,id,lunn"
" Like above but used for the copy command to specify then"
" source device.n"
"n"
" --driver driver-id:option-flagsn"
" Force usage of specified driver instead of the automat-n"
" ically determined driver. Available driver IDs:n"
" cdd2600, plextor, plextor-scan, generic-mmc, generic-n"
" mmc-raw, ricoh-mp6200, yamaha-cdr10x, teac-cdr55,n"
" sony-cdu920, sony-cdu948, taiyo-yuden, toshiba.n"
" Specifying an illegal driver ID will give a list ofn"
" available drivers. Option flags may be used to modifyn"
" the behavior of some drivers. See README for details.n"
"n"
" --source-driver driver-id:option-flagsn"
" Like above but used for the device specified withn"
" option --source-device.n"
"n"
" --speed valuen"
" Set the writing speed to value. Default is the highestn"
" possible speed.n"
"n"
" --datafile filen"
" Used for read-toc,read-cd and copy. Set the defaultn"
" data file placed in the toc-file by read-toc.Use-n"
" toindicateSTDIN. For commands read-cd and copy itn"
" specifies the name of the created image file.n"
"n"
" --read-rawn"
" Only used for command read-cd. All data sectors willn"
" be written as 2352 byte blocks including the sectorn"
" header and L-EC data to the image file. The track moden"
" will be set to MODE1_RAW or MODE2_RAW in the createdn"
" toc-file.n"
"n"
" --tao-sourcen"
" This option indicates to the commands read-toc andn"
" read-cd that the source CD was written in TAO mode. Itn"
" will be assumed that the pre-gap length between alln"
" tracks (except between two audio tracks) is the stan-n"
" dard 150 blocks plus the number of link blocks (usuallyn"
" 2). The number of link blocks can be controlled withn"
" option --tao-source-adjust.n"
"n"
" Use this option only if read-toc or read-cd give errorn"
" messages in the transition areas between two tracks. Ifn"
" you use this option with pressed CDs or CDs written inn"
" DAO mode you will get wrong results.n"
"n"
" --tao-source-adjust link-blocksn"
" Specifies the number of link blocks for tracks writtenn"
" in TAO mode. This option has only an effect if optionn"
" --tao-source is given.n"
"n"
" --fast-tocn"
" Only used for command read-toc. This option suppressesn"
" the pre-gap length and index mark extraction whichn"
" speeds up the read-toc process. Standard 2 second pre-n"
" gaps (but no silence!) will be placed into the toc-n"
" file. The resulting CD will sound like the source CD.n"
" Only the CD player's display will behave slightly dif-n"
" ferent in the transition area between two tracks.n"
"n"
" This option might help, too, if read-toc fails withn"
" your drive otherwise.n"
"n"
"n"
" --buffers buffer-countn"
" Specifies the number of buffers that are allocated ton"
" avoid buffer under runs. The minimal buffer count isn"
" fixed to 10, default is 32 except on FreeBSD systems,n"
" on which default is 20. Each buffer holds 1 second ofn"
" audio data so that dividing buffer-count by the writingn"
" speed gives the maximum time for which reading of audion"
" data may be stalled.n"
"n"
" --multin"
" If this option is given the session will not be closedn"
" after the audio data is successfully written. It isn"
" possible to append another session on such disks, e.g.n"
" to create a CD-EXTRA.n"
"n"
" --overburnn"
" By default cdrdao will not allow to write more data onn"
" a medium than specified by the current medium. Thisn"
" option allows to ignore this condition.n"
"n"
" --ejectn"
" Eject the CD-R after writing or write simulation.n"
"n"
" --swapn"
" Swap the byte order of all samples that are send to then"
" CD-recorder.n"
"n"
" --session session-nrn"
" Used for read-toc and read-cd to specify the sessionn"
" which should be processed on multi session CDs.n"
"n"
" --reloadn"
" Indicates that the tray may be opened before writingn"
" without prompting the user to reset the disk statusn"
" after a simulation run.n"
"n"
" --forcen"
" Forces the execution of an operation that otherwisen"
" would not be performed.n"
"n"
" --paranoia-mode moden"
" Sets the correction mode for digital audio extraction.n"
" 0: No checking, data is copied directly from the drive.n"
" 1: Perform overlapped reading to avoid jitter. 2: Liken"
" 1 but with additional checks of the read audio data. 3:n"
" Like 2 but with additional scratch detection andn"
" repair.n"
"n"
" The extraction speed reduces from 0 to 3.n"
"n"
" Default is the full paranoia mode (3).n"
"n"
" --keepimagen"
" If a CD is copied with command copy this option willn"
" cause that the created image is not removed after then"
" copy process has finished.n"
"n"
" --on-the-flyn"
" Perform CD copy on the fly without creating an imagen"
" file.n"
"n"
" --with-cddbn"
" Enables the automatic fetching of CDDB data for use asn"
" CD-TEXT data for commands copy, read-toc and read-cd.n"
"n"
" --cddb-servers server-listn"
" Sets space or ',' separated list of CDDB servers usedn"
" for command read-cddb or for commands where the --n"
" with-cddb option is active. A server entry may haven"
" the following forms:n"
"n"
" n"
" Connect to , default cddbp port (888), usen"
" cddbp protocol.n"
"n"
" :n"
" Connect to , port , use cddbp protocol.n"
"n"
" :n"
" Connect to , default http port (80), use httpn"
" protocol, url: .n"
"n"
" ::n"
" Connect to , port , use http protocol,n"
" url: .n"
"n"
" :::n"
" Connect to , default http port (80), usen"
" http protocol, url: http://:/" [ ]n"
" Adds the audio data of specified file to actual audion"
" track. It is possible to select a portion of an audion"
" file with and which allows non des-n"
" tructive cutting. The first sample of an audio file isn"
" addressed with = 0. If is omitted orn"
" set to 0 all audio data from until the end ofn"
" file is used.n"
"n"
" Audio files may have raw or WAVE format with 16 bitsn"
" per sample, 44.1 kHz sampling rate, stereo. Raw filesn"
" must have the layout 'MSBLeft LSBLeft MSBRight LSBRightn"
" ...' (big endian byte order). WAVE files are expectedn"
" to have little endian byte order. The option --swapn"
" reverses the expected byte order for all raw and WAVEn"
" files. Only filenames with a ".wav" ending are treatedn"
" as WAVE files, all other names are assumed to be rawn"
" audio files. Use tools like sox(1) to convert othern"
" file formats to supported formats.n"
"n"
" Specifying a "-" as filename causes data to be readn"
" from STDIN. Currently only raw files are supported fromn"
" STDIN.n"
"n"
" If you are unsure about the byte order of your audion"
" files try the command 'show-data'. If the byte order isn"
" correct you will see a sequence of increasing orn"
" decreasing numbers for both channels. Otherwise numbersn"
" are jumping between very high and low values - highn"
" volume static.n"
"n"
" DATAFILE "" [ ]n"
" Adds data from given file to actual data track. Ifn"
" is omitted the actual file length will ben"
" used.n"
"n"
" START [ MM:SS:FF ]n"
" Defines the length of the pre-gap (position where indexn"
" switches from 0 to 1). If the MSF value is omitted then"
" current track length is used. If the current trackn"
" length is not a multiple of the block length the pre-n"
" gap length will be rounded up to next block boundary.n"
"n"
" If no START statement is given the track will not haven"
" a pre-gap.n"
"n"
" PREGAP MM:SS:FFn"
" This is an alternate way to specify a pre-gap with zeron"
" audio data. It may appear before the first SILENCE,n"
" ZERO or FILE statement. Either PREGAP or START can ben"
" used within a track specification. It is equivalent ton"
" the sequencen"
" SILENCE MM:SS:FFn"
" STARTn"
" for audio tracks orn"
" ZERO MM:SS:FFn"
" STARTn"
" for data tracks.n"
"n"
" Nothing prevents mixing 'DATAFILE'/'ZERO' andn"
" 'AUDIOFILE'/'SILENCE' statements within the same track. Then"
" results, however, are undefined.n"
"n"
" The end of a track specification may contain zero or moren"
" index increment statements:n"
"n"
" INDEX MM:SS:FFn"
" Increments the index number at given position withinn"
" the track. The first statement will increment from 1 ton"
" 2. The position is relative to the real track start,n"
" not counting an existing pre-gap.n"
"n"
" CD-TEXT Blocksn"
" A CD-TEXT block may be placed in the global section ton"
" define data valid for the whole CD and in each track specif-n"
" ication of a toc-file. The global section must define an"
" language map that is used to map a language-number to coun-n"
" try codes. Up to 8 different languages can be defined:n"
"n"
" LANGUAGE_MAP { 0 : c1 1 : c2 ... 7 : c7 }n"
" The country code may be an integer value in the rangen"
" 0..255 or one of the following countries (then"
" corresponding integer value is placed in braces behindn"
" the token): EN(9, English)n"
" It is just necessary to define a mapping for the usedn"
" languages.n"
"n"
" If no mapping exists for a language-number the data for thisn"
" language will be ignored.n"
"n"
" For each language a language block must exist that definesn"
" the actual data for a certain language.n"
"n"
"cd-text-data ... }n"
" LANGUAGE language-number { cd-text-item cd-text-data cd-n"
" text-itemn"
" Defines the CD-TEXT items for given language-numbern"
" which must be defined in the language map.n"
"n"
" The cd-text-data may be either a string enclosed by " orn"
" binary data liken"
" { 0, 10, 255, ... }n"
" where each integer number must be in the range 0..255.n"
" The cd-text-item may be one of the following:n"
"n"
" TITLEn"
" String data: Title of CD or track.n"
"n"
" PERFORMERn"
" String data.n"
"n"
" SONGWRITERn"
" String data.n"
"n"
" COMPOSERn"
" String data.n"
"n"
" ARRANGERn"
" String data.n"
"n"
" MESSAGEn"
" String data. Message to the user.n"
"n"
" DISC_IDn"
" String data: Should only appear in the global CD-TEXTn"
" block. The format is usually: XY12345n"
"n"
" GENREn"
" Mixture of binary data (genre code) and string data.n"
" Should only appear in the global CD-TEXT block. Usefuln"
" entries will be created by gcdmaster.n"
"n"
" TOC_INFO1n"
" Binary data: Optional table of contents 1. Should onlyn"
" appear in the global CD-TEXT block.n"
"n"
" TOC_INFO2n"
" Binary data: Optional table of contents 2. Should onlyn"
" appear in the global CD-TEXT block.n"
"n"
" UPC_EANn"
" String data: This item should only appear in the globaln"
" CD-TEXT block. Was always an empty string on the CD-n"
" TEXT CDs I had access to.n"
"n"
" ISRC String data: ISRC code of track. The format is usually:n"
" CC-OOO-YY-SSSSSn"
"n"
" SIZE_INFOn"
" Binary data: Contains summary about all CD-TEXT datan"
" and should only appear in the global CD-TEXT block. Then"
" data will be automatically (re)created when the CD-TEXTn"
" data is written.n"
"n"
" If one of the CD-TEXT items TITLE, PERFORMER, SONG-n"
" WRITER, COMPOSER, ARRANGER, ISRC is defined for atn"
" least on track or in the global section it must ben"
" defined for all tracks and in the global section. If an"
" DISC_ID item is defined in the global section, an ISRCn"
" entry must be defined for each track.n"
"n"
" Examplesn"
" Simple track without pre-gap with all audio data from WAVEn"
" file "data.wav":n"
" CD_DAn"
" TRACK AUDIOn"
" FILE "data.wav" 0n"
"n"
" Standard track with two second pre-gap, ISRC code and CD-n"
" TEXT:n"
" CD_DAn"
" CD_TEXT {n"
" LANGUAGE_MAP {n"
" 0 : ENn"
" }n"
"n"
" LANGUAGE 0 {n"
" TITLE "CD Title"n"
" PERFORMER "Performer"n"
" DISC_ID "XY12345"n"
" UPC_EAN ""n"
" }n"
" }n"
"n"
" TRACK AUDIOn"
" ISRC "DEXXX9800001"n"
" CD_TEXT {n"
" LANGUAGE 0 {n"
" TITLE "Track Title"n"
" PERFORMER "Performer"n"
" ISRC "DE-XXX-98-00001"n"
" }n"
" }n"
" PREGAP 0:2:0n"
" FILE "data.wav" 0n"
"n"
" Track with 10 second pre-gap containing audio data from rawn"
" file "data.cdr":n"
" CD_DAn"
" TRACK AUDIOn"
" FILE "data.cdr" 0n"
" START 0:10:0n"
"n"
" Composed track with data from different files. Pre-gap datan"
" and length is taken from "pregapdata.wav". The first minuten"
" of "track.cdr" is omitted and two seconds silence aren"
" inserted at '2:0:0'. Index will be incremented after 2 and 4n"
" minutes past track start:n"
" CD_DAn"
" TRACK AUDIOn"
" FILE "pregapdata.wav" 0n"
" STARTn"
" FILE "track.cdr" 1:0:0 1:0:0n"
" SILENCE 0:2:0n"
" FILE "track.cdr" 2:0:0n"
" INDEX 2:0:0n"
" INDEX 4:0:0n"
"n"
" Mixed mode CD with a data track as first track followed byn"
" two audio tracks.n"
" CD_ROMn"
" TRACK MODE1n"
" DATAFILE "data_1"n"
" ZERO 00:02:00 // post-gapn"
"n"
" TRACK AUDIOn"
" SILENCE 00:02:00 // pre-gapn"
" STARTn"
" FILE "data_2.wav" 0n"
"n"
" TRACK AUDIOn"
" FILE "data_3.wav" 0n"
"n"
"CUE FILESn"
" Cue files may be used wherever a toc-file is expected. Then"
" corresponding bin file is not taken from the FILE statementn"
" of a cue file but constructed from the cue file name byn"
" replacing ".cue" by ".bin". The cue file must have exactlyn"
" one FILE statement.n"
"n"
" Currently, following track modes are supported: MODE1/2048,n"
" MODE1/2352, MODE2/2336, MODE2/2352. The CATALOG, ISRC andn"
" POSTGAP statements are parsed but not evaluated, yet.n"
"n"
"SETTINGSn"
" Some of the command line options can be stored as settingsn"
" at following locations. The files will be read on startup ofn"
" cdrdao in that order:n"
"n"
" 1. /etc/cdrdao.confn"
"n"
" 2. /etc/defaults/cdrdaon"
"n"
" 3. $HOME/.cdrdaon"
"n"
"n"
" Command line options will overwrite the loaded settings.n"
" The settings file contains name - value pairs separated by an"
" colon. String values should be enclosed by ". The file isn"
" automatically written if the command line option --save isn"
" used but it is also possible to modify it manually. Follow-n"
" ing values are defined:n"
"n"
" write_devicen"
" Device used for operations simulate, write, copy,n"
" blank, disk-info and Corresponding option: --devicen"
"n"
" write_drivern"
" Driver (including driver options) that is used forn"
" operations simulate, write, copy, blank, disk-info andn"
" Corresponding option: --drivern"
"n"
" write_speedn"
" Specifies writing speed. Corresponding option: --speedn"
"n"
" write_buffersn"
" Specifies fifo buffers used for recording. Correspond-n"
" ing option: --buffersn"
"n"
" read_devicen"
" Device used for operations read-toc, read-cd and copy.n"
" Corresponding option: --device or --source-devicen"
"n"
" read_drivern"
" Driver (including driver options) used for operationsn"
" read-toc, read-cd and copy. Corresponding option: --n"
" driver or --source-drivern"
"n"
" read_paranoia_moden"
" Paranoia mode used for operations read-cd and copy.n"
" Corresponding option: --paranoia-moden"
"n"
" cddb_server_listn"
" CDDB server list for read-cddb. Corresponding option:n"
" --cddb-serversn"
"n"
" cddb_timeoutn"
" CDDB connection timeout in seconds used by read-cddb.n"
" Corresponding option: --cddb-timeoutn"
"n"
" cddb_directoryn"
" Local directory where fetched CDDB records will ben"
" stored, used by read-cddb. Corresponding option: --n"
" cddb-directoryn"
"n"
"BUGSn"
" If the program is terminated during the write/simulationn"
" process used IPC resources may not be released. Use ipcs(8)n"
" and ipcrm(8) to delete them.n"
"n"
"AUTHORn"
" Andreas Mueller mueller@daneb.ping.den"
"n"
"SEE ALSOn"
" gcdmaster(1), cdrecord(1), cdda2wav(1),n"
"n";