aboutsummaryrefslogtreecommitdiffstats
path: root/man7/netdevice.7
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2007-06-23 07:56:56 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2007-06-23 07:56:56 +0000
commitf19a0f03eefac77a52687989582a5bcba2e109d3 (patch)
tree3fed6b3b2dfd6230eda1c873b043bb68967a283b /man7/netdevice.7
parent66ee0c7e89fe01348878638515edb8b2a51b9a2e (diff)
downloadman-pages-f19a0f03eefac77a52687989582a5bcba2e109d3.tar.gz
ffix
Diffstat (limited to 'man7/netdevice.7')
-rw-r--r--man7/netdevice.742
1 files changed, 21 insertions, 21 deletions
diff --git a/man7/netdevice.7 b/man7/netdevice.7
index 217fb1e207..65b802d9fa 100644
--- a/man7/netdevice.7
+++ b/man7/netdevice.7
@@ -24,7 +24,7 @@ Linux supports some standard ioctls to configure network devices.
They can be used on any socket's file descriptor regardless of the
family or type.
They pass an
-.B ifreq
+.I ifreq
structure:
.nf
@@ -57,7 +57,7 @@ struct ifconf {
.fi
Normally, the user specifies which device to affect by setting
-.B ifr_name
+.I ifr_name
to the name of the interface.
All other members of the structure may
share memory.
@@ -72,19 +72,19 @@ will be returned.
.TP
.B SIOCGIFNAME
Given the
-.BR ifr_ifindex ,
+.IR ifr_ifindex ,
return the name of the interface in
-.BR ifr_name .
+.IR ifr_name .
This is the only ioctl which returns its result in
-.BR ifr_name .
+.IR ifr_name .
.TP
.B SIOCGIFINDEX
Retrieve the interface index of the interface into
-.BR ifr_ifindex .
+.IR ifr_ifindex .
.TP
.BR SIOCGIFFLAGS ", " SIOCSIFFLAGS
Get or set the active flag word of the device.
-.B ifr_flags
+.I ifr_flags
contains a bitmask of the following values:
.TS
tab(:);
@@ -115,23 +115,23 @@ process may read it.
.TP
.BR SIOCGIFMETRIC ", " SIOCSIFMETRIC
Get or set the metric of the device using
-.BR ifr_metric .
+.IR ifr_metric .
This is currently not implemented; it sets
-.B ifr_metric
+.I ifr_metric
to 0 if you attempt to read it and returns
.B EOPNOTSUPP
if you attempt to set it.
.TP
.BR SIOCGIFMTU ", " SIOCSIFMTU
Get or set the MTU (Maximum Transfer Unit) of a device using
-.BR ifr_mtu .
+.IR ifr_mtu .
Setting the MTU is a privileged operation.
Setting the MTU to
too small values may cause kernel crashes.
.TP
.BR SIOCGIFHWADDR ", " SIOCSIFHWADDR
Get or set the hardware address of a device using
-.BR ifr_hwaddr .
+.IR ifr_hwaddr .
The hardware address is specified in a struct
.IR sockaddr .
.I sa_family
@@ -142,12 +142,12 @@ Setting the hardware address is a privileged operation.
.TP
.B SIOCSIFHWBROADCAST
Set the hardware broadcast address of a device from
-.BR ifr_hwaddr .
+.IR ifr_hwaddr .
This is a privileged operation.
.TP
.BR SIOCGIFMAP ", " SIOCSIFMAP
Get or set the interface's hardware parameters using
-.BR ifr_map .
+.IR ifr_map .
Setting the parameters is a privileged operation.
.nf
@@ -167,7 +167,7 @@ and the architecture.
.BR SIOCADDMULTI ", " SIOCDELMULTI
Add an address to or delete an address from the device's link layer
multicast filters using
-.BR ifr_hwaddr .
+.IR ifr_hwaddr .
These are privileged operations.
See also
.BR packet (7)
@@ -175,14 +175,14 @@ for an alternative.
.TP
.BR SIOCGIFTXQLEN ", " SIOCSIFTXQLEN
Get or set the transmit queue length of a device using
-.BR ifr_qlen .
+.IR ifr_qlen .
Setting the transmit queue length is a privileged operation.
.TP
.B SIOCSIFNAME
Changes the name of the interface specified in
-.BR ifr_name
+.IR ifr_name
to
-.BR ifr_newname .
+.IR ifr_newname .
This is a privileged operation.
It is only allowed when the interface
is not up.
@@ -194,14 +194,14 @@ means only addresses of the
.B AF_INET
(IPv4) family for compatibility.
The user passes a
-.B ifconf
+.I ifconf
structure as argument to the ioctl.
It contains a pointer to an array of
.I ifreq
structures in
-.B ifc_req
+.I ifc_req
and its length in bytes in
-.BR ifc_len .
+.IR ifc_len .
The kernel fills the ifreqs with all current L3 interface addresses that
are running:
.I ifr_name
@@ -222,7 +222,7 @@ Overflow is not an error.
.\" .TP
.\" .BR SIOCGIFSLAVE ", " SIOCSIFSLAVE
.\" Get or set the slave device using
-.\" .BR ifr_slave .
+.\" .IR ifr_slave .
.\" Setting the slave device is a privileged operation.
.\" .PP
.\" FIXME add amateur radio stuff.