First part of YODL converted documentation.
[ira/wip.git] / docs / yodldocs / samba.7.yo
1 mailto(samba-bugs@samba.anu.edu.au)
2 manpage(samba)(7)(23 Oct 1998)()()
3 manpagename(Samba)(A Windows fileserver for UNIX)
4 manpagesynopsis()
5 bf(Samba)
6
7
8 manpagedescription()
9
10 The Samba software suite is a collection of programs that implements
11 the Server Message Block(commenly abbreviated as SMB) protocol for
12 UNIX systems. This protocol is sometimes also referred to as the
13 Common Internet File System (CIFS), LanManager or NetBIOS protocol.
14
15 manpagesection(COMPONENTS)
16
17 The Samba suite is made up of several components. Each component is
18 described in a separate manual page. It is strongly recommended that
19 you read the documentation that comes with Samba and the manual pages
20 of those components that you use. If the manual pages aren't clear
21 enough then please send a patch to email(samba-bugs@samba.anu.edu.au).
22
23 startdit() 
24
25 dit(bf(smbd)) nl() The bf(smbd) (8) daemon provides the file and print
26 services to SMB clients, such as Windows 95/98, Windows NT, Windows
27 for Workgroups or LanManager. The configuration file for this daemon
28 is described in bf(smb.conf) (5).
29
30 dit(bf(nmbd)) nl() The bf(nmbd) (8) daemon provides NetBIOS
31 nameserving and browsing support. The configuration file for this
32 daemon is described in bf(smb.conf) (5).
33
34 dit(bf(smbclient)) nl() The bf(smbclient) (1) program implements a simple
35 ftp-like client. This is useful for accessing SMB shares on other
36 compatible servers (such as Windows NT), and can also be used to allow
37 a UNIX box to print to a printer attached to any SMB server (such as a
38 PC running Windows NT).
39
40 dit(bf(testparm)) nl() The bf(testparm) (1) utility allows you to test your
41 bf(smb.conf) (5) configuration file.
42
43 dit(bf(smbstatus)) nl() The bf(smbstatus) (1) utility allows you to tell
44 who is currently using the bf(smbd) (8) server.
45
46 dit(bf(nmblookup)) nl() the bf(nmblookup) (1) utility allows NetBIOS
47 name queries to be made from the UNIX machine. 
48
49 enddit()
50
51 manpagesection(AVAILABILITY)
52
53 The Samba software suite is licensed under the GNU Public License
54 (GPL). A copy of that license should have come with the package in the
55 file COPYING. You are encouraged to distribute copies of the Samba
56 suite, but please keep obey the terms of this license.
57
58 The latest version of the Samba suite can be obtained via anonymous
59 ftp from samba.anu.edu.au in the directory pub/samba/. It is
60 also available on several mirror sites worldwide.
61
62 You may also find useful information about Samba on the newsgroup
63 comp.protocols.smb and the Samba mailing list. Details on how to join
64 the mailing list are given in the README file that comes with Samba.
65
66 If you have access to a WWW viewer (such as Netscape or Mosaic) then
67 you will also find lots of useful information, including back issues
68 of the Samba mailing list, at
69 url(http://samba.anu.edu.au/samba/)(http://samba.anu.edu.au/samba/).
70
71 manpagesection(VERSION)
72
73 This man page is current for version 2.0 of Samba
74
75 manpagesection(CONTRIBUTIONS)
76
77 If you wish to contribute to the Samba project, then I suggest you
78 join the Samba mailing list at email(samba@samba.anu.edu.au). See the
79 Web page at
80 url(http://samba.anu.edu.au/listproc)(http://samba.anu.edu.au/listproc)
81 for details on how to do this.
82
83 If you have patches to submit or bugs to report then you may mail them
84 directly to email(samba-bugs@samba.anu.edu.au). Note, however, that due to
85 the enormous popularity of this package the Samba Team may take some
86 time to repond to mail. We prefer patches in em(diff -u) format.
87
88 manpagesection(AUTHOR)
89
90 The main author of the Samba suite is Andrew Tridgell. He may be
91 contacted via e-mail at email(samba-bugs@samba.anu.edu.au). Samba is
92 now maintained by a distributed group of people around the world
93 collectively known as the Samba Team.
94
95 manpagesection(CREDITS)
96
97 Contributors to the project are now too numerous to mention here but
98 all deserve the thanks of all Samba users. To see a full list, look at
99 url(ftp://samba.anu.edu.au/pub/samba/alpha/change-log)(ftp://samba.anu.edu.au/pub/samba/alpha/change-log)
100 for the pre-CVS changes and at
101 url(ftp://samba.anu.edu.au/pub/samba/alpha/cvs.log)(ftp://samba.anu.edu.au/pub/samba/alpha/cvs.log)
102 for the contributors to Samba post-CVS. CVS is the Open Source source
103 code control system used by the Samba Team to develop Samba. The
104 project would have been unmanageable without it.
105
106 In addition, several commercial organisations now help fund the Samba
107 Team with money and equipment. For details see the Samba Web pages at
108 url(http://samba.anu.edu.au/samba/samba-thanks.html)(http://samba.anu.edu.au/samba/samba-thanks.html).
109
110 manpageauthor()
111
112 The original Samba man pages were written by Karl Auer. The man page
113 sources were converted to YODL format (another excellent piece of Open
114 Source software) and updated for the Samba2.0 release by Jeremy
115 Allison.
116