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 firstname.lastname@example.org.
The following daemons come with Samba-TNG. Read
smb.conf(5) how to configure them.
browserd(8) daemon controls the domain browse lists.
lsarpcd(8) daemon provides support for the Local
Security Authority, which is used to resolve account information.
netlogond(8) daemon provides Authentication services
for user and machine (trust) accounts.
daemon provides NetBIOS nameserving and browsing support.
samrd(8) daemon provides management services for
accessing the SAM database. Samba-TNG's samedit command makes use of these
daemon provides the file and print services to SMB clients, such as
Windows 95/98, Windows NT, Windows for Workgroups or LanManager.
spoolssd(8) daemon provides NT style print services.
srvsvcd(8) daemon provides services for remote
administration of a server.
svcctld(8) daemon provides remote service control
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.
winregd(8) daemon provides remote registry services.
Windows' REGEDIT.EXE and REGEDT32.EXE and Samba-TNG's regedit make use of these
wkssvcd(8) daemon provides services like that of
Windows NT's Workstation service.
Programs and Utilities
The following tools come with Samba-TNG:
make_smbcodepage(1) utility allows you to
create SMB code page definition files for your smbd(8)
nmblookup(1) utility allows NetBIOS name queries to
be made from the UNIX machine.
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.
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).
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.
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).
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.
smbspool(8) program is a very small print spooling
program that sends a print file to an SMB printer.
smbstatus(1) utility allows you list current
connections to the smbd(8) server.
smbtar(1) utility is a very small shell script on top of
smbclient(1) which dumps SMB shares directly to tape.
testparm(1) utility allows you to test your
smb.conf(5) configuration file.
testprns(1) utility allows you to test the printers
defined in your printcap file.
wbinfo(1) program queries and returns information
created and used by the winbindd(8) daemon.
The following file formats are defined within Samba-TNG:
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.
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.
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
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 email@example.com. 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
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
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.