pdbedit, smbpassword: add page & improve comments (#7545)

pages/linux/pdbedit.md

@@ -0,0 +1,21 @@
+# pdbedit
+
+> Edit the Samba user database.
+> For simple user add/remove/password, you can also use `smbpasswd`.
+> More information: <https://manned.org/pdbedit>.
+
+- List all Samba users (use verbose flag to show their settings):
+
+`sudo pdbedit --list --verbose`
+
+- Add an existing Unix user to Samba (will prompt for password):
+
+`sudo pdbedit --user {{username}} --create`
+
+- Remove a Samba user:
+
+`sudo pdbedit --user {{username}} --delete`
+
+- Reset a Samba user's failed password counter:
+
+`sudo pdbedit --user {{username}} --bad-password-count-reset`

pages/linux/smbpasswd.md

@@ -1,20 +1,21 @@
 # smbpasswd
 
-> Change a user's SMB password.
+> Add/remove a Samba user or change its password.
-> Samba users must also have a local Unix account.
+> Samba users must have an existing local Unix account.
+> More information: <https://manned.org/smbpasswd.8>.
 
 - Change the current user's SMB password:
 
 `smbpasswd`
 
-- Add a specified user to Samba and set password(user should already exist in system):
+- Add a specified user to Samba and set password (user should already exist in system):
 
-`smbpasswd -a {{username}}`
+`sudo smbpasswd -a {{username}}`
 
 - Modify an existing Samba user's password:
 
-`smbpasswd {{username}}`
+`sudo smbpasswd {{username}}`
 
-- Delete a Samba user:
+- Delete a Samba user (use `pdbedit` instead if the Unix account has been deleted):
 
-`smbpasswd -x {{username}}`
+`sudo smbpasswd -x {{username}}`