<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
<refentry id="smbpasswd" lang="pl">
<refmeta>
    <refentrytitle>smbpasswd</refentrytitle>
    <manvolnum>8</manvolnum>
</refmeta>

<refnamediv>
    <refname>smbpasswd</Refname>
    <refpurpose>zmienia hasło SMB użytkownika</refpurpose>
</refnamediv>

<refsynopsisdiv>
      <cmdsynopsis>
	<command>smbpasswd</command>
	<arg choice="opt">-a</arg>
	<arg choice="opt">-x</arg>
	<arg choice="opt">-d</arg>
	<arg choice="opt">-e</arg>
	<arg choice="opt">-D poziom debugowania</arg>
	<arg choice="opt">-n</arg>
	<arg choice="opt">-r zdalna maszyna</arg>
	<arg choice="opt">-R kolejnosc odwzorowywania nazw</arg>
	<arg choice="opt">-m</arg>
	<arg choice="opt">-j DOMENA</arg>
	<arg choice="opt">-U nazwauzytkownika[%password]</arg>
	<arg choice="opt">-h</arg>
	<arg choice="opt">-s</arg>
	<arg choice="opt">nazwauzytkownika</arg>
      </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
      <title>OPIS</title>

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

      <para>Program smbpasswd ma kilka różnych funkcji, zależnie czy
	jest uruchamiany przez użytkownika <emphasis>root</emphasis>,
	czy nie. Gdy jest uruchamiany jako normalny użytkownik, pozwala
	mu (użytkownikowi) zmienić hasło SMB na każdej maszynie która
	przechowuje takie hała.</para>

      <para>Domyślnie (przy uruchamianiu bez argumentów) spróbuje
	zmienić hasło SMB bieżącego użytkownika na lokalnej maszynie.
	Jest to podobne do działania programu <command>passwd(1)</command>.
	Jednakże <command>smbpasswd</command> różni się od <command>passwd
	</command> tym, że nie jest programem <emphasis>setuid root
	</emphasis>, ale działa w trybie klient-serwer i komunikuje się
	z lokalnie działającym smbd. W konsekwencji, aby zakończyło się
	to sukcesem, demon smbd musi być uruchomiony na lokalnej maszynie.
	Na maszynie UNIX zakodowane hasła SMB są zwykle przechowywane w
	pliku <ulink url="smbpasswd.5.html"><filename>smbpasswd(5)</filename>
	</ulink>.</para>

      <para>Gdy jest uruchomiony bez żadnych opcji przez zwykłego
	użytkownika, <command>smbpasswd</command> zapyta o stare hasło,
	a potem o nowe dwukrotnie, aby upewnić się, że nowe hasło było
	wpisane poprawnie. Nie będzie echa na ekranie podczas wpisywania.
	Jeśli masz puste hasło smb (określone przez łańcuch "NO PASSWORD"
	w pliku <filename>smbpasswd</filename>), wtedy po prostu naciśnij
	klawisz &lt;Enter&gt; przy pytaniu o stare hasło.</para>

      <para>smbpasswd może być również użyty przez zwykłego użytkownika
	do zmiany hasła SMB na zdalnych maszynach, takich jak Głowne
	Kontrolery Domeny Windows NT (NT PDC). Zobacz niżej opcje
	(<parameter>-r</parameter>) i <parameter>-U</parameter>.</para>

      <para>Gdy jest uruchomiony przez root'a, <command>smbpasswd</command>
	pozwala dodawać i usuwać użytkowników w pliku <filename>smbpasswd(5)
	</filename>, jak również zmieniać atrybuty użytkowników w tym pliku.
	Gdy uruchomiony przez root'a, <command>smbpasswd</command> ma dostęp
	do lokalnego pliku <filename>smbpasswd(5)</filename> bezpośrednio,
	umożliwiając w ten sposób zmiany nawet, jeśli smbd nie jest
	uruchomiony.</para>
</refsect1>

<refsect1>
      <title>OPCJE</title>

      <variablelist>
	
	<varlistentry>
	  <term>-a</term>
	  <listitem><para>Ta opcja określa, że nazwa użytkownika powinna
	      być dodana do lokalnego pliku <filename>smbpasswd(5)</filename>
	      z nowym hasłem (naciśnij &lt;Enter&gt; jako stare hasło). Ta
	      opcja jest ignorowana jeśli nazwa użytkownika już istnieje w
	      pliku <filename>smbpasswd(5)</filename> i jest wówczas
	      traktowana jak polecenie regularnej zmiany hasła. Zauważ, że
	      użytkownik aby być dodanym, <emphasis>musi</emphasis> już istnieć
	      w systemowym pliku haseł (zwykle /etc/passwd), albo żądanie
	      dodania użytkownika zakończy się niepowodzeniem.</para>

	    <para>Ta opcja jest dostępna tylko podczas uruchamiania <command>
		smbpasswd</command> jako root.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>-x</term>
	  <listitem><para>Ta opcja określa, że podana nazwa użytkownika
	      powinna być usunięta z lokalnego pliku <filename>smbpasswd
		(5)</filename>.</para>

	    <para>Ta opcja jest dostępna tylko podczas uruchamiania <command>
		smbpasswd</command> jako root.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>-d</term>
	  <listitem><para>Ta opcja określa, że podana nazwa użytkownika
	      powinna być <emphasis>wyłączona</emphasis> w lokalnym pliku
	      <filename>smbpasswd(5)</filename>. Jest to wykonywane przez
	      wpisanie flagi <emphasis>'D'</emphasis> w miejsce kontrolne konta
	      w pliku <filename>smbpasswd(5)</filename>. Gdy zostanie to
	      zrobione, wszystkie próby autentykacji poprzez SMB, przy użyciu
	      tej nazwy użytkownika zakończą się niepowodzeniem.</para>

	    <para>Jeśli plik <filename>smbpasswd(5)</filename> jest w 'starym'
	      formacie (format pre-Samba 2.0) nie ma wówczas żadnego miejsca
	      we wpisie hasła użytkownika do zapisania tej informacji, więc
	      jest on wyłączany przez wpisanie znaków 'X' w miejsce hasła w
	      pliku <filename>smbpasswd(5)</filename>. Zobacz <filename>
		smbpasswd(5)</filename> aby dowiedzieć się szczegółów o
	      'starym' i nowym formacie plików. </para>

	    <para>Ta opcja jest dostępna tylko podczas uruchamiania <command>
		smbpasswd</command> jako root.</para>
	</varlistentry>

	<varlistentry>
	  <term>-e</term>
	  <listitem><para>Ta opcja określa, że podana nazwa użytkownika ma
	      być <emphasis>włączona</emphasis> w lokalnym pliku <filename>
		smbpasswd(5)</filename>, jeśli konto został wcześniej wyłączone.
	      Jeśli konto nie było wyłączone, ta opcja jest bez efektu. Gdy
	      konto jest włączone, wtedy użytkownik będzie mógł dokonywać
	      ponownie autentykacji poprzez SMB.</para>

	    <para>Jeśli plik smbpasswd jest w 'starym' formacie, wtedy
	      <command>smbpasswd</command> zapyta o nowe hasło dla tego
	      użytkownika. W przeciwnym wypadku konto będzie włączone przez
	      usunięcie flagi <emphasis>'D'</emphasis> z miejsca kontrolnego
	      konta w pliku <filename>smbpasswd(5)</filename>. Zobacz plik
	      <filename>smbpasswd(5)</filename>  aby dowiedzieć się szczegółów
	      o 'starym' i nowym formatcie plików.</para>

	    <para>Ta opcja jest dostępna tylko podczas uruchamiania <command>
		smbpasswd</command> jako root.</para>
	</varlistentry>

	<varlistentry>
	  <term>-D poziomdebugowania</term>
	  <listitem><para>poziom debugowania jest liczbą całkowitą od 0 do 10.
	      Domyślną wartością, jeśli ten parametr nie jest określony, jest
	      zero.</para>

	    <para>Im większa jest to wartość, tym więcej detali będzie
	      logowanych w plikach logu na temat aktywności serwera. Na poziomie
	      0, tylko krytyczne błędy i poważne ostrzeżenia będą rejestrowane.
	    </para>

	    <para>Poziomy ponad 1 będą generować znaczne ilości informacji
	      logu i powinny być używane tylko podczas śledzenia problemu.
	      Poziomy ponad 3 są zaprojektowane tylko dla użytku developerów
	      i generują OGROMNE ilości danych logu, w większości ekstremalnie
	      zagadkowych.</para>
	</varlistentry>

	<varlistentry>
	  <term>-n</term>
	  <listitem><para>Ta opcja określa, że następująca po niej nazwa
	      użytkownika powinna mieć hasło ustawione na null (tj. puste
	      hasło) w lokalnym pliku <command>smbpasswd</command>. Odbywa
	      się to przez wpisanie znaków "NO PASSWORD" jako pierwsza część
	      pierwszego hasła przechowywanego w pliku <filename>smbpasswd
	      </filename>.</para>

	    <para>Zauważ, że aby pozwolić użytkownikom na logowanie się do
	      serwera Samba gdy hasło zostało ustawione na "NO PASSWORD" w
	      pliku <filename>smbpasswd</filename>, administrator musi ustawić
	      następujący parametr w sekcji [global] pliku <filename>smb.conf
	      </filename>:</para>

	    <para><command>null passwords = yes</command></para>

	    <para>Ta opcja jest dostępna tylko podczas uruchamiania <command>
		smbpasswd</command> jako root.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>-r nazwa zdalnej maszyny</term>
	  <listitem><para>Ta opcja pozwala użytkownikowi określić na jakiej
	      maszynie chce zmienić swoje hasło. Bez tego parametru <command>
		smbpasswd</command> domyślnie przyjmuje lokalnego hosta.
	      <replaceable>nazwa zdalnej maszyny</replaceable> jest nazwą
	      NetBIOS serwera SMB/CIFS z którym należy się skontaktować aby
	      dokonać zmiany hasła. Ta nazwa jest odwzorowana na adres IP
	      używając standardowego mechanizmu odwzorowania nazw we wszystkich
	      programach pakietu Samba. Zobacz parametr <parameter>-R name
		resolve order</parameter> aby dowiedzieć się szczegółów na
	      temat zmiany tego mechanizmu.</para>

	    <para>Nazwa użytkownika którego hasło będzie zmienione jest nazwą
	      aktualnie zalogowanego użytkownika UNIX. Zobacz parametr
	      <parameter>-U nazwauzytkownika</parameter> aby dowiedzieć się
	      szczegółów na temat zmieniania hasła dla innej nazwy użytkownika.
	    </para>

	    <para>Zauważ, że jeśli zmieniasz hasło w domenie Windows NT,
	      określona zdalna maszyna musi być Głównym Kontrolerem Domeny
	      (PDC) dla domeny (Zapasowe Kontrolery Domeny (BDC) mają kopię
	      tylko-do-odczytu bazy danych kont użytkowników i nie pozwolą
	      na zmianę hasła).</para>

	    <para><emphasis>Zauważ</emphasis>, że Windows 95/98 nie mają
	      prawdziwej bazy danych haseł, więc jest niemożliwe żeby zmienić
	      hasło określając maszynę Win95/98 jako docelową zdalną maszynęł.
	    </para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>-R kolejnosc odwzorowania nazw</term>
	  <listitem><para>Ta opcja pozwala użytkownikowi programu smbpasswd
	      określić jakich usług odwzorowania nazw użyć podczas szukania
	      nazwy NetBIOS hosta do którego jest podłączany.</para>

	    <para>Tymi opcjami są :"lmhosts", "host", "wins" i "bcast".
	      Powodują one, że nazwy są odwzorowywane jak poniżej:</para>

	    <itemizedlist>
	      <listitem><para><constant>lmhosts</constant> : Szukaj adresu
		  IP w pliku Samba lmhosts.</para></listitem>
	      <listitem><para><constant>host</constant> : Przeprowadź
		  standardowe odwzorowanie nazwy hosta na adres IP przy użyciu
		  systemowego szukania <filename>/etc/hosts</filename>, NIS
		  lub DNS. Ta metoda rozwiązywania nazwy jest zależna od
		  systemu operacyjnego. Przykładowo w systemie IRIX lub
		  Solaris może to być kontrolowane przez plik <filename>
		    /etc/nsswitch.conf</filename>.</para></listitem>
	      <listitem><para><constant>wins</constant> : Zapytaj o nazwę pod
		  adresem IP wymienionym w parametrze <parameter>wins server
		  </parameter> w pliku <filename>smb.conf</filename>. Jeśli
		  żaden serwer WINS nie został określony, ta metoda zostanie
		  zignorowana.</para></listitem>
	      <listitem><para><constant>bcast</constant> : Wykonaj rozgłaszanie
		  na każdym ze znanych lokalnych interfejsów wymienionym w
		  parametrze <parameter>interfaces</parameter> w pliku smb.conf.
		  Jest to najmniej skuteczna spośród wszystkich metoda
		  odwzorowania nazw, jako że zależy od istnienia docelowego
		  hosta w lokalnie podłączonej podsieci.</para></listitem>
	    </itemizedlist>

	    <para>Domyślną kolejnością jest lmhosts, host, wins, bcast, i bez
	      tego parametru oraz żadnego wpisu w pliku <filename>smb.conf
	      </filename>, metody odwzorowania nazw będą wypróbowane w tej
	      kolejności.</para>
	</varlistentry>

	<varlistentry>
	  <term>-m</term>
	  <listitem><para>Ta opcja mówi smbpasswd że zmieniane konto jest
	      kontem MASZYNY. Obecnie jest to stosowane, gdy Samba jest używana
	      jako Główny Kontroler Domeny NT (NT PDC).</para>

	    <para>Ta opcja jest dostępna jedynie podczas uruchamiania
	      smbpasswd jako root.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>-j DOMENA</term>
	  <listitem><para>Ta opcja jest używana aby dodać serwer Samba do
	      Domeny Windows NT jako członka Domeny mogącego autentykować
	      konta użytkowników na Kontrolerze Domeny w ten sam sposób, co
	      Windows NT Server. Zobacz opcję <command>security=domain
	      </command> na stronie podręcznika <filename>smb.conf(5)
	      </filename>.</para>

	    <para>Aby użyć serwera Samba w ten sposób, Administrator Domeny
	      Windows NT musi użyć programu "Server Manager for Domains"
	      żeby dodać główną nazwę NetBIOS serwera Samba jako członka
	      Domeny.</para>

	    <para>Gdy to zostanie zrobione, aby przyłączyć się do Domeny
	      wywołaj <command>smbpasswd</command> z tym parametrem.
	      smbpasswd poszuka wtedy Głównego Kontrolera Domeny dla tej
	      Domeny (umieszczonego w pliku <filename>smb.conf</filename>
	      w parametrze <parameter>password server</parameter>)
	      i zmieni hasło konta maszyny używane do tworzenia chronionej
	      komunikacji w Domenie. To hasło jest wówczas przechowywane
	      w TDB, zapisywalnym tylko przez root'a, o nazwie <filename>
		secrets.tdb</filename>.</para>

	    <para>Gdy tylko ta operacja jest przeprowadzona, plik <filename>
		smb.conf</filename> może być zaktualizowany, aby ustawić
	      opcję <parameter>security=domain</parameter> i wszystkie
	      przyszłe logowania do serwera Samba będą autentykowane na
	      Windows NT PDC.</para>

	    <para>Zauważ, że nawet jeśli autentykacja jest przeprowadzana
	      przez PDC, wszyscy użytkownicy korzystający z serwera Samba
	      muszą nadal mieć ważne konto UNIX na tej maszynie.</para>

	    <para>Ta opcja jest dostępna jedynie podczas uruchamiania
	      smbpasswd jako root.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>-U nazwauzytkownika</term>
	  <listitem><para>Ta opcja może być użyta tylko w połączeniu
	      z opcją <parameter>-r</parameter>. Podczas zmieniania hasła
	      na zdalnej maszynie pozwala ona użytkownikowi na określenie
	      nazwy użytkownika na tej maszynie, na której hasło będzie
	      zmienione. Opcja ta jest obecna, aby umożliwić użytkownikom
	      którzy mają różne nazwy użytkowników na różnych systemach, na
	      zmianę tych haseł.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>-h</term>
	  <listitem><para>Ta opcja wyświetla tekst pomocy dla <command>
		smbpasswd</command>, wybierając poprawny dla uruchamiania
	      jako root lub jako zwyczajny użytkownik.</para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>-s</term>
	  <listitem><para>Ta opcja powoduje, że smbpasswd zachowuje ciszę
	      (tzn. nie zadaje pytań) i czyta jego stare i nowe hasłą ze
	      standardowego wejścia, zamiast z <filename>/dev/tty</filename>
	      (jak program <command>passwd(1)</command>). Ta opcja jest po
	      to, aby pomóc ludziom piszącym skrypty używające smbpasswd.
	    </para></listitem>
	</varlistentry>

	<varlistentry>
	  <term>nazwauzytkownika</term>
	  <listitem><para>To określa nazwę użytkownika na której operować,
	      przy wszystkich opcjach <emphasis>tylko root</emphasis>. Tylko
	      root może określić ten parametr, jako że tylko root ma
	      uprawnienia potrzebne do modyfikacji atrybutów bezpośrednio w
	      lokalnym pliku smbpasswd.</para></listitem>
	</varlistentry>
      </variablelist>
</refsect1>

<refsect1>
      <title>NOTATKI</title>
     
      <para>Ponieważ <command>smbpasswd</command> pracuje w trybie klient-serwer
	komunikując się z lokalnym smbd, aby to działało dla użytkownika
	innego niż root, demon smbd musi być uruchomiony. Powszechnym
	problemem jest dodanie restrykcji dla hostów, które mogą mieć
	dostęp do <command>smbd</command> uruchomionego na lokalnej maszynie,
	poprzez określanie wpisu <parameter>allow hosts</parameter> lub
	<parameter>deny hosts</parameter> w pliku <filename>smb.conf</filename>
	i przeoczenie udzielenia dostępu "localhost" do smbd.</para>

      <para>Dodatkowo, polecenie smbpasswd jest użyteczne tylko, jeśli
	Samba została ustawiona na korzystanie z kodowanych haseł. Zobacz
	plik <filename>ENCRYPTION.txt</filename> w katalogu docs, aby dowiedzieć
	się szczegółów jak to zrobić.</para>
</refsect1>

<refsect1>
      <title>WERSJA</title>
      
      <para>Ta strona podrecznika jest poprawna dla wersji 2.2 pakietu Samba.
      </para>
</refsect1>

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

      <para><ulink url="smbpasswd.5.html"><filename>smbpasswd(5)</filename></ulink>,
	<ulink url="samba.7.html">samba(7)</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ąfro 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 dla Samba 2.2
	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>
