ssh2-handler is filesystem for accessing files remotely using the SFTP
protocol. It is based on libssh2 1.10.0 and uses AmiSSL for SSL encryption
/decryption.

Requirements:

- filesysbox.library 54.3 or newer
  (https://github.com/salass00/filesysbox/releases).

- z.library 2.1 or newer (https://github.com/salass00/z_lib/releases).

- AmiSSL 4.12.

Usage:

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

Where <args> should follow the template:

HOSTADDR/A,PORT/N/K,USER/A,PASSWORD,VOLUME,READONLY/S,NOSSHAGENT/S,KEYFILE/K,
ROOTDIR/K

HOSTADDR is the IP address or domain name of the SSH server.

PORT is the port number (defaults to 22).

USER is the user name.

PASSWORD is the login password or key file passphrase depending on the
authentication method used. If this argument is left out a password requester
will be used instead.

VOLUME is the AmigaDOS volume name (defaults to <user>@<hostaddr>).

READONLY sets the filesystem to read only mode.

NOSSHAGENT stops filesystem from attempting to connect to ssh-agent.

KEYFILE can be used to change the key file used for public key authentication
(defaults to "$HOME/.ssh/id_rsa" or "HOME:.ssh/id_rsa").

ROOTDIR sets the root directory to use as the root of the volume (defaults to
"/").

To connect to a SFTP server with IP 192.168.1.16 and port 122 using username
"user123" use:

Startup = "192.168.1.16 PORT=122 user123"

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.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
drwxrwxr-x  1000/1000        0       0 ****** -lhd- 0000 Jun 28 09:10 ssh2fs/
-rw-r--r--  1000/1000      973    1960  49.6% -lh5- 3926 Aug 29  2021 ssh2fs/COPYING-libssh2
-rw-------  1000/1000      213     464  45.9% -lh5- d79e Jan  3 15:24 ssh2fs/COPYING-libssh2.info
-rw-rw-r--  1000/1000      116     150  77.3% -lh5- 09f7 Jun 21 09:36 ssh2fs/Install
-rw-------  1000/1000      276     493  56.0% -lh5- 78a6 Jun 21 09:31 ssh2fs/Install.info
drwxrwxr-x  1000/1000        0       0 ****** -lhd- 0000 Jun 28 09:10 ssh2fs/L/
-rwxrw-rw-  1000/1000    91236  217684  41.9% -lh5- a271 Jun 28 09:09 ssh2fs/L/ssh2-handler
-rw-rw-r--  1000/1000      724    1345  53.8% -lh5- c514 Jun 25 15:17 ssh2fs/LICENSE
-rw-------  1000/1000      213     464  45.9% -lh5- d79e Jan  3 15:24 ssh2fs/LICENSE.info
-rw-rw-r--  1000/1000      896    1635  54.8% -lh5- ecd7 Jun 21 19:15 ssh2fs/README
-rw-------  1000/1000      213     464  45.9% -lh5- d79e Jan  3 15:24 ssh2fs/README.info
-rw-rw-r--  1000/1000       58      58 100.0% -lh0- 2c11 Jun 28 09:06 ssh2fs/releasenotes
-rw-------  1000/1000      213     464  45.9% -lh5- d79e Jan  3 15:24 ssh2fs/releasenotes.info
-rw-------  1000/1000      280     628  44.6% -lh5- 1b61 Jan  3 15:22 ssh2fs.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        14 files   95411  225809  42.3%            Jun 30 11:46