From owner-freebsd-current@FreeBSD.ORG Wed Sep 1 19:16:27 2004 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id B258716A4CE; Wed, 1 Sep 2004 19:16:27 +0000 (GMT) Received: from rt0-ext.kdcg.net (rt0-ext.kdcg.net [81.2.114.200]) by mx1.FreeBSD.org (Postfix) with ESMTP id C631343D54; Wed, 1 Sep 2004 19:16:26 +0000 (GMT) (envelope-from cg@ijcg.net) Received: from localhost (localhost [127.0.0.1]) by rt0-ext.kdcg.net (Postfix) with ESMTP id CDC5F4AB9027; Wed, 1 Sep 2004 20:19:09 +0100 (BST) Received: from rt0-ext.kdcg.net ([127.0.0.1]) by localhost (alexandria.rings [127.0.0.1]) (amavisd-new, port 10024) with LMTP id 57477-01-3; Wed, 1 Sep 2004 20:19:09 +0100 (BST) Received: from tacitblue3.rings (tacitblue.rings [10.1.0.2]) by rt0-ext.kdcg.net (Postfix) with ESMTP id B6F5D4AB9025; Wed, 1 Sep 2004 20:19:08 +0100 (BST) Date: Wed, 01 Sep 2004 20:16:33 +0100 From: cg To: "Ruslan Ermilov" References: <20040828142503.GA52613@ip.net.ua> <20040829190833.GA9796@cnd.mcgill.ca> <20040829205942.GC39813@ip.net.ua> <20040831133654.GF31981@ip.net.ua> Content-Type: text/plain; format=flowed; delsp=yes; charset=iso-8859-15 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Message-ID: In-Reply-To: <20040831133654.GF31981@ip.net.ua> User-Agent: Opera M2/7.54 (Win32, build 3869) X-Virus-Scanned: by amavisd-new at badexample.com X-Mailman-Approved-At: Thu, 02 Sep 2004 11:53:01 +0000 cc: Seigo Tanimura cc: Cameron Grant cc: "Simon L. Nielsen" cc: multimedia@freebsd.org cc: Mathew Kanner cc: current@freebsd.org Subject: Re: [PATCH] sound(4) related manpages 5.3 TODO item X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 01 Sep 2004 19:16:28 -0000 > I agree that renaming the "pcm" devclass to "snd" or "sound" is a good > idea, and I like the "snd" more for a couple of reasons (please see > below). Let me now check if I got you right. Assuming it will be > renamed to "snd", what about the /dev entries, will they be still > /dev/pcm{unit}, /dev/mixer{unit}, and /dev/midi{unit}? If, for example, > I have two sound cards installed, first without MIDI, and second with > MIDI, what will I have in /dev? pcm0, mixer0, *no* midi0, pcm1, mixer1, > and midi1? And these devices ("pcm", "mixer", and "midi") will be all > children of the "snd" device. And for the ISA sound card with MIDI > support, the following device hints and corresponding /dev entries? the /dev entries are /dev/dsp* and /dev/audio*, /dev/sndstat, /dev/mixer*, plus the midi ones: /dev/midi* and /dev/sequencer. all of these names are mandated by the oss spec. i'm not sure about midi device numbering; i believe some cards can implement multiple midi devices, eg an fm synth, io port and a wavetable synth simultaneously. pcm won't be a separate device as such; it won't appear in dmesg. this probably applies to midi too. > So, to summarize, I'd have liked to see the following happen: > > - "snd" is the generic sound device (module snd.ko) > - "snd_foo" is the sound driver for foo (module snd_foo.ko) > - "pcm" devclass renamed to "snd" > - "pcm", "mixer", and "midi" devices are created as children of "snd" no. pcm and midi will effectively be part of snd. making them separate newbus drivers would be tricky and require every driver to be modified. > - ISA device hints become snd..{at,irq,drq,flags,...} > - the hw.snd. sysctl tree stays unmodified, including the following > convention: PCM-related sysctls will have the hw.snd.pcm > prefix, and MIDI-related sysctls (should there be any) will have the > hw.snd.midi prefix. > > And one final question: if the plan is as described here, it probably > makes sense to do it now, before 5.3, or postpone the "manpage and > handbook" sound related TODO items until it's actually done and merged > into RELENG_5. I'd like to avoid repo-copying the pcm(4) manpage to > sound(4) now, only to repo-copy it later to snd(4). If this doesn't > happen in time for 5.3, I suggest the following emergency plan for > now: > > - repo-copy (and tweak as necessary) all bridge drivers manpages, > as shown in my patch; > > - do *not* repo-copy pcm(4) to sound(4) yet, just link it, possibly > mentioning in the manpage that the generic driver will soon be > renamed from "sound" to "snd", > > - fix hints in NOTES (as in my patch) to match reality. this sounds ok to me. > When "sound" -> "snd" conversion is actually done, repo-copy > pcm(4) to sound(4), tweak as necessary, documenting what the > "sound" device really is, mentioning "pcm", "mixer", and "midi" > sub-devices, link sound(4) to pcm(4), mixer(4), and midi(4). > > Please let me know how to proceed... i don't think i can cope with the pressure of getting it into 5.3, so it'd be better to postpone it until 5.4 i think. -cg