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:

- AmigaOS 3.0 or newer.

- Optional: Reqtools for the password requester.

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

- AmiTCP 3.0 or any compatible TCP/IP stack.

- AmiSSL 5.1 or newer (https://github.com/jens-maus/amissl/releases).

- Optional: KillDev from IDEfix97 for unmounting.

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      256     495  51.7% -lh5- 21b4 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/
-rw-rw-r--  1000/1000    88297  183892  48.0% -lh5- aa82 Jun 28 09:08 ssh2fs/L/ssh2-handler.000
-rw-rw-r--  1000/1000    86787  182656  47.5% -lh5- d30a Jun 28 09:09 ssh2fs/L/ssh2-handler.020
-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      993    1853  53.6% -lh5- a521 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        15 files  179496  375236  47.8%            Jun 30 11:46