<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<refentry id="swat" lang="pl">

<refmeta>
    <refentrytitle>swat</refentrytitle>
    <manvolnum>8</manvolnum>
</refmeta>

<refnamediv>
    <refname>swat</refname>
    <refpurpose>Webowe Narzędzie Administracyjne Samby</refpurpose>
</refnamediv>

<refsynopsisdiv>
    <cmdsynopsis>
      <command>swat</command>
      <arg choice="opt">-s &lt;plik konfiguracyjny smb&gt;</arg>
      <arg choice="opt">-a</arg>
    </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
    <title>OPIS</title>

    <para>Ten program jest częścią pakietu <ulink url="samba.7.html">
	Samba</ulink>.

    <para><command>swat</command> umożliwia administratorowi Samba
      skonfigurować złożony plik <ulink url="smb.conf.5.html"><filename>
	  smb.conf</filename></ulink> poprzez przeglądarkę Web. Dodatkowo,
      strona konfiguracyjna swat ma łącza do pomocy do wszystkich
      konfigurowalnych opcji w pliku smb.conf pozwalając
      administratorowi z łatwością oglądać efekty jakiejkolwiek zmiany.
    </para>

    <para>swat jest uruchamiany z inetd</para>
</refsect1>

<refsect1>
    <title>OPCJE</title>


    <variablelist>

      <varlistentry>
	<term>-s &lt;plik konfiguracyjny smb&gt;</term>
	<listitem><para>Domyślna ścieżka do pliku konfiguracyjnego jest
	    determinowana w czasie kompilacji. Określony tu plik zawiera
	    detale konfiguracyjne wymagane przez serwer <command>smbd
	    </command>. Jest to plik który swat będzie modyfikował.
	    Informacja w tym pliku zawiera specyficzne dla serwera
	    informacje takie, jak którego pliku printcap użyć, jak
	    również opisy wszystkich usług które serwer ma udostępniać.
	    Zobacz <filename>smb.conf(5)</filename> aby uzyskać więcej
	    informacji.</para></listitem>
      </varlistentry>

      <varlistentry>
	<term>-a</term>
	<listitem><para>Ta opcja wyłącza autentykację i ustawia swat
	    w trybie demo. W trybie tym każdy będzie w stanie zmodyfikować
	    plik smb.conf file.</para>

	  <para><emphasis>NIE włączaj tej opcji na serwerze produkcyjnym.
	    </emphasis></para></listitem>
      </varlistentry>

    </variablelist>
</refsect1>


<refsect1>
      <title>INSTALACJA</title>

      <para>Po kompilacji SWAT trzeba uruchomić <command>make install
	</command> aby zainstalować binaria swat i różne pliki pomocy
	oraz rysunki. Domyślna instalacja umieściłaby je w:</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>

    <refsect2>
      <title>Instalacja Inetd</title>

      <para>Aby ustawić SWAT do uruchamiania przez inetd potrzebna
	jest edycja twoich plików <filename>/etc/inetd.conf</filename>
	i <filename>/etc/services</filename>.</para>

      <para>W <filename>/etc/services</filename> trzeba dodać taką
	linię:</para>

      <para><command>swat            901/tcp</command></para>

      <para>Notka dla użytkowników NIS/YP - możesz potrzebować
	przebudować mapowanie usług NIS zamiast zmieniać lokalny
	plik <filename>/etc/services</filename>.</para>

      <para>wybór numeru portu nie jest tak naprawdę ważny z wyjątkiem
	tego, że powinien być mniejszy niż 1024 i aktualnie nieużywany
	(używanie numeru powyżej 1024 stanowi możliwą lukę w
	bezpieczeństwie zależnie od detali implementacyjnych twojego
	demona <command>inetd</command>).</para>

      <para>W <filename>/etc/inetd.conf</filename> powinieneś dodać
	taką linię:</para>

      <para><command>swat    stream  tcp     nowait.400  root
	  /usr/local/samba/bin/swat swat</command></para>

      <para>Po dokonaniu edycji <filename>/etc/services</filename> i
	<filename>/etc/inetd.conf</filename> potrzebne jest jeszcze
	wysłanie sygnału HUP do inetd. Aby to zrobić użyj <command>
	  kill -1 PID</command>, gdzie PID jest numerem ID procesu
	demona inetd.</para>
    </refsect2>

    <refsect2>
      <title>URUCHAMIANIE</title>

      <para>Aby uruchomić swat po prostu uruchom twoją ulubioną
	przeglądarkę web i skieruj ją na "http://localhost:901/".
      </para>

      <para>Zauważ, że możesz podłączyć się do swat z każdej maszyny
	połączonej przez IP, ale łączenie się ze zdalnej maszyny
	pozostawia twoje połączenie otwartym na podsłuchiwanie hasła
	ponieważ będzie ono wysyłane po łączach w czystym tekście.
      </para>
    </refsect2>

</refsect1>

<refsect1>
    <title>PLIKI</title>

    <variablelist>
      <varlistentry>
	<term><filename>/etc/inetd.conf</filename></term>
	<listitem><para>Ten plik musi zawierać odpowiednią informację
	    startową dla meta-demona.</para></listitem>
      </varlistentry>

      <varlistentry>
	<term><filename>/etc/services</filename></term>
	<listitem><para>Ten plik musi zawierać mapowanie nazwy usługi
	    (np. swat) na port usługi (np. 901) i typ protokołu
	    (np. tcp).</para></listitem>
      </varlistentry>

      <varlistentry>
	<term><filename>/usr/local/samba/lib/smb.conf</filename></term>
	<listitem><para>Jest to domyślna lokalizacja pliku
	    konfiguracyjnego <filename>smb.conf(5)</filename> który
	    swat edytuje. Inne powszechne miejsca w których systemy
	    instalują ten plik to <filename>/usr/samba/lib/smb.conf
	    </filename> i <filename>/etc/smb.conf</filename>. Ten plik
	    opisuje wszystkie usługi, które serwer ma udostępniać
	    klientom.</para>
	</listitem>
      </varlistentry>

    </variablelist>
</refsect1>

<refsect1>
    <title>OSTRZEŻENIA</title>

    <para><command>swat</command> przepisze twój plik <filename>
	smb.conf</filename>. Uporządkuje na nowo wpisy i usunie
      wszystkie komentarze oraz opcje <parameter>include=</parameter>
      i <parameter>copy=</parameter>. Jeśli twój plik <filename>smb.conf
      </filename> to pieczołowicie stworzone rękodzieło, to zrób jego
      kopię zapasową, albo nie używaj swat!</para>
</refsect1>

<refsect1>
    <title>WERSJA</title>

    <para>Ta strona podręcznika jest poprawna dla wersji 2.2 pakietu
      Samba.</para>
</refsect1>

<refsect1>
    <title>ZOBACZ TEŻ</title>

    <para><command>inetd(5)</command>,
      <ulink url="smbd.8.html"><command>smbd(8)</command></ulink>, 
      <ulink url="smb.conf.5.html">smb.conf(5)</ulink>
    </para>
</refsect1>

<refsect1>
    <title>AUTOR</title>

    <para>Pierwotnie, Samba i związane z nią oprogramowanie były
      stworzone przez Andrew Tridgella. Samba jest teraz rozwijana
      przez Zespół Samba jako projekt Open Source podobnie jak jądro
      Linux.</para>

    <para>Pierwotnie, strony podręcznika Samba zostały napisane przez
      Karla Auera. Kody źrodłowe tych stron zostały przekonwertowane
      do formatu YODL (kolejny świetny kawałek oprogramowania Open
      Source dostępny na <ulink url="ftp://ftp.icce.rug.nl/pub/unix/">
	ftp://ftp.icce.rug.nl/pub/unix/</ulink>) i zaktualizowane do
      wydania 2.0 samby przez Jeremy Allisona. Konwersja do DocBook
      została wykonana przez Geralda Cartera. Tłumaczenie na język
      polski i konwersję polskiej wersji do DocBook wykonał
      Rafał Szcześniak.</para>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-namecase-general:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:("/usr/lib/sgml/catalog")
sgml-local-ecat-files:nil
End:
-->
