getcifsacl(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | NOTES | SEE ALSO | AUTHOR | COLOPHON

GETCIFSACL(1)            General Commands Manual            GETCIFSACL(1)

NAME         top

       getcifsacl - Userspace helper to display an ACL in a security
       descriptor for Common Internet File System (CIFS)

SYNOPSIS         top

          getcifsacl [-v|-r] {file system object}

DESCRIPTION         top

       This tool is part of the cifs-utils suite.

       getcifsacl is a userspace helper program for the Linux CIFS client
       file system. It is intended to display a security descriptor,
       including DACL and SACL for a file system object.

       This program uses a plugin to handle the mapping of SIDs to user
       and group names. /etc/cifs-utils/idmap-plugin should be a symlink
       that points to the correct plugin to use.

       Fields of an ACE such as SID, type, flags, and mask are displayed
       separated by /. Numeric values of type, flags, and mask are
       displayed in hexadecimal format.

OPTIONS         top

       -v     Print version number and exit.

       -r     Display a security descriptor in raw mode. Values such as
              type and flags are displayed in hexadecimal format, a SID
              is not mapped to a name.

       -R     List the ACLs of all files and directories recursively.

NOTES         top

       Kernel support for getcifsacl/setcifsacl utilities was initially
       introduced in the 2.6.37 kernel.

SEE ALSO         top

       mount.cifs(8), setcifsacl(1)

AUTHOR         top

       Shirish Pargaonkar wrote the getcifsacl program.

       The Linux CIFS Mailing list is the preferred place to ask
       questions regarding these programs.

COLOPHON         top

       This page is part of the LinuxCIFS utils (network filesystem
       mounts from Linux (e.g. to Samba, ksmbd, etc.)) project.
       Information about the project can be found at 
       ⟨https://wiki.samba.org/index.php/LinuxCIFS_utils⟩.  If you have a
       bug report for this manual page, send it to
       linux-cifs@vger.kernel.org, samba-technical@lists.samba.org.  This
       page was obtained from the project's upstream Git repository
       ⟨git://git.samba.org/cifs-utils.git⟩ on 2025-08-11.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2025-06-10.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

                                                            GETCIFSACL(1)

Pages that refer to this page: setcifsacl(1)smbinfo(1)idmapwb(8)mount.cifs(8)