svn commit: r318314 - head/lib/libc/sys

[Stephen J. Kiernan]

Author: stevek
Date: Mon May 15 19:32:26 2017
New Revision: 318314
URL: https://svnweb.freebsd.org/changeset/base/318314

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

Modified:
  head/lib/libc/sys/open.2

Modified: head/lib/libc/sys/open.2
==============================================================================
--- head/lib/libc/sys/open.2	Mon May 15 18:48:58 2017	(r318313)
+++ head/lib/libc/sys/open.2	Mon May 15 19:32:26 2017	(r318314)
@@ -141,6 +141,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
@@ -259,6 +260,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.