[systemd-devel] [PATCH 3/4] Update the man page of tmpfiles.d(5), to document the new h/H command.
From: Goffredo Baroncelli Update the man page of tmpfiles.d(5), to document the new h/H command. --- man/tmpfiles.d.xml | 36 1 file changed, 36 insertions(+) diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 8815bf9..a532f91 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -303,6 +303,41 @@ + h + Set file/directory attributes. Lines of this type + accept shell-style globs in place of normal path names. + + The format of the argument field is [+-=][aAcCdDeijsStTu] + + + The prefix + (the default one) causes the + attribute(s) to be added; - causes the + attribute(s) to be removed; = + causes the attributes to set exactly as the following letters. + The letters aAcCdDeijsStTu select the new + attributes for the files, see + chattr + 1 for further information. + + Passing only = as argument, + resets all the file attributes listed above. It has to be pointed + out that the = prefix, limits itself to the + attributes corresponding to the letters listed here. All other + attributes will be left untouched. + + + + + + + H + Recursively set file/directory attributes. Lines + of this type accept shell-style globs in place of normal + path names. + + + + a a+ Set POSIX ACLs (access control lists). If @@ -529,6 +564,7 @@ setfattr1, setfacl1, getfacl1 + chattr1 -- 2.1.4 ___ systemd-devel mailing list systemd-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/systemd-devel
Re: [systemd-devel] [PATCH 3/4] Update the man page of tmpfiles.d(5), to document the new h/H command.
On 2015-03-16 04:24, Zbigniew Jędrzejewski-Szmek wrote: > On Tue, Mar 10, 2015 at 09:07:42PM +0100, Goffredo Baroncelli wrote: >> Update the man page of tmpfiles.d(5), to document the new h/H command. >> --- >> man/tmpfiles.d.xml | 32 >> 1 file changed, 32 insertions(+) >> >> diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml >> index 8815bf9..469deeb 100644 >> --- a/man/tmpfiles.d.xml >> +++ b/man/tmpfiles.d.xml >> @@ -303,6 +303,37 @@ >> >> >> >> + h >> + Set file/directory attributes. Lines of this type >> + accept shell-style globs in place of normal path names. >> + >> + The format of the argument field is >> [+-=][aAcCdDeijsStTu] >> + >> + >> + The prefix + causes the >> + attribute(s) to be added; - causes the >> + attribute(s) to be removed; = >> + causes the attributes to set exactly as the following >> letters. > What happens if neither of the three prefix lettes is used? This > should be documented. ok > >> + The letters 'aAcCdDeijsStTu' select the new > instead of ''. ok > >> + attributes for the files, see >> + chattr >> + 1 for further information. >> + >> + Passing only = as argument, >> + reset all the file attributes. > resets > > So, is this description accurate? Operations on the attributes are > explicitly limited to the ones corresponding to the letters above (by > using a mask). But files can have other attributes, and the kernel might > define new attributes as some point. So maybe add a sentence like > "When operating on attributes, system-tmpfiles limits itself to the > attributes corresponding to the letters listed above. All other attributes > will be left untouched, even with =." > > Zbyszek You are right, good catch ! > >> + >> + >> + >> + >> + >> + H >> + Recursively set file/directory attributes. Lines >> + of this type accept shell-style globs in place of normal >> + path names. >> + >> + >> + >> + >>a >>a+ >>Set POSIX ACLs (access control lists). If >> @@ -529,6 +560,7 @@ >>> project='man-pages'>setfattr1, >>> project='man-pages'>setfacl1, >>> project='man-pages'>getfacl1 >> + > project='man-pages'>chattr1 >> >> >> >> -- >> 2.1.4 >> >> ___ >> systemd-devel mailing list >> systemd-devel@lists.freedesktop.org >> http://lists.freedesktop.org/mailman/listinfo/systemd-devel > -- gpg @keyserver.linux.it: Goffredo Baroncelli Key fingerprint BBF5 1610 0B64 DAC6 5F7D 17B2 0EDA 9B37 8B82 E0B5 ___ systemd-devel mailing list systemd-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/systemd-devel
Re: [systemd-devel] [PATCH 3/4] Update the man page of tmpfiles.d(5), to document the new h/H command.
On Tue, Mar 10, 2015 at 09:07:42PM +0100, Goffredo Baroncelli wrote: > Update the man page of tmpfiles.d(5), to document the new h/H command. > --- > man/tmpfiles.d.xml | 32 > 1 file changed, 32 insertions(+) > > diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml > index 8815bf9..469deeb 100644 > --- a/man/tmpfiles.d.xml > +++ b/man/tmpfiles.d.xml > @@ -303,6 +303,37 @@ > > > > + h > + Set file/directory attributes. Lines of this type > + accept shell-style globs in place of normal path names. > + > + The format of the argument field is > [+-=][aAcCdDeijsStTu] > + > + > + The prefix + causes the > + attribute(s) to be added; - causes the > + attribute(s) to be removed; = > + causes the attributes to set exactly as the following > letters. What happens if neither of the three prefix lettes is used? This should be documented. > + The letters 'aAcCdDeijsStTu' select the new instead of ''. > + attributes for the files, see > + chattr > + 1 for further information. > + > + Passing only = as argument, > + reset all the file attributes. resets So, is this description accurate? Operations on the attributes are explicitly limited to the ones corresponding to the letters above (by using a mask). But files can have other attributes, and the kernel might define new attributes as some point. So maybe add a sentence like "When operating on attributes, system-tmpfiles limits itself to the attributes corresponding to the letters listed above. All other attributes will be left untouched, even with =." Zbyszek > + > + > + > + > + > + H > + Recursively set file/directory attributes. Lines > + of this type accept shell-style globs in place of normal > + path names. > + > + > + > + >a >a+ >Set POSIX ACLs (access control lists). If > @@ -529,6 +560,7 @@ > project='man-pages'>setfattr1, > project='man-pages'>setfacl1, > project='man-pages'>getfacl1 > + project='man-pages'>chattr1 > > > > -- > 2.1.4 > > ___ > systemd-devel mailing list > systemd-devel@lists.freedesktop.org > http://lists.freedesktop.org/mailman/listinfo/systemd-devel ___ systemd-devel mailing list systemd-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/systemd-devel
[systemd-devel] [PATCH 3/4] Update the man page of tmpfiles.d(5), to document the new h/H command.
Update the man page of tmpfiles.d(5), to document the new h/H command. --- man/tmpfiles.d.xml | 32 1 file changed, 32 insertions(+) diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 8815bf9..469deeb 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -303,6 +303,37 @@ + h + Set file/directory attributes. Lines of this type + accept shell-style globs in place of normal path names. + + The format of the argument field is [+-=][aAcCdDeijsStTu] + + + The prefix + causes the + attribute(s) to be added; - causes the + attribute(s) to be removed; = + causes the attributes to set exactly as the following letters. + The letters 'aAcCdDeijsStTu' select the new + attributes for the files, see + chattr + 1 for further information. + + Passing only = as argument, + reset all the file attributes. + + + + + + H + Recursively set file/directory attributes. Lines + of this type accept shell-style globs in place of normal + path names. + + + + a a+ Set POSIX ACLs (access control lists). If @@ -529,6 +560,7 @@ setfattr1, setfacl1, getfacl1 + chattr1 -- 2.1.4 ___ systemd-devel mailing list systemd-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/systemd-devel
[systemd-devel] [PATCH 3/4] Update the man page of tmpfiles.d(5), to document the new h/H command.
Update the man page of tmpfiles.d(5), to document the new h/H command. --- man/tmpfiles.d.xml | 32 1 file changed, 32 insertions(+) diff --git a/man/tmpfiles.d.xml b/man/tmpfiles.d.xml index 8815bf9..469deeb 100644 --- a/man/tmpfiles.d.xml +++ b/man/tmpfiles.d.xml @@ -303,6 +303,37 @@ + h + Set file/directory attributes. Lines of this type + accept shell-style globs in place of normal path names. + + The format of the argument field is [+-=][aAcCdDeijsStTu] + + + The prefix + causes the + attribute(s) to be added; - causes the + attribute(s) to be removed; = + causes the attributes to set exactly as the following letters. + The letters 'aAcCdDeijsStTu' select the new + attributes for the files, see + chattr + 1 for further information. + + Passing only = as argument, + reset all the file attributes. + + + + + + H + Recursively set file/directory attributes. Lines + of this type accept shell-style globs in place of normal + path names. + + + + a a+ Set POSIX ACLs (access control lists). If @@ -529,6 +560,7 @@ setfattr1, setfacl1, getfacl1 + chattr1 -- 2.1.4 ___ systemd-devel mailing list systemd-devel@lists.freedesktop.org http://lists.freedesktop.org/mailman/listinfo/systemd-devel
