kqueue.2 (231777) | kqueue.2 (233648) |
---|---|
1.\" Copyright (c) 2000 Jonathan Lemon 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" | 1.\" Copyright (c) 2000 Jonathan Lemon 2.\" All rights reserved. 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. --- 8 unchanged lines hidden (view full) --- 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" |
25.\" $FreeBSD: head/lib/libc/sys/kqueue.2 231777 2012-02-15 18:34:57Z delphij $ | 25.\" $FreeBSD: head/lib/libc/sys/kqueue.2 233648 2012-03-29 05:02:12Z eadler $ |
26.\" 27.Dd February 15, 2012 28.Dt KQUEUE 2 29.Os 30.Sh NAME 31.Nm kqueue , 32.Nm kevent 33.Nd kernel event notification mechanism --- 164 unchanged lines hidden (view full) --- 198to return the event if it is triggered. 199.It EV_DISABLE 200Disable the event so 201.Fn kevent 202will not return it. 203The filter itself is not disabled. 204.It EV_DISPATCH 205Disable the event source immediately after delivery of an event. | 26.\" 27.Dd February 15, 2012 28.Dt KQUEUE 2 29.Os 30.Sh NAME 31.Nm kqueue , 32.Nm kevent 33.Nd kernel event notification mechanism --- 164 unchanged lines hidden (view full) --- 198to return the event if it is triggered. 199.It EV_DISABLE 200Disable the event so 201.Fn kevent 202will not return it. 203The filter itself is not disabled. 204.It EV_DISPATCH 205Disable the event source immediately after delivery of an event. |
206See | 206See |
207.Dv EV_DISABLE 208above. 209.It EV_DELETE 210Removes the event from the kqueue. 211Events which are attached to 212file descriptors are automatically deleted on the last close of 213the descriptor. 214.It EV_RECEIPT 215This flag is useful for making bulk changes to a kqueue without draining 216any pending events. 217When passed as input, it forces 218.Dv EV_ERROR 219to always be returned. | 207.Dv EV_DISABLE 208above. 209.It EV_DELETE 210Removes the event from the kqueue. 211Events which are attached to 212file descriptors are automatically deleted on the last close of 213the descriptor. 214.It EV_RECEIPT 215This flag is useful for making bulk changes to a kqueue without draining 216any pending events. 217When passed as input, it forces 218.Dv EV_ERROR 219to always be returned. |
220When a filter is successfully added the | 220When a filter is successfully added the |
221.Va data 222field will be zero. 223.It EV_ONESHOT 224Causes the event to return only the first occurrence of the filter 225being triggered. 226After the user retrieves the event from the kqueue, 227it is deleted. 228.It EV_CLEAR --- 215 unchanged lines hidden (view full) --- 444On return, 445.Va fflags 446contains the events which triggered the filter. 447.It Dv EVFILT_USER 448Establishes a user event identified by 449.Va ident 450which is not associated with any kernel mechanism but is triggered by 451user level code. | 221.Va data 222field will be zero. 223.It EV_ONESHOT 224Causes the event to return only the first occurrence of the filter 225being triggered. 226After the user retrieves the event from the kqueue, 227it is deleted. 228.It EV_CLEAR --- 215 unchanged lines hidden (view full) --- 444On return, 445.Va fflags 446contains the events which triggered the filter. 447.It Dv EVFILT_USER 448Establishes a user event identified by 449.Va ident 450which is not associated with any kernel mechanism but is triggered by 451user level code. |
452The lower 24 bits of the | 452The lower 24 bits of the |
453.Va fflags 454may be used for user defined flags and manipulated using the following: | 453.Va fflags 454may be used for user defined flags and manipulated using the following: |
455.Bl -tag -width XXNOTE_FFLAGSMASK | 455.Bl -tag -width XXNOTE_FFLAGSMASK |
456.It Dv NOTE_FFNOP 457Ignore the input 458.Va fflags . 459.It Dv NOTE_FFAND 460Bitwise AND 461.Va fflags . 462.It Dv NOTE_FFOR 463Bitwise OR --- 126 unchanged lines hidden --- | 456.It Dv NOTE_FFNOP 457Ignore the input 458.Va fflags . 459.It Dv NOTE_FFAND 460Bitwise AND 461.Va fflags . 462.It Dv NOTE_FFOR 463Bitwise OR --- 126 unchanged lines hidden --- |