[Buildroot] [git commit] package/makedevs: used manual's description

Yann E. MORIN yann.morin.1998 at free.fr
Wed Feb 7 11:06:14 UTC 2024


commit: https://git.buildroot.net/buildroot/commit/?id=8f4be5c41bdf296e6f5c7ad7b9811d34386f89ea
branch: https://git.buildroot.net/buildroot/commit/?id=refs/heads/master

Currently, the makedevs syntax explanations are duplicated: one in
the package directory, which was introduced firat but bit-rotted for
a while each time the makedevs was updated, and once in the manual,
which lagged much less. As for all duplicated documentation, the two
diverged and one was not updated.

In commit 738fb6dfa48b (docs/manual: extend makedev syntax section),
we recently updated the makedevs syntax description, but that indeed
missed the old README.

Get rid of the README and replace it with a symlink to the manual
makedevs section.

Signed-off-by: Marcus Folkesson <marcus.folkesson at gmail.com>
Signed-off-by: Yann E. MORIN <yann.morin.1998 at free.fr>
---
 package/makedevs/README      | 35 -----------------------------------
 package/makedevs/README.adoc |  1 +
 2 files changed, 1 insertion(+), 35 deletions(-)

diff --git a/package/makedevs/README b/package/makedevs/README
deleted file mode 100644
index 70844bf802..0000000000
--- a/package/makedevs/README
+++ /dev/null
@@ -1,35 +0,0 @@
-When building a target filesystem, it is desirable to not have to
-become root and then run 'mknod' a thousand times.  Using a device
-table you can create device nodes and directories "on the fly".
-
-You can do all sorts of interesting things with a device table file.
-For example, if you want to adjust the permissions on a particular
-file you can just add an entry like:
-
-  /sbin/foobar f 2755 0 0 - - - - -
-
-and (assuming the file /sbin/foobar exists) it will be made setuid
-root (regardless of what its permissions are on the host filesystem.
-
-Furthermore, you can use a single table entry to create a many device
-minors.  For example, if I wanted to create /dev/hda and
-/dev/hda[0-15] I could just use the following two table entries:
-
-  /dev/hda b 640 0 0 3 0 0 0 -
-  /dev/hda b 640 0 0 3 1 1 1 15
-
-Device table entries take the form of:
-
-<name> <type> <mode> <uid> <gid> <major> <minor> <start> <inc> <count>
-
-where name is the file name,  type can be one of:
-
-      f: A regular file
-      d: Directory
-      c: Character special device file
-      b: Block special device file
-      p: Fifo (named pipe)
-
-uid is the user id for the target file, gid is the group id for the
-target file.  The rest of the entries (major, minor, etc) apply only
-to device special files.
diff --git a/package/makedevs/README.adoc b/package/makedevs/README.adoc
new file mode 120000
index 0000000000..d62887a747
--- /dev/null
+++ b/package/makedevs/README.adoc
@@ -0,0 +1 @@
+../../docs/manual/makedev-syntax.adoc
\ No newline at end of file



More information about the buildroot mailing list