diff options
author | mpp <mpp@FreeBSD.org> | 1999-07-30 11:32:08 +0000 |
---|---|---|
committer | mpp <mpp@FreeBSD.org> | 1999-07-30 11:32:08 +0000 |
commit | 03610e3c14210b573cb5c6c7ba9d9daf37ca2e1a (patch) | |
tree | 790a5980e2223ea799c8c205c47c81bf5b6eb4c8 /lib/libc/sys/getdirentries.2 | |
parent | b984ff5dd59379659a4b633907b87fa875ea226b (diff) | |
download | FreeBSD-src-03610e3c14210b573cb5c6c7ba9d9daf37ca2e1a.zip FreeBSD-src-03610e3c14210b573cb5c6c7ba9d9daf37ca2e1a.tar.gz |
Document the getdents(2) system call. The documentation was
added to the getdirentries(2) man page because 95%+ of that
man page comprised the text of the getdents(2) man page
I obtained from NetBSD.
Diffstat (limited to 'lib/libc/sys/getdirentries.2')
-rw-r--r-- | lib/libc/sys/getdirentries.2 | 40 |
1 files changed, 27 insertions, 13 deletions
diff --git a/lib/libc/sys/getdirentries.2 b/lib/libc/sys/getdirentries.2 index 4a17664..f9e5795 100644 --- a/lib/libc/sys/getdirentries.2 +++ b/lib/libc/sys/getdirentries.2 @@ -30,22 +30,28 @@ .\" SUCH DAMAGE. .\" .\" @(#)getdirentries.2 8.2 (Berkeley) 5/3/95 -.\" $Id$ +.\" $Id: getdirentries.2,v 1.10 1999/07/12 20:48:23 nik Exp $ .\" .Dd May 3, 1995 .Dt GETDIRENTRIES 2 .Os .Sh NAME -.Nm getdirentries +.Nm getdirentries , +.Nm getdents .Nd "get directory entries in a filesystem independent format" .Sh SYNOPSIS .Fd #include <sys/types.h> .Fd #include <dirent.h> .Ft int .Fn getdirentries "int fd" "char *buf" "int nbytes" "long *basep" +.Ft int +.Fn getdents "int fd" "char *buf" "int nbytes" .Sh DESCRIPTION -.Fn Getdirentries -reads directory entries from the directory +The +.Fn getdirentries +and +.Fn getdents +functions read directory entries from the directory referenced by the file descriptor .Fa fd into the buffer pointed to by @@ -54,13 +60,13 @@ in a filesystem independent format. Up to .Fa nbytes of data will be transferred. -.Fa Nbytes -must be greater than or equal to the +The +.Fa nbytes +argument must be greater than or equal to the block size associated with the file, see .Xr stat 2 . -Some filesystems may not support -.Fn getdirentries +Some filesystems may not support these functions with buffers smaller than this size. .Pp The data in the buffer is a series of @@ -114,19 +120,23 @@ The current position pointer associated with .Fa fd is set to point to the next block of entries. The pointer may not advance by the number of bytes returned by -.Fn getdirentries . +.Fn getdirentries +or +.Fn getdents . A value of zero is returned when the end of the directory has been reached. .Pp -.Fn Getdirentries -writes the position of the block read into the location pointed to by +The +.Fn getdirentries +function writes the position of the block read into the location pointed to by .Fa basep . Alternatively, the current position pointer may be set and retrieved by .Xr lseek 2 . The current position pointer should only be set to a value returned by .Xr lseek 2 , a value returned in the location pointed to by -.Fa basep , +.Fa basep ( Ns Fn getdirentries +only) or zero. .Sh IMPLEMENTATION NOTES .Pp @@ -158,7 +168,7 @@ is set to indicate the error. .Sh ERRORS .Fn Getdirentries will fail if: -.Bl -tag -width [EFAULT] +.Bl -tag -width Er .It Bq Er EBADF .Fa fd is not a valid file descriptor open for reading. @@ -188,3 +198,7 @@ The .Fn getdirentries function first appeared in .Bx 4.4 . +The +.Fn getdents +function first appeared in +.Fx 3.0 . |