0722a578ed
_exit.2, access.2, brk.2, chmod.2, clone.2, epoll_wait.2, eventfd.2, fork.2, getgroups.2, gethostname.2, getpid.2, getpriority.2, killpg.2, mmap.2, poll.2, posix_fadvise.2, pread.2, ptrace.2, readv.2, sched_setaffinity.2, select.2, seteuid.2, setgid.2, setresuid.2, setreuid.2, setuid.2, sigaction.2, signalfd.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, stat.2, timer_create.2, uname.2, wait.2, wait4.2, mq_notify.3, mq_open.3, sigqueue.3, man-pages.7: Remove "ABI" from "C library/kernel ABI differences" subheadings
...
The "ABI" doesn't really convey anything significant in
the title. These subsections are about describing differences
between the kernel and (g)libc interfaces.
Reported-by: Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-08 13:10:04 +02:00
70b53bc047
stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-05-06 17:58:39 +02:00
44b1f5a0c2
stat.2: Minor fixes
...
Reported-by: Andreas Grünbacher <andreas.gruenbacher@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 16:50:34 +02:00
bba094e3f9
stat.2: Remove excessive leading zeros on some constants
...
Reported-by: Andreas Grünbacher <andreas.gruenbacher@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 16:35:23 +02:00
addfd6c39c
stat.2: Wording tweaks to Jann Horn's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:56:15 +02:00
1dab8564e2
stat.2: Add text on POSIX terms "file mode bits" and "file permission bits"
...
Recent changes to various pages employ this distinction.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 15:42:40 +02:00
64639e9aa6
stat.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:44:20 +02:00
f240296dee
stat.2: Add note about stat() being racy
...
The same thing was fixed for execve() in kernel commit
8b01fc86b9f425899f8a3a8fc1c47d73c2c20543, but for performance
reasons, that simple patch won't work for stat().
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:40:39 +02:00
7901c9c3cd
stat.2: Tighten wording: use 'mode bit' rather than 'permission bit'
...
According to POSIX, the the 9 UGO*RWX bits are permissions, and
'mode' is used to refer to collectively to those bits plus sticky,
set-UID, and set_GID bits.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:27:41 +02:00
b0c5363f3e
stat.2: Improve description of some mode constants
...
Signed-off-by: Andreas Gruenbacher <agruenba@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:27:29 +02:00
cd358be37a
Removed trailing white space at end of lines
2015-04-19 11:21:53 +02:00
c73595c249
getent.1, fallocate.2, getrlimit.2, llseek.2, madvise.2, mount.2, poll.2, posix_fadvise.2, pread.2, stat.2, symlink.2, timer_create.2, timerfd_create.2, unshare.2, acos.3, acosh.3, asin.3, asinh.3, asprintf.3, atan.3, atan2.3, atanh.3, cabs.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cimag.3, clog.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, erf.3, erfc.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, frexp.3, ftw.3, get_nprocs_conf.3, getcwd.3, gethostbyname.3, getnetent.3, getutent.3, glob.3, ilogb.3, insque.3, j0.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lseek64.3, malloc.3, mbsnrtowcs.3, mbsrtowcs.3, modf.3, mq_notify.3, mq_open.3, nan.3, nextafter.3, openpty.3, perror.3, posix_memalign.3, pow.3, printf.3, qsort.3, realpath.3, remainder.3, remquo.3, rint.3, round.3, scalbln.3, scandir.3, scanf.3, setnetgrent.3, significand.3, sin.3, sinh.3, sqrt.3, strcasecmp.3, tan.3, tanh.3, tgamma.3, trunc.3, unlocked_stdio.3, updwtmp.3, wcrtomb.3, wcsnrtombs.3, wcsrtombs.3, wordexp.3, wprintf.3, y0.3, epoll.7, icmp.7, nptl.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-19 11:20:58 +02:00
9497142004
stat.2: Add some details on various "stat" versions
...
Three versions of "stat" appeared on 32-bit systems,
dealing with structures of different (increasing) sizes.
Explain some of the details, and also note that the
situation is simpler on modern 64-bit architectures.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:27 +02:00
a39f2f4dc8
stat.2: Add a little more detail on history of three versions of *stat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:26 +02:00
cad6df3299
stat.2: Add mention of newfstatat()
...
The underlying system call for fstatat() is newfstatat()
on some architectures.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-11 08:46:26 +02:00
409b02780a
stat.2: tfix
...
Signed-off-by: Stéphane Aulery <saulery@free.fr>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-03-22 19:25:22 +01:00
6d322d5fc7
time.1, access.2, arch_prctl.2, cacheflush.2, capget.2, clone.2, execve.2, fcntl.2, fork.2, getpid.2, getxattr.2, ioctl.2, ioctl_fat.2, killpg.2, listxattr.2, madvise.2, migrate_pages.2, modify_ldt.2, mprotect.2, msgget.2, msgop.2, perf_event_open.2, ptrace.2, sched_setattr.2, semget.2, semop.2, sendfile.2, set_thread_area.2, setxattr.2, stat.2, statfs.2, wait.2, wait4.2, encrypt.3, mktemp.3, pthread_attr_setschedparam.3, resolver.3, statvfs.3, syslog.3, tzset.3, core.5, host.conf.5, intro.5, proc.5, resolv.conf.5, pthreads.7, socket.7, unix.7, ld.so.8, ldconfig.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 09:26:52 +01:00
1fbe05e023
stat.2: NOTES: add "C library/kernel ABI differences" subheading
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-02-21 08:32:13 +01:00
9af134cdeb
getrlimit.2, mmap.2, stat.2, unimplemented.2, dbopen.3, ecvt_r.3, fopen.3, fts.3, getcontext.3, qecvt.3, ip.7, ld.so.8: grfix: Add Oxford comma
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-09-01 17:57:07 +02:00
8980a50087
access.2, bdflush.2, bind.2, brk.2, chmod.2, chown.2, clone.2, epoll_wait.2, execve.2, fsync.2, getgroups.2, gethostname.2, getpagesize.2, getpriority.2, getrlimit.2, ioperm.2, kexec_load.2, link.2, mkdir.2, mmap.2, msgop.2, perf_event_open.2, process_vm_readv.2, ptrace.2, readlink.2, readv.2, recv.2, rename.2, sched_setaffinity.2, select.2, send.2, seteuid.2, signal.2, sigwaitinfo.2, stat.2, symlink.2, sync.2, sync_file_range.2, sysinfo.2, timer_create.2, uname.2, unlink.2, utime.2, wait.2, abs.3, atoi.3, catopen.3, cerf.3, cexp2.3, clearenv.3, clog2.3, ctime.3, des_crypt.3, ecvt.3, fgetgrent.3, flockfile.3, fseeko.3, ftime.3, ftok.3, ftw.3, getauxval.3, getcwd.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, getline.3, getpass.3, getutent.3, glob.3, insque.3, lseek64.3, memmem.3, mkstemp.3, mktemp.3, on_exit.3, openpty.3, putenv.3, qecvt.3, realpath.3, remove.3, setbuf.3, sigpause.3, strftime.3, strptime.3, strstr.3, strtod.3, tzset.3, updwtmp.3, xcrypt.3, core.5, utmp.5, capabilities.7, charsets.7, environ.7, ipv6.7, man-pages.7, packet.7, vdso.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-08-19 11:55:41 -05:00
cc2b44ebed
stat.2: nfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-22 07:17:07 +02:00
726663fd9d
bind.2, connect.2, create_module.2, delete_module.2, execve.2, get_robust_list.2, getpriority.2, getrusage.2, init_module.2, link.2, listen.2, mbind.2, open.2, poll.2, query_module.2, readlink.2, recv.2, remap_file_pages.2, sched_setaffinity.2, semop.2, send.2, stat.2, stime.2, syscall.2, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, remquo.3, rtime.3, sched_getcpu.3, stpcpy.3, stpncpy.3, strcasecmp.3, system.3, fd.4, proc.5, ip.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:31:12 +02:00
3779bbef74
stat.2: Describe feature test macro requirements for file type test macros
...
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728240
Reported-by: Aurelien Jarno <aurelien@aurel32.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
ff3976ceef
stat.2: Move text on S_I*() macros to follow text on S_I* macros
...
That ordering is more logical
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:55 +02:00
5c3122b1b3
stat.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:54 +02:00
c2033cfe6c
stat.2: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:54 +02:00
afb9bd5d77
stat.2: Update FTM requirements for lstat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:54 +02:00
ff0afc3fca
stat.2: Split discussion of 'st_mode' fields into type and permissions
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:54 +02:00
51c6aa6e63
stat.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:54 +02:00
b4112efb58
execve.2, getuid.2, stat.2, termios.3, ttyslot.3, glob.7: ffix: UNIX V6 or V7: use nonbreaking space
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-07 10:10:28 +02:00
a03c016c7d
isalpha.3, stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 21:15:37 +02:00
5201bb40a7
stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-03 13:41:19 +02:00
a211773aea
stat.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 16:55:46 +01:00
a6fcbdf87b
stat.2: Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 16:52:09 +01:00
d41c1140ea
stat.2: SEE ALSO: add ls(1) and stat(1)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-18 12:37:18 +01:00
496bdb5642
stat.2: Warn the reader that the 'stat' structure definition is not precise
...
Padding fields aren't shown, and the order of fields varies
somewhat across architectures.
Reported-by: Marius Gaubas <marius@livejournalinc.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
1fef0fa346
stat.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
e096bd701a
stat.2: Minor rewording: eliminate clumsy use of "stat" as a verb
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
cadd38ba1b
access.2, chmod.2, chown.2, link.2, mkdir.2, open.2, readlink.2, rename.2, stat.2, symlink.2, unlink.2, mkfifo.3, scandir.3: Minor fix: remove section numbers in references to functions inside page
...
With the page merges, we now have some references to functions
within the page that have section numbers. Remove those.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:52:53 +01:00
66cbeaf41b
stat.2: Use argument name 'pathname' throughout page
...
(Some APIs were using 'path' while others used 'pathname')
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:41:04 +01:00
9f3c96d3e6
stat.2: Remove sentence that fstatat() is present on Solaris
...
That point was only really relevant before fstatat() was
standardized in POSIX.1.2008.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:41:04 +01:00
282daba969
stat.2: CONFORMING TO: stat(), fstat(), lstat() are specified in POSIX.1-2008
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:41:04 +01:00
071d1c4f14
stat.2: Post-merge reworking of text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:41:04 +01:00
40084043d5
stat.2: Merge text from fstatat(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-02-21 12:41:04 +01:00
f78ed33a65
madvise.2, perf_event_open.2, query_module.2, stat.2, sem_init.3, hpsa.4, rtc.4, st.4, elf.5, filesystems.5, proc.5, environ.7, man-pages.7, regex.7, units.7: Reword to avoid use of "etc."
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-01-18 23:58:39 +13:00
b8efc3ed61
Removed trailing white space at end of lines
2013-12-12 20:42:43 +13:00
827edbd201
stat.2: wspfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
1ef5b28054
stat.2: Cosmetic reworking of timestamp discussion in NOTES
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-10-25 15:42:26 +13:00
96f92a7cb6
stat.2: Not filesystem support for nanosecond timestamps
...
Add some detail on which native filesystems do and don't
support nanosecond timestamps.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-10-25 15:39:02 +13:00
e9e9e87ecf
stat.2: Update discussion of nanosecond timestamps
...
The existing text describes the timestamp fields as 'time_t'
and delegates discussion of nanosecond timestamps under NOTES.
Nanosecond timestamps have been around for a while now,
and are in POSIX.1-2008, so reverse the orientation of the
discussion, putting the nanosecond fields into DESCRIPTION
and detailing the historical situation under NOTES.
Reported-by: Yang Yang <yangyang.gnu@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-10-25 15:39:02 +13:00
Michael Kerrisk