Documentation: fusermount vs fusermount3

I noticed rclone now uses fusermount3 (fuse3) to mount filesystems but the documentation and some code fragments (eg vfs/vfstest/submount.go) still reference (or calls) the older fusermount.

The documentation would be easy enough to clean up, but I'm not sure about all the code calls!

There has been discussion about this - eg Please consider to offer fusermount backward compatibility · libfuse/libfuse · Discussion #1007 · GitHub

This is all a bit of a mess IMHO. On my system fusermount is a symlink to fusermount3 which I think is probably the best way of dealing with it.

In the tests we only ever call fusermount -u I think which should be good with all fusermount versions.

I'm not sure all systems have a fusermount3.

Note that cmount via cgofuse still uses libfuse2 I think (not 100% sure).

Did you come across a specific system that this is causing a problem for?

Yeah on my old CentOS 7 machine and my Rocky 8 machines I had fuse (fuse-2.9.x RPM) installed and rclone mount failed because it needed fusermount3; I had to additionally install fuse3.

So now I have two versions of FUSE installed

% rpm -qf /usr/bin/fusermount /usr/bin/fusermount3
fuse-2.9.2-11.el7.x86_64
fuse3-3.6.1-4.el7.x86_64

I guess, in theory, I could remove fuse-2.9.2 and only have fusermount3 installed.

The current documentation says that I need fusermount and makes no mention of fusermount3 at all. At the very least that needs updating.

Do you want to make a PR for that?

I note that cgofuse and hence rclone cmount on Linux will use fusermount not fusermount3

Just to confuse things further.

But on Linux rclone mount (definitely) and rclone mount2 (not 100% sure) use fusermount3

Not really, because I don't know if it also impacts nfsmount and oracle...

docs/content/commands/rclone_nfsmount.md
docs/content/commands/rclone_mount.md
docs/content/oracleobjectstorage/tutorial_mount.md

all refer to fusermount!

Ok I've had a go at that. I've hedged a bit whether you need fusermount or fusermount3 just noted the possibility.

nfsmount needs umount so I've put that in the doc too.

1 Like