aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSamuel Thibault <samuel.thibault@ens-lyon.org>2021-04-24 22:46:47 +0200
committerSamuel Thibault <samuel.thibault@ens-lyon.org>2021-04-24 22:47:18 +0200
commitc1e4791543544e91d52d3e85590a370494c03603 (patch)
treea2b41a944a8d9cebf409e47d853de20d61d143d4
parentd3d6e1d447891889459a691b5cd50fa73fca92d1 (diff)
downloadhurd-c1e4791543544e91d52d3e85590a370494c03603.tar.gz
hurd-c1e4791543544e91d52d3e85590a370494c03603.tar.bz2
hurd-c1e4791543544e91d52d3e85590a370494c03603.zip
fs.defs: Make dir_readder documentation clearer
* hurd/fs.defs: make it clear that dir_readdir returns a series, not an array.
-rw-r--r--hurd/fs.defs4
1 files changed, 3 insertions, 1 deletions
diff --git a/hurd/fs.defs b/hurd/fs.defs
index 52f9cd37..7d36a18a 100644
--- a/hurd/fs.defs
+++ b/hurd/fs.defs
@@ -224,7 +224,9 @@ routine dir_lookup (
/* Read entries from the directory. Each entry is identified
by an index number starting at 0 and running through the file. This
call fetches NENTRIES (or any convenient number if NENTRIES is -1)
- entries starting at ENTRY, returning an array of struct directs in DATA.
+ entries starting at ENTRY, returning a series of struct dirent in DATA.
+ Note that due to the variable-size D_NAME field, D_RECLEN has to be used to
+ jump from one struct dirent to the other.
The number of entries successfully read is returned in AMOUNT. If ENTRY
is bigger than the index of the last entry, then 0 is returned in
AMOUNT. If BUFSIZE is nonzero, never return more than BUFSIZE bytes of