DVD

开发平台：

Visual C++

FreeburnHelpText.cpp：源码内容

/* File defining all text strings to be used in the HelpWindow Class
*
*/
/*
* FreeBurn Software License
* (based on the Apache Software License)
*
* Version 1.1
*
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* 3. The end-user documentation included with the redistribution, if any, must
* include the following acknowledgment:
*
* "This product includes software developed by the FreeBurn
* Project (http://freeburn.sourceforge.net/)."
*
* Alternately, this acknowledgment may appear in the software itself,
* if and wherever such third-party acknowledgments normally appear.
*
* 4. The names "FreeBurn" and "FreeBurn Project" must not be
* used to endorse or promote products derived from this software
* without prior written permission. For written permission, please
* contact aschlag@users.sourceforge.net.
*
* 5. Products derived from this software may not be called "FreeBurn",
* nor may "FreeBurn" appear in their name, without prior written
* permission of the FreeBurn Project.
*
* THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
* WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE FREEBURN PROJECT OR ITS
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
* This software consists of voluntary contributions made by many
* individuals on behalf of the FreeBurn Project. For more
* information on the FreeBurn Project and FreeBurn, please see
* <http://freeburn.sourceforge.net/>.
*
* This software is distributed with software that is released under the GNU
* General Public License (GPL). You can find the terms of this license in the
* file GPL.txt distributed in this package. You can find information on the
* software distributed with this package in the file PROGRAMS.txt.
*/
#include "FreeburnDefs.h"
#include "FreeburnHelpText.h"
const char fbHelpTitleText[] = "FreeBurn Help";
const char fbHelpCdrecordTitleText[] = "cdrecord man page";
const char fbHelpMkisofsTitleText[] = "mkisofs man page";
const char fbHelpCdrdaoTitleText[] = "cdrdao man page";
const char fbHelpCloseButtonText[] = "&OK";
const char fbHelpText[] =
" FreeBurn Helpn"
"n"
"FreeBurn is a free front-end for disc burning programs such as cdrecord,n"
"mkisofs, and cdrdao (currently). It is meant to be an easy to use interfacen"
"for creating CDs with free software. The programs FreeBurn uses are n"
"available for everyone to download and use under the terms of the GNU n"
"General Public License. FreeBurn itself is under the FreeBurn (or Apache)n"
"Software License, so you have less restrictions on how you can use thisn"
"front-end than you do with the actual programs that are doing the work.n"
"n"
"Currently you have the capability to do anything with cdrecord, mkisofs, andn"
"cdrdao that you could on the command line. This version of FreeBurn is n"
"a very early alpha version, and the interface has a while to go before it isn"
"complete. However, you can find the manual pages for cdrecord, mkisofs, n"
"and cdrdao included in this program (you can find them in the Help menu).n"
"With this you should be able to do some useful things with FreeBurn. Undern"
"the Burn A Blank CD dialog you can specify which program you want to use n"
"(cdrecord for Track-At-Once recording or cdrdao for Disc-At-Once recording).n"
"This dialog and the Disc Image dialog let you choose if you want to executen"
"the program with a UNIX-style shell (like sh or bash) as well as command linen"
"options. Once you launch a command you are given an output dialog that letsn"
"you keep track of the output, as well as view the entire contents of the outputn"
"log, which you can save to a text file once the command is complete.n"
"n"
"FreeBurn also has some customization features. You can set the paths ton"
"the disc burning tools and you can customize the interface. You can also n"
"choose different theme options. You can choose from four different icon sets, n"
"as well as the colors of the program itself. For icon themes you can choose n"
"from a default (Windows-like) icon set, a GNOME icon set, a KDE icon set, orn"
"an XP icon set. As previously mentioned, you can also set the colors for then"
"program. This all give you some flexibility on making FreeBurn look the way youn"
"want it to. If you don't like the colors you change it to, you can change themn"
"back to the default colors in the same dialog. All the settings for the program n"
"are stored in a file called freeburn.ini. You can find this ini file by searching for n"
"the .foxrc directory under your home directory.n"
"n"
"FreeBurn is far from complete. Please check our web site or our project site forn"
"updates and news on new versions of FreeBurn, as well as ways you may be ablen"
"to contribute if you so desire. Also, this help is far from complete, and will be n"
"updated continuously. If you have any questions, please feel free to e-mail the n"
"author at aschlag@users.sourceforge.net or post to the users mailing list at n"
"freeburn-users@lists.sourceforge.net.";
const char fbHelpCdrecordText[] =
"NAMEn"
" cdrecord - record audio or data Compact Discs from a mastern"
"n"
"SYNOPSISn"
" cdrecord [ general options ] dev=device [ track options ]n"
" track1...tracknn"
"n"
"DESCRIPTIONn"
" Cdrecord is used to record data or audio Compact Discs on ann"
" Orange Book CD-Recorder.n"
"n"
" The device refers to scsibus/target/lun of the CD-Recorder.n"
" Communication on SunOS is done with the SCSI general drivern"
" scg. Other operating systems are using a library simulationn"
" of this driver. Possible syntax is: dev=n"
" scsibus,target,lun or dev= target,lun. In the latter case,n"
" the CD-Recorder has to be connected to the default SCSI busn"
" of the machine. Scsibus, target and lun are integern"
" numbers. Some operating systems or SCSI transport implemen-n"
" tations may require to specify a filename in addition. Inn"
" this case the correct syntax for the device is: dev=n"
" devicename:scsibus,target, or dev= devicename:target,lun.n"
" If the name of the device node that has been specified onn"
" such a system refers to exactly one SCSI device, a shorthandn"
" in the form dev= devicename:@ or dev= devicename:@,lun mayn"
" be used instead of dev= devicename:scsibus,target,n"
"n"
" To access remote SCSI devices, you need to prepend the SCSIn"
" device name by a remote device indicator. The remote devicen"
" indicator is either REMOTE:user@host: or REMOTE:host:n"
" A valid remote SCSI device name may be: REMOTE:user@host:n"
" to allow remote SCSI bus scanning or REMOTE:user@host:1,0,0n"
" to access the SCSI device at host connected to SCSI bus #n"
" 1,target 0 lun 0.n"
"n"
" To make cdrecord portable to all UNIX platforms, the syntaxn"
" dev= devicename:scsibus,target, is preferred as is hides OSn"
" specific knowledge about device names from the user. An"
" specific OS must not necessarily support a way to specify an"
" real device file name nor a way to specifyn"
" scsibus,target,lun.n"
"n"
" Scsibus 0 is the default SCSI bus on the machine. Watch then"
" boot messages for more information or look inton"
" /var/adm/messages for more information about the SCSI confi-n"
" guration of your machine. If you have problems to figuren"
" out what values for scsibus,target,lun should be used, tryn"
" the -scanbus option of cdrecord described below.n"
" If a file /etc/default/cdrecord exists, the parameter to then"
" dev= option may also be a drive name label in said file (seen"
" FILES section).n"
"n"
" On SVr4 compliant systems, cdrecord uses the the real timen"
" class to get the highest scheduling priority that is possi-n"
" ble (higher than all kernel processes). On systems withn"
" POSIX real time scheduling cdrecord uses real time schedul-n"
" ing too, but may not be able to gain a priority that isn"
" higher than all kernel processes.n"
"n"
" In Track At Once mode, each track corresponds to a singlen"
" file that contains the prepared data for that track. If then"
" argument is `-', standard input is used for that track. Onlyn"
" one track may be taken from stdin.n"
"n"
"GENERAL OPTIONSn"
" General options must be before any track file name or trackn"
" option.n"
"n"
" -versionn"
" Print version information and exit.n"
"n"
" -v Increment the level of general verbosity by one. Thisn"
" is used e.g. to display the progress of the writingn"
" process.n"
"n"
" -V Increment the verbose level in respect of SCSI commandn"
" transport by one. This helps to debug problems duringn"
" the writing process, that occur in the CD-Recorder. Ifn"
" you get incomprehensible error messages you should usen"
" this flag to get more detailed output. -VV will shown"
" data buffer content in addition. Using -V or -VV slowsn"
" down the process and may be the reason for a buffern"
" underrun.n"
"n"
" debug=#, -dn"
" Set the misc debug value to # (with debug=#) or incre-n"
" ment the misc debug level by one (with -d). If youn"
" specify -dd, this equals to debug=2. This may help ton"
" find problems while opening a driver for libscg as welln"
" as with sector sizes and sector types. Using -debugn"
" slows down the process and may be the reason for an"
" buffer underrun.n"
"n"
" kdebug=#, kd=#n"
" Tell the scg-driver to modify the kernel debug valuen"
" while SCSI commands are running.n"
"n"
" -silent, -sn"
" Do not print out a status report for failed SCSI com-n"
" mands.n"
"n"
" -forcen"
" Force to continue on some errors. This optionn"
" currently implements some tricks that will allow you ton"
" blank bad CD-RW disks.n"
"n"
" -dummyn"
" The CD-Recorder will go through all steps of then"
" recording process, but the laser is turned off duringn"
" this procedure. It is recommended to run several testsn"
" before actually writing to a Compact Disk, if the tim-n"
" ing and load response of the system is not known.n"
"n"
" -dao Set Disk At Once mode. This currently only works withn"
" MMC drives that support non raw Session At Once mode.n"
"n"
" -multin"
" Allow multi session CD's to be made. This flag needs ton"
" be present on all sessions of a multi session disk,n"
" except you want to create a session that will be then"
" last session on the media. The fixation will be donen"
" in a way that allows the CD-Recorder to append addi-n"
" tional sessions later. This is done by generation a TOCn"
" with a link to the next program area. The so generatedn"
" media is not 100% compatible to manufactured CD'sn"
" (except for CDplus). Use only for recording of multin"
" session CD's. If this option is present, the defaultn"
" track type is CD-ROM XA mode 2. The Sony drives haven"
" no hardware support for CD-ROM XA mode 2. You have ton"
" specify the -data option in order to create multi ses-n"
" sion disks on these drives. As long as cdrecord doesn"
" not have a coder for converting data sectors to audion"
" sectors, you need to force CD-ROM sectors by includingn"
" the -data option if you like to record a multisessionn"
" disk in DAO/SAO mode. Not all drives allow multises-n"
" sion CD's in DAO/SAO mode.n"
"n"
" -msinfon"
" Retrieve multi session info in a form suitable forn"
" mkisofs-1.10 or later.n"
"n"
" This option makes only sense with a CD that contains atn"
" least one closed session and is appendable (not finallyn"
" closed yet). Some drives create error messages if youn"
" try to get the multi session info for a disk that isn"
" not suitable for this operation.n"
"n"
" -toc Retrieve and print out the table of content or PMA of an"
" CD. With this option, cdrecord will work with CD-Rn"
" drives and with CD-ROM drives.n"
"n"
" -atipn"
" Retrieve and print out the ATIP (absolute Time in Pre-n"
" groove) info of a CD recordable or CD rewritable media.n"
" With this option, cdrecord will try to retrieve then"
" ATIP info. If the actual drive does not support to readn"
" the ATIP info, it may be that only a reduced set ofn"
" information records or even nothing is displayed. Onlyn"
" a limited number of MMC compliant drives support ton"
" read the ATIP info.n"
"n"
" If cdrecord is able to retrieve the lead-in start timen"
" for the first session, it will try to decode and printn"
" the manufacturer info from the media.n"
"n"
" -fix The disk will only be fixated (i.e. a TOC for a CD-n"
" Reader will be written). This may be used, if for somen"
" reason the disk has been written but not fixated. Thisn"
" option currently does not work with old TEAC drivesn"
" (CD-R50S and CD-R55S).n"
"n"
" -nofixn"
" Do not fixate the disk after writing the tracks. Thisn"
" may be used to create an audio disk in steps. An un-n"
" fixated disk can usually not be used on a non CD-writern"
" type drive but there are audio CD players that will ben"
" able to play such a disk.n"
"n"
" -waitin"
" Wait for input to become available on standard inputn"
" before trying to open the SCSI driver. This allowsn"
" cdrecord to read it's input from a pipe even when writ-n"
" ing additional sessions to a multi session disk. Whenn"
" writing another session to a multi session disk,n"
" mkisofs needs to read the old session from the devicen"
" before writing output. This cannot be done if cdrecordn"
" opens the SCSI driver at the same time.n"
"n"
" -loadn"
" Load the media and exit. This only works with a trayn"
" loading mechanism but seems to be useful when using then"
" Kodak disk transporter.n"
"n"
" -ejectn"
" Eject disk after doing the work. Some Devices (e.g.n"
" Philips) need to eject the medium before creating a newn"
" disk. Doing a -dummy test and immediately creating an"
" real disk would not work on these devices.n"
"n"
" speed=#n"
" Set the speed factor of the writing process to #. # isn"
" an integer, representing a multiple of the audio speed.n"
" This is about 150 KB/s for CD-ROM and about 172 KB/sn"
" for CD-Audio. If no speed option is present, cdrecordn"
" will try to get the speed value from the CDR_SPEEDn"
" environment. If your drive has problems with speed=2n"
" or speed=4, you should try speed=0.n"
"n"
" blank=typen"
" Blank a CD-RW and exit or blank a CD-RW before writing.n"
" The blanking type may be one of:n"
"n"
" help Display a list of possible blanking types.n"
"n"
" all Blank the entire disk. This may take a longn"
" time.n"
"n"
" fast Minimally blank the disk. This results inn"
" erasing the PMA, the TOC and the pregap.n"
"n"
" track Blank a track.n"
"n"
" unreserve Unreserve a reserved track.n"
"n"
" trtail Blank the tail of a track.n"
"n"
" unclose Unclose last session.n"
"n"
" session Blank the last session.n"
" If used together with the -force flag, this option may ben"
" used to blank CD-RW disks that otherwise cannot be blanked.n"
" Note that you may need to specify blank=all because somen"
" drives will not continue with certain types of bad CD-RWn"
" disks. Note also that cdecord does it's best if the -forcen"
" flag is used but it finally depends on the drive's firmwaren"
" whether the blanking operation will succeed or not.n"
"n"
" fs=# Set the fifo (ring buffer) size to #. You may use then"
" same method as in dd(1), sdd(1) or star(1). The numbern"
" representing the size is taken in bytes unless other-n"
" wise specified. If a number is followed directly byn"
" the letter `b', `k', `m', `s' of `f', the size is mul-n"
" tiplied by 512, 1024, 1024*1024, 2048 or 2352. If then"
" size consists of numbers separated by `x' or `*', mul-n"
" tiplication of the two numbers is performed. Thusn"
" fs=10x63k will specify a fifo size of 630 kBytes.n"
"n"
" The size specified by the fs= argument includes then"
" shared memory that is needed for administration. Thisn"
" is at least one page of memory. If no fs= option isn"
" present, cdrecord will try to get the fifo size valuen"
" from the CDR_FIFOSIZE environment. The default fifon"
" size is currently 4 MB.n"
"n"
" The fifo is used to increase buffering for the realn"
" time writing process. It allows to run a pipe fromn"
" mkisofs directly into cdrecord. If the fifo is activen"
" and a pipe from mkisofs into cdrecord is used to createn"
" a CD, cdrecord will abort prior to do any modificationsn"
" on the disk if mkisofs dies before it starts writing.n"
" The recommended fifo size is between 4 and 32 MBytes.n"
" As a rule of thumb, the fifo size should be at leastn"
" equal to the size of the internal buffer of the CD-n"
" Recorder and no more than half of the physical amountn"
" of RAM available in the machine. If the fifo size isn"
" big enough, the fifo statistics will print a fifo emptyn"
" count of zero and the fifo min fill is not below 20%.n"
" It is not wise to use too much space for the fifo. Ifn"
" you need more than 8 MB to write a CD on an idlen"
" machine, your machine is either underpowered, hasn"
" hardware problems or is mis-configured. The sun4cn"
" architecture (e.g. a Sparcstation-2) has only MMU pagen"
" table entries for 16 MBytes per process. Using moren"
" than 14 MBytes for the fifo may cause the operatingn"
" system in this case to spend much time to constantlyn"
" reload the MMU tables. Newer machines from Sun do notn"
" have this MMU hardware problem. I have no informationn"
" on PC-hardware reflecting this problem.n"
"n"
" If you have buffer underruns or similar problems andn"
" observe a zero fifo empty count, you have hardwaren"
" problems. The fifo size in this case is sufficient.n"
"n"
" dev=targetn"
" Sets the SCSI target for the CD-Recorder, see notesn"
" above. A typical device specification is dev=6,0 . Ifn"
" a filename must be provided together with the numericaln"
" target specification, the filename is implementationn"
" specific. The correct filename in this case can ben"
" found in the system specific manuals of the targetn"
" operating system. On a FreeBSD system without CAM sup-n"
" port, you need to use the control device (e.g.n"
" /dev/rcd0.ctl). A correct device specification in thisn"
" case may be dev=/dev/rcd0.ctl:@ .n"
"n"
" On Linux, drives connected to a parallel port adaptern"
" are mapped to a virtual SCSI bus. Different adaptersn"
" are mapped to different targets on this virtual SCSIn"
" bus.n"
"n"
" If no dev option is present, cdrecord will try to getn"
" the device from the CDR_DEVICE environment.n"
"n"
" If the argument to the dev= option does not contain then"
" characters ',', '/', '@' or ':', it is interpreted asn"
" an label name that may be found in the filen"
" /etc/default/cdrecord (see FILES section).n"
"n"
" timeout=#n"
" Set the default SCSI command timeout value to #n"
" seconds. The default SCSI command timeout is then"
" minimum timeout used for sending SCSI commands. If an"
" SCSI command fails due to a timeout, you may try ton"
" raise the default SCSI command timeout above then"
" timeout value of the failed command. If the commandn"
" runs correctly with a raised command timeout, pleasen"
" report the better timeout value and the correspondingn"
" command to the author of the program. If no timeoutn"
" option is present, a default timeout of 40 seconds isn"
" used.n"
"n"
" driver=namen"
" Allows to use a user supplied driver name for the dev-n"
" ice. To get a list of possible drivers usen"
" driver=help. The reason for the existence of thisn"
" option is to allow users to use cdrecord with drivesn"
" that are similar to supported drives but not knownn"
" directly by cdrecord. Use this option with extremen"
" care. If a wrong driver is used for a device, the pos-n"
" sibility of creating corrupted disks is high. Then"
" minimum problem related to a wrong driver is that then"
" -speed or -dummy will not work.n"
"n"
" There are two special driver entries in the list:n"
" cdr_simul and dvd_simul. These driver entries aren"
" designed to make timing tests at any speed or timingn"
" tests for drives that do not support the -dummy option.n"
" The simulation drivers implement a drive with a buffern"
" size of 1MB that can be changed via then"
" CDR_SIMUL_BUFSIZE environment variable. The simulationn"
" driver correctly simulates even a buffer underrun con-n"
" dition. If the -dummy option is present, the simula-n"
" tion is not aborted in case of a buffer underrun.n"
"n"
" driveropts=option listn"
" Set driver specific options. The options are specifiedn"
" a comma separated list. To get a list of valid optionsn"
" use driveropts=help together with the -checkdriven"
" option. Currently only the burnproof option is imple-n"
" mented to support Buffer Underrun Proof writing withn"
" drives that use the Sanyo BURN-Proof technology.n"
"n"
" -checkdriven"
" Checks if a driver for the current drive is present andn"
" exit. If the drive is a known drive, cdrecord usesn"
" exit code 0.n"
"n"
" -prcapn"
" Print the drive capabilities for SCSI-3/mmc compliantn"
" drives as obtained from mode page 0x2A. Values markedn"
" with kB use 1000 bytes as kilo-byte, values marked withn"
" KB use 1024 bytes as Kilo-byte.n"
"n"
" -inq Do an inquiry for the drive, print the inquiry info andn"
" exit.n"
"n"
" -scanbusn"
" Scan all SCSI devices on all SCSI busses and print then"
" inquiry strings. This option may be used to find SCSIn"
" address of the CD-Recorder on a system. The numbersn"
" printed out as labels are computed by: bus * 100 + tar-n"
" getn"
"n"
" -resetn"
" Try to reset the SCSI bus where the CD recorder isn"
" located. This works not on all operating systems.n"
"n"
" -ignsizen"
" Ignore the known size of the medium. This optionsn"
" should be used with extreme care, it exists only forn"
" debugging purposes don't use it for other reasons. Itn"
" is not needed to write disks with more than the nominaln"
" capacity.n"
"n"
" -useinfon"
" Use *.inf files to overwrite audio options. If thisn"
" option is used, the pregap size information is readn"
" from the *.inf file that is associated with the filen"
" that contains the audio data for a track.n"
"n"
" defpregap=#n"
" Set the default pre-gap size for all tracks exceptn"
" track number 1. This option currently only makes sensen"
" with the TEAC drive when creating track-at-once disksn"
" without the 2 second silence before each track.n"
" This option may go away in future.n"
"n"
" -packetn"
" Set Packet writing mode. This is an experimental inter-n"
" face.n"
"n"
" pktsize=#n"
" Set the paket size to #, forces fixed packet mode.n"
" This is an experimental interface.n"
"n"
" -noclosen"
" Do not close the current track, useful only when inn"
" packet writing mode. This is an experimental inter-n"
" face.n"
"n"
" mcn=med_cat_nrn"
" Set the Media Catalog Number of the CD to med_cat_nr.n"
"n"
"TRACK OPTIONSn"
" Track options may be mixed with track file names.n"
"n"
" isrc=ISRC_numbern"
" Set the International Standard Recording Number for then"
" next track to ISRC_number.n"
"n"
" index=listn"
" Sets an index list for the next track. In index listn"
" is a comma separated list of numbers that are countingn"
" from index 1. The first entry in this list must containn"
" a 0, the following numbers must be an ascending list ofn"
" numbers (counting in 1/75 seconds) that represent then"
" start of the indices. An index list in the form:n"
" 0,7500,15000 sets index 1 to the start of the track,n"
" index 2 100 seconds from the start of the track andn"
" index 3 200 seconds from the start of the track.n"
"n"
" -audion"
" If this flag is present, all subsequent tracks aren"
" written in CD-DA (similar to Red Book) audio format.n"
" The file with data for this tracks should containn"
" stereo, 16-bit digital audio with 44100 samples/s. Then"
" byte order should be the following: MSB left, LSB left,n"
" MSB right, LSB right, MSB left and so on. The trackn"
" should be a multiple of 2352 bytes. It is not possiblen"
" to put the master image of an audio track on a raw diskn"
" because data will be read in multiple of 2352 bytesn"
" during the recording process.n"
"n"
" If a filename ends in .au or .wav the file is con-n"
" sidered to be a structured audio data file. Cdrecordn"
" assumes that the file in this case is a Sun audio filen"
" or a Microsoft .WAV file and extracts the audio datan"
" from the files by skipping over the non-audio headern"
" information. In all other cases, cdrecord will onlyn"
" work correctly if the audio data stream does not haven"
" any header. Because many structured audio files do notn"
" have an integral number of blocks (1/75th second) inn"
" length, it is often necessary to specify the -padn"
" option as well. cdrecord recognizes that audio data inn"
" a .WAV file is stored in Intel (little-endian) byten"
" order, and will automatically byte-swap the data if then"
" CD recorder requires big-endian data. Cdrecord willn"
" reject any audio file that does not match the Red Bookn"
" requirements of 16-bit stereo samples in PCM coding atn"
" 44100 samples/second.n"
"n"
" Using other structured audio data formats as input ton"
" cdrecord will usually work if the structure of the datan"
" is the structure described above (raw pcm data in big-n"
" endian byte order). However, if the data formatn"
" includes a header, you will hear a click at the startn"
" of a track.n"
"n"
" If neither -data nor -audio have been specified,n"
" cdrecord defaults to -audio for all filenames that endn"
" in .au or .wav and to -data for all other files.n"
"n"
" -swabn"
" If this flag is present, audio data is assumed to be inn"
" byte-swapped (little-endian) order. Some types of CD-n"
" Writers e.g. Yamaha, Sony and the new SCSI-3/mmc drivesn"
" require audio data to be presented in little-endiann"
" order, while other writers require audio data to ben"
" presented in the big-endian (network) byte order nor-n"
" mally used by the SCSI protocol. Cdrecord knows if an"
" CD-Recorder needs audio data in big- or little-endiann"
" order, and corrects the byte order of the data streamn"
" to match the needs of the recorder. You only need then"
" -swab flag if your data stream is in Intel (little-n"
" endian) byte order.n"
"n"
" Note that the verbose output of cdrecord will show youn"
" if swapping is necessary to make the byte order of then"
" input data fit the required byte order of the recorder.n"
" Cdrecord will not show you if the -swab flag was actu-n"
" ally present for a track.n"
"n"
" -datan"
" If this flag is present, all subsequent tracks aren"
" written in CD-ROM mode 1 (Yellow Book) format. The datan"
" is a multiple of 2048 bytes. The file with track datan"
" should contain an ISO-9660 or Rock Ridge filesystemn"
" image (see mkisofs for more details). If the track datan"
" is an ufs filesystem image, fragment size should be setn"
" to 2 KB or more to allow CR-drives with 2 KB sectorn"
" size to to be used for reading.n"
"n"
" -data is the default, if no other flag is present.n"
"n"
" If neither -data nor -audio have been specified,n"
" cdrecord defaults to -audio for all filenames that endn"
" in .au or .wav and to -data for all other files.n"
"n"
" -mode2n"
" If this flag is present, all subsequent tracks aren"
" written in CD-ROM mode 2 format. The data is a multiplen"
" of 2048 bytes.n"
"n"
" -xa1 If this flag is present, all subsequent tracks aren"
" written in CD-ROM XA mode 1 format. The data is a mul-n"
" tiple of 2048 bytes.n"
"n"
" -xa2 If this flag is present, all subsequent tracks aren"
" written in CD-ROM XA mode 2 format. The data is a mul-n"
" tiple of 2048 bytes.n"
"n"
" -cdi If this flag is present, all subsequent tracks aren"
" written in CDI format. The data is a multiple of 2048n"
" bytes.n"
"n"
" -isosizen"
" Use the ISO-9660 file system size as the size of then"
" next track. This option is needed if you want to readn"
" the image of a track from a raw disk partition or on an"
" master CD. In the first case the option -isosize isn"
" needed to limit the size of the CD to the size of then"
" ISO filesystem. In the second case the option -isosizen"
" is needed to prevent cdrecord from reading the two runn"
" out blocks that are appended by each CD-recorder inn"
" track at once mode. These two run out blocks cannot ben"
" read and would cause a buffer under run that wouldn"
" cause a defective copy. Do not use this option ifn"
" cdrecord reads the track data from stdin. This optionn"
" currently cannot be used to determine the size of an"
" file system if the multi session option is present.n"
"n"
" -pad If the track is a data track, 15 sectors of zeroed datan"
" will be added to the end of this and each subsequentn"
" data track. In this case, the -pad option is super-n"
" seded by the padsize= option. It will remain however asn"
" a shorthand for padsize=15s. If the -pad option refersn"
" to an audio track, cdrecord will pad the audio data ton"
" be a multiple of 2352 bytes. The audio data padding isn"
" done with binary zeroes which is equal to absoluten"
" silence.n"
"n"
" -pad remains valid until disabled by -nopad.n"
"n"
" padsize=#n"
" Set the amount of data to be appended as padding to then"
" next track to #. Opposed to the behavior of the -padn"
" option, the value for padsize= is reset to zero forn"
" each new track. See fs= option for possible arguments.n"
" Use this option if your CD-drive is not able to readn"
" the last sectors of a track or if you want to be ablen"
" to read the CD on a Linux system with the ISO-9660n"
" filesystem read ahead bug. If an empty file is usedn"
" for track data, this option may be used to create an"
" disk that is entirely made of padding.n"
"n"
" -nopadn"
" Do not pad the following tracks - the default.n"
"n"
" -shorttrackn"
" Allow all subsequent tracks to violate the Read Bookn"
" track length standard which requires a minimum trackn"
" length of 4 seconds. This option is only useful whenn"
" used in DAO mode. Not all drives support this feature.n"
" The drive must be accept the resulting CUE sheet.n"
"n"
" -noshorttrackn"
" Re-enforce the Red Book track length standard. Tracksn"
" must be at least 4 seconds.n"
"n"
" pregap=#n"
" Set the pre-gap size for the next track. This optionn"
" currently only makes sense with the TEAC drive whenn"
" creating track-at-once disks without the 2 secondn"
" silence before each track.n"
" This option may go away in future.n"
"n"
" -preempn"
" If this flag is present, all TOC entries for subsequentn"
" audio tracks will indicate that the audio data has beenn"
" sampled with 50/15 祍ec preemphasis. The data, howevern"
" is not modified during the process of transferring fromn"
" file to disk. This option has no effect on data tracks.n"
"n"
" -nopreempn"
" If this flag is present, all TOC entries for subsequentn"
" audio tracks will indicate that the audio data has beenn"
" mastered with linear data - this is the default.n"
"n"
" tsize=#n"
" If the master image for the next track has been storedn"
" on a raw disk, use this option to specify the validn"
" amount of data on this disk. If the image of the nextn"
" track is stored in a regular file, the size of thatn"
" file is taken to determine the length of this track.n"
" If the track contains an ISO 9660 filesystem image usen"
" the -isosize option to determine the length of thatn"
" filesystem image.n"
" In Disk at Once mode and with some drives that use then"
" TEAC programming interface, even in Track at Once mode,n"
" cdrecord needs to know the size of each track beforen"
" starting to write the disk. Cdrecord now checks thisn"
" and aborts before starting to write. If this happensn"
" you will need to run mkisofs -print-size before and usen"
" the output as an argument to the tsize= option ofn"
" cdrecord.n"
" See fs= option for possible arguments.n"
"n"
"EXAMPLESn"
" For all examples below, it will be assumed that the CD-n"
" Recorder is connected to the primary SCSI bus of then"
" machine. The SCSI target id is set to 2.n"
"n"
" To record a pure CD-ROM at double speed, using data from then"
" file cdimage.raw:n"
"n"
" cdrecord -v speed=2 dev=2,0 cdimage.rawn"
"n"
" To create an image for a ISO 9660 filesystem with Rock Ridgen"
" extensions:n"
"n"
" mkisofs -R -o cdimage.raw /home/joerg/master/treen"
"n"
" To check the resulting file before writing to CD on Solaris:n"
"n"
" mount -r -F fbk -o type=hsfs /dev/fbk0:cdimage.raw /mntn"
"n"
" On Linux:n"
"n"
" mount cdimage.raw -r -t iso9660 -o loop /mntn"
"n"
" Go on with:n"
" ls -lR /mntn"
" umount /mntn"
"n"
" If the overall speed of the system is sufficient and then"
" structure of the filesystem is not too complex, cdrecordn"
" will run without creating an image of the ISO 9660 filesys-n"
" tem. Simply run the pipeline:n"
"n"
" mkisofs -R /master/tree | cdrecord -v fs=6m speed=2n"
" dev=2,0 -n"
"n"
" The recommended minimum fifo size for running this pipelinen"
" is 4 MBytes. As the default fifo size is 4 MB, the fs=n"
" option needs only be present if you want to use a differentn"
" fifo size. If your system is loaded, you should run mkisofsn"
" in the real time class too. To raise the priority ofn"
" mkisofs replace the commandn"
"n"
" mkisofs -R /master/treen"
" byn"
" priocntl -e -c RT -p 59 mkisofs -R /master/treen"
"n"
" on Solaris and byn"
"n"
" nice --18 mkisofs -R /master/treen"
"n"
" on systems that don't have UNIX International compliantn"
" realtime scheduling.n"
" Cdrecord runs at priority 59 on Solaris, you should runn"
" mkisofs at no more than priority 58. On other systems, youn"
" should run mkisofs at no less than nice --18.n"
"n"
" Creating a CD-ROM without file system image on disk has beenn"
" tested on a Sparcstation-2 with a Yamaha CDR-400. It didn"
" work up to quad speed when the machine was not loaded. An"
" faster machine may be able to handle quad speed also in then"
" loaded case.n"
"n"
" To record a pure CD-DA (audio) at single speed, with eachn"
" track contained in a file named track01.cdaudio,n"
" track02.cdaudio, etc:n"
"n"
" cdrecord -v speed=1 dev=2,0 -audio track*.cdaudion"
"n"
" To check if it will be ok to use double speed for the exam-n"
" ple above. Use the dummy write option:n"
"n"
" cdrecord -v -dummy speed=2 dev=2,0 -audio track*.cdaudion"
"n"
" To record a mixed-mode CD with an ISO 9660 filesystem fromn"
" cdimage.raw on the first track, the other tracks being audion"
" tracks from the files track01.cdaudio, track02.cdaudio, etc:n"
"n"
" cdrecord -v -dummy dev=2,0 cdimage.raw -audion"
" track*.cdaudion"
"n"
" To handle drives that need to know the size of a trackn"
" before starting to write, first runn"
"n"
" mkisofs -R -q -print-size /master/treen"
"n"
" and then runn"
"n"
" mkisofs -R /master/tree | cdrecord speed=2 dev=2,0n"
" tsize=XXXs -n"
"n"
" where XXX is replaced by the output of the previous run ofn"
" mkisofs.n"
"n"
" To copy an audio CD in the most accurate way, first runn"
"n"
" cdda2wav -v255 -D2,0 -B -Owavn"
"n"
" and then runn"
"n"
" cdrecord -v dev=2,0 -dao -useinfo *.wavn"
"n"
"ENVIRONMENTn"
" CDR_DEVICEn"
" This may either hold a device identifier that isn"
" suitable to the open call of the SCSI transport libraryn"
" or a label in the file /etc/default/cdrecord.n"
"n"
" CDR_SPEEDn"
" Sets the default speed value for writing (see alson"
" -speed option).n"
"n"
" CDR_FIFOSIZEn"
" Sets the default size of the FIFO (see also fs=#n"
" option).n"
"n"
"FILESn"
" /etc/default/cdrecordn"
" Default values can be set for the following options inn"
" /etc/default/cdrecord. For example: CDR_FIFOSIZE=8mn"
" or CDR_SPEED=2n"
"n"
" CDR_DEVICEn"
" This may either hold a device identifier that isn"
" suitable to the open call of the SCSI transportn"
" library or a label in the filen"
" /etc/default/cdrecord that allows to identify an"
" specific drive on the system.n"
"n"
" CDR_SPEEDn"
" Sets the default speed value for writing (see alson"
" -speed option).n"
"n"
" CDR_FIFOSIZEn"
" Sets the default size of the FIFO (see also fs=#n"
" option).n"
"n"
" Any other labeln"
" is an identifier for a specific drive on the sys-n"
" tem. Such an identifier may not contain the char-n"
" acters ',', '/', '@' or ':'.n"
"n"
" Each line that follows a label contains a TABn"
" separated list of items. Currently, three itemsn"
" are recognized: the SCSI ID of the drive, then"
" default speed that should be used for this driven"
" and the default FIFO size that should be used forn"
" this drive. The values for speed and fifosize mayn"
" be set to -1 to tell cdrecord to use the globaln"
" defaults. A typical line may look this way:n"
"n"
" teac1= 0,5,0 4 8mn"
"n"
" yamaha= 1,6,0 -1 -1n"
"n"
" This tells cdrecord that a drive named teac1 is atn"
" scsibus 0, target 5, lun 0 and should be used withn"
" speed 4 and a FIFO size of 8 MB. A second driven"
" may be found at scsibus 1, target 6, lun 0 andn"
" uses the default speed and the default FIFO size.n"
"n"
"SEE ALSOn"
" cdda2wav(1), readcd(1), scg(7), fbk(7), mkisofs(8).n"
"n"
"NOTESn"
" On Solaris you need to stop the volume management if youn"
" like to use the USCSI fallback SCSI transport code. Evenn"
" things like cdrecord -scanbus will not work if the volumen"
" management is running.n"
"n"
" Disks made in Track At Once mode are not suitable as a mas-n"
" ter for direct mass production by CD manufacturers. Youn"
" will need the disk at once option to record such disks.n"
" Nevertheless the disks made in Track At Once will normallyn"
" be read in all CD players. Some old audio CD players howevern"
" may produce a two second click between two audio tracks.n"
"n"
" The minimal size of a track is 4 seconds or 300 sectors. Ifn"
" you write smaller tracks, the CD-Recorder will add dummyn"
" blocks. This is not an error, even though the SCSI-errorn"
" message looks this way.n"
"n"
" Cdrecord has been tested on an upgraded Philips CDD-521n"
" recorder at single and double speed on a SparcStation 20/502n"
" with no problems, slower computer systems should work also.n"
" The newer Philips/HP/Plasmon/Grundig drives as well asn"
" Yamaha CDR-100 and CDR-102 work also. The Plasmon RF-4100n"
" work, but has not tested in multi session. A Philips CDD-n"
" 521 that has not been upgraded will not work. The Sonyn"
" CDU-924 has been tested, but does not support XA-mode2 inn"
" hardware. The sony therefore cannot create conforming multin"
" session disks. The Ricoh RO-1420C works, but some peoplen"
" seem to have problems to use them with speed=2, try speed=0n"
" in this case.n"
"n"
" The Yamaha CDR-400 and all new SCSI-3/mmc conforming drivesn"
" are supported in single and multi-session.n"
"n"
" You should run several tests in all supported speeds of yourn"
" drive with the -dummy option turned on if you are usingn"
" cdrecord on an unknown system. Writing a CD is a realtimen"
" process. NFS will not always deliver constantly the neededn"
" data rates. If you want to use cdrecord with CD-images thatn"
" are located on a NFS mounted filesystem, be sure that then"
" fifo size is big enough. I used cdrecord with with mediumn"
" load on a SS20/502 and even at quad speed on an"
" Sparcstation-2 which was heavily loaded, but it is recom-n"
" mended to leave the system as lightly loaded as possiblen"
" while writing a CD. If you want to make sure that buffern"
" underrungs are not caused by your source disk, you may usen"
" the commandn"
"n"
" cdrecord -dummy dev=2,0 padsize=600m /dev/nulln"
"n"
" to create a disk that is entirely made of dummy data.n"
" Cdrecord needs to run as root to get access to the /dev/scg?n"
" device nodes and to be able to lock itself into memory.n"
"n"
" If you don't want to allow users to become root on your sys-n"
" tem, cdrecord may safely be installed suid root. This allowsn"
" all users or a group of users with no root privileges to usen"
" cdrecord. Cdrecord in this case checks, if the real usern"
" would have been able to read the specified files. To given"
" all user access to use cdrecord, enter:n"
"n"
" chown root /usr/local/bin/cdrecordn"
" chmod 4711 /usr/local/bin/cdrecordn"
"n"
" To give a restricted group of users access to cdrecordn"
" enter:n"
"n"
" chown root /usr/local/bin/cdrecordn"
" chgrp cdburners /usr/local/bin/cdrecordn"
" chmod 4710 /usr/local/bin/cdrecordn"
"n"
" and add a group cdburners on your system.n"
"n"
" Never give write permissions for non root users to then"
" /dev/scg? devices unless you would allow anybody ton"
" read/write/format all your disks.n"
"n"
" You should not connect old drives that do not supportn"
" disconnect/reconnect to either the SCSI bus that is con-n"
" nected to the CD-Recorder or the source disk.n"
"n"
" A Compact Disc can have no more than 99 tracks.n"
"n"
" When creating a disc with both audio and data tracks, then"
" data should be on track 1 otherwise you should create an"
" CDplus disk which is a multi session disk with the firstn"
" session containing the audio tracks and the following ses-n"
" sion containing the data track.n"
"n"
" Many operating systems are not able to read more than a sin-n"
" gle data track, or need special software to do so.n"
"n"
" More information on the SCSI command set of a HP CD-Recordern"
" can be found at:n"
" http://www.hp.com/isgsupport/cdr/index.htmln"
"n"
" If you have more information or SCSI command manuals forn"
" currently unsupported CD-Recorders please contact then"
" author.n"
"n"
" The Philips CDD 521 CD-Recorder (even in the upgraded ver-n"
" sion) has several firmware bugs. Some of them will force youn"
" to power cycle the device or to reboot the machine.n"
"n"
" When using cdrecord with the broken Linux SCSI genericn"
" driver. You should note that cdrecord uses a hack, thatn"
" tries to emulate the functionality of the scg driver.n"
" Unfortunately, the sg driver on Linux has several severen"
" bugs:n"
"n"
" o It cannot see if a SCSI command could not be sent atn"
" all.n"
"n"
" o It cannot get the SCSI status byte. Cdrecord for thatn"
" reason cannot report failing SCSI commands in somen"
" situations.n"
"n"
" o It cannot get real DMA count of transfer. Cdrecord can-n"
" not tell you if there is an DMA residual count.n"
"n"
" o It cannot get number of bytes valid in auto sense data.n"
" Cdrecord cannot tell you if device transfers no sensen"
" data at all.n"
"n"
" o It fetches to few data in auto request sensen"
" (CCS/SCSI-2/SCSI-3 needs >= 18).n"
"n"
" The fifo percent output is computed just after a block ofn"
" data has been written to the CD-Recorder. For this reason,n"
" there will never be 100% fifo fill, while the fifo is inn"
" streaming mode.n"
"n"
"DIAGNOSTICSn"
" You have 9 seconds to type ^C to abort cdrecord after youn"
" see the message:n"
"n"
" Starting to write CD at speed %d in %s mode for %s session.n"
"n"
" A typical error message for a SCSI command looks like:n"
"n"
" cdrecord: I/O error. test unit ready: scsi sendcmd: no errorn"
" CDB: 00 20 00 00 00 00n"
" status: 0x2 (CHECK CONDITION)n"
" Sense Bytes: 70 00 05 00 00 00 00 0A 00 00 00 00 25 00 00 00 00 00n"
" Sense Key: 0x5 Illegal Request, Segment 0n"
" Sense Code: 0x25 Qual 0x00 (logical unit not supported) Fru 0x0n"
" Sense flags: Blk 0 (not valid)n"
" cmd finished after 0.002s timeout 40sn"
"n"
" The first line gives information about the transport of then"
" command. The text after the first colon gives the errorn"
" text for the system call from the view of the kernel. Itn"
" usually is: I/O error unless other problems happen. Then"
" next words contain a short description for the SCSI commandn"
" that fails. The rest of the line tells you if there were anyn"
" problems for the transport of the command over the SCSI bus.n"
" fatal error means that it was not possible to transport then"
" command (i.e. no device present at the requested SCSIn"
" address).n"
"n"
" The second line prints the SCSI command descriptor block forn"
" the failed command.n"
"n"
" The third line gives information on the SCSI status coden"
" returned by the command, if the transport of the commandn"
" succeeds. This is error information from the SCSI device.n"
"n"
" The fourth line is a hex dump of the auto request sensen"
" information for the command.n"
"n"
" The fifth line is the error text for the sense key if avail-n"
" able, followed by the segment number that is only valid ifn"
" the command was a copy command. If the error message is notn"
" directly related to the current command, the text deferredn"
" error is appended.n"
"n"
" The sixth line is the error text for the sense code and then"
" sense qualifier if available. If the type of the device isn"
" known, the sense data is decoded from tables in scsierrs.c .n"
" The text is followed by the error value for a field replace-n"
" able unit.n"
"n"
" The seventh line prints the block number that is related ton"
" the failed command and text for several error flags. Then"
" block number may not be valid.n"
"n"
" The eight line reports the timeout set up for this commansn"
" and the time that the command realy needed to be finished.n"
"n"
" The following message is not an error:n"
" Track 01: Total bytes read/written: 2048/2048 (1 sectors).n"
" cdrecord: I/O error. flush cache: scsi sendcmd: no errorn"
" CDB: 35 00 00 00 00 00 00 00 00 00n"
" status: 0x2 (CHECK CONDITION)n"
" Sense Bytes: F0 00 05 80 00 00 27 0A 00 00 00 00 B5 00 00 00 00 00n"
" Sense Key: 0x5 Illegal Request, Segment 0n"
" Sense Code: 0xB5 Qual 0x00 (dummy data blocks added) Fru 0x0n"
" Sense flags: Blk -2147483609 (valid)n"
" cmd finished after 0.002s timeout 40sn"
"n"
" It simply notifies, that a track that is smaller than then"
" minimum size has been expanded to 300 sectors.n"
"n"
"BUGSn"
" Cdrecord has even more options than ls.n"
"n"
" Cdrecord currently only warns if the input data will not fitn"
" on the disk. If you don't abort the command you will getn"
" unpredictable results.n"
"n"
" There should be an option to write index numbers for audion"
" tracks.n"
"n"
" There should be a recover option to make disks usable, thatn"
" have been written during a power failure.n"
"n"
"CREDITSn"
" Bill Swartz (Bill_Swartz@twolf.com)n"
" For helping me with the TEAC driver supportn"
"n"
" Aaron Newsome (aaron.d.newsome@wdc.com)n"
" For letting me develop Sony support on hisn"
" driven"
"n"
" Eric Youngdale (eric@andante.jic.com)n"
" For supplying mkisofsn"
"n"
" Gadi Oxman (gadio@netvision.net.il)n"
" For tips on the ATAPI standardn"
"n"
" Finn Arne Gangstad (finnag@guardian.no)n"
" For the first FIFO implementation.n"
"n"
" Dave Platt (dplatt@feghoot.ml.org)n"
" For creating the experimental packet writingn"
" support, the first implementation of CD-RWn"
" blanking support, the first .wav file decodern"
" and many nice discussions on cdrecord.n"
"n"
" Chris P. Ross (cross@eng.us.uu.net)n"
" For the first implementation os a BSDI SCSIn"
" rtansport.n"
"n"
" Grant R. Guenther (grant@torque.net)n"
" For creating the first parallel port tran-n"
" sport implementation for Linux.n"
"n"
" Kenneth D. Merry (ken@kdm.org)n"
" for providing the CAM port for FreeBSDn"
" together with Michael Smithn"
" (msmith@freebsd.org)n"
"n"
"MAILING LISTSn"
" If you want to actively take part on the development ofn"
" cdrecord, you may join the cdwriting mailing list by sendingn"
" 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"
"n"
" other-cdwrite@lists.debian.orgn"
"n"
"AUTHORn"
" Joerg Schillingn"
" Seestr. 110n"
" D-13353 Berlinn"
" Germanyn"
"n"
" Additional information can be found on:n"
" http://www.fokus.gmd.de/usr/schilling/cdrecord.htmln"
"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 fbHelpMkisofsText[] =
"NAMEn"
" mkisofs - create an hybrid ISO9660/JOLIET/HFS filesystemn"
" with optional Rock Ridge attributes.n"
"n"
"SYNOPSISn"
" mkisofs [ -abstract FILE ] [ -allow-lowercase ] [ -allow-n"
" multidot ] [ -biblio FILE ] [ -cache-inodes ] [ -no-cache-n"
" inodes ] [ -b eltorito_boot_image ] [ -eltorito-alt-boot ] [n"
" -B sparc_boot_image_list ] [ -G generic_boot_image ] [ -guin"
" ] [ -C #,# ] [ -hard-disk-boot ] [ -no-emul-boot ] [ -no-n"
" boot ] [ -boot-load-seg ] [ -boot-load-size ] [ -boot-info-n"
" table ] [ -c boot_catalog ] [ -check-oldnames ] [ -check-n"
" session FILE ] [ -copyright FILE ] [ -A application_id ] [n"
" -f ] [ -d ] [ -D ] [ -dir-mode mode ] [ -file-mode mode ] [n"
" -gid gid ] [ -hide glob ] [ -hide-list file ] [ -hidden globn"
" ] [ -hidden-list file ] [ -hide-joliet glob ] [ -hide-n"
" joliet-list file ] [ -hide-joliet-trans-tbl ] [ -hide-rr-n"
" moved ] [ -iso-level level ] [ -input-charset charset ] [n"
" -output-charset charset ] [ -J ] [ -jcharset charset ] [ -ln"
" ] [ -L ] [ -log-file log_file ] [ -max-iso9660-filenames ] [n"
" -M path | device ] [ -new-dir-mode mode ] [ -nobak ] [ -no-n"
" bak ] [ -no-split-symlink-components ] [ -no-split-symlink-n"
" fields ] [ -pad ] [ -no-pad ] [ -path-list file ] [ -pn"
" preparer ] [ -print-size ] [ -P publisher ] [ -quiet ] [ -rn"
" ] [ -R ] [ -relaxed-filenames ] [ -sort sort file ] [ -sysidn"
" ID ] [ -T | -table-name TABLE_NAME ] [ -ucs-level level ] [n"
" -uid uid ] [ -use-fileversion ] [ -U ] [ -no-iso-translate ]n"
" [ -v ] [ -V volid ] [ -volset ID ] [ -volset-size # ] [n"
" -volset-seqno # ] [ -x path ] [ -exclude-list file ] [ -z ]n"
" [ -m glob ] [ -hfs | -apple ] [ -map mapping_file ] [ -magicn"
" magic_file ] [ -probe ] [ -no-desktop ] [ -mac-name ] [n"
" -boot-hfs-file driver_file [ -part ] [ -auto AutoStart_filen"
" ] [ -cluster-size size ] [ -hide-hfs glob ] [ -hide-hfs-listn"
" file ] [ -hfs-volid hfs_volid ] [ -icon-position ] [ -root-n"
" info FILE [ -prep-boot FILE ] [ -hfs-creator CREATOR ] [n"
" -hfs-type TYPE ] [ -input-hfs-charset charset ] [ -output-n"
" hfs-charset charset ] [ -hfs-unlock ] [ -hfs-blessn"
" folder_name ] [ --cap ] [ --netatalk ] [ --double ] [ --n"
" ethershare ] [ --ushare ] [ --exchange ] [ --sgi ] [ --xinetn"
" ] [ --macbin ] [ --single ] [ --dave ] [ --sfm ] -o filenamen"
" pathspec [pathspec]n"
"n"
"DESCRIPTIONn"
" mkisofs is effectively a pre-mastering program to generaten"
" an ISO9660/JOLIET/HFS hybrid filesystem.n"
"n"
" mkisofs is capable of generating the System Use Sharing Pro-n"
" tocol records (SUSP) specified by the Rock Ridge Interchangen"
" Protocol. This is used to further describe the files in then"
" iso9660 filesystem to a unix host, and provides informationn"
" such as longer filenames, uid/gid, posix permissions, sym-n"
" bolic links, block and character devices.n"
" If Joliet or HFS hybrid command line options are specified,n"
" mkisofs will create additional filesystem meta data forn"
" Joliet or HFS. The file content in this case refers to then"
" same data blocks on the media. It will generate a puren"
" ISO9660 filesystem unless the Joliet or HFS hybrid commandn"
" line options are given.n"
"n"
" mkisofs can generate a true (or shared) HFS hybrid filesys-n"
" tem. The same files are seen as HFS files when accessed fromn"
" a Macintosh and as ISO9660 files when accessed from othern"
" machines. HFS stands for Hierarchical File System and is then"
" native file system used on Macintosh computers.n"
"n"
" As an alternative, mkisofs can generate the Apple Entensionsn"
" to ISO9660 for each file. These extensions provide each filen"
" with CREATOR, TYPE and certain Finder Flags when accessedn"
" from a Macintosh. See the HFS MACINTOSH FILE FORMATS sectionn"
" below.n"
"n"
" mkisofs takes a snapshot of a given directory tree, and gen-n"
" erates a binary image which will correspond to an ISO9660 orn"
" HFS filesystem when written to a block device.n"
"n"
" Each file written to the iso9660 filesystem must have an"
" filename in the 8.3 format (8 characters, period, 3 charac-n"
" ters, all upper case), even if Rock Ridge is in use. Thisn"
" filename is used on systems that are not able to make use ofn"
" the Rock Ridge extensions (such as MS-DOS), and eachn"
" filename in each directory must be different from the othern"
" filenames in the same directory. mkisofs generally tries ton"
" form correct names by forcing the unix filename to uppern"
" case and truncating as required, but often times this yieldsn"
" unsatisfactory results when there are cases where the trun-n"
" cated names are not all unique. mkisofs assigns weightingsn"
" to each filename, and if two names that are otherwise then"
" same are found the name with the lower priority is renamedn"
" to have a 3 digit number as an extension (where the numbern"
" is guaranteed to be unique). An example of this would ben"
" the files foo.bar and foo.bar.~1~ - the file foo.bar.~1~n"
" would be written as FOO000.BAR;1 and the file foo.bar wouldn"
" be written as FOO.BAR;1n"
"n"
" When used with various HFS options, mkisofs will attempt ton"
" recognise files stored in a number of Apple/Unix file for-n"
" mats and will copy the data and resource forks as well asn"
" any relevant finder information. See the HFS MACINTOSH FILEn"
" FORMATS section below for more about formats mkisofs sup-n"
" ports.n"
"n"
" Note that mkisofs is not designed to communicate with then"
" writer directly. Most writers have proprietary command setsn"
" which vary from one manufacturer to another, and you need an"
" specialized tool to actually burn the disk.n"
"n"
" The cdrecord utility is a utility capable of burning ann"
" actual disc. The latest version of cdrecord is availablen"
" from ftp://ftp.fokus.gmd.de/pub/unix/cdrecordn"
"n"
" Also you should know that most cd writers are very particu-n"
" lar about timing. Once you start to burn a disc, you cannotn"
" let their buffer empty before you are done, or you will endn"
" up with a corrupt disc. Thus it is critical that you ben"
" able to maintain an uninterrupted data stream to the writern"
" for the entire time that the disc is being written.n"
"n"
" pathspec is the path of the directory tree to be copied inton"
" the iso9660 filesystem. Multiple paths can be specified,n"
" and mkisofs will merge the files found in all of the speci-n"
" fied path components to form the cdrom image.n"
"n"
" If the option -graft-points has been specified, it is possi-n"
" ble to graft the paths at points other than the root direc-n"
" tory, and it is possible to graft files or directories onton"
" the cdrom image with names different than what they have inn"
" the source filesystem. This is easiest to illustrate with an"
" couple of examples. Let's start by assuming that a localn"
" file ../old.lis exists, and you wish to include it in then"
" cdrom image.n"
"n"
" foo/bar/=../old.lisn"
"n"
" will include the file old.lis in the cdrom image atn"
" /foo/bar/old.lis, whilen"
"n"
" foo/bar/xxx=../old.lisn"
"n"
" will include the file old.lis in the cdrom image atn"
" /foo/bar/xxx. The same sort of syntax can be used withn"
" directories as well. mkisofs will create any directoriesn"
" required such that the graft points exist on the cdrom imagen"
" - the directories do not need to appear in one of the paths.n"
" By default, any directories that are created on the fly liken"
" this will have permissions 0555 and appear to be owned byn"
" the person running mkisofs. If you wish other permissionsn"
" or owners of the intermediate directories, see -uid, -gid,n"
" -dir-mode, -file-mode and -new-dir-mode.n"
"n"
" mkisofs will also run on Win9X/NT4 machines when compiledn"
" with Cygnus' cygwin (available fromn"
" http://sourceware.cygnus.com/cygwin/). Therefore most refer-n"
" ences in this man page to Unix can be replaced with Win32.n"
"n"
"OPTIONSn"
" -abstract FILEn"
" Specifies the abstract file name. This parameter cann"
" also be set in the file .mkisofsrc with ABST=filename.n"
" If specified in both places, the command line versionn"
" is used.n"
"n"
" -A application_idn"
" Specifies a text string that will be written into then"
" volume header. This should describe the applicationn"
" that will be on the disc. There is space on the discn"
" for 128 characters of information. This parameter cann"
" also be set in the file .mkisofsrc with APPI=id. Ifn"
" specified in both places, the command line version isn"
" used.n"
"n"
" -allow-lowercasen"
" This options allows lower case characters to appear inn"
" iso9660 filenames.n"
" This violates the ISO9660 standard, but it happens ton"
" work on some systems. Use with caution.n"
"n"
" -allow-multidotn"
" This options allows more than one dot to appear inn"
" iso9660 filenames. A leading dot is not affected byn"
" this option, it may be allowed separately using the -Ln"
" option.n"
" This violates the ISO9660 standard, but it happens ton"
" work on many systems. Use with caution.n"
"n"
" -biblio FILEn"
" Specifies the bibliographic file name. This parametern"
" can also be set in the file .mkisofsrc withn"
" BIBLO=filename. If specified in both places, the com-n"
" mand line version is used.n"
"n"
" -cache-inodesn"
" Cache inode and device numbers to find hard links ton"
" files. If mkisofs finds a hard link (a file with mul-n"
" tiple names), then the file will only appear once onn"
" the CD. This helps to save space on the CD. The optionn"
" -cache-inodes is default on UNIX like operating sys-n"
" tems. Be careful when using this option on a filesys-n"
" tem without unique inode numbers as it may result inn"
" files containing the wrong content on CD.n"
"n"
" -no-cache-inodesn"
" Do not cache inode and device numbers. This option isn"
" needed whenever a filesystem does not have unique inoden"
" numbers. It is the default on Cygwin. As the Microsoftn"
" operating system that runs below Cygwin is not POSIXn"
" compliant, it does not have unique inode numbers.n"
" Cygwin creates fake inode numbers from a hash algorithmn"
" that is not 100% correct. If mkisofs would cachen"
" inodes on Cygwin, it would believe that some files aren"
" identical although they are not. The result in thisn"
" case are files that contain the wrong content if a sig-n"
" nificant amount of different files (> ~5000) is inn"
" inside the tree that is to be archived. This does notn"
" happen when the -no-cache-inodes is used, but then"
" disadvantage mkisofs cannot detect hardlinks anymoren"
" and the resulting CD image may be larger than expected.n"
"n"
" -b eltorito_boot_imagen"
" Specifies the path and filename of the boot image to ben"
" used when making an "El Torito" bootable CD. The path-n"
" name must be relative to the source path specified ton"
" mkisofs. This option is required to make an "El Torito"n"
" bootable CD. The boot image must be exactly the sizen"
" of either a 1.2, 1.44, or a 2.88 meg floppy, andn"
" mkisofs will use this size when creating the outputn"
" iso9660 filesystem. It is assumed that the first 512n"
" byte sector should be read from the boot image (it isn"
" essentially emulating a normal floppy drive). Thisn"
" will work, for example, if the boot image is a LILOn"
" based boot floppy.n"
"n"
" -eltorito-alt-bootn"
" Start with a new set of "El Torito" boot parameters.n"
" This allows to have more than one El Torito boot on an"
" CD. A maximum of 63 El Torito boot entries may be putn"
" on a single CD.n"
"n"
" -B img_sun4,img_sun4c,img_sun4m,img_sun4d,img_sun4en"
" Specifies a comma separated list of boot images thatn"
" are needed to make a bootable CD for sparc systems.n"
" There may be empty fields in the comma separated list.n"
" This option is required to make a bootable CD for Sunn"
" sparc systems. If the -B or -sparc-boot option hasn"
" been specified, the first sector of the resulting imagen"
" will contain a Sun disk label. This disk label speci-n"
" fies slice 0 for the iso9660 image and slice 1 ...n"
" slice 7 for the boot images that have been specifiedn"
" with this option. Byte offset 512 ... 8191 within eachn"
" of the additional boot images must contain a primaryn"
" boot that works for the appropriate sparc architecture.n"
" The rest of each of the images usually contains an ufsn"
" filesystem that is used primary kernel boot stage.n"
"n"
" The implemented boot method is the boot method foundn"
" with SunOS 4.x and SunOS 5.x. However, it does notn"
" depend on SunOS internals but only on properties of then"
" Open Boot prom. For this reason, it should be usablen"
" for any OS that boots off a sparc system.n"
" If the special filename ... is used, the actual and alln"
" following boot partitions are mapped to the previousn"
" partition. If mkisofs is called with -G image -B ...n"
" all boot partitions are mapped to the partition thatn"
" contains the iso9660 filesystem image and the genericn"
" boot image that is located in the first 16 sectors ofn"
" the disk is used for all architectures.n"
"n"
" -G generic_boot_imagen"
" Specifies the path and filename of the generic bootn"
" image to be used when making a generic bootable CD.n"
" The generic_boot_image will be placed on the first 16n"
" sectors of the CD. The first 16 sectors are the sectorsn"
" that are located before the iso9660 primary volumen"
" descriptor. If this option is used together with then"
" -sparc-boot option, the Sun disk label will overlay then"
" first 512 bytes of the generic boot image.n"
"n"
" -hard-disk-bootn"
" Specifies that the boot image used to create "El Tor-n"
" ito" bootable CDs is a hard disk image. The hard diskn"
" image must begin with a master boot record that con-n"
" tains a single partition.n"
"n"
" -no-emul-bootn"
" Specifies that the boot image used to create "El Tor-n"
" ito" bootable CDs is a 'no emulation' image. The systemn"
" will load and execute this image without performing anyn"
" disk emulation.n"
"n"
" -no-bootn"
" Specifies that the created "El Torito" CD should ben"
" marked as not bootable. The system will provide an emu-n"
" lated drive for the image, but will boot off a standardn"
" boot device.n"
"n"
" -boot-load-seg segment_addressn"
" Specifies the load segment address of the boot imagen"
" for no-emulation "El Torito" CDs.n"
"n"
" -boot-load-size load_sectorsn"
" Specifies the number of "virtual" (512-byte) sectors ton"
" load in no-emulation mode. The default is to load then"
" entire boot file. Some BIOSes may have problems ifn"
" this is not a multiple of 4.n"
"n"
" -boot-info-tablen"
" Specifies that a 56-byte table with information of then"
" CD-ROM layout will be patched in at offset 8 in then"
" boot file. If this option is given, the boot file isn"
" modified in the source filesystem, so make sure to maken"
" a copy if this file cannot be easily regenerated! Seen"
" the EL TORITO BOOT INFO TABLE section for a descriptionn"
" of this table.n"
"n"
" -C last_sess_start,next_sess_startn"
" This option is needed when mkisofs is used to create an"
" CDextra or the image of a second session or a highern"
" level session for a multi session disk. The option -Cn"
" takes a pair of two numbers separated by a comma. Then"
" first number is the sector number of the first sectorn"
" in the last session of the disk that should be appendedn"
" to. The second number is the starting sector number ofn"
" the new session. The expected pair of numbers may ben"
" retrieved by calling cdrecord -msinfo ... If the -Cn"
" option is used in conjunction with the -M option,n"
" mkisofs will create a filesystem image that is intendedn"
" to be a continuation of the previous session. If then"
" -C option is used without the -M option, mkisofs willn"
" create a filesystem image that is intended to be usedn"
" for a second session on a CDextra. This is a multi ses-n"
" sion CD that holds audio data in the first session andn"
" a ISO9660 filesystem in the second session.n"
"n"
" -c boot_catalogn"
" Specifies the path and filename of the boot catalog ton"
" be used when making an "El Torito" bootable CD. Then"
" pathname must be relative to the source path specifiedn"
" to mkisofs. This option is required to make a bootablen"
" CD. This file will be inserted into the output treen"
" and not created in the source filesystem, so be suren"
" the specified filename does not conflict with an exist-n"
" ing file, as it will be excluded. Usually a name liken"
" "boot.catalog" is chosen.n"
"n"
" -check-oldnamesn"
" Check all filenames imported from old session for com-n"
" pliance with actual mkisofs iso9660 file naming rules.n"
" It his option is not present, only names with a lengthn"
" > 31 are checked as these files are a hard violation ofn"
" the iso9660 standard.n"
"n"
" -check-session FILEn"
" Check all old sessions for compliance with actualn"
" mkisofs iso9660 file naming rules. This is a highn"
" level option that is a combination of the options: -Mn"
" FILE -C 0,0 -check-oldnames For the parameter FILE seen"
" desciption of -M option.n"
"n"
" -copyright FILEn"
" Specifies the Copyright file name. This parameter cann"
" also be set in the file .mkisofsrc with COPY=filename.n"
" If specified in both places, the command line versionn"
" is used.n"
"n"
" -d Omit trailing period from files that do not have an"
" period.n"
" This violates the ISO9660 standard, but it happens ton"
" work on many systems. Use with caution.n"
"n"
" -D Do not use deep directory relocation, and instead justn"
" pack them in the way we see them.n"
" This violates the ISO9660 standard, but it happens ton"
" work on many systems. Use with caution.n"
"n"
" -dir-mode moden"
" Overrides the mode of directories used to create then"
" image to mode. Specifying this option automaticallyn"
" enables Rock Ridge extensions.n"
"n"
" -f Follow symbolic links when generating the filesystem.n"
" When this option is not in use, symbolic links will ben"
" entered using Rock Ridge if enabled, otherwise the filen"
" will be ignored.n"
"n"
" -file-mode moden"
" Overrides the mode of regular files used to create then"
" image to mode. Specifying this option automaticallyn"
" enables Rock Ridge extensions.n"
"n"
" -gid gidn"
" Overrides the gid read from the source files to then"
" value of gid. Specifying this option automaticallyn"
" enables Rock Ridge extensions.n"
"n"
" -gui Switch the behaviour for a GUI. This currently makesn"
" the output more verbose but may have other effects inn"
" future.n"
"n"
" -graft-pointsn"
" Allow to use graft points for filenames. If this optionn"
" is used, all filenames are checked for graft points.n"
" The filename is divided at the first unescaped equaln"
" sign. All occurrences of '\' and '=' characters mustn"
" be escaped with '\' if -graft-points has been speci-n"
" fied.n"
"n"
" -hide globn"
" Hide glob from being seen on the ISO9660 or Rock Ridgen"
" directory. glob is a shell wild-card-style patternn"
" that must match any part of the filename or path. Mul-n"
" tiple globs may be hidden. If glob matches a direc-n"
" tory, then the contents of that directory will be hid-n"
" den. In order to match a directory name, make sure then"
" pathname does not include a trailing '/' character.n"
" All the hidden files will still be written to the out-n"
" put CD image file. Should be used with the -hide-n"
" joliet option.n"
"n"
" -hide-list filen"
" A file containing a list of globs to be hidden asn"
" above.n"
"n"
" -hidden globn"
" Add the hidden (existence) ISO9660 directory attributen"
" for glob. This attribute will prevent glob from beingn"
" listed on DOS based systems if the /A flag is not usedn"
" for the listing. glob is a shell wild-card-style pat-n"
" tern that must match any part of the filename or path.n"
" In order to match a directory name, make sure the path-n"
" name does not include a trailing '/' character. Multi-n"
" ple globs may be hidden.n"
"n"
" -hidden-list filen"
" A file containing a list of globs to get the hiddenn"
" attribute as above.n"
"n"
" -hide-joliet globn"
" Hide glob from being seen on the Joliet directory.n"
" glob is a shell wild-card-style pattern that must matchn"
" any part of the filename or path. Multiple globs mayn"
" be hidden. If glob matches a directory, then the con-n"
" tents of that directory will be hidden. In order ton"
" match a directory name, make sure the pathname does notn"
" include a trailing '/' character. All the hidden filesn"
" will still be written to the output CD image file.n"
" Should be used with the -hide option.n"
"n"
" -hide-joliet-list filen"
" A file containing a list of globs to be hidden asn"
" above.n"
"n"
" -hide-joliet-trans-tbln"
" Hide the TRANS.TBL files from the Joliet tree. Thesen"
" files usually don't make sense in the Joliet World asn"
" they list the real name and the ISO9660 name which mayn"
" both be different from the Joliet name.n"
"n"
" -hide-rr-movedn"
" Rename the directory RR_MOVED to .rr_moved in the Rockn"
" Ridge tree. It seems to be impossible to completelyn"
" hide the RR_MOVED directory from the Rock Ridge tree.n"
" This option only makes the visible tree better ton"
" understand for people who don't know what this direc-n"
" tory is for. If you need to have no RR_MOVED directoryn"
" at all, you should use the -D option. Note that in casen"
" that the -D option has been specified, the resultingn"
" filesystem is not ISO9660 level-1 compliant and willn"
" not be readable on MS-DOS. See also NOTES section forn"
" more information on the RR_MOVED directory.n"
"n"
" -l Allow full 31 character filenames. Normally then"
" ISO9660 filename will be in an 8.3 format which is com-n"
" patible with MS-DOS, even though the ISO9660 standardn"
" allows filenames of up to 31 characters. If you usen"
" this option, the disc may be difficult to use on a MS-n"
" DOS system, but this comes in handy on some other sys-n"
" tems (such as the Amiga). Use with caution.n"
"n"
" -input-charset charsetn"
" Input charset that defines the characters used in localn"
" file names. To get a list of valid charset names, calln"
" mkisofs -input-charset help. To get a 1:1 mapping, youn"
" may use default as charset name. The default initialn"
" values are cp437 on DOS based systems and iso8859-1 onn"
" all other systems. See CHARACTER SETS section belown"
" for more details.n"
"n"
" -output-charset charsetn"
" Output charset that defines the characters that will ben"
" used in Rock Ridge file names. Defaults to the inputn"
" charset. See CHARACTER SETS section below for moren"
" details.n"
"n"
" -iso-level leveln"
" Set the iso9660 conformance level. Valid numbers aren"
" 1..3.n"
"n"
" With level 1, files may only consist of one section andn"
" filenames are restricted to 8.3 characters.n"
"n"
" With level 2, files may only consist of one section.n"
"n"
" With level 3, no restrictions apply.n"
"n"
" With all iso9660 levels all filenames are restricted ton"
" upper case letters, numbers and the underscore (_). Then"
" maximum filename length is restricted to 31 characters,n"
" the directory nesting level is restricted to 8 and then"
" maximum path length is limited to 255 characters.n"
"n"
" -J Generate Joliet directory records in addition to regu-n"
" lar iso9660 file names. This is primarily useful whenn"
" the discs are to be used on Windows-NT or Windows-95n"
" machines. The Joliet filenames are specified inn"
" Unicode and each path component can be up to 64 Unicoden"
" characters long. Note that Joliet is no standard -n"
" CD's that use only Joliet extensions but no standardn"
" Rock Ridge extensions may usually only be used onn"
" Microsoft Win32 systems. Furthermore, the fact that then"
" filenames are limited to 64 characters and the factn"
" that Joliet uses the UTF-16 coding for Unicode charac-n"
" ters causes interoperability problems.n"
"n"
" -jcharset charsetn"
" Same as using -input-charset charset and -J options.n"
" See CHARACTER SETS section below for more details.n"
"n"
" -L Allow ISO9660 filenames to begin with a period. Usu-n"
" ally, a leading dot is replaced with an underscore inn"
" order to maintain MS-DOS compatibility.n"
" This violates the ISO9660 standard, but it happens ton"
" work on many systems. Use with caution.n"
"n"
" -log-file log_filen"
" Redirect all error, warning and informational messagesn"
" to log_file instead of the standard error.n"
"n"
" -m globn"
" Exclude glob from being written to CDROM. glob is an"
" shell wild-card-style pattern that must match part ofn"
" the filename (not the path as with option -x). Techni-n"
" cally glob is matched against the d->d_name part of then"
" directory entry. Multiple globs may be excluded.n"
" Example:n"
"n"
" mkisofs -o rom -m '*.o' -m core -m foobarn"
"n"
" would exclude all files ending in ".o", called "core"n"
" or "foobar" to be copied to CDROM. Note that if you hadn"
" a directory called "foobar" it too (and of course alln"
" its descendants) would be excluded.n"
"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"
" -exclude-list filen"
" A file containing a list of globs to be exclude asn"
" above.n"
"n"
" -max-iso9660-filenamesn"
" Allow 37 chars in iso9660 filenames. This optionn"
" forces the -N option as the extra name space is takenn"
" from the space reserved for ISO-9660 version numbers.n"
" This violates the ISO9660 standard, but it happens ton"
" work on many systems. Although a conforming applica-n"
" tion needs to provide a buffer space of at least 37n"
" characters, disks created with this option may cause an"
" buffer overflow in the reading operating system. Usen"
" with extreme care.n"
"n"
" -M pathn"
" orn"
"n"
" -M devicen"
" Specifies path to existing iso9660 image to be merged.n"
" The alternate form takes a SCSI device specifier thatn"
" uses the same syntax as the dev= parameter of cdrecord.n"
" The output of mkisofs will be a new session whichn"
" should get written to the end of the image specified inn"
" -M. Typically this requires multi-session capabilityn"
" for the recorder and cdrom drive that you are attempt-n"
" ing to write this image to. This option may only ben"
" used in conjunction with the -C option.n"
"n"
" -N Omit version numbers from ISO9660 file names.n"
" This violates the ISO9660 standard, but no one reallyn"
" uses the version numbers anyway. Use with caution.n"
"n"
" -new-dir-mode moden"
" Mode to use when creating new directories in the iso fsn"
" image. The default mode is 0555.n"
"n"
" -nobakn"
"n"
" -no-bakn"
" Do not include backup files files on the iso9660n"
" filesystem. If the -no-bak option is specified, filesn"
" that contain the characters '~' or '#' or end in '.bak'n"
" will not be included (these are typically backup filesn"
" for editors under unix).n"
"n"
" -force-rrn"
" Do not use the automatic Rock Ridge attributes recogni-n"
" tion for previous sessions. This helps to show rottenn"
" iso9660 extension records as e.g. created by NERO burn-n"
" ing ROM.n"
"n"
" -no-rrn"
" Do not use the Rock Ridge attributes from previous ses-n"
" sions. This may help to avoid getting into troublen"
" when mkisofs finds illegal Rock Ridge signatures on ann"
" old session.n"
"n"
" -no-split-symlink-componentsn"
" Don't split the SL components, but begin a new Con-n"
" tinuation Area (CE) instead. This may waste some space,n"
" but the SunOS 4.1.4 cdrom driver has a bug in readingn"
" split SL components (link_size = component_size insteadn"
" of link_size += component_size).n"
"n"
" -no-split-symlink-fieldsn"
" Don't split the SL fields, but begin a new Continuationn"
" Area (CE) instead. This may waste some space, but then"
" SunOS 4.1.4 and Solaris 2.5.1 cdrom driver have a bugn"
" in reading split SL fields (a `/' can be dropped).n"
"n"
" -o filenamen"
" is the name of the file to which the iso9660 filesystemn"
" image should be written. This can be a disk file, an"
" tape drive, or it can correspond directly to the devicen"
" name of the optical disc writer. If not specified,n"
" stdout is used. Note that the output can also be an"
" block special device for a regular disk drive, in whichn"
" case the disk partition can be mounted and examined ton"
" ensure that the premastering was done correctly.n"
"n"
" -pad Pad the end of the ISO9660 by 16 sectors (32kB). If then"
" total size then is not a multiple of 16 sectors, then"
" needed number of sectors is added. If the option -B isn"
" used, then there is a second padding at the end of then"
" boot partitions.n"
"n"
" The padding is needed as many operating systems (e.g.n"
" Linux) implement read ahead bugs in their filesystemn"
" I/O. These bugs result in read errors on one or moren"
" files that are located at the end of a track. They aren"
" usually present when the CD is written in Track at Oncen"
" mode or when the disk is written as mixed mode CD wheren"
" an audio track follows the data track.n"
"n"
" To avoid problems with I/O error on the last file onn"
" the filesystem, the -pad option has been made then"
" default.n"
"n"
" -no-padn"
" Do not Pad the end of the ISO9660 by 16 sectors (32kB).n"
"n"
" -path-list filen"
" A file containing a list of pathspec directories andn"
" filenames to be added to the ISO9660 filesystem. Thisn"
" list of pathspecs are processed after any that appearn"
" on the command line. If the argument is -, then then"
" list is read from the standard input. There must be atn"
" least one pathspec given on the command line as well.n"
"n"
" -P publisher_idn"
" Specifies a text string that will be written into then"
" volume header. This should describe the publisher ofn"
" the CDROM, usually with a mailing address and phonen"
" number. There is space on the disc for 128 charactersn"
" of information. This parameter can also be set in then"
" file .mkisofsrc with PUBL=. If specified in bothn"
" places, the command line version is used.n"
"n"
" -p preparer_idn"
" Specifies a text string that will be written into then"
" volume header. This should describe the preparer ofn"
" the CDROM, usually with a mailing address and phonen"
" number. There is space on the disc for 128 charactersn"
" of information. This parameter can also be set in then"
" file .mkisofsrc with PREP=. If specified in bothn"
" places, the command line version is used.n"
"n"
" -print-sizen"
" Print estimated filesystem size and exit. This optionn"
" is needed for Disk At Once mode and with some CD-Rn"
" drives when piping directly into cdrecord. In this casen"
" it is needed to know the size of the filesystem beforen"
" the actual CD-creation is done. The option -print-sizen"
" allows to get this size from a "dry-run" before the CDn"
" is actually written. Old versions of mkisofs did writen"
" this information (among other information) to stderr.n"
" As this turns out to be hard to parse, the numbern"
" without any other information is now printed on stdoutn"
" too. If you like to write a simple shell script,n"
" redirect stderr and catch the number from stdout. Thisn"
" may be done with:n"
"n"
" cdblocks=` mkisofs -print-size -quiet ... `n"
"n"
" mkisofs ... | cdrecord ... tsize=${cdblocks}s -n"
"n"