2. mmap系统调用：函数原型、参数详解与错误码

mmap（memory map）是Linux帧缓冲性能优化的核心系统调用。它负责将帧缓冲设备（/dev/fb0）的物理内存映射到用户空间，使应用程序可以直接读写显存，避免昂贵的read()/write()系统调用开销。理解mmap的每个参数如何影响映射行为，是配置高性能帧缓冲的关键前提。

2.1 mmap() 函数原型

#include <sys/mman.h>

void *mmap(void *addr, size_t length, int prot, int flags, int fd, off_t offset);

返回值：成功返回映射区域的起始地址（void *）；失败返回 MAP_FAILED（即 (void *) -1），并设置 errno。

2.2 参数详解

2.3 参数深度解析

addr — 映射地址提示

• 推荐值： NULL。让内核自动选择合适的虚拟地址，避免地址冲突。
• 性能影响： 指定非NULL地址时，如果地址不可用，内核会忽略该提示并重新选择，不会导致失败，但可能引入额外的地址空间查找开销。
• 帧缓冲特例： 某些嵌入式平台（如ARM）要求映射地址在特定范围内才能使用DMA，此时可指定 addr 为 0x40000000 等预定义地址。

length — 映射长度

• 帧缓冲标准做法： 使用 ioctl(fd, FBIOGET_VSCREENINFO, &vinfo) 获取屏幕信息后，计算 length = vinfo.xres * vinfo.yres * vinfo.bits_per_pixel / 8，或直接使用 finfo.smem_len。
• 性能陷阱： 映射长度必须是系统页大小（通常4096字节）的整数倍。如果长度不是页对齐，内核会向上取整到页边界，但多出的部分访问时会产生 SIGBUS 信号。
• 优化建议： 对于双缓冲或多缓冲场景，映射长度应覆盖所有缓冲区，避免多次mmap调用。

prot — 内存保护标志

flags — 映射类型标志

flags是mmap参数中影响性能最复杂的字段。帧缓冲场景下，必须使用 MAP_SHARED，否则写入不会同步到物理显存。

fd — 文件描述符

• 帧缓冲设备文件：open("/dev/fb0", O_RDWR)。
• 权限要求： 必须使用 O_RDWR，仅 O_RDONLY 会导致mmap失败（EPERM）。
• 生命周期： mmap成功后可以立即 close(fd)，映射仍然有效。但帧缓冲场景建议保持fd打开，以便后续 ioctl 操作。

offset — 文件偏移量

• 帧缓冲标准值： 0，从帧缓冲起始地址开始映射。
• 页对齐要求： offset必须是系统页大小（sysconf(_SC_PAGESIZE)）的整数倍。非页对齐的offset会导致 EINVAL 错误。
• 高级用法： 对于支持多缓冲区的帧缓冲驱动，可以通过不同的offset映射不同的缓冲区（如 offset = 0 映射前缓冲区，offset = screen_size 映射后缓冲区）。

2.4 返回值与错误码

2.5 mmap参数配置流程（SVG）

2.6 帧缓冲mmap典型代码片段

#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <unistd.h>
#include <sys/mman.h>
#include <linux/fb.h>
#include <sys/ioctl.h>

int main() {
    int fbfd = open("/dev/fb0", O_RDWR);
    if (fbfd == -1) {
        perror("open /dev/fb0");
        exit(EXIT_FAILURE);
    }

    struct fb_var_screeninfo vinfo;
    struct fb_fix_screeninfo finfo;

    // 获取屏幕信息
    if (ioctl(fbfd, FBIOGET_VSCREENINFO, &vinfo) == -1) {
        perror("ioctl FBIOGET_VSCREENINFO");
        close(fbfd);
        exit(EXIT_FAILURE);
    }
    if (ioctl(fbfd, FBIOGET_FSCREENINFO, &finfo) == -1) {
        perror("ioctl FBIOGET_FSCREENINFO");
        close(fbfd);
        exit(EXIT_FAILURE);
    }

    // 计算映射长度（页对齐检查）
    size_t screensize = vinfo.xres * vinfo.yres * vinfo.bits_per_pixel / 8;
    long pagesize = sysconf(_SC_PAGESIZE);
    if (screensize % pagesize != 0) {
        screensize = ((screensize / pagesize) + 1) * pagesize;
    }

    // 执行mmap（性能优化版本）
    char *fbp = mmap(NULL, screensize,
                     PROT_READ | PROT_WRITE,
                     MAP_SHARED | MAP_POPULATE,  // 预分配页表
                     fbfd, 0);

    if (fbp == MAP_FAILED) {
        perror("mmap framebuffer");
        close(fbfd);
        exit(EXIT_FAILURE);
    }

    // 此时可以直接通过fbp读写帧缓冲
    // ... 绘制操作 ...

    // 清理
    munmap(fbp, screensize);
    close(fbfd);
    return 0;
}

2.7 常见配置错误与性能影响

2.8 本章小结

• mmap是帧缓冲性能的基石：正确的参数配置可以避免系统调用开销和缺页中断。
• flags参数最关键：MAP_SHARED 是强制要求，MAP_POPULATE 是性能优化利器。
• 页对齐是硬约束：offset和length都必须遵守页对齐规则，否则映射失败或产生SIGBUS。
• 错误码诊断：EINVAL 通常指向对齐问题，EACCES 指向权限问题，ENOMEM 指向内存不足。