usmb(1)

NAME
usmb - Mount SMB/CIFS shares via FUSE

SYNOPSIS
usmb [-c file] [-d] [-f] mount_id
usmb [-c file] -u mount_id

DESCRIPTION

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

Shares, usernames and other details are defined in a configuration file, by default ${HOME}/.usmb.conf.

OPTIONS

-c file, --config=file
    Use file rather than ${HOME}/.usmb.conf as the configuration file.

-d, --debug
    Debug mode.

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

-h, --help
    Show usage information and exit.

-u, --unmount
    Unmount the given filesystem.

-v, --version
    Show usmb, FUSE and Samba versions and exit.

CONFIGURATION

usmb uses the configuration file ${HOME}/.usmb.conf to define shares and the credentials used to access them. The configuration file is an XML file with two main elements: credentials and mounts. The file can contain any number of credentials and mounts elements; the whole file is wrapped in a usmbconfig element.

  Credentials

  <credentials id="ID used in mount elements">
    <domain>domain or workgroup</domain>
    <username>username</username>
    <password>password (optional)</password>
  </credentials>

Each credentials element defines a domain/username/password triple. If you omit the <password> element then usmb will prompt for a password when the credentials are used.

  Mounts

  <mount id="mount_id" credentials="ID of credentials to use">
    <server>hostname or IP address of server</server>
    <share>share name</share>
    <mountpoint>/path/to/mount/point</mountpoint>
    <options>mount options</options>
  </mount>

A mount element describes a share. The id attribute is given on the usmb command line to identify the share to mount. The credentials attribute identified the id of the credentials element to use. The (optional) options element gives a comma-separated list of FUSE mount options:

hard_remove
    Immediate removal (don't hide files)

umask=M
    Set file permissions (octal)

uid=N
    Set file owner

gid=N
    Set file group

allow_other
    Allow access to other users

allow_root
    Allow access to root

nonempty
    Allow mount over non-empty directory

  Example

<?xml version="1.0" encoding="ISO-8859-1"?>
<usmbconfig>
  <credentials id="cred1">
    <domain>WORKGROUP</domain>
    <username>user</username>
    <password>pass</password>
  </credentials>
  <credentials id="cred2">
    <domain>mydomain</domain>
    <username>anotheruser</username>
    <!-- No password element => prompt for password at runtime. -->
  </credentials>
  <mount id="home" credentials="cred1">
    <server>192.168.0.5</server>
    <share>myshare</share>
    <mountpoint>/tmp/smb</mountpoint>
  </mount>
  <mount id="music" credentials="cred2">
    <server>winbox</server>
    <share>music</share>
    <!-- You can use ~/xyz or ~user/xyz for the mountpoint. -->
    <mountpoint>~/music</mountpoint>
    <options>allow_root</options>
  </mount> </usmbconfig>

This defines two shares:
    \\192.168.0.5\myshare on /tmp/smb authenticating as WORKGROUP\user
    \\winbox\music on ${HOME}/music authenticating as mydomain\anotheruser

These can be mounted using "usmb home" or "usmb music".

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

FILES
${HOME}/.usmb.conf

BUGS

usmb should not require a configuration file. The configuration file can provide defaults but you should be able to specify everything necessary on the command line.

usmb does not support Kerberos / GSSAPI authentication, although a development branch exists with preliminary support.

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

COPYING
Copyright © 2006-2013 Geoff Johnstone.
Licence: GNU GPL version 3 <http://gnu.org/licenses/gpl.html>.