Vietnamese (machine translation)

English

Lưu ý

Mục đích của file này là để độc giả tiếng Việt có thể đọc và hiểu tài liệu nhân kernel dễ dàng hơn, không phải để tạo ra một nhánh tài liệu riêng. Nếu bạn có bất kỳ nhận xét hoặc cập nhật nào cho file này, vui lòng thử cập nhật file tiếng Anh gốc trước. Nếu bạn thấy có sự khác biệt giữa bản dịch và bản gốc, hoặc có vấn đề về bản dịch, vui lòng gửi góp ý hoặc patch cho người dịch của file này, hoặc nhờ người bảo trì và người review tài liệu tiếng Việt giúp đỡ.

Bản gốc:: Devlink Trap
Người dịch:: Google Translate (machine translation)
Phiên bản gốc:: 8541d8f725c6

Cảnh báo

Tài liệu này được dịch tự động bằng máy và chưa được review bởi người dịch. Nội dung có thể không chính xác hoặc khó hiểu ở một số chỗ. Khi có sự khác biệt với bản gốc, bản gốc luôn là chuẩn. Bản dịch chất lượng cao (được review) được đặt trong thư mục vi_VN/.

Bẫy liên kết nhà phát triển¶

Lý lịch¶

Các thiết bị có khả năng giảm tải đường dẫn dữ liệu của kernel và thực hiện các chức năng như vì cầu nối và định tuyến cũng phải có khả năng gửi các gói cụ thể đến kernel (tức là CPU) để xử lý.

Ví dụ: một thiết bị hoạt động như một cầu nối nhận biết multicast phải có khả năng gửi Thành viên IGMP báo cáo cho kernel để mô-đun cầu nối xử lý. Nếu không xử lý các gói tin như vậy, mô-đun cầu nối sẽ không bao giờ có thể đưa vào MDB.

Một ví dụ khác, hãy xem xét một thiết bị đóng vai trò là bộ định tuyến đã nhận được địa chỉ IP gói có TTL là 1. Khi định tuyến gói, thiết bị phải gửi nó đến kernel để nó cũng sẽ định tuyến nó và tạo ra ICMP Đã vượt quá thời gian datagram lỗi. Không để kernel tự định tuyến các gói như vậy, các tiện ích chẳng hạn như ZZ0000ZZ không bao giờ có thể hoạt động được.

Khả năng cơ bản của việc gửi các gói nhất định đến kernel để xử lý được gọi là “bẫy gói”.

Tổng quan¶

Cơ chế ZZ0000ZZ cho phép các trình điều khiển thiết bị có khả năng đăng ký hỗ trợ bẫy gói với ZZ0001ZZ và báo cáo các gói bị mắc kẹt tới ZZ0002ZZ để phân tích thêm.

Khi nhận được các gói bị mắc kẹt, ZZ0001ZZ sẽ thực hiện việc xử lý các gói trên mỗi bẫy và tính toán byte và có khả năng báo cáo gói tin tới không gian người dùng thông qua liên kết mạng sự kiện cùng với tất cả siêu dữ liệu được cung cấp (ví dụ: lý do bẫy, dấu thời gian, thông tin đầu vào cổng). Điều này đặc biệt hữu ích cho bẫy thả (xem ZZ0000ZZ) vì nó cho phép người dùng có được khả năng hiển thị sâu hơn về các gói tin bị rơi nếu không thì vô hình.

Sơ đồ sau đây cung cấp cái nhìn tổng quan chung về ZZ0000ZZ:

Sự kiện Netlink: Gói có siêu dữ liệu

Hoặc bản tóm tắt về những lần giảm gần đây

Không gian người dùng |

hạt nhân |

ZZ0000ZZ ZZ0001ZZ ZZ0002ZZ +-------^--------+

Bẫy không kiểm soát

Đường dẫn Rx của hạt nhân ZZ0003ZZ ZZ0004ZZ (bẫy không thả) ZZ0005ZZ +----^----+ ^

ZZ0006ZZ +----------+ |

ZZ0007ZZ ZZ0008ZZ ZZ0009ZZ +-------^-------+

hạt nhân |

Phần cứng |

Gói bị mắc kẹt

ZZ0010ZZ ZZ0011ZZ ZZ0012ZZ +------+

Các loại bẫy¶

Cơ chế ZZ0000ZZ hỗ trợ các loại bẫy gói sau:

ZZ0001ZZ: Các gói bị mắc kẹt đã bị thiết bị bên dưới loại bỏ. Gói
chỉ được xử lý bởi ZZ0002ZZ và không được đưa vào đường dẫn Rx của kernel. Hành động bẫy (xem ZZ0000ZZ) có thể được thay đổi.
- ZZ0003ZZ: Các gói bị mắc kẹt không được chuyển tiếp như dự định thiết bị cơ bản do một ngoại lệ (ví dụ: lỗi TTL, thiếu hàng xóm entry) và bị giữ lại trong mặt phẳng điều khiển để giải quyết. Các gói được được xử lý bởi ZZ0004ZZ và đưa vào đường dẫn Rx của kernel. Thay đổi hành động của những cái bẫy như vậy là không được phép, vì nó có thể dễ dàng phá vỡ sự kiểm soát máy bay.
- ZZ0005ZZ: Các gói bị bẫy đã bị thiết bị giữ lại vì đây là các gói điều khiển cần thiết cho hoạt động chính xác của mặt phẳng điều khiển. Ví dụ: gói yêu cầu ARP và gói truy vấn IGMP. Các gói được đưa vào đường dẫn Rx của kernel, nhưng không được báo cáo cho trình giám sát thả của kernel. Không được phép thay đổi hoạt động của những cái bẫy như vậy vì nó có thể dễ dàng bị gãy. mặt phẳng điều khiển.

Hành động bẫy¶

Cơ chế ZZ0000ZZ hỗ trợ các hành động bẫy gói sau:

ZZ0000ZZ: Bản sao duy nhất của gói được gửi đến CPU. * ZZ0001ZZ: Gói tin bị thiết bị bên dưới bỏ đi và không có bản sao

được gửi đến CPU.
- ZZ0002ZZ: Gói được chuyển tiếp bởi thiết bị cơ bản và một bản sao được được gửi đến CPU.

Bẫy gói chung¶

Bẫy gói chung được sử dụng để mô tả các bẫy bẫy các gói được xác định rõ hoặc các gói bị kẹt do các điều kiện được xác định rõ (ví dụ: lỗi TTL). Những cái bẫy như vậy có thể được chia sẻ bởi nhiều trình điều khiển thiết bị và mô tả của chúng phải thêm vào bảng sau:

List of Generic Packet Traps¶
Name	Type	Description
`source_mac_is_multicast`	`drop`	Traps incoming packets that the device decided to drop because of a multicast source MAC
`vlan_tag_mismatch`	`drop`	Traps incoming packets that the device decided to drop in case of VLAN tag mismatch: The ingress bridge port is not configured with a PVID and the packet is untagged or prio-tagged
`ingress_vlan_filter`	`drop`	Traps incoming packets that the device decided to drop in case they are tagged with a VLAN that is not configured on the ingress bridge port
`ingress_spanning_tree_filter`	`drop`	Traps incoming packets that the device decided to drop in case the STP state of the ingress bridge port is not “forwarding”
`port_list_is_empty`	`drop`	Traps packets that the device decided to drop in case they need to be flooded (e.g., unknown unicast, unregistered multicast) and there are no ports the packets should be flooded to
`port_loopback_filter`	`drop`	Traps packets that the device decided to drop in case after layer 2 forwarding the only port from which they should be transmitted through is the port from which they were received
`blackhole_route`	`drop`	Traps packets that the device decided to drop in case they hit a blackhole route
`ttl_value_is_too_small`	`exception`	Traps unicast packets that should be forwarded by the device whose TTL was decremented to 0 or less
`tail_drop`	`drop`	Traps packets that the device decided to drop because they could not be enqueued to a transmission queue which is full
`non_ip`	`drop`	Traps packets that the device decided to drop because they need to undergo a layer 3 lookup, but are not IP or MPLS packets
`uc_dip_over_mc_dmac`	`drop`	Traps packets that the device decided to drop because they need to be routed and they have a unicast destination IP and a multicast destination MAC
`dip_is_loopback_address`	`drop`	Traps packets that the device decided to drop because they need to be routed and their destination IP is the loopback address (i.e., 127.0.0.0/8 and ::1/128)
`sip_is_mc`	`drop`	Traps packets that the device decided to drop because they need to be routed and their source IP is multicast (i.e., 224.0.0.0/8 and ff::/8)
`sip_is_loopback_address`	`drop`	Traps packets that the device decided to drop because they need to be routed and their source IP is the loopback address (i.e., 127.0.0.0/8 and ::1/128)
`ip_header_corrupted`	`drop`	Traps packets that the device decided to drop because they need to be routed and their IP header is corrupted: wrong checksum, wrong IP version or too short Internet Header Length (IHL)
`ipv4_sip_is_limited_bc`	`drop`	Traps packets that the device decided to drop because they need to be routed and their source IP is limited broadcast (i.e., 255.255.255.255/32)
`ipv6_mc_dip_reserved_scope`	`drop`	Traps IPv6 packets that the device decided to drop because they need to be routed and their IPv6 multicast destination IP has a reserved scope (i.e., ffx0::/16)
`ipv6_mc_dip_interface_local_scope`	`drop`	Traps IPv6 packets that the device decided to drop because they need to be routed and their IPv6 multicast destination IP has an interface-local scope (i.e., ffx1::/16)
`mtu_value_is_too_small`	`exception`	Traps packets that should have been routed by the device, but were bigger than the MTU of the egress interface
`unresolved_neigh`	`exception`	Traps packets that did not have a matching IP neighbour after routing
`mc_reverse_path_forwarding`	`exception`	Traps multicast IP packets that failed reverse-path forwarding (RPF) check during multicast routing
`reject_route`	`exception`	Traps packets that hit reject routes (i.e., “unreachable”, “prohibit”)
`ipv4_lpm_miss`	`exception`	Traps unicast IPv4 packets that did not match any route
`ipv6_lpm_miss`	`exception`	Traps unicast IPv6 packets that did not match any route
`non_routable_packet`	`drop`	Traps packets that the device decided to drop because they are not supposed to be routed. For example, IGMP queries can be flooded by the device in layer 2 and reach the router. Such packets should not be routed and instead dropped
`decap_error`	`exception`	Traps NVE and IPinIP packets that the device decided to drop because of failure during decapsulation (e.g., packet being too short, reserved bits set in VXLAN header)
`overlay_smac_is_mc`	`drop`	Traps NVE packets that the device decided to drop because their overlay source MAC is multicast
`ingress_flow_action_drop`	`drop`	Traps packets dropped during processing of ingress flow action drop
`egress_flow_action_drop`	`drop`	Traps packets dropped during processing of egress flow action drop
`stp`	`control`	Traps STP packets
`lacp`	`control`	Traps LACP packets
`lldp`	`control`	Traps LLDP packets
`igmp_query`	`control`	Traps IGMP Membership Query packets
`igmp_v1_report`	`control`	Traps IGMP Version 1 Membership Report packets
`igmp_v2_report`	`control`	Traps IGMP Version 2 Membership Report packets
`igmp_v3_report`	`control`	Traps IGMP Version 3 Membership Report packets
`igmp_v2_leave`	`control`	Traps IGMP Version 2 Leave Group packets
`mld_query`	`control`	Traps MLD Multicast Listener Query packets
`mld_v1_report`	`control`	Traps MLD Version 1 Multicast Listener Report packets
`mld_v2_report`	`control`	Traps MLD Version 2 Multicast Listener Report packets
`mld_v1_done`	`control`	Traps MLD Version 1 Multicast Listener Done packets
`ipv4_dhcp`	`control`	Traps IPv4 DHCP packets
`ipv6_dhcp`	`control`	Traps IPv6 DHCP packets
`arp_request`	`control`	Traps ARP request packets
`arp_response`	`control`	Traps ARP response packets
`arp_overlay`	`control`	Traps NVE-decapsulated ARP packets that reached the overlay network. This is required, for example, when the address that needs to be resolved is a local address
`ipv6_neigh_solicit`	`control`	Traps IPv6 Neighbour Solicitation packets
`ipv6_neigh_advert`	`control`	Traps IPv6 Neighbour Advertisement packets
`ipv4_bfd`	`control`	Traps IPv4 BFD packets
`ipv6_bfd`	`control`	Traps IPv6 BFD packets
`ipv4_ospf`	`control`	Traps IPv4 OSPF packets
`ipv6_ospf`	`control`	Traps IPv6 OSPF packets
`ipv4_bgp`	`control`	Traps IPv4 BGP packets
`ipv6_bgp`	`control`	Traps IPv6 BGP packets
`ipv4_vrrp`	`control`	Traps IPv4 VRRP packets
`ipv6_vrrp`	`control`	Traps IPv6 VRRP packets
`ipv4_pim`	`control`	Traps IPv4 PIM packets
`ipv6_pim`	`control`	Traps IPv6 PIM packets
`uc_loopback`	`control`	Traps unicast packets that need to be routed through the same layer 3 interface from which they were received. Such packets are routed by the kernel, but also cause it to potentially generate ICMP redirect packets
`local_route`	`control`	Traps unicast packets that hit a local route and need to be locally delivered
`external_route`	`control`	Traps packets that should be routed through an external interface (e.g., management interface) that does not belong to the same device (e.g., switch ASIC) as the ingress interface
`ipv6_uc_dip_link_local_scope`	`control`	Traps unicast IPv6 packets that need to be routed and have a destination IP address with a link-local scope (i.e., fe80::/10). The trap allows device drivers to avoid programming link-local routes, but still receive packets for local delivery
`ipv6_dip_all_nodes`	`control`	Traps IPv6 packets that their destination IP address is the “All Nodes Address” (i.e., ff02::1)
`ipv6_dip_all_routers`	`control`	Traps IPv6 packets that their destination IP address is the “All Routers Address” (i.e., ff02::2)
`ipv6_router_solicit`	`control`	Traps IPv6 Router Solicitation packets
`ipv6_router_advert`	`control`	Traps IPv6 Router Advertisement packets
`ipv6_redirect`	`control`	Traps IPv6 Redirect Message packets
`ipv4_router_alert`	`control`	Traps IPv4 packets that need to be routed and include the Router Alert option. Such packets need to be locally delivered to raw sockets that have the IP_ROUTER_ALERT socket option set
`ipv6_router_alert`	`control`	Traps IPv6 packets that need to be routed and include the Router Alert option in their Hop-by-Hop extension header. Such packets need to be locally delivered to raw sockets that have the IPV6_ROUTER_ALERT socket option set
`ptp_event`	`control`	Traps PTP time-critical event messages (Sync, Delay_req, Pdelay_Req and Pdelay_Resp)
`ptp_general`	`control`	Traps PTP general messages (Announce, Follow_Up, Delay_Resp, Pdelay_Resp_Follow_Up, management and signaling)
`flow_action_sample`	`control`	Traps packets sampled during processing of flow action sample (e.g., via tc’s sample action)
`flow_action_trap`	`control`	Traps packets logged during processing of flow action trap (e.g., via tc’s trap action)
`early_drop`	`drop`	Traps packets dropped due to the RED (Random Early Detection) algorithm (i.e., early drops)
`vxlan_parsing`	`drop`	Traps packets dropped due to an error in the VXLAN header parsing which might be because of packet truncation or the I flag is not set.
`llc_snap_parsing`	`drop`	Traps packets dropped due to an error in the LLC+SNAP header parsing
`vlan_parsing`	`drop`	Traps packets dropped due to an error in the VLAN header parsing. Could include unexpected packet truncation.
`pppoe_ppp_parsing`	`drop`	Traps packets dropped due to an error in the PPPoE+PPP header parsing. This could include finding a session ID of 0xFFFF (which is reserved and not for use), a PPPoE length which is larger than the frame received or any common error on this type of header
`mpls_parsing`	`drop`	Traps packets dropped due to an error in the MPLS header parsing which could include unexpected header truncation
`arp_parsing`	`drop`	Traps packets dropped due to an error in the ARP header parsing
`ip_1_parsing`	`drop`	Traps packets dropped due to an error in the first IP header parsing. This packet trap could include packets which do not pass an IP checksum check, a header length check (a minimum of 20 bytes), which might suffer from packet truncation thus the total length field exceeds the received packet length etc
`ip_n_parsing`	`drop`	Traps packets dropped due to an error in the parsing of the last IP header (the inner one in case of an IP over IP tunnel). The same common error checking is performed here as for the ip_1_parsing trap
`gre_parsing`	`drop`	Traps packets dropped due to an error in the GRE header parsing
`udp_parsing`	`drop`	Traps packets dropped due to an error in the UDP header parsing. This packet trap could include checksum errors, an improper UDP length detected (smaller than 8 bytes) or detection of header truncation.
`tcp_parsing`	`drop`	Traps packets dropped due to an error in the TCP header parsing. This could include TCP checksum errors, improper combination of SYN, FIN and/or RESET etc.
`ipsec_parsing`	`drop`	Traps packets dropped due to an error in the IPSEC header parsing
`sctp_parsing`	`drop`	Traps packets dropped due to an error in the SCTP header parsing. This would mean that port number 0 was used or that the header is truncated.
`dccp_parsing`	`drop`	Traps packets dropped due to an error in the DCCP header parsing
`gtp_parsing`	`drop`	Traps packets dropped due to an error in the GTP header parsing
`esp_parsing`	`drop`	Traps packets dropped due to an error in the ESP header parsing
`blackhole_nexthop`	`drop`	Traps packets that the device decided to drop in case they hit a blackhole nexthop
`dmac_filter`	`drop`	Traps incoming packets that the device decided to drop because the destination MAC is not configured in the MAC table and the interface is not in promiscuous mode
`eapol`	`control`	Traps “Extensible Authentication Protocol over LAN” (EAPOL) packets specified in IEEE 802.1X
`locked_port`	`drop`	Traps packets that the device decided to drop because they failed the locked bridge port check. That is, packets that were received via a locked port and whose {SMAC, VID} does not correspond to an FDB entry pointing to the port

Bẫy gói dành riêng cho trình điều khiển¶

Trình điều khiển thiết bị có thể đăng ký bẫy gói dành riêng cho trình điều khiển, nhưng chúng phải được có tài liệu rõ ràng. Những cái bẫy như vậy có thể tương ứng với các trường hợp ngoại lệ dành riêng cho thiết bị và giúp gỡ lỗi các gói bị rớt do những ngoại lệ này gây ra. Danh sách sau đây bao gồm liên kết đến mô tả bẫy dành riêng cho trình điều khiển được đăng ký bởi nhiều thiết bị khác nhau trình điều khiển:

Tài liệu/mạng/devlink/netdevsim.rst * Tài liệu/mạng/devlink/mlxsw.rst * Tài liệu/mạng/devlink/prestera.rst

Nhóm bẫy gói chung¶

Các nhóm bẫy gói chung được sử dụng để tổng hợp các gói liên quan đến logic bẫy. Các nhóm này cho phép người dùng thực hiện các thao tác hàng loạt như đặt bẫy hành động của tất cả các bẫy thành viên. Ngoài ra, ZZ0000ZZ có thể báo cáo tổng hợp số liệu thống kê về gói và byte trên mỗi nhóm, trong trường hợp số liệu thống kê trên mỗi bẫy quá hẹp. Mô tả của các nhóm này phải được thêm vào bảng sau:

List of Generic Packet Trap Groups¶
Name	Description
`l2_drops`	Contains packet traps for packets that were dropped by the device during layer 2 forwarding (i.e., bridge)
`l3_drops`	Contains packet traps for packets that were dropped by the device during layer 3 forwarding
`l3_exceptions`	Contains packet traps for packets that hit an exception (e.g., TTL error) during layer 3 forwarding
`buffer_drops`	Contains packet traps for packets that were dropped by the device due to an enqueue decision
`tunnel_drops`	Contains packet traps for packets that were dropped by the device during tunnel encapsulation / decapsulation
`acl_drops`	Contains packet traps for packets that were dropped by the device during ACL processing
`stp`	Contains packet traps for STP packets
`lacp`	Contains packet traps for LACP packets
`lldp`	Contains packet traps for LLDP packets
`mc_snooping`	Contains packet traps for IGMP and MLD packets required for multicast snooping
`dhcp`	Contains packet traps for DHCP packets
`neigh_discovery`	Contains packet traps for neighbour discovery packets (e.g., ARP, IPv6 ND)
`bfd`	Contains packet traps for BFD packets
`ospf`	Contains packet traps for OSPF packets
`bgp`	Contains packet traps for BGP packets
`vrrp`	Contains packet traps for VRRP packets
`pim`	Contains packet traps for PIM packets
`uc_loopback`	Contains a packet trap for unicast loopback packets (i.e., `uc_loopback`). This trap is singled-out because in cases such as one-armed router it will be constantly triggered. To limit the impact on the CPU usage, a packet trap policer with a low rate can be bound to the group without affecting other traps
`local_delivery`	Contains packet traps for packets that should be locally delivered after routing, but do not match more specific packet traps (e.g., `ipv4_bgp`)
`external_delivery`	Contains packet traps for packets that should be routed through an external interface (e.g., management interface) that does not belong to the same device (e.g., switch ASIC) as the ingress interface
`ipv6`	Contains packet traps for various IPv6 control packets (e.g., Router Advertisements)
`ptp_event`	Contains packet traps for PTP time-critical event messages (Sync, Delay_req, Pdelay_Req and Pdelay_Resp)
`ptp_general`	Contains packet traps for PTP general messages (Announce, Follow_Up, Delay_Resp, Pdelay_Resp_Follow_Up, management and signaling)
`acl_sample`	Contains packet traps for packets that were sampled by the device during ACL processing
`acl_trap`	Contains packet traps for packets that were trapped (logged) by the device during ACL processing
`parser_error_drops`	Contains packet traps for packets that were marked by the device during parsing as erroneous
`eapol`	Contains packet traps for “Extensible Authentication Protocol over LAN” (EAPOL) packets specified in IEEE 802.1X

Cảnh sát bẫy gói¶

Như đã giải thích trước đây, thiết bị cơ bản có thể bẫy các gói nhất định vào CPU để xử lý. Trong hầu hết các trường hợp, thiết bị cơ bản có khả năng xử lý tốc độ gói cao hơn vài bậc so với tốc độ gói có thể được xử lý bởi CPU.

Do đó, để ngăn thiết bị cơ bản lấn át CPU, các thiết bị thường bao gồm các cảnh sát bẫy gói có khả năng cảnh sát các gói bị mắc kẹt ở mức mà CPU có thể xử lý.

Cơ chế ZZ0001ZZ cho phép các trình điều khiển thiết bị có khả năng đăng ký hỗ trợ cảnh sát bẫy gói với ZZ0002ZZ. Trình điều khiển thiết bị có thể chọn để liên kết các cảnh sát này với các nhóm bẫy gói được hỗ trợ (xem ZZ0000ZZ) trong quá trình khởi tạo, do đó làm lộ ra chính sách mặt phẳng điều khiển mặc định của nó đối với không gian người dùng.

Trình điều khiển thiết bị nên cho phép không gian người dùng thay đổi các thông số của cảnh sát (ví dụ: tốc độ, kích thước cụm) cũng như sự liên kết giữa cảnh sát và nhóm bẫy bằng cách thực hiện các cuộc gọi lại có liên quan.

Nếu có thể, trình điều khiển thiết bị nên triển khai lệnh gọi lại để cho phép không gian người dùng để lấy lại số lượng gói tin đã bị cảnh sát đánh rơi vì nó chính sách được cấu hình đã bị vi phạm.

Kiểm tra¶

Xem ZZ0000ZZ để biết thử nghiệm bao phủ cơ sở hạ tầng cốt lõi. Các trường hợp thử nghiệm nên được thêm vào cho bất kỳ trường hợp mới nào chức năng.

Trình điều khiển thiết bị nên tập trung kiểm tra chức năng dành riêng cho thiết bị, chẳng hạn như như kích hoạt các bẫy gói được hỗ trợ.

Nhân Linux

Mục lục

Trang này