linux-toradex.git/Documentation/networking/netdevices.rst, branch v5.18-rc5

net: bonding: move ioctl handling to private ndo operation

2021-07-27T19:11:45+00:00

All other user triggered operations are gone from ndo_ioctl, so move
the SIOCBOND family into a custom operation as well.

The .ndo_ioctl() helper is no longer called by the dev_ioctl.c code now,
but there are still a few definitions in obsolete wireless drivers as well
as the appletalk and ieee802154 layers to call SIOCSIFADDR/SIOCGIFADDR
helpers from inside the kernel.

Cc: Jay Vosburgh 
Cc: Veaceslav Falico 
Cc: Andy Gospodarek 
Signed-off-by: Arnd Bergmann 
Signed-off-by: David S. Miller

net: split out ndo_siowandev ioctl

2021-07-27T19:11:45+00:00

In order to further reduce the scope of ndo_do_ioctl(), move
out the SIOCWANDEV handling into a new network device operation
function.

Adjust the prototype to only pass the if_settings sub-structure
in place of the ifreq, and remove the redundant 'cmd' argument
in the process.

Cc: Krzysztof Halasa 
Cc: "Jan \"Yenya\" Kasprzak" 
Cc: Kevin Curtis 
Cc: Zhao Qiang 
Cc: Martin Schiller 
Cc: Jiri Slaby 
Cc: linux-x25@vger.kernel.org
Signed-off-by: Arnd Bergmann 
Signed-off-by: David S. Miller

dev_ioctl: split out ndo_eth_ioctl

2021-07-27T19:11:45+00:00

Most users of ndo_do_ioctl are ethernet drivers that implement
the MII commands SIOCGMIIPHY/SIOCGMIIREG/SIOCSMIIREG, or hardware
timestamping with SIOCSHWTSTAMP/SIOCGHWTSTAMP.

Separate these from the few drivers that use ndo_do_ioctl to
implement SIOCBOND, SIOCBR and SIOCWANDEV commands.

This is a purely cosmetic change intended to help readers find
their way through the implementation.

Cc: Doug Ledford 
Cc: Jason Gunthorpe 
Cc: Jay Vosburgh 
Cc: Veaceslav Falico 
Cc: Andy Gospodarek 
Cc: Andrew Lunn 
Cc: Vivien Didelot 
Cc: Florian Fainelli 
Cc: Vladimir Oltean 
Cc: Leon Romanovsky 
Cc: linux-rdma@vger.kernel.org
Signed-off-by: Arnd Bergmann 
Acked-by: Jason Gunthorpe 
Signed-off-by: David S. Miller

net: split out SIOCDEVPRIVATE handling from dev_ioctl

2021-07-27T19:11:43+00:00

SIOCDEVPRIVATE ioctl commands are mainly used in really old
drivers, and they have a number of problems:

- They hide behind the normal .ndo_do_ioctl function that
  is also used for other things in modern drivers, so it's
  hard to spot a driver that actually uses one of these

- Since drivers use a number different calling conventions,
  it is impossible to support compat mode for them in
  a generic way.

- With all drivers using the same 16 commands codes, there
  is no way to introspect the data being passed through
  things like strace.

Add a new net_device_ops callback pointer, to address the
first two of these. Separating them from .ndo_do_ioctl
makes it easy to grep for drivers with a .ndo_siocdevprivate
callback, and the unwieldy name hopefully makes it easier
to spot in code review.

By passing the ifreq structure and the ifr_data pointer
separately, it is no longer necessary to overload these,
and the driver can use either one for a given command.

Cc: Cong Wang 
Signed-off-by: Arnd Bergmann 
Signed-off-by: David S. Miller

docs: net: explain struct net_device lifetime

2021-01-09T03:27:41+00:00

Explain the two basic flows of struct net_device's operation.

Signed-off-by: Jakub Kicinski

docs: net: fix documentation on .ndo_get_stats

2021-01-06T00:41:51+00:00

Fix calling context.

Signed-off-by: Jakub Kicinski 
Reviewed-by: Vladimir Oltean 
Signed-off-by: David S. Miller

docs: networking: convert netdevices.txt to ReST

2020-04-30T19:56:36+00:00

- add SPDX header;
- adjust title markup;
- mark lists as such;
- adjust identation, whitespaces and blank lines;
- add to networking/index.rst.

Signed-off-by: Mauro Carvalho Chehab 
Signed-off-by: David S. Miller