Bug 79658

Summary: Freebsd Handbook incorrect about ATAPI CD driver
Product: Documentation Reporter: Alan Larson <larson>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Alan Larson 2005-04-08 00:30:04 UTC 
Section 16.6.5 of the FreeBSD Handbook says that the ATAPI CD driver can
read audio tracks as /dev/acdDtNN (for drive D, track NN), and that the
NN is zero prefixed if necessary to fill to 2 digits.
This is incorrect.  MAKEDEV generates acd0t1, acd0t2, ... without the
leading zeros.

Fix: 

Correct the manual.
How-To-Repeat:       Dare I say it?  RTFM?  (Sorry, I couldn't resist.)
Comment 1 Tom Rhodes freebsd_committer freebsd_triage 2005-04-08 01:43:45 UTC 
On Thu, 7 Apr 2005 23:29:36 GMT
Alan Larson <larson@w6yx.stanford.edu> wrote:

> Section 16.6.5 of the FreeBSD Handbook says that the ATAPI CD driver can
> read audio tracks as /dev/acdDtNN (for drive D, track NN), and that the
> NN is zero prefixed if necessary to fill to 2 digits.
> This is incorrect.  MAKEDEV generates acd0t1, acd0t2, ... without the
> leading zeros.

It would be nice if this section also discussed using the
cdcontrol(1) utility.

It would be nice if the cdcontrol(1) utility checked if the
invoker has access to the cdrom device on start up.  Currently
it just dies on the poor user after they type some options.

-- 
Tom Rhodes
Comment 2 Simon L. B. Nielsen freebsd_committer freebsd_triage 2005-04-08 08:22:55 UTC 
On 2005.04.07 23:29:36 +0000, Alan Larson wrote:
> 
> Section 16.6.5 of the FreeBSD Handbook says that the ATAPI CD driver can
> read audio tracks as /dev/acdDtNN (for drive D, track NN), and that the
> NN is zero prefixed if necessary to fill to 2 digits.
> This is incorrect.  MAKEDEV generates acd0t1, acd0t2, ... without the
> leading zeros.


I suspect (but I don't have an audio CD handy to test) that this is a
4.X/5.X difference.  (This is mostly a comment to whoever decides to
work on the PR).

>       Dare I say it?  RTFM?  (Sorry, I couldn't resist.)


:-)

-- 
Simon L. Nielsen
Comment 3 Pav Lucistnik freebsd_committer freebsd_triage 2006-01-10 17:26:26 UTC 
State Changed
From-To: open->closed

Fixed!