Date: Wed, 30 May 2001 18:28:22 -0700 From: Kris Kennaway <kris@obsecurity.org> To: Eric Melville <eric@FreeBSD.org> Cc: Dima Dorfman <dima@unixfreak.org>, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/lib/libc/gen setproctitle.3 syslog.3 src/lib/libc/stdio printf.3 Message-ID: <20010530182822.A79068@xor.obsecurity.org> In-Reply-To: <20010530172131.A60056@FreeBSD.org>; from eric@FreeBSD.org on Wed, May 30, 2001 at 05:21:31PM -0700 References: <200105252042.f4PKgfu84635@freefall.freebsd.org> <20010526004601.2109A3E2F@bazooka.unixfreak.org> <20010530172131.A60056@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--mYCpIKhGyMATD0i+ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, May 30, 2001 at 05:21:31PM -0700, Eric Melville wrote: > > > Approved by: murray > > > Obtained from: OpenBSD > >=20 > > Related PR: 26286 > >=20 > > This commit doesn't close it, but you may want to read the discussion > > anyway. >=20 > I like the idea of a full man page for these sorts of things. Perhaps > strings.9, secure.9, or something like that? I'd also welcome this. I also want better manpage documentation about things like how to use strncpy() properly, whether to use array[FOO_MAX] or array[FOO_MAX+1] for proper bounding of buffers passed to library (e.g. POSIX) functions, etc. These should include code snippets so people can easily get the right idea instead of having to infer from verbal descriptions. Some of this stuff best goes in the individual function manpages, but the second class includes examples of a general implementation used by a number of functions. OpenBSD have made a good start at improving the code examples and documentation in their function manpages. We also have some stuff on http://www.freebsd.org/security which could be improved upon. Kris --mYCpIKhGyMATD0i+ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.6 (FreeBSD) Comment: For info see http://www.gnupg.org iD8DBQE7FZ41Wry0BWjoQKURAo6EAKClDhqtq8X3MnEjoO4tB5ZpaeRvlgCglBtD 04EKDZpP1oM4+U4PlGrr4co= =MN4q -----END PGP SIGNATURE----- --mYCpIKhGyMATD0i+-- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010530182822.A79068>