CIFS Client
Description
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 |
Packages
- 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.
Install
Required
opkg install kmod-fs-cifs
Optional
opkg install kmod-nls-utf8 kmod-nls-base kmod-crypto-hmac kmod-crypto-md5 kmod-crypto-misc cifsmount
Note: kmod-crypto-misc for md4-hash algorithm — ivang 2011/11/06 22:12
Examples
Basic example of authenticated share.
mount -t cifs //cifs-server/share /localfolder -o user=username,password=passwordSame 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=workgroupAnonymous or guest share mounting.
mount -t cifs '\\cifs-server\share' /localfolder -o guest,iocharset=utf8,file_mode=0777,dir_mode=0777,nounix,noserverinoAnonymous 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
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
Throughput Issues
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 NOTRACK #------------------ don't track SMB $IPT -t raw -A OUTPUT -o $IF_LAN -s $IP_LAN -p tcp --dport 445 -j NOTRACK #------------------ don't track SMB $IPT -t raw -A PREROUTING -o $IF_LAN -s $IP_LAN -p tcp --sport 139 -j NOTRACK #------------------ don't track SMB $IPT -t raw -A PREROUTING -o $IF_LAN -s $IP_LAN -p tcp --sport 445 -j 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.
NOTE: If you have problems
doc/howto/cifs.client.txt · Last modified: 2013/03/31 14:06 by hmlinaric
This text is licensed under a Creative Commons Attribution-ShareAlike 3.0 Unported License.
