Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 20 Jul 2000 09:52:29 -0400 (EDT)
From:      "Sean O'Connell" <sto@stat.Duke.EDU>
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/20060: Add some mention of sound devices in the pcm manpage
Message-ID:  <200007201352.JAA68985@feta.isds.duke.edu>

next in thread | raw e-mail | index | archive | help

>Number:         20060
>Category:       docs
>Synopsis:       Add some mention of sound devices in the pcm manpage
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jul 20 07:00:04 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Sean O'Connell
>Release:        FreeBSD 4.0-STABLE i386
>Organization:
Institute of Statistics and Decision Sciences
>Environment:

	Both RELENG_4 and -CURRENT.

>Description:

	This is based on a conversation with a frustrated -STABLE user
	who couldn't figure out how to create the requisite devices for
	his sound card (which had kernel support ... device pcm was added
	as per LINT).  He had looked through the manpages and had done 
	some searching through the handbook and FAQ.  There does exist
	an entry in the FAQ (http://www.freebsd.org/FAQ/admin.html#AEN2508),
	but it doesn't hit all the right keywords.  It should contain more
	verbiage (something in reference to sound/pcm/MAKEDEV snd, etc).
	My initial instinct was to say RTFM, but when I went to the manpage
	for pcm, there was no reference to the requirment to do a
	cd /dev; sh MAKEDEV snd0 (for pcm0, snd1 for pcm1, etc).

>How-To-Repeat:

	man 4 pcm and try to find a reference to the relevant device files

>Fix:

	The following is a patch to /usr/src/share/man/man4/pcm.4 that 
	adds a DEVICE FILES section (probably nonstandard) to reward the
	industrious user.  Do other kernel devices make reference to their
	relevant /dev entries ... It might be a nice thing to add.


--- pcm.4.orig	Wed Mar 22 00:12:01 2000
+++ pcm.4	Wed Jul 19 17:54:30 2000
@@ -121,6 +121,24 @@
 
 .It NeoMagic 256AV/ZX (PCI)
 .Pp
+
+.El
+.Pp
+.Sh DEVICE FILES
+
+To create the proper device files for audio support,
+
+.Cd "cd /dev"
+.Cd "sh MAKEDEV snd0"
+
+for soundcards detected as
+.Em pcm0
+(similarly, if the card is detected as
+.Em "pcm1",
+it would require
+.Em "snd1",
+etc.).
+
 .El
 .Pp
 .Sh DIAGNOSTICS AND TROUBLESHOOTING


>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200007201352.JAA68985>