1 2 3 4 5 6 7<html><head><title>swat (8)</title> 8 9<link rev="made" href="mailto:samba@samba.org"> 10</head> 11<body> 12 13<hr> 14 15<h1>swat (8)</h1> 16<h2>Samba</h2> 17<h2>23 Oct 1998</h2> 18 19 20 21<p><a name="NAME"></a> 22<h2>NAME</h2> 23 swat - Samba Web Administration Tool 24<p><a name="SYNOPSIS"></a> 25<h2>SYNOPSIS</h2> 26 27<p><strong>swat</strong> [<a href="swat.8.html#minuss">-s smb config file</a>] [<a href="swat.8.html#minusa">-a</a>] 28<p><a name="DESCRIPTION"></a> 29<h2>DESCRIPTION</h2> 30 31<p>This program is part of the <strong>Samba</strong> suite. 32<p><strong>swat</strong> allows a Samba administrator to configure the complex 33<a href="smb.conf.5.html"><strong>smb.conf</strong></a> file via a Web browser. In 34addition, a swat configuration page has help links to all the 35configurable options in the <a href="smb.conf.5.html"><strong>smb.conf</strong></a> file 36allowing an administrator to easily look up the effects of any change. 37<p><strong>swat</strong> is run from <strong>inetd</strong> 38<p><a name="OPTIONS"></a> 39<h2>OPTIONS</h2> 40 41<p><dl> 42<p><a name="minuss"></a> 43<p></p><dt><strong><strong>-s smb configuration file</strong></strong><dd> The default configuration file path is 44determined at compile time. 45<p>The file specified contains the configuration details required by the 46<a href="smbd.8.html"><strong>smbd</strong></a> server. This is the file that <strong>swat</strong> will 47modify. The information in this file includes server-specific 48information such as what printcap file to use, as well as descriptions 49of all the services that the server is to provide. See <a href="smb.conf.5.html">smb.conf 50(5)</a> for more information. 51<p><a name="minusa"></a> 52<p></p><dt><strong><strong>-a</strong></strong><dd> 53<p>This option disables authentication and puts <strong>swat</strong> in demo mode. In 54that mode anyone will be able to modify the 55<a href="smb.conf.5.html"><strong>smb.conf</strong></a> file. 56<p>Do NOT enable this option on a production server. 57<p></dl> 58<p><a name="INSTALLATION"></a> 59<h2>INSTALLATION</h2> 60 61<p>After you compile SWAT you need to run <code>"make install"</code> to install the 62swat binary and the various help files and images. A default install 63would put these in: 64<p><pre> 65 66/usr/local/samba/bin/swat 67/usr/local/samba/swat/images/* 68/usr/local/samba/swat/help/* 69 70</pre> 71 72<p><a name="INETD"></a> 73<h2>INETD INSTALLATION</h2> 74 75<p>You need to edit your <code>/etc/inetd.conf</code> and <code>/etc/services</code> to 76enable <strong>SWAT</strong> to be launched via inetd. 77<p>In <code>/etc/services</code> you need to add a line like this: 78<p><code>swat 901/tcp</code> 79<p>Note for NIS/YP users - you may need to rebuild the NIS service maps 80rather than alter your local <code>/etc/services</code> file. 81<p>the choice of port number isn't really important except that it should 82be less than 1024 and not currently used (using a number above 1024 83presents an obscure security hole depending on the implementation 84details of your <strong>inetd</strong> daemon). 85<p>In <code>/etc/inetd.conf</code> you should add a line like this: 86<p><code>swat stream tcp nowait.400 root /usr/local/samba/bin/swat swat</code> 87<p>One you have edited <code>/etc/services</code> and <code>/etc/inetd.conf</code> you need 88to send a HUP signal to inetd. To do this use <code>"kill -1 PID"</code> where 89PID is the process ID of the inetd daemon. 90<p><a name="LAUNCHING"></a> 91<h2>LAUNCHING</h2> 92 93<p>To launch <strong>swat</strong> just run your favorite web browser and point it at 94<code>http://localhost:901/</code>. 95<p><strong>Note that you can attach to <strong>swat</strong> from any IP connected machine but 96connecting from a remote machine leaves your connection open to 97password sniffing as passwords will be sent in the clear over the 98wire.</strong> 99<p><h2>FILES</h2> 100 101<p><strong>/etc/inetd.conf</strong> 102<p>This file must contain suitable startup information for the 103meta-daemon. 104<p><strong>/etc/services</strong> 105<p>This file must contain a mapping of service name (e.g., swat) to 106service port (e.g., 901) and protocol type (e.g., tcp). 107<p><strong>/usr/local/samba/lib/smb.conf</strong> 108<p>This is the default location of the <em>smb.conf</em> server configuration 109file that <strong>swat</strong> edits. Other common places that systems install 110this file are <em>/usr/samba/lib/smb.conf</em> and <em>/etc/smb.conf</em>. 111<p>This file describes all the services the server is to make available 112to clients. See <strong>smb.conf (5)</strong> for more information. 113<p><a name="WARNINGS"></a> 114<h2>WARNINGS</h2> 115 116<p><strong>swat</strong> will rewrite your <a href="smb.conf.5.html"><strong>smb.conf</strong></a> file. It 117will rearrange the entries and delete all comments, 118<a href="smb.conf.5.html#include"><strong>"include="</strong></a> and 119<a href="smb.conf.5.html#copy"><strong>"copy="</strong></a> options. If you have a 120carefully crafted <a href="smb.conf.5.html"><strong>smb.conf</strong></a> then back it up 121or don't use <strong>swat</strong>! 122<p><a name="VERSION"></a> 123<h2>VERSION</h2> 124 125<p>This man page is correct for version 2.0 of the Samba suite. 126<p><a name="SEEALSO"></a> 127<h2>SEE ALSO</h2> 128 129<p><strong>inetd (8)</strong>, <a href="nmbd.8.html"><strong>nmbd (8)</strong></a>, 130<a href="smb.conf.5.html"><strong>smb.conf (5)</strong></a>. 131<p><a name="AUTHOR"></a> 132<h2>AUTHOR</h2> 133 134<p>The original Samba software and related utilities were created by 135Andrew Tridgell (samba@samba.org). Samba is now developed 136by the Samba Team as an Open Source project similar to the way the 137Linux kernel is developed. 138<p>The original Samba man pages were written by Karl Auer. The man page 139sources were converted to YODL format (another excellent piece of Open 140Source software, available at 141<a href="ftp://ftp.icce.rug.nl/pub/unix/"><strong>ftp://ftp.icce.rug.nl/pub/unix/</strong></a>) 142and updated for the Samba2.0 release by Jeremy Allison. 143<a href="mailto:samba@samba.org"><em>samba@samba.org</em></a>. 144<p>See <a href="samba.7.html"><strong>samba (7)</strong></a> to find out how to get a full 145list of contributors and details on how to submit bug reports, 146comments etc. 147</body> 148</html> 149