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.