From 32317dea4d71c0e813c466af48b3a1f589d4b6db Mon Sep 17 00:00:00 2001
From: Coontzy1 <48108269+Coontzy1@users.noreply.github.com>
Date: Wed, 15 Jan 2025 22:55:11 -0500
Subject: [PATCH] smbcacls: add page (#15475)

---
 pages/linux/smbcacls.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 pages/linux/smbcacls.md

diff --git a/pages/linux/smbcacls.md b/pages/linux/smbcacls.md
new file mode 100644
index 0000000000..8f13736325
--- /dev/null
+++ b/pages/linux/smbcacls.md
@@ -0,0 +1,21 @@
+# smbcacls
+
+> View and manipulate Windows ACLs on SMB shares.
+> Part of the Samba suite.
+> More information: <https://www.samba.org/samba/docs/current/man-html/smbcacls.1.html>.
+
+- Display the ACLs for a file or directory on a remote SMB share:
+
+`smbcacls //{{server}}/{{share}} {{path/to/file_or_directory}} --user {{domain\\username}}%{{password}}`
+
+- Set a new ACL for a file on a remote SMB share (replace `"ACL:..."` with a valid Windows ACL specification):
+
+`smbcacls //{{server}}/{{share}} {{path/to/file}} --user {{domain\\username}}%{{password}} "ACL:{{DACL}}"`
+
+- Remove all existing ACL entries and set a new ACL:
+
+`smbcacls //{{server}}/{{share}} {{path/to/file}} --user {{domain\\username}}%{{password}} "RESET" "ACL:{{DACL}}"`
+
+- Specify an alternative workgroup (or domain) and have the program prompt for a password interactively:
+
+`smbcacls //{{server}}/{{share}} {{path/to/file}} --user {{username}} --workgroup {{workgroup}}`