c634028ab5
intro.1, time.1, _syscall.2, accept.2, brk.2, capget.2, faccessat.2, futimesat.2, gethostname.2, intro.2, ioprio_set.2, kill.2, madvise.2, mlock.2, mount.2, msgget.2, perf_event_open.2, poll.2, readv.2, sched_rr_get_interval.2, sched_setscheduler.2, select.2, select_tut.2, shmget.2, stat.2, timer_create.2, ustat.2, vfork.2, wait.2, alloca.3, atexit.3, catopen.3, crypt.3, dbopen.3, fenv.3, fopen.3, getaddrinfo_a.3, gethostbyname.3, getutent.3, intro.3, login.3, mallopt.3, queue.3, regex.3, sigpause.3, sigsetops.3, stdio.3, strftime.3, strptime.3, sysconf.3, ttyslot.3, undocumented.3, cciss.4, console_codes.4, hpsa.4, initrd.4, intro.4, rtc.4, st.4, tty_ioctl.4, wavelan.4, acct.5, charmap.5, dir_colors.5, hosts.5, intro.5, termcap.5, utmp.5, intro.6, armscii-8.7, boot.7, bootparam.7, capabilities.7, cpuset.7, credentials.7, ddp.7, epoll.7, glob.7, intro.7, ip.7, ipv6.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, man-pages.7, man.7, math_error.7, netlink.7, numa.7, packet.7, path_resolution.7, pipe.7, pthreads.7, raw.7, rtnetlink.7, signal.7, socket.7, spufs.7, svipc.7, tcp.7, time.7, udp.7, udplite.7, unicode.7, unix.7, uri.7, utf-8.7, x25.7, intro.8: Global fix: use consistent capitalization in .SS headings
...
Capitalization in .SS sections across pages (and sometimes even
within a single page) is wildly inconsistent. Make it consistent.
Capitalize first word in heading, but otherwise use lower case,
except where English usage (e.g., proper nouns) or programming
language requirements (e.g., identifier names) dictate otherwise.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2013-02-24 15:08:38 +01:00
fec75159e1
stat.2: Clarify description of EOVERFLOW error
...
The EOVERFLOW error is not only for st_size, but also
inode and block size fields. See glibc source file
sysdeps/unix/sysv/linux/xstatconv.c and kernel source
file fs/stat.c. Also, fix bit/byte confusion
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604928
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-11 11:40:23 +01:00
7fac88a949
eventfd.2, futex.2, mmap2.2, open.2, pciconfig_read.2, ptrace.2, reboot.2, request_key.2, sched_rr_get_interval.2, splice.2, stat.2, sync_file_range.2, syscalls.2, timer_create.2, vm86.2, pthread_attr_setscope.3, core.5, proc.5, aio.7, futex.7, netlink.7, time.7: Global fix: "userspace" ==> "user space" or "user-space"
...
Existing pages variously use "userspace or "user space".
But, "userspace" is not quite an English word.
So change "userspace" to "user space" or, when used
attributively, "user-space".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:33 +02:00
318c814291
stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:36 +02:00
77b9991851
stat.2: Formatting fixes
...
From "groff -ww" (or "man --warnings=w ..."):
warning: around line 442: table wider than line width
GNU man uses line length of 78.
Use text blocks. Two spaces between sentences or better: start
each sentence in a new line.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:18 +12:00
41acdb62c9
Changes, setns.2, stat.2, proc.5, capabilities.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-04 08:32:21 +02:00
5503c85ea4
intro.1, fork.2, futex.2, open.2, rename.2, select_tut.2, semop.2, spu_create.2, stat.2, netlink.3, random.3, scanf.3, shm_open.3, strftime.3, console.4, console_codes.4, sk98lin.4, st.4, bootparam.7, cpuset.7, credentials.7, man-pages.7, path_resolution.7, uri.7: Global fix: remove spaces around em-dash
...
Normal English typographical convention is not to have
spaces around em dashes.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-03 08:47:35 +02:00
295bb82e56
stat.2: Regarding automounter action, add a reference to fstatat(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-01 07:16:10 +02:00
d3e8b1410a
stat.2: Note POSIX.1-2001 and POSIX.1-2008 requirements for lstat()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-01 07:16:10 +02:00
beb0ebc887
stat.2: Clean up text describing which POSIX descibes S_IF* constants
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-10-01 07:16:10 +02:00
280ff2097b
stat.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-28 06:27:15 +02:00
c066b1699c
stat.2: Small rewording of ENAMETOOLONG error
...
Reported-by: Jon Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2011-09-16 07:00:47 +02:00
f8697edd6d
getrlimit.2, sendfile.2, stat.2: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:43:09 +01:00
4d69ed2e0d
stat.2: Fix EOVERFLOW error description
...
2<<31 should read 1<<31 (which equals 2^31).
Reported-by: Emil Mikulic <emikulic@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-12-03 07:42:05 +01:00
008f1ecc43
intro.1, time.1, accept.2, bind.2, connect.2, execve.2, flock.2, getdents.2, getpriority.2, getuid.2, intro.2, ioctl.2, mincore.2, mknod.2, personality.2, ptrace.2, read.2, recv.2, select_tut.2, send.2, sendfile.2, shmctl.2, sigaction.2, signal.2, stat.2, times.2, truncate.2, umask.2, wait.2, MB_CUR_MAX.3, MB_LEN_MAX.3, argz_add.3, btowc.3, clearenv.3, clock.3, cmsg.3, end.3, endian.3, errno.3, exit.3, fgetwc.3, fgetws.3, fopen.3, fputwc.3, fputws.3, fseek.3, fwide.3, getfsent.3, getgrnam.3, gethostid.3, getipnodebyname.3, getmntent.3, getpwnam.3, getwchar.3, grantpt.3, iconv.3, iconv_close.3, iconv_open.3, insque.3, intro.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mkstemp.3, mktemp.3, nl_langinfo.3, openpty.3, posix_openpt.3, printf.3, ptsname.3, putwchar.3, qecvt.3, rcmd.3, readdir.3, rexec.3, rpc.3, setnetgrent.3, shm_open.3, sigpause.3, stdin.3, stpcpy.3, strftime.3, strptime.3, syslog.3, towctrans.3, towlower.3, towupper.3, ttyslot.3, ungetwc.3, unlocked_stdio.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wprintf.3, console_ioctl.4, pts.4, elf.5, filesystems.5, hosts.5, proc.5, ttytype.5, boot.7, capabilities.7, credentials.7, epoll.7, glob.7, koi8-r.7, path_resolution.7, pty.7, signal.7, suffixes.7, time.7, unicode.7, unix.7, uri.7, utf-8.7: global fix: s/Unix/UNIX/
...
The man pages were rather inconsistent in the use of "Unix"
versus "UNIX". Let's go with the trademark usage.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-10-12 06:49:17 +02:00
34c909ac11
stat.2: Note feature test macro requirements for blkcnt_t and blksize_t
...
Reported-by: Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 17:36:41 +02:00
3ba63d802e
chdir.2, chmod.2, chown.2, gethostname.2, getsid.2, pread.2, setpgid.2, sigaltstack.2, stat.2, truncate.2, wait.2, dirfd.3, getsubopt.3, mkdtemp.3, mkstemp.3, siginterrupt.3, strdup.3: Simplify feature test macro requirements
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-26 17:16:57 +02:00
50831f9b8a
_exit.2, brk.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, getdtablesize.2, gethostname.2, getpagesize.2, getsid.2, killpg.2, mknod.2, mknodat.2, poll.2, posix_fadvise.2, pread.2, readlink.2, setpgid.2, setreuid.2, sigaltstack.2, stat.2, symlink.2, sync.2, truncate.2, vfork.2, wait.2, wait4.2, a64l.3, abs.3, acos.3, acosh.3, asin.3, asinh.3, atan.3, atan2.3, atoi.3, cbrt.3, ceil.3, copysign.3, cosh.3, dirfd.3, div.3, ecvt.3, erf.3, erfc.3, exp.3, exp2.3, fabs.3, fdim.3, ffs.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fpclassify.3, frexp.3, ftw.3, fwide.3, gcvt.3, getcwd.3, getdate.3, getgrent.3, gethostid.3, getpass.3, getpwent.3, getsubopt.3, getw.3, hypot.3, ilogb.3, index.3, isalpha.3, isgreater.3, iswblank.3, j0.3, ldexp.3, lockf.3, log.3, log10.3, log1p.3, logb.3, lrint.3, lround.3, mkstemp.3, mktemp.3, modf.3, mq_receive.3, mq_send.3, nan.3, nextafter.3, posix_fallocate.3, posix_memalign.3, printf.3, qecvt.3, random.3, realpath.3, remainder.3, remquo.3, rint.3, round.3, scalb.3, scalbln.3, scanf.3, siginterrupt.3, signbit.3, sigset.3, sinh.3, sqrt.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strfry.3, strpbrk.3, strsep.3, strspn.3, strstr.3, strtod.3, strtok.3, strtol.3, strtoul.3, strxfrm.3, tanh.3, tgamma.3, trunc.3, ttyslot.3, ualarm.3, usleep.3, wprintf.3, armscii-8.7, cp1251.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-3.7, iso_8859-5.7, iso_8859-6.7, iso_8859-8.7, koi8-u.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:09 +02:00
43e0fe7d64
stat.2: Update lstat() feature test macro requirements
...
Add requirements for glibc 2.10.
Correct requirements for glibc versions before 2.10.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:03 +02:00
f593575224
stat.2: Update information on nanosecond timestamp fields
...
Update feature test macro requirements for exposing these fields.
Note that these fields are specified in POSIX.1-2008.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-09-22 16:59:02 +02:00
310672d6b1
ioctl_list.2, mount.2, select_tut.2, stat.2, getifaddrs.3, pthread_cleanup_push_defer_np.3, pthread_getcpuclockid.3, proc.5, bootparam.7: Global fix: s/sub-/sub/
...
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "sub-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:36:10 +01:00
24b74457e7
accept.2, access.2, acct.2, clock_nanosleep.2, mbind.2, mincore.2, remap_file_pages.2, sched_setscheduler.2, set_mempolicy.2, splice.2, stat.2, syslog.2, timer_create.2, timerfd_create.2, truncate.2, fenv.3, ferror.3, fflush.3, fgetwc.3, fgetws.3, flockfile.3, fputwc.3, fputws.3, fread.3, getopt.3, gets.3, getwchar.3, glob.3, iconv.3, longjmp.3, pow.3, printf.3, puts.3, putwchar.3, regex.3, rpc.3, scanf.3, setjmp.3, termios.3, unlocked_stdio.3, wcswidth.3, hd.4, rtc.4, st.4, core.5, dir_colors.5, elf.5, proc.5, arp.7, ascii.7, boot.7, bootparam.7, charsets.7, futex.7, ip.7, iso_8859-11.7, man-pages.7, man.7, mdoc.samples.7, path_resolution.7, pipe.7, posixoptions.7, unicode.7, unix.7, uri.7, utf-8.7, ld.so.8: s/non-/non/
...
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 18:20:12 +01:00
2843ba93d4
stat.2, posix_fallocate.3, proc.5, tcp.7, udp.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-30 03:28:34 +02:00
bdfd22665a
stat.2: Fix small bug in example program
...
Since it is a failure, EXIT_FAILURE looks more appropriate
than EXIT_SUCCESS.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:29 +02:00
ec28c6b988
stat.2: Minor fixes
...
Fix to formatting issues:
* remove ending tabulation
* add missing parenthesis
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:25 +02:00
94ea1e9d16
stat.2: Improve wording of ENOTDIR error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-21 14:57:42 +12:00
5cf0b3b40e
stat.2: wfix
...
Reported-by: Tolga Dalman <tdalman@project-psi.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-04-21 14:53:07 +12:00
14adeb6d28
stat.2: Note that open(O_NOATIME) also cause st_atime not to be updated
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-22 20:53:44 +01:00
5e4dc2691b
open.2, stat.2: tfix s/_FILE_OFF_SET_BITS/_FILE_OFFSET_BITS/
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Chris Heath <chris@heathens.co.nz>
2008-12-05 22:47:18 -05:00
9dcc46058a
stat.2: Document EOVERFLOW error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Andre Majorel <aym-xunil@teaser.fr>
2008-12-05 22:47:18 -05:00
e9ef777f73
stat.2: Refer reader to major() and minor() to decompose a device ID
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:54 -05:00
44c95a090f
stat.2, tsearch.3, tzset.3: wfix: s/SysV/System V/
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-10-29 14:54:12 -05:00
82d2be3d9d
> > Additionally, you may want to make a note in the stat/lstat man page that on
...
> > Linux, lstat(2) will generally not trigger automounter action, whereas
> > stat(2) will.
>
> I don't understand this last piece. Can you say some more. (I'm not
> familiar with automounter details.)
An automounter (either an explicit one, like autofs, or an implicit
one, such as are used by AFS or NFSv4) is something that triggers
a mount when something is touched.
However, it's undesirable to automount, say, everyone's home
directory just because someone opened up /home in their GUI
browser or typed "ls -l /home". The early automounters simply
didn't list the contents until you accessed it by name;
this is still the case when you can't enumerate a mapping
(say, all DNS names under /net). However, this is extremely
inconvenient, too.
The solution we ended up settling on is to create something
that looks like a directory (i.e. reports S_IFDIR in stat()),
but behaves somewhat like a symlink. In particular, when it is
accessed in a way where a symlink would be dereferenced,
the automount triggers and the directory is mounted. However,
system calls which do *not* cause a symlink to be dereferenced,
like lstat(), also do not cause the automounter to trigger.
This means that "ls -l", or a GUI file browser, can see a list
of directories without causing each one of them to be automounted.
-hpa
2008-09-10 10:40:01 +00:00
86d89e4c89
Add more detail in mount options that prevent updates to atime.
2008-09-09 05:25:25 +00:00
614aae4105
Add "512B" to comment for st_blocks
2008-09-09 05:12:17 +00:00
ad22ad5568
ffix
2008-06-11 22:19:03 +00:00
a9cfde1dbc
SEE ALSO: add symlink.7
2008-06-11 21:50:53 +00:00
24d01c530c
s/filesystem/file system/
2008-03-19 07:26:08 +00:00
647d1abbdb
Added some .\" comments, and a FIXME.
2008-03-18 14:25:00 +00:00
6982cdd87c
Minor wording change
2008-03-18 14:11:57 +00:00
d1b4e37d41
ffix
2007-12-23 22:24:54 +00:00
d3b03141a9
s/filedes/fd/
2007-12-23 21:56:27 +00:00
bd19142309
enclose code smaples/structure defns/etc in ".in +4n / .in"
2007-12-19 06:16:04 +00:00
a08ea57c20
Make the standard indent for code samples, shell session
...
logs, etc. to be ".in +4n".
2007-12-19 05:53:30 +00:00
2d986c928c
Replace `...' with alternate formatting (e.g., ".." or .I)
2007-12-18 07:47:22 +00:00
6b6da70802
ffix
2007-12-07 19:30:58 +00:00
2777b1caec
Remove section numbers for page references where the
...
reference refers to the page itself. (This stops man2html
producing links from a page back to itself.)
2007-11-24 10:10:39 +00:00
0daa9e92d0
Fix redundant formatting macros
2007-09-20 16:26:31 +00:00
c11b1abf2e
Change mtk's email address
2007-09-20 06:52:22 +00:00
6f1a1e6143
Minor improvements in text describing underlying system calls.
2007-07-10 20:57:30 +00:00
Michael Kerrisk