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

<refmeta>
    <refentrytitle>make_smbcodepage</refentrytitle>
    <manvolnum>1</manvolnum>
</refmeta>

<refnamediv>
    <refname>make_smbcodepage</refname>
    <refpurpose>Konstruuje plik strony kodowej pakietu Samba</refpurpose>
</refnamediv>

<refsynopsisdiv>
    <cmdsynopsis>
      <command>make_smbcodepage</command>
      <arg choice="req">c|d</arg>
      <arg choice="req">stronakodowa</arg>
      <arg choice="req">plikwejsciowy</arg>
      <arg choice="req">plikwyjsciowy</arg>
    </cmdsynopsis>
</refsynopsisdiv>

<refsect1>
    <title>OPIS</title>

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

    <para><command>make_smbcodepage</command> kompiluje lub dekompiluje
      pliki stron kodowych używane w międzynarodowych własnościach Samby
      2.2.</para> 
</refsect1>

<refsect1>
    <title>OPTIONS</title>

    <variablelist>
      <varlistentry>
	<term>c|d</term>
	<listitem><para>Określa, czy <command>make_smbcodepage</command>
	    kompiluje (<parameter>c</parameter>) stronę kodową z formatu
	    tekstowego do binarnego, czy (<parameter>d</parameter>)
	    dekompiluje binarny plik strony kodowej do tekstu.</para>
	</listitem>
      </varlistentry>

      <varlistentry>
	<term>stronakodowa</term>
	<listitem><para>To jest strona kodowa którą przetwarzamy (numer,
	    np. 850).</para></listitem>
      </varlistentry>

      <varlistentry>
	<term>plikwejsciowy</term>
	<listitem><para>To jest plik wejściowy do przetwarzania. W przypadku
	    <parameter>c</parameter> będzie to plik z tekstową definicją
	    strony kodowej, taki jak pliki które są w katalogu Samby
	    <filename>source/codepages</filename>. W przypadku <parameter>d
	    </parameter> będzie to plik binarny z definicją strony kodowej,
	    który normalnie znajduje się w podkatalogu <filename>lib/codepages
	    </filename> katalogu w którym zainstalowany jest pakiet Samba.
	  </para></listitem>
      </varlistentry>

      <varlistentry>
	<term>plikwyjsciowy</term>
	<listitem><para>Jest to plik wyjściowy do utworzenia.</para>
	</listitem>
      </varlistentry>
    </variablelist>
</refsect1>

<refsect1>
    <title>PLIKI STRON KODOWYCH</title>

    <para>Plik tekstowy z definicją strony kodowej Samba jest opisem,
      który mówi Sambie jak mapować duże litery na małe dla znakow
      większych niż ascii 127 w określonej stronie kodowej DOS. Zauważ,
      że dla pewnych stron kodowych DOS (na przyklad 437) mapowanie
      małych liter na duże może być niesymetryczne. Na przykład,
      w stronie 437 małe a dokładnie pasuje do dużego A podczas
      przekształcania z małej na dużą literę, lecz duże A niedokładnie
      mapuje się do małego a podczas przekształcania dużej litery
      na małą.</para>

    <para>Binarny plik defincji strony kodowej Samba jest binarną
      reprezentacją tej samej informacji, włącznie z informacją
      określającą jaką stronę kodową ten plik opisuje.</para>

    <para>Ponieważ Samba nie używa jeszcze UNICODE (aktualnie dla
      wersji 2.2) musisz określić stronę kodową którą twój klient DOS
      i Windows używają, jeśli chcesz mieć poprawnie realizowaną
      "niewrażliwość" na duże/małe litery w twoim konkretnym języku.
      Domyślnie, Samba używa strony kodowej 850 (Zachodnia Europa).
      Przykładowe pliki definicji stron kodowych Samba są dostarczone
      z dystrybucją dla stron 437 (USA), 737 (Grecja), 850 (Zachodnia
      Europa), 852 (MS-DOS Latin 2), 861 (Islandia), 866 (Cyrylica),
      932 (Kanji SJIS), 936 (Uproszczony Chiński), 949 (Hangul), 950
      (Tradycyjny Chiński). Zachęcamy użytkowników, żeby pisali testowe
      definicje dla własnych stron kodowych i wysyłali je na adres
      samba@samba.org. Wszystkie pliki stron kodowych w katalogu Samby
      <filename>source/codepages</filename> zostają skompilowane i
      zainstalowane, gdy zostanie wydane polecenie <command>make install
      </command>.</para>

    <para>Strona kodowa klienta używana przez serwer <command>smbd
      </command> jest konfigurowana przy użyciu parametru <parameter>
	client code page</parameter> w pliku <filename>smd.conf(5)
      </filename>.</para>
</refsect1>

<refsect1>
    <title>PLIKI</title>

    <para><filename>codepage_def.&lt;codepage&gt;</filename></para>

    <para>To są wejściowe (tekstowe) pliki stron kodowych dostarczone
      w katalogu Samba <filename>source/codepages</filename>.</para>

    <para>Plik tekstowy definicji strony kodowej składa sie z wielu
      linii zawierających po cztery pola. Polami tymi sa:</para>

    <itemizedlist>
      <listitem><para><replaceable>mała litera</replaceable>: jest (hex)
	  znakiem małej litery mapowanej w tej linii</para>
      </listitem>

      <listitem><para><replaceable>duża litera</replaceable>: jest (hex)
	  znakiem dużej litery do której będzie mapowana mała</para>
      </listitem>

      <listitem><para><replaceable>mapowanie dużej na małą</replaceable>
	  jest wartością boolean (wstaw tu albo <constant>True</constant>
	  albo <constant>False</constant>) która mówi Sambie, czy
	  jest to mapowanie podanego znaku dużej litery na podany znak
	  małej litery przy zamianie litery dużej na małą w nazwie pliku.
	</para></listitem>

      <listitem><para><replaceable>mapowanie małej na dużą</replaceable>
	  jest wartością boolean (wstaw tu albo <constant>True</constant>
	  albo <constant>False</constant>) która mówi Sambie, czy jest
	  to mapowanie podanego znaku małej litery na podany znak dużej
	  litery przy zamianie litery małej na dużą w nazwie pliku.
	</para></listitem>
    </itemizedlist>


    <para><filename>codepage.&lt;codepage&gt;</filename> -
      To są wyjściowe (binarne) pliki stron kodowych stworzone i
      umieszczone w katalogu przeznaczenia Samba <filename>lib/codepage
      </filename>.</para>
</refsect1>

<refsect1>
    <title>INSTALACJA</title>

    <para>Lokalizacja serwera i jego pliki wspierające są sprawą
      indywidualnych administratorów systemów. Dalej są więc zawarte
      tylko sugestie.</para>

    <para>Jest zalecane, aby program <command>make_smbcodepage</command>
      był zainstalowany w hierarchii <filename>/usr/local/samba</filename>,
      w katalogu możliwym do czytania przez wszystkich, do zapisu tylko
      przez root'a. Sam program powinien być możliwy do wykonania przez
      wszystkich. <emphasis>NIE</emphasis> powinien mieć ustawionych
      setuid lub setgid!</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="smbd.8.pl.html"><command>smbd(8)</command></ulink>, 
      <ulink url="smb.conf.5.pl.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 źródłowe tych stron zostały przekonwertowane
      do formatu YODL (kolejny świetny kawałek oprogramowania Open
      Source dostepny 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>
<!-- 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:
-->
