testparm¶
Prüft die Samba-Konfiguration
smb.confauf Fehler und zeigt die Einstellungen, die Samba tatsächlich nutzt.

Syntax¶
testparm [-s] [-v] [--section-name=FREIGABE] [KONFIGDATEI]
Optionen¶
| Option | Beschreibung |
|---|---|
-s |
Die Konfiguration ausgeben, ohne auf Enter zu warten |
-v |
Auch alle Parameter mit ihren Standardwerten zeigen |
--section-name=FREIGABE |
Nur eine Freigabe zeigen |
--parameter-name=NAME |
Nur den Wert eines Parameters zeigen |
KONFIGDATEI |
Eine andere Datei statt /etc/samba/smb.conf prüfen |
Meldungen gehen auf stderr, die Konfiguration auf stdout. testparm -s 2>/dev/null gibt deshalb ein sauberes smb.conf ohne Kommentare aus.
Beispiele¶
Die Konfiguration prüfen:
testparm -s 2>&1 | head -5
Load smb config files from /etc/samba/smb.conf
Loaded services file OK.
Weak crypto is allowed by GnuTLS (e.g. NTLM as a compatibility fallback)
Server role: ROLE_STANDALONE
Ein Tippfehler in einem Parameter:
testparm -s 2>&1 | head -4
Load smb config files from /etc/samba/smb.conf
Unknown parameter encountered: "wirte list"
Ignoring unknown parameter "wirte list"
Loaded services file OK.
wirte list sollte write list heißen. Samba würde trotzdem starten und die Zeile einfach ignorieren.
Nur eine Freigabe zeigen:
testparm -s --section-name=team 2>/dev/null
[team]
path = /srv/share/team
read only = No
valid users = nox
Welche SMB-Versionen der Server erlaubt:
testparm -sv 2>/dev/null | grep -E 'server (min|max) protocol'
server max protocol = SMB3
server min protocol = SMB2_02
Das alte SMB1 ist standardmäßig aus. Lass es dabei.
Wann brauche ich das?¶
- Nach jeder Änderung an
smb.conf, vorsystemctl reload smbd - Um Tippfehler zu finden: Samba ignoriert unbekannte Parameter stillschweigend
- Um die wirksamen Einstellungen einer Freigabe zu sehen, ohne Kommentare und Standardwerte
Nach dem Test neu laden
testparm -s >/dev/null && sudo systemctl reload smbd lädt nur neu, wenn sich die Datei
lesen lässt. Laufende Verbindungen bleiben bestehen.
„Loaded services file OK“ ist nicht alles
testparm prüft die Syntax, nicht die Rechte. Bekommt nox trotzdem ACCESS_DENIED,
schau dir Besitzer und Rechte des Verzeichnisses mit namei -l an.
Unterschiede zwischen Distributionen¶
| Debian | Ubuntu | RHEL | Arch | |
|---|---|---|---|---|
| Paket | samba-common-bin |
samba-common-bin |
samba-common-tools |
samba |
| Samba-Dienst | smbd |
smbd |
smb |
smb |
smb.conf nach der Installation |
ja | ja | ja | nein: /etc/samba/smb.conf.default kopieren |