susmb.1 - susmb - fork from usmb 20130204: mount SMB/CIFS shares via FUSE
HTML git clone git://git.codemadness.org/susmb
DIR Log
DIR Files
DIR Refs
DIR README
DIR LICENSE
---
susmb.1 (2163B)
---
1 .Dd February 23, 2026
2 .Dt SUSMB 1
3 .Os
4 .Sh NAME
5 .Nm susmb
6 .Nd Mount SMB/CIFS shares via FUSE
7 .Sh SYNOPSIS
8 .Nm
9 .Op Fl d
10 .Op Fl f
11 .Op Fl v
12 .Op Fl o Ar options
13 .Op Fl u Ar user
14 .Op Fl g Ar gid
15 .Ar URI
16 .Ar mountpoint
17 .Pp
18 .Ar URI
19 is in the format: smb://domain\\someuser@192.168.1.1/Storage
20 .Pp
21 The password can be specified with the environment variable
22 .Ev SMB_PASS .
23 If the variable is not set then the password is read from the tty.
24 .Sh DESCRIPTION
25 .Nm
26 mounts SMB and CIFS shares through FUSE, including Samba shares and
27 Windows shared folders.
28 Unlike some other such filesystems,
29 .Nm
30 can mount
31 shares from any server, including those not browsable or advertised on the
32 network.
33 .Pp
34 The options are as follows:
35 .Bl -tag -width Ds
36 .It Fl d
37 Debug mode.
38 .It Fl f
39 Foreground operation (i.e. don't daemonise).
40 .It Fl v
41 Show
42 .Nm ,
43 FUSE and Samba versions and exit.
44 .It Fl o Ar options
45 Additional list of FUSE options as a comma-separated list.
46 These options are platform-specific, see the man page of your FUSE
47 implementation for the supported options.
48 .It Fl u Ar user
49 Privdrop to user.
50 When a name is given then the uid and gid is read from the password
51 database entry.
52 Otherwise the option is interpreted as an uid number and the gid number needs
53 to be specified as well.
54 .It Fl g Ar gid
55 Privdrop to group.
56 This option is interpreted as an gid number.
57 .El
58 .Pp
59 Both a uid and gid should be specified or resolved to be able to use privdrop.
60 .Sh EXIT STATUS
61 .Ex -std
62 .Sh EXAMPLES
63 .Bd -literal
64 SMB_PASS="password" susmb -u hiltjo -f -o 'uid=1000,gid=1000,allow_other' "smb://domain\\someuser@192.168.1.1/Storage" /mnt/share
65 .Ed
66 .Sh SEE ALSO
67 .Xr fusermount 1 ,
68 .Xr fuse_mount 3 ,
69 .Xr mount.cifs 8 ,
70 .Xr umount.cifs 8
71 .Sh AUTHORS
72 .An Hiltjo Posthuma Aq Mt hiltjo@codemadness.org
73 .Pp
74 usmb authors:
75 .Pp
76 Geoff Johnstone, with contributions from Jonathan Schultz, Stijn Hoop, Nigel
77 Smith and Michal Suchanek.
78 .Sh CAVEATS
79 .Bl -item
80 .It
81 When running
82 .Nm
83 as a privilege-dropped user on Linux there may be issues unmounting the
84 network share in a clean manner.
85 A workaround could be a shellscript wrapper that does something like:
86 .Pp
87 trap 'umount /mnt/testshare' INT TERM EXIT
88 .El