Documentation: fusermount vs fusermount3

Suspected Bug
1

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!

2

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?

3

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.

4

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

5

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!

6

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
7

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.