From owner-freebsd-hackers Thu Oct 9 11:51:20 1997 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.7/8.8.7) id LAA20092 for hackers-outgoing; Thu, 9 Oct 1997 11:51:20 -0700 (PDT) (envelope-from owner-freebsd-hackers) Received: from sax.sax.de (sax.sax.de [193.175.26.33]) by hub.freebsd.org (8.8.7/8.8.7) with SMTP id LAA20050 for ; Thu, 9 Oct 1997 11:51:09 -0700 (PDT) (envelope-from j@uriah.heep.sax.de) Received: (from uucp@localhost) by sax.sax.de (8.6.12/8.6.12-s1) with UUCP id UAA02024; Thu, 9 Oct 1997 20:51:07 +0200 Received: (from j@localhost) by uriah.heep.sax.de (8.8.7/8.8.5) id UAA20047; Thu, 9 Oct 1997 20:33:11 +0200 (MET DST) Message-ID: <19971009203311.QE10395@uriah.heep.sax.de> Date: Thu, 9 Oct 1997 20:33:11 +0200 From: j@uriah.heep.sax.de (J Wunsch) To: freebsd-hackers@FreeBSD.ORG Cc: mdean@best.com (mdean) Subject: Re: Major number requested References: X-Mailer: Mutt 0.60_p2-3,5,8-9 Mime-Version: 1.0 X-Phone: +49-351-2012 669 X-PGP-Fingerprint: DC 47 E6 E4 FF A6 E9 8F 93 21 E0 7D F9 12 D6 4E Reply-To: joerg_wunsch@uriah.heep.sax.de (Joerg Wunsch) In-Reply-To: ; from mdean on Oct 8, 1997 23:42:30 -0700 Sender: owner-freebsd-hackers@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk As mdean wrote: > I would like to ask for a major number for my dio48s/at-p driver (48 > channel digital i/o with change of state interrupt). Well, we probably wouldn't `reserve' major numbers before they are needed. However, with the current approach, this is just a single #define statement in your code anyway, so i don't think you gotta worry much about it yet. Simply use major # 20 (``local use'') by now to develop it. Basically, if you look at the latest copy of the file /sys/i386/conf/majors.i386, you'll see what's the next available number. > I will be contributing this driver, unless rejected, to the > freebsd project. Please adhere to style(9) if you intend to contribute it. If you care for it from the beginning, it's much easier than changing things later. > I also need to know what kind of man page text I need to go along with > this. I have never done any man pages. Basically, pick some comparable device driver man page from section 4 (/usr/src/share/man/man4/). Unless the driver exports some kernel API functions (i.e. non-`static' functions etc. that can be reused in other parts of the kernel), section 9 man pages are not required. I think there are a number of people around in the committers club who are knowledgable about man pages, so if you ask nicely for a review/ style fixup, it's likely that you should find someone. Finding a kernel committer who's knowledgable enough for at least a cursory review of your code *and* who also has the time to do it is probably much harder. -- cheers, J"org joerg_wunsch@uriah.heep.sax.de -- http://www.sax.de/~joerg/ -- NIC: JW11-RIPE Never trust an operating system you don't have sources for. ;-)