Thank you for the link.
It's done. (Bug ID# 12191689)
Summary:
Two mistakes in the following documentation headers:
- sys/kern_control.h => doc of function ctl_enqueuedata(…)
- sys/kpi_socketfilter.h => sf_data_out_func
Steps to Reproduce:
1. In <sys/kern_control.h> on line 395, the documentation of the function ctl_enqueuedata(…) states:
"@param flags Send flags. CTL_DATA_NOWAKEUP is currently the only supported flag"
this is not true and misleading for inexperienced kernel extension programmers who don't know better.
2. In <sys/kpi_socketfilter.h>on line 334, the documentation of the function sf_connect_out_func states:
" @result Return:
0 - The caller will continue with normal processing of the
connection.
Anything Else - The caller will rejecting the outbound
connection.
"
which is not true. It is also possible to return EJUSTRETURN to stop the processing without rejecting the outbound connection.
Expected Results:
- improvement of the documentation accuracy.
- diminution of the number of confused readers.
Actual Results:
Actual results will depend on the number of developers actually reading this specific part of the documentation.
Regression:
No regression to foresee.
Notes:
---