userapps/opensource/ftpd/doc/pl/bftpddoc-pl.sgml

   1 <!doctype linuxdoc system>\r
   2 \r
   3 <article>\r
   4 \r
   5 <!-- Title information -->\r
   6 \r
   7 <title>dokumentacja bftpd [jezyk polski]</title>\r
   8 <author>\r
   9  <name>napisana przez Max-Wilhelm Bruker <tt/&lt;brukie@gmx.net/&gt;</name>\r
  10 </author>\r
  11 <!--<date>$Id: bftpddoc-pl.sgml,v 1.1.1.1 2006/05/24 20:04:52 mshtulberg Exp $</date>-->\r
  12 \r
  13 <abstract>\r
  14 Ten dokument stanowi dokumentacje serwera bftpd.\r
  15 </abstract>\r
  16 \r
  17 <!-- Table of contents -->\r
  18 <toc>\r
  19 \r
  20 <!-- Begin the document -->\r
  21 \r
  22 <sect>Wprowadzenie \r
  23 \r
  24  <p>\r
  25 bfptd jest serwerem FTP dla Linuxa, BSD/OS, FreeBSD, Solarisa, DG-UXa oraz Tru64 (nie wiem czy dziala on na innych systemach, jesli probowales, napisz do mnie). Uruchamiany moze byc poprzez inetd badz w trybie standalone (demon).\r
  26  </p>\r
  27  <p>\r
  28   bftpd stara sie byc bardzo elastycznym przy zachowaniu malego rozmiaru oraz swojej szybkosci. Mozesz wprowadzac wartosci domyslne dla kazdej opcji w konfiguracji a nastepnie nadpisywac je poprzez lokalne parametry.\r
  29 </p>\r
  30  <p>\r
  31 Do zalet bftpd zaliczyc mozna: \r
  32   <itemize>\r
  33 <item> Prosta konfiguracje \r
  34 <item> Predkosc \r
  35 <item> Obsluge wiekszosci komend FTP RFC \r
  36 <item> Kompresje w locie do archiwow .tar.gz \r
  37 <item> Bezpieczenstwo poprzez proste wprowadzenie chroota \r
  38 <item> Brak koniecznosci udostepniania basha oraz innych komend w srodowisku chroot \r
  39 <item> Logowanie do wtmp oraz do pliku badz demona syslogd \r
  40 <item> Obsluge PAM oraz hasel passwd/shadow \r
  41 <item> Obsluge komend SITE CHOWN/CHMOD\r
  42  \r
  43   </itemize>\r
  44  </p>\r
  45 </sect>\r
  46 \r
  47 <sect> Instalacja\r
  48 <sect1> Kompilacja\r
  49 <p>\r
  50 Najpierw uruchom nastepujace polecenia (zamieniajac x.x.x na wersje, ktora instalujesz):\r
  51   <tscreen><verb>\r
  52 tar xzf bftpd-x.x.x.tar.gz\r
  53 cd bftpd-x.x.x\r
  54 ./configure\r
  55 make\r
  56 make install [wymaga roota]\r
  57   </verb></tscreen>\r
  58 Wiedz, ze jesli upgradujesz bftpd ze starszej wersji, musisz recznie skopiowac plik bftpd.conf do katalogu /etc, poniewaz polecenie 'make install' nie nadpisuje pliku konfiguracyjnego.\r
  59  </p>\r
  60  <p>\r
  61  Uwaga: Jesli chcesz korzystac z opcji kompresji w locie do .tar.gz, musisz sciagnac kody zrodlowe gzipa oraz paxa i rozpakowac je do katalogu zrodlowego bftpd. Nastepnie, zamiast uruchomic "./configure", wykonaj &dquot;./configure --enable-pax=katalog-z-paxem --enable-gzip=katalog-z-gzipem&dquot;.\r
  62  </p>\r
  63 <sect1> Uruchamianie serwera\r
  64 <p>\r
  65 Do wyboru masz uruchamianie bftpd poprzez inetd oraz w trybie standalone (demon). \r
  66  <descrip>\r
  67 <tag> Jesli chcesz korzystac z inetd: </tag>\r
  68  Dodaj nastepujacy wpis do /etc/inetd.conf: \r
  69 <tscreen>ftp stream tcp nowait root /usr/sbin/bftpd bftpd<verb></verb></tscreen>\r
  70  Wyslij inetdowi sygnal HUP lub zrestartuj system. Od tego momentu bftpd powinien pracowac.\r
  71 <tag> Jesli chcesz uruchomic bftpd jako demona (standalone): </tag>\r
  72  Kaz systemowi uruchamiac: \r
  73   <tscreen><verb>/usr/sbin/bftpd -d</verb></tscreen>\r
  74   przy  starcie.\r
  75   </descrip>\r
  76  </p>\r
  77 \r
  78 <sect>Konfiguracja\r
  79 <sect1>Zarzadzanie uzytkownikami<p>\r
  80 Mozesz obslugiwac konta uzytkownikow w bardzo prosty sposob, edytujac plik /etc/passwd oraz, jesli Twoj system to obsluguje, /etc/shadow. Kazdy uzytkownik wystepujacy w /etc/passwd moze sie polaczyc z serwerem jesli poda haslo i spelni wymagania konfiguracji serwera bftpd. Mozna rowniez zalozyc konto anonymous, ustawiajac zmienna ANONYMOUS_USER na yes. bftpd obsluguje rowniez PAM.\r
  81 </p>\r
  82 <sect1> Plik konfiguracji (/etc/bftp.conf)\r
  83 <sect2> Sekcja globalna\r
  84 <p>\r
  85 W tej sekcji mozesz nadawac wartosci opcjom konfiguracji. Skladnia jest nastepujaca:\r
  86 <tscreen><verb>\r
  87 global {\r
  88   nazwa1=wartosc1\r
  89   nazwa2=wartosc2\r
  90 }\r
  91 </verb></tscreen>\r
  92 </p>\r
  93 <sect2>Sekcja uzytkownikow\r
  94 <p>\r
  95 W konfiguracji wystepuje rowniez sekcja uzytkownikow, w ktorej mozesz nadpisywac wartosci globalne dla poszczegolnych uzytkownikow. Przyklad: \r
  96 <tscreen><verb>\r
  97 global {\r
  98   nazwa1=wartosc1\r
  99   nazwa2=wartosc2\r
 100 }\r
 101 user foo {\r
 102   nazwa1=wartosc3\r
 103 }\r
 104 </verb></tscreen>\r
 105 Jesli uzytkownik foo sie zaloguje, to nazwa pierwsza bedzie miala wartosc3. Jesli zalogowany jest inny uzytkownik, nazwa1 ma warosc1, natomiast nazwa2 ma zawsze wartosc2.\r
 106 \r
 107 </p>\r
 108 <sect2>Sekcja grup uzytkownikow\r
 109 <p>\r
 110 Mozesz takze definiowac konfiguracje grupom uzytkownikow - podobnie jak dla jednego uzytkownika, tylko mozesz przydzielic ich kilku pod postacia grupy. Mozesz rowniez umieszczac w konfiguracji grupy systemowe dodajac do ich nazwy znak @. Przyklad:\r
 111 <tscreen><verb>\r
 112 group foo,bar,@baz {\r
 113   nazwa1=wartosc1\r
 114 }\r
 115 </verb></tscreen>\r
 116 Te opcje oddzialuja na uzytkownikow foo i bar oraz na kazdego z grupy systemowej baz.\r
 117 </p>\r
 118 <sect2>Sekcja katalogow\r
 119 <p>\r
 120 Mozesz ustalac opcje, ktore beda wazne tylko dla uzytkownikow znajdujacych sie w danym katalogu, badz jego podkatalogach. Wez pod uwage, ze musisz umiescic te struktury w opcjach globalnych, uzytkownikow oraz grup. W ten sposob mozesz takze nadpisywac specyficzne ustawienia katalogu dla danych uzytkownikow. Przykladowo:\r
 121 <tscreen><verb>\r
 122 global {\r
 123   nazwa=wartosc1\r
 124   directory /foo {\r
 125     nazwa1=wartosc2\r
 126   }\r
 127 }\r
 128 user bar {\r
 129   directory /foo {\r
 130     nazwa1=wartosc3\r
 131   }\r
 132 }\r
 133 </verb></tscreen>\r
 134 Tutaj, nazwa1 bedzie miala warosc3 jesli uzytkownik bar bedzie w katalogu /foo. Natomiast wartosc2 przybierze jesli inny uzytkownik znajdzie sie w katalogu /foo. Kazdy inny przypadek spowoduje nadanie nazwie1 wartosci1.\r
 135 </p>\r
 136 <p>\r
 137 Wyjasnienie tych opcji znajdziesz w pliku konfiguracyjnym bftpd (jesli nie upgradowales bftpd, plik zostal juz skopiowany do /etc). Zmodyfikuj oczywiscie plik do twoich potrzeb. Jednak domyslna konfiguracja tez powinna byc w porzadku.\r
 138 </p>\r
 139 \r
 140 <sect>FAQ\r
 141 <sect1>Problemy z kompilacja\r
 142 <sect2>Nie moge skompilowac bftpd\r
 143 <p>\r
 144 Daj mi znac. Powiedz na jakim systemie i architekturze go kompilowales, przeslij tez wyjscie calego procesu kompilacji (configure i make). Nie dostaje ton poczty, wiec postaram sie rozwiazac Twoj problem. Jesli natomiast nie odpowiem, prawie zapomnialem o Twoim mailu, wiec go ponow :)\r
 145 </p>\r
 146 <sect2>Wystepuja dziwne ostrzezenia\r
 147 <p>\r
 148 To jest calkiem mozliwe na platformach, na ktorych nie testowalem bftpd. Nawet jesli bftpd skompiluje sie prawidlowo i dziala bez zarzutu, prosze, przeslij mi informacje na ten temat, gdyz kompilator moze powodowac niezauwazalne na pierwszy rzut oka problemy.\r
 149 </p>\r
 150 <sect2>Make mowi ze nie moge uzywac wtmp\r
 151 <p>\r
 152 Prawdopodobnie uzywasz Solarisa. Poniewaz nie mam dostepu do takiej maszyny, nigdy nie moglem sprawdzic jej wtmp. Jesli otrzymujesz taki komunikat i nie wiesz czym jest w ogole wtmp, nie martw sie o to. Jesli jest inaczej, pomoz mi rozwiazac problem.\r
 153 </p>\r
 154 <sect1>Problemy przy uruchamianiu\r
 155 <sect2>Otrzymuje komunikat &dquot;Could not get peer IP address.&dquot;\r
 156 <p>\r
 157 Uruchomiles bftpd przez konsole. Jesli chcialbys z niego korzystac w trybie standalone, musisz dodac opcje &dquot;-d&dquot;. Jesli jednak ustawiles go jako usluge inetd, sprawdz to przez:\r
 158 <tscreen><verb>\r
 159 hostname:&tilde;$ ftp localhost\r
 160 </verb></tscreen>\r
 161 </p>\r
 162 <sect2>Dostaje blad &dquot;Bind failed: Address already in use.&dquot;\r
 163 <p>\r
 164 Ten blad oznacza, ze inny proces juz wykorzystuje port, na ktorym chcesz uruchomic serwer bftpd. Mozesz zmienic numer portu bftpd w pliku konfiguracyjnym (bftpd.conf) - opcja PORT w strukturze globalnej. Domyslnie ustawiony jest na 21. Jesli nie zmieniales tego portu, prawdopodobnie zapomniales wylaczyc swoj stary serwer FTP. Zajrzyj do /etc/inetd.conf oraz do wydruku polecenia  &dquot;ps aux | grep ftp&dquot;.\r
 165 </p>\r
 166 <sect1>Problemy podczas sesji FTP\r
 167 <sect2>Mam blad podobny do &dquot;500 Unknown command: 'foo'&dquot;\r
 168 <p>\r
 169 Twoj program wyslal komende, ktorej bftpd nie rozpoznal. To jest moj blad, chyba ze rzeczywiscie wyslales nieistniejace polecenie. Sprawdz czy sie nie pomyliles przy jego wpisywaniu i wyslij mi raport, jesli masz pewnosc, ze komenda byla dobra.\r
 170 </p>\r
 171 <sect2>Sesja sie konczy bledem 421\r
 172 <p>\r
 173 Jesli porobujesz sie zalogowac ze zlym haslem, bftpd zerwie polaczenie. Jesli sie zalogowales zanim blad sie pojawil, badz blad wystapil przed zalogowaniem, to na pewno jest moj blad. Powiedz mi o tym.\r
 174 </p>\r
 175 <sect1>Rozne\r
 176 <sect2>Jak dziala kompresja w locie?\r
 177 <p>\r
 178 Zalozmy, ze masz katalog nazywajacy sie foo. Nawet jesli nie ma pliku o nazwie foo.tar.gz, mozesz jednak uzyc polecenia RETR i bedzie on zaweral zawartosc katalogu foo, tar-gzipowana. Mozesz rowniez sciagac pliki:\r
 179 <itemize>\r
 180 <item>dirname.tar</item>\r
 181 <item>filename.gz</item>\r
 182 </itemize>\r
 183 Jesli chcesz korzystac z tej opcji, wkompiluj ja najpierw (patrz: instalacja)\r
 184 </p>\r
 185 <sect2>Moje opcje dla polaczen anonymous nie dzialaja\r
 186 <p>\r
 187 Jesli w strukturze jest opcja ALIAS=...., nie musisz uzupelniac jej opcjami. Zamiast tego, zrob to w sekcji, do ktorej sie alias odnosi.\r
 188 </p>\r
 189 <sect2>Dlaczego dokumentacja jest tak uboga?\r
 190 <p>\r
 191 Odpowiedz jest prosta, nikt niczego nie napisal :)<newline>\r
 192 Nigdy nie wiem co napisac, wiec jesli masz jakas wizje wzbogacenia dokumentacji, prosze, poinformuj mnie o tym. To samo dotyczy tlumaczen na inne jezyki. Jesli chcialbyc cos stworzyc, zrob to, jednak zwracaj uwage na bledy stylistyczne i literowki.\r
 193 </p>\r
 194 <sect>Credits\r
 195 <sect1>Testowanie na roznych platformach\r
 196 <p>\r
 197 <itemize>\r
 198 <item>David L. Nicol (david@kasey.umkc.edu) testowal bftpd na Tru64.</item>\r
 199 <item>JackRipper (vic@altoona.net) testowal bftpd na BSD/OS oraz DG-UX.</item>\r
 200 <item>Christian Beyerlein (christian@beyerlein.de) testowal bftpd na FreeBSD i Solarisie.</item>\r
 201 <item>Ludzie z kanalu #linux (IRCNet) sprawdzali bftpd na roznych systemach.</item>\r
 202 </itemize>\r
 203 </p>\r
 204 <sect1>Pomysly, uwagi&amp; fragmenty kodu\r
 205 <p>\r
 206 <itemize>\r
 207 <item>Josh Woodcock (josh@hamparts.com) podzielil sie kiloma uwagami - Solaris 8.</item>\r
 208 <item>Floh (floh@maflohsoft.de) zasugerowal wbudowac obsluge ASCII.</item>\r
 209 <item>Erik Hensema (erik@hensema.xs4all.nl) znalazl blad w netfilterze 2.4.0 wplywajacy na bftpd.</item>\r
 210 <item>Heiko Rother (rother@cmsnet.de) mial wiele dobrych pomyslow (patrz changelog).</item>\r
 211 <item>Christophe Bailleux (cb@grolier.fr) wprost uwielbia znajdowac problemy w listingowaniu katalogow. Poza tym mial wiele uwag i podeslal wiele fragmentow kodu.</item>\r
 212 <item>Jonathan Heusser (jonathanheusser@gyml.unibas.ch) znalazl blad przepelnienia bufora.</item>\r
 213 <item>Christian Beyerlein (christian@beyerlein.de) zaproponowal aliasy uzytkownikow.</item>\r
 214 <item>Elmusafir (jslmarti@campus.cem.itesm.mx) doniosl o bledzie we wspolpracy ze Staroffice, ktory naprawiono w wersji 1.0.8.</item>\r
 215 <item>Alex Madden (alexm@immstudios.com) oraz Daniel Mack (daniel.mack@nextra.de) napisali o niekompatybilnosci z Solarisem -  naprawiono w 1.0.8.</item>\r
 216 <item>Daniel Mack (daniel.mack@nextra.de) podeslal duzego patcha (patrz changelog).</item>\r
 217 </itemize>\r
 218 </p>\r
 219 <sect1>Pisanie dokumentacji\r
 220 <p>\r
 221 <itemize>\r
 222 <item>Radek Michalski (radek@end.p-s.com.pl) przetlumaczyl dokumentacje bftpd na jezyk polski.</item>\r
 223 </itemize>\r
 224 </p>\r
 225 <sect1>Inne\r
 226 <p>\r
 227 <itemize>\r
 228 <item>\r
 229 Kilka pomyslow struktry kodu zaczerpnalem z betaftpd Steinera H. Gutersona. Ale to raptem kilka linii.\r
 230 </itemize>\r
 231 </p>\r
 232 </article>\r