[prev in list] [next in list] [prev in thread] [next in thread] 

List:       buildroot
Subject:    Re: [Buildroot] [PATCH] docs/manual: extend makedev syntax section
From:       Peter Korsgaard <peter () korsgaard ! com>
Date:       2024-02-29 15:46:54
Message-ID: 87msrje0i9.fsf () 48ers ! dk
[Download RAW message or body]

>>>>> "Thomas" == Thomas Petazzoni via buildroot <buildroot@buildroot.org> writes:

 > 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!

Committed to 2023.02.x and 2023.11.x, thanks.

-- 
Bye, Peter Korsgaard
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot
[prev in list] [next in list] [prev in thread] [next in thread]