diff options
Diffstat (limited to 'templates/man3/ftw.3.pot')
| -rw-r--r-- | templates/man3/ftw.3.pot | 1048 |
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 "" |