fuse-nfs(1)

FUSE-NFS(1)

fuse-nfs

FUSE-NFS(1)

NAME

fuse-nfs - A FUSE filesystem for NFS

SYNOPSIS

fuse-nfs [ OPTIONS ]

fuse-nfs [-n --nfs-share=<NFS-URL>] [-m --mountpoint=<path>] [-a --allow-other] [-? --help] [--usage]

DESCRIPTION

fuse-nfs is a FUSE filesystem that implements the NFS protocol.

Example: Mounting a filesystem

$ fuse-nfs -n nfs://127.0.0.1/data/tmp -m /data/sahlberg/foo

Example: Unounting a filesystem

$ fusermount -u /data/sahlberg/foo

OPTIONS

-a --allow-user

By default, only the user that mounted the FUSE filesystem will be able to access it. Use this argument to make the filesystem accessible to all users.

-n --nfs-share=<NFS-URL>

Specify the server/export to mount.

-m --mountpoint=<path>

The local mountpoint to use.

-? --help

Display basic help text.

--usage

Display basic usage text.

NFS-URL

Libnfs uses RFC2224 style URLs extended with libnfs specific url arguments and some minor extensions. The basic syntax of these URLs is

	nfs://<server|ipv4|ipv6>/path[?arg=val[&arg=val]*]

URL Arguments:

tcp-syncnt=<int>

Number of SYNs to send during the session establish before failing setting up the tcp connection to the server.

uid=<int>

UID value to use when talking to the server. default it 65534 on Windows and getuid() on unixen.

gid=<int>

GID value to use when talking to the server. default it 65534 on Windows and getgid() on unixen.

readahead=<int>

Enable readahead for files and set the maximum amount of readahead to <int>.

auto-traverse-mounts=<0|1>

Should libnfs try to traverse across nested mounts automatically or not. Default is 1 == enabled.

ROOT VS NON-ROOT

NFS servers by default restrict access to only those clients that connect from a systems port, i.e. a port number less than 1024. In Un*x access to these ports are traditionally reserved to the root user which means that a non-root user will normally not be able to use fuse-nfs to access an NFS share.

There are two ways to solve this and allow non-root users to use fuse-nfs:

cap_net_bind_service

Adding this capability to the fuse-nfs binary the linux kernel will now allow the use of systems port for any user of this binary which will allow fuse-nfs to connect to the server.

$ sudo setcap 'cap_net_bind_service=+ep' fuse-nfs

insecure mode

Alternatively you can disable the check in the NFS server that blocks non-system ports from connecting. In Linux NFS servers this is done by adding the "insecure" option to /etc/exports