From owner-svn-doc-head@FreeBSD.ORG Wed Apr 23 20:00:06 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id D9A02891; Wed, 23 Apr 2014 20:00:05 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id C56511142; Wed, 23 Apr 2014 20:00:05 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s3NK05Et012362; Wed, 23 Apr 2014 20:00:05 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s3NK05F4012357; Wed, 23 Apr 2014 20:00:05 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201404232000.s3NK05F4012357@svn.freebsd.org> From: Dru Lavigne Date: Wed, 23 Apr 2014 20:00:05 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 23 Apr 2014 20:00:06 -0000 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 + + Burning a <acronym>CD</acronym> + + In &os;, cdrecord can + be used to burn CDs. This command is + installed with the + sysutils/cdrtools package or port. + + + &os; 8.x includes the built-in + burncd utility for burning + CDs using an ATAPI + CD burner. Refer to the manual page for + burncd for usage examples. + + + While cdrecord has many options, basic + usage is simple. Burning an ISO 9660 image is done + with: + + &prompt.root; cdrecord dev=device imagefile.iso + + The tricky part of using cdrecord is + finding the to use. To find the proper + setting, use which might produce + results like this: + + + CD-ROMs + burning + + &prompt.root; cdrecord -scanbus +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) * + + This lists the appropriate value for + the devices on the list. Locate the CD + burner, and use the three numbers separated by commas as the + value for . In this case, the CRW device + is 1,5,0, so the appropriate input is + . Refer to &man.cdrecord.1; for + easier ways to specify this value and for information on + writing audio tracks and controlling the write speed. + + Alternately, as root, run the + following command to get the SCSI address + of the burner: + + &prompt.root; camcontrol devlist +<MATSHITA CDRW/DVD UJDA740 1.00> at scbus1 target 0 lun 0 (pass0,cd0) + + In this example, 1,0,0 is the + SCSI address to use with &man.cdrecord.1; + and other SCSI applications. + + Creating an <acronym>ISO</acronym> File System @@ -834,105 +908,6 @@ cd0: Attempt to query device size failed &man.mkisofs.8; for details. - - Using an <acronym>ATAPI</acronym> Burner - - - CD-ROMs - burning - - For an ATAPI CD - burner, burncd can be used to burn an ISO - image onto a CD. - burncd is part of the base system, - installed as /usr/sbin/burncd. Usage is - very simple, as it has few options: - - &prompt.root; burncd -f cddevice data imagefile.iso fixate - - This command will burn a copy of - imagefile.iso on - cddevice. The default device is - /dev/acd0. See &man.burncd.8; for - options to set the write speed, eject the - CD after burning, and write audio - data. - - - - Using a <acronym>USB</acronym> or <acronym>SCSI</acronym> Burner - - For systems without an ATAPI - CD burner, cdrecord can - be used to burn CDs. - cdrecord is not part of the base system and - must be installed from either the - sysutils/cdrtools package or port. Changes - to the base system can cause binary versions of this program - to fail, possibly resulting in a coaster. It - is recommended to either upgrade the port when the system is - upgraded, or for users tracking - -STABLE, to upgrade the port when a new version - becomes available. - - While cdrecord has many options, basic - usage is simple. Burning an ISO 9660 image is done - with: - - &prompt.root; cdrecord dev=device imagefile.iso - - The tricky part of using cdrecord is - finding the to use. To find the proper - setting, use which might produce - results like this: - - - CD-ROMs - burning - - &prompt.root; cdrecord -scanbus -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) * - - This lists the appropriate value for - the devices on the list. Locate the CD - burner, and use the three numbers separated by commas as the - value for . In this case, the CRW device - is 1,5,0, so the appropriate input is - . Refer to &man.cdrecord.1; for - easier ways to specify this value and for information on - writing audio tracks and controlling the write speed. - - Alternately, as root, run the - following command to get the SCSI address - of the burner: - - &prompt.root; camcontrol devlist -<MATSHITA CDRW/DVD UJDA740 1.00> at scbus1 target 0 lun 0 (pass0,cd0) - - In this example, 1,0,0 is the - SCSI address to use with &man.cdrecord.1; - and other SCSI applications. - - Duplicating Audio <acronym>CD</acronym>s @@ -1008,12 +983,14 @@ scsibus1: Burn the extracted files to disk using - burncd. Specify that these are audio - files, and that burncd should fixate + cdrecord. Specify that these are audio + files, and that cdrecord should fixate the disk when finished: - + + @@ -1124,10 +1101,11 @@ scsibus1: CD, without creating an ISO 9660 file system. Some people do this for backup purposes. This command runs more quickly than burning a standard - CD: - + CD. + In order to retrieve the data burned to such a CD, the data must be read from the raw device node: 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. Burn the Media Next, write the downloaded image(s) to disc. If using - another &os; system, refer to and + another &os; system, refer to for instructions. 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 Both the WAV and PCM - formats can be used with cdrecord - to create audio CDs, whereas - burncd requires the - PCM format. When using + formats can be used with cdrecord. When using WAV files, there will be a small tick sound at the beginning of each track. This sound is the header of the WAV file. The