【C语言】Infiniband驱动mlx4_init_one

最新推荐文章于 2024-03-29 09:09:16 发布
最新推荐文章于 2024-03-29 09:09:16 发布
阅读量686 收藏 5
点赞数 12
分类专栏： 编程 # C语言 网络 文章标签： linux
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/eidolon_foot/article/details/136419110
版权
编程 同时被 3 个专栏收录
279 篇文章 3 订阅
订阅专栏
C语言
173 篇文章 1 订阅
订阅专栏
网络
75 篇文章 1 订阅
订阅专栏

一、注释

这是Linux内核中Mellanox Ethernet网卡驱动程序mlx4模块的一部分代码，主要用于初始化一个PCI设备。以下是其注释：

// 驱动的主结构体，包含了供PCI核心使用的勾子（hooks）
static struct pci_driver mlx4_driver = {
    .name        = DRV_NAME,                 // 驱动名称
    .id_table    = mlx4_pci_table,          // 支持的PCI设备ID表
    .probe        = mlx4_init_one,           // 初始化一个PCI设备时调用的函数
    .shutdown    = mlx4_shutdown,           // 关闭设备时调用的函数
    .remove        = mlx4_remove_one,         // 移除设备时调用的函数
    .suspend    = mlx4_suspend,            // 暂停设备时调用的函数
    .resume        = mlx4_resume,             // 恢复设备时调用的函数
    .err_handler    = &mlx4_err_handler,      // 错误处理程序（一些PCI错误处理函数）
};

// 初始化PCI设备的函数
static int mlx4_init_one(struct pci_dev *pdev, const struct pci_device_id *id)
{
    // 下面的宏定义是用来处理不同内核版本之间的兼容性问题

#ifdef HAVE_DEVLINK_H
    struct devlink *devlink;
#endif
    struct mlx4_priv *priv;
    struct mlx4_dev *dev;
    int ret;

    printk_once(KERN_INFO "%s", mlx4_version);  // 打印驱动版本信息

#ifdef HAVE_DEVLINK_H
    // devlink相关的初始化。如果支持devlink，则使用devlink相应的API分配内存以及初始化
    ...
    priv = devlink_priv(devlink);
#else
    priv = kzalloc(sizeof(*priv), GFP_KERNEL);  // 分配内存
    if (!priv)
        return -ENOMEM;  // 如果内存分配失败，则返回错误
#endif
    dev       = &priv->dev;
    dev->persist = kzalloc(sizeof(*dev->persist), GFP_KERNEL);  // 分配持久化的设备结构
    if (!dev->persist) {
        // 如果分配失败，执行相应的清理工作然后返回错误
        ...
    }
    dev->persist->pdev = pdev;
    dev->persist->dev = dev;
    pci_set_drvdata(pdev, dev->persist);  // 设置PCI设备的驱动程序数据

    priv->pci_dev_data = id->driver_data;  // 设置设备私有数据
    // 初始化互斥锁
    mutex_init(&dev->persist->device_state_mutex);
    mutex_init(&dev->persist->interface_state_mutex);
    mutex_init(&dev->persist->pci_status_mutex);

#ifdef HAVE_DEVLINK_H
    // 如果支持devlink，则继续进行devlink的设置和注册
    ...
#endif

    ret =  __mlx4_init_one(pdev, id->driver_data, priv);  // 调用内部初始化函数
#ifdef HAVE_DEVLINK_H
    // 处理可能的devlink初始化错误，并注册devlink参数
    ...
#endif

    if (ret) {
        // 如果有错误发生，进行清理工作
        ...
    } else {
        pci_save_state(pdev);  // 保存PCI设备状态
    }

#ifdef HAVE_DEVLINK_H
    // 如果支持devlink，处理错误时的清理工作
    ...
#endif
    return ret;  // 返回初始化结果，成功或失败的错误码
}

以上代码是在内核代码中的一个PCI驱动程序的初始化函数。在该函数中，驱动程序初始化PCI设备并为其分配必要的资源（比如内存）。如果启用了`devlink`配置选项（用于一些设备的配置和监控功能），它会额外处理`devlink`相关的注册和初始化。该函数最后将返回一个错误码，表示初始化操作的成功或失败状态。

完整代码的中文注释：

// 驱动的主结构体，包含了供PCI核心使用的勾子（hooks）
static struct pci_driver mlx4_driver = {
    .name        = DRV_NAME,                   // 驱动名称
    .id_table    = mlx4_pci_table,             // 支持的PCI设备ID表
    .probe        = mlx4_init_one,              // 初始化一个PCI设备时调用的函数
    .shutdown    = mlx4_shutdown,              // 关闭设备时调用的函数
    .remove        = mlx4_remove_one,            // 移除设备时调用的函数
    .suspend    = mlx4_suspend,               // 暂停设备时调用的函数
    .resume        = mlx4_resume,                // 恢复设备时调用的函数
    .err_handler    = &mlx4_err_handler,         // 错误处理程序（一些PCI错误处理函数）
};
// 初始化一个PCI设备的函数
static int mlx4_init_one(struct pci_dev *pdev, const struct pci_device_id *id)
{
#ifdef HAVE_DEVLINK_H
    struct devlink *devlink;
#endif
    struct mlx4_priv *priv;
    struct mlx4_dev *dev;
    int ret;
    // 仅打印一次驱动版本信息
    printk_once(KERN_INFO "%s", mlx4_version);
#ifdef HAVE_DEVLINK_H
    // 根据编译时的设置，以不同的方式分配并初始化devlink
#ifdef HAVE_DEVLINK_ALLOC_GET_3_PARAMS
    devlink = devlink_alloc(&mlx4_devlink_ops, sizeof(*priv), &pdev->dev);
#else
    devlink = devlink_alloc(&mlx4_devlink_ops, sizeof(*priv));
#endif
    if (!devlink)
        return -ENOMEM;   // 内存分配失败时返回错误
    priv = devlink_priv(devlink); // 从devlink得到私有结构体的引用
#else
    priv = kzalloc(sizeof(*priv), GFP_KERNEL); // 在没有devlink的情况下分配内存
    if (!priv)
        return -ENOMEM;   // 内存分配失败时返回错误
#endif
    dev = &priv->dev;
    dev->persist = kzalloc(sizeof(*dev->persist), GFP_KERNEL); // 分配持久化设备结构
    if (!dev->persist) {
#ifdef HAVE_DEVLINK_H
        ret = -ENOMEM;
        goto err_devlink_free;   // 在devlink设置中，如果内存分配失败则跳转到相应清理环节
#else
        kfree(priv);            // 在非devlink设置中清理分配的内存
        return -ENOMEM;
#endif
    }
    // 初始化pdev和dev之间的引用
    dev->persist->pdev = pdev;
    dev->persist->dev = dev;
    pci_set_drvdata(pdev, dev->persist);     // 将持久化的dev结构与pci设备关联起来
    priv->pci_dev_data = id->driver_data;    // 设置设备特定的数据
    // 初始化多个mutex
    mutex_init(&dev->persist->device_state_mutex);
    mutex_init(&dev->persist->interface_state_mutex);
    mutex_init(&dev->persist->pci_status_mutex);
#ifdef HAVE_DEVLINK_H
    // 如果支持devlink，根据编译时的配置注册devlink实例
#ifdef HAVE_DEVLINK_REGISTER_GET_1_PARAMS
    devlink_register(devlink);
#else
    ret = devlink_register(devlink, &pdev->dev);
    if (ret)
        goto err_persist_free;  // 注册失败时清理并返回
#endif
#if defined(HAVE_DEVLINK_PARAM) && defined(HAVE_DEVLINK_PARAMS_PUBLISHED)
    // 如果支持devlink参数，注册设备的参数
    ret = devlink_params_register(devlink, mlx4_devlink_params,
                      ARRAY_SIZE(mlx4_devlink_params));
    if (ret)
        goto err_devlink_unregister;  // 注册失败时清理并返回
    // 设置初始化时的参数值
    mlx4_devlink_set_params_init_values(devlink);
#endif
#endif
    ret =  __mlx4_init_one(pdev, id->driver_data, priv);  // 调用内部的初始化函数
    if (ret) {
        goto err_handling;  // 如果初始化失败，处理错误
    }
#ifdef HAVE_DEVLINK_H
#if defined(HAVE_DEVLINK_PARAM) && defined(HAVE_DEVLINK_PARAMS_PUBLISHED)
    // 如果支持devlink参数并且已经发布，发布参数设置
#ifdef HAVE_DEVLINK_PARAMS_PUBLISHED
    devlink_params_publish(devlink);
#endif
#ifdef HAVE_DEVLINK_RELOAD_ENABLE
    // 如果支持devlink重载，使能devlink的重载操作
    devlink_reload_enable(devlink);
#endif
#endif
#endif
    pci_save_state(pdev);   // 保存当前的PCI设备状态，这样在需要恢复设备时（比如从挂起状态恢复时）可以用到
    return 0;               // 返回0表示成功
#ifdef HAVE_DEVLINK_H
#if defined(HAVE_DEVLINK_PARAM) && defined(HAVE_DEVLINK_PARAMS_PUBLISHED)
    // 如果支持devlink参数和发布功能，以下是失败时的清理过程
err_params_unregister:
    // 取消注册之前注册的devlink参数
    devlink_params_unregister(devlink, mlx4_devlink_params,
                  ARRAY_SIZE(mlx4_devlink_params));
#endif
    // 错误处理部分：如果devlink注册失败，则取消注册
err_devlink_unregister:
    devlink_unregister(devlink);
#ifndef HAVE_DEVLINK_REGISTER_GET_1_PARAMS
    // 如果出现错误且版本不支持单参数devlink注册，则需要释放持久化设备结构内存
err_persist_free:
#endif
    kfree(dev->persist);  // 释放持久化设备结构内存
    // 如果devlink分配失败，则执行以下代码来释放内存
err_devlink_free:
    devlink_free(devlink);  // 释放devlink结构体所占用的内存
#endif
    return ret;  // 返回错误码。如果初始化过程中的某个步骤失败，则返回相应的错误码
}

上面的 pci_save_state(pdev) 函数调用负责保存当前PCI设备的核心配置寄存器。这在系统休眠或PCI设备电源管理事件中是必要的，因为在这样的事件中，设备的PCI配置可能会丢失或被重置，系统在恢复时需要这信息重新对设备进行配置。

return 0; 表明函数执行成功，返回值0符合Linux内核中处理成功操作的返回值约定。在C语言中，返回状态通常使用整形返回，而0通常表示成功，非0值表示某种形式的错误。

备注：此代码段涉及到了错误处理和内存清理部分。在初始化一个PCI设备时，如果过程中遇到错误，代码会跳转到相应的错误处理标签进行清理。这些清理工作可能包括注销注册的devlink参数、释放分配的内存、取消注册devlink设备等，以确保在发生错误时不会泄露资源。一旦完成清理，函数将返回一个表示错误状态的负值错误码。如果初始化成功，代码则将保存PCI设备的状态，并且返回0表示初始化成功。

二、讲解

这段代码主体是一个`mlx4_init_one`函数，它是Mellanox公司网络设备驱动的初始化函数，用于对PCI网络设备进行初始化。这段代码来自Linux内核的Mellanox网络驱动，其中的`mlx4_driver`结构体是PCI驱动的注册信息。`mlx4_init_one`函数是在PCI设备开始初始化时由内核调用的。函数主体涉及资源分配、设备注册和错误处理。
代码以及注释的大致意思如下：
- mlx4_driver：一个PCI驱动结构体，提供驱动的基本信息和回调函数。
- mlx4_init_one：驱动的初始化函数，它会针对每个被发现的PCI设备被调用。
  - 输出一次版本信息到内核日志。
  - 分配`devlink`资源，作为网络设备到devlink层的接口。
  - 分配`mlx4_priv`结构体以存储私有数据。
  - 分配`mlx4_dev`结构体中的`persist`字段，存储设备持续性状态。
  - 设置PCI设备与驱动数据的关联。
  - 初始化一些互斥锁，保护设备状态和PCI状态。
  - 在devlink层注册该设备，以及设备参数。
  - 调用`__mlx4_init_one`进行进一步的设备初始化工作。
  - 最后，保存PCI设备的状态以便恢复时使用。
- 如果初始化失败，函数会逐步释放已分配的资源，并且返回错误代码。
这段代码展示了复杂PCI设备驱动初始化流程的一部分，包括资源的分配和初始化，以及设备在系统内的注册。如果在初始化过程中遇到任何错误，它会回滚已经执行的步骤，释放资源，确保系统稳定。

109702008
关注
  • 12
    点赞
  • 踩
  • 5
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
ipz_pt_fn.rar_驱动编程_Unix_Linux_
08-11
IBM eServer eHCA Infiniband device driver for Linux on POWER.
【C语言】Infiniband驱动__mlx4_init_one函数
数字人生
03-26 1102
8. 错误处理：一系列的错误处理标签（`err_catas`，`err_crdump`，`err_release_regions`，`err_disable_pdev`），分别对应不同阶段的初始化失败处理，包括释放资源和禁用设备等。4. 检查通过`num_vfs`和`probe_vf`模块参数指定的VF数量的有效性，它们必须是非负的，并且`probe_vf`不能超过`num_vfs`指定的值。2. 函数尝试使PCI设备可用（`mlx4_pci_enable_device`），并检查是否成功。
【C语言】Infiniband驱动mlx4_cmd_init
最新发布
数字人生
03-29 712
dma_alloc_coherent 是 Linux 内核中的一个函数，用于分配一块连续的物理内存，并确保该内存区域对 DMA（Direct Memory Access）操作以及 CPU 都是可见的。3. 非换出内存：使用 GFP_KERNEL 标志分配的内存是非换出的（non-swappable），这对于 DMA 必不可少，因为 DMA 地址必须始终有效，不能被换出到磁盘。具体到`dma_pool_create`函数，它会创建一个内存池，使得驱动程序可以从中分配和释放用于DMA的内存块。
【C语言】Infiniband驱动mlx4_load_one函数
数字人生
03-07 1092
错误处理部分（`err_port`、`err_steer`、`err_disable_msix`等标签）包括停止设备，关闭固件界面，清理命令接口，禁用SR-IOV（如果已启用），以及释放内存资源等。3. 代码中包含了多个错误处理标签（如`err_port`、`err_steer`等），它们用于在函数执行中遇到错误时，跳转到相应的代码位置进行资源清理和释放操作。此段代码主要完成当PCI设备是主设备（物理功能）时的初始化准备工作，包括对设备所有权的检查和声明，设备的重置，以及虚拟功能相关的设置。
【C语言】InfiniBand驱动mlx4_init和mlx4_cleanup
数字人生
03-03 976
通过mlx4_interface的注册，Ethernet和InfiniBand驱动相互之间可以得知对应的设备添加(add)、移除(remove)等事件，然后执行针对InfiniBand协议所必需的操作。所以，当一个Mellanox设备作为PCI设备被系统发现时，Ethernet子系统中的mlx4_driver会通过mlx4_init_one初始化以太网功能，同时它也会与InfiniBand子系统进行通信以通过mlx4_ib_add初始化InfiniBand相关功能。注册PCI驱动mlx4_driver。
ipoib.rar_infiniband_ipoib
09-23
Transmission of IP over InfiniBand (IPoIB) (RFC 4391).
ip_set_hash.rar_infiniband
09-23
IBM eServer eHCA Infiniband device driver for Linux on POWER.
Intro_to_InfiniBand.pdf
05-21
“Introduction to High-Speed InfiniBand Interconnect” from HPC Advisory Council
Oracle_Database_and_InfiniBand_Technology_presentation
12-17
Oracle_Database_and_InfiniBand_Technology_presentation
cuda9需安装Visual Studio 2017
热门推荐
数字人生
01-13 1万+
在安装CUDA 9的过程中，可以选择不安装Visual Studio Integration组件，特别是如果系统中已经存在兼容的Visual Studio版本并且不需要额外集成的话。不过，仍需要确保安装CUDA的其他必要组件，如CUDA编译器和库文件。
【python】绘制春节烟花
数字人生
02-06 1万+
下载适合Windows的版本，运行安装程序，并确保在安装过程中选中了“Add Python to PATH”这个选项，以便在命令行中使用`python`命令。安装了Python之后，按下Windows键，输入`cmd`或`PowerShell`，然后选择“命令提示符”或“Windows PowerShell”。注意：如果电脑安装了多个Python版本，使用`python3`或者`py`命令替换`python`。这个脚本创建了一些简单的烟花效果，它们会随机地在底部生成，并上升到屏幕的一半高度左右时爆炸。
SM3WithSM2摘要的SM2签名验签
数字人生
12-08 9997
GmSSL是一个开源的密码学库，实现了SM2、SM3、SM4等国家密码算法，由中国科学院信息工程研究所实施。SM2是一种椭圆曲线公钥密码算法，主要用于数字签名、密钥交换和公钥加密。SM3是一种加密哈希函数。在GmSSL中，你可以使用SM2算法和SM3哈希函数结合来进行签名和验证。 下面提供一个GmSSL利用SM3和SM2进行签名和验证的C代码示例。请注意，要成功运行以下代码，你需要有GmSSL库的开发环境设置好，代码仅供参考：
ffmpeg使用h264、h265编码转换
数字人生
08-12 8986
1、编译x264 git clone https://code.videolan.org/videolan/x264.git cd x264 ./configure --enable-shared --enable-static --disable-asm make make install x264, the best H.264/AVC encoder - VideoLAN 2、编译x265 hg clone http://hg.videolan.org/x265 cd x265/buil.
gmssl国密sm2(生成密钥对-私钥签字-证书验签)
数字人生
12-11 8035
所以在缺省情况下，ENTL值是0x0080.a, b, x_G, y_G 都是SM2算法标准中给定的值。a和b是椭圆曲线y=x+ax+b的系数，x_G, y_G是SM2算法选定的基点的坐标。x_A || y_A就是公钥两部分值的拼接，注意，没有0x04的部分;将上述各元素拼接值进行SM3运算，得到结果Z。Z是第一步运算得到的摘要，M是签名的原文，将两者拼接，再进行SM3摘要运算。ENTL || ID || a || b || x_G || y_G || x_A || y_A表示签名元素数据的拼接（级联）。
C语言变量命名规范
数字人生
05-18 4807
C语言变量命名规范 （1）i（常用n），int，整型，iSize （2）n（常用s或sh），short，短整型，nPort （3）l，long，长整型，lSum （4）f，float，浮点型，fValue （5）d，double，双精度浮点型，dValue （6）u，无符号 （7）ch（常用c），字符型，chChar （8）by，字节（无符号字符），byData （9）b，布尔型，bIsTrue （10）a（常用arr），数组，anNum[10]
iperf2和iperf3
数字人生
02-10 4166
iperf2和iperf3
国密sm2签名验签
数字人生
12-07 4079
国密GM/T 0003.5-2012 标准中的 SM2 是一种公钥加密算法，类似于其他加密标准，如 RSA 或 ECC。下面将提供一个 SM2 签名和验签的示例代码，这是基于 OpenSSL 的 GmSSL 分支实现的，但请注意务必检查 OpenSSL/GmSSL 的许可证和出于安全考虑，始终使用最新版本的库和补丁。在使用上面的代码之前，请确认你有安装 GmSSL 或 OpenSSL 并且已包含 SM2 支持。在实际应用中，你需要确保采取安全的密钥管理措施，避免密钥泄露风险。
MLNX_OFED是什么
06-02
MLNX_OFED（Mellanox OpenFabrics Enterprise Distribution）是一种基于OpenFabrics Enterprise Distribution（OFED）的InfiniBand软件套件，由Mellanox Technologies开发和维护。它提供了一组标准的InfiniBand软件组件，包括驱动程序、用户空间库和工具，以及一些额外的Mellanox特定组件，如Mellanox OFED Management（MLNX-OM）和Mellanox InfiniBand Diagnostic（MLNX_DIAG）等。 MLNX_OFED旨在提供高性能、高可靠性的InfiniBand网络支持，以满足企业级和HPC（High Performance Computing）应用的需求。它支持多种操作系统，包括Linux、Windows和VMware等，并提供了一组丰富的管理工具和API，以帮助用户更好地管理和优化InfiniBand网络。 MLNX_OFED的主要特点包括： - 高性能：MLNX_OFED支持InfiniBand网络的高速传输，可以提供高达100 Gb/s的带宽和低延迟的传输性能。 - 高可靠性：MLNX_OFED提供了多种故障恢复机制，如自动重试、错误检测和错误纠正等，可以保障InfiniBand网络的稳定和可靠性。 - 多操作系统支持：MLNX_OFED支持多种操作系统，包括Linux、Windows和VMware等。 - 丰富的管理工具和API：MLNX_OFED提供了一组丰富的管理工具和API，以帮助用户更好地管理和优化InfiniBand网络。 总之，MLNX_OFED是一种基于OFED的InfiniBand软件套件，提供了高性能、高可靠性的InfiniBand网络支持，以满足企业级和HPC应用的需求。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

109702008

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值