[xiph-commits] r11816 - websites/xiph.org/paranoia
xiphmont at svn.xiph.org
xiphmont at svn.xiph.org
Tue Aug 29 18:22:29 PDT 2006
Author: xiphmont
Date: 2006-08-29 18:22:25 -0700 (Tue, 29 Aug 2006)
New Revision: 11816
Added:
websites/xiph.org/paranoia/black-xifish.png
Modified:
websites/xiph.org/paranoia/bugs.html
websites/xiph.org/paranoia/doc.html
websites/xiph.org/paranoia/down.html
websites/xiph.org/paranoia/faq.html
websites/xiph.org/paranoia/index.html
websites/xiph.org/paranoia/links.html
websites/xiph.org/paranoia/manual.html
websites/xiph.org/paranoia/manualj.html
websites/xiph.org/paranoia/news.html
websites/xiph.org/paranoia/prog.html
websites/xiph.org/paranoia/tech.html
websites/xiph.org/paranoia/trouble.html
Log:
Paranoia website update for 10pre0 release
Added: websites/xiph.org/paranoia/black-xifish.png
===================================================================
(Binary files differ)
Property changes on: websites/xiph.org/paranoia/black-xifish.png
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: websites/xiph.org/paranoia/bugs.html
===================================================================
--- websites/xiph.org/paranoia/bugs.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/bugs.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -86,11 +86,11 @@
</center>
<p align=left>
-March 27, 2001
+August 29, 2006
<p align=center>
<!-- body or table of contents -->
-<h1>Known bugs/shortcomings in alpha 9.8</h1>
+<h1>Known bugs/shortcomings in 10pre0</h1>
A number of these items are simply bugs in particular drives that
cdparanoia cannot yet correct or known limitations in the current
@@ -110,6 +110,13 @@
<hr>
<h1>Known bugs fixed from previous releases</h1>
+<h2>Bugs fixed since alpha 9.8</h2>
+<ul>
+<li>Segfault caused by failure to probe a detected SCSI cdrom drive.
+<li>Lack of SG_IO interface support.
+<li>Autoconf and build fixes.
+</ul>
+
<h2>Bugs fixed since alpha 9.7</h2>
<ul>
@@ -377,8 +384,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/doc.html
===================================================================
--- websites/xiph.org/paranoia/doc.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/doc.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -89,7 +89,7 @@
<hr>
<p align=left>
-January 31, 1999
+August 29, 2006
<p align=left>
<!-- body or table of contents -->
@@ -105,7 +105,6 @@
<ul>
<li><a href="faq.html">Paranoia FAQ</a>
-<li><a href="prog.html">Paranoia IV API and programming</a>
<li><a href="tech.html">Technical information and algorithms used by Paranoia</a>
</ul>
<p>
@@ -134,8 +133,8 @@
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/down.html
===================================================================
--- websites/xiph.org/paranoia/down.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/down.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -90,7 +90,7 @@
<hr>
<p align=left>
-March 27, 2001
+August 29, 2006
<p align=left>
<!-- body or table of contents -->
@@ -99,23 +99,36 @@
<font face= "Arial, Helvetica, sans-serif" color=#000080>
<p>
+<h3>Cdparanoia release 10</h3>
+<strong>Current testing release version</strong>: cdparanoia III 10pre0<br><p>
+
+This release is currently in testing toward full release. It should
+not yet be trusted around pets or small children.<p>
+
+<ul><li><a
+href="http://downloads.xiph.org/releases/cdparanoia/cdparanoia-III-10pre0.src.tgz">Complete
+cdparanoia 10pre0 package source, ready to build</a>
+(116591 bytes)
+<li><a href="http://downloads.xiph.org/releases/cdparanoia/">
+Download directory for all current and past releases</a>
+</ul>
+
+<p>
<h3>Cdparanoia release 9</h3>
<strong>Current stable release version</strong>: cdparanoia III 9.8<br>
<ul><li><a
href="http://downloads.xiph.org/releases/cdparanoia/cdparanoia-III-alpha9.8.src.tgz">Complete
-cdparanoia III package source, ready to build</a>
+cdparanoia 9.8 package source, ready to build</a>
(116591 bytes)
<li><a
href="http://downloads.xiph.org/releases/cdparanoia/cdparanoia-III-alpha9.8.i386-linux-elf.gz">Gzipped,
statically linked cdparanoia binary for
Linux i386 ELF</a> (204807 bytes)
-<li><a href="http://downloads.xiph.org/releases/cdparanoia/">
-Download directory for all current and past releases</a>
</ul>
<p>
-<strong>Anonymous read-only Subversion access</strong>
+<h3>Anonymous read-only Subversion access</h3>
<ul><li>The <a href="/svn">xiph.org Subversion access page</a> has
complete instructions for accessing
<a href="http://svn.xiph.org/trunk/cdparanoia/">cdparanoia III</a>
@@ -126,15 +139,16 @@
</td></tr>
</table>
-<h2><a name=alpha>Alpha release notes:</a></h2>
+<h2><a name=alpha>Release notes:</a></h2>
-This alpha release is stable code; its status as 'alpha' is because
-the library interface (Paranoia III) is soon to be replaced (by
-Paranoia IV) and as such, will not be supported after Paranoia IV's
-release.<p>
+Cdparanoia 9 is the current stable release; it should be chosen to run
+on stable systems. Cdparanoia 10 is a beta prerelease and not yet
+well tested; individuals with an adventureous spirit are encouraged to
+try it out. Once 10pre0 has seen more feedback, it will be propmoted
+to the current stable release.<p>
-Alpha 9.8 may have a number of minor bugs that will be corrected in the
-next release. <strong>Check the <a href=bugs.html>buglist</a> before
+10pre0 may have a number of minor bugs that will be corrected before final release.
+<strong>Please, check the <a href=bugs.html>buglist</a> before
writing!</strong>. Most difficulties in getting cdparanoia to work
are due to failing to read the documentation. <strong>If cdparanoia
doesn't run after installing, read the <a
@@ -142,18 +156,13 @@
writing</strong>.<p>
If the buglist and troubleshooting page don't help, please don't
-hesitate to <a href="mailto:paranoia-dev at xiph.org">send mail</a>. People
-do find new bugs now and then and they only get fixed when reported.
-If it's not a bug, it's probably something I missed on the buglist or
-troubleshooting faq, and you shouldn't feel guilty about that :-)<p>
+hesitate to <a href="mailto:paranoia-dev at xiph.org">send mail</a>.
+People do find new bugs now and then, especially in prereleases, and
+they only get fixed when reported. If it's not a bug, it's probably
+something I missed on the buglist or troubleshooting faq, and you
+shouldn't feel guilty about that :-)<p>
+
-Alpha 9 is still Linux only, although ports for BSD variants, IRIX and
-Solaris are next on the "todo" list (and well under way). Also, alpha
-9 does not yet include scratch detection and repair or info file
-support. Aside from these missing features, any inability to properly
-read audio from an undamaged CD is a bug. Report what doesn't
-work!<p>
-
<!-- body complete. cleanup table -->
</font>
</td>
@@ -178,8 +187,8 @@
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/faq.html
===================================================================
--- websites/xiph.org/paranoia/faq.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/faq.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -86,7 +86,7 @@
<hr>
<p align=left>
-August 25, 1999
+August 29, 2006
<p align=left>
<!-- body or table of contents -->
@@ -97,9 +97,6 @@
Questions about errors and problems with Paranoia/cdparanoia aren't
here; look at the <a href="trouble.html">troubleshooting page</a>.<p>
-And yes, dammit, it's y2k compliant. Now I don't want to hear any
-more about it.<p>
-
<p>
<h1>Table of Contents:</h1>
<p>
@@ -115,12 +112,11 @@
<li><a href="#versions">What are the differences between Paranoia II, III and IV?</a>
<li><a href="#maillist">Are there cdparanoia mailing lists for users or developers?</a>
<li><a href="#devstatus">What is Paranoia IV's current development status?</a>
- <li><a href="#merge">Will cdparanoia, and cdda2wav or xcdroast merge anytime in the future?</a>
</ol>
<li>Questions about using Paranoia and cdparanoia
<ol>
- <li><a href="#req">Requirements to run cdparanoia (as of alpha 3)</a>
- <li><a href="#supp">Does Cdparanoia support ATAPI drives? SCSI Emulation? Parallel port drives?</a>
+ <li><a href="#req">Requirements to run cdparanoia</a>
+ <li><a href="#supp">Does Cdparanoia support ATAPI drives? SCSI Emulation? USB drives? Parallel port drives?</a>
<li><a href="#play">I can play audio CDs perfectly; why is reading the CD into a file so difficult and prone to errors?</a>
<li><a href="#analog">Does cdparanoia lose quality from the CD recording?</a>
<li><a href="#toc">Can cdparanoia detect pregaps? Can it remove the two second gaps between tracks</a>
@@ -212,46 +208,46 @@
<a name=paranoia>
<h2>What is Paranoia?</h2>
-Paranoia is a library project that provides a platform independent,
-unified, robust interface for packet-command based devices. In the
-case of CDROM drives for example, handling and programming cdrom
-drives becomes identical whether on Solaris or Linux, or if the Linux
-drive is SCSI, ATAPI or on the parallel port. In this way, Paranoia
-is similar to Joerg Schilling's SCG library.<p>
+Paranoia is a library that provides a unified, robust interface for
+Linux applications that want to use CDROM devices.<p>
-In addition to device/platform unification, the library provides tools
-for automatically identifying devices, and intelligent
+In addition to Linux device interface unification, the library
+provides tools for automatically identifying devices, and intelligent
handling/correction of errors at all levels of the interface. On top
of a generic low-level packet command layer, Paranoia implements
high-level error-correcting interfaces for tasks such as CDDA where
broken or vastly non-standard devices are the rule, rather than the
exception.<p>
-The Paranoia libraries are incomplete; the first release for use will
-be Paranoia IV, to be bundled with cdparanoia alpha release 10.
-Programming documentation for Paranoia IV will appear shortly on the
-<a href="doc.html">documentation page</a> as <a
-href="prog.html">Programming with Paranoia IV</a>. Programmers
-interested in contributing to Paranoia IV should read the heading <a
-href="#devstatus">Paranoia IV development information</a>.<p>
-
<hr>
<a name=portable>
<h2>Is cdparanoia / Paranoia portable?</h2>
-Paranoia III is Linux only (although it runs on all the flavors of linux
+Paranoia is Linux only (although it runs on all the flavors of linux
with a 2.0 or later kernel. It is not only for x86).<p>
-Paranoia IV (cdparanoia alpha 10 and later) is a port to other UNIX
-flavors and uses a substantially revised infrastructure. NetBSD and
-Solaris will be first; others will be added as time and outside
-assistance allow.<p>
+In the past, there was effort to make this library as portable as
+possible across other OS platforms. As time has worn on, I've come to
+realize that most cross-platform libraries that try to bring a
+completely uniform interface to a wide variety of very different
+OSes:<p>
-Suggestions on the proper way to handle each OS's native configuration
-idioms are welcome. I want Rhapsody cdparanoia to look just like other
-Rhapsody apps just as much as I want Linux cdparanoia to look like a
-Linux app.<p>
+<ol>
+<li>fail to be all that uniform
+<li>limit functionality to some subset of what any given platform can do
+<li>introduce additional lyers of bugs
+<li><em>just don't work very well</em>
+</ol>
+I'm a Linux user. I'm a Linux developer. As a user and developer, I
+don't really give a damn about other platforms. I want my apps to be
+the best Linux apps they can be. Full stop.<p>
+
+Should other developers like to participate on full-featured ports to
+other platforms, I'm all for full cooperation. I'd like to see those
+ports take *full* advantage of the target platform, not turn into a
+halfbaked subset of the features that work on both.<p>
+
<hr>
<a name=history>
<h2>What is Paranoia's history?</h2>
@@ -279,134 +275,62 @@
drives.<p>
Paranoia III was the first version to be written seperately from
-cdda2wav in the form of a standalone library. It was not terribly
+cdda2wav in the form of a standalone library.<p> It was not terribly
portable, however, and the API proved to be inadequate for extension.<p>
-Paranoia IV is the upcoming new generation of CDDA Paranoia. It is
-both portable and more capable than Paranoia III.<p>
+Paranoia IV is an upcoming generation that intends to improve the
+library API as well as take advantage of new CDROM features that
+existed on only a few specialist drives five years ago, but are now
+ubiquitous even in inexpensive models. Where Paranoia III
+concentrated on bulletproof extraction from good media and reliable
+extraction from damaged media, Paranoia IV will concentrate on the
+best possible extraction and correction from even heavily damaged
+media-- so long as the drive can still recognize the disc.<p>
<hr>
<a name=maillist>
<h2>Are there cdparanoia mailing lists for users or developers?</h2>
Yes. In addition to the mailing lists below, read-only Subversion access to
-Paranoia II and IV is availble <a href="/svn">here</a>.
+Paranoia is availble <a href="/svn">here</a>.
-<h3>
-Mailing list for Paranoia and Cdparanoia users (paranoia at xiph.org)
-</h3>
+<ul>
+<li><a href="http://lists.xiph.org/mailman/listinfo/paranoia">
+Mailing list for Paranoia and Cdparanoia users (paranoia at xiph.org)</a>
+<li><a href="http://lists.xiph.org/mailman/listinfo/paranoia-dev">
+Mailing list for Paranoia developers: paranoia-dev at xiph.org</a>
+<li><a href="http://lists.xiph.org/mailman/listinfo/paranoia-announce">
+Announcement list for new Paranoia releases</a>
+</ul>
-Assuming that the email preferences in your web browser are set up
-correctly, you can use the following button to subscribe:
-
- <form enctype=text/plain action="mailto:majordomo at xiph.org">
- <b>
- <input type=hidden name="# Paranoia user list" value="
-subscribe paranoia">
- <input type=submit value="Subscribe to the Paranoia mailing list">
- </b>
- </form>
-
-The traditional way to join: send a message containing only the
-one-word line 'subscribe' in the body to <a
-href="mailto:paranoia-request at xiph.org">paranoia-request at xiph.org</a>. Do
-not send subscription requests directly to the main list. The list
-server at xiph.org should respond fairly quickly with a welcome
-message.<p>
-
-
-<h3>
-Mailing list for Paranoia IV developers: paranoia-dev at xiph.org
-</h3>
-
-The developers list is intended for focused development discussion
-amongst the core Paranoia development team and outside groups
-developing their own applications using Paranoia. Of course, anyone
-is welcome to read.<p>
-
-Assuming
-that the email preferences in your web browser are set up correctly,
-you can just use the following button to subscribe:
-
- <form enctype=text/plain action="mailto:majordomo at xiph.org">
- <b>
- <input type=hidden name="# Paranoia user list" value="
-subscribe paranoia-dev">
- <input type=submit value="Subscribe to the Paranoia developers mailing list">
- </b>
- </form><p>
-
-Tradiitonal method: send a message containing only the one-word line
-'subscribe' in the body to <a
-href="mailto:paranoia-dev-request at xiph.org">paranoia-dev-request at xiph.org</a>.
-Do not send subscription requests directly to the main list.
-
-<h3>
-List for general CDROM tools
-</h3>
-
-There's also a general mailing list for those using/developing CDDA
-extraction and CD writing tools (cdwrite at other.debian.org).
-
-The following form submission button should set up the submission email automatically if the email features of your web browser are properly configured:
-
- <form enctype=text/plain action="mailto:other-cdwrite-request at lists.debian.org">
- <b>
- <input type=hidden name="# Cdwrite list" value="
-subscribe cdwrite">
- <input type=submit value="Subscribe to the cdwrite mailing list">
- </b>
- </form><p>
-
-Otherwise, subscribe by sending mail to <a
-href="mailto:other-cdwrite-request at lists.debian.org">other-cdwrite-request at lists.debian.org</a>
-containing only the word <strong>subscribe</strong> in the body. Do
-not send subscription requests directly to the main list.<p>
-
<hr>
<a name=devstatus>
<h2>What is Paranoia IV's current development status?</h2>
-Paranoia IV code will soon be available for internal evaluation,
-testing and development work to the developers involved in the
-Paranoia project; read-only <a href="/svn">Subversion</a> access
-is also available. A public release does not yet set for any firm date.<p>
+Paranoia IV has been on haitus for several years while Xiph.Org
+concentrated on other projects such as Ogg. It was originally intended
+to be little more than a more cross-platform update of Paranoia-III
+that included other devices; although the project drew some outside
+interest, it's not clear there's any great need for it.<p>
-Those interested in contributing to the development of Paranoia, or
-who wich to contribute to porting to other platforms, please <a
-href="mailto:monty at xiph.org">contact us</a>. Paranoia IV prerelease
-code will be available to porters soon; I prefer to be in contact with
-those porting to other platforms so that Paranoia development has
-consistent quality across platforms.<p>
+Since Paranoia III was originally declared 'finished' in 1999
+(subsequent releases have mostly just been to fix bugs and keep up
+with kernel changes), a number of features that once existed only on
+very expensive CDROM drives have become more widespread. In
+particular, drives today are much more capable of fine-grained
+reporting of media damage. Thus Paranoia IV is now intended to be an
+update of Paranoia III that improves error handling and reconstruction
+ability.
-At the moment, volunteers have contacted me for most major platforms,
-but more help is still welcome on every OS.<p>
-
<hr>
-<a name=merge>
-<h2>Will cdparanoia, and cdda2wav or xcdroast merge anytime in the future?</h2>
-
-Probably not beyond the point it already has. Versions of XCDRoast
-(and other GUI frontends; see the <a href=links.html>links page</a>)
-that make use of cdparanoia already exist.<p>
-
-Although the cdrecord/cdda2wav and Paranoia projects cooperate,
-they're likely to remain seperate as the former is committed to Joerg
-Schilling's libscg (part of the <a
-href="http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html">cdrecord
-package</a>), just as cdparanoia is committed to using Paranoia IV.<p>
-
-
-
-<hr>
<h1>Questions about using Paranoia and cdparanoia</h1>
<a name=req>
<h2>
-Requirements to run cdparanoia (as of alpha 3)
+Requirements to run cdparanoia 10
</h2>
<ol>
-<li>A CDDA capable CDROM drive</li>
-<li> Linux 2.0, 2.1 or 2.2
+<li>A CDDA capable CDROM drive (in 2006, virtually all CDROm drives are)</li>
+<li> Linux 2.0 through 2.2:
<ol>
<li>kernel support for the particular CDROM in use</li>
<li>kernel support for the generic SCSI interface (if using a SCSI
@@ -414,6 +338,10 @@
with the MAKEDEV script) in /dev. Most distributions
already have the /dev/sg? files.</li>
</ol>
+<li> Linux 2.4, through 2.6:
+<ol>
+ <li>kernel support for either the generic SCSI of SG_IO interfaces; most modern kernels are built with SG_IO by default.
+ </ol>
</ol>
The cdparanoia binary will likely work with Linux 1.2 and 1.3, but I
@@ -422,39 +350,29 @@
the problems are mostly related to the ever-changing locations of
proprietary cdrom include files.<p>
-Also, although a stock SCSI setup will work, performance will be
-better if linux/include/scsi/sg.h defines SG_BIG_BUFF to 65536 (it
-can't be bigger). Recent kernels (2.0.x+?) already set it to 32768;
-that's OK. Cdparanoia will tell you how big your generic SCSI buffer
-is.<p>
-
-Unlike cdda2wav, cdparanoia does not require threading, IPC or
-(optionally) sound card support. /proc filesystem support is no
-longer required (but encouraged!), and /dev/sr? or /dev/scd? devices
-are not required for SCSI, although they do add functionality if
-present.<p>
-
<hr>
<a name=supp>
<h2>
-Does Cdparanoia support ATAPI drives? SCSI Emulation? Parallel port drives?
+Does Cdparanoia support ATAPI drives? SCSI Emulation? USB drives? Parallel port drives?
</h2>
-Alpha 9 supports the full ATAPI, IDE-SCSI and SCSI generic interfaces
-under Linux.<p>
+Cdparanoia 9 and 10 support the full ATAPI, IDE-SCSI and SCSI generic
+interfaces under Linux. Cdparanoia 10 adds SG_IO support, which it
+the default interface for all modern CDROM drives under linux 2.6. <p>
-Note that the native ATAPI driver is supported, but that IDE-SCSI
-emulation works better with ATAPI drives. This is an issue of
-control; the emulation interface gives cdparanoia complete control
-over the drive whereas the native ATAPI driver insists on hiding the
-device under an abstraction layer with poor error handling
-capabilities. Note also that a number of ATAPI drives that do not
-work at all with the ATAPI driver (error 006: Could not read audio)
-*will* work with IDE-SCSI emulation.<p>
+Note that the native 'cooked' ATAPI driver is supported, but should be
+considered deprecated; SG_IO and IDE-SCSI emulation both work better
+with ATAPI drives. This is an issue of control; the other interfaces
+gives cdparanoia complete control over the drive whereas the native
+ATAPI driver insists on hiding the device under an abstraction layer
+with poor error handling capabilities. Note also that a number of
+ATAPI drives that do not work at all with the ATAPI driver (error 006:
+Could not read audio) *will* work with SG_IO and IDE-SCSI
+emulation.<p>
-Parallel port based CDROM (paride) drives are not yet supported;
-support for these drives in Linux will appear in alpha release 10
-(Paranoia IV).
+USB drives are fully supported through the SG_IO and SG interfaces.<p>
+
+Parallel port based CDROM (paride) drives are not yet explicitly supported.
<p>
<hr>
@@ -585,8 +503,7 @@
<a name=toc>
<h2>Can cdparanoia detect pregaps? Can it remove the two second gaps between tracks</h2>
-Not yet. This feature is slated to appear in a release of alpha 10
-(Paranoia IV).<p>
+Not yet. This feature is slated to appear in Paranoia IV.<p>
<hr>
<a name=gimme>
@@ -824,6 +741,10 @@
<a name=bigbuff>
<h2>(Linux only) What is the biggest value of SG_BIG_BUFF I can use?</h2>
+<em>[note: This question only applies to the SG kernel interface;
+cdparanoia 10 prefers the 2.6 kernel's new SG_IO interface. Only
+users with older kernels care about SG.]<em><p>
+
65536 (64 kilobytes). Some motherboards can use 128kB DMA, but
attempting to use 128kB DMA on a machine that can't do it will crash
the machine. Cdparanoia will not use larger than 64kB requests.<p>
@@ -832,7 +753,7 @@
<a name=diff>
<h2>Why do the binary files from two reads differ when compared?</h2>
-The problem is the beginning point of the read. Cdparanoia enforces
+The usual problem is the beginning point of the read. Cdparanoia enforces
consistency from whatever the drive considers to be the starting point
of the data, and the drive is returning a slightly different beginning
point each time. The beginning point should not vary by much, and if
@@ -841,6 +762,9 @@
the read; scratch correction or any reported skips will very likely
also result in different files).<p>
+It is also possible to get different reads if the media is damaged and
+cdparanoia is unable to deterministically repair the error.<p>
+
<hr>
<a name=cdr>
<h2>Why do CDParanoia, CDDA2WAV et al. rip files off into WAV
@@ -883,8 +807,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/index.html
===================================================================
--- websites/xiph.org/paranoia/index.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/index.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -86,25 +86,23 @@
<hr>
<p align=left>
-March 27, 2001
+August 29, 2006
<p align=left>
<!-- body or table of contents -->
<strong>Current stable release version</strong>: cdparanoia III 9.8<br>
-<strong>Most current version</strong>: see <a href="/svn">Subversion</a> (Currently matches 9.8 release)
+<strong>Current test version</strong>: cdparanoia III 10pre0<br>
+<strong>Most current version</strong>: see <a href="http://svn.xiph.org/trunk/cdparanoia">Subversion</a> (Currently matches 10pre0 release)
<p align=left>
This is the main distribution site for the <a
href="faq.html#paranoia">Paranoia project libraries</a> (<a
-href="faq.html#versions">Paranoia II through IV</a>) and the audio CD
+href="faq.html#versions">Paranoia II an III</a>) and the audio CD
digital audio extraction application <a
href="faq.html#cdparanoia">cdparanoia</a>. Cdparanoia extracts audio
from compact discs directly as data, <a href="faq.html#analog">with no
analog step between</a>, and writes the data to a file or pipe in WAV,
-AIFC, AIFC or raw 16 bit linear PCM. <a href="faq.html#paranoia">The
-Paranoia IV library</a> (to be released with cdparanoia as alpha 10)
-is a larger effort to provide uniform generic (packet) and specialized
-interfaces across platforms.
+AIFC, AIFC or raw 16 bit linear PCM.
<p align=left>
New happenings,
@@ -149,8 +147,8 @@
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
@@ -158,7 +156,7 @@
<a href=../xiphname.html>Cdparanoia</a> and the <a
href=../xiphname.html>Laser-Playback-Head-of-Omniscience logo</a> are
trademarks (tm) of <a href="/index.html">Xiph.Org</a>. These pages
- are copyright (C) 1994-2002 Xiph.Org. All rights reserved.<br>
+ are copyright (C) 1994-2006 Xiph.Org. All rights reserved.<br>
<a href="mailto:webmaster at xiph.org">Comments and
questions</a> about this web site are welcome.
Modified: websites/xiph.org/paranoia/links.html
===================================================================
--- websites/xiph.org/paranoia/links.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/links.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -90,7 +90,7 @@
<hr>
<p align=left>
-February 5, 2002
+August 29, 2006
<p align=left>
<!-- body or table of contents -->
@@ -104,41 +104,17 @@
to the discussion and development lists. There is no reason to join
the announce list if you subscribe to either/both of the other two.<p>
-Assuming that the email preferences in your web browser are set up
-correctly, the following button sends a subscription request directly
-to xiph.org. You'll get an email back with the result; the submit
-button does not take you to another page.
+<ul>
+<li>
+<a href="http://lists.xiph.org/mailman/listinfo/paranoia-announce">
+Announcement mailing list page for new Paranoia releases</a><br>
+<li>
+<a href="http://lists.xiph.org/mailman/listinfo/paranoia">
+Mailing list for Paranoia and Cdparanoia users (paranoia at xiph.org)</a>
+</ul>
- <form enctype=text/plain action="mailto:majordomo at xiph.org">
- <b>
- <input type=hidden name="# Paranoia user list" value="
-subscribe paranoia">
- <input type=submit value="Subscribe to Paranoia user discussion">
- </b>
- </form>
-
- <form enctype=text/plain action="mailto:majordomo at xiph.org">
- <b>
- <input type=hidden name="# Paranoia announce list" value="
-subscribe paranoia-announce">
- <input type=submit value="Subscribe to Paranoia announcements">
- </b>
- </form>
-
-The traditional way to join: send a message containing only the
-one-word line 'subscribe' in the body to <a
-href="mailto:paranoia-request at xiph.org">paranoia-request at xiph.org</a>
-or <a
-href="mailto:paranoia-announce-request at xiph.org">paranoia-announce-request at xiph.org</a>. Do
-not send subscription requests directly to the main list. The list
-server at xiph.org should respond fairly quickly with a welcome
-message.<p>
-
-The list is archived on the xiph.org <a
-href="http://www.xiph.org/archives/">mailing list archive</a> page.<p>
-
<h3>
-Mailing list for Paranoia IV developers: paranoia-dev at xiph.org
+Mailing list for Paranoia developers: paranoia-dev at xiph.org
</h3>
The developers list is intended for focused development discussion
@@ -146,27 +122,12 @@
developing their own applications using Paranoia. Of course, anyone
is welcome to read.<p>
-Assuming that the email preferences in your web browser are set up
-correctly, the following button sends a subscription request directly
-to xiph.org. You'll get an email back with the result; the submit
-button does not take you to another page.
+<ul>
+<li>
+<a href="http://lists.xiph.org/mailman/listinfo/paranoia-dev">
+Mailing list for Paranoia developers: paranoia-dev at xiph.org</a>
+</ul>
- <form enctype=text/plain action="mailto:majordomo at xiph.org">
- <b>
- <input type=hidden name="# Paranoia user list" value="
-subscribe paranoia-dev">
- <input type=submit value="Subscribe to Paranoia developers">
- </b>
- </form><p>
-
-Tradiitonal method: send a message containing only the one-word line
-'subscribe' in the body to <a
-href="mailto:paranoia-dev-request at xiph.org">paranoia-dev-request at xiph.org</a>.
-Do not send subscription requests directly to the main list.<p>
-
-The list is archived on the xiph.org <a
-href="http://www.xiph.org/archives/">mailing list archive</a> page.<p>
-
<h3>
List for general CDROM tools
</h3>
@@ -198,7 +159,7 @@
<li><a href='http://tcvp.sf.net/'>TCVP</a>: a video and music player, among other things. It rips CDs.
<p>
-<li><a href="http://userpage.fu-berlin.de/~mbayer/tools/">dekagen</a>: dekagen is a bourne shell script that automates the ripping, encoding, and naming of music data that comes from CD and will be saved in Ogg Vorbis files, using programs like cdparanoia, and oggenc. <p>
+<li><a href="http://userpage.fu-berlin.de/~mbayer/tools/dekagen.html">dekagen</a>: dekagen is a bourne shell script that automates the ripping, encoding, and naming of music data that comes from CD and will be saved in Ogg Vorbis files, using programs like cdparanoia, and oggenc. <p>
<li><a href="http://www.nostatic.org/grip/">grip</a>: Grip
is a gtk-based cd-player and cd-ripper. It has the ripping
@@ -211,14 +172,14 @@
<li><a
-href="http://ripperx.sourceforge.net/">ripperX</a>:
+href="http://sourceforge.net/projects/ripperx/">ripperX</a>:
An X front end for cdparanoia and the 8Hz-mp3 MPEG encoder. Rips
directly from CD to MPEG layer 3.<p>
<li><a href="http://www.xcdroast.org/">X-CD-Roast</a>: This is a version of the well known intergrated CD
ripper and burner which uses cdparanoia as its ripping engine.<p>
-<li><a href="http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html">cdrecord</a>: the venerable, all-purpose, runs-anywhere TAO/DAO cd burning tool by Joerg Schilling. <p>
+<li><a href="http://cdrdao.sourceforge.net/">CDRDAO</a>: The original disk-at-once burning tool for Linux/UNIX.<p>
</ul>
@@ -230,17 +191,9 @@
<li><a href="http://www.cd-info.com/CDIC/Bibliography.html">A links page for a large number of CDROM sites and references</a><p>
-<li><a href="http://www.pacwest.net/byron13/sam/cdfaq.htm">Document on
-the repqir and troubleshooting of CD drives/players</a>. Also has
-interesting tech tidbits on CDs themselves.<p>
-
<li><a href="http://www.cdrfaq.org/faq02.html#S2">Information about the
physical properties/encoding of a CD</a><p>
-<li><a href="http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdb.html">
-the unix cd building project</a>: Joerg Schilling's grandaddy of all UNIX CDD
-related sites. Highly informational.<p>
-
<li><a href="http://www.mit.edu/afs/sipb.mit.edu/contrib/doc/specs/protocol/scsi-2/s2-r10l.txt">SCSI-2 spec (text)</a>: A text copy of the complete SCSI-2 packet
command specification.<p>
@@ -278,8 +231,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
@@ -287,7 +240,7 @@
<a href=../xiphname.html>Cdparanoia</a> and the <a
href=../xiphname.html>Laser-Playback-Head-of-Omniscience logo</a> are
trademarks (tm) of <a href="/index.html">Xiph.Org</a>. These pages
- are copyright (C) 1994-2002 Xiph.Org. All rights reserved.<br>
+ are copyright (C) 1994-2006 Xiph.Org. All rights reserved.<br>
<a href="mailto:webmaster at xiph.org">Comments and
questions</a> about this web site are welcome.
Modified: websites/xiph.org/paranoia/manual.html
===================================================================
--- websites/xiph.org/paranoia/manual.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/manual.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -88,169 +88,210 @@
<hr>
<p align=left>
-August 25, 1999
+August 29, 2006
<p align=center>
<!-- body or table of contents -->
-<img src=wait.gif><br><em>Apologies; this page is still under
-construction. At the moment, this document contains only the
-cdparanoia 9.4 manpage.</em><p>
+<em>At the moment, this document contains only the
+cdparanoia 10pre0 manpage.</em><p>
-Japanese manpage available for <a
+Japanese manpage for cdparanoia 9.8 available for <a
href="http://cvs.linux.or.jp/JM/manual/cdparanoia/release/man1/cdparanoia.1">download</a> or <a
href="manualj.html">viewing as HTML</a>.
<pre>
-<font face="courier" color="#000080">
-CDPARANOIA(1) CDPARANOIA(1)
+CDPARANOIA(1) CDPARANOIA(1)
+
NAME
- cdparanoia (Paranoia release III) - an audio CD reading
- utility which includes extra data verification features
+ cdparanoia 10.0 (Paranoia release III) - an audio CD reading utility
+ which includes extra data verification features
-DATE
- version III release alpha 9 (03 Dec 1998)
-
SYNOPSIS
cdparanoia [options] span [outfile]
DESCRIPTION
- cdparanoia retrieves audio tracks from CDDA capable CDROM
- drives. The data can be saved to a file or directed to
- standard output in WAV, AIFF, AIFF-C or raw format. Most
- ATAPI, SCSI and several proprietary CDROM drive makes are
- supported; cdparanoia can determine if the target drive is
- CDDA capable.
+ cdparanoia retrieves audio tracks from CDDA capable CDROM drives. The
+ data can be saved to a file or directed to standard output in WAV,
+ AIFF, AIFF-C or raw format. Most ATAPI, SCSI and several proprietary
+ CDROM drive makes are supported; cdparanoia can determine if the target
+ drive is CDDA capable.
- In addition to simple reading, cdparanoia adds extra-
- robust data verification, synchronization, error handling
- and scratch reconstruction capability.
+ In addition to simple reading, cdparanoia adds extra-robust data veri-
+ fication, synchronization, error handling and scratch reconstruction
+ capability.
OPTIONS
-v --verbose
- Be absurdly verbose about the autosensing and read-
- ing process. Good for setup and debugging.
+ Be absurdly verbose about the autosensing and reading process.
+ Good for setup and debugging.
+
-q --quiet
- Do not print any progress or error information dur-
- ing the reading process.
+ Do not print any progress or error information during the read-
+ ing process.
+
-e --stderr-progress
- Force output of progress information to stderr (for
- wrapper scripts).
+ Force output of progress information to stderr (for wrapper
+ scripts).
+
-V --version
Print the program version and quit.
+
-Q --query
- Perform CDROM drive autosense, query and print the
- CDROM table of contents, then quit.
+ Perform CDROM drive autosense, query and print the CDROM table
+ of contents, then quit.
+
-s --search-for-drive
- Forces a complete search for a cdrom drive, even if
- the /dev/cdrom link exists.
+ Forces a complete search for a cdrom drive, even if the
+ /dev/cdrom link exists.
+
-h --help
- Print a brief synopsis of cdparanoia usage and
- options.
+ Print a brief synopsis of cdparanoia usage and options.
+
-p --output-raw
- Output headerless data as raw 16 bit PCM data with
- interleaved samples in host byte order. To force
- little or big endian byte order, use -r or -R as
- described below.
+ Output headerless data as raw 16 bit PCM data with interleaved
+ samples in host byte order. To force little or big endian byte
+ order, use -r or -R as described below.
+
-r --output-raw-little-endian
- Output headerless data as raw 16 bit PCM data with
- interleaved samples in LSB first byte order.
+ Output headerless data as raw 16 bit PCM data with interleaved
+ samples in LSB first byte order.
+
-R --output-raw-big-endian
- Output headerless data as raw 16 bit PCM data with
- interleaved samples in MSB first byte order.
+ Output headerless data as raw 16 bit PCM data with interleaved
+ samples in MSB first byte order.
+
-w --output-wav
- Output data in Micro$oft RIFF WAV format (note that
- WAV data is always LSB first byte order).
+ Output data in Microsoft RIFF WAV format (note that WAV data is
+ always LSB first byte order).
+
-f --output-aiff
- Output data in Apple AIFF format (note that AIFC
- data is always in MSB first byte order).
+ Output data in Apple AIFF format (note that AIFC data is always
+ in MSB first byte order).
+
-a --output-aifc
- Output data in uncompressed Apple AIFF-C format
- (note that AIFF-C data is always in MSB first byte
- order).
+ Output data in uncompressed Apple AIFF-C format (note that AIFF-
+ C data is always in MSB first byte order).
- -i --output-info file
- Output a log file containing autosensing informa-
- tion, events during the reading process, locations
- of fixups and detected scratches, and general
- statistics.
-B --batch
- Cdda2wav-style batch output flag; cdparanoia will
- split the output into multiple files at track
- boundaries. Output file names are prepended with
- 'track#.'
+ Cdda2wav-style batch output flag; cdparanoia will split the out-
+ put into multiple files at track boundaries. Output file names
+ are prepended with 'track#.'
+
+
-c --force-cdrom-little-endian
- Some CDROM drives misreport their endianness (or do
- not report it at all); it's possible that
- cdparanoia will guess wrong. Use -c to force
- cdparanoia to treat the drive as a little endian
+ Some CDROM drives misreport their endianness (or do not report
+ it at all); it's possible that cdparanoia will guess wrong. Use
+ -c to force cdparanoia to treat the drive as a little endian
device.
+
-C --force-cdrom-big-endian
- As above but force cdparanoia to treat the drive as
- a big endian device.
+ As above but force cdparanoia to treat the drive as a big endian
+ device.
- -n --force-default-sectors n
- Force the interface backend to do atomic reads of n
- sectors per read. This number can be misleading;
- the kernel will often split read requests into mul-
- tiple atomic reads (the automated Paranoia code is
- aware of this) or allow reads only wihin a
- restricted size range. This option should gener-
- ally not be used.
- -d --force-cdrom-device device
- Force the interface backend to read from device
- rather than the first readable CDROM drive it
- finds. This can be used to specify devices of any
- valid interface type (ATAPI, SCSI or proprietary).
+ -n --force-default-sectors _
+ Force the interface backend to do atomic reads of n sectors per
+ read. This number can be misleading; the kernel will often
+ split read requests into multiple atomic reads (the automated
+ Paranoia code is aware of this) or allow reads only wihin a
+ restricted size range. This option should generally not be
+ used.
- -g --force-generic-device device
- This option is used along with -d when one wants
- explicit control in setting both the SCSI cdrom and
- generic devices seperately. This option is only
- useful on non-standard SCSI setups.
+ -d --force-cdrom-device ______
+ Force the interface backend to read from device rather than the
+ first readable CDROM drive it finds. This can be used to spec-
+ ify devices of any valid interface type (ATAPI, SCSI or propri-
+ etary).
+
+
+ -g --force-generic-device ______
+ This option forces use of the old 'generic scsi' (sg) kernel
+ interface with the specified generic scsi device. -g may be
+ used with -d to explicitly set both the SCSI cdrom and generic
+ (sg) devices seperately. This option is only useful on non-stan-
+ dard SCSI setups and when using the generic scsi (sg) driver.
+
+
+ -S --force-read-speed ______
+ Use this option explicitly to set the read rate of the CD drive
+ (where supported). This can reduce underruns on machines with
+ slow disks, or which are low on memory.
+
+
+ -t --toc-offset ______
+ Use this option to force the entire disc LBA addressing to shift
+ by the given amount; the value is added to the beginning offsets
+ in the TOC. This can be used to shift track boundaries for the
+ whole disc manually on sector granularity. The next option does
+ something similar...
+
+
+ -T --toc-bias
+ Some drives (usually random Toshibas) report the actual track
+ beginning offset values in the TOC, but then treat the beginning
+ of track 1 index 1 as sector 0 for all read operations. This
+ results in every track seeming to start too late (losing a bit
+ of the beginning and catching a bit of the next track). -T
+ accounts for this behavior. Note that this option will cause
+ cdparanoia to attempt to read sectors before or past the known
+ user data area of the disc, resulting in read errors at disc
+ edges on most drives and possibly even hard lockups on some
+ buggy hardware.
+
+
+ -O --sample-offset ______
+ Use this option to force the entire disc to shift sample posi-
+ tion output by the given amount; This can be used to shift track
+ boundaries for the whole disc manually on sample granularity.
+ Note that this will cause cdparanoia to attempt to read partial
+ sectors before or past the known user data area of the disc,
+ probably causing read errors on most drives and possibly even
+ hard lockups on some buggy hardware.
+
+
+
-Z --disable-paranoia
- Disable data verification and correction features.
- When using -Z, cdparanoia reads data exactly as
- would cdda2wav with an overlap setting of zero.
- This option implies that and -Y are active, but is
- not equivalent to -Z -W -X -Y as the -W through -Z
- options specify layered levels of verification.
- The last specified option takes precedence.
+ Disable all data verification and correction features. When
+ using -Z, cdparanoia reads data exactly as would cdda2wav with
+ an overlap setting of zero. This option implies that -Y is
+ active.
+
+ -z --never-skip[=max_retries]
+ Do not accept any skips; retry forever if needed. An optional
+ maximum number of retries can be specified; for comparison,
+ default without -z is currently 20.
+
+
-Y --disable-extra-paranoia
- Disables intra-read data verification; only overlap
- checking at read boundaries is performed.
+ Disables intra-read data verification; only overlap checking at
+ read boundaries is performed. It can wedge if errors occur in
+ the attempted overlap area. Not recommended.
- -X --disable-scratch-detection
- Neither look for scratches nor perform scratch-tol-
- erant synchronization during verification. With -X
- specified, a scratched disc will cause cdparanoia
- to abort its read.
- -W --disable-scratch-repair
- Detect and hold sync across scratches, but do not
- attempt any repair of damaged data. If an info
- file is in use (-i) log the frame positions of all
- scratches.
+ -X --abort-on-skip
+ If the read skips due to imperfect data, a scratch, whatever,
+ abort reading this track. If output is to a file, delete the
+ partially completed file.
OUTPUT SMILIES
@@ -260,11 +301,10 @@
:-/ Read drift
- :-P Unreported loss of streaming in atomic read opera-
- tion
+ :-P Unreported loss of streaming in atomic read operation
- 8-| Finding read problems at same point during reread;
- hard to correct
+ 8-| Finding read problems at same point during reread; hard to cor-
+ rect
:-0 SCSI/ATAPI transport error
@@ -272,20 +312,21 @@
;-( Gave up trying to perform a correction
+ 8-X Aborted read due to known, uncorrectable error
+
:^D Finished extracting
PROGRESS BAR SYMBOLS
- <space>
- No corrections needed
+ ' ' No corrections needed
- Jitter correction required
+ Unreported loss of streaming/other error in read
- ! Errors found after stage 1 correction; the drive is
- making the same error through multiple re-reads,
- and cdparanoia is having trouble detecting them.
+ ! Errors found after stage 1 correction; the drive is making the
+ same error through multiple re-reads, and cdparanoia is having
+ trouble detecting them.
e SCSI/ATAPI transport error (corrected)
@@ -293,105 +334,97 @@
SPAN ARGUMENT
- The span argument specifies which track, tracks or subsec-
- tions of tracks to read. This argument is required.
- NOTE: Unless the span is a simple number, it's generally a
- good idea to quote the span argument to protect it from
- the shell.
+ The span argument specifies which track, tracks or subsections of
+ tracks to read. This argument is required. NOTE: Unless the span is a
+ simple number, it's generally a good idea to quote the span argument to
+ protect it from the shell.
- The span argument may be a simple track number or an
- offset/span specification. The syntax of an offset/span
- takes the rough form:
+ The span argument may be a simple track number or an offset/span speci-
+ fication. The syntax of an offset/span takes the rough form:
1[ww:xx:yy.zz]-2[aa:bb:cc.dd]
- Here, 1 and 2 are track numbers; the numbers in brackets
- provide a finer grained offset within a particular track.
- [aa:bb:cc.dd] is in hours/minutes/seconds/sectors format.
- Zero fields need not be specified: [::20], [:20], [20],
- [20.], etc, would be interpreted as twenty seconds, [10:]
- would be ten minutes, [.30] would be thirty sectors (75
+ Here, 1 and 2 are track numbers; the numbers in brackets provide a
+ finer grained offset within a particular track. [aa:bb:cc.dd] is in
+ hours/minutes/seconds/sectors format. Zero fields need not be speci-
+ fied: [::20], [:20], [20], [20.], etc, would be interpreted as twenty
+ seconds, [10:] would be ten minutes, [.30] would be thirty sectors (75
sectors per second).
- When only a single offset is supplied, it is interpreted
- as a starting offset and ripping will continue to the end
- of he track. If a single offset is preceeded or followed
- by a hyphen, the implicit missing offset is taken to be
- the start or end of the disc, respectively. Thus:
+ When only a single offset is supplied, it is interpreted as a starting
+ offset and ripping will continue to the end of the track. If a single
+ offset is preceeded or followed by a hyphen, the implicit missing off-
+ set is taken to be the start or end of the disc, respectively. Thus:
1:[20.35]
- Specifies ripping from track 1, second 20, sector
- 35 to the end of track 1.
+ Specifies ripping from track 1, second 20, sector 35 to the end
+ of track 1.
1:[20.35]-
- Specifies ripping from 1[20.35] to the end of the
- disc
+ Specifies ripping from 1[20.35] to the end of the disc
- -2 Specifies ripping from the beginning of the disc up
- to (and including) track 2
+ -2 Specifies ripping from the beginning of the disc up to (and
+ including) track 2
-2:[30.35]
- Specifies ripping from the beginning of the disc up
- to 2:[30.35]
+ Specifies ripping from the beginning of the disc up to 2:[30.35]
- 2-4 Specifies ripping from the beginning of track two
- to the end of track 4.
+ 2-4 Specifies ripping from the beginning of track 2 to the end of
+ track 4.
- Again, don't forget to protect square brackets and pre-
- ceeding hyphens from the shell.
+ Again, don't forget to protect square brackets and preceeding hyphens
+ from the shell.
EXAMPLES
A few examples, protected from the shell:
- Query only with exhaustive search for a drive and full
- reporting of autosense:
+ Query only with exhaustive search for a drive and full reporting of
+ autosense:
cdparanoia -vsQ
- Extract an entire disc, putting each track in a seperate
- file:
+ Extract an entire disc, putting each track in a seperate file:
- cdparanoia -B "1-"
+ cdparanoia -B
Extract from track 1, time 0:30.12 to 1:10.00:
cdparanoia "1[:30.12]-1[1:10]"
- Extract one minute from track 1, starting at time 0:30.12:
+ Extract from the beginning of the disc up to track 3:
- cdparanoia "1[:30.12]-[1:00]"
+ cdparanoia -- "-3"
+ The "--" above is to distinguish "-3" from an option flag.
OUTPUT
- The output file argument is optional; if it is not speci-
- fied, cdparanoia will output samples to one of cdda.wav,
- cdda.aifc, or cdda.raw depending on whether -w, -a, -r or
- -R is used (-w is the implicit default). The output file
- argument of - specifies standard output; all data formats
- may be piped.
+ The output file argument is optional; if it is not specified, cdpara-
+ noia will output samples to one of cdda.wav, cdda.aifc, or cdda.raw
+ depending on whether -w, -a, -r or -R is used (-w is the implicit
+ default). The output file argument of - specifies standard output; all
+ data formats may be piped.
ACKNOWLEDGEMENTS
- Cdparanoia sprang from and once drew heavily from the
- interface of Heiko Eissfeldt's (heiko at colossus.escape.de)
- 'cdda2wav' package. Cdparanoia would not have happened
- without it.
+ Cdparanoia sprang from and once drew heavily from the interface of
+ Heiko Eissfeldt's (heiko at colossus.escape.de) 'cdda2wav' package.
+ Cdparanoia would not have happened without it.
- Joerg Schilling has also contributed SCSI expertise
- through his generic SCSI transport library.
+ Joerg Schilling has also contributed SCSI expertise through his generic
+ SCSI transport library.
AUTHOR
Monty <monty at xiph.org>
- Cdparanoia's homepage may be found at:
+ Cdparanoia's homepage may be found at: http://www.xiph.org/paranoia/
- http://www.xiph.org/paranoia/index.html
-</font>
+ 29 Aug 2006 CDPARANOIA(1)
+
</pre>
@@ -443,8 +476,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/manualj.html
===================================================================
--- websites/xiph.org/paranoia/manualj.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/manualj.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -485,8 +485,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/news.html
===================================================================
--- websites/xiph.org/paranoia/news.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/news.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -86,43 +86,21 @@
<hr>
<p align=left>
-March 27, 2001
+August 29, 2006
<p align=left>
<!-- body or table of contents -->
<p align=left>
-<strong>Things on hold for now:</strong>
+<strong>cdparanoia 10 prerelease now up for testing</strong>
+<p>
-No, that doesn't mean the project is dead, just that active
-development is on hold while we throw all the time we have available
-to get <a href="/ogg/vorbis/">OggVorbis</a> to 1.0 in a reasonable
-amount of time. Once Vorbis hits 1.0, we'll get back to Paranoia.<p>
+The upcoming release is intended to keep up with bugfixes and kernel
+changes over the past few years. Cdparanoia 10 is intended to be the
+last major release of the Paranoia III series (which maintains
+out-of-the-box compatability with linux kernels all the way back to
+Linux 2.0) before restarting development of Paranoia IV, which will be
+a clean break with the older versions.<p>
-<p align=left>
-<strong>9.8 released for Linux:</strong>
-
-<p align=left>
-This is an update release to keep up with contributed patches, bugs
-and kernel updates. The <a
-href="http://www.xiph.org/archives/paranoia-announce/0004.html">release
-announcement for 9.8</a> is available in the mail archive.<p>
-
-<p align=left>
-A Japanese manpage (courtesy of Teruyoshi Fujiwara
-fjwr at mtj.biglobe.ne.jp) is available for <a
-href="http://cvs.linux.or.jp/JM/manual/cdparanoia/release/man1/cdparanoia.1">download</a> or <a
-href="manualj.html">viewing as HTML</a>.
-
-<p align=left>
-<strong>Cdparanoia mailing lists now active; Subversion access to Paranoia IV
-development is available</strong><p>
-
-See <a href="links.html">the links/resources page</a> for mailing list
-subscription information and <a
-href="http://www.xiph.org/svn">the Subversion page</a> for Subversion
-access instructions.
-
-
<p>
@@ -149,8 +127,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/prog.html
===================================================================
--- websites/xiph.org/paranoia/prog.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/prog.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -116,8 +116,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/tech.html
===================================================================
--- websites/xiph.org/paranoia/tech.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/tech.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -122,8 +122,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
Modified: websites/xiph.org/paranoia/trouble.html
===================================================================
--- websites/xiph.org/paranoia/trouble.html 2006-08-30 01:21:13 UTC (rev 11815)
+++ websites/xiph.org/paranoia/trouble.html 2006-08-30 01:22:25 UTC (rev 11816)
@@ -87,7 +87,7 @@
<hr>
<p align=left>
-December 14, 1999
+August 29, 2006
<p align=left>
<!-- body or table of contents -->
@@ -95,8 +95,16 @@
This document describes common problems using cdparanoia. Note that
"troubleshooting" addresses examples of system setup or 'pilot error'.
Bugs in Paranoia are documented elsewhere (on the <a
-href="bugs.html">bugs page</a>).
+href="bugs.html">bugs page</a>).<p>
+<em>A quick note:</em> Long ago, the only ways to read from a cdrom
+were to use one of two interfaces, the 'ATAPI cooked ioctl' interface
+or the 'generic scsi (SG)' interface. The setup and usage of these
+interfaces could be very tricky for users, and much of theis FAQ deals
+with these now-dead methods. If you're using cdparanoia 10 and a
+modern (2.6 or later) Linux kernel, chances are that nothing below
+about 'SG' or 'cooked ioctl()' interface applies to you.<p>
+
<h1>Table of contents</h1>
<ol>
@@ -166,19 +174,23 @@
<a name="gendev">
<h2>Cdparanoia says "could not find generic device to match SCSI cdrom device"</h2>
+[this error happens only when using the SG interface; modern kernels
+offer a newer SG_IO interface which is preferred by cdparanoia]
+
This error means exactly what it says; the generic SCSI devices are
missing, unusable or have permissions set to deny access by users.
First, a bit of explanation...<p>
-Cdparanoia doesn't actually use the 'normal' SCSI cdrom device,
-typically /dev/scd* or /dev/sr*; it uses (and requires) a generic SCSI
-device (typically /dev/sg*) to access a drive's audio extraction
-features. Cdparanoia does accept the CDROM device name because users
-are used to this device specifying a cdrom drive, but only uses the
-CDROM device name to map to a matching generic SCSI device.<p>
+When using the old 'sg' (scsi generic) interface, cdparanoia doesn't
+actually use the 'normal' SCSI cdrom device, typically /dev/scd* or
+/dev/sr*; it uses (and requires) a generic SCSI device (typically
+/dev/sg*) to access a drive's audio extraction features. Cdparanoia
+does accept the CDROM device name because users are used to this
+device specifying a cdrom drive, but only uses the CDROM device name
+to map to a matching generic SCSI device.<p>
If cdparanoia can't get to a working set of generic devices, it can't
-use a SCSI drive. Before sending mail, check that:
+use a SCSI drive with the sg interface. Before sending mail, check that:
<ol>
<li>The kernel has generic SCSI support compiled in (or the generic
@@ -202,11 +214,9 @@
Make sure you're using a WAV player that can play CD quality data. So
far, every case of a 'garbage' .WAV file has been due to a bad player.
-Note particularly that the 'play' utility packaged with RedHat is
-incapable of playing CD quality WAV files.<p>
+Note particularly that the 'play' utility packaged with old RedHat
+distros is incapable of playing CD quality WAV files.<p>
-Splay, aplay and Ogg (at the very least) can play CD quality audio correctly.<p>
-
<hr>
<a name=underrun>
<h2>(Linux) My ATAPI drive is *very* slow and /var/log/messages contains
@@ -217,43 +227,52 @@
driver, then tries to repeat the request (and likely gets the same
error again).<p>
-The solution (aside from fixing Linux) is to use your ATAPI drive with
-<a href="#useemu">IDE-SCSI hotadapter emulation</a>.<p>
+This error is rare these days as modern (2.6) Linux kernels offer a
+new default interface named SG_IO for raw access of IDE CDROMs, and
+cdparanoia 10 will use this interface by default. If you're stuck
+using an older version of linux without SG_IO (or an older versionof
+cdparanoia), the solution is to use your ATAPI drive with <a
+href="#useemu">IDE-SCSI hotadapter emulation</a>.<p>
<hr>
<a name=eightsec>
<h2>My ATAPI performance is slow; cdparanoia is slower on my ATAPI drive than cdda2wav.</h2>
-The Linux ATAPI ioctl()-based kernel drivel only reads 8 sectors from
-an audio CD at a time. If you tell it to read more than eight, it
-will divide the request up into 8-sector chunks. Alignment and jitter
-errors are most likely to happen on those boundaries. Cdparanois is
-aware of this, and thus only requests 8 sectors at a time when using
-the ATAPI interface.<p>
+Again, this problem is rare on 2.6 with the new SG_IO interface for ATAPI cdrom drives.
+On older kernels or with older versions of cdparanoia that are using
+the 'cooked ioctl()' kernel interface, the kernel only reads 8 sectors
+from an audio CD at a time. If you tell it to read more than eight,
+it will divide the request up into 8-sector chunks. Alignment and
+jitter errors are most likely to happen on those boundaries.
+Cdparanoia is aware of this, and thus only requests 8 sectors at a
+time when using the cooked ioctl() interface.<p>
+
The kernel overhead involved in each request is farily high, so this
is inefficient; however, the goal is to be correct, not fast.
cdparanoia is slower on ATAPI drives than, for example, cdda2wav
because it's being more careful (cdda2wav makes larger requests and
doesn't track boundaries).<p>
-If you're concerned about performance, use the SG driver and <a
+If you're concerned about performance and are stuck using an old
+kernel or old cdparanoia, use the SG driver and <a
name=underrun>IDE-SCSI hostadapter emulation</a>. SG is superior to
the ATAPI interface for several additional reasons.. However, if you
absolutely *must* use the ATAPI interface, the following
kernel/cdparanoia mods will help you out.<p>
-<ol>
+<ul>
<li>
In linux/drivers/block/ide-cdrom.h, increase the value of
CDROM_NBLOCKS_BUFFER from 8 to a larger value (eg, 16). Rebuild the
-kernel. <li>In cdparanoia/interface/cooked_interface.c, change the
-value of d->nsectors on line 205 to the same value you used int he
+kernel.
+<li>
+In cdparanoia/interface/cooked_interface.c, change the
+value of d->nsectors on line 205 to the same value you used in the
kernel.
</ul>
-
<p>
<hr>
<a name=exslow>
@@ -261,7 +280,7 @@
and CPU usage is 100%</h2>
Most likely, your using a drive that suffers from fragmentation with
-an older version of cdparanoia. Upgrade to the latest release.<p>
+an older version of cdparanoia. Upgrade to a recent release.<p>
<hr>
<a name=repslow>
@@ -343,11 +362,12 @@
the drive's positioning isn't exactly correct and it's managing to
read a bit too far.<p>
-The problem would not be serious except that the Linux ATAPI driver
-then tells the drive to retry.... and gets the same error which
-triggers a retry, etc. In this case, the solution, as above, is to
-use the drive with IDE-SCSI hostadapter emulation. The errors will
-become harmless.<p>
+The problem would not be serious except that the Linux cooked-ioctl
+kernel interface (used by older kernels and older versions of
+cdparanoia) automatically tells the drive to retry.... and gets the
+same error which triggers a retry, etc. In this case, the solution,
+as above, is to use the drive with IDE-SCSI hostadapter emulation.
+The errors will become harmless.<p>
Also, discs with sectors in the gaps between tracks marked as non-audio
are becoming more common. Some cdrom drives complain about it. Is
@@ -362,10 +382,13 @@
looking for the drive and the result of searching in each place.
Chances are the problem is one of two things:<p>
-<ul><li>Permission denied: a CDROM device must be readable, and a
-generic SCSI device must be readable and writable by the user for
-cdparanoia to work. <li>No such file or device: Support for the CDROM
-(or generic SCSI if a SCSI drive) is not built into the kernel.</ul><p>
+<ul><li>Permission denied: CDROM devices must be readable and writable
+by the user for cdparanoia to work (write access is required to send
+commands to the drive). When using the older SG interface, the CDROM
+and generic scsi devices both must be accessible. The newer SG_IO
+interface uses only the CDROM device.<li>No such file or device:
+Support for the CDROM (or generic SCSI if a drive is being used with
+SG) is not built into the kernel.</ul><p>
<hr>
<a name=longfind>
@@ -376,9 +399,12 @@
real device name of the CDROM drive. Things should become much faster.<p>
<hr>
<a name=bigbuff>
+
<h2>(Linux) I get an error about not having SG_BIG_BUFF defined in my kernel</h2>
-This was a common problem in Linux distributions until recently.
+[This note does not apply to modern (2.6) kernels]<p>
+
+This was a common problem in Linux distributions until about 1999.
Without the big buffer for generic SCSI reads, cdparanoia can only
read a single sector from a SCSI cdrom at a time. This is too small
for cdparanoia to function.<p>
@@ -393,16 +419,20 @@
<a name=emu>
<h2>(Linux) I'm trying to use an ATAPI drive with SCSI emulation (or a SCSI MMC drive), and I get a file full of zeroes (silence)!</h2>
-You are using an old version of cdparanoia that doesn;t know when a
+You are using an old version of cdparanoia that doesn't know when a
packet command has been rejected (this is actually hard to do under
Linux). Use alpha 6 or later.
<hr>
<a name=unable>
<h2>My ATAPI CDROM drive reports 'unable to read any data'!</h2>
+<em>The information below applies to older Linux kernels (2.4 and earlier)
+without the SG_IO interface, or older versions of cdparanoia (earlier
+than cdparanaoia 10) that could not use SG_IO.</em><p>
+
Chances are that the drive is not capable of reading audio discs. To
be certain, try using the drive under Linux IDE-SCSI emulation rather
-than with the native ATAPI driver. The emulation is more flexible,
+than with the cooked ioctl ATAPI driver. The emulation is more flexible,
and cdparanoia will be able to try more possible read techniques.<p>
Note that a few Matsushita drives (and Panasonics which are made by
@@ -421,14 +451,19 @@
<h2>(Linux) How do I use my ATAPI drive through IDE-SCSI hostadapter
emulation?</h2>
-To use the SCSI emulation with an ATAPI cdrom, the kernel must be
-configured <strong>with</strong> SCSI support, generic SCSI device
-support and IDE-SCSI emulation, and <em>without</em> ATAPI (IDE) CDROM
-drive support. If the kernel includes native ATAPI (IDE CDROM drive)
-support, then the kernel will always use it over the emulation
-interface.<p>
-<hr>
+First off, if you're using a recent (2.6) kernel, there's no reason to
+do so; the 2.6 kernel offers SG_IO, which can do everything the old
+IDE-SCSI emulation could.<p>
+If you're stuck with Linux older than 2.6 or a version of cdparanoia
+before cdparanoia 10, then IDE-SCSI hostadapter emulation is
+recommended for ATAPI drives. To use the SCSI emulation with an
+ATAPI cdrom, the kernel must be configured <strong>with</strong> SCSI
+support, generic SCSI device support and IDE-SCSI emulation, and
+<em>without</em> ATAPI (IDE) CDROM drive support. If the kernel
+includes cooked ioctl ATAPI (IDE CDROM drive) support, then the kernel
+will always use it over the emulation interface.<p> <hr>
+
<a name=term>
<h2>My SCSI drive is unable to read some tracks, occasionally locks
up, or just behaves strangely in general</h2>
@@ -498,8 +533,8 @@
<td><img src=sidespacer1.gif width=10 alt=""></td>
<td bgcolor="#2a2a2c" valign=bottom><img src=bottomB.gif alt=""></td>
<td bgcolor="#2a2a2c" align=center valign=center width=100%>
- <table border=0 cellpadding=0 cellspacing=5 width=100%><tr>
- <td valign=center><a href="../index.html"><img src=black-xifish.gif
+ <table border=0 cellpadding=0 cellspacing=0 width=100%><tr>
+ <td valign=center><a href="../index.html"><img src=black-xifish.png
border=0></a></td>
<td valign=center>
<font face="Verdana, Arial, Helvetica" size=-2 color=#a0a0a0>
More information about the commits
mailing list