Page MenuHomeFreeBSD
Differential D58313 Diff 182768 lib/libsys/kqueue.2

Changeset View

Standalone View

View Options

lib/libsys/kqueue.2

Show All 16 Lines
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE. .\" SUCH DAMAGE.
.\" .\"
.Dd January 24, 2026 .Dd July 22, 2026
.Dt KQUEUE 2 .Dt KQUEUE 2
.Os .Os
.Sh NAME .Sh NAME
.Nm kqueue , .Nm kqueue ,
.Nm kevent .Nm kevent
.Nd kernel event notification mechanism .Nd kernel event notification mechanism
.Sh LIBRARY .Sh LIBRARY
.Lb libc .Lb libc
▲ Show 20 Lines • Show All 504 Lines • ▼ Show 20 Lines
The events to monitor are: The events to monitor are:
.Bl -tag -width "Dv NOTE_TRACKERR" .Bl -tag -width "Dv NOTE_TRACKERR"
.It Dv NOTE_EXIT .It Dv NOTE_EXIT
The process has exited. The process has exited.
The exit status will be stored in The exit status will be stored in
.Va data .Va data
in the same format as the status returned by in the same format as the status returned by
.Xr wait 2 . .Xr wait 2 .
.It Dv NOTE_REAP
The process has been reaped by a call to the
kibUnsubmitted
Done
Inline Actions

I think some explanation what 'reaped' means is useful.

kib: I think some explanation what 'reaped' means is useful.
desAuthorUnsubmitted
Done
Inline Actions

Why? It's established terminology. I prefer “collected” but “reaped” is what it's been called for 40 or 50 years, cf. procctl(2), waitpid(2) etc.

des: Why? It's established terminology. I prefer “collected” but “reaped” is what it's been called…
markjUnsubmitted
Done
Inline Actions

You might at least refer to wait(2), e.g., "The process has been reaped by a call to the wait(2) family of functions."

markj: You might at least refer to wait(2), e.g., "The process has been reaped by a call to the wait…
.Xr wait 2
family of functions.
.It Dv NOTE_FORK .It Dv NOTE_FORK
The process has called The process has called
.Fn fork . .Xr fork 2
or
.Xr vfork 2 .
.It Dv NOTE_EXEC .It Dv NOTE_EXEC
The process has executed a new process via The process has executed a new process via
.Xr execve 2 .Xr execve 2
or a similar call. or a similar call.
.It Dv NOTE_TRACK .It Dv NOTE_TRACK
Follow a process across Follow a process across
.Fn fork .Fn fork
calls. calls.
▲ Show 20 Lines • Show All 476 Lines • Show Last 20 Lines