smb2fs icon indicating copy to clipboard operation
smb2fs copied to clipboard

SMB2 file system client

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:

  • newlib.library V53.40 or newer (or V53.30 as included in 4.1 FE).

  • filesysbox.library 54.4 or newer.

Usage:

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

Where 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;][[:]@][:]//

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 -).

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.