From: Volker Lendecke Date: Tue, 30 Jul 2024 12:06:21 +0000 (+0200) Subject: docs: Document parametric form of hide and veto files X-Git-Tag: tdb-1.4.12~46 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=10e9b858a3f9ca8d7e5dfd1c4e1e7937a03db671;p=thirdparty%2Fsamba.git docs: Document parametric form of hide and veto files Bug: https://bugzilla.samba.org/show_bug.cgi?id=15688 Signed-off-by: Volker Lendecke Reviewed-by: Stefan Metzmacher Autobuild-User(master): Stefan Metzmacher Autobuild-Date(master): Wed Jul 31 09:41:54 UTC 2024 on atb-devel-224 --- diff --git a/docs-xml/smbdotconf/filename/hidefiles.xml b/docs-xml/smbdotconf/filename/hidefiles.xml index f93885e43a3..3290f8df8db 100644 --- a/docs-xml/smbdotconf/filename/hidefiles.xml +++ b/docs-xml/smbdotconf/filename/hidefiles.xml @@ -14,14 +14,22 @@ as in DOS wildcards. - If a file or directory name is prefixed by "../USERNAME/" - or "../GROUPNAME/", then the subsequent filename is only hidden for the - given user or group. Instead of specifying users or groups by name, they - can also be specified by SID. + can also be used as a + parametric option where NAME in + + + hide files : NAME = - User and group names use the same format as . + + specifies a user or group name with the same syntax as + . This parametric form can + be specified multiple times for different users or + groups. This means that "hide files : NAME" set both + in the [global] and the share section add up, whereas normally + options set in a share section overwrite the default in the + [global] section. + Each entry must be a Unix path, not a DOS path and must not include the Unix directory separator '/'. @@ -46,9 +54,12 @@ hide files = /.*/DesktopFolderDB/TrashFor%m/resource.frk/ ; Hide some files for anyone and some files for specific users and groups -hide files = hideforall1/../joe/hideforuserjoe/hideforall2/../students/hideforstudents/hideforall3 -hide files = ../UNIVERSITY\Alumnis/somefile.txt/../john@university.org/anotherfile.txt -hide files = ../S-1-5-21-123-456-789-1000/secretfile.txt +hide files = /hideforall1/ +hide files : USER = /hidetoforuser/ +hide files : GROUP = /hideforgroup/ +hide files : UNIVERSITY\Alumnis = /somefile.txt/ +hide files : john@university.org = /anotherfile.txt/ +hide files : S-1-5-21-123-456-789-1000 = /secretfile.txt/ diff --git a/docs-xml/smbdotconf/filename/vetofiles.xml b/docs-xml/smbdotconf/filename/vetofiles.xml index e47490ee49d..e90cf707c2d 100644 --- a/docs-xml/smbdotconf/filename/vetofiles.xml +++ b/docs-xml/smbdotconf/filename/vetofiles.xml @@ -11,14 +11,22 @@ - If a file or directory name is prefixed by "../USERNAME/" - or "../GROUPNAME/", then the subsequent filename is only hidden for the - given user or group. Instead of specifying users or groups by name, they - can also be specified by SID. + can also be used as a + parametric option where NAME in + + + veto files : NAME = - User and group names use the same format as . + + specifies a user or group name with the same syntax as + . This parametric form can + be specified multiple times for different users or + groups. This means that "veto files : NAME" set both + in the [global] and the share section add up, whereas normally + options set in a share section overwrite the default in the + [global] section. + Each filename must be a unix path, not a DOS path and must @@ -51,9 +59,12 @@ veto files = /*Security*/*.tmp/*root*/ ; Veto some files for anyone and some files for specific users and groups -veto files = /vetoforall1/../USER/vetoforuser/vetoforall2/../GROUP/vetoforgroup/vetoforall3/ -veto files = ../UNIVERSITY\Alumnis/somefile.txt/../john@university.org/anotherfile.txt -veto files = ../S-1-5-21-123-456-789-1000/secretfile.txt +veto files = /vetoforall1/ +veto files : USER = /vetotoforuser/ +veto files : GROUP = /vetoforgroup/ +veto files : UNIVERSITY\Alumnis = /somefile.txt/ +veto files : john@university.org = /anotherfile.txt/ +veto files : S-1-5-21-123-456-789-1000 = /secretfile.txt/ ; Veto the Apple specific files that a NetAtalk server ; creates.