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

<refmeta>
    <refentrytitle>testparm</refentrytitle>
    <manvolnum>1</manvolnum>
</refmeta>


<refnamediv>
    <refname>testparm</refname>
    <refpurpose>sprawdź plik konfiguracyjny smb.conf pod
      względem wewnętrznej poprawności</refpurpose>
</refnamediv>

<refsynopsisdiv>
    <cmdsynopsis>
      <command>testparm</command>
      <arg choice="opt">-s</arg>
      <arg choice="opt">-h</arg>
      <arg choice="opt">-L nazwaserwera</arg>
      <arg choice="req">nazwaplikukonfig</arg>
      <arg choice="opt">nazwahosta IPhosta</arg>
    </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
    <title>OPIS</title>

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

    <para><command>testparm</command> jest bardzo prostym programem
      testowym do sprawdzania pliku konfiguracyjnego dla <command>smbd
      </command>, pod względem wewnętrznej poprawności. Jeśli ten
      program nie stwierdzi problemów, możesz użyć pliku
      konfiguracyjnego będąc pewnym, że <command>smbd</command>
      pomyślnie go załaduje.</para>

    <para>Zauważ, że <emphasis>NIE</emphasis> gwarantuje to, że
      usługi określone w pliku konfiguracyjnym będą dostępne lub
      będą funkcjonować zgodnie z oczekiwaniami.</para>

    <para>Jeśli opcjonalna nazwa hosta i adres IP hosta są określone
      w linii poleceń, ten program testowy sprawdzi kolejne wpisy
      usług raportując, czy podany host ma dostęp do każdej z nich.
    </para>

    <para>Jeśli <command>testparm</command> znajdzie błąd w pliku
      <filename>smb.conf</filename>, wraca z kodem wyjścia 1 do
      wywołującego programu. W przeciwnym wypadku wraca z kodem
      wyjścia 0. To pozwala skryptom powłoki testować wyjście
      z <command>testparm</command>.</para>
</refsect1>


<refsect1>
    <title>OPCJE</title>

    <variablelist>

      <varlistentry>
	<term>-s</term>
	<listitem><para>Bez tej opcji, <command>testparm</command>
	    zaczeka na powrót karetki (ang. carriage return) po
	    wypisaniu nazw usług i przed pokazaniem definicji usług.
	  </para></listitem>
      </varlistentry>

      <varlistentry>
	<term>-h</term>
	<listitem><para>Wyświetla wiadomość o użyciu</para></listitem>
      </varlistentry>

      <varlistentry>
	<term>nazwaserwera</term>
	<listitem><para>Ustawia wartość makra %L na nazwę serwera.
	    Jest to użyteczne do testowania dołączanych plików
	    specyfikowanych z makrem %L.</para></listitem>
      </varlistentry>

      <varlistentry>
	<term>nazwaplikukonfig</term>
	<listitem><para>Jest to nazwa pliku konfiguracyjnego do
	    sprawdzenia. Jeśli ten parametr nie jest obecny, wtedy
	    sprawdzony będzie domyślny plik <filename>smb.conf</filename>.
	  </para></listitem>
      </varlistentry>

      <varlistentry>
	<term>nazwahosta</term>
	<listitem><para>Jeśli ten parametr i następne są określone,
	    wtedy testparm będzie sprawdzał parametry <parameter>hosts
	      allow</parameter> i <parameter>hosts deny</parameter> w
	    pliku <filename>smb.conf</filename> żeby określić, czy nazwa
	    hosta z tym adresem IP mogłaby usyskać dostęp do serwera
	    <command>smbd</command>. Jeśli ten parametr jest dostarczony,
	    wówczas parametr hostIP również musi być dostarczony.
	  </para></listitem>
      </varlistentry>

      <varlistentry>
	<term>IPhosta</term>
	<listitem><para>Jest to adres IP hosta określonego w
	    poprzednim parametrze. Ten adres musi być dostarczony,
	    jeśli jest dostarczony parametr nazwahosta.
	  </para></listitem>
      </varlistentry>
    </variablelist>
</refsect1>


<refsect1>
    <title>PLIKI</title>

    <variablelist>
      <varlistentry>
	<term><filename>smb.conf</filename></term>
	<listitem><para>Taka jest zazwyczaj nazwa pliku konfiguracyjnego
	    używanego przez <command>smbd</command>.</para></listitem>
      </varlistentry>
    </variablelist>
</refsect1>

<refsect1>
    <title>DIAGNOSTYKA</title>

    <para>Program wygeneruje komunikat stwierdzający, czy załadowany
      plik konfiguracyjny jest w porządku, czy nie. Ten komunikat
      może być poprzedzony błędami i ostrzeżeniami jeśli plik się nie
      załadował. Jeśli załadował się w porządku, program zrzuci
      na standardowe wyjście wszystkie znane detale usług.</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><ulink url="smb.conf.5.html"><filename>smb.conf(5)</filename></ulink>, 
      <ulink url="smbd.8.html"><command>smbd(8)</command></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 źródł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> a zaktualizowane
      do wydania 2.0 Samby przez Jeremy Allisona. Konwersja do
      DocBook dla Samba 2.2 została zrobiona przez Geralda
      Cartera. Tłumaczenie na język polski i konwersję polskiej
      wersji do DocBook wykonał Rafał Szcześniak.</para>
</refsect1>

</refentry>
