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