From owner-freebsd-doc@FreeBSD.ORG Fri Nov 7 14:20:57 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A21D216A4CF for ; Fri, 7 Nov 2003 14:20:57 -0800 (PST) Received: from hak.cnd.mcgill.ca (hak.cnd.mcgill.ca [132.216.11.133]) by mx1.FreeBSD.org (Postfix) with ESMTP id 8D07644005 for ; Fri, 7 Nov 2003 14:20:45 -0800 (PST) (envelope-from mat@hak.cnd.mcgill.ca) Received: from hak.cnd.mcgill.ca (localhost [127.0.0.1]) by hak.cnd.mcgill.ca (8.12.9/8.12.8) with ESMTP id hA7MIVk4097791 for ; Fri, 7 Nov 2003 17:18:31 -0500 (EST) (envelope-from mat@hak.cnd.mcgill.ca) Received: (from mat@localhost) by hak.cnd.mcgill.ca (8.12.9/8.12.8/Submit) id hA7MIVnp097790 for freebsd-doc@freebsd.org; Fri, 7 Nov 2003 17:18:31 -0500 (EST) Date: Fri, 7 Nov 2003 17:18:31 -0500 From: Mathew Kanner To: freebsd-doc@freebsd.org Message-ID: <20031107221831.GG94805@cnd.mcgill.ca> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="M9NhX3UHpAaciwkO" Content-Disposition: inline User-Agent: Mutt/1.4.1i Organization: I speak for myself, operating in Montreal, CANADA X-Spam-Status: No, hits=0.0 required=5.0 tests=none autolearn=no version=2.60 X-Spam-Checker-Version: SpamAssassin 2.60 (1.212-2003-09-23-exp) on hak.cnd.mcgill.ca Subject: suggested pcm replacement X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 07 Nov 2003 22:20:57 -0000 --M9NhX3UHpAaciwkO Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Hello All, I'm not subscribed to the -doc list so please CC me. Anyway, I've been pondering sound latetly and would like to see the man page replaced with something like the attached. Please note this is a first draft, I don't know how to write man pages, a paragraph was ripped from the old manual, etc. An emu10k1 manual should be simple in that the emu10k1 driver supports the soundblaster 5.1, soundblaster live, dell EOM soundblaster live. but NOT the audigy, audigy2, or extigy. Cheers, --Mat -- It's impossible to awaken a man who is pretending to be asleep. - Navajo saying --M9NhX3UHpAaciwkO Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="pcm.4" PCM -- FreeBSD PCM audio device infrastructure PCM devices provide audio record and playback channels. snd_driver_load="YES" in /boot/loader.conf, or kldload snd_driver will load all available sound drivers. snd_emu10k1_load="YES" in /boot/loader.conf, or kldload snd_emu10k1 will load the EMU10K1 (SoundBlaster 5.1, etc) and all nessary components. It is not recommened to include the sound modules in your kernel config. SYSCTL PCM sysctls are rooted in hw.snd hw.snd.targetirqrate: Set the default block size such that continous playback will achieve the IRQ rate. This can overidden by applications. hw.snd.report_soft_formats: Formats not supported by the device are avaible to applications, uses internal format conversion. hw.snd.verbose: Level of verbosity in /dev/sndstat output hw.snd.unit: The default device for /dev/dsp VCHANS Each device can optionnaly supported more playback channels that physical hardware provides. This feature can be set on a globally or per device instance. VCHANs setting can only be manipulated while the device is inactive. Sysctls hw.snd.maxautovchans: Global vchans settings, Setting 0 disables VCHANs hw.snd.pcm%d.vchans: current number of VCHANs for a device. Setting the number of VCHANs to 0 disables this feature. IOCTL The driver supports most of the OSS ioctls(), and most applications work unmodified (including popular mpeg players and linux binaries). A few differences exist (the most important one is the ability to use mem- ory-mapped access to the audio buffers). As a consequence, some applica- tions may need to be recompiled with a slightly modified audio module. See for a complete list of the supported ioctls. FILES /dev/audio%d.%d Sparc-compatible audio device /dev/dsp%d.%d Digitized voice device /dev/dspW%d.%d Like /dev/dsp, but 16 bits per sample /dev/dspr%d.%d Connected to a record codec /dev/sndstat Current PCM status, including all channels and drivers. --M9NhX3UHpAaciwkO--