NAME

       x2gomountdirs - Share Client-Side Folder with X2Go Session

SYNOPSIS

       x2gomountdirs <mount_type> <session_id> <username> <key_file> <dir1> [<dir2> [<dir3> [...]]]

DESCRIPTION

       x2gomountdirs mounts client-side folders or devices onto mountpoints that are accessible from within your
       remote X2Go session.

       x2gomountdirs is run with X2Go user privileges and normally issued by an X2Go client application.

ARGUMENTS

       <mount_type>
              If  the mount type is set to ,,dir'' then the client-side mount target is interpreted as a folder.
              If other, it is interpreted as a device.

       <session_id>
              The <session_id> is the unique identifier of the X2Go session that this command is run for.

       <username>
              The owner of session <session_id> is given as the <username> argument.

       <key_file>
              Location of a temporary private SSH key file (only valid for this command execution).

       <dir1> [<dir2> [<dir3> [...]]]
              A list of client-side folders or device mount points  that  shall  be  mounted  for  X2Go  session
              <session_id>.

PERMISSIONS

       X2Go  uses  the  fuse-based  SSH  filesystem  (SSHFS)  for  sharing  client-side file resources with X2Go
       sessions.  Users that shall use X2Go folder sharing must be members of the X2Go server's  ,,fuse''  POSIX
       group.

RETURN VALUES

       x2gomountdirs returns some mount point information to stdout if the mounting process has been successful.
       The mount results are printed line-by-line. The individual lines must be interpreted as shown below:

           line 01: dirs:<local_path>__REVERSESSH_PORT__<sshfs_port>
           line 02: ssh port:<sshfs_port>
           line 03: Host:<client_ip>
           line 04: User:<user>
           line 05: inserted, sshfs  -o <options> \
                       "<user">@<client_ip>:"<local_path>" \
                       "<server_path>" -p <sshfs_port>
           line 06: mount <local_path> ok
           line 07: fname: <desktop_icon_name>

       If mounting of a client folder fails, either of the errors is returned (on stdout):

           error 01: mounting of <local_path> failed
           error 02: insertion of <local_path> failed (already mounted?), not mounting

       As exitcode x2gomoundirs always returns 0.

SEE ALSO

       x2goumount-session(8)

AUTHOR

       This  manual  has  been  written  by Mike Gabriel <mike.gabriel@das-netzwerkteam.de> for the X2Go project
       (https://www.x2go.org).

Version 4.1.0.6                                     Aug 2023                                    x2gomountdirs(8)