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>