Date: Wed, 23 Apr 2014 20:00:05 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44638 - in head/en_US.ISO8859-1/books/handbook: disks install multimedia Message-ID: <201404232000.s3NK05F4012357@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: dru Date: Wed Apr 23 20:00:04 2014 New Revision: 44638 URL: http://svnweb.freebsd.org/changeset/doc/44638 Log: Rip out all instances of burncd in prep for closing PR171098. Add note for 8.x users about the existence of burncd. Still need to tech review the rest of the CD chapter and update some examples to use cdrecord. More commits to come. Reviewed by: zeising Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml head/en_US.ISO8859-1/books/handbook/install/chapter.xml head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/disks/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Wed Apr 23 19:35:48 2014 (r44637) +++ head/en_US.ISO8859-1/books/handbook/disks/chapter.xml Wed Apr 23 20:00:04 2014 (r44638) @@ -747,6 +747,80 @@ cd0: Attempt to query device size failed </screen> </sect2> + <sect2 xml:id="cdrecord"> + <title>Burning a <acronym>CD</acronym></title> + + <para>In &os;, <command>cdrecord</command> can + be used to burn <acronym>CD</acronym>s. This command is + installed with the + <package>sysutils/cdrtools</package> package or port.</para> + + <note> + <para>&os; 8.x includes the built-in + <command>burncd</command> utility for burning + <acronym>CD</acronym>s using an <acronym>ATAPI</acronym> + <acronym>CD</acronym> burner. Refer to the manual page for + <command>burncd</command> for usage examples.</para> + </note> + + <para>While <command>cdrecord</command> has many options, basic + usage is simple. Burning an ISO 9660 image is done + with:</para> + + <screen>&prompt.root; <userinput>cdrecord dev=<replaceable>device</replaceable> <replaceable>imagefile.iso</replaceable></userinput></screen> + + <para>The tricky part of using <command>cdrecord</command> is + finding the <option>dev</option> to use. To find the proper + setting, use <option>-scanbus</option> which might produce + results like this:</para> + + <indexterm> + <primary><acronym>CD-ROM</acronym>s</primary> + <secondary>burning</secondary> + </indexterm> + <screen>&prompt.root; <userinput>cdrecord -scanbus</userinput> +Cdrecord-Clone 2.01 (i386-unknown-freebsd7.0) Copyright (C) 1995-2004 Jörg Schilling +Using libscg version 'schily-0.1' +scsibus0: + 0,0,0 0) 'SEAGATE ' 'ST39236LW ' '0004' Disk + 0,1,0 1) 'SEAGATE ' 'ST39173W ' '5958' Disk + 0,2,0 2) * + 0,3,0 3) 'iomega ' 'jaz 1GB ' 'J.86' Removable Disk + 0,4,0 4) 'NEC ' 'CD-ROM DRIVE:466' '1.26' Removable CD-ROM + 0,5,0 5) * + 0,6,0 6) * + 0,7,0 7) * +scsibus1: + 1,0,0 100) * + 1,1,0 101) * + 1,2,0 102) * + 1,3,0 103) * + 1,4,0 104) * + 1,5,0 105) 'YAMAHA ' 'CRW4260 ' '1.0q' Removable CD-ROM + 1,6,0 106) 'ARTEC ' 'AM12S ' '1.06' Scanner + 1,7,0 107) *</screen> + + <para>This lists the appropriate <option>dev</option> value for + the devices on the list. Locate the <acronym>CD</acronym> + burner, and use the three numbers separated by commas as the + value for <option>dev</option>. In this case, the CRW device + is 1,5,0, so the appropriate input is + <option>dev=1,5,0</option>. Refer to &man.cdrecord.1; for + easier ways to specify this value and for information on + writing audio tracks and controlling the write speed.</para> + + <para>Alternately, as <systemitem class="username">root</systemitem>, run the + following command to get the <acronym>SCSI</acronym> address + of the burner:</para> + + <screen>&prompt.root; <userinput>camcontrol devlist</userinput> +<MATSHITA CDRW/DVD UJDA740 1.00> at scbus1 target 0 lun 0 (pass0,cd0)</screen> + + <para>In this example, <literal>1,0,0</literal> is the + <acronym>SCSI</acronym> address to use with &man.cdrecord.1; + and other <acronym>SCSI</acronym> applications.</para> + </sect2> + <sect2 xml:id="mkisofs"> <title>Creating an <acronym>ISO</acronym> File System</title> @@ -834,105 +908,6 @@ cd0: Attempt to query device size failed &man.mkisofs.8; for details.</para> </sect2> - <sect2 xml:id="burncd"> - <title>Using an <acronym>ATAPI</acronym> Burner</title> - - <indexterm> - <primary><acronym>CD-ROM</acronym>s</primary> - <secondary>burning</secondary> - </indexterm> - <para>For an <acronym>ATAPI</acronym> <acronym>CD</acronym> - burner, <command>burncd</command> can be used to burn an ISO - image onto a <acronym>CD</acronym>. - <command>burncd</command> is part of the base system, - installed as <filename>/usr/sbin/burncd</filename>. Usage is - very simple, as it has few options:</para> - - <screen>&prompt.root; <userinput>burncd -f <replaceable>cddevice</replaceable> data <replaceable>imagefile.iso</replaceable> fixate</userinput></screen> - - <para>This command will burn a copy of - <replaceable>imagefile.iso</replaceable> on - <replaceable>cddevice</replaceable>. The default device is - <filename>/dev/acd0</filename>. See &man.burncd.8; for - options to set the write speed, eject the - <acronym>CD</acronym> after burning, and write audio - data.</para> - </sect2> - - <sect2 xml:id="cdrecord"> - <title>Using a <acronym>USB</acronym> or <acronym>SCSI</acronym> Burner</title> - - <para>For systems without an <acronym>ATAPI</acronym> - <acronym>CD</acronym> burner, <command>cdrecord</command> can - be used to burn <acronym>CD</acronym>s. - <command>cdrecord</command> is not part of the base system and - must be installed from either the - <package>sysutils/cdrtools</package> package or port. Changes - to the base system can cause binary versions of this program - to fail, possibly resulting in a <quote>coaster</quote>. It - is recommended to either upgrade the port when the system is - upgraded, or for users <link linkend="stable">tracking - -STABLE</link>, to upgrade the port when a new version - becomes available.</para> - - <para>While <command>cdrecord</command> has many options, basic - usage is simple. Burning an ISO 9660 image is done - with:</para> - - <screen>&prompt.root; <userinput>cdrecord dev=<replaceable>device</replaceable> <replaceable>imagefile.iso</replaceable></userinput></screen> - - <para>The tricky part of using <command>cdrecord</command> is - finding the <option>dev</option> to use. To find the proper - setting, use <option>-scanbus</option> which might produce - results like this:</para> - - <indexterm> - <primary><acronym>CD-ROM</acronym>s</primary> - <secondary>burning</secondary> - </indexterm> - <screen>&prompt.root; <userinput>cdrecord -scanbus</userinput> -Cdrecord-Clone 2.01 (i386-unknown-freebsd7.0) Copyright (C) 1995-2004 Jörg Schilling -Using libscg version 'schily-0.1' -scsibus0: - 0,0,0 0) 'SEAGATE ' 'ST39236LW ' '0004' Disk - 0,1,0 1) 'SEAGATE ' 'ST39173W ' '5958' Disk - 0,2,0 2) * - 0,3,0 3) 'iomega ' 'jaz 1GB ' 'J.86' Removable Disk - 0,4,0 4) 'NEC ' 'CD-ROM DRIVE:466' '1.26' Removable CD-ROM - 0,5,0 5) * - 0,6,0 6) * - 0,7,0 7) * -scsibus1: - 1,0,0 100) * - 1,1,0 101) * - 1,2,0 102) * - 1,3,0 103) * - 1,4,0 104) * - 1,5,0 105) 'YAMAHA ' 'CRW4260 ' '1.0q' Removable CD-ROM - 1,6,0 106) 'ARTEC ' 'AM12S ' '1.06' Scanner - 1,7,0 107) *</screen> - - <para>This lists the appropriate <option>dev</option> value for - the devices on the list. Locate the <acronym>CD</acronym> - burner, and use the three numbers separated by commas as the - value for <option>dev</option>. In this case, the CRW device - is 1,5,0, so the appropriate input is - <option>dev=1,5,0</option>. Refer to &man.cdrecord.1; for - easier ways to specify this value and for information on - writing audio tracks and controlling the write speed.</para> - - <para>Alternately, as <systemitem class="username">root</systemitem>, run the - following command to get the <acronym>SCSI</acronym> address - of the burner:</para> - - <screen>&prompt.root; <userinput>camcontrol devlist</userinput> -<MATSHITA CDRW/DVD UJDA740 1.00> at scbus1 target 0 lun 0 (pass0,cd0)</screen> - - <para>In this example, <literal>1,0,0</literal> is the - <acronym>SCSI</acronym> address to use with &man.cdrecord.1; - and other <acronym>SCSI</acronym> applications.</para> - </sect2> - <sect2 xml:id="duplicating-audiocds"> <title>Duplicating Audio <acronym>CD</acronym>s</title> @@ -1008,12 +983,14 @@ scsibus1: <step> <para>Burn the extracted files to disk using - <command>burncd</command>. Specify that these are audio - files, and that <command>burncd</command> should fixate + <command>cdrecord</command>. Specify that these are audio + files, and that <command>cdrecord</command> should fixate the disk when finished:</para> - +<!-- +Update example for cdrecord <screen>&prompt.root; <userinput>burncd -f <replaceable>/dev/acd0</replaceable> audio track1.cdr track2.cdr <replaceable>...</replaceable> fixate</userinput></screen> - </step> + --> + </step> </procedure> </sect2> @@ -1124,10 +1101,11 @@ scsibus1: <acronym>CD</acronym>, without creating an ISO 9660 file system. Some people do this for backup purposes. This command runs more quickly than burning a standard - <acronym>CD</acronym>:</para> - + <acronym>CD</acronym>.</para> +<!-- +Update example for cdrecord <screen>&prompt.root; <userinput>burncd -f /dev/acd1 -s 12 data archive.tar.gz fixate</userinput></screen> - + --> <para>In order to retrieve the data burned to such a <acronym>CD</acronym>, the data must be read from the raw device node:</para> Modified: head/en_US.ISO8859-1/books/handbook/install/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/install/chapter.xml Wed Apr 23 19:35:48 2014 (r44637) +++ head/en_US.ISO8859-1/books/handbook/install/chapter.xml Wed Apr 23 20:00:04 2014 (r44638) @@ -4406,7 +4406,7 @@ Please press any key to reboot.</screen> <title>Burn the Media</title> <para>Next, write the downloaded image(s) to disc. If using - another &os; system, refer to <xref linkend="burncd"/> and + another &os; system, refer to <xref linkend="cdrecord"/> for instructions.</para> <para>If using another platform, use any burning utility Modified: head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Wed Apr 23 19:35:48 2014 (r44637) +++ head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Wed Apr 23 20:00:04 2014 (r44638) @@ -678,10 +678,7 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz </procedure> <para>Both the <acronym>WAV</acronym> and <acronym>PCM</acronym> - formats can be used with <application>cdrecord</application> - to create audio <acronym>CD</acronym>s, whereas - <application>burncd</application> requires the - <acronym>PCM</acronym> format. When using + formats can be used with <application>cdrecord</application>. When using <acronym>WAV</acronym> files, there will be a small tick sound at the beginning of each track. This sound is the header of the <acronym>WAV</acronym> file. The
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201404232000.s3NK05F4012357>