support/misc/target-dir-warning.txt

   1 Warning!
   2 ========
   3
   4 This directory does *not* contain the root filesystem that you can use
   5 on your embedded system. Since Buildroot does not run as root, it
   6 cannot create device files and set the permissions and ownership of
   7 files correctly in this directory to make it usable as a root
   8 filesystem.
   9
  10 For that reason, do *not* use the contents of this directory to mount
  11 your root filesystem over NFS or copy the contents of this directory
  12 to a SD card or USB key, thinking it will work as the root filesystem
  13 for your embedded system. It will simply *not* work.
  14
  15 Instead, if you need a usable root filesystem, please select one of
  16 the filesystem image formats available in the Buildroot configuration
  17 interface (make menuconfig or others) in the "Filesystem images"
  18 sub-menu. If you want to get a filesystem image that you can easily
  19 extract to your SD card or to some directory exposed through NFS,
  20 please use the "tar the root filesystem" option. It will generate a
  21 images/rootfs.tar image in your Buildroot output directory, which you
  22 can extract as root:
  23
  24   sudo tar -C /destination/of/extraction -xf images/rootfs.tar
  25
  26 Those image files are created using the contents of the target/
  27 directory, but there is a post-processing step to create device files
  28 and set owernship/permissions properly even if Buildroot does not run
  29 as root.