From owner-cvs-all  Fri Jul 30  3:34:31 1999
Delivered-To: cvs-all@freebsd.org
Received: from godzilla.zeta.org.au (godzilla.zeta.org.au [203.26.10.9])
	by hub.freebsd.org (Postfix) with ESMTP
	id 7790E150AA; Fri, 30 Jul 1999 03:34:21 -0700 (PDT)
	(envelope-from bde@godzilla.zeta.org.au)
Received: (from bde@localhost)
	by godzilla.zeta.org.au (8.8.7/8.8.7) id UAA03693;
	Fri, 30 Jul 1999 20:34:19 +1000
Date: Fri, 30 Jul 1999 20:34:19 +1000
From: Bruce Evans <bde@zeta.org.au>
Message-Id: <199907301034.UAA03693@godzilla.zeta.org.au>
To: mpp@FreeBSD.org, mpp@mpp.pro-ns.net
Subject: Re: cvs commit: src/lib/libc/sys getdents.2
Cc: cvs-all@FreeBSD.org, cvs-committers@FreeBSD.org
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk

>>   Added files:
>>     lib/libc/sys         getdents.2 
>>   Log:
>>   Add a manual page for getdents(2).  This was taken from NetBSD, but
>>   still needs some cleanup which is why it hasn't been added to the
>>   Makefile yet.
>
>After looking around a bit, it appears that getdents(2) just sets
>up a call to getdirentries(2), passing the same arguments and
>returning the same data.  So why do we have two identical system
>calls with different names?  Let me guess, POSIX?

They're not identical.  getdirentries() has an extra basep arg and has
the wrong type for the size arg.  I don't know why NetBSD dropped the
basep arg.

Diffing the man pages shows some bugs in getdents.2:
- missing include in synopsys
- wrong types for d_fileno, etc.
- d_type not documented (intentional?)
- spelling error gtdents
- non-bug ".Bl -tag -width Er".  Is this better?
- missing/extra docs for EINVAL
- xrefs not sorted

Bruce


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message