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