---
name: "smbnetfs"
section: "1"
platform: "linux"
package: "smbnetfs"
version: "0.6.3-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/smbnetfs"
---

# smbnetfs(1)

User-space filesystem for SMB/NMB (Windows) network servers and shares

## NAME

smbnetfs - User-space filesystem for SMB/NMB (Windows) network servers and shares

## DESCRIPTION

usage: smbnetfs mountpoint \[options\]

### general options:

- **-o** opt,\[opt...\]

  mount options

- **-h** **--help**

  print help

- **-V** **--version**

  print version

### SMBNetFS options:

- **-o** config=PATH

  path to config (~/.smb/smbnetfs.conf)

- **-o** smbnetfs\_debug=N

  SMBNetFS debug level (N\<=10)

- **-o** smb\_debug\_level=N

  Samba debug level (N\<=10)

- **-o** log\_file=PATH

  File to store SMBNetFS debug messages

- **-o** local\_charset=CHARSET

  Local charset (autodetected)

- **-o** samba\_charset=CHARSET

  Charset used by samba (utf-8)

- **-o** use\_libsecret=BOOL

  Enable/disable usage of libsecret as a password storage

- **-o** libsecret\_timeout=T

  auth retrieving timeout from libsecret base (500ms)

- **-o** max\_rw\_block\_size=N

  Maximum size of r/w block in Kb (autodetected)

- **-o** smb\_tree\_scan\_period=T

  Period of scanning samba network tree (300s)

- **-o** smb\_tree\_elements\_ttl=T

  TTL of scanned elements in samba tree (900s)

- **-o** smb\_query\_browsers=BOOL

  Enable/disable scanning of samba tree (on)

- **-o** smb\_timeout=T

  Samba reply timeout (20000ms))

- **-o** show\_$\_shares=BOOL

  Enable/disable showing of hidden shares (off)

- **-o** show\_hidden\_hosts=BOOL

  See in documentation (off)

- **-o** free\_space\_size=N

  Free space size in pages (0)

- **-o** quiet\_flag=BOOL

  Do not fail on chown/chgroup (on)

- **-o** neg\_cache=BOOL

  Enable/disable negative cache (on)

- **-o** neg\_cache\_timeout=T

  Negative cache records expiration time (3000ms)

- **-o** stat\_workaround\_depth=N

  konquerror and gnome terminal hack (3)

- **-o** time\_step=T

  Scheduler sleep interval (10s)

- **-o** config\_update\_period=T

  Configuration update interval (300s)

- **-o** max\_ctx\_count=N

  Maximum number of children processes (15)

- **-o** max\_retry\_count=N

  Number of retries before fail (2)

- **-o** listen\_timeout=T

  Child process inactivity timeout (300s)

- **-o** reply\_timeout=T

  Child process reply timeout (30s)

- **-o** max\_passwd\_query\_count=N

  See in documentation (10)

### FUSE options:

- **-d** **-o** debug

  enable debug output (implies **-f**)

- **-f**

  foreground operation

- **-s**

  disable multi-threaded operation

- **-o** allow\_other

  allow access to other users

- **-o** allow\_root

  allow access to root

- **-o** auto\_unmount

  auto unmount on process termination

- **-o** nonempty

  allow mounts over non-empty file/dir

- **-o** default\_permissions

  enable permission checking by kernel

- **-o** fsname=NAME

  set filesystem name

- **-o** subtype=NAME

  set filesystem type

- **-o** large\_read

  issue large read requests (2.4 only)

- **-o** max\_read=N

  set maximum size of read requests

- **-o** hard\_remove

  immediate removal (don't hide files)

- **-o** use\_ino

  let filesystem set inode numbers

- **-o** readdir\_ino

  try to fill in d\_ino in readdir

- **-o** direct\_io

  use direct I/O

- **-o** kernel\_cache

  cache files in kernel

- **-o** \[no\]auto\_cache

  enable caching based on modification times (off)

- **-o** umask=M

  set file permissions (octal)

- **-o** uid=N

  set file owner

- **-o** gid=N

  set file group

- **-o** entry\_timeout=T

  cache timeout for names (1.0s)

- **-o** negative\_timeout=T

  cache timeout for deleted names (0.0s)

- **-o** attr\_timeout=T

  cache timeout for attributes (1.0s)

- **-o** ac\_attr\_timeout=T

  auto cache timeout for attributes (attr\_timeout)

- **-o** noforget

  never forget cached inodes

- **-o** remember=T

  remember cached inodes for T seconds (0s)

- **-o** nopath

  don't supply path if not necessary

- **-o** intr

  allow requests to be interrupted

- **-o** intr\_signal=NUM

  signal to send on interrupt (10)

- **-o** modules=M1\[:M2...\]

  names of modules to push onto filesystem stack

- **-o** max\_write=N

  set maximum size of write requests

- **-o** max\_readahead=N

  set maximum readahead

- **-o** max\_background=N

  set number of maximum background requests

- **-o** congestion\_threshold=N

  set kernel's congestion threshold

- **-o** async\_read

  perform reads asynchronously (default)

- **-o** sync\_read

  perform reads synchronously

- **-o** atomic\_o\_trunc

  enable atomic open+truncate support

- **-o** big\_writes

  enable larger than 4kB writes

- **-o** no\_remote\_lock

  disable remote file locking

- **-o** no\_remote\_flock

  disable remote file locking (BSD)

- **-o** no\_remote\_posix\_lock

  disable remove file locking (POSIX)

- **-o** \[no\_\]splice\_write

  use splice to write to the fuse device

- **-o** \[no\_\]splice\_move

  move data while splicing to the fuse device

- **-o** \[no\_\]splice\_read

  use splice to read from the fuse device

### Module options:

### \[iconv\]

- **-o** from\_code=CHARSET

  original encoding of file names (default: UTF-8)

- **-o** to\_code=CHARSET

  new encoding of the file names (default: UTF-8)

### \[subdir\]

- **-o** subdir=DIR

  prepend this directory to all paths (mandatory)

- **-o** \[no\]rellinks

  transform absolute symlinks to relative

## FILES

Please create configuration directory ~/.smb.  This directory should contain at least two files: smb.conf and smbnetfs.conf. You may copy smb.conf from the /etc/samba directory. You can find a sample of smbnetfs.conf in the  /etc directory.

## AUTHOR

This manual page was written by Varun Hiremath \<varunhiremath@gmail.com\> and lately updated by Mikhail Kshevetskiy \<mikhail.kshevetskiy@gmail.com\>, for the Debian project (but may be used by others).