Page MenuHomeFreeBSD
Differential D53845 Diff 167461 share/man/man9/kqueue.9

Changeset View

Standalone View

View Options

share/man/man9/kqueue.9

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 December 18, 2023 .Dd December 2, 2025
.Dt KQUEUE 9 .Dt KQUEUE 9
.Os .Os
.Sh NAME .Sh NAME
.Nm kqueue_add_filteropts , kqueue_del_filteropts , .Nm kqueue_add_filteropts , kqueue_del_filteropts ,
.Nm kqfd_register , .Nm kqfd_register ,
.Nm knote_fdclose , .Nm knote_fdclose ,
.Nm knlist_init , knlist_init_mtx , .Nm knlist_init , knlist_init_mtx ,
.Nm knlist_add , knlist_remove , knlist_empty , .Nm knlist_add , knlist_remove , knlist_empty ,
▲ Show 20 Lines • Show All 158 Lines • ▼ Show 20 Lines
.Va f_event , .Va f_event ,
it must be obtained in the it must be obtained in the
.Fa kl_lock .Fa kl_lock
function of the function of the
.Vt knlist .Vt knlist
that the that the
.Va knote .Va knote
was added to. was added to.
.It Va f_copy
kibUnsubmitted
Not Done
Inline Actions

Why did you dropped the description of the f_copy itself?

kib: Why did you dropped the description of the f_copy itself?
The
.Va f_copy
function is called to copy notes when the process forks.
When
.Dv NULL ,
the current node is not duplicated to the child process.
impAuthorUnsubmitted
Done
Inline Actions

Or maybe "the not will not be copied to the child process"
I'm not sure which is better.

imp: Or maybe "the not will not be copied to the child process" I'm not sure which is better.
kibUnsubmitted
Not Done
Inline Actions

Now I do not quite like either formulation. The idea is to inform that the copied note is not copied. Might be,
When NULL, the current note is not duplicated in the child process kqueue.

kib: Now I do not quite like either formulation. The idea is to inform that the copied note is not…
Filter might set
.Dv f_copy
pauamma_chezdork.comUnsubmitted
Not Done
Inline Actions

Did you mean "knote_triv_copy" here?

pauamma_chezdork.com: Did you mean "knote_triv_copy" here?
impAuthorUnsubmitted
Done
Inline Actions

yea, I typed it rather than cut and paste.

imp: yea, I typed it rather than cut and paste.
to
.Fn knote_triv_copy
if there is no additional handling required, besides shallow copying of the knote itself.
kibUnsubmitted
Not Done
Inline Actions
.Fn knote_triv_copy
- if there is no additional resource handling required, besides shallow copying of the knote itself.
+ if there is no additional handling required, besides shallow copying of the knote itself.
.El
.Pp
The function

The 'resource' term there does not add anything IMO

kib: The 'resource' term there does not add anything IMO
.El .El
.Pp .Pp
The function The function
kibUnsubmitted
Not Done
Inline Actions

I do not understand the second half of this sentence (WRT error), and think that the first half could be reformulated.
I suggest to say it like this, feel free to edit the language:

Filter might set
.Dv f_copy
to
.Fn knote_triv_copy
if there is no additional resource handling required, besides shallow copying of the knote itself.

kib: I do not understand the second half of this sentence (WRT error), and think that the first half…
impAuthorUnsubmitted
Done
Inline Actions

Yes. That's likely better. Do I need to mention anything about errors calling the detach function (which I saw from code inspection)?

imp: Yes. That's likely better. Do I need to mention anything about errors calling the detach…
kibUnsubmitted
Not Done
Inline Actions

No, there is no need. This is a normal flow for destroying knote, and it does not matter why it happen.

kib: No, there is no need. This is a normal flow for destroying knote, and it does not matter why…
.Fn kqfd_register .Fn kqfd_register
will register the will register the
.Vt kevent .Vt kevent
on the kqueue file descriptor on the kqueue file descriptor
.Fa fd . .Fa fd .
If it is safe to sleep, If it is safe to sleep,
.Fa waitok .Fa waitok
should be set. should be set.
▲ Show 20 Lines • Show All 216 Lines • Show Last 20 Lines