1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
2<HTML>
3<HEAD>
4   <TITLE>Samba Release Notes</TITLE>
5</HEAD>
6<BODY>
7
8<H1>Samba Release Notes</H1>
9
10<P>
11<HR></P>
12
13<H2>Table of Contents</H2>
14
15<MENU>
16<LI><B><A HREF="#WHATIS">What is Samba?</A></B> </LI>
17
18<LI><B><A HREF="#Support">Support Policy</A> </B></LI>
19
20<LI><B><A HREF="#Installation">Installation Information</A> </B></LI>
21
22<LI><B><A HREF="legal_notice.html">Silicon
23Graphics Legal Notice</A> </B></LI>
24
25<LI><B><A HREF="#AUTHORNOTES">Author's Notice(s)</A> </B></LI>
26
27<LI><B><A HREF="#Documentation">Documentation Information</A> </B></LI>
28</MENU>
29
30<P>
31<HR></P>
32
33<H2><A NAME="WHATIS"></A>What is Samba?</H2>
34
35<P>Samba is an SMB client and server for Unix. It makes it possible for
36client machines running Windows 95 and Windows for Workgroups to access
37files and/or print services on a Unix system. Samba includes an SMB server
38to provide LanManager-style file and print services to PCs, a Netbios (RFC10001/1002)
39name server, and an FTP-like client application for accessing PC resources
40from Unix. </P>
41
42<P>To make Samba work you'll need to configure your server host to run
43<B>smbd</B> and <B>nmbd</B> whenever you connect to a certain Internet
44port from the client machine. <B>Smbd</B> and <B>nmbd</B> can be started
45either as daemons or from inetd.</P>
46
47<P>By default <B>smbd</B> and <B>nmbd</B> are started as daemons by the
48file <I>/etc/init.d/samba</I> in conjunction with the chkconfig variable
49samba being set to on. If you set chkconfig samba off then the deamons
50will not be automatically started on reboot. In this case you must type
51the following at a shell prompt to start samba after a reboot: </P>
52
53<PRE><B>   chkconfig samba on
54   /etc/init.d/samba start</B>
55</PRE>
56
57<P>If you make changes to your configuration files, <B>smbd</B> and <B>nmbd</B>
58may be restarted by typing the following at a shell prompt: </P>
59
60<PRE><B>   /etc/init.d/samba start</B>
61</PRE>
62
63<P><B>smbd</B> and <B>nmbd</B> may be killed by typing the following at
64a shell prompt: </P>
65
66<PRE><B>   /etc/init.d/samba stop</B>
67</PRE>
68
69<P>To have <B>smbd</B> and <B>nmbd</B> started by inetd you can execute
70the shell script <I>/usr/samba/inetd.sh</I> to automatically configure
71the various files and start the processes. This shell script first kills
72any running <B>smbd</B> and <B>nmbd</B> processes. It then removes any
73existing entries for &quot;netbios*&quot; from <I>/etc/inetd.conf</I> and
74adds the following lines </P>
75
76<PRE><B>    netbios-ssn stream tcp  nowait  root    /usr/samba/bin/smbd smbd
77    netbios-ns  dgram udp   wait    root    /usr/samba/bin/nmbd nmbd -S</B>
78</PRE>
79
80<P>It then removes any existing entries for &quot;netbios*&quot; from <I>/etc/services</I>
81and adds the following lines </P>
82
83<PRE><B>    netbios-ns        137/udp                         # SAMBA
84    netbios-ssn       139/tcp                         # SAMBA</B>
85</PRE>
86
87<P><I>Inetd</I> is then restarted by executing:</P>
88
89<PRE><B>   /etc/killall -HUP inetd</B>
90</PRE>
91
92<P>If you make changes to your configuration files, <B>smbd</B> and <B>nmbd</B>
93may be restarted by typing the following at a shell prompt: </P>
94
95<PRE><B>   /etc/killall smbd nmbd
96   /etc/killall -HUP inetd</B>
97</PRE>
98
99<H3><A NAME="AUTHORNOTES"></A>Author's Notice(s):</H3>
100
101<P>The author of this product is: Andrew Tridgell </P>
102
103<P>Samba is distributed freely under the <A HREF="COPYING">GNU
104public license</A>. </P>
105
106<H3><A NAME="Support"></A>Support:</H3>
107
108<P>The software in this package is considered unsupported by Silicon Graphics.
109Neither the authors or Silicon Graphics are compelled to help resolve problems
110you may encounter in the installation, setup, or execution of this software.
111To be more to the point, if you call us with an issue regarding products
112in the Freeware package, we'll have to gracefully terminate the call. The
113<A HREF="http://samba.org/pub/samba/">
114Samba Web Page</A> has a listing of companies and individuals that offer
115commercial support for a fee.
116</P>
117
118<H2><A NAME="Installation"></A>Installation Information</H2>
119
120<P>Samba includes these subsystems: </P>
121
122<TABLE>
123<TR>
124<TD ALIGN=LEFT><B>samba.sw.base</B> (<I>default</I>)</TD>
125
126<TD>Execution environment for Samba.</TD>
127</TR>
128
129<TR>
130<TD ALIGN=left><B>samba.man.manpages</B>(<I>default</I>)</TD>
131
132<TD>Samba's online manual pages (preformatted).</TD>
133</TR>
134
135<TR>
136<TD ALIGN=LEFT VALIGN=TOP><B>samba.man.doc</B> (<I>default</I>)</TD>
137
138<TD>Samba documentation: hints on installation and configuration, an FAQ
139(Frequently Asked Questions), help in diagnosing problems, etc..</TD>
140</TR>
141
142<TR>
143<TD ALIGN=left><B>samba.man.relnotes</B> (<I>default</I>) </TD>
144
145<TD>Samba online release notes.</TD>
146</TR>
147
148<TR>
149<TD ALIGN=LEFT VALIGN=TOP><B>samba.src.samba</B> </TD>
150
151<TD>The Samba software distribution from which this product was
152built (including the packaging/SGI directory which will allow this distribution
153to be rebuilt).</TD>
154</TR>
155</TABLE>
156
157<H3>Installation Method</H3>
158
159<P>All of the subsystems for Samba can be installed using IRIX. You do
160not need to use the miniroot. Refer to the <I>Software Installation Administrator's
161Guide</I> for complete installation instructions. </P>
162
163<H3>Prerequisites</H3>
164
165<P>Your workstation must be running IRIX 5.3 or later in order to use this
166product. </P>
167
168<H3>Configuration Files</H3>
169
170<P>Because configuration files often contain modifications, inst treats
171them specially during the installation process. If they have not been modified,
172inst removes the old file and installs the new version during software
173updates. For configuration files that have been modified, the new version
174is installed and the old version is renamed by adding the suffix .O (for
175older) to the name. The no-suffix version contains changes that are required
176for compatibility with the rest of the newly installed software, that increase
177functionality, or that fix bugs. You should use diff(1) or gdiff(1) to
178compare the two versions of the files and transfer information that you
179recognize as machine or site-specific from the .O version to the no-suffix
180version. </P>
181
182<DL>
183<DT><B>/usr/samba/lib/smb.conf</B> </DT>
184
185<DD>Configuration definitions for the <B>smbd</B> program; the SMB server
186process. The default configuration sets up password-based access to home
187directories on a machine as well as open access to to all printers and
188/tmp. The workgroup is set by default to &quot;workgroup&quot;. It is highly
189recommended that administrators review the content of this file when installing
190Samba for the first time.</DD>
191
192<DT><B>/usr/samba/printcap</B> </DT>
193
194<DD>A file that specifies the available printers on a system. It is included
195as an example; administrators may want to replace it or override the reference
196to it in the <B>smb.conf</B> file. The script <B>/usr/samba/mkprintcap.sh</B>
197was used by inst to create a printcap file that contains all printers on
198your system. You may wish to remove some printers or add a comment to each
199printer name to describe its location.</DD>
200</DL>
201
202<H2><A NAME="Documentation"></A>Documentation Information</H2>
203
204<P>Preformatted manual pages are installed by default as are the contents
205of the <B>docs</B> directory from the Samba distribution; consult <I>samba</I>(7)
206for an introduction. </P>
207
208<P>There is a mailing list for discussion of Samba. To subscribe send mail
209to <A HREF="mailto:listproc@samba.org">listproc@samba.org</A>
210with a body of &quot;subscribe samba Your Name&quot; </P>
211
212<P>To send mail to everyone on the list mail to <A HREF="mailto:samba@samba.org">samba@samba.org</A>.
213</P>
214
215<P>There is also an announcement mailing list where new versions are announced.
216To subscribe send mail to <A HREF="mailto:listproc@samba.org">listproc@samba.org</A>
217with a body of &quot;subscribe samba-announce Your Name&quot;. All announcements
218also go to the samba list. </P>
219
220<P>You might also like to look at the Usenet news group <A HREF="news:comp.protocols.smb">comp.protocols.smb</A>
221as it often contains lots of useful info and is frequented by lots of Samba
222users. The newsgroup was initially setup by people on the Samba mailing
223list. It is not, however, exclusive to Samba, it is a forum for discussing
224the SMB protocol (which Samba implements). </P>
225
226<P>A Samba WWW site has been setup with lots of useful info. Connect to:
227<A HREF="http://samba.org/pub/samba/">http://samba.org/pub/samba/</A>.
228It is maintained by Paul Blackman (thanks Paul!). You can contact him at
229<A HREF="mailto:ictinus@lake.canberra.edu.au">ictinus@lake.canberra.edu.au</A>.
230</P>
231
232</BODY>
233</HTML>
234