Changeset 3093
- Timestamp:
- 02/28/10 10:53:09 (6 months ago)
- Files:
-
- 1 modified
-
libburn/trunk/cdrskin/cdrskin.1 (modified) (18 diffs)
Legend:
- Unmodified
- Added
- Removed
-
libburn/trunk/cdrskin/cdrskin.1
r3028 r3093 3 3 .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection 4 4 .\" other parameters are allowed: see man(7), man(1) 5 .TH CDRSKIN 1 " Jan 19, 2010"5 .TH CDRSKIN 1 "Feb 29, 2010" 6 6 .\" Please adjust this date whenever revising the manpage. 7 7 .\" … … 83 83 Each track is initiated by one track source address argument, which may either 84 84 be "-" for standard input or the address of a readable file. If no write mode 85 is given explicit ely then one will be chosen which matches the peculiarities85 is given explicitly then one will be chosen which matches the peculiarities 86 86 of track sources and the state of the output media. 87 87 .PP … … 94 94 Info about the addresses of burned tracks is kept in a table of 95 95 content (TOC) on media and can be retrieved via cdrskin option -toc. 96 Th ese informations arealso used by the operating systems' CD-ROM read drivers.96 This information is also used by the operating systems' CD-ROM read drivers. 97 97 .PP 98 98 In general there are two types of tracks: data and audio. They differ in … … 100 100 resp. by music CD players. With DVD and BD there is only type data. 101 101 .br 102 If not explicit ely option -audio is given, then any track is burned as type102 If not explicitly option -audio is given, then any track is burned as type 103 103 data, unless the track source is a file with suffix ".wav" or ".au" and has a 104 104 header part which identifies it as MS-WAVE resp. SUN Audio with suitable … … 139 139 .br 140 140 So the mentioning of write modes in the following paragraphs and in the 141 examples is not so much a demand that the user shall choose one explicit ely,141 examples is not so much a demand that the user shall choose one explicitly, 142 142 but rather an illustration of what to expect with particular media types. 143 143 .SS … … 182 182 appendable media, allows no -multi and only a single track. The size of the 183 183 track needs to be known in advance. So either its source has to be a disk file 184 of recognizable size or the size has to be announced explicit ely by options184 of recognizable size or the size has to be announced explicitly by options 185 185 .B tsize= 186 186 or … … 188 188 .br 189 189 DAO is the only mode for media which do not offer feature 21h Incremental 190 Streaming. DAO may also be selected explicit ely by option190 Streaming. DAO may also be selected explicitly by option 191 191 .B -sao . 192 192 Program growisofs uses DAO on sequential DVD-R[W] media for maximum … … 195 195 The other mode, Incremental Streaming, is the default write mode if 196 196 it is available and if the restrictions of DAO would prevent the job. 197 Incremental Streaming may be selected explicit ely by option197 Incremental Streaming may be selected explicitly by option 198 198 .B -tao 199 199 as it resembles much CD TAO by allowing track sources of … … 226 226 .br 227 227 Option -audio is not allowed. Only one track is allowed. 228 Option -multi cannot mark a recogniz eable end of overwriteable media.228 Option -multi cannot mark a recognizable end of overwriteable media. 229 229 Therefore -multi is banned unless ISO-9660 images shall be expandable by help 230 230 of option … … 351 351 The source is supposed to be uncompressed headerless PCM, 44100 Hz, 16 bit, 352 352 stereo. For little-endian byte order (which is usual on PCs) use option 353 -swab. Unless marked explicit ely by option -data, input files with suffix353 -swab. Unless marked explicitly by option -data, input files with suffix 354 354 ".wav" are examined wether they have a header in MS-WAVE format confirming 355 355 those parameters and eventually raw audio data get extracted and burned as … … 528 528 mechanism against temporary lack of source data (i.e. buffer underrun). 529 529 A drive that announces no such capabilities will not get them enabled anyway, 530 even if attempted explicit ely via "driveropts=burnfree".530 even if attempted explicitly via "driveropts=burnfree". 531 531 .TP 532 532 .BI \-dummy … … 598 598 If not, then the burn run will be aborted. 599 599 .br 600 The range of -isosize is exactly one track. Further tracks may be prece eded600 The range of -isosize is exactly one track. Further tracks may be preceded 601 601 by further -isosize options, though. At least 15 blocks of padding will be 602 602 added to each -isosize track. But be advised to rather use padsize=300k. … … 706 706 .br 707 707 -sao can only be used for tracks of fixely predicted size. This implies that 708 track arguments which depict stdin or named pipes need to be prece eded by708 track arguments which depict stdin or named pipes need to be preceded by 709 709 option tsize= or by option tao_to_sao_tsize=. 710 710 .br … … 823 823 .TP 824 824 .BI \--adjust_speed_to_drive 825 Curb explicit ely given speed= values to the maximum which is announced by the825 Curb explicitly given speed= values to the maximum which is announced by the 826 826 drive for the loaded media. By default, such an adjustment is only made with 827 827 pseudo-speeds 0 and -1 whereas speed settings > 0 are sent unchanged to the … … 917 917 the address of an own program. 918 918 .br 919 The fallback program mwill get all arguments of cdrskin which do not match919 The fallback program will get all arguments of cdrskin which do not match 920 920 the shell patterns --?* or *_*=* . This eventually suppresses path names of 921 921 track sources which happen to match those patterns. The options from the … … 963 963 eventual ISO-9660 filesystem on media. It is assumed that this image's inner 964 964 size description points to the end of the valuable data. 965 Overwriteable media with a recogniz eable ISO-9660 size will be regarded as965 Overwriteable media with a recognizable ISO-9660 size will be regarded as 966 966 appendable rather than as blank. I.e. options -msinfo and -toc will work. 967 967 -toc will always show a single session with its size increasing with 968 968 every added mkisofs image. 969 969 .br 970 If not overrid en by option write_start_address=, the track with the new image970 If not overridden by option write_start_address=, the track with the new image 971 971 will be placed behind the end of the old one. One may use option 972 972 assert_write_lba= to make sure that media state and mkisofs job do match. … … 1063 1063 a cdrskin version prior to 0.3.3 no track source should be given in order 1064 1064 not to start an involuntary burn session. 1065 In this case set at least -sao or -tao explicit ely.1065 In this case set at least -sao or -tao explicitly. 1066 1066 .br 1067 1067 The result gets printed to standard output. It is 0 or empty if no writing … … 1131 1131 options --devices and -scanbus. 1132 1132 Normally this is /dev/sgN on kernel versions < 2.6 and /dev/srN 1133 on kernels >= 2.6 . This option allows to explicit ely override that default1133 on kernels >= 2.6 . This option allows to explicitly override that default 1134 1134 in order to meet other programs at a common device file for each drive. 1135 1135 On kernel 2.4 families sr and scd will find no drives.
