From 75484f491140fb86eaee90dde1dc1c9d4ebe8a41 Mon Sep 17 00:00:00 2001 From: Karolin Seeger Date: Mon, 3 Sep 2012 21:49:25 +0200 Subject: docs: Rename manpages-3 -> manpages. This change was suggested by Andrew Bartlett on the samba-technical mailing list. Karolin Autobuild-User(master): Karolin Seeger Autobuild-Date(master): Mon Sep 3 23:35:38 CEST 2012 on sn-devel-104 --- docs-xml/manpages-3/smbcacls.1.xml | 265 ------------------------------------- 1 file changed, 265 deletions(-) delete mode 100644 docs-xml/manpages-3/smbcacls.1.xml (limited to 'docs-xml/manpages-3/smbcacls.1.xml') diff --git a/docs-xml/manpages-3/smbcacls.1.xml b/docs-xml/manpages-3/smbcacls.1.xml deleted file mode 100644 index 8674ecf1f4..0000000000 --- a/docs-xml/manpages-3/smbcacls.1.xml +++ /dev/null @@ -1,265 +0,0 @@ - - - - - - smbcacls - 1 - Samba - User Commands - 3.6 - - - - - smbcacls - Set or get ACLs on an NT file or directory names - - - - - smbcacls - //server/share - /filename - -D|--delete acls - -M|--modify acls - -a|--add acls - -S|--set acls - -C|--chown name - -G|--chgrp name - -I allow|romove|copy - --numeric - -t - -U username - -h - -d - - - - - DESCRIPTION - - This tool is part of the samba - 7 suite. - - The smbcacls program manipulates NT Access Control - Lists (ACLs) on SMB file shares. - - - - - OPTIONS - - The following options are available to the smbcacls program. - The format of ACLs is described in the section ACL FORMAT - - - - - -a|--add acls - Add the ACLs specified to the ACL list. Existing - access control entries are unchanged. - - - - - - -M|--modify acls - Modify the mask value (permissions) for the ACLs - specified on the command line. An error will be printed for each - ACL specified that was not already present in the ACL list - - - - - - - -D|--delete acls - Delete any ACLs specified on the command line. - An error will be printed for each ACL specified that was not - already present in the ACL list. - - - - - - -S|--set acls - This command sets the ACLs on the file with - only the ones specified on the command line. All other ACLs are - erased. Note that the ACL specified must contain at least a revision, - type, owner and group for the call to succeed. - - - - - - -C|--chown name - The owner of a file or directory can be changed - to the name given using the -C option. - The name can be a sid in the form S-1-x-y-z or a name resolved - against the server specified in the first argument. - - This command is a shortcut for -M OWNER:name. - - - - - - - -G|--chgrp name - The group owner of a file or directory can - be changed to the name given using the -G - option. The name can be a sid in the form S-1-x-y-z or a name - resolved against the server specified n the first argument. - - - This command is a shortcut for -M GROUP:name. - - - - - - -I|--inherit allow|remove|copy - Set or unset the windows "Allow inheritable - permissions" check box using the -I - option. To set the check box pass allow. To unset the check - box pass either remove or copy. Remove will remove all - inherited acls. Copy will copy all the inherited acls. - - - - - - - - --numeric - This option displays all ACL information in numeric - format. The default is to convert SIDs to names and ACE types - and masks to a readable string format. - - - - -t|--test-args - - Don't actually do anything, only validate the correctness of - the arguments. - - - - &stdarg.help; - &stdarg.server.debug; - &popt.common.samba; - &popt.common.credentials; - - - - - - ACL FORMAT - - The format of an ACL is one or more ACL entries separated by - either commas or newlines. An ACL entry is one of the following: - - -REVISION:<revision number> -OWNER:<sid or name> -GROUP:<sid or name> -ACL:<sid or name>:<type>/<flags>/<mask> - - - - The revision of the ACL specifies the internal Windows - NT ACL revision for the security descriptor. - If not specified it defaults to 1. Using values other than 1 may - cause strange behaviour. - - The owner and group specify the owner and group sids for the - object. If a SID in the format S-1-x-y-z is specified this is used, - otherwise the name specified is resolved using the server on which - the file or directory resides. - - ACLs specify permissions granted to the SID. This SID again - can be specified in S-1-x-y-z format or as a name in which case - it is resolved against the server on which the file or directory - resides. The type, flags and mask values determine the type of - access granted to the SID. - - The type can be either ALLOWED or DENIED to allow/deny access - to the SID. The flags values are generally zero for file ACLs and - either 9 or 2 for directory ACLs. Some common flags are: - - - #define SEC_ACE_FLAG_OBJECT_INHERIT 0x1 - #define SEC_ACE_FLAG_CONTAINER_INHERIT 0x2 - #define SEC_ACE_FLAG_NO_PROPAGATE_INHERIT 0x4 - #define SEC_ACE_FLAG_INHERIT_ONLY 0x8 - - - At present flags can only be specified as decimal or - hexadecimal values. - - The mask is a value which expresses the access right - granted to the SID. It can be given as a decimal or hexadecimal value, - or by using one of the following text strings which map to the NT - file permissions of the same name. - - - R - Allow read access - W - Allow write access - X - Execute permission on the object - D - Delete the object - P - Change permissions - O - Take ownership - - - - The following combined permissions can be specified: - - - - READ - Equivalent to 'RX' - permissions - CHANGE - Equivalent to 'RXWD' permissions - - FULL - Equivalent to 'RWXDPO' - permissions - - - - - EXIT STATUS - - The smbcacls program sets the exit status - depending on the success or otherwise of the operations performed. - The exit status may be one of the following values. - - If the operation succeeded, smbcacls returns and exit - status of 0. If smbcacls couldn't connect to the specified server, - or there was an error getting or setting the ACLs, an exit status - of 1 is returned. If there was an error parsing any command line - arguments, an exit status of 2 is returned. - - - - VERSION - - This man page is correct for version 3 of the Samba suite. - - - - AUTHOR - - The original Samba software and related utilities - were created by Andrew Tridgell. Samba is now developed - by the Samba Team as an Open Source project similar - to the way the Linux kernel is developed. - - smbcacls was written by Andrew Tridgell - and Tim Potter. - - The conversion to DocBook for Samba 2.2 was done - by Gerald Carter. The conversion to DocBook XML 4.2 for Samba 3.0 was done - by Alexander Bokovoy. - - - -- cgit