svn commit: r345391 - in stable/11: lib/libc/sys sbin/mount_fusefs

[Alan Somers]

Author: asomers
Date: Thu Mar 21 21:56:03 2019
New Revision: 345391
URL: https://svnweb.freebsd.org/changeset/base/345391

Log:
  MFC r340455, r340525, r341598
  
  r340455:
  fcntl.2: document an additional error condition
  
  r340525:
  mount_fusefs.8: expand HISTORY section
  
  Note that fuse was available from ports long before joining the base system.
  Also, update the upstream URL.
  
  r341598:
  stat(2): clarify which syscalls modify file timestamps
  
  The list of syscalls that modify st_atim, st_mtim, and st_ctim was quite out
  of date and probably not accurate to begin with.  Update it, and make it
  clear that the list is open-ended.
  
  Reviewed by:	kib
  Differential Revision:	https://reviews.freebsd.org/D18410

Modified:
  stable/11/lib/libc/sys/fcntl.2
  stable/11/lib/libc/sys/stat.2
  stable/11/sbin/mount_fusefs/mount_fusefs.8
Directory Properties:
  stable/11/   (props changed)

Modified: stable/11/lib/libc/sys/fcntl.2
==============================================================================
--- stable/11/lib/libc/sys/fcntl.2	Thu Mar 21 21:53:55 2019	(r345390)
+++ stable/11/lib/libc/sys/fcntl.2	Thu Mar 21 21:56:03 2019	(r345391)
@@ -28,7 +28,7 @@
 .\"     @(#)fcntl.2	8.2 (Berkeley) 1/12/94
 .\" $FreeBSD$
 .\"
-.Dd May 2, 2018
+.Dd Nov 15, 2018
 .Dt FCNTL 2
 .Os
 .Sh NAME
@@ -562,6 +562,10 @@ or
 and the data to which
 .Fa arg
 points is not valid.
+.Pp
+The argument
+.Fa cmd
+is invalid.
 .It Bq Er EMFILE
 The argument
 .Fa cmd

Modified: stable/11/lib/libc/sys/stat.2
==============================================================================
--- stable/11/lib/libc/sys/stat.2	Thu Mar 21 21:53:55 2019	(r345390)
+++ stable/11/lib/libc/sys/stat.2	Thu Mar 21 21:56:03 2019	(r345391)
@@ -28,7 +28,7 @@
 .\"     @(#)stat.2	8.4 (Berkeley) 5/1/95
 .\" $FreeBSD$
 .\"
-.Dd January 14, 2016
+.Dd December 5, 2018
 .Dt STAT 2
 .Os
 .Sh NAME
@@ -151,45 +151,53 @@ are as follows:
 .Bl -tag -width ".Va st_birthtim"
 .It Va st_atim
 Time when file data last accessed.
-Changed by the
-.Xr mknod 2 ,
-.Xr utimes 2 ,
+Changed implicitly by syscalls such as
 .Xr read 2
 and
-.Xr readv 2
-system calls.
+.Xr readv 2 ,
+and explicitly by
+.Xr utimes 2 .
 .It Va st_mtim
 Time when file data last modified.
-Changed by the
+Changed implicitly by syscalls such as
+.Xr truncate 2 ,
+.Xr write 2 ,
+and
+.Xr writev 2 ,
+and explicitly by
+.Xr utimes 2 .
+Also, any syscall which modifies directory content changes the
+.Va st_mtim
+for the affected directory.
+For instance,
+.Xr creat 2 ,
 .Xr mkdir 2 ,
-.Xr mkfifo 2 ,
-.Xr mknod 2 ,
-.Xr utimes 2 ,
-.Xr write 2
+.Xr rename 2 ,
+.Xr link 2 ,
 and
-.Xr writev 2
-system calls.
+.Xr unlink 2 .
 .It Va st_ctim
 Time when file status was last changed (inode data modification).
-Changed by the
+Changed implicitly by any syscall that affects file metadata, including
+.Va st_mtim ,
+such as
 .Xr chflags 2 ,
 .Xr chmod 2 ,
 .Xr chown 2 ,
+.Xr truncate 2 ,
+.Xr utimes 2 ,
+and
+.Xr write 2 .
+Also, any syscall which modifies directory content changes the
+.Va st_ctim
+for the affected directory.
+For instance,
 .Xr creat 2 ,
-.Xr link 2 ,
 .Xr mkdir 2 ,
-.Xr mkfifo 2 ,
-.Xr mknod 2 ,
 .Xr rename 2 ,
-.Xr rmdir 2 ,
-.Xr symlink 2 ,
-.Xr truncate 2 ,
-.Xr unlink 2 ,
-.Xr utimes 2 ,
-.Xr write 2
+.Xr link 2 ,
 and
-.Xr writev 2
-system calls.
+.Xr unlink 2 .
 .It Va st_birthtim
 Time when the inode was created.
 .El

Modified: stable/11/sbin/mount_fusefs/mount_fusefs.8
==============================================================================
--- stable/11/sbin/mount_fusefs/mount_fusefs.8	Thu Mar 21 21:53:55 2019	(r345390)
+++ stable/11/sbin/mount_fusefs/mount_fusefs.8	Thu Mar 21 21:56:03 2019	(r345391)
@@ -29,7 +29,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 3, 2016
+.Dd November 17, 2018
 .Dt MOUNT_FUSEFS 8
 .Os
 .Sh NAME
@@ -339,12 +339,16 @@ does not call any external utility and also provides a
 .Xr umount 8
 .Sh HISTORY
 .Nm
-appeared in
-.Fx 10.0
-as the part of the
+was written as the part of the
 .Fx
-implementation of the Fuse userspace filesystem
-framework (see http://fuse.sourceforge.net).
+implementation of the Fuse userspace filesystem framework (see
+.Xr https://github.com/libfuse/libfuse )
+and first appeared in the
+.Pa sysutils/fusefs-kmod
+port, supporting
+.Fx 6.0 .
+It was added to the base system in
+.Fx 10.0 .
 .Sh CAVEATS
 This user interface is
 .Fx