SUSMB(1)

NAME
susmb - Mount SMB/CIFS shares via FUSE

SYNOPSIS
susmb [-d] [-f] [-v] [-o options] [-u user] [-g gid] URI mountpoint

URI is in the format: smb://domain\someuser@192.168.1.1/Storage

The password can be specified with the environment variable SMB_PASS. If the variable is not set then the password is read from the tty.

DESCRIPTION
susmb mounts SMB and CIFS shares through FUSE, including Samba shares and Windows shared folders. Unlike some other such filesystems, susmb can mount shares from any server, including those not browsable or advertised on the network.

The options are as follows:

-d  Debug mode.

-f  Foreground operation (i.e. don't daemonise).

-v  Show susmb, FUSE and Samba versions and exit.

-o options
    Additional list of FUSE options as a comma-separated list. These options are platform-specific, see the man page of your FUSE implementation for the supported options.

-u user
    Privdrop to user. When a name is given then the uid and gid is read from the password database entry. Otherwise the option is interpreted as an uid number and the gid number needs to be specified as well.

-g gid
    Privdrop to group. This option is interpreted as an gid number.

Both a uid and gid should be specified or resolved to be able to use privdrop.

EXIT STATUS

EXAMPLES

    SMB_PASS="password" susmb -u hiltjo -f -o 'uid=1000,gid=1000,allow_other' "smb://domain\someuser@192.168.1.1/Storage" /mnt/share

SEE ALSO
fusermount(1), fuse_mount(3), mount.cifs(8), umount.cifs(8)

AUTHORS
Hiltjo Posthuma <hiltjo@codemadness.org>

usmb authors:

Geoff Johnstone, with contributions from Jonathan Schultz, Stijn Hoop, Nigel Smith and Michal Suchanek.

CAVEATS

When running susmb as a privilege-dropped user on Linux there may be issues unmounting the network share in a clean manner. A workaround could be a shellscript wrapper that does something like:

trap 'umount /mnt/testshare' INT TERM EXIT