diff options
Diffstat (limited to 'templates/man2/stat.2.pot')
| -rw-r--r-- | templates/man2/stat.2.pot | 1029 |
1 files changed, 1029 insertions, 0 deletions
diff --git a/templates/man2/stat.2.pot b/templates/man2/stat.2.pot new file mode 100644 index 00000000..bddae950 --- /dev/null +++ b/templates/man2/stat.2.pot @@ -0,0 +1,1029 @@ +# 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 17:09+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 "stat" +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 "stat, fstat, lstat, fstatat - get file status" +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>sys/stat.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 stat(const char *restrict >I<pathname>B<,>\n" +"B< struct stat *restrict >I<statbuf>B<);>\n" +"B<int fstat(int >I<fd>B<, struct stat *>I<statbuf>B<);>\n" +"B<int lstat(const char *restrict >I<pathname>B<,>\n" +"B< struct stat *restrict >I<statbuf>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<#include E<lt>fcntl.hE<gt> >/* Definition of B<AT_*> constants */\n" +"B<#include E<lt>sys/stat.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 fstatat(int >I<dirfd>B<, const char *restrict >I<pathname>B<,>\n" +"B< struct stat *restrict >I<statbuf>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 +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<lstat>():" +msgstr "" + +#. _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +" /* Since glibc 2.20 */ _DEFAULT_SOURCE\n" +" || _XOPEN_SOURCE E<gt>= 500\n" +" || /* Since glibc 2.10: */ _POSIX_C_SOURCE E<gt>= 200112L\n" +" || /* glibc 2.19 and earlier */ _BSD_SOURCE\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "B<fstatat>():" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "" +" Since glibc 2.10:\n" +" _POSIX_C_SOURCE E<gt>= 200809L\n" +" Before glibc 2.10:\n" +" _ATFILE_SOURCE\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 "" +"These functions return information about a file, in the buffer pointed to by " +"I<statbuf>. No permissions are required on the file itself, but\\[em]in the " +"case of B<stat>(), B<fstatat>(), and B<lstat>()\\[em]execute (search) " +"permission is required on all of the directories in I<pathname> that lead to " +"the file." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<stat>() and B<fstatat>() retrieve information about the file pointed to " +"by I<pathname>; the differences for B<fstatat>() are described below." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<lstat>() is identical to B<stat>(), except that if I<pathname> is a " +"symbolic link, then it returns information about the link itself, not the " +"file that the link refers to." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"B<fstat>() is identical to B<stat>(), except that the file about which " +"information is to be retrieved is specified by the file descriptor I<fd>." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "The stat structure" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"All of these system calls return a I<stat> structure (see B<stat>(3type))." +msgstr "" + +#. Background: inode attributes are modified with i_mutex held, but +#. read by stat() without taking the mutex. +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<Note>: for performance and simplicity reasons, different fields in the " +"I<stat> structure may contain state information from different moments " +"during the execution of the system call. For example, if I<st_mode> or " +"I<st_uid> is changed by another process by calling B<chmod>(2) or " +"B<chown>(2), B<stat>() might return the old I<st_mode> together with the " +"new I<st_uid>, or the old I<st_uid> together with the new I<st_mode>." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "fstatat()" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The B<fstatat>() system call is a more general interface for accessing file " +"information which can still provide exactly the behavior of each of " +"B<stat>(), B<lstat>(), and B<fstat>()." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If the pathname given in I<pathname> is relative, then it is interpreted " +"relative to the directory referred to by the file descriptor I<dirfd> " +"(rather than relative to the current working directory of the calling " +"process, as is done by B<stat>() and B<lstat>() for a relative pathname)." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, " +"then I<pathname> is interpreted relative to the current working directory of " +"the calling process (like B<stat>() and B<lstat>())." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "If I<pathname> is absolute, then I<dirfd> is ignored." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<flags> can either be 0, or include one or more of the following flags ORed:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<AT_EMPTY_PATH> (since Linux 2.6.39)" +msgstr "" + +#. commit 65cfc6722361570bfe255698d9cd4dccaf47570d +#. Before glibc 2.16, defining _ATFILE_SOURCE sufficed +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is an empty string, operate on the file referred to by " +"I<dirfd> (which may have been obtained using the B<open>(2) B<O_PATH> " +"flag). In this case, I<dirfd> can refer to any type of file, not just a " +"directory, and the behavior of B<fstatat>() is similar to that of " +"B<fstat>(). If I<dirfd> is B<AT_FDCWD>, the call operates on the current " +"working directory. This flag is Linux-specific; define B<_GNU_SOURCE> to " +"obtain its definition." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<AT_NO_AUTOMOUNT> (since Linux 2.6.38)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Don't automount the terminal (\"basename\") component of I<pathname.> Since " +"Linux 3.1 this flag is ignored. Since Linux 4.11 this flag is implied." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<AT_SYMLINK_NOFOLLOW>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"If I<pathname> is a symbolic link, do not dereference it: instead return " +"information about the link itself, like B<lstat>(). (By default, " +"B<fstatat>() dereferences symbolic links, like B<stat>().)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "See B<openat>(2) for an explanation of the need for B<fstatat>()." +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 "" +"On success, zero is returned. On error, -1 is returned, and I<errno> is set " +"to indicate the error." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "ERRORS" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EACCES>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Search permission is denied for one of the directories in the path prefix of " +"I<pathname>. (See also B<path_resolution>(7).)" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EBADF>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<fd> is not a valid open file descriptor." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"(B<fstatat>()) I<pathname> is relative but I<dirfd> is neither B<AT_FDCWD> " +"nor a valid file descriptor." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EFAULT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Bad address." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<EINVAL>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "(B<fstatat>()) Invalid flag specified 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<ELOOP>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Too many symbolic links encountered while traversing the path." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENAMETOOLONG>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "I<pathname> is too long." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOENT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"A component of I<pathname> does not exist or is a dangling symbolic link." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<pathname> is an empty string and B<AT_EMPTY_PATH> was not specified 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<ENOMEM>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "Out of memory (i.e., kernel memory)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<ENOTDIR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "A component of the path prefix of I<pathname> is not a directory." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"(B<fstatat>()) I<pathname> is relative and I<dirfd> is a file descriptor " +"referring to a file other than 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<EOVERFLOW>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"I<pathname> or I<fd> refers to a file whose size, inode number, or number of " +"blocks cannot be represented in, respectively, the types I<off_t>, I<ino_t>, " +"or I<blkcnt_t>. This error can occur when, for example, an application " +"compiled on a 32-bit platform without I<-D_FILE_OFFSET_BITS=64> calls " +"B<stat>() on a file whose size exceeds I<(1E<lt>E<lt>31)-1> bytes." +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: TP +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<stat>()" +msgstr "" + +#. type: TQ +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<fstat>()" +msgstr "" + +#. type: TQ +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<lstat>()" +msgstr "" + +#. SVr4 documents additional +#. .BR fstat () +#. error conditions EINTR, ENOLINK, and EOVERFLOW. SVr4 +#. documents additional +#. .BR stat () +#. and +#. .BR lstat () +#. error conditions EINTR, EMULTIHOP, ENOLINK, and EOVERFLOW. +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "SVr4, 4.3BSD, POSIX.1-2001." +msgstr "" + +#. type: TP +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "B<fstatat>()" +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-leap-15-6 opensuse-tumbleweed +msgid "POSIX.1-2008. Linux 2.6.16, glibc 2.4." +msgstr "" + +#. 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-2001, B<lstat>() on a symbolic link need return valid " +"information only in the I<st_size> field and the file type of the I<st_mode> " +"field of the I<stat> structure. POSIX.1-2008 tightens the specification, " +"requiring B<lstat>() to return valid information in all fields except the " +"mode bits in I<st_mode>." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Use of the I<st_blocks> and I<st_blksize> fields may be less portable. " +"(They were introduced in BSD. The interpretation differs between systems, " +"and possibly on a single system when NFS mounts are involved.)" +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "C library/kernel differences" +msgstr "" + +#. See include/asm-i386/stat.h in the Linux 2.4 source code for the +#. various versions of the structure definitions +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Over time, increases in the size of the I<stat> structure have led to three " +"successive versions of B<stat>(): I<sys_stat>() (slot I<__NR_oldstat>), " +"I<sys_newstat>() (slot I<__NR_stat>), and I<sys_stat64()> (slot " +"I<__NR_stat64>) on 32-bit platforms such as i386. The first two versions " +"were already present in Linux 1.0 (albeit with different names); the last " +"was added in Linux 2.4. Similar remarks apply for B<fstat>() and " +"B<lstat>()." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The kernel-internal versions of the I<stat> structure dealt with by the " +"different versions are, respectively:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "I<__old_kernel_stat>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "The original structure, with rather narrow fields, and no padding." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "I<stat>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Larger I<st_ino> field and padding added to various parts of the structure " +"to allow for future expansion." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "I<stat64>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"Even larger I<st_ino> field, larger I<st_uid> and I<st_gid> fields to " +"accommodate the Linux-2.4 expansion of UIDs and GIDs to 32 bits, and various " +"other enlarged fields and further padding in the structure. (Various " +"padding bytes were eventually consumed in Linux 2.6, with the advent of 32-" +"bit device IDs and nanosecond components for the timestamp fields.)" +msgstr "" + +# +# +# +# +# +# +#. A note from Andries Brouwer, July 2007 +#. > Is the story not rather more complicated for some calls like +#. > stat(2)? +#. Yes and no, mostly no. See /usr/include/sys/stat.h . +#. The idea is here not so much that syscalls change, but that +#. the definitions of struct stat and of the types dev_t and mode_t change. +#. This means that libc (even if it does not call the kernel +#. but only calls some internal function) must know what the +#. format of dev_t or of struct stat is. +#. The communication between the application and libc goes via +#. the include file <sys/stat.h> that defines a _STAT_VER and +#. _MKNOD_VER describing the layout of the data that user space +#. uses. Each (almost each) occurrence of stat() is replaced by +#. an occurrence of xstat() where the first parameter of xstat() +#. is this version number _STAT_VER. +#. Now, also the definitions used by the kernel change. +#. But glibc copes with this in the standard way, and the +#. struct stat as returned by the kernel is repacked into +#. the struct stat as expected by the application. +#. Thus, _STAT_VER and this setup cater for the application-libc +#. interface, rather than the libc-kernel interface. +#. (Note that the details depend on gcc being used as c compiler.) +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The glibc B<stat>() wrapper function hides these details from applications, " +"invoking the most recent version of the system call provided by the kernel, " +"and repacking the returned information if required for old binaries." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"On modern 64-bit systems, life is simpler: there is a single B<stat>() " +"system call and the kernel deals with a I<stat> structure that contains " +"fields of a sufficient size." +msgstr "" + +#. strace(1) shows the name "newfstatat" on x86-64 +#. type: Plain text +#: archlinux debian-bookworm debian-unstable fedora-40 fedora-rawhide +#: mageia-cauldron opensuse-leap-15-6 opensuse-tumbleweed +msgid "" +"The underlying system call employed by the glibc B<fstatat>() wrapper " +"function is actually called B<fstatat64>() or, on some architectures, " +"B<newfstatat>()." +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 calls B<lstat>() and displays selected fields in the " +"returned I<stat> structure." +msgstr "" + +#. type: Plain text +#: archlinux debian-unstable fedora-40 fedora-rawhide mageia-cauldron +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"#include E<lt>stdint.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>sys/stat.hE<gt>\n" +"#include E<lt>sys/sysmacros.hE<gt>\n" +"#include E<lt>time.hE<gt>\n" +"\\&\n" +"int\n" +"main(int argc, char *argv[])\n" +"{\n" +" struct stat sb;\n" +"\\&\n" +" if (argc != 2) {\n" +" fprintf(stderr, \"Usage: %s E<lt>pathnameE<gt>\\en\", argv[0]);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" if (lstat(argv[1], &sb) == -1) {\n" +" perror(\"lstat\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +"\\&\n" +" printf(\"ID of containing device: [%x,%x]\\en\",\n" +" major(sb.st_dev),\n" +" minor(sb.st_dev));\n" +"\\&\n" +" printf(\"File type: \");\n" +"\\&\n" +" switch (sb.st_mode & S_IFMT) {\n" +" case S_IFBLK: printf(\"block device\\en\"); break;\n" +" case S_IFCHR: printf(\"character device\\en\"); break;\n" +" case S_IFDIR: printf(\"directory\\en\"); break;\n" +" case S_IFIFO: printf(\"FIFO/pipe\\en\"); break;\n" +" case S_IFLNK: printf(\"symlink\\en\"); break;\n" +" case S_IFREG: printf(\"regular file\\en\"); break;\n" +" case S_IFSOCK: printf(\"socket\\en\"); break;\n" +" default: printf(\"unknown?\\en\"); break;\n" +" }\n" +"\\&\n" +" printf(\"I-node number: %ju\\en\", (uintmax_t) sb.st_ino);\n" +"\\&\n" +" printf(\"Mode: %jo (octal)\\en\",\n" +" (uintmax_t) sb.st_mode);\n" +"\\&\n" +" printf(\"Link count: %ju\\en\", (uintmax_t) sb.st_nlink);\n" +" printf(\"Ownership: UID=%ju GID=%ju\\en\",\n" +" (uintmax_t) sb.st_uid, (uintmax_t) sb.st_gid);\n" +"\\&\n" +" printf(\"Preferred I/O block size: %jd bytes\\en\",\n" +" (intmax_t) sb.st_blksize);\n" +" printf(\"File size: %jd bytes\\en\",\n" +" (intmax_t) sb.st_size);\n" +" printf(\"Blocks allocated: %jd\\en\",\n" +" (intmax_t) sb.st_blocks);\n" +"\\&\n" +" printf(\"Last status change: %s\", ctime(&sb.st_ctime));\n" +" printf(\"Last file access: %s\", ctime(&sb.st_atime));\n" +" printf(\"Last file modification: %s\", ctime(&sb.st_mtime));\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<ls>(1), B<stat>(1), B<access>(2), B<chmod>(2), B<chown>(2), " +"B<readlink>(2), B<statx>(2), B<utime>(2), B<stat>(3type), " +"B<capabilities>(7), B<inode>(7), B<symlink>(7)" +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: SH +#: debian-bookworm +#, no-wrap +msgid "VERSIONS" +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "" +"B<fstatat>() was added in Linux 2.6.16; library support was added in glibc " +"2.4." +msgstr "" + +#. SVr4 documents additional +#. .BR fstat () +#. error conditions EINTR, ENOLINK, and EOVERFLOW. SVr4 +#. documents additional +#. .BR stat () +#. and +#. .BR lstat () +#. error conditions EINTR, EMULTIHOP, ENOLINK, and EOVERFLOW. +#. type: Plain text +#: debian-bookworm +msgid "" +"B<stat>(), B<fstat>(), B<lstat>(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1.2008." +msgstr "" + +#. type: Plain text +#: debian-bookworm +msgid "B<fstatat>(): POSIX.1-2008." +msgstr "" + +#. type: SH +#: debian-bookworm +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"#include E<lt>stdint.hE<gt>\n" +"#include E<lt>stdio.hE<gt>\n" +"#include E<lt>stdlib.hE<gt>\n" +"#include E<lt>sys/stat.hE<gt>\n" +"#include E<lt>sys/sysmacros.hE<gt>\n" +"#include E<lt>time.hE<gt>\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +"int\n" +"main(int argc, char *argv[])\n" +"{\n" +" struct stat sb;\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (argc != 2) {\n" +" fprintf(stderr, \"Usage: %s E<lt>pathnameE<gt>\\en\", argv[0]);\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" if (lstat(argv[1], &sb) == -1) {\n" +" perror(\"lstat\");\n" +" exit(EXIT_FAILURE);\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"ID of containing device: [%x,%x]\\en\",\n" +" major(sb.st_dev),\n" +" minor(sb.st_dev));\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " printf(\"File type: \");\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" switch (sb.st_mode & S_IFMT) {\n" +" case S_IFBLK: printf(\"block device\\en\"); break;\n" +" case S_IFCHR: printf(\"character device\\en\"); break;\n" +" case S_IFDIR: printf(\"directory\\en\"); break;\n" +" case S_IFIFO: printf(\"FIFO/pipe\\en\"); break;\n" +" case S_IFLNK: printf(\"symlink\\en\"); break;\n" +" case S_IFREG: printf(\"regular file\\en\"); break;\n" +" case S_IFSOCK: printf(\"socket\\en\"); break;\n" +" default: printf(\"unknown?\\en\"); break;\n" +" }\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid " printf(\"I-node number: %ju\\en\", (uintmax_t) sb.st_ino);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"Mode: %jo (octal)\\en\",\n" +" (uintmax_t) sb.st_mode);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"Link count: %ju\\en\", (uintmax_t) sb.st_nlink);\n" +" printf(\"Ownership: UID=%ju GID=%ju\\en\",\n" +" (uintmax_t) sb.st_uid, (uintmax_t) sb.st_gid);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"Preferred I/O block size: %jd bytes\\en\",\n" +" (intmax_t) sb.st_blksize);\n" +" printf(\"File size: %jd bytes\\en\",\n" +" (intmax_t) sb.st_size);\n" +" printf(\"Blocks allocated: %jd\\en\",\n" +" (intmax_t) sb.st_blocks);\n" +msgstr "" + +#. type: Plain text +#: debian-bookworm opensuse-leap-15-6 +#, no-wrap +msgid "" +" printf(\"Last status change: %s\", ctime(&sb.st_ctime));\n" +" printf(\"Last file access: %s\", ctime(&sb.st_atime));\n" +" printf(\"Last file modification: %s\", ctime(&sb.st_mtime));\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-05-03" +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 "" |