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