2020-07-17 12:18:39 +00:00
|
|
|
/* Definition for struct stat.
|
|
|
|
Copyright (C) 2020 Free Software Foundation, Inc.
|
2011-12-04 02:13:38 +00:00
|
|
|
This file is part of the GNU C Library.
|
|
|
|
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
|
|
|
modify it under the terms of the GNU Lesser General Public
|
|
|
|
License as published by the Free Software Foundation; either
|
|
|
|
version 2.1 of the License, or (at your option) any later version.
|
|
|
|
|
|
|
|
The GNU C Library is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
|
|
Lesser General Public License for more details.
|
|
|
|
|
|
|
|
You should have received a copy of the GNU Lesser General Public
|
2012-03-09 23:56:38 +00:00
|
|
|
License along with the GNU C Library. If not, see
|
Prefer https to http for gnu.org and fsf.org URLs
Also, change sources.redhat.com to sourceware.org.
This patch was automatically generated by running the following shell
script, which uses GNU sed, and which avoids modifying files imported
from upstream:
sed -ri '
s,(http|ftp)(://(.*\.)?(gnu|fsf|sourceware)\.org($|[^.]|\.[^a-z])),https\2,g
s,(http|ftp)(://(.*\.)?)sources\.redhat\.com($|[^.]|\.[^a-z]),https\2sourceware.org\4,g
' \
$(find $(git ls-files) -prune -type f \
! -name '*.po' \
! -name 'ChangeLog*' \
! -path COPYING ! -path COPYING.LIB \
! -path manual/fdl-1.3.texi ! -path manual/lgpl-2.1.texi \
! -path manual/texinfo.tex ! -path scripts/config.guess \
! -path scripts/config.sub ! -path scripts/install-sh \
! -path scripts/mkinstalldirs ! -path scripts/move-if-change \
! -path INSTALL ! -path locale/programs/charmap-kw.h \
! -path po/libc.pot ! -path sysdeps/gnu/errlist.c \
! '(' -name configure \
-execdir test -f configure.ac -o -f configure.in ';' ')' \
! '(' -name preconfigure \
-execdir test -f preconfigure.ac ';' ')' \
-print)
and then by running 'make dist-prepare' to regenerate files built
from the altered files, and then executing the following to cleanup:
chmod a+x sysdeps/unix/sysv/linux/riscv/configure
# Omit irrelevant whitespace and comment-only changes,
# perhaps from a slightly-different Autoconf version.
git checkout -f \
sysdeps/csky/configure \
sysdeps/hppa/configure \
sysdeps/riscv/configure \
sysdeps/unix/sysv/linux/csky/configure
# Omit changes that caused a pre-commit check to fail like this:
# remote: *** error: sysdeps/powerpc/powerpc64/ppc-mcount.S: trailing lines
git checkout -f \
sysdeps/powerpc/powerpc64/ppc-mcount.S \
sysdeps/unix/sysv/linux/s390/s390-64/syscall.S
# Omit change that caused a pre-commit check to fail like this:
# remote: *** error: sysdeps/sparc/sparc64/multiarch/memcpy-ultra3.S: last line does not end in newline
git checkout -f sysdeps/sparc/sparc64/multiarch/memcpy-ultra3.S
2019-09-07 05:40:42 +00:00
|
|
|
<https://www.gnu.org/licenses/>. */
|
2011-12-04 02:13:38 +00:00
|
|
|
|
|
|
|
#if !defined _SYS_STAT_H && !defined _FCNTL_H
|
2020-07-17 12:18:39 +00:00
|
|
|
# error "Never include <bits/struct_stat.h> directly; use <sys/stat.h> instead."
|
2011-12-04 02:13:38 +00:00
|
|
|
#endif
|
|
|
|
|
2020-07-17 12:18:39 +00:00
|
|
|
#ifndef _BITS_STRUCT_STAT_H
|
|
|
|
#define _BITS_STRUCT_STAT_H 1
|
2011-12-04 02:13:38 +00:00
|
|
|
|
Split up endian.h to minimize exposure of BYTE_ORDER.
With only two exceptions (sys/types.h and sys/param.h, both of which
historically might have defined BYTE_ORDER) the public headers that
include <endian.h> only want to be able to test __BYTE_ORDER against
__*_ENDIAN.
This patch creates a new bits/endian.h that can be included by any
header that wants to be able to test __BYTE_ORDER and/or
__FLOAT_WORD_ORDER against the __*_ENDIAN constants, or needs
__LONG_LONG_PAIR. It only defines macros in the implementation
namespace.
The existing bits/endian.h (which could not be included independently
of endian.h, and only defines __BYTE_ORDER and maybe __FLOAT_WORD_ORDER)
is renamed to bits/endianness.h. I also took the opportunity to
canonicalize the form of this header, which we are stuck with having
one copy of per architecture. Since they are so short, this means git
doesn’t understand that they were renamed from existing headers, sigh.
endian.h itself is a nonstandard header and its only remaining use
from a standard header is guarded by __USE_MISC, so I dropped the
__USE_MISC conditionals from around all of the public-namespace things
it defines. (This means, an application that requests strict library
conformance but includes endian.h will still see the definition of
BYTE_ORDER.)
A few changes to specific bits/endian(ness).h variants deserve
mention:
- sysdeps/unix/sysv/linux/ia64/bits/endian.h is moved to
sysdeps/ia64/bits/endianness.h. If I remember correctly, ia64 did
have selectable endianness, but we have assembly code in
sysdeps/ia64 that assumes it’s little-endian, so there is no reason
to treat the ia64 endianness.h as linux-specific.
- The C-SKY port does not fully support big-endian mode, the compile
will error out if __CSKYBE__ is defined.
- The PowerPC port had extra logic in its bits/endian.h to detect a
broken compiler, which strikes me as unnecessary, so I removed it.
- The only files that defined __FLOAT_WORD_ORDER always defined it to
the same value as __BYTE_ORDER, so I removed those definitions.
The SH bits/endian(ness).h had comments inconsistent with the
actual setting of __FLOAT_WORD_ORDER, which I also removed.
- I *removed* copyright boilerplate from the few bits/endian(ness).h
headers that had it; these files record a single fact in a fashion
dictated by an external spec, so I do not think they are copyrightable.
As long as I was changing every copy of ieee754.h in the tree, I
noticed that only the MIPS variant includes float.h, because it uses
LDBL_MANT_DIG to decide among three different versions of
ieee854_long_double. This patch makes it not include float.h when
GCC’s intrinsic __LDBL_MANT_DIG__ is available.
* string/endian.h: Unconditionally define LITTLE_ENDIAN,
BIG_ENDIAN, PDP_ENDIAN, and BYTE_ORDER. Condition byteswapping
macros only on !__ASSEMBLER__. Move the definitions of
__BIG_ENDIAN, __LITTLE_ENDIAN, __PDP_ENDIAN, __FLOAT_WORD_ORDER,
and __LONG_LONG_PAIR to...
* string/bits/endian.h: ...this new file, which includes
the renamed header bits/endianness.h for the definition of
__BYTE_ORDER and possibly __FLOAT_WORD_ORDER.
* string/Makefile: Install bits/endianness.h.
* include/bits/endian.h: New wrapper.
* bits/endian.h: Rename to bits/endianness.h.
Add multiple-include guard. Rewrite the comment explaining what
the machine-specific variants of this file should do.
* sysdeps/unix/sysv/linux/ia64/bits/endian.h:
Move to sysdeps/ia64.
* sysdeps/aarch64/bits/endian.h
* sysdeps/alpha/bits/endian.h
* sysdeps/arm/bits/endian.h
* sysdeps/csky/bits/endian.h
* sysdeps/hppa/bits/endian.h
* sysdeps/ia64/bits/endian.h
* sysdeps/m68k/bits/endian.h
* sysdeps/microblaze/bits/endian.h
* sysdeps/mips/bits/endian.h
* sysdeps/nios2/bits/endian.h
* sysdeps/powerpc/bits/endian.h
* sysdeps/riscv/bits/endian.h
* sysdeps/s390/bits/endian.h
* sysdeps/sh/bits/endian.h
* sysdeps/sparc/bits/endian.h
* sysdeps/x86/bits/endian.h:
Rename to endianness.h; canonicalize form of file; remove
redundant definitions of __FLOAT_WORD_ORDER.
* sysdeps/powerpc/bits/endianness.h: Remove logic to check for
broken compilers.
* ctype/ctype.h
* sysdeps/aarch64/nptl/bits/pthreadtypes-arch.h
* sysdeps/arm/nptl/bits/pthreadtypes-arch.h
* sysdeps/csky/nptl/bits/pthreadtypes-arch.h
* sysdeps/ia64/ieee754.h
* sysdeps/ieee754/ieee754.h
* sysdeps/ieee754/ldbl-128/ieee754.h
* sysdeps/ieee754/ldbl-128ibm/ieee754.h
* sysdeps/m68k/nptl/bits/pthreadtypes-arch.h
* sysdeps/microblaze/nptl/bits/pthreadtypes-arch.h
* sysdeps/mips/ieee754/ieee754.h
* sysdeps/mips/nptl/bits/pthreadtypes-arch.h
* sysdeps/nios2/nptl/bits/pthreadtypes-arch.h
* sysdeps/nptl/pthread.h
* sysdeps/riscv/nptl/bits/pthreadtypes-arch.h
* sysdeps/sh/nptl/bits/pthreadtypes-arch.h
* sysdeps/sparc/sparc32/ieee754.h
* sysdeps/unix/sysv/linux/generic/bits/stat.h
* sysdeps/unix/sysv/linux/generic/bits/statfs.h
* sysdeps/unix/sysv/linux/sys/acct.h
* wctype/bits/wctype-wchar.h:
Include bits/endian.h, not endian.h.
* sysdeps/unix/sysv/linux/hppa/pthread.h: Don’t include endian.h.
* sysdeps/mips/ieee754/ieee754.h: Use __LDBL_MANT_DIG__
in ifdefs, instead of LDBL_MANT_DIG. Only include float.h
when __LDBL_MANT_DIG__ is not predefined, in which case
define __LDBL_MANT_DIG__ to equal LDBL_MANT_DIG.
2019-09-20 21:23:51 +00:00
|
|
|
#include <bits/endian.h>
|
2011-12-04 02:13:38 +00:00
|
|
|
#include <bits/wordsize.h>
|
|
|
|
|
|
|
|
#if defined __USE_FILE_OFFSET64
|
|
|
|
# define __field64(type, type64, name) type64 name
|
2019-08-13 20:18:06 +00:00
|
|
|
#elif __WORDSIZE == 64 || defined __INO_T_MATCHES_INO64_T
|
|
|
|
# if defined __INO_T_MATCHES_INO64_T && !defined __OFF_T_MATCHES_OFF64_T
|
|
|
|
# error "ino_t and off_t must both be the same type"
|
|
|
|
# endif
|
2011-12-04 02:13:38 +00:00
|
|
|
# define __field64(type, type64, name) type name
|
|
|
|
#elif __BYTE_ORDER == __LITTLE_ENDIAN
|
|
|
|
# define __field64(type, type64, name) \
|
2013-11-20 21:12:18 +00:00
|
|
|
type name __attribute__((__aligned__ (__alignof__ (type64)))); int __##name##_pad
|
2011-12-04 02:13:38 +00:00
|
|
|
#else
|
|
|
|
# define __field64(type, type64, name) \
|
2013-11-20 21:12:18 +00:00
|
|
|
int __##name##_pad __attribute__((__aligned__ (__alignof__ (type64)))); type name
|
2011-12-04 02:13:38 +00:00
|
|
|
#endif
|
|
|
|
|
|
|
|
struct stat
|
|
|
|
{
|
|
|
|
__dev_t st_dev; /* Device. */
|
|
|
|
__field64(__ino_t, __ino64_t, st_ino); /* File serial number. */
|
|
|
|
__mode_t st_mode; /* File mode. */
|
|
|
|
__nlink_t st_nlink; /* Link count. */
|
|
|
|
__uid_t st_uid; /* User ID of the file's owner. */
|
|
|
|
__gid_t st_gid; /* Group ID of the file's group.*/
|
|
|
|
__dev_t st_rdev; /* Device number, if device. */
|
|
|
|
__dev_t __pad1;
|
|
|
|
__field64(__off_t, __off64_t, st_size); /* Size of file, in bytes. */
|
|
|
|
__blksize_t st_blksize; /* Optimal block size for I/O. */
|
|
|
|
int __pad2;
|
|
|
|
__field64(__blkcnt_t, __blkcnt64_t, st_blocks); /* 512-byte blocks */
|
struct stat is not posix conform
On 21/05/15 05:29, Siddhesh Poyarekar wrote:
> On Wed, May 20, 2015 at 06:55:02PM +0100, Szabolcs Nagy wrote:
>> i guess it's ok for consistency if i fix struct stat64
>> too to use __USE_XOPEN2K8.
>>
>> i will run some tests and come back with a patch
>
> I also think it would be appropriate to change this code in other
> architectures (microblaze and nacl IIRC) to make all of them
> consistent. It is a mechanical enough change IMO that all arch
> maintainer acks is not necessary.
>
here is the patch with consistent __USE_XOPEN2K8
ok to commit?
2015-05-21 Szabolcs Nagy <szabolcs.nagy@arm.com>
[BZ #18234]
* conform/data/sys/stat.h-data (struct stat): Add tests for st_atim,
st_mtim and st_ctim members.
* sysdeps/nacl/bits/stat.h (struct stat, struct stat64): Make
st_atim, st_ctim, st_mtim visible under __USE_XOPEN2K8 only.
* sysdeps/unix/sysv/linux/generic/bits/stat.h (struct stat,):
(struct stat64): Likewise.
* sysdeps/unix/sysv/linux/ia64/bits/stat.h (struct stat,):
(struct stat64): Likewise.
* sysdeps/unix/sysv/linux/microblaze/bits/stat.h (struct stat,):
(struct stat64): Likewise.
2015-05-26 16:57:23 +00:00
|
|
|
#ifdef __USE_XOPEN2K8
|
2011-12-04 02:13:38 +00:00
|
|
|
/* Nanosecond resolution timestamps are stored in a format
|
|
|
|
equivalent to 'struct timespec'. This is the type used
|
|
|
|
whenever possible but the Unix namespace rules do not allow the
|
|
|
|
identifier 'timespec' to appear in the <sys/stat.h> header.
|
|
|
|
Therefore we have to handle the use of this header in strictly
|
|
|
|
standard-compliant sources special. */
|
|
|
|
struct timespec st_atim; /* Time of last access. */
|
|
|
|
struct timespec st_mtim; /* Time of last modification. */
|
|
|
|
struct timespec st_ctim; /* Time of last status change. */
|
|
|
|
# define st_atime st_atim.tv_sec /* Backward compatibility. */
|
|
|
|
# define st_mtime st_mtim.tv_sec
|
|
|
|
# define st_ctime st_ctim.tv_sec
|
|
|
|
#else
|
|
|
|
__time_t st_atime; /* Time of last access. */
|
|
|
|
unsigned long int st_atimensec; /* Nscecs of last access. */
|
|
|
|
__time_t st_mtime; /* Time of last modification. */
|
|
|
|
unsigned long int st_mtimensec; /* Nsecs of last modification. */
|
|
|
|
__time_t st_ctime; /* Time of last status change. */
|
|
|
|
unsigned long int st_ctimensec; /* Nsecs of last status change. */
|
|
|
|
#endif
|
2013-11-26 11:29:20 +00:00
|
|
|
int __glibc_reserved[2];
|
2011-12-04 02:13:38 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
#undef __field64
|
|
|
|
|
|
|
|
#ifdef __USE_LARGEFILE64
|
|
|
|
struct stat64
|
|
|
|
{
|
|
|
|
__dev_t st_dev; /* Device. */
|
|
|
|
__ino64_t st_ino; /* File serial number. */
|
|
|
|
__mode_t st_mode; /* File mode. */
|
|
|
|
__nlink_t st_nlink; /* Link count. */
|
|
|
|
__uid_t st_uid; /* User ID of the file's owner. */
|
|
|
|
__gid_t st_gid; /* Group ID of the file's group.*/
|
|
|
|
__dev_t st_rdev; /* Device number, if device. */
|
|
|
|
__dev_t __pad1;
|
|
|
|
__off64_t st_size; /* Size of file, in bytes. */
|
|
|
|
__blksize_t st_blksize; /* Optimal block size for I/O. */
|
|
|
|
int __pad2;
|
|
|
|
__blkcnt64_t st_blocks; /* Nr. 512-byte blocks allocated. */
|
struct stat is not posix conform
On 21/05/15 05:29, Siddhesh Poyarekar wrote:
> On Wed, May 20, 2015 at 06:55:02PM +0100, Szabolcs Nagy wrote:
>> i guess it's ok for consistency if i fix struct stat64
>> too to use __USE_XOPEN2K8.
>>
>> i will run some tests and come back with a patch
>
> I also think it would be appropriate to change this code in other
> architectures (microblaze and nacl IIRC) to make all of them
> consistent. It is a mechanical enough change IMO that all arch
> maintainer acks is not necessary.
>
here is the patch with consistent __USE_XOPEN2K8
ok to commit?
2015-05-21 Szabolcs Nagy <szabolcs.nagy@arm.com>
[BZ #18234]
* conform/data/sys/stat.h-data (struct stat): Add tests for st_atim,
st_mtim and st_ctim members.
* sysdeps/nacl/bits/stat.h (struct stat, struct stat64): Make
st_atim, st_ctim, st_mtim visible under __USE_XOPEN2K8 only.
* sysdeps/unix/sysv/linux/generic/bits/stat.h (struct stat,):
(struct stat64): Likewise.
* sysdeps/unix/sysv/linux/ia64/bits/stat.h (struct stat,):
(struct stat64): Likewise.
* sysdeps/unix/sysv/linux/microblaze/bits/stat.h (struct stat,):
(struct stat64): Likewise.
2015-05-26 16:57:23 +00:00
|
|
|
#ifdef __USE_XOPEN2K8
|
2011-12-04 02:13:38 +00:00
|
|
|
/* Nanosecond resolution timestamps are stored in a format
|
|
|
|
equivalent to 'struct timespec'. This is the type used
|
|
|
|
whenever possible but the Unix namespace rules do not allow the
|
|
|
|
identifier 'timespec' to appear in the <sys/stat.h> header.
|
|
|
|
Therefore we have to handle the use of this header in strictly
|
|
|
|
standard-compliant sources special. */
|
|
|
|
struct timespec st_atim; /* Time of last access. */
|
|
|
|
struct timespec st_mtim; /* Time of last modification. */
|
|
|
|
struct timespec st_ctim; /* Time of last status change. */
|
|
|
|
#else
|
|
|
|
__time_t st_atime; /* Time of last access. */
|
|
|
|
unsigned long int st_atimensec; /* Nscecs of last access. */
|
|
|
|
__time_t st_mtime; /* Time of last modification. */
|
|
|
|
unsigned long int st_mtimensec; /* Nsecs of last modification. */
|
|
|
|
__time_t st_ctime; /* Time of last status change. */
|
|
|
|
unsigned long int st_ctimensec; /* Nsecs of last status change. */
|
|
|
|
#endif
|
2013-11-26 11:29:20 +00:00
|
|
|
int __glibc_reserved[2];
|
2011-12-04 02:13:38 +00:00
|
|
|
};
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/* Tell code we have these members. */
|
|
|
|
#define _STATBUF_ST_BLKSIZE
|
|
|
|
#define _STATBUF_ST_RDEV
|
|
|
|
/* Nanosecond resolution time values are supported. */
|
|
|
|
#define _STATBUF_ST_NSEC
|
|
|
|
|
2020-07-17 12:18:39 +00:00
|
|
|
#endif /* _BITS_STRUCT_STAT_H */
|