<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&kpf;">
  <!ENTITY package "kdenetwork">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Polish "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">

  <bookinfo>

    <title
>Podręcznik programu &kpf;</title>

    <authorgroup>

      <author
><firstname
>Rik</firstname
> <surname
>Hemsley</surname
> <affiliation
> <address
>&Rik.Hemsley.mail;</address>
        </affiliation>
      </author>

      <othercredit role="translator"
><firstname
>Paweł</firstname
><surname
>Dąbek</surname
><affiliation
><address
><email
>pdabek@onet.pl</email
></address
></affiliation
><contrib
>Polskie tłumaczenie</contrib
></othercredit
> 

    </authorgroup>

    <copyright>
      <year
>2002</year>
      <holder
>&Rik.Hemsley;</holder>
    </copyright>

    <legalnotice
>&FDLNotice;</legalnotice>

    <date
>2003-09-30</date>
    <releaseinfo
>1.0.1</releaseinfo>

    <abstract>
      <para
>Program &kpf; umożliwia udostępnianie plików w sieci. </para>
    </abstract>

    <keywordset>
      <keyword
>KDE</keyword>
      <keyword
>publiczny</keyword>
      <keyword
>serwer plików</keyword>
      <keyword
>HTTP</keyword>
    </keywordset>

  </bookinfo>

  <chapter id="introduction">

    <title
>Wstęp</title>

    <para
>&kpf; umożliwia łatwe udostępnianie plików za pomocą protokołu &HTTP; (ang. Hyper Text Transfer Protocol), czyli protokołu wykorzystywanego przez serwisy WWW do przesyłania danych do przeglądarek internetowych. &kpf; jest całkowicie publicznym serwerem plików, co oznacza, że nie istnieją ograniczenia dostępu do współdzielonych plików. Wszystko co zostanie udostępnione, będzie osiągalne dla wszystkich. </para>

    <para
>&kpf; ma służyć do udostępniania plików znajomym, a nie pełnić rolę w pełni funkcjonalnego serwera WWW, takiego jak <application
>Apache</application
>. &kpf; został pierwotnie stworzony do współdzielenia plików między użytkownikami <acronym
>IRC</acronym
> (ang. Internet Relay Chat czyli <quote
>pogawędek internetowych</quote
>). </para>

    <para
>Typowe użycie: &kpf; ma za zadanie przekazywać pliki z katalogu <filename class="directory"
>public_html</filename
> znajdującego się w katalogu domowym. Załóżmy, że chcemy udostępnić plik naszym rozmówcom z czatu. Zamiast wysyłać e-mail z załącznikiem (niektórzy mogą sobie tego nie życzyć), należy skopiować plik do katalogu <filename class="directory"
>public_html</filename
> i poinformować innych, że plik jest dostępny pod adresem http://www.mojkomputer.net:8001/moj_plik </para>

  </chapter>

  <chapter id="using-kpf">

    <title
>Korzystanie z &kpf;</title>

    <sect1 id="kpf-basics">

      <title
>Podstawowe informacje o &kpf;</title>

      <para
>&kpf; działa jako aplet wewnątrz &kicker-dopelniacz; (panelu). Oznacza to, że wykorzystuje on niewielki obszar ekranu i jego status jest zawsze widoczny. Aby uruchomić aplet &kpf;, kliknij <mousebutton
>prawym</mousebutton
> przyciskiem na panelu i wybierz <guimenu
>Dodaj aplet do panelu...</guimenu
>, w celu wywołania okna <guilabel
>Dodaj aplet</guilabel
>. Następnie wybierz <guilabel
>Publiczny serwer plików</guilabel
> i naciśnij przycisk <guibutton
>Dodaj do panelu</guibutton
>. </para>

      <para
>&kpf; działa na zasadzie udostępnionych katalogów. Możesz wskazać jeden lub więcej katalogów i uczynić je publicznymi, a wówczas wszystkie pliki w tych katalogach (i podkatalogach) będą udostępnione innym. </para>

      <para
>Przy wyborze współdzielonych katalogów należy zachować szczególną ostrożność. Wszystkie pliki w katalogu i jego podkatalogach, włączając w to pliki <quote
>ukryte</quote
> (czyli o nazwie zaczynającej się od kropki) staną się dostępne dla świata, dlatego nie należy udostępniać tak istotnych danych jak hasła, klucze kryptograficzne, książka adresowa, poufne dokumenty firmy, itp. </para>

      <para
>Po uruchomieniu &kpf; wyświetlony zostanie kwadratowy aplet otoczony cienką, zapadniętą ramką z ikoną przedstawiającą <guiicon
>balon na gorące powietrze</guiicon
>. Balon jest widoczny tylko wtedy, gdy żadne katalogi nie są udostępnione. </para>

      <para
>Aby rozpocząć udostępnianie katalogu, kliknij <mousebutton
>prawym</mousebutton
> przyciskiem na ikonie balonu, a wówczas ukaże się kontekstowe menu zawierające pozycję: <guimenuitem
>Nowy serwer...</guimenuitem
>. Wybranie tej pozycji uruchamia <quote
>asystenta</quote
>, który poprosi o odpowiedź na kilka prostych pytań. Udzielenie na nie odpowiedzi umożliwi utworzenie udostępnionego katalogu. </para>

      <para
>Możliwe jest alternatywne, bezpośrednie użycie apletu umożliwiające udostępnienie katalogu. &kpf; jest zintegrowany z &konqueror-narzednik;. </para>

      <para
>Mając wyświetlony katalog w programie &konqueror-mianownik;, kliknij <mousebutton
>prawym</mousebutton
> przyciskiem na tle i otwórz okno <quote
>Właściwości</quote
>. Podczas instalacji &kpf;, w oknie tym została dodana karta <guilabel
>Udostępnianie</guilabel
>. Jeśli &kpf; nie jest uruchomiony, będzie możliwość uruchomienia go z poziomu tej karty. Naciśnięcie przycisku <guibutton
>OK</guibutton
> wyśle do apletu &kpf; polecenie dodania nowego, udostępnionego katalogu. </para>

    </sect1>

  </chapter>

  <chapter id="share-config">

    <title
>Konfigurowanie udostępniania</title>

    <sect1 id="listen-port">

      <title
>Port nasłuchu</title>

      <para
>Dla każdego katalogu udostępnianego przez &kpf;, otwierany jest nowy <quote
>port</quote
> sieciowy. <quote
>Port</quote
> oznacza tu liczbę służącą do jednoznacznej identyfikacji serwisu sieciowego. Jeśli używamy pewnego programu (np. przeglądarki internetowej) do połączenia z jakimś komputerem, wówczas zostajemy przekierowani do serwisu po określeniu adresu komputera i <quote
>portu</quote
> na którym serwis jest uruchomiony. </para>

      <para
>Koncepcja <quote
>portu</quote
> umożliwia komputerowi pracę z więcej niż jednym serwisem sieciowym. Powszechnie używane serwisy to &HTTP; (strony WWW) wykorzystujący zwykle port 80, &SMTP; (wysyłanie e-maili) działający na porcie 25 i POP3 (odbieranie e-maili) najczęściej na porcie 110. </para>

      <para
>Łącząc się z serwisem sieciowym, zwykle nie musisz określać, którego <quote
>portu</quote
> chcesz używać. Dzieje się tak dlatego, że porty podlegają standaryzacji, więc każdy łączący się z portem 80 na komputerze sieciowym, spodziewa się znaleźć tam serwer &HTTP; (WWW). </para>

      <para
>&kpf; nie jest <quote
>standardowym</quote
> serwisem, więc jako domyślny został wybrany port 8001. </para>

      <para
>Drugi udostępniony katalog będzie widoczny na porcie 8002 i numer portu będzie zwiększany wraz z udostępnianiem kolejnego katalogu. </para>

      <para
>W ramach pewnych granic, można swobodnie wybierać numer portu służącego do udostępniania. </para>

      <para
>Zazwyczaj oznaczenia portów z liczbami poniżej 1000 są zarezerwowane dla serwisów <quote
>systemowych</quote
>, czyli będących pod nadzorem administratora komputera, dlatego próba użycia liczby poniżej 1000 zakończy się niepowodzeniem. </para>

      <para
>&kpf; stara się ostrzegać o sytuacjach, gdy nie może <quote
>nasłuchiwać</quote
> na danym porcie. Odbywa się to poprzez wyświetlenie ikony <guiicon
>zerwanego połączenia</guiicon
> nad lewym, górnym rogiem wykresu. &kpf; stara się powstrzymać Cię przed przydzieleniem więcej niż jednego udostępnienia do tego samego portu, ale nie będzie zapobiegał wybraniu portu nasłuchu zajętego już przez inny serwis, na przykład przez <quote
>prawdziwy</quote
> serwer WWW. </para>

      <para
>Jeśli zobaczysz ikonę <guiicon
>zerwane połączenie</guiicon
>, kliknij <mousebutton
>prawym</mousebutton
> przyciskiem na wykresie połączenia i wybierz <guimenuitem
>Konfiguruj...</guimenuitem
>. Następnie zmień port nasłuchu i naciśnij <guibutton
>OK</guibutton
>. Jeśli tym razem wybrany został wolny port, ikona <guiicon
>zerwanego połączenia</guiicon
> powinna zniknąć i nawiązanie połączenia z udostępnionym katalogiem będzie już możliwe. </para>

    </sect1>

    <sect1 id="bandwidth-limit">

      <title
>Limit przepustowości</title>

      <para
>Termin <quote
>przepustowość</quote
> odnosi się do ilości danych, które mogą być przesłane za pomocą łącza w pewnym okresie czasu. </para>

      <para
>&kpf; pozwala ustalić granice przepustowości połączenia przeznaczonego dla danego udostępnienia. Chodzi tu o uniknięcie zapchania łącza przez użytkowników współdzielonych katalogów. Posiadacz modemu ma dla siebie na przykład tylko kilka kilobajtów na sekundę. Ograniczenie przepustowości przeznaczonej dla &kpf; pozwala zachować część przepustowości na własne potrzeby. </para>

      <para
>Jak przed momentem wspomniano, &kpf; mierzy przepustowość w kilobajtach na sekundę lub krócej kB/s. Typowy modem telefoniczny przesyła średnio ok. 5kB/s, więc przeznaczenie mniejszej wartości na wszystkie udostępnione przez &kpf; katalogi jest rozsądnym posunięciem. Wszystko oczywiście zależy od tego jak używane jest &kpf;. </para>

    </sect1>

    <sect1 id="follow-symlinks">

      <title
>Podążanie za dowiązaniami symbolicznymi</title>

      <para
>Dowiązanie symboliczne to specjalny plik będący odnośnikiem do innego pliku (lub katalogu) w systemie plików. Podążając za dowiązaniem, dotrzesz do pliku lub katalogu do którego zostało utworzone dowiązanie - łącze jest zwykle przezroczyste dla programów. </para>

      <para
>Domyślne ustawienia &kpf; uniemożliwiają podążanie za dowiązaniami symbolicznymi. Gdyby podążanie za dowiązaniami było włączone i istniałby udostępniony katalog <filename class="directory"
>/twoj/katalog/domowy/public_html</filename
> oraz zostałoby utworzone dowiązanie wewnątrz <filename class="directory"
>public_html</filename
> wskazujące na <filename class="directory"
>/tmp</filename
>, wówczas każdy chcący wejść do katalogu <filename class="directory"
>/tmp</filename
> zobaczyłby zawartość katalogu <filename
>/tmp</filename
>. </para>

      <para
>Krótko mówiąc, umożliwienie podążania za dowiązaniami symbolicznymi w ten sposób nie jest najszczęśliwszym pomysłem. Jest to najczęściej dopuszczalne jeśli istnieją dowiązania wewnątrz udostępnionego katalogu wskazujące na inne miejsce wewnątrz udostępnionego katalogu. Może być to użyteczne, jeśli obsługiwana jest cała <quote
>strona WWW</quote
> - ale jak wspomnieliśmy wcześniej, nie takie jest przeznaczenie &kpf;. </para>

      <para
>Należy pamiętać o unikaniu dowiązań do jakiegokolwiek pliku lub katalogu w systemie mogącego zawierać niejawne informacje (lub zawierającego kolejne dowiązanie symboliczne do niejawnych informacji!). </para>

    </sect1>

  </chapter>

  <chapter id="faq">

    <title
>Pytania i odpowiedzi</title>

    <qandaset id="faq-questions">

      <qandaentry>

        <question>
          <para
>Dlaczego &kpf; nie zawiera żadnych mechanizmów bezpieczeństwa?</para>
        </question>

        <answer>

          <para
>Tak naprawdę, &kpf; zawiera wiele funkcji chroniących użytkownika przed udostępnieniem niejawnych informacji. Nie ma ochrony hasłem ani szyfrowania. Teraz wyjaśnimy dlaczego tak to zostało zaprojektowane. </para>

          <para
>Im więcej środków bezpieczeństwa dodano do serwisu, tym bezpieczniej czują się jego użytkownicy. Aby jednak zapewnić sobie prawdziwe bezpieczeństwo, użytkownik musi dobrze rozumieć powiązane z tym kwestie. Na przykład ochrona hasłem będzie bezużyteczna, jeśli nie zostanie wybrane właściwe hasło. Dlatego też postanowiliśmy wybrać opcję zerowego bezpieczeństwa, w nadziei, że użytkownik łatwiej zrozumie co to znaczy, niż gdyby miał poświęcać miesiące i lata na zdobywanie wiedzy na temat złożonych problemów bezpieczeństwa w sieci. </para>

          <para
>Koncepcja jest prosta: jeśli udostępniany jest jakiś katalog, to jest on udostępniany dla całego świata. Jeśli nie ma on być dostępny dla wszystkich, to nie udostępniaj go. </para>

        </answer>

      </qandaentry>

    </qandaset>

  </chapter>

  <chapter id="credits">

    <title
>Podziękowania i licencje</title>

    <para
>&kpf; </para>

    <para
>Prawa autorskie do programu: (c) 2002 &Rik.Hemsley; &Rik.Hemsley.mail; </para>

    <para
>Prawa autorskie do dokumentacji: (c) 2002 by &Rik.Hemsley; &Rik.Hemsley.mail; </para>

<para
>Polskie tłumaczenie dokumentacji: Paweł Dąbek <email
>pdabek@onet.pl</email
></para
> 
&underFDL; <para
>&kpf; jest rozpowszechniany na licencji MIT. </para>

  </chapter>

  <appendix id="installation">

    <title
>Instalacja</title>

    <sect1 id="getting-kpf">

      <title
>Jak zdobyć &kpf;</title>
&install.intro.documentation; </sect1>

  </appendix>

  &documentation.index; 

</book>

<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->

<!-- vim:tabstop=2:shiftwidth=2:expandtab -->