Linux内核API 之BLK --blk_rq_map_kern

ret = blk_rq_map_kern(q, req, buffer, bufflen, GFP_KERNEL);
该函数 含义是 将 buffer 中的数据直接映射到请求 req 中。然后将映射后的请求 req 插入到请求队列 q 中

/**
 * blk_rq_map_kern - map kernel data to a request, for passthrough requests
 * @q:        request queue where request should be inserted
 * @rq:        request to fill
 * @kbuf:    the kernel buffer
 * @len:    length of user data
 * @gfp_mask:    memory allocation flags
 *
 * Description:
 *    Data will be mapped directly if possible. Otherwise a bounce
 *    buffer is used. Can be called multiple times to append multiple
 *    buffers.
 */
int blk_rq_map_kern(struct request_queue *q, struct request *rq, void *kbuf,
            unsigned int len, gfp_t gfp_mask)
{
    int reading = rq_data_dir(rq) == READ;
    unsigned long addr = (unsigned long) kbuf;
    struct bio *bio, *orig_bio;
    int ret;

    if (len > (queue_max_hw_sectors(q) << 9))
        return -EINVAL;
    if (!len || !kbuf)
        return -EINVAL;

    if (!blk_rq_aligned(q, addr, len) || object_is_on_stack(kbuf))
        bio = bio_copy_kern(q, kbuf, len, gfp_mask, reading);
    else
        bio = bio_map_kern(q, kbuf, len, gfp_mask);

    if (IS_ERR(bio))
        return PTR_ERR(bio);

    bio->bi_opf &= ~REQ_OP_MASK;
    bio->bi_opf |= req_op(rq);

    orig_bio = bio;
    ret = blk_rq_append_bio(rq, &bio);
    if (unlikely(ret)) {
        /* request is too big */
        bio_put(orig_bio);
        return ret;
    }

    return 0;
}
EXPORT_SYMBOL(blk_rq_map_kern);

参数说明

- q：是请求队列（request queue），表示请求应该插入到的队列。
- rq：是一个请求数据结构，用于表示请求的属性和要执行的操作。
- kbuf：是指向内核缓冲区的指针，其中包含要映射到请求的数据。
- len：表示要映射的数据的长度。
- gfp_mask：是内存分配标志，用于内存分配。

函数的功能可以分为以下几个步骤：

1. 首先，函数检查传递给它的参数，包括数据长度（len）是否超出了队列支持的最大扇区数（queue_max_hw_sectors(q)）。如果数据长度超出了支持的范围，函数返回 `-EINVAL` 表示参数无效。

2. 然后，函数检查数据长度（`len`）和内核缓冲区指针（`kbuf`）是否有效。如果数据长度为零或内核缓冲区指针为 NULL，则函数返回 `-EINVAL` 表示参数无效。

3. 接下来，函数根据数据的对齐情况和内存位置选择合适的方式来映射数据。如果数据未对齐或位于内核栈上（通过 `blk_rq_aligned` 和 `object_is_on_stack` 函数进行检查），则使用 `bio_copy_kern` 函数创建一个新的 BIO（块输入/输出对象），并将数据复制到其中。否则，使用 `bio_map_kern` 函数将数据映射到 BIO 中。

4. BIO 是 Linux 块层的数据结构，用于表示块设备操作。函数设置 BIO 的操作标志（`bi_opf`）以匹配请求的操作类型，然后将 BIO 添加到请求中。

5. 最后，函数调用 `blk_rq_append_bio` 函数将 BIO 添加到请求的 BIO 链表中，并返回成功（0）或错误代码。如果请求的大小超出了支持的范围，函数会释放 BIO 并返回错误

 。

总之blk_rq_map_kern 函数的主要作用是将内核数据映射到块设备请求中，以便执行请求。函数会根据数据的对齐和位置情况选择合适的映射方式，然后将映射后的数据添加到请求中，以便后续块设备操作。这个函数通常用于处理直通请求，其中请求的数据直接从内核空间传输到块设备，而无需复制或临时缓冲。