Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
64639e9aa6
stat.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-04-21 14:44:20 +02:00
Jann Horn
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
Michael Kerrisk
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
Andreas Gruenbacher
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
Michael Kerrisk
cd358be37a
Removed trailing white space at end of lines
2015-04-19 11:21:53 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Stéphane Aulery
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
David Prévot
cc2b44ebed
stat.2: nfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-22 07:17:07 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
5c3122b1b3
stat.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:54 +02:00
Michael Kerrisk
c2033cfe6c
stat.2: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:54 +02:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
51c6aa6e63
stat.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-05-08 11:26:54 +02:00
Simon Paillard
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
Simon Paillard
a03c016c7d
isalpha.3, stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-10 21:15:37 +02:00
David Prévot
5201bb40a7
stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-04-03 13:41:19 +02:00
Michael Kerrisk
a211773aea
stat.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-19 16:55:46 +01:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
1fef0fa346
stat.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-03-10 15:03:56 +01:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
b8efc3ed61
Removed trailing white space at end of lines
2013-12-12 20:42:43 +13:00
Michael Kerrisk
827edbd201
stat.2: wspfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-12-12 16:16:08 +13:00
Michael Kerrisk
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
Michael Kerrisk
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
Michael Kerrisk
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
9ee4a2b6ec
intro.1, time.1, access.2, acct.2, alloc_hugepages.2, bind.2, chdir.2, chmod.2, chown.2, chroot.2, clone.2, close.2, execve.2, fallocate.2, fcntl.2, getdents.2, getrusage.2, getxattr.2, init_module.2, inotify_add_watch.2, ioprio_set.2, kcmp.2, link.2, listxattr.2, lseek.2, madvise.2, mkdir.2, mknod.2, mmap.2, mount.2, move_pages.2, msgctl.2, nfsservctl.2, open.2, pivot_root.2, quotactl.2, read.2, readlink.2, removexattr.2, rename.2, rmdir.2, semctl.2, setfsgid.2, setfsuid.2, setresuid.2, setuid.2, setup.2, setxattr.2, shmctl.2, splice.2, spu_create.2, stat.2, statfs.2, swapon.2, symlink.2, sync.2, sync_file_range.2, sysfs.2, truncate.2, umount.2, unlink.2, unshare.2, ustat.2, utime.2, utimensat.2, write.2, btree.3, errno.3, fexecve.3, ftw.3, futimes.3, get_nprocs_conf.3, getcwd.3, getdirentries.3, getmntent.3, glob.3, mkfifo.3, mq_open.3, readdir.3, realpath.3, recno.3, remove.3, sem_open.3, shm_open.3, statvfs.3, sysconf.3, telldir.3, tmpfile.3, cciss.4, initrd.4, pts.4, sk98lin.4, vcs.4, core.5, filesystems.5, proc.5, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, feature_test_macros.7, fifo.7, hier.7, inotify.7, intro.7, mq_overview.7, path_resolution.7, pipe.7, sem_overview.7, shm_overview.7, spufs.7, symlink.7, unix.7, uri.7, sync.8: Global fix: s/file system/filesystem/
...
Notwithstanding 24d01c530c
,
"filesystem" is the form used by the great majority of man pages
outside the man-pages project and in a number of other sources,
so let's go with that.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-08-08 10:07:57 +02:00
Michael Kerrisk
0d24f47f29
stat.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-03-25 12:12:27 +01:00