diff options
Diffstat (limited to 'docs/docbook/manpages/swat.8.sgml')
| -rw-r--r-- | docs/docbook/manpages/swat.8.sgml | 147 |
1 files changed, 77 insertions, 70 deletions
diff --git a/docs/docbook/manpages/swat.8.sgml b/docs/docbook/manpages/swat.8.sgml index 7d9540418e..aeff886de8 100644 --- a/docs/docbook/manpages/swat.8.sgml +++ b/docs/docbook/manpages/swat.8.sgml @@ -67,103 +67,110 @@ </varlistentry> </variablelist> +</refsect1> -<RefSect1><title>Installation</title> - -<para>After -you compile SWAT you need to run "make install" <ItemizedList MARK=Bullet> -<term>to install the </term><listitem><para>swat binary -and the various help files and images. A default install would put these -in: </para></listitem> -</ItemizedList> - - -<para> <BR> - <BR> -/usr/local/samba/bin/swat<BR> -/usr/local/samba/swat/images/*<BR> -/usr/local/samba/swat/help/*<BR> - <BR> - - -<para></RefSect1> - -<RefSect1><title>Inetd Installation</title> - -<para>You need to edit your CW/etc/inetd.conf and CW/etc/services -to enable SWAT to be launched via inetd. - -<para>In CW/etc/services you need to -add a line like this: - -<para>CWswat 901/tcp - -<para>Note for NIS/YP users - -you may need to rebuild the NIS service maps rather than alter your local -CW/etc/services file. - -<para>the choice of port number isn't really important except -that it should be less than 1024 and not currently used (using a number -above 1024 presents an obscure security hole depending on the implementation -details of your inetd daemon). +<refsect1> -<para>In CW/etc/inetd.conf you should add a line -like this: + <title>INSTALLATION</title> -<para>CWswat stream tcp nowait.400 root /usr/local/samba/bin/swat -swat + <para>After you compile SWAT you need to run <command>make install + </command> to install the <command>swat</command> binary + and the various help files and images. A default install would put + these in: </para> + + <itemizedlist> + <listitem><para>/usr/local/samba/bin/swat</para></listitem> + <listitem><para>/usr/local/samba/swat/images/*</para></listitem> + <listitem><para>/usr/local/samba/swat/help/*</para></listitem> + </itemizedlist> -<para>One you have edited CW/etc/services and CW/etc/inetd.conf you need -to send a HUP signal to inetd. To do this use CW"kill -1 PID" where PID is -the process ID of the inetd daemon. + <refsect2> + <title>Inetd Installation</title> -<para></RefSect1> + <para>You need to edit your <filename>/etc/inetd.conf + </filename> and <filename>/etc/services</filename> + to enable SWAT to be launched via inetd.</para> -<RefSect1><title>Launching</title> + <para>In <filename>/etc/services</filename> you need to + add a line like this: </para> -<para>To launch swat just run your -favorite web browser and point it at CW<Command>http://localhost:901/.</Command> + <para><command>swat 901/tcp</command></para> -<para>Note that -you can attach to swat from any IP connected machine but connecting from -a remote machine leaves your connection open to password sniffing as passwords -will be sent in the clear over the wire. + <para>Note for NIS/YP users - you may need to rebuild the + NIS service maps rather than alter your local <filename> + /etc/services</filename> file. </para> -<para></RefSect1> + <para>the choice of port number isn't really important + except that it should be less than 1024 and not currently + used (using a number above 1024 presents an obscure security + hole depending on the implementation details of your + <command>inetd</command> daemon). </para> -<RefSect1><title>Files</title> + <para>In <filename>/etc/inetd.conf</filename> you should + add a line like this: </para> -<para>/etc/inetd.conf + <para><command>swat stream tcp nowait.400 root + /usr/local/samba/bin/swat swat</command></para> + + <para>One you have edited <filename>/etc/services</filename> + and <filename>/etc/inetd.conf</filename> you need to send a + HUP signal to inetd. To do this use <command>kill -1 PID + </command> where PID is the process ID of the inetd daemon. </para> -<para>This file must -contain suitable startup information for the meta-daemon. + </refsect2> -<para>/etc/services + <refsect2> + <title>Launching</title> -<para>This file must contain a mapping of service name (e.g., swat) to service -port (e.g., 901) and protocol type (e.g., tcp). + <para>To launch swat just run your favorite web browser and + point it at "http://localhost:901/".</para> -<para>/usr/local/samba/lib/smb.conf + <para>Note that you can attach to swat from any IP connected + machine but connecting from a remote machine leaves your + connection open to password sniffing as passwords will be sent + in the clear over the wire. </para> + </refsect2> +</refsect1> +<refsect1> + <title>FILES</title> + + <variablelist> + <varlistentry> + <term><filename>/etc/inetd.conf</filename></term> + <listitem><para>This file must contain suitable startup + information for the meta-daemon.</para></listitem> + </varlistentry> -<para>This is the default location of the <I>smb.conf</I> server configuration file that -swat edits. Other common places that systems install this file are <I>/usr/samba/lib/smb.conf</I> -and <I>/etc/smb.conf</I>. + <varlistentry> + <term><filename>/etc/services</filename></term> + <listitem><para>This file must contain a mapping of service name + (e.g., swat) to service port (e.g., 901) and protocol type + (e.g., tcp). </para></listitem> + </varlistentry> -<para>This file describes all the services the server is to -make available to clients. See <Command>smb.conf (5)</Command> for more information. + <varlistentry> + <term><filename>/usr/local/samba/lib/smb.conf</filename></term> + <listitem><para>This is the default location of the <filename>smb.conf(5) + </filename> server configuration file that swat edits. Other + common places that systems install this file are <filename> + /usr/samba/lib/smb.conf</filename> and <filename>/etc/smb.conf + </filename>. This file describes all the services the server + is to make available to clients. </para></listitem> + </varlistentry> + </variablelist> +</refsect1> -<para></RefSect1> <refsect1> - <title>WANRNIGS</title> + <title>WARNINGS</title> <para><command>swat</command> will rewrite your <filename>smb.conf </filename> file. It will rearrange the entries and delete all comments, <parameter>include=</parameter> and <parameter>copy=" </parameter> options. If you have a carefully crafted <filename> - smb.conf</filanem> then back it up or don't use swat! </para> + smb.conf</filename> then back it up or don't use swat! </para> </refsect1> |