smb2-handler is a filesystem for accessing files remotely using the SMB2/3
protocols. The protocol implementation is based on the currently latest git
version of libsmb2 (https://github.com/sahlberg/libsmb2).

Requirements:

- AmigaOS 3.0 or newer.

- Optional: ReqTools for the password requester.

- filesysbox.library 54.3 or newer.

- AmiTCP 3.0 or any compatible TCP/IP stack.

- Optional: KillDev from IDEfix97 for unmounting.

Usage:

Create a DOSDriver with the contents:
Handler   = L:smb2-handler
StackSize = 65536
Priority  = 5
GlobVec   = -1
Startup   = "<args>"

Where <args> should follow the template:

URL/A,USER,PASSWORD,VOLUME,DOMAIN/K,READONLY/S,NOPASSWORDREQ/S,NOHANDLESRCV/S,
RECONNECTREQ/S

URL is the address of the samba share in the format:
smb://[<domain;][<username>[:<password>]@]<host>[:<port>]/<share>/<path>

USER and PASSWORD arguments if used override the username and password (if
any) specified in the URL argument.

VOLUME is the AmigaDOS volume name (if not specified it defaults to
<server>-<share>).

DOMAIN can be used to set the domain name (setting this via the URL argument
does not work ATM as c:mount treats anything after a semi-colon as a comment,
even if it's between double-quotes).

READONLY sets the filesystem to read only mode.

NOPASSWORDREQ stops a password requester from being opened if no password is
specified.

NOHANDLESRCV/S disables the automatic recovery of filehandles after a
connection fault is resolved. This should not be needed, but the SMB server
might still cause lock issue, reported by "..busy" "..in use" errors on
workbench. This can't be solved within this handler, unless libsmb2 supports
durable handles.

RECONNECTREQ/S requests the user if a reconnection should be attempted. This
is part of an initial implementation of connection fault handling and might
not be needed, as the final implementation relies on OS "No disk - retry"
mechanism. Still, if you have issues, you might try this option. Depending on
user feedback this option will be removed in future releases.

To connect to the share myshare on server mypc using username "myuser" and
password "password123" use:

Startup = "smb://myuser:password123@mypc/myshare"

If the user name or password contains reserved characters (: ; @) the 
USER and PASSWORD arguments can be used instead:

Startup = "smb://mypc/myshare USER=myuser PASSWORD=password123"

If you prefer not to store the password as plain text, you can also use its
NTLM hash with the following syntax:

Startup = "smb://mypc/myshare USER=myuser PASSWORD=ntlm:HASHABCDEF"

To connect to the same share using a guest account you can use:

Startup = "smb://mypc/myshare NOPASSWORDREQ"

To give the mounted share a custom name the VOLUME argument can be used:

Startup = "smb://mypc/myshare VOLUME=MyShare"

If you want the handler to be started immediately on mount, rather than on the
first access, then make sure that ACTIVATE=1 is set in either in the icon
tooltypes or in the DOSDriver file itself.

To unmount the share, set the DOSDEV tooltype in KillDev's icon to the name
of the DOSDriver file, then start KillDev from Workbench. This can also be
used if the volume couldn't be mounted, and you get a "device already mounted"
message.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
drwxrwxr-x  1000/1000        0       0 ****** -lhd- 0000 Jun 19 13:42 smb2fs/
-rw-rw-r--  1000/1000     7021   18002  39.0% -lh5- 8af8 Oct  7  2020 smb2fs/COPYING
-rw-------  1000/1000      213     464  45.9% -lh5- d79e Jan  3  2023 smb2fs/COPYING.info
-rw-rw-r--  1000/1000      283     551  51.4% -lh5- b0c4 Jun 17 07:29 smb2fs/Install
-rw-------  1000/1000      276     493  56.0% -lh5- c21c Jan 18  2023 smb2fs/Install.info
drwxrwxr-x  1000/1000        0       0 ****** -lhd- 0000 Jun 19 13:42 smb2fs/L/
-rw-rw-r--  1000/1000    95402  202668  47.1% -lh5- 05ec Jun 19 13:40 smb2fs/L/smb2-handler.000
-rw-rw-r--  1000/1000    93511  196024  47.7% -lh5- 1e63 Jun 19 13:40 smb2fs/L/smb2-handler.020
-rw-rw-r--  1000/1000    93306  195624  47.7% -lh5- 0355 Jun 19 13:41 smb2fs/L/smb2-handler.060
-rw-rw-r--  1000/1000     9646   26530  36.4% -lh5- 7b42 Dec  9  2022 smb2fs/LICENCE-libsmb2
-rw-------  1000/1000      213     464  45.9% -lh5- d79e Jan  3  2023 smb2fs/LICENCE-libsmb2.info
-rw-rw-r--  1000/1000     1562    3245  48.1% -lh5- d6f7 Jun 17 07:29 smb2fs/README
-rw-------  1000/1000      213     464  45.9% -lh5- d79e Jan  3  2023 smb2fs/README.info
-rw-rw-r--  1000/1000     1613    3275  49.3% -lh5- 0f6a Jun 19 12:32 smb2fs/releasenotes
-rw-------  1000/1000      213     464  45.9% -lh5- d79e Jan  3  2023 smb2fs/releasenotes.info
-rw-------  1000/1000      280     628  44.6% -lh5- 1b61 Jan  3  2023 smb2fs.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        16 files  303752  648896  46.8%            Jun 27 23:54