5e84b8b73c
The new skeleton of the manual as it has been thought:
1. About Buildroot:
Presentation of Buildroot
2. Starting up:
Everything to quickly and easily start working with Buildroot
3. Working with Buildroot
Basics to make your work fitting your needs
4. Troubleshooting
5. Going further in Buildroot's innards
Explaination of how buildroot is organised, how it works, etc
6. Developer Guidelines
7. Getting involved
8. Contibuting to Buildroot
9. Legal notice
10. Appendix
It is easy to distinguish two parts in this plan:
- Sections 1 to 4 mainly address people starting with Buildroot
- Sections 5 to 10 are more focused on how to develop Buildroot itself
Most of the existing sections have just been moved in the hierarchy,
few were split and dispatch in, what i think was the relevant section,
and numerous others have been created.
Signed-off-by: Samuel Martin <s.martin49@gmail.com>
Signed-off-by: Peter Korsgaard <jacmet@sunsite.dk>
57 lines
2.1 KiB
Plaintext
57 lines
2.1 KiB
Plaintext
// -*- mode:doc -*- ;
|
|
|
|
[[makedev-syntax]]
|
|
Makedev syntax documentation
|
|
----------------------------
|
|
|
|
The makedev syntax is used across several places in Buildroot to
|
|
define changes to be made for permissions or which device files to
|
|
create and how to create them, in order to avoid to call mkdnod every
|
|
now and then.
|
|
|
|
This syntax is derived from the makedev utility, and a more complete
|
|
documentation can be found in the +package/makedevs/README+ file.
|
|
|
|
It takes the form of a line for each file, with the following layout:
|
|
|
|
|===========================================================
|
|
|name |type |mode |uid |gid |major |minor |start |inc |count
|
|
|===========================================================
|
|
|
|
There is a few non-trivial blocks here:
|
|
|
|
- +name+ is the path to the file you want to create/modify
|
|
- +type+ is the type of the file, being one of :
|
|
* f: a regular file
|
|
* d: a directory
|
|
* c: a character device file
|
|
* b: a block device file
|
|
* p: a named pipe
|
|
- +mode+, +uid+ and +gid+ are the usual permissions stuff
|
|
- +major+ and +minor+ are here for device files
|
|
- +start+, +inc+ and +count+ are when you want to create a whole batch
|
|
of files, and can be reduced to a loop, beginning at +start+,
|
|
incrementing its counter by +inc+ until it reaches +count+
|
|
|
|
Let's say you want to change the permissions of a given file, using
|
|
this syntax, you will need to put:
|
|
-------------------------------------------------------------------
|
|
/usr/bin/foobar f 644 0 0 - - - - -
|
|
-------------------------------------------------------------------
|
|
|
|
On the other hand, if you want to create the device file +/dev/hda+
|
|
and the corresponding 15 files for the partitions, you will need for
|
|
+/dev/hda+:
|
|
|
|
-------------------------------------------------------------------
|
|
/dev/hda b 640 0 0 3 0 0 0 -
|
|
-------------------------------------------------------------------
|
|
|
|
and then for device files corresponding to the partitions of
|
|
+/dev/hda+, +/dev/hdaX+, +X+ ranging from 1 to 15:
|
|
|
|
-------------------------------------------------------------------
|
|
/dev/hda b 640 0 0 3 1 1 1 15
|
|
-------------------------------------------------------------------
|
|
|