添加函数注释-DPDK中文网

当然可以！以下是 set_raw_socket_ttl 函数的完整代码，包含了函数的注释，以解释其功能、参数和返回值：

/**
 * 设置原始套接字的生存时间（TTL）值。
 *
 * @param fd 套接字描述符，用于设置 TTL 的目标套接字。
 * @param family 地址族，支持 AF_INET（IPv4）和 AF_INET6（IPv6）。
 * @param ttl 要设置的 TTL 值。有效范围为 0 到 255。
 *
 * @return 成功时返回 0，失败时返回 -1，并通过 perror 输出错误信息。
 *
 * 此函数根据指定的地址族使用 setsockopt 来设置给定套接字的 TTL 值。
 * 对于 IPv4 套接字，它将使用 IP_TTL 选项；对于 IPv6 套接字，则使用 IPV6_UNICAST_HOPS 选项。
 */
int set_raw_socket_ttl(evutil_socket_t fd, int family, int ttl) {
  
  // 检查地址族是否为 IPv6
  if (family == AF_INET6) {
#if !defined(IPV6_UNICAST_HOPS)
    // 如果未定义 IPV6_UNICAST_HOPS，忽略 fd 和 ttl 参数
    UNUSED_ARG(fd);
    UNUSED_ARG(ttl);
#else
    // 校正 TTL 值，以确保其在有效范围内（0-255）
    CORRECT_RAW_TTL(ttl);

    // 使用 setsockopt 设置 IPv6 套接字的 HOPLIMIT（TTL）
    if (setsockopt(fd, IPPROTO_IPV6, IPV6_UNICAST_HOPS, (const void *)&ttl, sizeof(ttl)) < 0) {
      perror("set HOPLIMIT on socket"); // 输出错误信息
      return -1; // 返回错误代码
    }
#endif
  } else {
#if !defined(IP_TTL)
    // 如果未定义 IP_TTL，忽略 fd 和 ttl 参数
    UNUSED_ARG(fd);
    UNUSED_ARG(ttl);
#else
    // 校正 TTL 值，以确保其在有效范围内（0-255）
    CORRECT_RAW_TTL(ttl);

    // 使用 setsockopt 设置 IPv4 套接字的 TTL 
    if (setsockopt(fd, IPPROTO_IP, IP_TTL, (const void *)&ttl, sizeof(ttl)) < 0) {
      perror("set TTL on socket"); // 输出错误信息
      return -1; // 返回错误代码
    }
#endif
  }

  return 0; // 返回成功代码
}