Samba (7)
Samba-TNG
20 Aug 2005
NAME
Samba-TNG - A Windows SMB/CIFS fileserver for UNIX
SYNOPSIS
Samba-TNG
DESCRIPTION
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.
COMPONENTS
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 tng-technical@samba-tng.org.
Daemons
The following daemons come with Samba-TNG. Read
smb.conf(5) how to configure them.
- browserd
-
The
browserd(8) daemon controls the domain browse lists.
- lsarpcd
-
The
lsarpcd(8) daemon provides support for the Local
Security Authority, which is used to resolve account information.
- netlogond
-
The
netlogond(8) daemon provides Authentication services
for user and machine (trust) accounts.
- nmbd
-
The nmbd(8)
daemon provides NetBIOS nameserving and browsing support.
- samrd
-
The
samrd(8) daemon provides management services for
accessing the SAM database. Samba-TNG's samedit command makes use of these
services.
- smbd
-
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.
- spoolssd
-
The
spoolssd(8) daemon provides NT style print services.
- srvsvcd
-
The
srvsvcd(8) daemon provides services for remote
administration of a server.
- svcctld
-
The
svcctld(8) daemon provides remote service control
services.
- winbindd
-
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.
- winregd
-
The
winregd(8) daemon provides remote registry services.
Windows' REGEDIT.EXE and REGEDT32.EXE and Samba-TNG's regedit make use of these
services.
- wkssvcd
-
The
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
-
The
make_smbcodepage(1) utility allows you to
create SMB code page definition files for your smbd(8)
server.
- nmblookup
-
The
nmblookup(1) utility allows NetBIOS name queries to
be made from the UNIX machine.
- regedit
-
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.
- rpcclient
-
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).
- samedit
-
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.
- smbclient
-
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).
- smbsend
-
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.
- smbspool
-
The
smbspool(8) program is a very small print spooling
program that sends a print file to an SMB printer.
- smbstatus
-
The
smbstatus(1) utility allows you list current
connections to the smbd(8) server.
- smbtar
-
The
smbtar(1) utility is a very small shell script on top of
smbclient(1) which dumps SMB shares directly to tape.
- testparm
-
The
testparm(1) utility allows you to test your
smb.conf(5) configuration file.
- testprns
-
The
testprns(1) utility allows you to test the printers
defined in your printcap file.
- wbinfo
-
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:
- lmhosts
-
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.
- smb.conf
-
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.
- smbpasswd
-
The
smbpasswd(5) file format is very similar to
the familiar Unix passwd(5) file format.
AVAILABILITY
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
http://download.samba-tng.org/tng/
or via anonymous CVS - see instructions on
http://www.samba-tng.org/cvs.html.
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
http://www.samba-tng.org/mailinglists.html.
CONTRIBUTIONS
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
http://www.samba-tng.org/mailinglists.html
for details on how to do this.
If you have patches to submit or bugs to report then you may mail them
directly to tng-technical@samba-tng.org. 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.
CREDITS
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
http://www.samba-tng.org/sponsors.html.
AUTHOR
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
ftp://ftp.icce.rug.nl/pub/unix/) 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.