rfsd

NAME
SYNOPSIS
OPTIONS
DESCRIPTION
SECURITY NOTES
EXAMPLES
AUTHORS
REPORTING BUGS
COPYING
SEE ALSO

NAME

rfsd − remotefs server

SYNOPSIS

rfsd [OPTIONS]

OPTIONS

−h

Show help

−v

Print version

−a ADDRESS[,ADDRESS[,ADDRESS[,...]]]

Listen for connections on ADDRESS(es). You can specify up to 16 addresses to listen to.

−p PORT

Listen for connections on PORT

−u USERNAME

Worker process be running with privileges of USERNAME

−r PATH

Change pidfile path from default to PATH

-e PATH

Load exports from PATH

-s PATH

Load passwords from PATH

-q

Suppress warnings

DESCRIPTION

rfsd may work in two modes:

Just file server
For this mode all users may be authenticated by IP-address or login and password. All users will be able to read files in exported directory and write to files unless there is an "ro" option specified for this export.

rfsd worker process will be running with privileges of user (and group) specified by -u and -g options (root by default). Alternatively, worker process user and group may be overridden by specifying "user=" and "group=" options for a particular export.

UGO compatibility mode
For this mode, rfsd will log the user into the server’s OS. It’s like remote shell, but without the actual shell, just for file access. To enable this mode, set option "ugo" for export(s).

If ugo option is specified, -u and -g options in rsfd command line as well as "user=", "group=" and "ro" options in exports file are ignored.

You need to create system users with the same names as remotefs users. However, rfsd will not use system passwords database for authentication, it will use rfspasswd database instead.

In this mode users could use chown and chmod commands to set access rights. Remote and local systems should be synced for this mode to work fully. Otherwise the server may refuse to set the owner if it isn’t aware of the specified user or group and the client may report the wrong owner or group.

See rfs(1) for description of side effects of unsynced systems at client’s side.

SECURITY NOTES

Official recommendation for remotefs is to keep it away from untrusted networks. You normally setup rfsd to listen on a local network. If you absolutely need to use it over the Internet, you should at least firewall the connection with a specific IP-address.

Please consider this advice seriously.

BTW, rfsd will warn you about listening on an interface that is not local and will refuse to run until -q option is provided, or a local interface is specified.

EXAMPLES

Please refer to examples in /etc/rfs-exports

AUTHORS

Aleksey Tulinov: aleksey_t@users.sourceforge.net
Jean−Jacques Sarton: jjsarton@users.sourceforge.net

REPORTING BUGS

See remotefs project on SourceForge: http://remotefs.sourceforge.net/

COPYING

GNU General Public License (GPL)

SEE ALSO

rfs(1), rfspasswd(8)