SCSI子系统基础学习笔记 - 2. 添加SCSI适配器到系统

最新推荐文章于 2023-08-27 14:14:13 发布
最新推荐文章于 2023-08-27 14:14:13 发布
阅读量1.5k 收藏 6
点赞数 2
分类专栏： # SCSI
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/jasonactions/article/details/116291558
版权

目录

1. 前言

本专题我们开始学习SCSI子系统的相关内容。本专题主要参考了《存储技术原理分析》、ULA、ULK的相关内容。本专题主要以硬件UFS为例，记录SCSI子系统的框架流程。
SCSI低层驱动是面向主机适配器的，低层驱动被加载时，首先要添加主机适配器。添加主机适配器包括两部分内容，为主机适配器分配数据结构，将主机适配器添加到系统。SCSI中间层为此提供了两个公共函数：scsi_host_alloc和scsi_add_host。

以UFS设备为例，这部分的内容是在ufs_qcom_probe->ufshcd_pltfrm_init中完成

kernel版本：5.10
平台：arm64

注：
为方便阅读，正文标题采用分级结构标识，每一级用一个"-“表示，如：两级为”|- -", 三级为”|- - -“

2. scsi_host_alloc

struct Scsi_Host *scsi_host_alloc(struct scsi_host_template *sht, int privsize)
	|--struct Scsi_Host *shost;
	|--shost = kzalloc(sizeof(struct Scsi_Host) + privsize, gfp_mask);
	|  //Scsi_Host初始化
	|--shost->host_lock = &shost->default_lock;
	|  //初始化shost->host_lock锁
	|  spin_lock_init(shost->host_lock);
	|  shost->shost_state = SHOST_CREATED; //初始化shost->shost_state为SHOST_CREATED状态。
	|  INIT_LIST_HEAD(&shost->__devices);//初始化&shost->__devices链表用于链接host下所有的scsi_device
	|  INIT_LIST_HEAD(&shost->__targets); //初始化&shost->__targets链表用于链接host下所有的scsi_target
	|  INIT_LIST_HEAD(&shost->eh_cmd_q);//初始化&shost->eh_cmd_q链表用于链接host下所有的error command
	|  INIT_LIST_HEAD(&shost->starved_list); //初始化&shost->starved_list链表(TODO)
	|  init_waitqueue_head(&shost->host_wait);
	|  mutex_init(&shost->scan_mutex)
	|  index = ida_simple_get(&host_index_ida, 0, 0, GFP_KERNEL);//shost->host_no，通过idx子系统为host分配一个ID
	|  shost->host_no = index;//初始化host no
	|  shost->dma_channel = 0xff;
	|  /* These three are default values which can be overridden */
    |  shost->max_channel = 0;//初始化max_channel，max_id,max_lun，其中后两者要设置为比id号大1
    |  shost->max_id = 8;
    |  shost->max_lun = 8;
    |  shost->transportt = &blank_transport_template;//初始化shost->transportt为默认，是一个空的函数模板
    |  shost->max_cmd_len = 12;//初始化最大命令长度为12（命令最大长度or命令个数 TODO）
    |  shost->hostt = sht;
    |  shost->this_id = sht->this_id;//通过sht模板来初始化新创建的Scsi_host
    |  shost->can_queue = sht->can_queue;
    |  shost->sg_tablesize = sht->sg_tablesize;//初始化shost->sg_tablesize，值为UCD中PRDT数组个数
    |  shost->sg_prot_tablesize = sht->sg_prot_tablesize;
    |  shost->cmd_per_lun = sht->cmd_per_lun;//初始化shost->cmd_per_lun（每个lun命令队列支持的最大命令个数）
    |  shost->unchecked_isa_dma = sht->unchecked_isa_dma;
    |  shost->no_write_same = sht->no_write_same;
    |  shost->host_tagset = sht->host_tagset;   
    |  shost->eh_deadline = ...;
    |  shost->active_mode = ...;
    |  shost->max_host_blocked = ...;
    |  shost->max_sectors = ...;//设置host能处理的最大扇区数量max_sectors
    |  shost->max_segment_size = ...;
    |  shost->dma_boundary = ...;//设置dma的界线shost->dma_boundary，默认是4G，也即是大于4G会被划分为两部分
    |  shost->virt_boundary_mask = sht->virt_boundary_mask;
    |  //初始化Scsi_Host内嵌通用设备描述符和设备描述符
    |--device_initialize(&shost->shost_gendev);
    |  dev_set_name(&shost->shost_gendev, "host%d", shost->host_no);
    |  shost->shost_gendev.bus = &scsi_bus_type;//在scsi_bus下面创建节点, 如：/sys/bus/scsi/devices/host0
    |  shost->shost_gendev.type = &scsi_host_type;
    |--device_initialize(&shost->shost_dev);
    |  shost->shost_dev.parent = &shost->shost_gendev;//shost_gendev为shost_dev的父设备
    |  shost->shost_dev.class = &shost_class;///sys/class/scsi_host/host0
    |  dev_set_name(&shost->shost_dev, "host%d", shost->host_no);
    |  shost->shost_dev.groups = scsi_sysfs_shost_attr_groups;
    |
    |--shost->ehandler = kthread_run(scsi_error_handler, shost,"scsi_eh_%d", shost->host_no);
    |--shost->tmf_work_q = alloc_workqueue("scsi_tmf_%d", WQ_UNBOUND | WQ_MEM_RECLAIM | WQ_SYSFS,1, shost->host_no);
    |--scsi_proc_hostdir_add(shost->hostt);

scsi_host_alloc为Scsi_host和其私有数据分配了空间并对其进行初始化。
以高通ufs为例，则执行路径为ufs_qcom_probe->scsi_host_alloc。sht指向scsi_host_template，privsize为私有数据的大小，对于UFS就是ufs_hba结构体大小。scsi_host_alloc为Scsi_host和其私有数据分配了空间。注册一个scsi host实例，并对scsi_host成员变量进行初始化，其中shost->ehandler为错误处理回调线程，shost->tmf_work_q为工作队列，并在/proc/scsi下创建scsi以提供相关信息。/proc/scsi/scsi属性显示了各个LUN的详细信息。
qcom platform_device =》shost->shost_gendev =》 shost->shost_dev依次形成父子关系

  1. kzalloc(sizeof(struct Scsi_Host) + privsize, gfp_mask)
    分配scsi_host空间和host私有空间
    在这里插入图片描述

  2. Scsi_Host初始化

  3. 通过device_initialize对shost->shost_gendev和shost->shost_dev初始化
    每个scsi主机适配器都由两个内嵌设备描述符：
    (1)内嵌通用设备描述符shost->shost_gendev
    (2)内嵌设备描述符shost->shost_dev
    它的parent为内嵌通用设备描述符shost->shost_gendev
    以UFS为例，在sysfs下将会创建如下两个文件：
    /sys/devices/platform/soc/1d84000.ufshc/host0
    /sys/devices/platform/soc/1d84000.ufshc/host0/scsi_host/host0
    在执行device_add后将形成如下图的拓扑关系：
    在这里插入图片描述
    如上图引用部分的host#分别代表了shost->shost_gendev和shost->shost_dev

  4. kthread_run(scsi_error_handler, shost,“scsi_eh_%d”, shost->host_no)
    通过kthread_run启动错误处理线程shost->ehandler，错误处理函数为scsi_error_handler

  5. alloc_workqueue：初始化工作队列shost->tmf_work_q，名称为scsi_tmf_host编号；

  6. scsi_proc_hostdir_add(shost->hostt)
    在/proc/下创建scsi目录，可以通过/proc/scsi/scsi查看lun的信息

3. scsi_add_host

static inline int __must_check scsi_add_host(struct Scsi_Host *host,
	|--scsi_add_host_with_dma(host, dev, dev);
			|--struct scsi_host_template *sht = shost->hostt;
			|--if (!shost->can_queue)
			|		shost_printk(KERN_ERR, shost, "can_queue = 0 no longer supported\n");
			|		goto fail;
			|--scsi_init_sense_cache(shost);
			|--scsi_mq_setup_tags(shost);
			|		|--struct blk_mq_tag_set *tag_set = &shost->tag_set;
			|		|--tag_set->ops = &scsi_mq_ops;
			|		|  tag_set->nr_hw_queues = shost->nr_hw_queues ? : 1;
			|		|  tag_set->queue_depth = shost->can_queue;
			|		|  tag_set->cmd_size = cmd_size;
			|		|  tag_set->numa_node = NUMA_NO_NODE;
			|		|  tag_set->flags = BLK_MQ_F_SHOULD_MERGE;
			|		|--blk_mq_alloc_tag_set(tag_set)
			|--if (!shost->shost_gendev.parent)
			|		shost->shost_gendev.parent = dev ? dev : &platform_bus;
			|--if (!dma_dev)
			|		dma_dev = shost->shost_gendev.parent;
			|	shost->dma_dev = dma_dev;
			|--pm_runtime_get_noresume(&shost->shost_gendev);
		    |  pm_runtime_set_active(&shost->shost_gendev);
		    |  pm_runtime_enable(&shost->shost_gendev);
		    |--device_enable_async_suspend(&shost->shost_gendev);
		    |--device_add(&shost->shost_gendev);
		    |--scsi_host_set_state(shost, SHOST_RUNNING);
		    |--get_device(shost->shost_gendev.parent);
		    |--device_enable_async_suspend(&shost->shost_dev);
		    |--device_add(&shost->shost_dev);
		    |--get_device(&shost->shost_gendev);
		    |--if (shost->transportt->host_size)
		    |           shost->shost_data = kzalloc(shost->transportt->host_size,GFP_KERNEL);
		    |--if (shost->transportt->create_work_queue) 
		    |            snprintf(shost->work_q_name, sizeof(shost->work_q_name),
		    |                     "scsi_wq_%d", shost->host_no);
		    |            shost->work_q = alloc_workqueue("%s",
		    |                    WQ_SYSFS | __WQ_LEGACY | WQ_MEM_RECLAIM | WQ_UNBOUND,
		    |                    1, shost->work_q_name);
		    |
		    |--scsi_sysfs_add_host(shost);
		    |--scsi_proc_host_add(shost);
		    |--scsi_autopm_put_host(shost);

ufs_qcom_probe->ufshcd_init->scsi_add_host时会调用scsi_add_host
scsi_add_host会直接调用scsi_add_host_with_dma(host, dev, dev)，它将分配的Scsi_Host添加到scsi总线设备模型中

  1. 判断shost->can_queue，即主机适配器可以同时接受的命令数，此处不能为0

  2. scsi_init_sense_cache(shost)
    主机适配器用于分配sense缓冲区的存储池结构

  3. scsi_mq_setup_tags
    对&shost->tag_set进行初始化，其中tag_set->ops = &scsi_mq_ops中，则设定了tag_set的操作集，它最终在blk_mq_init_allocated_queue会用于初始化request_queue->mq_ops，其中的request_queue->mq_ops->queue_rq将在请求分发的过程中被调用。
    blk_mq_alloc_tag_set 为每个硬队列分配blk_mq_tags指针数组，blk_mq_tag_set 一般内嵌在块设备相关结构体中，此处为Scsi_Host ；分配数组mq_map用于维护软硬队列的映射，并建立软硬队列的映射关系，同时对每个硬件队列，根据队列深度为每个硬件队列分配bitmap，并根据队列深度创建相应数目的request。此tag set将与一个或多个request_queue进行关联，

  4. shost->shost_gendev.parent = dev ? dev : &platform_bus
    确定主机适配器在sysfs中的位置，对于ufs来讲，此处的dev为mas-ufs
    注：至此内嵌通用设备和内嵌类设备初始化完毕
    在这里插入图片描述
    注：scsi_device和scsi_target后面才会添加，如上device->class指向哪里？（TODO）

  5. device_add(&shost->shost_gendev)
    将主机适配器的内嵌通用设备添加到系统中

  6. error = device_add(&shost->shost_dev)
    将主机适配器的内嵌类设备添加到系统中

  7. scsi_sysfs_add_host(shost)
    通过调用transport_register_device(&shost->shost_gendev);
    transport_configure_device(&shost->shost_gendev)
    将主机适配器添加到子系统, 在/sys/class/scsi_host/host0下面创建属性文件

  8. scsi_proc_host_add(shost)
    为兼容早期版本允许在proc中显示或配置主机适配器

参考文献

《存储技术原理分析》

HZero.chen
关注
  • 2
    点赞
  • 踩
  • 6
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
scsi-target-utils-1.0.24-18.el6.x86_64.rpm
10-21
适用于centos6的iscsi target安装包，用来配置iscsi服务端。 安装方法：rpm -ivh scsi-target-utils-1.0.24-18.el6.x86_64.rpm
SCSI系列三：linux SCSI 子系统六十八-hisi_sas（9）
Go，GO，GO！
08-15 84
这个函数根据设备的类型执行不同的初始化操作。在代码片段的上下文中，此函数似乎是用于初始化设备，以便在使用设备之前进行一些必要的设置。总之，这个函数用于对所有连接到 HISI SAS 控制器的设备执行初始化操作，确保这些设备在使用之前都进行了必要的设置和准备工作。总之，这个函数用于向连接到指定 SAS 端口上的每个物理链路上的 ATA 设备发送 ATA 复位命令，以进行复位操作。总之，这个函数的目的是在 STP 连接被拒绝时，通过终止相关设备的内部任务和发送 ATA 复位命令，确保连接的终止。
一文搞懂linux进程
rqaz123的博客
05-23 6440
1.进程的概念： 程序运行起来就是进程，系统会给进程分配cpu，内存，所属用户和权限.... 2.进程的分类 #pstree命令查看进程数，第一列是主进程（systemd）只有一个，第二列是父进程，第三列是子进程，第四列是子子进程，一般进程也就到 第四列 [root@node-10 ~]# pstree systemd─┬─ModemManager───2*[{ModemManager}] ├─NetworkManager───2*[{NetworkManager}] ├─...
Linux学习（七） 进程管理
qq_41957257的博客
05-31 725
1.进程概念 1.在Linux中，每一个程序都有自己的一个进程，每一个进程都有一个id号 2. 每一个进程都会有一个父进程 3.服务在后台进行，程序一般在前台进行。 2. ps 查看当前系统正在进行的各种进程信息 格式： ps 选项 -a 显示当前终端运行的所有进程信息 -u 以用户的信息显示进程 -x 显示后台运行进程的参数 [root@wangstudy /]# ps -x PID TTY STAT TIME COMMAND 1 ? ...
Linux磁盘热插拔命令
DONG999的专栏
11-24 2009
然后再运行fdisk -l 就能发现新添加的硬盘已经被系统识别了，查看系统日志/var/log/messages，发现对SCSI设备进行了一次重新扫描。需要注意的是echo的三个- – -号之间有空隔。对于支持热插拔SCSI技术的服务器，SCSI硬盘和磁带机可以在Linux下实现在线添加和移除。b是硬盘或者磁带机所在SCSI通道的编号；d是硬盘或者磁带机的lun号默认情况都是0。a是硬盘或者磁带机所在SCSI控制器号；c是硬盘或者磁带机的SCSI ID号；
深入浅出SCSI子系统（四）添加适配器到系统
sinat_37817094的博客
10-02 1163
目录 添加适配器到系统 scsi_host_alloc() scsi_add_host() 添加适配器到系统 SCSI低层驱动是面向主机适配器的，低层驱动被加载时，首先要添加主机适配器。主机适配器可以在PCI子系统完成ID匹配时添加，或者通过手工方式添加。所有基于硬件PCI接口的主机适配器都采用前一种方式，而UNH iSCSI启动器采用的是后一种方式。 添加主机适配器包括两部分的内容，为主机适配器分配数据结构，将主机适配器添加到系统。SCSI中间层为此提供了两个公共函数：scsi_host_
5.4版本内核ufs设备信息查询方式
sunnywalden
08-16 2179
本章主要介绍5.4版本内核中ufs存储设备的设备信息查询方法：ufs设备相关信息节点位于系统：/sys/devices/platform/soc/1d84000.ufshc目录下，具体如下： 其中： device_descriptor：设备描述相关信息 health_descriptor：使用寿命相关信息 string_descriptors：物料型号、厂商、sn号等信息 具体如下： device_descriptor： string_descriptors： health_descriptor： a
Linux命令lsscsi详解
一口Linux的专栏
08-31 6756
SCSI(Small Computer System Interface)是一套完整的数据传输协议，其主要功能是在主机和存储设备之间传送命令、状态和块数据。在各类存储技术中，SCSI技术可谓是最重要的脊梁。SCSI协议位于操作系统和外部资源之间，它具有一系列的功能组件，操作系统对外部设备（如磁盘、磁带、光盘、打印机等）的I/O操作均可以通过SCSI协议来实现，一般情况下，SCSI协议都嵌入到设备驱动器或者主机适配器的板载逻辑中。...
USB学习笔记-SCSI命令.pdf
10-26
USB学习笔记_SCSI命令.pdf
ISO_IEC_14776-412.rar_IEC_scsi-2
09-20
Information technology - Small Computer System Interface - Part 412: SCSI Architecture Model - 2 (SAM-2)
SCSI-spc-sbc-mmc-ssc.rar
03-20
各个版本的SCSI协议标准，包括SPC-2， SPC-3, SPC-4, SPC-5, SBC-3, MMC-5, SSC-3等。另外还包括了单独的指令说明等学习资料
scsi_2protocol.rar_68Pin_NAS_rom_sCsi2传输速度_scsi-2
09-23
SCSI-2也称为Fast－SCSI，传输...在接口电缆上， 为兼容SCSI－l所使用的A电缆，SCSI－2标准在A 电缆的基础上增加一条68pin的扁平电缆，称为B电 缆。目前还有不少SCSI的CD－ROM、CD－R、CD－ RW还是使用SCSI－2界面。
SCSI层代码分析（1）SCSI HOST的管理
flyingnosky的专栏
11-30 2322
本节首先对scsi host相关的结构体做描述，然后介绍scsi host的管理包括scsi host的分配/释放以及添加到系统中。 1. scsi host相关结构体介绍 1.1 scsi_host结构体 当OS通过HBA与硬盘进行交互之前，需要识别当前的HBA，然后才能识别连接到HBA上的硬盘。从SCSI层到LLDD层（有些驱动可能使用libsas层，有些没有），每一层都存在表示HBA的结构体。在SCSI层使用的是结构体scsi host。 结构体Scs...
UFS 手机相关调试接口
guozhidixian的博客
04-16 2990
一. 前言 我们拿到一款手机，怎么去知道手机UFS相关的信息呢，接下来我们一起来看下吧！ 二 . UFS相关信息 预置环境：最好有root权限的手机版本，可以连接adb 1. 查看UFS分区 sgdisk --print /dev/block/sdx(块设备节点，对应UFS的一个Lun) :/# sgdisk --print /dev/block/sda Disk /dev/block/sda: 124655616 sectors, 475.5GIB Sector size(logical/p
/proc 详解
weixin_34128534的博客
06-06 205
来源于：http://blog.sina.com.cn/s/blog_458983150100k93s.html使用/proc 文件系统来控制系统/proc/scsi/proc/scsi/scsi作为系统管理员，需要了解的最有用内容是，在有热交换驱动器情况下，如何不重 启系统就可以添加更多磁盘空间。假使不使用 /proc，您可以插入驱动器，但为了使系统识别新磁盘，必须...
linux平台实现虚拟磁盘驱动（通用的块设备驱动和基于SCSI的磁盘驱动）
fanxiushu的专栏
08-16 1040
struct Scsi_Host *sh = scsi_host_alloc(&nbt_scsi_driver_template, sizeof(自己定义的私有结构体大小));这时候 scsi_host_template 里边对应的 queuecommand 回调函数就会被调用，用来处理具体的SCSI磁盘的SCSI请求。然后响应 一些关于磁盘的特殊IOCTL， 同时响应 IRP_MG_READ和IRP_MJ_WRITE的读写磁盘扇区请求。
浅析Linux SCSI子系统：设备管理
Aspiresky的专栏
08-27 981
Linux SCSI子系统通过SCSI主机适配器（HBA）接入所有SCSI存储设备，在Linux系统中，可以安装多种主机适配器，SCSI中层会提供主机适配器的统一抽象，这些主机适配器的厂商提供具体的低层驱动实现；主机适配器接入到SCSI子系统后，SCSI会通过扫描或者低层驱动主动上报的方式，接入主机适配器下挂的所有SCSI存储设备。
SCSI学习
shipinsky的博客
06-27 531
upper lever driver : sd sr st sg 抽象的硬盘，磁带等节点，sd的驱动程序注册； middle lever driver:scsi core：提供API给上层和下层，第一优先级加载； lower lever：HBAS 具体控制器的驱动程序，控制器注册并探测到设备，注册设备 lower lever三部曲： 第一步 scsi_host_alloc ...
后端开发是一个涉及广泛技术和工具的领域.docx
最新发布
04-30
后端开发是一个涉及广泛技术和工具的领域，这些资源对于构建健壮、可扩展和高效的Web应用程序至关重要。以下是对后端开发资源的简要介绍： 首先，掌握一门或多门编程语言是后端开发的基础。Java、Python和Node.js是其中最受欢迎的几种。Java以其跨平台性和丰富的库而著名，Python则因其简洁的语法和广泛的应用领域而备受欢迎。Node.js则通过其基于JavaScript的单线程异步I/O模型，为Web开发提供了高性能的解决方案。 其次，数据库技术是后端开发中不可或缺的一部分。关系型数据库（如MySQL、PostgreSQL）和非关系型数据库（如MongoDB、Redis）各有其特点和应用场景。关系型数据库适合存储结构化数据，而非关系型数据库则更适合处理大量非结构化数据。 此外，Web开发框架也是后端开发的重要资源。例如，Express是一个基于Node.js的Web应用开发框架，它提供了丰富的API和中间件支持，使得开发人员能够快速地构建Web应用程序。Django则是一个用Python编写的Web应用框架，它采用了MVC的软件设计模式，使得代码结构更加清晰和易于维护。
bigip-14.1.0.6-0.0.9.all-scsi.ova
10-03
bigip-14.1.0.6-0.0.9.all-scsi.ova是一个文件的命名格式，表示的是BIG-IP系统的一个版本。BIG-IP是一种领先的应用交付控制平台，可以帮助企业提供高可用性、高性能和安全的应用服务。14.1.0.6-0.0.9是BIG-IP系统的版本号，是指该版本的一个特定发行版。all-scsi表示该版本的软件包适用于所有的SCSI设备。 ova是Open Virtualization Appliance的缩写，表示该文件是一个虚拟化映像文件。虚拟化技术可以将物理服务器划分为多个虚拟机实例，从而提高服务器的利用率和灵活性。ova文件通常用于通过虚拟化软件部署操作系统和应用程序。 所以，bigip-14.1.0.6-0.0.9.all-scsi.ova是一个包含BIG-IP系统特定版本的虚拟化映像文件。通过将此ova文件导入虚拟化环境中的虚拟化软件，可以轻松地部署和运行BIG-IP系统。这样可以为企业提供强大的应用交付控制功能，帮助企业提高应用程序的性能、可靠性和安全性。

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

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值