Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 1048 insertions, 0 deletions

diff --git a/templates/man3/ftw.3.pot b/templates/man3/ftw.3.pot
new file mode 100644
index 00000000..b9b6ed55
--- /dev/null
+++ b/templates/man3/ftw.3.pot
@@ -0,0 +1,1048 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2024-03-01 16:56+0100\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: TH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "ftw"
+msgstr ""
+
+#. type: TH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+#, no-wrap
+msgid "2023-10-31"
+msgstr ""
+
+#. type: TH
+#: archlinux fedora-40 fedora-rawhide mageia-cauldron
+#, no-wrap
+msgid "Linux man-pages 6.06"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "ftw, nftw - file tree walk"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "LIBRARY"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "Standard C library (I<libc>, I<-lc>)"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "SYNOPSIS"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<#include E<lt>ftw.hE<gt>>\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"B<int nftw(const char *>I<dirpath>B<,>\n"
+"B<        int (*>I<fn>B<)(const char *>I<fpath>B<, const struct stat *>I<sb>B<,>\n"
+"B<                  int >I<typeflag>B<, struct FTW *>I<ftwbuf>B<),>\n"
+"B<        int >I<nopenfd>B<, int >I<flags>B<);>\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"B<[[deprecated]]>\n"
+"B<int ftw(const char *>I<dirpath>B<,>\n"
+"B<        int (*>I<fn>B<)(const char *>I<fpath>B<, const struct stat *>I<sb>B<,>\n"
+"B<                  int >I<typeflag>B<),>\n"
+"B<        int >I<nopenfd>B<);>\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "B<nftw>():"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "    _XOPEN_SOURCE E<gt>= 500\n"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "DESCRIPTION"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"B<nftw>()  walks through the directory tree that is located under the "
+"directory I<dirpath>, and calls I<fn>() once for each entry in the tree.  By "
+"default, directories are handled before the files and subdirectories they "
+"contain (preorder traversal)."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"To avoid using up all of the calling process's file descriptors, I<nopenfd> "
+"specifies the maximum number of directories that B<nftw>()  will hold open "
+"simultaneously.  When the search depth exceeds this, B<nftw>()  will become "
+"slower because directories have to be closed and reopened.  B<nftw>()  uses "
+"at most one file descriptor for each level in the directory tree."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"For each entry found in the tree, B<nftw>()  calls I<fn>() with four "
+"arguments: I<fpath>, I<sb>, I<typeflag>, and I<ftwbuf>.  I<fpath> is the "
+"pathname of the entry, and is expressed either as a pathname relative to the "
+"calling process's current working directory at the time of the call to "
+"B<nftw>(), if I<dirpath> was expressed as a relative pathname, or as an "
+"absolute pathname, if I<dirpath> was expressed as an absolute pathname.  "
+"I<sb> is a pointer to the I<stat> structure returned by a call to "
+"B<stat>(2)  for I<fpath>."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The I<typeflag> argument passed to I<fn>()  is an integer that has one of "
+"the following values:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_F>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "I<fpath> is a regular file."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_D>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "I<fpath> is a directory."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_DNR>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "I<fpath> is a directory which can't be read."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_DP>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"I<fpath> is a directory, and B<FTW_DEPTH> was specified in I<flags>.  (If "
+"B<FTW_DEPTH> was not specified in I<flags>, then directories will always be "
+"visited with I<typeflag> set to B<FTW_D>.)  All of the files and "
+"subdirectories within I<fpath> have been processed."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_NS>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The B<stat>(2)  call failed on I<fpath>, which is not a symbolic link.  The "
+"probable cause for this is that the caller had read permission on the parent "
+"directory, so that the filename I<fpath> could be seen, but did not have "
+"execute permission, so that the file could not be reached for B<stat>(2).  "
+"The contents of the buffer pointed to by I<sb> are undefined."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_SL>"
+msgstr ""
+
+#.  To obtain the definition of this constant from
+#.  .IR <ftw.h> ,
+#.  either
+#.  .B _BSD_SOURCE
+#.  must be defined, or
+#.  .BR _XOPEN_SOURCE
+#.  must be defined with a value of 500 or more.
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "I<fpath> is a symbolic link, and B<FTW_PHYS> was set in I<flags>."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_SLN>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"I<fpath> is a symbolic link pointing to a nonexistent file.  (This occurs "
+"only if B<FTW_PHYS> is not set.)  In this case the I<sb> argument passed to "
+"I<fn>()  contains information returned by performing B<lstat>(2)  on the "
+"\"dangling\" symbolic link.  (But see BUGS.)"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The fourth argument (I<ftwbuf>)  that B<nftw>()  supplies when calling "
+"I<fn>()  is a pointer to a structure of type I<FTW>:"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"struct FTW {\n"
+"    int base;\n"
+"    int level;\n"
+"};\n"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"I<base> is the offset of the filename (i.e., basename component)  in the "
+"pathname given in I<fpath>.  I<level> is the depth of I<fpath> in the "
+"directory tree, relative to the root of the tree (I<dirpath>, which has "
+"depth 0)."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"To stop the tree walk, I<fn>() returns a nonzero value; this value will "
+"become the return value of B<nftw>().  As long as I<fn>() returns 0, "
+"B<nftw>()  will continue either until it has traversed the entire tree, in "
+"which case it will return zero, or until it encounters an error (such as a "
+"B<malloc>(3)  failure), in which case it will return -1."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"Because B<nftw>()  uses dynamic data structures, the only safe way to exit "
+"out of a tree walk is to return a nonzero value from I<fn>().  To allow a "
+"signal to terminate the walk without causing a memory leak, have the handler "
+"set a global flag that is checked by I<fn>().  I<Don't> use B<longjmp>(3)  "
+"unless the program is going to terminate."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The I<flags> argument of B<nftw>()  is formed by ORing zero or more of the "
+"following flags:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_ACTIONRETVAL> (since glibc 2.3.3)"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If this glibc-specific flag is set, then B<nftw>()  handles the return value "
+"from I<fn>()  differently.  I<fn>()  should return one of the following "
+"values:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_CONTINUE>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "Instructs B<nftw>()  to continue normally."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_SKIP_SIBLINGS>"
+msgstr ""
+
+#.  If \fBFTW_DEPTH\fP
+#.  is set, the entry's parent directory is processed next (with
+#.  \fIflag\fP set to \fBFTW_DP\fP).
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If I<fn>() returns this value, then siblings of the current entry will be "
+"skipped, and processing continues in the parent."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_SKIP_SUBTREE>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If I<fn>() is called with an entry that is a directory (I<typeflag> is "
+"B<FTW_D>), this return value will prevent objects within that directory from "
+"being passed as arguments to I<fn>().  B<nftw>()  continues processing with "
+"the next sibling of the directory."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_STOP>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"Causes B<nftw>()  to return immediately with the return value B<FTW_STOP>."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"Other return values could be associated with new actions in the future; "
+"I<fn>() should not return values other than those listed above."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The feature test macro B<_GNU_SOURCE> must be defined (before including "
+"I<any> header files)  in order to obtain the definition of "
+"B<FTW_ACTIONRETVAL> from I<E<lt>ftw.hE<gt>>."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_CHDIR>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If set, do a B<chdir>(2)  to each directory before handling its contents.  "
+"This is useful if the program needs to perform some action in the directory "
+"in which I<fpath> resides.  (Specifying this flag has no effect on the "
+"pathname that is passed in the I<fpath> argument of I<fn>.)"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_DEPTH>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If set, do a post-order traversal, that is, call I<fn>() for the directory "
+"itself I<after> handling the contents of the directory and its "
+"subdirectories.  (By default, each directory is handled I<before> its "
+"contents.)"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_MOUNT>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If set, stay within the same filesystem (i.e., do not cross mount points)."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<FTW_PHYS>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If set, do not follow symbolic links.  (This is what you want.)  If not set, "
+"symbolic links are followed, but no file is reported twice."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If B<FTW_PHYS> is not set, but B<FTW_DEPTH> is set, then the function "
+"I<fn>()  is never called for a directory that would be a descendant of "
+"itself."
+msgstr ""
+
+#. type: SS
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "ftw()"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"B<ftw>()  is an older function that offers a subset of the functionality of "
+"B<nftw>().  The notable differences are as follows:"
+msgstr ""
+
+#. type: IP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "\\[bu]"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"B<ftw>()  has no I<flags> argument.  It behaves the same as when B<nftw>()  "
+"is called with I<flags> specified as zero."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "The callback function, I<fn>(), is not supplied with a fourth argument."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The range of values that is passed via the I<typeflag> argument supplied to "
+"I<fn>()  is smaller: just B<FTW_F>, B<FTW_D>, B<FTW_DNR>, B<FTW_NS>, and "
+"(possibly)  B<FTW_SL>."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "RETURN VALUE"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "These functions return 0 on success, and -1 if an error occurs."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If I<fn>() returns nonzero, then the tree walk is terminated and the value "
+"returned by I<fn>()  is returned as the result of B<ftw>()  or B<nftw>()."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"If B<nftw>()  is called with the B<FTW_ACTIONRETVAL> flag, then the only "
+"nonzero value that should be used by I<fn>()  to terminate the tree walk is "
+"B<FTW_STOP>, and that value is returned as the result of B<nftw>()."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "ATTRIBUTES"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"For an explanation of the terms used in this section, see B<attributes>(7)."
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Interface"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Attribute"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Value"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
+#, no-wrap
+msgid ".na\n"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
+#, no-wrap
+msgid ".nh\n"
+msgstr ""
+
+#. #-#-#-#-#  archlinux: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  debian-bookworm: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: tbl table
+#. #-#-#-#-#  debian-unstable: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  fedora-40: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  fedora-rawhide: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  mageia-cauldron: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  opensuse-leap-15-6: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  opensuse-tumbleweed: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<nftw>()"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Thread safety"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "MT-Safe cwd"
+msgstr ""
+
+#. #-#-#-#-#  archlinux: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  debian-bookworm: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: tbl table
+#. #-#-#-#-#  debian-unstable: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  fedora-40: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  fedora-rawhide: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  mageia-cauldron: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  opensuse-leap-15-6: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#. #-#-#-#-#  opensuse-tumbleweed: ftw.3.pot (PACKAGE VERSION)  #-#-#-#-#
+#. type: TP
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "B<ftw>()"
+msgstr ""
+
+#. type: tbl table
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "MT-Safe"
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "VERSIONS"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"In some implementations (e.g., glibc), B<ftw>()  will never use B<FTW_SL>; "
+"on other systems B<FTW_SL> occurs only for symbolic links that do not point "
+"to an existing file; and again on other systems B<ftw>()  will use B<FTW_SL> "
+"for each symbolic link.  If I<fpath> is a symbolic link and B<stat>(2)  "
+"failed, POSIX.1-2008 states that it is undefined whether B<FTW_NS> or "
+"B<FTW_SL> is passed in I<typeflag>.  For predictable results, use B<nftw>()."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "STANDARDS"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+msgid "POSIX.1-2008."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "HISTORY"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+msgid "POSIX.1-2001, SVr4, SUSv1.  POSIX.1-2008 marks it as obsolete."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+msgid "glibc 2.1.  POSIX.1-2001, SUSv1."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-leap-15-6 opensuse-tumbleweed
+msgid "POSIX.1-2001, SUSv1."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "NOTES"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"POSIX.1-2008 notes that the results are unspecified if I<fn> does not "
+"preserve the current working directory."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "BUGS"
+msgstr ""
+
+#.  https://bugzilla.redhat.com/show_bug.cgi?id=1422736
+#.  http://austingroupbugs.net/view.php?id=1121
+#.  glibc commit 6ba205b2c35e3e024c8c12d2ee1b73363e84da87
+#.  https://sourceware.org/bugzilla/show_bug.cgi?id=23501
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"According to POSIX.1-2008, when the I<typeflag> argument passed to I<fn>()  "
+"contains B<FTW_SLN>, the buffer pointed to by I<sb> should contain "
+"information about the dangling symbolic link (obtained by calling "
+"B<lstat>(2)  on the link).  Early glibc versions correctly followed the "
+"POSIX specification on this point.  However, as a result of a regression "
+"introduced in glibc 2.4, the contents of the buffer pointed to by I<sb> were "
+"undefined when B<FTW_SLN> is passed in I<typeflag>.  (More precisely, the "
+"contents of the buffer were left unchanged in this case.)  This regression "
+"was eventually fixed in glibc 2.30, so that the glibc implementation (once "
+"more) follows the POSIX specification."
+msgstr ""
+
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "EXAMPLES"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid ""
+"The following program traverses the directory tree under the path named in "
+"its first command-line argument, or under the current directory if no "
+"argument is supplied.  It displays various information about each file.  The "
+"second command-line argument can be used to specify characters that control "
+"the value assigned to the I<flags> argument when calling B<nftw>()."
+msgstr ""
+
+#. type: SS
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "Program source"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron
+#: opensuse-tumbleweed
+#, no-wrap
+msgid ""
+"#define _XOPEN_SOURCE 500\n"
+"#include E<lt>ftw.hE<gt>\n"
+"#include E<lt>stdint.hE<gt>\n"
+"#include E<lt>stdio.hE<gt>\n"
+"#include E<lt>stdlib.hE<gt>\n"
+"#include E<lt>string.hE<gt>\n"
+"\\&\n"
+"static int\n"
+"display_info(const char *fpath, const struct stat *sb,\n"
+"             int tflag, struct FTW *ftwbuf)\n"
+"{\n"
+"    printf(\"%-3s %2d \",\n"
+"           (tflag == FTW_D) ?   \"d\"   : (tflag == FTW_DNR) ? \"dnr\" :\n"
+"           (tflag == FTW_DP) ?  \"dp\"  : (tflag == FTW_F) ?   \"f\" :\n"
+"           (tflag == FTW_NS) ?  \"ns\"  : (tflag == FTW_SL) ?  \"sl\" :\n"
+"           (tflag == FTW_SLN) ? \"sln\" : \"???\",\n"
+"           ftwbuf-E<gt>level);\n"
+"\\&\n"
+"    if (tflag == FTW_NS)\n"
+"        printf(\"-------\");\n"
+"    else\n"
+"        printf(\"%7jd\", (intmax_t) sb-E<gt>st_size);\n"
+"\\&\n"
+"    printf(\"   %-40s %d %s\\en\",\n"
+"           fpath, ftwbuf-E<gt>base, fpath + ftwbuf-E<gt>base);\n"
+"\\&\n"
+"    return 0;           /* To tell nftw() to continue */\n"
+"}\n"
+"\\&\n"
+"int\n"
+"main(int argc, char *argv[])\n"
+"{\n"
+"    int flags = 0;\n"
+"\\&\n"
+"    if (argc E<gt> 2 && strchr(argv[2], \\[aq]d\\[aq]) != NULL)\n"
+"        flags |= FTW_DEPTH;\n"
+"    if (argc E<gt> 2 && strchr(argv[2], \\[aq]p\\[aq]) != NULL)\n"
+"        flags |= FTW_PHYS;\n"
+"\\&\n"
+"    if (nftw((argc E<lt> 2) ? \".\" : argv[1], display_info, 20, flags)\n"
+"        == -1)\n"
+"    {\n"
+"        perror(\"nftw\");\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+"\\&\n"
+"    exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#.  SRC END
+#. type: SH
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+#, no-wrap
+msgid "SEE ALSO"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide
+#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed
+msgid "B<stat>(2), B<fts>(3), B<readdir>(3)"
+msgstr ""
+
+#. type: TH
+#: debian-bookworm
+#, no-wrap
+msgid "2023-02-05"
+msgstr ""
+
+#. type: TH
+#: debian-bookworm
+#, no-wrap
+msgid "Linux man-pages 6.03"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm
+msgid "B<nftw>()  is available since glibc 2.1."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm
+msgid ""
+"POSIX.1-2001, POSIX.1-2008, SVr4, SUSv1.  POSIX.1-2008 marks B<ftw>()  as "
+"obsolete."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm
+msgid ""
+"The function B<nftw>()  and the use of B<FTW_SL> with B<ftw>()  were "
+"introduced in SUSv1."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm
+msgid ""
+"In some implementations (e.g., glibc), B<ftw>()  will never use B<FTW_SL>, "
+"on other systems B<FTW_SL> occurs only for symbolic links that do not point "
+"to an existing file, and again on other systems B<ftw>()  will use B<FTW_SL> "
+"for each symbolic link.  If I<fpath> is a symbolic link and B<stat>(2)  "
+"failed, POSIX.1-2008 states that it is undefined whether B<FTW_NS> or "
+"B<FTW_SL> is passed in I<typeflag>.  For predictable results, use B<nftw>()."
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"#define _XOPEN_SOURCE 500\n"
+"#include E<lt>ftw.hE<gt>\n"
+"#include E<lt>stdint.hE<gt>\n"
+"#include E<lt>stdio.hE<gt>\n"
+"#include E<lt>stdlib.hE<gt>\n"
+"#include E<lt>string.hE<gt>\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"static int\n"
+"display_info(const char *fpath, const struct stat *sb,\n"
+"             int tflag, struct FTW *ftwbuf)\n"
+"{\n"
+"    printf(\"%-3s %2d \",\n"
+"           (tflag == FTW_D) ?   \"d\"   : (tflag == FTW_DNR) ? \"dnr\" :\n"
+"           (tflag == FTW_DP) ?  \"dp\"  : (tflag == FTW_F) ?   \"f\" :\n"
+"           (tflag == FTW_NS) ?  \"ns\"  : (tflag == FTW_SL) ?  \"sl\" :\n"
+"           (tflag == FTW_SLN) ? \"sln\" : \"???\",\n"
+"           ftwbuf-E<gt>level);\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    if (tflag == FTW_NS)\n"
+"        printf(\"-------\");\n"
+"    else\n"
+"        printf(\"%7jd\", (intmax_t) sb-E<gt>st_size);\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    printf(\"   %-40s %d %s\\en\",\n"
+"           fpath, ftwbuf-E<gt>base, fpath + ftwbuf-E<gt>base);\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    return 0;           /* To tell nftw() to continue */\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"int\n"
+"main(int argc, char *argv[])\n"
+"{\n"
+"    int flags = 0;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    if (argc E<gt> 2 && strchr(argv[2], \\[aq]d\\[aq]) != NULL)\n"
+"        flags |= FTW_DEPTH;\n"
+"    if (argc E<gt> 2 && strchr(argv[2], \\[aq]p\\[aq]) != NULL)\n"
+"        flags |= FTW_PHYS;\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    if (nftw((argc E<lt> 2) ? \".\" : argv[1], display_info, 20, flags)\n"
+"        == -1)\n"
+"    {\n"
+"        perror(\"nftw\");\n"
+"        exit(EXIT_FAILURE);\n"
+"    }\n"
+msgstr ""
+
+#. type: Plain text
+#: debian-bookworm opensuse-leap-15-6
+#, no-wrap
+msgid ""
+"    exit(EXIT_SUCCESS);\n"
+"}\n"
+msgstr ""
+
+#. type: TH
+#: debian-unstable opensuse-tumbleweed
+#, no-wrap
+msgid "2023-07-20"
+msgstr ""
+
+#. type: TH
+#: debian-unstable opensuse-tumbleweed
+#, no-wrap
+msgid "Linux man-pages 6.05.01"
+msgstr ""
+
+#. type: TH
+#: opensuse-leap-15-6
+#, no-wrap
+msgid "2023-03-30"
+msgstr ""
+
+#. type: TH
+#: opensuse-leap-15-6
+#, no-wrap
+msgid "Linux man-pages 6.04"
+msgstr ""