diff options
author | Samuel Thibault <samuel.thibault@ens-lyon.org> | 2021-04-24 22:46:47 +0200 |
---|---|---|
committer | Samuel Thibault <samuel.thibault@ens-lyon.org> | 2021-04-24 22:47:18 +0200 |
commit | c1e4791543544e91d52d3e85590a370494c03603 (patch) | |
tree | a2b41a944a8d9cebf409e47d853de20d61d143d4 | |
parent | d3d6e1d447891889459a691b5cd50fa73fca92d1 (diff) | |
download | hurd-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.defs | 4 |
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 |