kumquat-buildroot/docs/manual
Yann E. MORIN 738fb6dfa4 docs/manual: extend makedev syntax section
The section of the manual describing the makedev syntax is not
up-to-date with the current features, and does not properly describe
existing ones.

  - extend the list of types with the requirements on the existence of
    the target file or directory; for 'c', 'b', and 'p', the existence
    requirement is inherited from mknod(2):

    ERRORS
        ...
        ENOENT A directory component in pathname does not exist or is a
               dangling symbolic link.

    for the other types, the existence requirements are extracted from
    the source of makedev.c;

  - format the types flags, so they are rendered in monospace;

  - extend the 'mode' description, as it can be set to -1 for 'f', 'd',
    or 'r', so that only the uid and gid are set. This is most useful
    for 'r', where setting the same mode recursively for all the
    sub-directories and files alike does not really make sense; indeed
    in this case, the modes are usually set correctly when the package
    (or rootfs overlay) installs the files, and only the uid and gid are
    interesting to set;

  - extend and update the examples to show-case the -1 mode use-case.

Signed-off-by: Yann E. MORIN <yann.morin@orange.com>
Signed-off-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
2024-02-06 11:52:09 +01:00
..
adding-board-support.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-asciidoc.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-autotools.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-cargo.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-cmake.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-conclusion.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-directory.adoc package/pkg-download: lookup hash files in global-patch-dir 2023-11-07 11:48:46 +01:00
adding-packages-generic.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-gettext.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-golang.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-hooks.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-kconfig.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-kernel-module.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-linux-kernel-spec-infra.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-luarocks.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-meson.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-perl.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-python.adoc docs/manual: remove references to PKG_PYTHON_*_OPTS 2023-11-25 22:03:15 +01:00
adding-packages-qmake.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-rebar.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-tips.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-virtual.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages-waf.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
adding-packages.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
advanced.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
appendix.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
beyond-buildroot.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
ccache-support.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
common-usage.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
configure-other-components.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
configure.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
contribute.adoc docs/manual/contribute.txt: fix typo 2024-01-31 21:23:18 +01:00
customize-configuration.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize-device-permission-tables.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize-directory-structure.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize-outside-br.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize-packages.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize-patches.adoc utils/add-custom-hashes: add script to manage global patch dir hashes 2023-11-12 11:59:27 +01:00
customize-post-image.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize-quick-guide.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize-rootfs.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize-users-tables.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
customize.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
debugging-buildroot.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
developers.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
download-infra.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
download-location.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
faq-troubleshooting.adoc docs/manual: add a FAQ entry about Y2038 support 2023-10-01 21:14:07 +02:00
getting.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
how-buildroot-works.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
integration-selinux-support.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
integration-systemd.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
integration.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
introduction.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
known-issues.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
legal-notice.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
make-tips.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
makedev-syntax.adoc docs/manual: extend makedev syntax section 2024-02-06 11:52:09 +01:00
makeusers-syntax.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
manual.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
manual.mk docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
migrating.adoc docs/manual: fix typo 2023-10-21 23:30:27 +02:00
package-make-target.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
patch-policy.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
prerequisite.adoc doc/manual: rsync is not optional 2023-12-11 09:21:52 +01:00
quickstart.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
rebuilding-packages.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
release-engineering.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
resources.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
using-buildroot-debugger.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
using-buildroot-development.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
using-buildroot-toolchain.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00
writing-rules.adoc docs/manual: rename *.txt as *.adoc 2023-09-30 10:25:22 +02:00