From f6e60e47c29c15da72054cf674032c5330b06625 Mon Sep 17 00:00:00 2001
From: Machiavelli <145562237+MachiavelliII@users.noreply.github.com>
Date: Mon, 26 May 2025 07:35:01 +0300
Subject: [PATCH] smbserver.py, impacket-smbserver: add page (#16582)

* smbserver.py, impacket-smbserver: add page

* add long option

* 0A

* Update pages/common/smbserver.py.md

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>

---------

Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
---
 pages/common/impacket-smbserver.md |  7 ++++++
 pages/common/smbserver.py.md       | 36 ++++++++++++++++++++++++++++++
 2 files changed, 43 insertions(+)
 create mode 100644 pages/common/impacket-smbserver.md
 create mode 100644 pages/common/smbserver.py.md

diff --git a/pages/common/impacket-smbserver.md b/pages/common/impacket-smbserver.md
new file mode 100644
index 0000000000..84b4b3dabd
--- /dev/null
+++ b/pages/common/impacket-smbserver.md
@@ -0,0 +1,7 @@
+# impacket-smbserver
+
+> This command is an alias of `smbserver.py`.
+
+- View documentation for the original command:
+
+`tldr smbserver.py`
diff --git a/pages/common/smbserver.py.md b/pages/common/smbserver.py.md
new file mode 100644
index 0000000000..dedef6d06b
--- /dev/null
+++ b/pages/common/smbserver.py.md
@@ -0,0 +1,36 @@
+# smbserver.py
+
+> A Python-based SMB server for hosting shares (requires root for port 445).
+> More information: <https://github.com/fortra/impacket>.
+
+- Set up a basic SMB share:
+
+`smbserver.py {{sharename}} {{path/to/share}}`
+
+- Set up a share with a custom comment:
+
+`smbserver.py -comment {{my_share}} {{sharename}} {{path/to/share}}`
+
+- Set up a share with username and password authentication:
+
+`smbserver.py -username {{username}} -password {{password}} {{sharename}} {{path/to/share}}`
+
+- Set up a share with NTLM hash authentication:
+
+`smbserver.py -hashes {{LMHASH}}:{{NTHASH}} {{sharename}} {{path/to/share}}`
+
+- Set up a share on a specific interface:
+
+`smbserver.py {{[-ip|--interface-address]}} {{interface_ip_address}} {{sharename}} {{path/to/share}}`
+
+- Set up a share on a non-standard SMB port:
+
+`smbserver.py -port {{port}} {{sharename}} {{path/to/share}}`
+
+- Set up a share with SMB2 support:
+
+`smbserver.py -smb2support {{sharename}} {{path/to/share}}`
+
+- Set up a share and log commands to an output file:
+
+`smbserver.py -outputfile {{path/to/output_file}} {{sharename}} {{path/to/share}}`