Home | History | Annotate | Download | only in gen
History log of /src/lib/libc/gen/directory.3
RevisionDateAuthorComments
 1.43  17-Feb-2021  dholland Document that rewinddir(3) might either reopen or just lseek the dir.

(Currently it depends on the underlying directory, but documenting the
exact details seems inadvisable.)

Also, Someone(TM) should check if POSIX permits this or if we ought to
improve the implementation.
 1.42  17-Feb-2021  dholland Fix some typos/malapropisms in directory(3).
 1.41  03-Jul-2017  wiz Remove workaround for ancient HTML generation code.
 1.40  22-Jan-2016  pgoyette Improved wording.
 1.39  22-Jan-2016  plunky clarify closing of descriptor returned by dirfd(3)
 1.38  08-Oct-2012  njoly Kill some extra spaces in function arguments.
 1.37  15-Oct-2011  rmind branches: 1.37.2; 1.37.8;
Mention POSIX conformance of some functions, when they appeared, sprinkle .Xr.
 1.36  17-Dec-2010  njoly Fix cross-reference, dir(5) -> dirent(3).
 1.35  04-Jun-2010  jruoho Fix .Xr; dirent(5) -> dirent(3).
 1.34  17-May-2010  jruoho Actually the previous is wrong; all of these can set the errno either via
each other or via something like malloc(3) or lseek(2).
 1.33  17-May-2010  jruoho Fix the note about errno in ERRORS; telldir(3), seekdir(3), and rewinddir(3)
do not set the errno.
 1.32  16-May-2010  wiz Sort sections. Fix typo. Fix xref. Improve wording in one case.
 1.31  16-May-2010  jruoho At least one markup-typo slipped through the cracks.
 1.30  16-May-2010  jruoho Rewrite much of the page.

Provide much more detailed and structured discussion. Notably, try to gather
some of the conditions around the famous undefined behavior; these functions
(or the implementations) are quite prone to such behavior.

Add compatibility notes. (The big change here is that in SUSv4 it is no
longer mandated that the directory streams are implemented by using file
descriptors.)

XXX: Please proofread this. Consider also adding some additional notes. For
instance, I left the semantics about "." and ".." out. The returned
errno's should be enumerated as well.
 1.29  11-Jan-2009  christos merge christos-time_t
 1.28  05-Dec-2008  wiz New sentence, new line. Bump date for fdopendir.
 1.27  05-Dec-2008  ad Add fdopendir(), from Solaris/Linux.
 1.26  18-May-2006  christos branches: 1.26.28;
Explicitly mention that telldir values are only valid for the lifetime of
the DIR pointer. Pointed out by Klaus Klein.
 1.25  17-May-2006  christos PR/24324: Arne H Juul: Re-implement seekdir/telldir using a pointer of
locations per directory instead of a global hash table to avoid memory
leak issues, and incorrect results.
 1.24  07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22280, verified by myself.
 1.23  04-Jul-2003  wiz Drop whitespace.
 1.22  28-May-2003  kleink Add restrict qualifiers to previous.
 1.21  28-May-2003  christos add mutex locking for directories and readdir_r(3). Influenced by FreeBSD.
 1.20  16-Apr-2003  wiz Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.
 1.19  02-Mar-2003  enami Cosmetic changes in sample code.
 1.18  01-Oct-2002  wiz New sentence, new line. From Robert Elz.
 1.17  10-Aug-2002  wiz Update Dd for recent changes.
 1.16  10-Aug-2002  yamt - move a example into EXAMPLES section.
- check a return value of opendir.
from openbsd.
 1.15  29-Apr-2002  simonb Remove <sys/types.h> from synopsis, as per latest SUS/Posix specs.
 1.14  07-Feb-2002  ross generate & symbolically
 1.13  07-Feb-2002  ross Generate <>& symbolically.
 1.12  16-Sep-2001  wiz Standardize section headers, sort sections, sort SEE ALSO, punctuation
and misc. fixes.
 1.11  16-Sep-2001  wiz Boring whitespace fixes.
 1.10  22-Mar-1999  garbled branches: 1.10.12;
Last of the .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Wheee!
 1.9  05-Feb-1998  perry add LIBRARY section to man page
 1.8  14-Jul-1997  kleink Add missing `STANDARDS' compliance statements. As we #define _POSIX_VERSION
to 199009L, bump existing statements to 1003.1-1990.
 1.7  25-Feb-1995  cgd clean up Id's on files previously imported...
 1.6  27-Jul-1994  jtc branches: 1.6.2;
Sync with 4.4 lite
 1.5  10-Jan-1994  jtc Fix spelling errors.
 1.4  20-Aug-1993  jtc Fixed typo. Readdir returns a "struct dirent *", not "struct dirent".
 1.3  20-Aug-1993  mycroft Technically, readdir(3) returns a `struct dirent *', not a `struct direct *',
not that they aren't the same thing.
 1.2  30-Jul-1993  mycroft Add RCS identifiers.
 1.1  21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2  27-Jul-1994  jtc opendir() & friends from 4.4lite.
 1.1.1.1  21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.6.2.2  27-Jul-1994  jtc Sync with 4.4 lite
 1.6.2.1  27-Jul-1994  jtc file directory.3 was added on branch netbsd-1-0 on 1994-07-27 05:37:09 +0000
 1.10.12.6  18-Oct-2002  nathanw Catch up to -current.
 1.10.12.5  13-Aug-2002  nathanw Catch up to -current.
 1.10.12.4  21-Jun-2002  nathanw Catch up to -current.
 1.10.12.3  22-Mar-2002  nathanw Catch up to -current.
 1.10.12.2  08-Mar-2002  nathanw Catch up to -current.
 1.10.12.1  08-Oct-2001  nathanw Catch up to -current.
 1.26.28.1  04-Jan-2009  christos merge with head.
 1.37.8.1  20-Nov-2012  tls Resync to 2012-11-19 00:00:00 UTC
 1.37.2.1  30-Oct-2012  yamt sync with head

RSS XML Feed