summaryrefslogtreecommitdiff
path: root/man3/glob.3
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2007-04-12 22:42:49 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2007-04-12 22:42:49 +0000
commitc13182efa3b3d77f2563034c8212c0ca798243ca (patch)
treee7652b26018b7c22cd6a4e4b41404dfaab911303 /man3/glob.3
parent4174ff5658082832c2ed511720f18881b3a80a34 (diff)
Wrapped long lines, wrapped at sentence boundaries; stripped trailing
white space.
Diffstat (limited to 'man3/glob.3')
-rw-r--r--man3/glob.331
1 files changed, 16 insertions, 15 deletions
diff --git a/man3/glob.3 b/man3/glob.3
index 363e49c5..24c03fca 100644
--- a/man3/glob.3
+++ b/man3/glob.3
@@ -8,7 +8,7 @@
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one.
-.\"
+.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
@@ -16,7 +16,7 @@
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
-.\"
+.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\" License.
@@ -106,8 +106,8 @@ slots will be reserved at the beginning of the list of strings in
which means that, if no pattern matches, to return the original pattern,
.TP
.B GLOB_APPEND
-which means to append to the results of a previous call. Do not set
-this flag on the first invocation of
+which means to append to the results of a previous call.
+Do not set this flag on the first invocation of
.BR glob ().
.TP
.B GLOB_NOESCAPE
@@ -153,29 +153,30 @@ a pointer to the path which failed, and
the value of
.I errno
as returned from one of the calls to
-.BR opendir (),
-.BR readdir (),
-or
+.BR opendir (),
+.BR readdir (),
+or
.BR stat ().
-If
+If
.I errfunc
returns non-zero, or if
.B GLOB_ERR
-is set,
+is set,
.BR glob ()
will terminate after the call to
.IR errfunc .
.PP
-Upon successful return,
+Upon successful return,
.I pglob->gl_pathc
contains the number of matched pathnames and
.I pglob->gl_pathv
-a pointer to the list of matched pathnames. The first pointer after
-the last pathname is NULL.
+a pointer to the list of matched pathnames.
+The first pointer after the last pathname is NULL.
.PP
It is possible to call
.BR glob ()
-several times. In that case, the
+several times.
+In that case, the
.B GLOB_APPEND
flag has to be set in
.I flags
@@ -187,7 +188,7 @@ is set to the flags specified, \fBor\fRed with
.B GLOB_MAGCHAR
if any metacharacters were found.
.SH "RETURN VALUE"
-On successful completion,
+On successful completion,
.BR glob ()
returns zero.
Other possible returns are:
@@ -224,7 +225,7 @@ POSIX.2, POSIX.1-2001.
The
.BR glob ()
function may fail due to failure of underlying function calls, such as
-.BR malloc ()
+.BR malloc ()
or
.BR opendir ().
These will store their error code in