refactor(knet): move link configuration ownership into devices · Pull Request !626 · openKylin（孵化期）/x-kernel

## 概述

本 PR 将链路（link）配置的所有权从 rtnetlink 控制面迁移到设备层（`NetDevice`）。接口名、MTU、管理 up 状态、operstate 与硬件地址统一由设备持有，并通过 `LinkSnapshot` 导出；`RTM_GETLINK`、`RTM_NEWLINK`、AF_PACKET 与路由 MTU 查询全部直接读写设备状态，从而删除 `RtnetlinkState` 中的 link mirror，同时保留地址、路由和邻居原有的控制面同步路径。

## 主要变更

### 设备层（`net/knet/src/device`）

- `NetDevice` trait 新增 `link_kind`、`mtu`、`is_link_up`、`link_snapshot`、`link_send_snapshot`、`set_name`、`set_mtu`、`set_link_up`；`sync_netlink` 收窄为仅同步地址与邻居。
- 新增 `LinkKind`（含 `validate_mtu`）、`LinkSnapshot`、`LinkSendSnapshot`、`LinkConfigUpdate`、`validate_interface_name` 以及 `LINK_FLAG_*`、`IF_OPER_*` 常量。
- `EthernetDevice` 与 `LoopbackDevice` 构造时建立初始 link 状态；收发路径按当前 up 状态与 MTU 过滤，link down 时停止收发（Ethernet `send_link_frame` 返回 `ENETDOWN`），超 MTU 报文直接丢弃。

### 控制面（`net/knet/src/netlink`）

- 删除 `RtnetlinkState::links`、`LinkState`、`link_state_for_ifindex` 与 `IFF_*` 常量。
- `RTM_GETLINK` 改为在 `SERVICE` 锁内读取设备实时 `LinkSnapshot` 生成 dump（`family=0`、`change=0`，不再输出 `IFLA_LINK` 属性）。
- `RTM_NEWLINK` 经 `Service::update_device_link` → `Router::update_device_link` 写入目标设备；写入前整组校验接口名格式（`EINVAL`）、名称唯一性（`EEXIST`）、MTU 范围（`EINVAL`）与 flags。`IFF_VOLATILE` 派生位按 Linux 语义保留，实际改变的未支持可写位返回 `EOPNOTSUPP`，避免部分提交。
- `build_initial_state` 不再构造 link，link 初始状态由设备构造器建立；地址/路由/邻居 mutation 的 `ensure_link_exists` 改为查询设备快照，并在取得 `SERVICE` 前释放 `ROUTE_STATE` 写锁。

### 数据面（`net/knet/src/stack`）

- 路由 MTU 改为从匹配路由指向的设备读取；link down 时 MTU 查询仍返回设备配置值，UDP 与 raw IPv4 在提交报文前返回 `ENETUNREACH`，设备收发路径继续保留 up 状态守卫。
- `Router` 新增 `effective_mtu`（各设备 MTU 的最小值），作为 smoltcp `DeviceCapabilities` 的 MTU；设备配置或运行时移除改变有效 MTU 时通过 `Service::rebuild_interface` 重建 smoltcp `Interface`。

### AF_PACKET 与文档

- packet socket 在单次 `SERVICE` 锁临界区内读取无分配 `LinkSendSnapshot`、校验 up 与 MTU、填充 datagram 源 MAC 并发送。
- 同步更新 `design.md` 与 `security.md`，补充 link 所有权边界、新增威胁与失效场景条目（如 T-25、F-09）。

## Diagram Walkthrough

以下流程图展示了本次变更的核心数据流（查询、变更与同步路径）：

```mermaid
flowchart TD
    %% ===== 控制面查询路径 =====
    GETLINK["RTM_GETLINK 请求"]
    PACKET["AF_PACKET 发送"]
    MTUQUERY["路由 MTU 查询"]
    SERVICE["Service（SERVICE 锁）"]
    ROUTER["Router"]
    DEVICE["NetDevice（link owner）"]
    SNAPSHOT["实时 LinkSnapshot"]

%% ===== 控制面变更路径 =====
    NEWLINK["RTM_NEWLINK 请求"]
    VALIDATE["整组校验名称/MTU/flags"]
    REBUILD["重建 smoltcp Interface"]

%% ===== 地址、路由、邻居投影 =====
    ROUTE_STATE["RtnetlinkState（地址/路由/邻居）"]

GETLINK --> SERVICE
    PACKET --> SERVICE
    MTUQUERY --> SERVICE
    SERVICE --> ROUTER
    ROUTER --> DEVICE
    DEVICE --> SNAPSHOT

NEWLINK --> SERVICE
    SERVICE --> VALIDATE
    VALIDATE --> DEVICE
    SERVICE -- "有效 MTU 变更" --> REBUILD

ROUTE_STATE -- "sync_netlink 同步地址与邻居" --> SERVICE
```

## 新增功能

- `RTM_NEWLINK` 支持修改接口名、MTU 与 up/down 状态，并在写入前完成整组校验。
- 设备 link down 时收发路径立即生效，UDP 与 raw IPv4 返回 `ENETUNREACH`；loopback 新增 MTU 检查。
- 新增测试：link dump 读取设备实时快照、非法复合更新整组拒绝、全位 `ifi_change` 兼容、down 设备发送返回 `ENETUNREACH`、有效 MTU 未变化时保留 Interface、设备移除改变有效 MTU 时重建 Interface。

## 破坏性变更

- `RTM_NEWLINK` 携带不受支持的 attribute（如 `IFLA_ADDRESS`）或实际改变未支持的可写 flag（如 `IFF_MULTICAST`）时返回 `EOPNOTSUPP`；`IFF_RUNNING`、`IFF_LOWER_UP`、`IFF_LOOPBACK` 等派生位按 `IFF_VOLATILE` 语义保留。
- link dump 不再包含 `IFLA_LINK` 属性，`family` 改为 `0`、`change` 改为 `0`。
- `NetDevice` trait 接口变更，`sync_netlink` 签名调整（crate 内部接口）。

## 验证

- `cargo +nightly-2026-03-08 fmt --all`
- `make build`
- `make clippy`
- `make unittest UNITTEST_CRATE=knet`，158 项通过

`make doc_check_missing` 运行到仓库既有的 `util/kiface/test_crates/impl-simple-interfaces`、`boot/x86-boot-common`、`core/ktracing` 和 `drivers/pci` missing-docs 错误后停止，本次 `knet` 路径未产生 missing-docs 报错。

类型	指派人员	状态
审查	Debin 郭伟康已审查通过王1宁于博	已完成 (1/1人)
测试	王1宁已测试通过 x-cibot 已测试通过	已完成 (2/1人)

openKylin（孵化期） / x-kernel .gitee-modal { width: 500px !important; }

搜索帮助

openKylin（孵化期） / x-kernel