CIFS Client

Common Internet File System (CIFS) allows you to mount networked drives. You'll need a Internet connection for downloading the packages and a computer with CIFS/SAMBA server with some shares.

Note1: cifs mount is not compatible with luci (see #10366)
Note2: In r31584 the package cifsmount was replaced with cifs-utils


  • kmod-fs-cifs Package is required for the actual mounting of cifs drives.
  • cifsmount contains a helper program mount.cifs which can be used instead of mount -t cifs command. Personal note: On Backfire 10.03.1-rc6, I observed that cifsmount is necessary (in addition to kmod-fs-cifs). “mount -t cifs” fails without cifsmount.
  • kmod-nls-utf8 Native language support-Package is required for anonymous/guest access to cifs mounts. Otherwise, “mount error 83 = Can not access a needed shared library” results.
opkg install kmod-fs-cifs kmod-nls-base
opkg install kmod-nls-utf8 kmod-crypto-hmac kmod-crypto-md5 kmod-crypto-misc cifsmount

Note: kmod-crypto-misc for md4-hash algorithm --- ivang 2011/11/06 22:12

Options required for a successful mount vary by kernel version. Newer kernels require more options for a successful mount.

Example of authenticated share with options, kernel 3.14+

mount -t cifs //cifs-server/share /mnt -o username=admin,password=pwpwpw,sec=ntlm,file_mode=0644,unc=\\\\cifs-server\\share

Basic example of authenticated share (no options, may work with old kernels)

mount -t cifs //cifs-server/share /localfolder -o user=username,password=password

Same as above, but specifies more options

mount -t cifs //cifs-server/share /localfolder -o unc=\\\\cifs-server\\share,ip=IP-Address,user=john,pass=doe,dom=workgroup

Anonymous or guest share mounting, current 3.14+ kernels:

mount -t cifs //cifs-server/share /mnt/share -o user=,file_mode=0777,dir_mode=0777,unc=\\\\cifs-server\\share

Anonymous or guest share mounting, old version.

mount -t cifs '\\cifs-server\share' /localfolder -o guest,iocharset=utf8,file_mode=0777,dir_mode=0777,nounix,noserverino

Anonymous or guest share mounting. If you have a problems with mounting CIFS with Anonymous or guest share try this. Its known bug/issue on kernel 3.8.x.

mount.cifs //cifs-server/share /localfolder -o guest,sec=ntlm

And for fstab.

//wndr4300/extroot /mnt cifs username=root,password=72587258,sec=ntlm,file_mode=0777	 0	 0

Another example for fstab

//cifs-server/share /localfolder cifs credentials=/etc/samba_pswds_my_share,_netdev,uid=user,gid=group 0 0

where credentials file (chmod 0700) is formatted as


If the cifsmount package is installed the mount.cifs can be used be instead of mount -t cifs.

Check manpage of mount.cifs

Note: if you face the error “Value too large for defined data type”, use the option “nounix,noserverino” as per Samba FAQ

Since netfilter will track every connection, if you use MASQUERADING for example, you could disable conntrack'ing for data connection:

$IPT -t raw -A OUTPUT -o $IF_LAN -s $IP_LAN -p tcp --dport 139 -j CT --notrack #------------------ don't track SMB
$IPT -t raw -A OUTPUT -o $IF_LAN -s $IP_LAN -p tcp --dport 445 -j CT --notrack #------------------ don't track SMB
$IPT -t raw -A PREROUTING -o $IF_LAN -s $IP_LAN -p tcp --sport 139 -j CT --notrack #------------------ don't track SMB
$IPT -t raw -A PREROUTING -o $IF_LAN -s $IP_LAN -p tcp --sport 445 -j CT --notrack #------------------ don't track SMB

Note this is not the same as for the server, the source and destination ports differ. The INPUT is for when you read from the remote filesystem and the OUTPUT for when you write to it.

This website uses cookies. By using the website, you agree with storing cookies on your computer. Also you acknowledge that you have read and understand our Privacy Policy. If you do not agree leave the website.More information about cookies
  • Last modified: 2018/03/04 16:26
  • by