Samba (7)


20 Aug 2005


Samba-TNG - A Windows SMB/CIFS fileserver for UNIX




The Samba-TNG software suite is a collection of programs that implements the Server Message Block (commonly abbreviated as SMB) protocol for UNIX systems. This protocol is sometimes also referred to as the Common Internet File System (CIFS), LanManager or NetBIOS protocol.


The Samba-TNG suite is made up of several components. Each component is described in a separate manual page. It is strongly recommended that you read the documentation that comes with Samba and the manual pages of those components that you use. If the manual pages aren't clear enough then please send a patch or bug report to


The following daemons come with Samba-TNG. Read smb.conf(5) how to configure them.


The browserd(8) daemon controls the domain browse lists.


The lsarpcd(8) daemon provides support for the Local Security Authority, which is used to resolve account information.


The netlogond(8) daemon provides Authentication services for user and machine (trust) accounts.


The nmbd(8) daemon provides NetBIOS nameserving and browsing support.


The samrd(8) daemon provides management services for accessing the SAM database. Samba-TNG's samedit command makes use of these services.


The smbd(8) daemon provides the file and print services to SMB clients, such as Windows 95/98, Windows NT, Windows for Workgroups or LanManager.


The spoolssd(8) daemon provides NT style print services.


The srvsvcd(8) daemon provides services for remote administration of a server.


The svcctld(8) daemon provides remote service control services.


The winbindd(8) daemon provides a service for the Name Service Switch capability that is present in most modern C libraries. The Name Service Switch allows user and system information to be obtained from different databases services such as NIS or DNS. It can be configured through the /etc/nsswitch.conf file. The service provided by winbindd(8) is called `winbind' and can be used to resolve user and group information from a Windows NT server. The service can also provide authentication services via an associated PAM module.


The winregd(8) daemon provides remote registry services. Windows' REGEDIT.EXE and REGEDT32.EXE and Samba-TNG's regedit make use of these services.


The wkssvcd(8) daemon provides services like that of Windows NT's Workstation service.

Programs and Utilities

The following tools come with Samba-TNG:


The make_smbcodepage(1) utility allows you to create SMB code page definition files for your smbd(8) server.


The nmblookup(1) utility allows NetBIOS name queries to be made from the UNIX machine.


The regedit(1) program is a client that implements the registry editing side of all rpcclient(8) commands. The corresponding NT server program is REGEDT32.EXE.


The rpcclient(8) program is a client that can 'talk' to an SMB/CIFS MSRPC server. Operations include things like managing a SAM Database (users, groups and aliases) in the same way as the Windows NT programs User Manager for Domains and Server Manager for Domains; managing a remote registry in the same way as the Windows NT programs REGEDT32.EXE and REGEDIT.EXE; viewing a remote event log (same as EVENTVWR.EXE).


The samedit(8) program is a client that implements the SAM database side of all rpcclient commands. The corresponding NT server programs are User Manager for Domains and Server Manager for Domains.


The smbclient(1) program implements a simple ftp-like client. This is useful for accessing SMB shares on other compatible servers (such as Windows NT), and can also be used to allow a UNIX box to print to a printer attached to any SMB server (such as a PC running Windows NT).


The smbsend(1) program sends a SMB (also known as "WinPopup") message to one or more remote computers. This is the equivalent to Microsoft's NET SEND command, but a lot more powerful.


The smbspool(8) program is a very small print spooling program that sends a print file to an SMB printer.


The smbstatus(1) utility allows you list current connections to the smbd(8) server.


The smbtar(1) utility is a very small shell script on top of smbclient(1) which dumps SMB shares directly to tape.


The testparm(1) utility allows you to test your smb.conf(5) configuration file.


The testprns(1) utility allows you to test the printers defined in your printcap file.


The wbinfo(1) program queries and returns information created and used by the winbindd(8) daemon.

File Formats

The following file formats are defined within Samba-TNG:


The lmhosts(5) file format is the Samba-TNG NetBIOS name to IP address mapping file. It is very similar to the /etc/hosts file format, except that the hostname component must correspond to the NetBIOS naming format.


The smb.conf(5) file is a configuration file for the Samba-TNG suite. smb.conf(5) contains runtime configuration information for the Samba-TNG programs.


The smbpasswd(5) file format is very similar to the familiar Unix passwd(5) file format.


The Samba-TNG software suite is licensed under the GNU Public License (GPL). A copy of that license should have come with the package in the file COPYING. You are encouraged to distribute copies of the Samba-TNG suite, but please obey the terms of this license.

The latest version of the Samba-TNG suite can be obtained via http from or via anonymous CVS - see instructions on

You may also find useful information about Samba-TNG on the Samba-TNG Forum or on the Samba-TNG mailing list. Details on how to join the mailing list are given at


If you wish to contribute to the Samba-TNG project, then it is suggested you join on one of the Samba-TNG mailing lists. See the Web page at for details on how to do this.

If you have patches to submit or bugs to report then you may mail them directly to Note, however, that due to the very small team it may take some time to respond to mail. We prefer patches in diff -u format.


There are very few Contributors to the project and thus all deserve the special thanks of all Samba-TNG users. To see a full list, look at


The original Samba software and related utilities were created by Andrew Tridgell. Samba-TNG is now developed as an independent project by the Samba-TNG Team as an Open Source project similar to the way the Linux kernel is developed.

The original Samba man pages were written by Karl Auer. The man page sources were converted to YODL format (another excellent piece of Open Source software, available at and updated for the Samba2.0 release by Jeremy Allison. It was modified March 2000 by Matthew Geddes to include (very basic) information about the new Samba-TNG daemons and support programs.

In 2005 the basic informations to the daemons and support programs where continued and the informations to the Samba-TNG project were refreshed.