Re: [Buildroot] [PATCH] docs/manual: extend makedev syntax section

[Thomas Petazzoni via buildroot <buildroot@buildroot.org>]

On Thu, 18 Jan 2024 17:08:50 +0100
<yann.morin@orange.com> wrote:

> From: "Yann E. MORIN" <yann.morin@orange.com>
> 
> 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 fags, 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>
> ---
>  docs/manual/makedev-syntax.adoc | 33 +++++++++++++++++++--------------
>  1 file changed, 19 insertions(+), 14 deletions(-)

Applied to master (with the typo in the commit log fixed), thanks!

Thomas
-- 
Thomas Petazzoni, CTO, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot