diff options
Diffstat (limited to 'extension')
| -rw-r--r-- | extension/ChangeLog | 5 | ||||
| -rw-r--r-- | extension/readdir.3am | 12 |
2 files changed, 16 insertions, 1 deletions
diff --git a/extension/ChangeLog b/extension/ChangeLog index f85683a4..d71ac219 100644 --- a/extension/ChangeLog +++ b/extension/ChangeLog @@ -1,3 +1,8 @@ +2019-11-03 Arnold D. Robbins <arnold@skeeve.com> + + * readdir.3am: Document that readdir extension can cause a + fatal error, which should be handled with BEGINFILE. + 2019-10-16 Andrew J. Schorr <aschorr@telemetry-investments.com> * filefuncs.3am: Enhance the stat() documentation to explain that diff --git a/extension/readdir.3am b/extension/readdir.3am index e4f24dff..531c65cf 100644 --- a/extension/readdir.3am +++ b/extension/readdir.3am @@ -1,4 +1,4 @@ -.TH READDIR 3am "Mar 17 2019" "Free Software Foundation" "GNU Awk Extension Modules" +.TH READDIR 3am "Oct 30 2019" "Free Software Foundation" "GNU Awk Extension Modules" .SH NAME readdir \- directory input parser for gawk .SH SYNOPSIS @@ -42,6 +42,16 @@ to calling in order to provide the information. Thus the third field should never be .BR u . +.PP +By default, if a directory cannot be opened (due to permission problems, +for example), +.I gawk +will exit. +As with regular files, this situation can be handled using a +.B BEGINFILE +rule that checks +.B ERRNO +and prints an error or otherwise handles the problem. .\" .SH BUGS .SH EXAMPLE .ft CW |