Smbnetfs

From Gentoo Wiki
Jump to: navigation, search
This page contains changes which are not marked for translation.

This article is a stub. You can help by expanding it.
Resources

smbnetfs is a FUSE-based filesystem for SMB/CIFS shares. It enables each user to mount Window's based network shares within their own userspace.

Installation

Kernel

See the Kernel section of the FUSE article for kernel confirmation.

USE flags

Cannot load package information. Is the atom net-fs/smbnetfs correct?

Emerge

Install the userspace utilities:

root #emerge --ask net-fs/smbnetfs

Configuration

Files

Import files related to smbnetfs include:

  • ~/.smb/smbnetfs.conf - The local (user-specific) configuration file. This file is not installed in user home directories by default (see below).

Credentials

Create the ~/.smb directory, then copy the configuration file to the configuration location. Note: depending on which version of the software was installed, the filesystem path could change. Determining the version of the software Portage installed will help determine the name of the first network path in the bunzip2 command:

user $mkdir ~/.smb
user $bunzip2 -c /usr/share/doc/smbnetfs-0.6.0/smbnetfs.conf.bz2 > ~/.smb/smbnetfs.conf

Next, modify the configuration file in order to gain network authentication. There are different methods of inputting authentication credentials: GNOME Keyring (which can be effective if the GNOME desktop environment is being used) or username/password fields in the smbnetfs.conf file itself.

For example, when entering username/password in the configuration file, uncomment the following line and add appropriate values. guest should be substituted with the username and the next set of quotes should include the password:

FILE ~/.smb/smbnetfs.conf
#auth                   "guest" ""
Warning
Anyone who has access to read the files in the user's home directory will be able to see the username/password information contained in the ~/.smb/smbnetfs.conf file above. Lock down the /home directory for maximum security.

Usage

Invocation

smbnetfs needs to know where to mount the shares. If a directory for them does not yet exist create one, then mount things there:

user $mkdir ~/mnt
user $smbnetfs ~/mnt

Removal

Unmerge

root #emerge --ask --unmerge net-fs/smbnetfs

See also

  • Samba - A re-implementation of the SMB/CIFS networking protocol.

External resources