OS Manuals

/usr/bin/smbcacls

Samba client programs

From samba-client 4.25.1-r1 (os), captured 2026-11-05 by running smbcacls --help (exit 0). permalink

Usage: smbcacls //server1/share1 filename
ACLs look like: 'ACL:user:[ALLOWED|DENIED]/flags/permissions'
  -D, --delete=ACL                             Delete an acl
  -M, --modify=ACL                             Modify an acl
  -a, --add=ACL                                Add an acl
  -S, --set=ACLS                               Set acls
  -C, --chown=USERNAME                         Change ownership of a file
  -G, --chgrp=GROUPNAME                        Change group ownership of a file
  -I, --inherit=STRING                         Inherit allow|remove|copy
      --propagate-inheritance                  Supports propagation of
                                               inheritable ACE(s) when used in
                                               conjunction with add, delete,
                                               set or modify
      --save=STRING                            stores the DACLs in sddl format
                                               of the specified file or folder
                                               for later use with restore.
                                               SACLS, owner or integrity
                                               labels are not stored
      --restore=STRING                         applies the stored DACLS to
                                               files in directory.
      --recurse                                indicates the operation is
                                               performed on directory and all
                                               files/directories below. (only
                                               applies to save option)
      --numeric                                Don't resolve sids or masks to
                                               names
      --sddl                                   Output and input acls in sddl
                                               format
      --query-security-info=INT                The security-info flags for
                                               queries
      --set-security-info=INT                  The security-info flags for
                                               modifications
  -t, --test-args                              Test arguments
      --domain-sid=SID                         Domain SID for sddl
  -x, --maximum-access                         Query maximum permissions

Help options:
  -?, --help                                   Show this help message
      --usage                                  Display brief usage message

Common Samba options:
  -d, --debuglevel=DEBUGLEVEL                  Set debug level
      --debug-stdout                           Send debug output to standard
                                               output
  -s, --configfile=CONFIGFILE                  Use alternative configuration
                                               file
      --option=name=value                      Set smb.conf option from
                                               command line
  -l, --log-basename=LOGFILEBASE               Basename for log/debug files
      --leak-report                            enable talloc leak reporting on
                                               exit
      --leak-report-full                       enable full talloc leak
                                               reporting on exit

Connection options:
  -R, --name-resolve=NAME-RESOLVE-ORDER        Use these name resolution
                                               services only
  -O, --socket-options=SOCKETOPTIONS           socket options to use
  -m, --max-protocol=MAXPROTOCOL               Set max protocol level
  -n, --netbiosname=NETBIOSNAME                Primary netbios name
      --netbios-scope=SCOPE                    Use this Netbios scope
  -W, --workgroup=WORKGROUP                    Set the workgroup name
      --realm=REALM                            Set the realm name

Credential options:
  -U, --user=[DOMAIN/]USERNAME[%PASSWORD]      Set the network username
  -N, --no-pass                                Don't ask for a password
      --password=STRING                        Password
      --pw-nt-hash                             The supplied password is the NT
                                               hash
  -A, --authentication-file=FILE               Get the credentials from a file
  -P, --machine-pass                           Use stored machine account
                                               password
      --simple-bind-dn=DN                      DN to use for a simple bind
      --use-kerberos=desired|required|off      Use Kerberos authentication
      --use-krb5-ccache=CCACHE                 Credentials cache location for
                                               Kerberos
      --use-winbind-ccache                     Use the winbind ccache for
                                               authentication
      --client-protection=sign|encrypt|off     Configure used protection for
                                               client connections

Deprecated legacy options:
  -k, --kerberos                               DEPRECATED: Migrate to
                                               --use-kerberos

Version options:
  -V, --version                                Print version
Options (47)
OptionDescriptionSource
-D, --delete ACLDelete an aclhelp
-M, --modify ACLModify an aclhelp
-a, --add ACLAdd an aclhelp
-S, --set ACLSSet aclshelp
-C, --chown USERNAMEChange ownership of a filehelp
-G, --chgrp GROUPNAMEChange group ownership of a filehelp
-I, --inherit STRINGInherit allow|remove|copyhelp
--propagate-inheritanceSupports propagation of inheritable ACE(s) when used in conjunction with add, delete, set or modifyhelp
--save STRINGstores the DACLs in sddl format of the specified file or folder for later use with restore.help
--restore STRINGapplies the stored DACLS to files in directory.help
--recurseindicates the operation is performed on directory and all files/directories below.help
--numericDon't resolve sids or masks to nameshelp
--sddlOutput and input acls in sddl formathelp
--query-security-info INTThe security-info flags for querieshelp
--set-security-info INTThe security-info flags for modificationshelp
-t, --test-argsTest argumentshelp
--domain-sid SIDDomain SID for sddlhelp
-x, --maximum-accessQuery maximum permissionshelp
-?, --helpShow this help messagehelp
--usageDisplay brief usage message.help + man
-d, --debuglevel DEBUGLEVELSet debug levelhelp
--debug-stdoutThis will redirect debug output to STDOUT.help + man
-s, --configfile CONFIGFILEThe file specified contains the configuration details required by the client.help + man
--option name=valueSet the smb.conf(5) option "<name>" to value "<value>" from the command line.help + man
-l, --log-basename LOGFILEBASEBasename for log/debug fileshelp
--leak-reportEnable talloc leak reporting on exit.help + man
--leak-report-fullEnable full talloc leak reporting on exit.help + man
-R, --name-resolve NAME-RESOLVE-ORDERUse these name resolution services onlyhelp
-O, --socket-options SOCKETOPTIONSsocket options to usehelp
-m, --max-protocol MAXPROTOCOLSet max protocol levelhelp
-n, --netbiosname NETBIOSNAMEPrimary netbios namehelp
--netbios-scope SCOPEThis specifies a NetBIOS scope that nmblookup will use to communicate with when generating NetBIOS names.help + man
-W, --workgroup WORKGROUPSet the workgroup namehelp
--realm REALMSet the realm namehelp
-U, --user DOMAIN/]USERNAME[%PASSWORDSet the network usernamehelp
-N, --no-passDon't ask for a passwordhelp
--password STRINGSpecify the password on the commandline.help + man
--pw-nt-hashThe supplied password is the NT hash.help + man
-A, --authentication-file FILEGet the credentials from a filehelp
-P, --machine-passUse stored machine account passwordhelp
--simple-bind-dn DNDN to use for a simple bind.help + man
--use-kerberos desired|required|offThis parameter determines whether Samba client tools will try to authenticate using Kerberos.help + man
--use-krb5-ccache CCACHESpecifies the credential cache location for Kerberos authentication.help + man
--use-winbind-ccacheTry to use the credential cache by winbind.help + man
--client-protection sign|encrypt|offSets the connection protection the client tool should use.help + man
-k, --kerberosDEPRECATED: Migrate tohelp
-V, --versionPrint versionhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.