svn commit: r318893 - stable/11/lib/libc/sys

[Stephen J. Kiernan]

Author: stevek
Date: Thu May 25 18:55:10 2017
New Revision: 318893
URL: https://svnweb.freebsd.org/changeset/base/318893

Log:
  MFC r318314
  
  Add information to open(2) man page about the O_VERIFY flag.
  
  PR:		219262
  Reviewed by:	bjk wblock
  Approved by:	sjg (mentor)
  Obtained from:	Juniper Networks, Inc.

Modified:
  stable/11/lib/libc/sys/open.2
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/lib/libc/sys/open.2
==============================================================================
--- stable/11/lib/libc/sys/open.2	Thu May 25 18:46:13 2017	(r318892)
+++ stable/11/lib/libc/sys/open.2	Thu May 25 18:55:10 2017	(r318893)
@@ -119,6 +119,7 @@ O_NOCTTY	ignored
 O_TTY_INIT	ignored
 O_DIRECTORY	error if file is not a directory
 O_CLOEXEC	set FD_CLOEXEC upon open
+O_VERIFY	verify the contents of the file
 .Ed
 .Pp
 Opening a file with
@@ -237,6 +238,15 @@ may be used to set
 .Dv FD_CLOEXEC
 flag for the newly returned file descriptor.
 .Pp
+.Dv O_VERIFY
+may be used to indicate to the kernel that the contents of the file should
+be verified before allowing the open to proceed.
+The details of what
+.Dq verified
+means is implementation specific.
+The run-time linker (rtld) uses this flag to ensure shared objects have
+been verified before operating on them.
+.Pp
 If successful,
 .Fn open
 returns a non-negative integer, termed a file descriptor.