From owner-freebsd-hackers Sun Aug 10 07:20:55 1997 Return-Path: Received: (from root@localhost) by hub.freebsd.org (8.8.5/8.8.5) id HAA22557 for hackers-outgoing; Sun, 10 Aug 1997 07:20:55 -0700 (PDT) Received: from sax.sax.de (sax.sax.de [193.175.26.33]) by hub.freebsd.org (8.8.5/8.8.5) with SMTP id HAA22551 for ; Sun, 10 Aug 1997 07:20:53 -0700 (PDT) Received: (from uucp@localhost) by sax.sax.de (8.6.12/8.6.12-s1) with UUCP id QAA08818 for hackers@FreeBSD.ORG; Sun, 10 Aug 1997 16:20:51 +0200 Received: (from j@localhost) by uriah.heep.sax.de (8.8.7/8.8.5) id QAA03572; Sun, 10 Aug 1997 16:02:18 +0200 (MET DST) Message-ID: <19970810160218.ZD61398@uriah.heep.sax.de> Date: Sun, 10 Aug 1997 16:02:18 +0200 From: j@uriah.heep.sax.de (J Wunsch) To: hackers@FreeBSD.ORG Subject: Re: creating man 9f References: <199708101321.GAA20590@hub.freebsd.org> 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: <199708101321.GAA20590@hub.freebsd.org>; from Darren Reed on Aug 10, 1997 23:07:54 +1000 Sender: owner-freebsd-hackers@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk As Darren Reed wrote: > I'd like to nominate the following man pages for duplication into section > 9f (kernel functions): Duplication isn't too good. I'm rather in favor of stub pages then, with an .Xr to the section 3 pages. > printf, vprintf (I'me sure there are some differences) Quite a number. Also, the related interfaces log(9), addlog(9), uprintf(9), tprintf(9), etc. need to be mentioned. Too many people tend to use printf() where one of the alternate functions would be better. (Eg. using log(LOG_DEBUG, ...) for debug output doesn't clutter the console.) > putc > free free(9) is different from free(3), and is already covered in the malloc(9) page. > ...just to start the man9 section off. Comments ? `start' is nice. :-) j@uriah 296% ls -1 /usr/share/man/man9 | wc -l 147 > * - there's a noticable lack of the *nprintf functions from the kernel. > Given the number of buffer overflow problems and the trend towards their > use, shouldn't things like strncat & friends be put in the kernel too ? If an abuser can abuse kernel functions, it doesn't matter whether they've got an `n' in their name or not. ;-) -- 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. ;-)