Revision to SMB Docs

docs/handbook/network-communications.md

@@ -295,9 +295,47 @@ You can create additional CIFS datasets using the following 4 commands.
 < Placeholder for introduction content >
 
 
-### Hipster as a SAMBA server
+### Hipster as a SMB/SAMBA server
+
+OpenIndiana has rich & native support through it's Zettabyte file system to drive modern SAMBA services. First, to start, ensure you have the pool you want to share created. Second, check that any other SMB service (such as one you may have installed or compiled manually) is not running as it will conflict with the native implementation. Third, start the native service as follows:
+
+```
+sudo svcadm enable -r smb/server
+```
+
+Then run the following: 
+
+```
+sudo zfs create -o nbmand=on -o sharesmb=on poolname/setname 
+```
+Then, to define the share's name, use the following command:
+
+```
+sudo zfs set sharesmb=name=sharename poolname/setname  
+```
+
+Afterwards, you can test your share with the following command on your OpenIndiana system.
+
+```
+sudo smbclient -L //192.168.1.1/ -U username
+```
+
+You can also verify locally that the system share parameters are to your liking:
+
+```
+sharemgr show
+```
+
+Lastly, ensure that the permissions you set agree with the user account's permissions. For instance, if you want users to be able to edit files, ensure they have the permission to do so for their user account and group. 
+
+For instance, if the SMB user account is named "user", & in the "staff" group, ensure the folders and files they create by default have read, write, and if need be, execute permissions. If they don't, Windows users will see the Windows File Properties Menushowing restrictions for editing, viewing, (or executing) their SMB files. As always, test thoroughly as permissions on OpenIndiana's side can cause issues for Windows users. 
+
+<div class="note" markdown="1">
+!!! note
+    For Microsoft Windows 11: consider having your Windows 11 users authenticate with a username/password as opposed to a guest account, as Windows 11 has many roadblocks that make this difficult otherwise with passwordless guest accounts. This author personally has spent hours with this, and does not recommend it either!
+
+</div>
 
-< Place holder for content >
 
 ### Configuring NFS client connectivity