diff --git a/lib/libc/sys/getdirentries.2.sav b/lib/libc/sys/getdirentries.2 --- a/lib/libc/sys/getdirentries.2.sav +++ b/lib/libc/sys/getdirentries.2 @@ -28,7 +28,7 @@ .\" @(#)getdirentries.2 8.2 (Berkeley) 5/3/95 .\" $FreeBSD$ .\" -.Dd March 30, 2020 +.Dd February 14, 2021 .Dt GETDIRENTRIES 2 .Os .Sh NAME @@ -91,7 +91,8 @@ .Fa d_off field returns a cookie which can be used with .Xr lseek 2 -to position the directory descriptor to the next entry. +to position the directory descriptor to the next entry +if it is non-zero. The .Fa d_reclen entry is the length, in bytes, of the directory record. @@ -148,14 +149,16 @@ .Pc , a value returned in the .Fa d_off -field, +field if it is not zero, or zero. .Sh IMPLEMENTATION NOTES The .Fa d_off -field is being used as a cookie to readdir for nfs servers. -These cookies can be cached and allow to read directory entries at a specific -offset on demand. +field is currently set to 0 by the NFS client, since the +directory offset cookies returned by an NFS server cannot +be used by +.Xr lseek 2 +at this time. .Sh RETURN VALUES If successful, the number of bytes actually transferred is returned. Otherwise, -1 is returned and the global variable