Samba Client Howto
Julien Herbin Email : email@example.com
Don't hesitate to contact me in case you need any information. Please inform me of any mistake I may have done.
Last modified :
This Howto will show you how to browse a Microsoft Windows shared
directory and then mount it on your local Linux filesystem using SAMBA
It has been written with the Debian Linux distribution, because
packages management and dependencies is easy and commonplace through the APT command. It
doesn't mean that the configuration won't work with another Linux
distribution, since packages to install should be the same, but some
configuration files may be located in another directories of your
Installing the packages
First login as root in order to get the required packages.
You need to install both samba-common and smbclient packages. If you are using a Debian
distribution, then type in :
apt-get install smbclient
Maybe another packages will be installed since smbclient depends
"samba-common, libc6, libcupsys2, libncurses5, libpam0g, libreadline4".
Others will have to get those package installed another way (RPM for RedHat and Mandrake for instance).
If you intend to mount windows shared directly on your filesystem,
install the smbfs package. Note that to do so, you will need
to add "SMB Network FilesSystem" to your kernel or as a kernel module.
Just check the "SMB file system support" item in the "Filesystem =>
Network Filesystem" menu. Then rebuild you kernel and reboot, or
rebuild you modules and that's final ;).
For Debian users, then type in :
apt-get install smbfs
Others will have to get this package installed another way.
Now that install is complete, you should be asked your desired
Workgroup / Domain Name. You should enter here the same workgroup
(usually "mshome" by default on win2k and win XP).
Then you will be asked if you want to use password encryption. Answer yes.
Finally, answer yes to use WINS settings from DHCP if you have a Windows DHCP server running on a computer of your network (note that the package "dhcp3-client" should be installed
on you system to get this feature work correctly).
Altering the configuration file
In case you need to change the configuration you setted up just after installation, just edit the "/etc/samba/smb.conf" file.
Doing some tests
Shares directories browsing
Let's check that your installation is successfull and do a first browsing test.
My computer "Fraise" runs a Windows XP Home Edition with the guest login
on. So, i don't have to worry about a username/password to get to
access my shared directories. If you do need a username/password, then
add " -U your_username". Your password should be asked when press enter.
smbclient -L network_name_of_your_windows_computer
If your computer is called "fraise", then enter :
smbclient -L fraise
A password will be asked to you. If you set one on your Windows computer, then enter it now.
The result should look like the following :
[15:03:24][jam@cerise] ~$ smbclient -L fraise
Sharename Type Comment
--------- ---- -------
IPC$ IPC Distant IPC
print$ Disk Printers Drivers
hpdeskje Printer hp deskjet 845c
UtilZ Disk My read only shared directory
Upload Disk My read/write shared directory
Example of a manual mount
Now, lets assume the package "smbfs" is correctly installed and your
kernel or your modules include the "smbfs driver". We are going to
mount the "UtilZ" and the "Upload" directories from the computer called
Now try :
mount -t smb //fraise/UtilZ /mnt/smb_UtilZ_on_Fraise
Note that if you compiled "smb file system driver" as a module, it should load automaticaly :
[13:08:19][root@cerise] /mnt# lsmod
Module Size Used by
smbfs 68760 2
Automatic mount a startup
If the last step was successfull, you should not meet any kind of
problem here. Here are the lines to add to your "fstab" configuration
file (usually located in "/etc"). The last two lines are responsible for the two
shared directories mountage on startup.
The first one is mounted read-only whereas the second one is mounted read-write. If you have need "user name/password" to authentifiate, then add in the "<options>" column "username=your_user_name,password=your_password,ro,user".
You can set up your own options to give permissions on files and directories. For example, it is possible to assign au uid or a gid to the files and directories
Type "man smbmount" to get more details on options
If you feel like using a GUI
to manage your Samba mounts, you can use the program LinNeighborhood (http://www.bnro.de/~schmidjo/index.html
Run as root :
apt-get install linNeighborhood
To start the program, type in your favorit X console :
Please refer to program's homepage to get information.
See also the rewrited version for GTK+ 2 : PyNeighborhood