%general-entities; ]> $LastChangedBy$ $Date$ Samba-&samba3-version; Introduction to <application>Samba</application> The Samba package provides file and print services to SMB/CIFS clients and Windows networking to Linux clients. Package information Download (HTTP): Download (FTP): Download size: &samba3-size; Estimated Disk space required: &samba3-buildsize; Estimated build time: &samba3-time; Additional downloads Maintainer Recommended Patch: <application>Samba</application> dependencies Optional , , , or , , or , , and Valgrind Installation of <application>Samba</application> Install Samba by running the following commands: patch -Np1 -i ../samba-&samba3-version;-maintainer-1.patch && cd source && install -d /var/cache/samba && ./configure \ --prefix=/usr \ --sysconfdir=/etc \ --localstatedir=/var \ --with-piddir=/var/run \ --with-fhs \ --with-smbmount && make && make install && install -m755 nsswitch/libnss_win{s,bind}.so /lib && ln -sf libnss_winbind.so /lib/libnss_winbind.so.2 && ln -sf libnss_wins.so /lib/libnss_wins.so.2 && cp ../examples/smb.conf.default /etc/samba You may want to run configure with the --help parameter. There may be other parameters needed to take advantage of the optional dependencies. Installation command explanations install -d /var/cache/samba: This directory is needed for proper operation of the smbd and nmbd daemons. --sysconfdir=/etc: Sets the configuration file directory to avoid the default of /usr/etc. --localstatedir=/var: Sets the variable data directory to avoid the default of /usr/var. : Assigns all other file paths in a manner compliant with the Filesystem Hierarchy Standard (FHS). : Orders the creation of an extra binary for use by the mount command so that mounting remote SMB (Windows) shares becomes no more complex than mounting remote NFS shares. install -m755 nsswitch/libnss_win{s,bind}.so /lib: The nss libraries are not installed by default. If you intend to use winbindd for domain auth, and/or WINS name resolution, you need these libraries. ln -sf libnss_winbind.so /lib/libnss_winbind.so.2 and ln -sf libnss_wins.so /lib/libnss_wins.so.2: These symlinks are required by glibc to use the nss libraries. cp ../examples/smb.conf.default /etc/samba: This copies a default smb.conf into /etc/samba. This sample configuration will not work unless edited for your site, and renamed smb.conf. Configuring <application>Samba</application> Because of the various uses for Samba, complete configuration is well beyond the scope of the BLFS book. In fact, many complete books have been written on this topic alone. The included documentation, a popular book published by O'Reilly, can be viewed by pointing your web browser to . The built in SWAT (Samba Web Administration Tool) utility can be used for basic configuration, however, before using SWAT you must add an entry to /etc/services and make changes to your inetd/xinetd configuration. Add the swat entry to /etc/services with the following command: echo "swat 901/tcp" >> /etc/services If inetd is used, the following command will add the swat entry to /etc/inetd.conf: echo "swat stream tcp nowait.400 root /usr/sbin/swat swat" \ >> /etc/inetd.conf Issue a killall -HUP inetd to reread the changed inetd.conf file. If xinetd is used, the following command will add the swat entry to /etc/xinetd.conf: cat >> /etc/xinetd.conf << "EOF" service swat { port = 901 socket_type = stream wait = no only_from = 127.0.0.1 user = root server = /usr/sbin/swat log_on_failure += USERID } EOF Issue a killall -HUP xinetd to reread the changed xinetd.conf file. SWAT can be launched by pointing your web browser to . For your convenience, boot scripts have been provided for Samba. There are two included in the package. The first, samba, will start the smbd and nmbd daemons needed to provide SMB/CIFS services. The second script, winbind, starts the winbindd daemon, used for providing Windows domain services to Linux clients. Install the samba script with the following command: make install-samba If you also need the winbind script: make install-winbind Contents The Samba package contains make_smbcodepage, make_unicodemap, mount.smbfs, net, nmbd, nmblookup, rpcclient, smbcacls, smbclient, smbcontrol, smbd, smbpasswd, smbspool, smbstatus, swat, testparm, testprns, wbinfo and winbindd. Description make_smbcodepage make_smbcodepage converts text descriptions of code pages to binary code page files and vice versa. make_unicodemap make_unicodemap converts text Unicode map files to binary, for use in mapping characters to 16 bit Unicode. mount.smbfs mount.smbfs provides /bin/mount with a way to mount remote Windows (or Samba) fileshares. net net is a tool for administration of Samba and remote CIFS servers, similar to the net utility for DOS/Windows. nmbd nmbd is the Samba NetBIOS name server. nmblookup nmblookup is used to query NetBIOS names and map them to IP addresses. rpcclient rpcclient is used to execute MS-RPC client side functions. smbcacls smbcacls is used to manipulate NT access control lists. smbclient smbclient is a SMB/CIFS access utility, similar to FTP. smbcontrol smbcontrol is used to control running smbd, nmbd and winbindd daemons. smbd smbd is the main Samba daemon. smbpasswd smbpasswd changes a user's Samba password. smbspool smbspool sends a print job to an SMB printer. smbstatus smbstatus reports current Samba connections. swat swat is the Samba Web Administration Tool. testparm testparm checks an smb.conf file for proper syntax. testprns testprns tests printer names. wbinfo wbinfo queries a running winbindd daemon. winbindd winbindd resolves names from NT servers.