s4:dsdb/descriptor: pass object_list to create_security_descriptor()
[Samba/gebeck_regimport.git] / packaging / SGI / relnotes.html
2 <HTML>
3 <HEAD>
4 <TITLE>Samba Release Notes</TITLE>
5 </HEAD>
6 <BODY>
8 <H1>Samba Release Notes</H1>
10 <P>
11 <HR></P>
13 <H2>Table of Contents</H2>
15 <MENU>
16 <LI><B><A HREF="#WHATIS">What is Samba?</A></B> </LI>
18 <LI><B><A HREF="#Support">Support Policy</A> </B></LI>
20 <LI><B><A HREF="#Installation">Installation Information</A> </B></LI>
22 <LI><B><A HREF="legal_notice.html">Silicon
23 Graphics Legal Notice</A> </B></LI>
25 <LI><B><A HREF="#AUTHORNOTES">Author's Notice(s)</A> </B></LI>
27 <LI><B><A HREF="#Documentation">Documentation Information</A> </B></LI>
28 </MENU>
30 <P>
31 <HR></P>
33 <H2><A NAME="WHATIS"></A>What is Samba?</H2>
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>
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>
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>
53 <PRE><B> chkconfig samba on
54 /etc/init.d/samba start</B>
55 </PRE>
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>
60 <PRE><B> /etc/init.d/samba start</B>
61 </PRE>
63 <P><B>smbd</B> and <B>nmbd</B> may be killed by typing the following at
64 a shell prompt: </P>
66 <PRE><B> /etc/init.d/samba stop</B>
67 </PRE>
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>
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>
80 <P>It then removes any existing entries for &quot;netbios*&quot; from <I>/etc/services</I>
81 and adds the following lines </P>
83 <PRE><B> netbios-ns 137/udp # SAMBA
84 netbios-ssn 139/tcp # SAMBA</B>
85 </PRE>
87 <P><I>Inetd</I> is then restarted by executing:</P>
89 <PRE><B> /etc/killall -HUP inetd</B>
90 </PRE>
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>
95 <PRE><B> /etc/killall smbd nmbd
96 /etc/killall -HUP inetd</B>
97 </PRE>
99 <H3><A NAME="AUTHORNOTES"></A>Author's Notice(s):</H3>
101 <P>The author of this product is: Andrew Tridgell </P>
103 <P>Samba is distributed freely under the <A HREF="COPYING">GNU
104 public license</A>. </P>
106 <H3><A NAME="Support"></A>Support:</H3>
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>
118 <H2><A NAME="Installation"></A>Installation Information</H2>
120 <P>Samba includes these subsystems: </P>
122 <TABLE>
123 <TR>
124 <TD ALIGN=LEFT><B>samba.sw.base</B> (<I>default</I>)</TD>
126 <TD>Execution environment for Samba.</TD>
127 </TR>
129 <TR>
130 <TD ALIGN=left><B>samba.man.manpages</B>(<I>default</I>)</TD>
132 <TD>Samba's online manual pages (preformatted).</TD>
133 </TR>
135 <TR>
136 <TD ALIGN=LEFT VALIGN=TOP><B>samba.man.doc</B> (<I>default</I>)</TD>
138 <TD>Samba documentation: hints on installation and configuration, an FAQ
139 (Frequently Asked Questions), help in diagnosing problems, etc..</TD>
140 </TR>
142 <TR>
143 <TD ALIGN=left><B>samba.man.relnotes</B> (<I>default</I>) </TD>
145 <TD>Samba online release notes.</TD>
146 </TR>
148 <TR>
149 <TD ALIGN=LEFT VALIGN=TOP><B>samba.src.samba</B> </TD>
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>
157 <H3>Installation Method</H3>
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>
163 <H3>Prerequisites</H3>
165 <P>Your workstation must be running IRIX 5.3 or later in order to use this
166 product. </P>
168 <H3>Configuration Files</H3>
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>
182 <DL>
183 <DT><B>/usr/samba/lib/smb.conf</B> </DT>
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>
192 <DT><B>/usr/samba/printcap</B> </DT>
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>
202 <H2><A NAME="Documentation"></A>Documentation Information</H2>
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>
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>
212 <P>To send mail to everyone on the list mail to <A HREF="mailto:samba@samba.org">samba@samba.org</A>.
213 </P>
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>
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>
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>
232 </BODY>
233 </HTML>