CVS log for src/lib/libc/sys/stat.2

Up to [cvs.NetBSD.org] / src / lib / libc / sys

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

Pull up following revision(s) (requested by rin in ticket #755):

	lib/libc/sys/stat.2: revision 1.60

document S_ISWHT, sort these macros

document S_ISWHT, sort these macros

Mostly merge changes from HEAD upto 20200411

Pull up following revision(s) (requested by sevan in ticket #174):
	lib/libc/sys/chmod.2: revision 1.48
	lib/libc/sys/stat.2: revision 1.59
	lib/libc/sys/unlink.2: revision 1.30
	lib/libc/sys/lseek.2: revision 1.25
	lib/libc/sys/getuid.2: revision 1.18
	lib/libc/sys/chown.2: revision 1.37
	lib/libm/man/exp.3: revision 1.32
	lib/libm/man/log.3: revision 1.7
	lib/libc/sys/open.2: revision 1.60
	lib/libc/stdio/fopen.3: revision 1.36
	lib/libc/stdio/putc.3: revision 1.14
	lib/libc/sys/mount.2: revision 1.51
	share/man/man9/copy.9: revision 1.22
	share/man/man9/uiomove.9: revision 1.20
	lib/libc/sys/setuid.2: revision 1.23
	lib/libc/sys/close.2: revision 1.18
	sbin/init/init.8: revision 1.61
	lib/libc/sys/write.2: revision 1.36
	lib/libc/sys/read.2: revision 1.39
	sbin/init/init.8: revision 1.62
	lib/libc/sys/wait.2: revision 1.40
	usr.bin/tty/tty.1: revision 1.10
	lib/libc/sys/link.2: revision 1.33
	usr.bin/du/du.1: revision 1.24
	lib/libc/stdlib/exit.3: revision 1.17
	usr.bin/su/su.1: revision 1.53
	usr.bin/mail/mail.1: revision 1.66
	lib/libc/sys/fork.2: revision 1.25
	usr.bin/su/su.1: revision 1.54
	usr.bin/mail/mail.1: revision 1.67
	lib/libm/man/sin.3: revision 1.15
	share/man/man9/intro.9: revision 1.26
	share/man/man5/utmp.5: revision 1.17
	lib/libc/compat-43/creat.3: revision 1.17
	lib/libc/time/ctime.3: revision 1.61
	lib/libcompat/4.1/stty.3: revision 1.10
	usr.bin/dc/dc.1: revision 1.3
	lib/libm/man/cos.3: revision 1.17
	lib/libc/sys/chdir.2: revision 1.23
	lib/libc/gen/exec.3: revision 1.30
	lib/libc/gen/exec.3: revision 1.31
	games/bcd/bcd.6: revision 1.18
	games/bcd/bcd.6: revision 1.19
	usr.bin/write/write.1: revision 1.7
	usr.bin/wc/wc.1: revision 1.18
	usr.bin/pr/pr.1: revision 1.24
	usr.bin/who/who.1: revision 1.25
	lib/libc/sys/mkdir.2: revision 1.30
	lib/libc/stdio/getc.3: revision 1.13
	usr.bin/sort/sort.1: revision 1.40
	usr.bin/mesg/mesg.1: revision 1.11
	share/man/man5/passwd.5: revision 1.34
sort was there since v1
https://www.bell-labs.com/usr/dmr/www/man61.pdf

dc was in v1
https://www.bell-labs.com/usr/dmr/www/man12.pdf

du was in v1
https://www.bell-labs.com/usr/dmr/www/man12.pdf

mail was in v1
https://www.bell-labs.com/usr/dmr/www/man12.pdf

mesg was in v1
https://www.bell-labs.com/usr/dmr/www/man12.pdf

Document history
https://www.bell-labs.com/usr/dmr/www/man13.pdf

su was in v1
https://www.bell-labs.com/usr/dmr/www/man13.pdf

Document history
https://www.bell-labs.com/usr/dmr/www/man13.pdf

Document history
https://www.bell-labs.com/usr/dmr/www/man14.pdf
Update URL

write was in v1
https://www.bell-labs.com/usr/dmr/www/man14.pdf
grammar

passwd(5) was in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf

utmp(5) was present in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf

Earliest version of wtmp I could find was in v3
https://minnie.tuhs.org/cgi-bin/utree.pl?file=V3/man/man5/wtmp.5

Document history of chdir(2)
https://www.bell-labs.com/usr/dmr/www/man21.pdf

Document history of chmod(2)
https://www.bell-labs.com/usr/dmr/www/man21.pdf

Document history of chown(2)
https://www.bell-labs.com/usr/dmr/www/man21.pdf

Document history
https://www.bell-labs.com/usr/dmr/www/man21.pdf

create was present in v1
https://www.bell-labs.com/usr/dmr/www/man21.pdf

Document history of exec()
Move statement on execlpe() & execvpe() to HISTORY section.

Document history
https://www.bell-labs.com/usr/dmr/www/man21.pdf

fork was present in v1
https://www.bell-labs.com/usr/dmr/www/man21.pdf
stat() was present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

document history of fstat()
https://www.bell-labs.com/usr/dmr/www/man21.pdf

getuid was present in v1
https://www.bell-labs.com/usr/dmr/www/man21.pdf

Document history
https://www.bell-labs.com/usr/dmr/www/man21.pdf

Document history
https://www.bell-labs.com/usr/dmr/www/man21.pdf

stty & gtty were around since v1
https://www.bell-labs.com/usr/dmr/www/man21.pdf
https://www.bell-labs.com/usr/dmr/www/man22.pdf

mount & umount were present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

Open was present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

read was present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

seek was present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

setuid was in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

unlink was presen in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

wait was present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

write was present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf

start documenting history
exp was present in v1
https://www.bell-labs.com/usr/dmr/www/man31.pdf

Start documenting history
https://www.bell-labs.com/usr/dmr/www/man31.pdf

Start documenting history
https://www.bell-labs.com/usr/dmr/www/man31.pdf

log appeared in v1
https://www.bell-labs.com/usr/dmr/www/man31.pdf

putc & putw were in v1
https://www.bell-labs.com/usr/dmr/www/man31.pdf

putchar was in v4
https://minie.tuhs.org/cgi-bin/utree.pl?file=V4/man/man3/putchr.3

Start documenting history
https://www.bell-labs.com/usr/dmr/www/man31.pdf

Document history.
https://www.bell-labs.com/usr/dmr/www/man11.pdf
Between v1 & v6 UNIX, bcd was rewritten in C, but I don't know if which
version,
hence I've skipped mentioning it.
End sentence with a dot.
Remove superfluous Pp.
Remove superfluous Pp.
Remove superfluous Ns.
Remove superfluous Pp.
fetch(9) -> ufetch(9)
fetch(9) -> ufetch(9). Remove superfluous Pp.
fetch(9) -> ufetch(9). Remove reference to unimplemented ppi(9).

stat() was present in v1
https://www.bell-labs.com/usr/dmr/www/man22.pdf
document history of fstat()
https://www.bell-labs.com/usr/dmr/www/man21.pdf

Sync with HEAD

Sync with HEAD

Remove comma after the last Nm entry.

Rebase to HEAD as of a few days ago.

Rebase.

sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs.  ("Protocol error: too many arguments")

Mention the word 'inode' next to st_ino so it's easier to find.
Bump date.

Adjust needed includes for fchmodat/mkdirat/mkfifoat/mknodat/fstatat
syscalls.

Add fstatat(2) specific errors.

resync with head

sync with head

sync with (a bit old) head

Revert defective O_SEARCH implementation committed by manu@ along with
the *at system calls on November 18th of last year. Reasons to revert
it include:
   - it is incorrect in a whole variety of ways (but fortunately, one
     of them is that the missing and improper permission checks have
     no net effect);
   - it was committed without review or discussion;
   - core ruled that all the new O_* flags pertaining to the *at calls
     needed to wait until their semantics could be clarified.

manu was asked to revert it on these grounds but has ignored the request.

I have left O_SEARCH defined and visible and made open() explicitly
ignore it. This way, most code that tries to use it will continue to
build and run. I've also arranged lib/libc/c063/t_o_search.c so that
the tests that make use of the O_SEARCH semantics will disappear until
O_SEARCH comes back, and fixed some mistakes and/or incorrect hacks
that were causing some of these to succeed despite the broken O_SEARCH
implementation.

Bump date. New sentence, new line. Wording/articles.
Sort errors while here.

Remove trailing whitespace.

Resync to 2012-11-19 00:00:00 UTC

Add most system calls for POSIX extended API set, part 2, with test cases:
faccessat(2), fchmodat(2), fchownat(2), fstatat(2), mkdirat(2), mkfifoat(2),
mknodat(2), linkat(2), readlinkat(2), symlinkat(2), renameat(2), unlinkat(2),
utimensat(2), openat(2).

Also implement O_SEARCH for openat(2)

Still missing:
- some flags for openat(2)
- fexecve(2) implementation

sync with head

Fix a sentence, following a hint by Abhinav Upadhyay.

There's no st_block field; it's st_blocks.

Sync with HEAD

v-node -> vnode
(for consistency)

No file system I know of reports directory sizes that are multiples of
sizeof(struct dirent) except by accident. So, sync with reality. Brought
to my attention by Taylor R Campbell in chat.

Fix .Xr; dirent(5) -> dirent(3).

Consistently use `.Brq Dv XXX' across syscalls man pages, for NAME_MAX
and PATH_MAX.

Split "file system" and fix a typo.

Note that all stat-functions are standardized nowadays.

Try to describe the struct stat instead of copy-pasting it from the header.
Use xrefs to avoid duplication of effort. Note the S_IS*() macros.

Mention the history of stat(2) and fix the history of open(2).

Use .In for header files instead of .Ar Pa and variations.

Fix typo.

Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html

Sort errors. Avoid marking up punctuation.

Fix markup

Note ZFS returning the number of entries instead of the size of the directory.

u_intN_t -> uintN_t

- Correct the fields in the stat structure. From PR/18255.
- Document the st_birthtime field.

Reviewed by wiz.

\- is a minus, not -.

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22280, verified by myself.

Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.

Merge the nathanw_sa branch.

Catch up to -current.

New sentence, new line. From Robert Elz.

Catch up to -current.

stat(2) can return ENXIO.

Catch up to -current.

Remove <sys/types.h> from synopsis, as per latest SUS/Posix specs.

Catch up to -current.

Catch up to -current.

Generate <>& symbolically. I'm avoiding .../dist/... directories for now.

Add a reference to dir(5) per PR 14291

Catch up to -current.

Reduce the ties to `inode'.

Catch up to -current.

Sort sections, sort SEE ALSO, punctuation and miscellanous fixes.

Boring whitespace fixes.

Document a weird circumstance under which stat() return EBADF.

Use ".Fa stat" instead of ".Fn stat" when referring to the structure
rather than the function.

Pull up rev. 1.19:
bin/10472: fix a couple typos in stat.2

bin/10472: fix a couple typos in stat.2

Pull up to last week's -current.

Add a LIBRARY section to system call manual pages.  While it's clear that the
libraries contain stubs only (with minor exceptions a la pipe(2)), the purpose
of this section is to provide linkage information.

Last of the .Os cleanups.  .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages.  Wheee!

first pass at fixing up capitalization of function names and
arguments; ensure that each is correct with respect to the
implementation, rather than being correct as per english.

merge lite-2

import lite-2

Don't start function name with capital letter even if it is beginning
of a sentence.

Remove description about behaviour of 4.4BSD symlink.

Add missing `STANDARDS' compliance statements.  As we #define _POSIX_VERSION
to 199009L, bump existing statements to 1003.1-1990.

Add/update 1003.1 conformance notice.

add description of file flags, with xrefs to chflags(2).
add missing group/other file mode bits (!).
eliminate obsolete CAVEATS section.
fix misc. grammar and macro usage errors.

Add S_IFWHT to correspond with <sys/stat.h>; Reported by Mike Long in PR #1949

merge with lite, keeping most local changes.  clean up Ids

from Lite

Remove description of EINVAL, "The pathname contains a character with the
high-order bit set", as this error is obsolete.

Eventually we may want to add code to some of the "optional" filesystems
(msdosfs, etc.) that checks for illegal characters.  At that time it would
be appropriate to reintroduce this error with appropriate text.  Perhaps
"The pathname contains a character that is not valid for filesystem type".

Use symbolic names {NAME_MAX} & {PATH_MAX} instead of 255 and 1023 in
description of ENAMETOOLONG error.

Fix spelling errors.

Use "Er" for argument to -width in the lists in the ERROR sections --- so
the formatting is consistant.

Clean up manpages:
  Use .Fn rather than .Nm macro in HISTORY and STANDARDS sections.
  Use .At and .St macros instead of spelling out "Version 6 UNIX",
	"IEEE 1003.1-1988 (POSIX)", etc.

Add RCS indentifiers.

initial import of 386bsd-0.1 sources

Initial revision