svn commit: r348466 - stable/12/lib/libc/gen

[Alan Somers]

Author: asomers
Date: Fri May 31 16:24:22 2019
New Revision: 348466
URL: https://svnweb.freebsd.org/changeset/base/348466

Log:
  MFC r347032:
  
  directory.3: add a STANDARDS section
  
  Reviewed by:	jilles, ngie
  Sponsored by:	The FreeBSD Foundation
  Differential Revision:	https://reviews.freebsd.org/D20111

Modified:
  stable/12/lib/libc/gen/directory.3
Directory Properties:
  stable/12/   (props changed)

Modified: stable/12/lib/libc/gen/directory.3
==============================================================================
--- stable/12/lib/libc/gen/directory.3	Fri May 31 16:23:51 2019	(r348465)
+++ stable/12/lib/libc/gen/directory.3	Fri May 31 16:24:22 2019	(r348466)
@@ -28,7 +28,7 @@
 .\"     @(#)directory.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd May 22, 2017
+.Dd April 30, 2019
 .Dt DIRECTORY 3
 .Os
 .Sh NAME
@@ -264,6 +264,30 @@ return (NOT_FOUND);
 .Xr open 2 ,
 .Xr read 2 ,
 .Xr dir 5
+.Sh STANDARDS
+The
+.Fn closedir ,
+.Fn dirfd ,
+.Fn fdopendir ,
+.Fn opendir ,
+.Fn readdir ,
+.Fn readdir_r ,
+.Fn rewinddir ,
+.Fn seekdir
+and
+.Fn telldir
+functions are expected to conform to
+.St -p1003.1-2008 .
+The
+.Fn fdclosedir
+function and the
+.Fa d_off ,
+.Fa d_reclen
+and
+.Fa d_type
+fields of
+.Vt struct dirent
+are non-standard, and should not be used in portable programs.
 .Sh HISTORY
 The
 .Fn opendir ,