[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-3810-g8cf269c

[Arnold Robbins]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".

The branch, master has been updated
       via  8cf269c998f8592f4022af4b05703cae0e12ba7c (commit)
      from  98e500ff3ceb035d9d42acf25aa365940cf47568 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=8cf269c998f8592f4022af4b05703cae0e12ba7c

commit 8cf269c998f8592f4022af4b05703cae0e12ba7c
Author: Arnold D. Robbins <address@hidden>
Date:   Wed Aug 21 20:14:07 2019 +0300

    Document statvfs in filefuncs.3am.

diff --git a/extension/ChangeLog b/extension/ChangeLog
index 22d73d0..fef2eb7 100644
--- a/extension/ChangeLog
+++ b/extension/ChangeLog
@@ -1,3 +1,9 @@
+2019-08-21         Arnold D. Robbins     <address@hidden>
+
+       * filefuncs.c: Fix a typo in a comment. Update copyright year.
+       * filefuncs.3am: Document statvfs. Thanks to Andrew Schorr
+       for noticing it was missing. Update copyright year.
+
 2019-06-26         Arnold D. Robbins     <address@hidden>
 
        * inplace.3am: Update to match current code's behavior.
diff --git a/extension/filefuncs.3am b/extension/filefuncs.3am
index 571fdea..1ccf98f 100644
--- a/extension/filefuncs.3am
+++ b/extension/filefuncs.3am
@@ -12,6 +12,8 @@ result = stat("/some/path", statdata [, follow])
 flags = or(FTS_PHYSICAL, ...)
 .br
 result = fts(pathlist, flags, filedata)
+.sp
+result = statvfs("/some/path", fsdata)
 .ft R
 .SH DESCRIPTION
 The
@@ -301,6 +303,89 @@ and
 The
 .B fts()
 function returns 0 if there were no errors. Otherwise it returns \-1.
+.SS statvfs()
+The
+.B statvfs()
+function provides a hook into the
+.IR statvfs (2)
+system call on systems that supply this system call.
+It returns zero
+upon success or less than zero upon error.
+In the latter case it updates
+.BR ERRNO .
+.PP
+When the call is successful,
+.B statvfs()
+fills the
+.B fsdata
+array with information retrieved about the filesystem, as follows:
+.TP
+\fBfsdata["bsize"]\fP
+Corresponds to the
+.B bsize
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["frsize"]\fP
+Corresponds to the
+.I f_frsize
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["blocks"]\fP
+Corresponds to the
+.I f_blocks
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["bfree"]\fP
+Corresponds to the
+.I f_bfree
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["bavail"]\fP
+Corresponds to the
+.I f_bavail
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["files"]\fP
+Corresponds to the
+.I f_files
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["ffree"]\fP
+Corresponds to the
+.I f_ffree
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["favail"]\fP
+Corresponds to the
+.I f_favail
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["fsid"]\fP
+Corresponds to the
+.I f_fsid
+member in the
+.IR "struct statvfs" .
+This member is not available on all systems.
+.TP
+\fBfsdata["flag"]\fP
+Corresponds to the
+.I f_flag
+member in the
+.IR "struct statvfs" .
+.TP
+\fBfsdata["namemax"]\fP
+Corresponds to the
+.I f_namemax
+member in the
+.IR "struct statvfs" .
 .SH NOTES
 The AWK
 .B fts()
@@ -348,12 +433,13 @@ distribution for an example.
 .PP
 .IR chdir (2),
 .IR fts (3),
-.IR stat (2).
+.IR stat (2),
+.IR statvfs (2).
 .SH AUTHOR
 Arnold Robbins,
 .BR address@hidden .
 .SH COPYING PERMISSIONS
-Copyright \(co 2012, 2013, 2018,
+Copyright \(co 2012, 2013, 2018, 2019,
 Free Software Foundation, Inc.
 .PP
 Permission is granted to make and distribute verbatim copies of
diff --git a/extension/filefuncs.c b/extension/filefuncs.c
index 1ea25db..828f68a 100644
--- a/extension/filefuncs.c
+++ b/extension/filefuncs.c
@@ -10,7 +10,7 @@
  */
 
 /*
- * Copyright (C) 2001, 2004, 2005, 2010-2018
+ * Copyright (C) 2001, 2004, 2005, 2010-2019
  * the Free Software Foundation, Inc.
  *
  * This file is part of GAWK, the GNU implementation of the
@@ -527,7 +527,7 @@ do_statvfs(int nargs, awk_value_t *result, struct 
awk_ext_func *unused)
        /* always empty out the array */
        clear_array(array);
 
-       /* stat the file; if error, set ERRNO and return */
+       /* statvfs the filesystem; if error, set ERRNO and return */
        ret = statvfs(name, & vfsbuf);
        if (ret < 0) {
                update_ERRNO_int(errno);

-----------------------------------------------------------------------

Summary of changes:
 extension/ChangeLog     |  6 ++++
 extension/filefuncs.3am | 90 +++++++++++++++++++++++++++++++++++++++++++++++--
 extension/filefuncs.c   |  4 +--
 3 files changed, 96 insertions(+), 4 deletions(-)


hooks/post-receive
-- 
gawk