bianbu-repo-mirror/bianbu-linux-6.6
1
0
Fork 0
mirror of https://gitee.com/bianbu-linux/linux-6.6 synced 2025-04-24 14:07:52 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

switchdev: documentation: use switchdev_port_obj_xxx for IPv4 FIB add/modify/delete ops

Browse source 
Clarify in documentation and code that IPV4 FIB add operation is used for
both adding a new FIB entry to the device and for modifying an existing FIB
entry on the device.

Also, remove left-over references to ipv4_fib ops and replace with details
on SWITCHDEV_PORT_IPV4_FIB object.

Signed-off-by: Scott Feldman <sfeldma@gmail.com>
Acked-by: Jiri Pirko <jiri@resnulli.us>
Signed-off-by: David S. Miller <davem@davemloft.net>
This commit is contained in:
Scott Feldman 2015-06-03 20:43:43 -07:00 • committed by David S. Miller
parent 4b5364fbdc
commit 7616dcbb21
2 changed files with 28 additions and 23 deletions
Download patch file Download diff file Expand all files Collapse all files

47
Documentation/networking/switchdev.txt
View file

@ -300,33 +300,38 @@ IGMP Snooping
XXX: complete this section XXX: complete this section
L3 routing L3 Routing Offload
---------- ------------------
Offloading L3 routing requires that device be programmed with FIB entries from Offloading L3 routing requires that device be programmed with FIB entries from
the kernel, with the device doing the FIB lookup and forwarding. The device the kernel, with the device doing the FIB lookup and forwarding. The device
does a longest prefix match (LPM) on FIB entries matching route prefix and does a longest prefix match (LPM) on FIB entries matching route prefix and
forwards the packet to the matching FIB entry's nexthop(s) egress ports. To forwards the packet to the matching FIB entry's nexthop(s) egress ports.
program the device, the switchdev driver is called with add/delete ops for IPv4
and IPv6 FIB entries. For IPv4, the driver implements switchdev ops:
int (*switchdev_fib_ipv4_add)(struct net_device *dev, To program the device, the driver implements support for
__be32 dst, int dst_len, SWITCHDEV_OBJ_IPV[4|6]_FIB object using switchdev_port_obj_xxx ops.
struct fib_info *fi, switchdev_port_obj_add is used for both adding a new FIB entry to the device,
u8 tos, u8 type, or modifying an existing entry on the device.
u32 nlflags, u32 tb_id);
int (*switchdev_fib_ipv4_del)(struct net_device *dev, XXX: Currently, only SWITCHDEV_OBJ_IPV4_FIB objects are supported.
__be32 dst, int dst_len,
struct fib_info *fi,
u8 tos, u8 type,
u32 tb_id);
to add/delete IPv4 dst/dest_len prefix on table tb_id. The *fi structure holds SWITCHDEV_OBJ_IPV4_FIB object passes:
details on the route and route's nexthops. *dev is one of the port netdevs
mentioned in the routes next hop list. If the output port netdevs referenced struct switchdev_obj_ipv4_fib { /* IPV4_FIB */
in the route's nexthop list don't all have the same switch ID, the driver is u32 dst;
not called to add/delete the FIB entry. int dst_len;
struct fib_info *fi;
u8 tos;
u8 type;
u32 nlflags;
u32 tb_id;
} ipv4_fib;
to add/modify/delete IPv4 dst/dest_len prefix on table tb_id. The *fi
structure holds details on the route and route's nexthops. *dev is one of the
port netdevs mentioned in the routes next hop list. If the output port netdevs
referenced in the route's nexthop list don't all have the same switch ID, the
driver is not called to add/modify/delete the FIB entry.
Routes offloaded to the device are labeled with "offload" in the ip route Routes offloaded to the device are labeled with "offload" in the ip route
listing: listing:
@ -344,7 +349,7 @@ listing:
12.0.0.4 via 11.0.0.9 dev sw1p2 proto zebra metric 20 offload 12.0.0.4 via 11.0.0.9 dev sw1p2 proto zebra metric 20 offload
192.168.0.0/24 dev eth0 proto kernel scope link src 192.168.0.15 192.168.0.0/24 dev eth0 proto kernel scope link src 192.168.0.15
XXX: add/del IPv6 FIB API XXX: add/mod/del IPv6 FIB API
Nexthop Resolution Nexthop Resolution
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^

4
net/switchdev/switchdev.c
View file

@ -803,7 +803,7 @@ static struct net_device *switchdev_get_dev_by_nhs(struct fib_info *fi)
} }
/** /**
* switchdev_fib_ipv4_add - Add IPv4 route entry to switch * switchdev_fib_ipv4_add - Add/modify switch IPv4 route entry
* *
* @dst: route's IPv4 destination address * @dst: route's IPv4 destination address
* @dst_len: destination address length (prefix length) * @dst_len: destination address length (prefix length)
@ -813,7 +813,7 @@ static struct net_device *switchdev_get_dev_by_nhs(struct fib_info *fi)
* @nlflags: netlink flags passed in (NLM_F_*) * @nlflags: netlink flags passed in (NLM_F_*)
* @tb_id: route table ID * @tb_id: route table ID
* *
* Add IPv4 route entry to switch device. * Add/modify switch IPv4 route entry.
*/ */
int switchdev_fib_ipv4_add(u32 dst, int dst_len, struct fib_info *fi, int switchdev_fib_ipv4_add(u32 dst, int dst_len, struct fib_info *fi,
u8 tos, u8 type, u32 nlflags, u32 tb_id) u8 tos, u8 type, u32 nlflags, u32 tb_id)