smb2-handler

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:

- filesysbox.library

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,READONLY/S,NOPASSWORDREQ/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>).

READONLY sets the filesystem to read only mode.

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

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.

smb2-handler 53.7 (17.6.2023)

- Merged latest changes from libsmb2 git repository.

- AmigaOS 3 version now uses ReqTools for the password requester.

- Now uses an empty string instead of a NULL pointer when connecting to a
  share without a password.

- AROS version no longer gets SysBase by reading it from AbsExecBase.

- AROS version: Replaced fcntl() and close() calls with IoctlSocket() and
  CloseSocket().