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

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

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

Fix some macro( usage)s

Add epoll(2) from Theodore Preduta as part of GSoC 2023

Fix typo

Add support for the EVFILT_EMPTY filter, which is activated when the
write buffer associated with the file descriptor is empty.  This is
currently implemented only for sockets, and is intended primarily to
provide visibility to applications that all previously written data
has been acknowledged by the TCP layer on the receiver.  Compatible
with the same filter in FreeBSD.

Oops, forgot to note the history of NOTE_OPEN, NOTE_CLOSE, NOTE_CLOSE_WRITE,
and NOTE_READ.

Overhaul of the EVFILT_VNODE kevent(2) filter:

- Centralize vnode kevent handling in the VOP_*() wrappers, rather than
  forcing each individual file system to deal with it (except VOP_RENAME(),
  because VOP_RENAME() is a mess and we currently have 2 different ways
  of handling it; at least it's reasonably well-centralized in the "new"
  way).
- Add support for NOTE_OPEN, NOTE_CLOSE, NOTE_CLOSE_WRITE, and NOTE_READ,
  compatible with the same events in FreeBSD.
- Track which kevent notifications clients are interested in receiving
  to avoid doing work for events no one cares about (avoiding, e.g.
  taking locks and traversing the klist to send a NOTE_WRITE when
  someone is merely watching for a file to be deleted, for example).

In support of the above:

- Add support in vnode_if.sh for specifying PRE- and POST-op handlers,
  to be invoked before and after vop_pre() and vop_post(), respectively.
  Basic idea from FreeBSD, but implemented differently.
- Add support in vnode_if.sh for specifying CONTEXT fields in the
  vop_*_args structures.  These context fields are used to convey information
  between the file system VOP function and the VOP wrapper, but do not
  occupy an argument slot in the VOP_*() call itself.  These context fields
  are initialized and subsequently interpreted by PRE- and POST-op handlers.
- Version VOP_REMOVE(), uses the a context field for the file system to report
  back the resulting link count of the target vnode.  Return this in tmpfs,
  udf, nfs, chfs, ext2fs, lfs, and ufs.

NetBSD 9.99.92.

Add support for the NOTE_SECONDS, NOTE_MSECONDS, NOTE_USECONDS,
NOTE_NSECONDS, and NOTE_ABSTIME filter flags to EVFILT_TIMER,
API-compatible with the same in FreeBSD.

add missing sentence.

Remove trailing whitespace.

PR/55663: Ruslan Nikolaev: Add support for EVFILT_USER in kqueue(2)

Merge changes from current as of 20200406

Explain in kevent(2) the semantics of EINTR

All changes contained in the changelist are applied before returning this
error.

Document udata type switch in struct kevent in the kqueue(2)

Sync with HEAD

Markup improvements: use Dv for kqueue filters, events and note names

ok wiz@

Merge autofs support from: Tomohiro Kusumi
XXX: Does not work yet

Remove workaround for ancient HTML generation code.

EV_SET(2) - simplify description

Note only the information that it does not evaluate multiple times its
parameters.

Suggested by <wiz>.

s/filesystem/file system/

Thanks to Thomas for pointing out that in NetBSD man pages we try to use the convention of writing it
as "file system".

Bump date for previous
Fix typo: fileystem -> filesystem

Update the EV_SET() description with newer implementation.

EV_SET(2) is a macro again, that wraps an inline function which is still
new in NetBSD 8.0.

Sponsored by <The NetBSD Foundation>

Document transition of EV_SET() from a macro to a static inline function

Sponsored by <The NetBSD Foundation>

Sync with HEAD

Sync with HEAD

Use more markup for `struct timespec`
Use Xr to refer to timespec(3)
Add timespec(3) to SEE ALSO

s/Sets/Set: Use style consistent with the other sentences in that list.
Add .Pp before next sentence.

Fix sentence.

Add EV_SET() to the NAME section
Use Xr instead of Fn to refer other man pages
Add some more entries to SEE ALSO

Reviewed by wiz@

Sync with HEAD.  (Note that most of these changes are simply $NetBSD$
tag issues.)

Use markup for errno
Also remove a .Pp before .Bl while there

PR/50506: Tobias Nygren: kqueue(2) lacks EV_DISPATCH/EV_RECEIPT support

Pull up following revision(s) (requested by christos in ticket #677):
	lib/libc/sys/kqueue.2: revision 1.34
	sys/kern/kern_event.c: revision 1.83
put the exit code of the process in data, like FreeBSD does.
--
say that we put the exit code in data.

say that we put the exit code in data.

resync with head

sync with (a bit old) head

Pull up revisions:
  src/sys/kern/kern_event.c revision 1.79
  src/sys/kern/kern_descrip.c revision 1.219
  src/lib/libc/sys/kqueue.2 revision 1.33
  src/tests/lib/libc/sys/t_kevent.c revision 1.2-1.5
(requested by christos in ticket #716).

- initialize kn_id
- in close, invalidate f_data and f_type early to prevent accidental re-use
- add a DIAGNOSTIC for when we use unsupported fd's and a KASSERT for f_event
  being NULL.

Return EOPNOTSUPP for fnullop_kqfilter to prevent registration of unsupported
fds. XXX: We should really fix the fd's to be supported in the future.
Unsupported fd's have a NULL f_event, so registering crashes the kernel with
a NULL function dereference of f_event.

mention that kevent returns now EOPNOTSUPP.

Move the references to PRs from code comments to the test description. Once
ATF has the ability to output the metadata in the HTML reports, it should be
easy to traverse between releng and gnats -reports via links.

Add a (skipped for now) test case for PR 46463

adapt to new reality

Add a test for adding an event to an unsupported fd.

Pull up revisions:
  src/sys/kern/kern_event.c revision 1.79
  src/sys/kern/kern_descrip.c revision 1.219
  src/lib/libc/sys/kqueue.2 revision 1.33
  src/tests/lib/libc/sys/t_kevent.c revision 1.2-1.5
(requested by christos in ticket #716).

- initialize kn_id
- in close, invalidate f_data and f_type early to prevent accidental re-use
- add a DIAGNOSTIC for when we use unsupported fd's and a KASSERT for f_event
  being NULL.

Return EOPNOTSUPP for fnullop_kqfilter to prevent registration of unsupported
fds. XXX: We should really fix the fd's to be supported in the future.
Unsupported fd's have a NULL f_event, so registering crashes the kernel with
a NULL function dereference of f_event.

mention that kevent returns now EOPNOTSUPP.

Move the references to PRs from code comments to the test description. Once
ATF has the ability to output the metadata in the HTML reports, it should be
easy to traverse between releng and gnats -reports via links.

Add a (skipped for now) test case for PR 46463

adapt to new reality

Add a test for adding an event to an unsupported fd.

mention that kevent returns now EOPNOTSUPP.

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]

* Arrange for interfaces that create new file descriptors to be able to
  set close-on-exec on creation (http://udrepper.livejournal.com/20407.html).

    - Add F_DUPFD_CLOEXEC to fcntl(2).
    - Add MSG_CMSG_CLOEXEC to recvmsg(2) for unix file descriptor passing.
    - Add dup3(2) syscall with a flags argument for O_CLOEXEC, O_NONBLOCK.
    - Add pipe2(2) syscall with a flags argument for O_CLOEXEC, O_NONBLOCK.
    - Add flags SOCK_CLOEXEC, SOCK_NONBLOCK to the socket type parameter
      for socket(2) and socketpair(2).
    - Add new paccept(2) syscall that takes an additional sigset_t to alter
      the sigmask temporarily and a flags argument to set SOCK_CLOEXEC,
      SOCK_NONBLOCK.
    - Add new mode character 'e' to fopen(3) and popen(3) to open pipes
      and file descriptors for close on exec.
    - Add new kqueue1(2) syscall with a new flags argument to open the
      kqueue file descriptor with O_CLOEXEC, O_NONBLOCK.

* Fix the system calls that take socklen_t arguments to actually do so.

* Don't include userland header files (signal.h) from system header files
  (rump_syscallargs.h).

* Bump libc version for the new syscalls.

fix incorrect variable name

Uncomment pdf link for paper.

Add the USENIX paper of Jonathan Lemon to SEE ALSO.

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

remove one the to much.

simplify the example; only register the set of events to watch once since
it does not change. Also print that ATTR means changing times too.

Make HTML-ready.

Add useful example program from

	http://mail-index.netbsd.org/tech-kern/2009/09/01/msg006020.html

Sync with HEAD.

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

Use comments instead of .ig (requested by joerg).
Sort errors while here.

Remove pointless AUTHORS sections. The names are in the source and CVS
history along with everyone else who has contributed.

Make HTML-output safe.

Reference kfilter_register(9) rather than the non-existent kfilter_register(2).

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.

After "sys/event.h" was fixed "sys/types.h" doesn't need to be included
manually any more.

update copyright dates and .Dd

Introduce EVFILT_TIMER, which allows a process to establish an
arbitrary number of timers, both oneshot and periodic.

from FreeBSD

g/c the NEXTRELEASE comment tag now that the next version number is decided

Merge the nathanw_sa branch.

Catch up to -current

struct kevent's udata is actually intptr_t

update HISTORY - kqueue branch was merged
bump date

'data' field of struct kevent is actually int64_t nowadays

Catch up to -current.

file kqueue.2 was added on branch nathanw_sa on 2002-10-18 02:16:58 +0000

no more BUGS; EVFILT_{VNODE,READ} is supported also for other filesystems
than FFS

deprecated, not depreciated.

New sentence, new line. From Robert Elz.

Drop trailing whitespace, and some mdoc fixes and improvements.

add missing comma

'data' contains amount of space remaining in the write buffer also
for ttys

add kqueue(2)/kevent(2) manpage to mainline, to reduce difference between
the kqueue branch and -current and thus make testing easier

change HISTORY to clearly state this interface is only available with
  experimental kernel branch
add Jason Thorpe and me to AUTHORS
update .Dd

kevent(2): nchanges and nevents changed to size_t

credit Luke in HISTORY section

document differences in netbsd implementation:
* we don't have rfork or AIO, so don't talk about it
* filter, flags and fflags are now uint32_t
* document KFILTER_BYFILTER and KFILTER_BYNAME ioctls
* expand filter description

move to kqueue branch for now

freebsd kqueue implementation

Initial revision