another round of syncs for HEAD that I forget
[nivanova/samba-autobuild/.git] / packaging / SGI / relnotes.html
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
23 Graphics 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
36 client machines running Windows 95 and Windows for Workgroups to access
37 files and/or print services on a Unix system. Samba includes an SMB server
38 to provide LanManager-style file and print services to PCs, a Netbios (RFC10001/1002)
39 name server, and an FTP-like client application for accessing PC resources
40 from 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
44 port from the client machine. <B>Smbd</B> and <B>nmbd</B> can be started
45 either as daemons or from inetd.</P>
46
47 <P>By default <B>smbd</B> and <B>nmbd</B> are started as daemons by the
48 file <I>/etc/init.d/samba</I> in conjunction with the chkconfig variable
49 samba being set to on. If you set chkconfig samba off then the deamons
50 will not be automatically started on reboot. In this case you must type
51 the 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>
58 may 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
64 a 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
70 the shell script <I>/usr/samba/inetd.sh</I> to automatically configure
71 the various files and start the processes. This shell script first kills
72 any running <B>smbd</B> and <B>nmbd</B> processes. It then removes any
73 existing entries for &quot;netbios*&quot; from <I>/etc/inetd.conf</I> and
74 adds 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>
81 and 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>
93 may 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
104 public 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.
109 Neither the authors or Silicon Graphics are compelled to help resolve problems
110 you may encounter in the installation, setup, or execution of this software.
111 To be more to the point, if you call us with an issue regarding products
112 in the Freeware package, we'll have to gracefully terminate the call. The
113 <A HREF="http://samba.org/pub/samba/">
114 Samba Web Page</A> has a listing of companies and individuals that offer
115 commercial 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
152 built (including the packaging/SGI directory which will allow this distribution
153 to 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
160 not need to use the miniroot. Refer to the <I>Software Installation Administrator's
161 Guide</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
166 product. </P>
167
168 <H3>Configuration Files</H3>
169
170 <P>Because configuration files often contain modifications, inst treats
171 them specially during the installation process. If they have not been modified,
172 inst removes the old file and installs the new version during software
173 updates. For configuration files that have been modified, the new version
174 is installed and the old version is renamed by adding the suffix .O (for
175 older) to the name. The no-suffix version contains changes that are required
176 for compatibility with the rest of the newly installed software, that increase
177 functionality, or that fix bugs. You should use diff(1) or gdiff(1) to
178 compare the two versions of the files and transfer information that you
179 recognize as machine or site-specific from the .O version to the no-suffix
180 version. </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
186 process. The default configuration sets up password-based access to home
187 directories 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
189 recommended that administrators review the content of this file when installing
190 Samba 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
195 as an example; administrators may want to replace it or override the reference
196 to it in the <B>smb.conf</B> file. The script <B>/usr/samba/mkprintcap.sh</B>
197 was used by inst to create a printcap file that contains all printers on
198 your system. You may wish to remove some printers or add a comment to each
199 printer 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
205 of the <B>docs</B> directory from the Samba distribution; consult <I>samba</I>(7)
206 for an introduction. </P>
207
208 <P>There is a mailing list for discussion of Samba. To subscribe send mail
209 to <A HREF="mailto:listproc@samba.org">listproc@samba.org</A>
210 with 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.
216 To subscribe send mail to <A HREF="mailto:listproc@samba.org">listproc@samba.org</A>
217 with a body of &quot;subscribe samba-announce Your Name&quot;. All announcements
218 also 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>
221 as it often contains lots of useful info and is frequented by lots of Samba
222 users. The newsgroup was initially setup by people on the Samba mailing
223 list. It is not, however, exclusive to Samba, it is a forum for discussing
224 the 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>.
228 It 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>