Changeset View
Changeset View
Standalone View
Standalone View
share/man/man9/ifnet.9
Show All 22 Lines | ||||||||||||
.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | .\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND | |||||||||||
.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, | .\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, | |||||||||||
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT | .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT | |||||||||||
.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |||||||||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | |||||||||||
.\" | .\" | |||||||||||
.\" $FreeBSD$ | .\" $FreeBSD$ | |||||||||||
.\" | .\" | |||||||||||
.Dd September 28, 2020 | .Dd September 28, 2020 | |||||||||||
hselasky: Fix date before commit? | ||||||||||||
.Dt IFNET 9 | .Dt IFNET 9 | |||||||||||
.Os | .Os | |||||||||||
.Sh NAME | .Sh NAME | |||||||||||
.Nm ifnet , | .Nm ifnet , | |||||||||||
.Nm ifaddr , | .Nm ifaddr , | |||||||||||
.Nm ifqueue , | .Nm ifqueue , | |||||||||||
.Nm if_data | .Nm if_data | |||||||||||
.Nd kernel interfaces for manipulating network interfaces | .Nd kernel interfaces for manipulating network interfaces | |||||||||||
▲ Show 20 Lines • Show All 1,289 Lines • ▼ Show 20 Lines | ||||||||||||
Requesting to enable an unsupported capability is invalid. | Requesting to enable an unsupported capability is invalid. | |||||||||||
The rest is supposed to be done by the driver, | The rest is supposed to be done by the driver, | |||||||||||
which includes updating | which includes updating | |||||||||||
.Va if_capenable | .Va if_capenable | |||||||||||
and | and | |||||||||||
.Va if_data.ifi_hwassist | .Va if_data.ifi_hwassist | |||||||||||
appropriately. | appropriately. | |||||||||||
.Pp | .Pp | |||||||||||
.It Dv SIOCGIFCAPNV | ||||||||||||
.Xr NV 9 | ||||||||||||
version of the | ||||||||||||
.Dv SIOCGIFCAP | ||||||||||||
ioctl. | ||||||||||||
Done Inline Actions.Xr ioctl 2 . hselasky: .Xr ioctl 2 . | ||||||||||||
Done Inline ActionsIMO there is no point in cross-reference there. We talk not about syscall, but about some feature implemented as part of the described framework. kib: IMO there is no point in cross-reference there. We talk not about syscall, but about some… | ||||||||||||
Caller must provide the pointer to | ||||||||||||
Done Inline ActionsSpelling? Caller must provide the pointer to Caller must provide a pointer to hselasky: Spelling?
```
Caller must provide the pointer to
```
```
Caller must provide a pointer to
``` | ||||||||||||
.Vt struct ifreq_cap_nv | ||||||||||||
as | ||||||||||||
.Fa data , | ||||||||||||
where the member | ||||||||||||
.Dv buffer | ||||||||||||
points to some buffer containing | ||||||||||||
.Dv buf_length | ||||||||||||
bytes. | ||||||||||||
The serialized nvlist with description of the device capabilities | ||||||||||||
is written to the buffer. | ||||||||||||
If buffer is too short, then the structure is updated with | ||||||||||||
Done Inline Actionscan skip the word "then" hselasky: can skip the word "then" | ||||||||||||
.Dv buffer | ||||||||||||
member set to | ||||||||||||
.Dv NULL, | ||||||||||||
debdrupUnsubmitted Done Inline ActionsStill missing a space here between NULL and the comma. debdrup: Still missing a space here between NULL and the comma. | ||||||||||||
.Dv length | ||||||||||||
Done Inline Actions
The syntax here needs work; I think my suggestion will work. Be sure to check with mandoc and igor. debdrup: The syntax here needs work; I think my suggestion will work.
Be sure to check with mandoc and… | ||||||||||||
set to the minimal required length, and error | ||||||||||||
.Er EFBIG | ||||||||||||
is returned. | ||||||||||||
.Pp | ||||||||||||
Elements of the returned nvlist for simple capabilities are boolean, | ||||||||||||
identified by names. | ||||||||||||
Presence of the boolean element means that corresponding capability is | ||||||||||||
supported by the interface. | ||||||||||||
Element's value describes the current configured state: | ||||||||||||
.Dv true | ||||||||||||
means that the capability is enabled, and | ||||||||||||
.Dv false | ||||||||||||
that it is disabled. | ||||||||||||
.Pp | ||||||||||||
Driver indicates support for both | ||||||||||||
.Dv SIOCGIFCAPNV | ||||||||||||
and | ||||||||||||
.Dv SIOCSIFCAPNV | ||||||||||||
requests by setting | ||||||||||||
.Dv IFCAP_NV | ||||||||||||
non-modifiable capability bit in | ||||||||||||
.Dv if_capabilities . | ||||||||||||
.Pp | ||||||||||||
.It Dv SIOCSIFCAPNV | ||||||||||||
.Xr NV 9 | ||||||||||||
version of the | ||||||||||||
.Dv SIOCSIFCAP | ||||||||||||
ioctl. | ||||||||||||
Caller must provide the pointer to | ||||||||||||
.Vt struct ifreq_cap_nv | ||||||||||||
as | ||||||||||||
.Fa data , | ||||||||||||
where the member | ||||||||||||
.Dv buffer | ||||||||||||
points to unpacked nvlist of | ||||||||||||
.Dv length | ||||||||||||
bytes. | ||||||||||||
Each element of nvlist describes a requested update of one capability, | ||||||||||||
identified by the element name. | ||||||||||||
For simple capabilities, the element must be boolean. | ||||||||||||
Its | ||||||||||||
.Dv true | ||||||||||||
value means that the caller asks to enable the capability, and | ||||||||||||
.Dv false | ||||||||||||
value to disable. | ||||||||||||
Only capabilities listed in the nvlist are affected by the call. | ||||||||||||
.Pp | ||||||||||||
.It Dv SIOCSIFFIB | .It Dv SIOCSIFFIB | |||||||||||
Sets interface FIB. | Sets interface FIB. | |||||||||||
Caller must have appropriate privilege. | Caller must have appropriate privilege. | |||||||||||
FIB values start at 0 and values greater or equals than | FIB values start at 0 and values greater or equals than | |||||||||||
.Va net.fibs | .Va net.fibs | |||||||||||
are considered invalid. | are considered invalid. | |||||||||||
.It Dv SIOCSIFFLAGS | .It Dv SIOCSIFFLAGS | |||||||||||
Change interface flags. | Change interface flags. | |||||||||||
▲ Show 20 Lines • Show All 201 Lines • Show Last 20 Lines |
Fix date before commit?