susmb.1 - susmb - fork from usmb 20130204: mount SMB/CIFS shares via FUSE
 (HTM) git clone git://git.codemadness.org/susmb
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) 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\\someuser@192.168.1.1/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 the
           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 privdrop.
           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' "smb://domain\\someuser@192.168.1.1/Storage" /mnt/share
           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 hiltjo@codemadness.org
           71 .Pp
           72 usmb authors:
           73 .Pp
           74 Geoff Johnstone, with contributions from Jonathan Schultz, Stijn Hoop, Nigel
           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