From 828fcd2e1b96535208159bbadaab3ff4a8625f6d Mon Sep 17 00:00:00 2001 From: Thomas Schmitt Date: Wed, 13 Dec 2006 22:12:36 +0000 Subject: [PATCH] Clarified track content meaning. Corrected some typos and beauty flaws --- libburn/trunk/cdrskin/cdrskin.1 | 40 +++++++++++++++++++++++++-------- 1 file changed, 31 insertions(+), 9 deletions(-) diff --git a/libburn/trunk/cdrskin/cdrskin.1 b/libburn/trunk/cdrskin/cdrskin.1 index 027e591f..cf4cc13a 100644 --- a/libburn/trunk/cdrskin/cdrskin.1 +++ b/libburn/trunk/cdrskin/cdrskin.1 @@ -60,10 +60,32 @@ state of the output media. .PP There can be more than one track burned by a single run of cdrskin. CDs can be kept appendable so that further tracks can -be witten to them in subsequent runs of cdrskin (see option -multi). +be written to them in subsequent runs of cdrskin (see option -multi). Info about the addresses of burned tracks is kept in a table of content (TOC) on media and can be retrieved via cdrskin option -toc. These informations are also used by the operating systems' CD-ROM read drivers. +.PP +In general there are two types of tracks: data and audio. They differ in +sector size, throughput and readability via the systems' CD-ROM drivers +resp. by music CD players. +.br +If not explicitely option -audio is given, then any track is burned as data +unless the track source is a file with suffix ".wav" or ".au" and has a +header part which identifies it as MS-WAVE resp. SUN Audio with suitable +parameters. Such files are burned as audio tracks by default. +.PP +While audio tracks just contain a given time span of acoustic vibrations, +data tracks may have an arbitray meaning. Nevertheless, ISO-9660 filesystems +are established as a format which can represent a tree of directories and +data files on all major operating systems. Such filesystem images can be +produced by programs mkisofs or genisoimage. They can also be extended by +follow-up tracks if prepared properly. See the man pages of said programs. +cdrskin is able to fulfill the needs about their option -C. +.br +Another type of data track content are archive formats which originally +have been developed for magnetic tapes. Only formats which mark a detectable +end-of-archive in their data are suitable with CD, though. Well tested are +the archivers afio and star. Not suitable seems GNU tar. .br .SH OPTIONS .TP @@ -303,17 +325,17 @@ somebody who had a look into the program sourcecode. Alphabetical list of options which are genuine to cdrskin and intended for normal use: .TP +.BI \--allow_setuid +Disable the loud warning about insecure discrepance between login user and +effective user which indicates application of chmod u+s to the program binary. +One should not do this chmod u+s , but it is an old cdrecord tradition. +.TP .BI \--any_track Allow source_addresses to begin with "-" (plus further characters) or to contain a "=" character. By default such arguments are seen as misspelled options. It is nevertheless not possible to use one of the options listed with --list_ignored_options. .TP -.BI \--allow_setuid -Disable the loud warning about insecure discrepance between login user and -effective user which indicates application of chmod u+s to the program binary. -One should not do this chmod u+s , but it is an old cdrecord tradition. -.TP .BI \--demand_a_drive Exit with a nonzero value if no drive can be found during a bus scan. .TP @@ -351,7 +373,7 @@ interpretation of eventual startup files. See section FILES below. .BI \--list_ignored_options List all ignored cdrecord options. The --options cannot be used as addresses of track sources. No track source address may begin with a text equal to an -option which ends by "=". +option which ends by "=". The list is ended by an empty line. .TP .BI \--single_track Accept only the last argument of the command line as track source address. @@ -482,7 +504,7 @@ cdrskin -v dev=0,1,0 fs=32m speed=8 driveropts=burnfree \\ .br padsize=300k -tao - .SS -.B Write several sessions to the same CD +.B Write several sessions to the same CD: .br cdrskin dev=/dev/hdc padsize=300k -multi 1.iso .br @@ -492,7 +514,7 @@ cdrskin dev=/dev/hdc padsize=300k -multi -tao 3.afio .br cdrskin dev=/dev/hdc padsize=300k -tao 4.afio .SS -.B Get the multi-session info for option -C of program mkisofs +.B Get the multi-session info for option -C of program mkisofs: .br c_values=$(cdrskin dev=/dev/sr0 -msinfo 2>/dev/null) .br