CVS log for src/lib/libc/sys/open.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 thorpej in ticket #114):

	lib/libc/sys/open.2: revision 1.66

Document the error code when O_REGULAR is specified and the last
path component is not a regular file.

Document the error code when O_REGULAR is specified and the last
path component is not a regular file.

Remove superfluous article.

Clarify use of open flags in open(2).

(Avoid using values of three that are equal to four.)

Note that open(O_ASYNC) does not work as advertised.

This matches Linux, which also advertises the same semantics and
fails to implement it, according to:

https://man7.org/linux/man-pages/man2/fcntl.2.html

(At what point should we collectively stop advertising the semantics
that doesn't work and call the bug a feature?)

Mostly merge changes from HEAD upto 20200411

Sort errors.

Document O_EXEC, and add some extra explanation for O_CREAT from FreeBSD.

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).

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

Pull up following revision(s) (requested by christos in ticket #741):
	lib/libc/stdio/flags.c: revision 1.19
	lib/libc/stdio/fdopen.c: revision 1.18
	sys/kern/vfs_vnops.c: revision 1.196
	lib/libc/stdio/freopen.c: revision 1.20
	lib/libc/stdio/fopen.c: revision 1.17
	external/bsd/nvi/dist/common/recover.c: revision 1.10
	external/bsd/nvi/dist/common/recover.c: revision 1.11
	lib/libc/sys/open.2: revision 1.58
	sys/sys/fcntl.h: revision 1.49
make the checkok test stricter to avoid races, and use O_REGULAR.
Instead of opening the file and using popen(3), pass the file descriptor
to sendmail directory. Idea and code from Todd Miller.
Add O_REGULAR to enforce opening of only regular files
(like we have O_DIRECTORY for directories).
This is better than open(, O_NONBLOCK), fstat()+S_ISREG() because opening
devices can have side effects.

Remove Tn.

Add O_REGULAR to enforce opening of only regular files
(like we have O_DIRECTORY for directories).
This is better than open(, O_NONBLOCK), fstat()+S_ISREG() because opening
devices can have side effects.

Resolve conflicts from previous merge (all resulting from $NetBSD
keywork expansion)

file system police.

Rebase to HEAD as of a few days ago.

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")

Add openat(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

As discussed in tech-kern, provide the means to prevent delivery of SIGPIPE
on EPIPE for all file descriptor types:

- provide O_NOSIGPIPE for open,kqueue1,pipe2,dup3,fcntl(F_{G,S}ETFL) [NetBSD]
- provide SOCK_NOSIGPIPE for socket,socketpair [NetBSD]
- provide SO_NOSIGPIPE for {g,s}seckopt [NetBSD/FreeBSD/MacOSX]
- provide F_{G,S}ETNOSIGPIPE for fcntl [MacOSX]

sync with reality (prototype of open is varyadic)

exec is on a higher plane of existence.

Document O_CLOEXEC.

Bump date for O_DIRECTORY, more markup, merge two error sections.

implement O_DIRECTORY as standardized in POSIX-2008,
for both native and linux emulations.
this fixes the rest of PR 43695.

O_NOFOLLOW is not a non-standard extension any longer (2, 6 years? who counts).

Note a difference to IEEE Std 2003.1-2008. Bump date.

Explain how O_NOFOLLOW may cause EFTYPE. From joerg.
While here, sort errors. Bump date.

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

Sort ERRORS section.

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

Bump date for previous.

open(2) can fail with EPERM.

Bump date for previous.
New sentence, new line.

add support for O_DIRECT (I/O directly to application memory,
bypassing any kernel caching for file data).

Add article. Remove superfluous braces.

lib/26532: Manual page for open(2) bit difficult to understand:
	apply patch with small improvement - s/conditions/methods/

document the flags O_ALT_IO and O_NOCTTY

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

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

O_NOFOLLOW is another non-standard extension

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.

Use "its" instead of "it's" where appropriate.
From Soren Jacobsen in PR 20730.

Merge the nathanw_sa branch.

Sync with HEAD.

Provide O_NOFOLLOW with compatibility with the joneses.

Catch up to -current.

-1 -> \-1.

- move return values info into RETURN VALUES section.
- note that O_SHLOCK and O_EXLOCK are not portable.
from OpenBSD.

Catch up to -current.

Remove the cross reference of fileno(3). It is more appropriate to
cross reference this from fopen(3). After discussion with John Heasley
in PR/17224.

Add Xr to fileno(3), as request in lib/17224.

Catch up to -current.

Catch up to -current.

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

Catch up to -current.

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

Boring whitespace fixes.

Sync w/ netbsd-1-5-base.

Merge duplicate mentions of EPERM, EACCESS, ... into one entry
(where applicable).

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.

Add ENXIO error for FIFOs.

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.

Per IEEE Std 1003.1b-1993, Synchronous I/O Option, add O_DSYNC (synchronized
I/O data integrity completion) and O_RSYNC (complete read operations at the
same level of integrity requested for write operations).

fix mdoc references

Pull up 1.11 and 1.12 (thorpej)

Document the O_SYNC flag, and where its semantics are defined (XPG4.2).
Be more clear about how file access modes are specified, and do a bit
of general cleanup.

Nuke trailing comma in SEE ALSO section.

xref getdtablesize(3) not getdtablesize(2)

Add/update 1003.1 conformance notice.

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

from Lite

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

bleh

Tell user to #include <fcntl.h>, not <sys/fcntl.h> or <sys/file.h>.

Manpage formatting tweaks.

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