编写设备驱动程序

GLDv3 功能

GLDv3 实现一种功能机制，允许框架查询和启用 GLDv3 驱动程序支持的功能。使用 mc_getcapab(9E) 入口点报告功能。如果驱动程序支持某种功能，请通过 mc_getcapab() 传递关于该功能的信息，例如特定于功能的入口点或标志。传递一个指向 mac_callback 结构中 mc_getcapab() 入口点的指针。有关 mac_callbacks 结构的更多信息，请参见GLDv3 MAC 注册数据结构。

boolean_t mc_getcapab(void *driver_handle, mac_capab_t cap, void *cap_data);

cap 参数指定所查询的功能类型。 cap 的值可以是 MAC_CAPAB_HCKSUM（硬件校验和负载转移）或 MAC_CAPAB_LSO（大段负载转移）。使用 cap_data 参数将功能数据返回框架。

如果驱动程序支持 cap 功能，则 mc_getcapab() 入口点必须返回 B_TRUE。如果驱动程序不支持 cap 功能，则 mc_getcapab() 必须返回 B_FALSE。

示例 19–5 `mc_getcapab()` 入口点

static boolean_t
xx_m_getcapab(void *arg, mac_capab_t cap, void *cap_data)
{
        switch (cap) {
        case MAC_CAPAB_HCKSUM: {
                uint32_t *txflags = cap_data;
                *txflags = HCKSUM_INET_FULL_V4 | HCKSUM_IPHDRCKSUM;
                break;
        }
        case MAC_CAPAB_LSO: {
                /* ... */
                break;
        }
        default:
                return (B_FALSE);
        }
        return (B_TRUE);
}

下面各节将介绍所支持的功能和需要返回的相应功能数据。

硬件校验和负载转移

为了获得关于硬件校验和负载转移支持的数据，框架将在 cap 参数中发送 MAC_CAPA _HCKSUM。请参见硬件校验和负载转移功能信息。

要在启用硬件校验和的情况下查询校验和负载转移元数据以及检索每个包的硬件校验和元数据，请使用 mac_hcksum_get(9F)。请参见mac_hcksum_get()() 函数标志。

要设置校验和负载转移元数据，请使用 mac_hcksum_set(9F)。请参见mac_hcksum_set()() 函数标志。

有关更多信息，请参见硬件校验和：硬件和硬件校验和：MAC 层。

硬件校验和负载转移功能信息

要将关于 MAC_CAPAB_HCKSUM 功能的信息传递给框架，驱动程序必须在指向 uint32_t 的 cap_data 中设置以下标志的组合。这些标志指明驱动程序能够为外发包执行的硬件校验和负载转移的级别。

HCKSUM_INET_PARTIAL: 1 的补码的部分校验和功能
HCKSUM_INET_FULL_V4: 针对 IPv4 包的 1 的补码的完全校验和能力
HCKSUM_INET_FULL_V6: 针对 IPv6 包的 1 的补码的完全校验和能力
HCKSUM_IPHDRCKSUM: IPv4 头校验和负载转移功能

`mac_hcksum_get()()` 函数标志

mac_hcksum_get() 的 flags 参数是以下值的组合：

HCK_FULLCKSUM: 计算此包的完整校验和。
HCK_FULLCKSUM_OK: 完整校验和已在硬件中通过验证，证实是正确的。
HCK_PARTIALCKSUM: 根据传递给 mac_hcksum_get() 的其他参数计算 1 的补码的部分校验和。HCK_PARTIALCKSUM 与 HCK_FULLCKSUM 互斥。
HCK_IPV4_HDRCKSUM: 计算 IP 报头校验和。
HCK_IPV4_HDRCKSUM_OK: IP 头校验和已在硬件中通过验证，证实是正确的。

`mac_hcksum_set()()` 函数标志

mac_hcksum_set 的 flags() 参数是以下值的组合：

HCK_FULLCKSUM: 通过 value 参数计算和传递完整校验和。
HCK_FULLCKSUM_OK: 完整校验和已在硬件中通过验证，证实是正确的。
HCK_PARTIALCKSUM: 通过 value 参数计算和传递部分校验和。HCK_PARTIALCKSUM 与 HCK_FULLCKSUM 互斥。
HCK_IPV4_HDRCKSUM: 通过 value 参数计算和传递 IP 头校验和。··
HCK_IPV4_HDRCKSUM_OK: IP 头校验和已在硬件中通过验证，证实是正确的。

大段（或发送）负载转移

为了查询大段（或发送）负载转移支持，框架将在 cap 参数中发送 MAC_CAPA _LSO，并等待接收在指向 mac_capab_lso(9S) 结构的 cap_data 中返回的信息。框架将分配 mac_capab_lso 结构，并在 cap_data 中传递指向此结构的指针。 mac_capab_lso 结构包含一个 lso_basic_tcp_ipv4(9S) 结构和一个 lso_flags 成员。如果驱动程序实例为 IPv4 上的 TCP 支持 LSO，请设置 lso_flags 中的 LSO_TX_BASIC_TCP_IPV4 标志，并将 lso_basic_tcp_ipv4 结构的 lso_max 成员设置为驱动程序实例支持的最大有效载荷大小。

使用 mac_lso_get(9F) 获得每个包的 LSO 元数据。如果为此包启用了 LSO，则将在 mac_lso_get () flags 参数中设置 HW_LSO 标志。在大段的分段过程中使用的最大段大小 (maximum segment size, MSS) 将通过 mss 参数指向的位置返回。有关更多信息，请参见大段负载转移。