PetaLinux 文件系统目录详解：嵌入式 Linux 根文件系统各文件夹的作用与内容

PetaLinux 文件系统目录详解嵌入式 Linux 根文件系统各文件夹的作用与内容文章目录PetaLinux 文件系统目录详解嵌入式 Linux 根文件系统各文件夹的作用与内容一、根文件系统总览二、各目录详细说明1. /bin - 基本用户命令二进制文件2. /sbin - 系统管理命令3. /usr - 用户系统资源二级层次4. /lib - 系统引导和根文件系统运行所需的基本共享库与内核模块5. /etc - 系统配置文件6. /dev - 设备文件7. /proc - 进程信息伪文件系统8. /sys - 内核对象信息与驱动模型9. /boot - 引导加载程序相关文件10. /home - 普通用户主目录11. /root - root 用户主目录12. /var - 可变数据文件13. /tmp - 临时文件14. /run - 运行时变量数据15. /mnt 与 /media - 临时挂载点16. /opt - 可选应用软件包17. /srv - 服务数据三、PetaLinux 特有的目录或注意事项四、实际使用中的小贴士1. 如何查看当前目录使用情况2. 如何判断某个命令来自哪个包3. 如何自定义根文件系统内容4. 如何固化自定义脚本或配置文件五、总结在嵌入式 Linux 开发中PetaLinux 是 Xilinx 官方推荐的一套嵌入式 Linux 构建工具能够快速生成针对 Zynq、Zynq UltraScale MPSoC 等平台的 Linux 镜像。PetaLinux 构建出的根文件系统rootfs遵循标准的 Linux 文件系统层次结构Filesystem Hierarchy Standard, FHS同时又针对嵌入式场景做了一些定制与精简。对于刚接触 PetaLinux 或嵌入式 Linux 的开发者来说理清根文件系统下各个目录的用途、存放内容以及它们与实际系统运行的关系是调试和定制系统的基础。本文将详细介绍 PetaLinux 生成的根文件系统中常见文件夹的作用和内容帮助你快速掌握嵌入式 Linux 的文件布局。一、根文件系统总览一个典型的 PetaLinux 根文件系统以rootfs或rootfs.cpio形式呈现挂载到目标板的/下使用ls /可以看到如下目录bin boot dev etc home lib media mnt opt proc root run sbin srv sys tmp usr var有些目录在 PetaLinux 默认配置下可能为空如/home、/srv但仍保留以满足标准应用程序的预期。下面我们逐一剖析这些目录的用途。二、各目录详细说明1./bin- 基本用户命令二进制文件用途存放系统启动和单用户模式下必需的用户级命令所有用户均可执行。典型内容常用 Shell 命令sh、ls、cp、mv、rm、cat、echo、mount、umount等。在 PetaLinux 中这些命令通常来自BusyBox一个集成众多常用命令的精简工具集因此/bin下的可执行文件多为指向 BusyBox 的符号链接。$ls-l/bin/ls lrwxrwxrwx1root root7Mar92023/bin/ls -busybox注意现代 Linux 发行版倾向于将/bin、/sbin、/lib合并到/usr下即 UsrMerge。但在 PetaLinux 构建的嵌入式系统中为了精简仍保留传统的分离结构。2./sbin- 系统管理命令用途存放系统管理员使用的关键系统命令通常需要 root 权限执行。典型内容ifconfig、route网络配置fsck、mkfs文件系统检查与创建reboot、halt、poweroff系统控制与硬件交互的工具fw_printenv、i2cget、gpio等取决于 PetaLinux 配方中是否添加相关软件包与/bin类似这些命令大多也链接至 BusyBox。3./usr- 用户系统资源二级层次/usr是根文件系统中内容最丰富的目录之一它包含了大部分用户程序、库、文档和共享数据。子目录用途/usr/bin绝大多数用户命令如gcc、python、make、ssh等如果安装了/usr/sbin非必需的系统管理命令如sshd、tcpdump、useradd/usr/lib应用程序和系统服务使用的共享库、目标文件/usr/includeC/C 头文件用于交叉编译环境/usr/share架构无关的共享数据如帮助文档、时区信息、字体、图标等/usr/local本地安装的软件PetaLinux 默认通常为空供用户自定义安装使用PetaLinux 特有说明在/usr/bin下可能会包含一些与 Xilinx 硬件相关的工具如xbutil管理 Alveo 加速卡、dfx-mgr动态功能交换管理器等具体取决于你启用的IMAGE_FEATURES和添加的 recipes。4./lib- 系统引导和根文件系统运行所需的基本共享库与内核模块用途存放系统启动和/bin、/sbin下程序所依赖的动态链接库以及内核模块。子路径内容/lib/ld-linux-*.so*动态链接器/加载器/lib/libc.so.*C 标准库通常为 glibc 或 musl/lib/libm.so.*数学库/lib/modules/$(uname -r)/内核模块目录存放编译好的.ko文件及其依赖关系文件modules.depPetaLinux 特别注意若你在 PetaLinux 配置中使能了内核模块CONFIG_xxxm这些模块会被安装到/lib/modules/kernel-version/下。启动时depmod会生成模块依赖关系确保modprobe能正确加载模块。5./etc- 系统配置文件用途存放系统全局的配置文件文本文件启动脚本和网络配置等均在此处。重要文件/子目录文件/目录作用/etc/inittab定义 init 进程的运行级别及启动的任务若使用 sysvinit/etc/init.d/SysV init 风格的服务启动脚本/etc/rc*.d/各个运行级别下服务的符号链接K 开头表示停止S 开头表示启动/etc/fstab文件系统挂载表定义启动时自动挂载的分区/etc/passwd、/etc/shadow用户账户信息密码哈希存储在 shadow 中/etc/group用户组信息/etc/hostname主机名/etc/hosts静态主机名解析/etc/resolv.confDNS 解析服务器配置可能由 DHCP 或 network manager 动态生成/etc/network/interfaces网络接口静态配置若使用 ifupdown/etc/udev/udev 设备管理器的规则和配置/etc/dropbear/Dropbear SSH 服务器的密钥和配置PetaLinux 常用轻量级 SSHPetaLinux 特性PetaLinux 生成的根文件系统默认使用BusyBox init或SysVinit可配置。/etc/init.d/rcS是系统启动时的主要初始化脚本你可以在这里添加自定义启动命令。6./dev- 设备文件用途Linux “一切皆文件”哲学的体现所有硬件设备包括虚拟设备都以特殊文件的形式存在于/dev下。典型内容块设备/dev/mmcblk0SD 卡、/dev/mtdblock0NAND/NOR Flash字符设备/dev/ttyPS0Zynq UART、/dev/i2c-0I2C 总线、/dev/gpiochip*GPIO 控制器虚拟设备/dev/null、/dev/zero、/dev/random、/dev/urandom终端/dev/tty、/dev/console、/dev/pts/*在 PetaLinux 中/dev由devtmpfs或udev/mdev动态管理。启动时内核挂载 devtmpfs用户空间的 udev/mdev 负责处理热插拔事件并创建设备节点。7./proc- 进程信息伪文件系统用途一个内存中的虚拟文件系统提供了内核和进程信息的实时视图。不占用磁盘空间。常用文件/proc/cpuinfo- CPU 信息/proc/meminfo- 内存使用情况/proc/version- 内核版本/proc/uptime- 系统启动时长/proc/PID/- 每个进程的详细信息如cmdline、status、fd//proc/device-tree/-设备树Device Tree的运行时视图对嵌入式开发极其有用例如查看 Zynq MPSoC 的 CPU 信息cat/proc/cpuinfo8./sys- 内核对象信息与驱动模型用途类似于/proc但提供的是关于内核对象、设备和驱动模型的统一视图。常用目录/sys/class/- 按设备类别分类如/sys/class/gpio/用于操作 GPIO/sys/devices/- 按实际设备拓扑组织/sys/kernel/debug/-debugfs 挂载点提供内核调试信息需挂载debugfsPetaLinux 默认启用 sysfs许多硬件调试都依赖/sys。9./boot- 引导加载程序相关文件注意在嵌入式 Linux 中/boot目录不一定被挂载为单独的分区其内容可能直接存放在根文件系统中。PetaLinux 环境下/boot的典型内容Image或uImage- 编译好的 Linux 内核镜像system.dtb或system-top.dtb- 设备树二进制文件boot.scr或boot.bin- U-Boot 启动脚本或综合引导文件对于 ZynqBOOT.BIN包含 FSBL、bitstream 和 U-Boot通常放在 FAT 分区不在/boot下对于使用ext4 根文件系统且由 U-Boot 加载内核的场景U-Boot 会从 FAT 分区读取内核和 DTB因此/boot可能为空或仅用于存放备份镜像。具体情况取决于你的启动介质配置。10./home- 普通用户主目录用途为系统上的普通用户提供个人文件存储空间。PetaLinux 默认通常只创建root用户因此/home目录多为空。如果需要创建多用户环境可以在petalinux-config -c rootfs中添加用户支持包并在此处创建用户目录。11./root- root 用户主目录用途root 用户的专属主目录路径固定为/root不同于/home/root。12./var- 可变数据文件用途存放系统运行过程中内容会频繁变化的文件如日志、缓存、锁文件、临时数据库等。子目录内容/var/log系统和应用程序日志文件如messages、dmesg、boot.log/var/run运行时进程 PID 文件和 socket 文件现多软链接到/run/var/lock锁文件确保资源互斥访问软链接到/run/lock/var/tmp持久化的临时文件系统重启后通常保留/var/spool邮件、打印任务等队列数据/var/lib应用程序状态信息如包管理器数据库opkg或rpm13./tmp- 临时文件用途所有用户和程序存放临时文件的目录。系统重启后该目录内容会被清空。在 PetaLinux 中/tmp通常挂载为tmpfs内存文件系统这样可以减少对 Flash 的写入磨损。14./run- 运行时变量数据用途自系统启动以来描述系统状态的数据通常也挂载为 tmpfs。系统启动早期即可用且重启后消失。典型内容/run/utmp- 当前登录用户信息/run/udev/- udev 运行时数据/run/dbus/- D-Bus 系统总线的 socket 文件/run/media/- 自动挂载的可移动介质如 U 盘挂载点15./mnt与/media- 临时挂载点/mnt系统管理员手动挂载文件系统的临时挂载点。PetaLinux 中常用于挂载 SD 卡的其他分区、NFS 共享等。/media自动挂载可移动介质如 USB 存储设备的基础目录。若系统使用udisks或automount工具U 盘会被挂载到/media/sda1等子目录下。16./opt- 可选应用软件包用途存放额外安装的第三方软件。PetaLinux 镜像默认可能为空但当你通过 Yocto recipe 添加独立的大型软件如 Xilinx Vitis AI 运行时、自定义应用程序时常将它们安装到/opt下。例如Xilinx 提供的 AI 示例可能安装至/opt/xilinx/。17./srv- 服务数据用途存放系统服务提供的数据如 HTTP 服务器/srv/www或 FTP 服务器/srv/ftp。嵌入式系统中较少用到默认多为空。三、PetaLinux 特有的目录或注意事项/lib/firmware/PetaLinux 内核可能通过request_firmware()接口加载固件到硬件设备如 WiFi/BT 芯片、Xilinx AI Engine 固件。这些固件文件.bin、.fw会被放置在/lib/firmware/下。/usr/bin/petalinux-*并不存在注意PetaLinux 是构建工具生成的根文件系统里没有petalinux-开头的命令。这些命令只在开发主机上使用。设备树叠加层DTBO若使用动态设备树叠加层.dtbo文件常放在/lib/firmware/或/boot/下由dfx-mgr或用户脚本加载。挂载点与分区布局PetaLinux 构建的映像通常将根文件系统打包为rootfs.cpio.gz.u-boot或rootfs.ext4而引导文件BOOT.BIN、image.ub放在 FAT 分区中。因此在目标板上根文件系统的/boot可能为空而真正的内核/DTB 在第一个 FAT 分区挂载为/run/media/mmcblk0p1等。四、实际使用中的小贴士1. 如何查看当前目录使用情况使用df -h查看各挂载点的磁盘使用量# df -hFilesystem Size Used Avail Use% Mounted on /dev/root3.5G 320M3.0G10% / devtmpfs 494M0494M0% /dev tmpfs 494M1.2M 493M1% /run tmpfs 494M 132K 494M1% /var/volatile2. 如何判断某个命令来自哪个包在 PetaLinux 环境中可以使用which找到命令位置然后检查其链接whichls# /bin/lsls-l/bin/ls# lrwxrwxrwx 1 root root 7 Mar 9 2023 /bin/ls - busybox3. 如何自定义根文件系统内容通过petalinux-config -c rootfs菜单增减软件包。在project-spec/meta-user/recipes-core/images/petalinux-image.bbappend中添加IMAGE_INSTALL your-package。在project-spec/meta-user/下创建自定义 recipe 或添加文件到rootfs的特定路径。4. 如何固化自定义脚本或配置文件将文件放在project-spec/meta-user/recipes-core/base-files/下通过 bbappend 覆盖原/etc下的文件或者编写自己的 recipe 安装到目标目录。五、总结PetaLinux 生成的根文件系统遵循标准的 Linux 目录结构但针对嵌入式做了大量精简。理解各目录的作用能够帮助你快速定位问题比如配置文件在/etc日志在/var/log模块在/lib/modules。进行系统定制知道在哪里添加自启动脚本在哪里放置固件。有效调试硬件利用/sys和/proc/device-tree查看设备状态。参考资料Filesystem Hierarchy StandardXilinx PetaLinux Tools DocumentationBusyBox Documentation