Provided by: manpages-pl_0.6-2_all 
NAZWA
innd, inndstart - InterNetNews daemon
SKŁADNIA
innd [ -a ] [ -c dni ] [ -C ] [ -d ] [ -f ] [ -H licznik ] [ -i licznik ] [ -Iadres_IP ] [
-l rozmiar ] [ -m tryb ] [ -n flaga ] [ -o licznik ] [ -pfd_des ] [ -Pport ] [ -r ] [ -s ]
[ -t opóźnienie ] [ -T licznik ] [ -u ] [ -X sekundy ] [ -Z ]
inndstart [ flagi ]
OPIS
Uwaga! To tłumaczenie może być nieaktualne!
Innd, który jest demonem news (InterNetNews), obsługuje wszystkie nadchodzące feedy.
Najpierw wczytuje do pamięci pliki active(5), newsfeeds(5) i incoming.conf(5). Potem
otwiera port NNTP do odbierania artykułów ze zdalnych stacji (zobacz opcję ``-p''). Jeśli
w include/config.h zdefiniowano HAVE_UNIX_DOMAIN_SOCKETS, to do odbioru artykułów od
lokalnych procesów, takich jak nnrpd(8) i rnews(1) otwierane jest gniazdo strumieniowe
dziedziny Uniksowej, a dla ctlinnd(8) odwierane jest analogiczne gniazdo datagramowe. Gdy
makro to nie jest zdefiniowane, używane są łącza nazwane. Ctlinnd(8) wykorzystywany jest
do przekazywania serwerowi poleceń wykonania określonych akcji. Otwiera również bazę
history(5) i dwa pliki raportowe, zastępujące jego standardowe wyjście i wyjście błędu.
Po otwarciu wszystkich plików i gniazd, innd oczekuje na połączenia i dane na swoich
portach, używając do tego select(2) i nieblokującego I/O. Jeśli nie ma dostępnych danych,
to wypróżni on swoje wewnątrzrdzeniowe struktury danych. Domyślna liczba sekund opóźnienia
przed wypróżnieniem jest ustawiana jako <DEFAULT_TIMEOUT w config.data> (zwykle 300)
sekund.
Jeśli innd otrzyma błąd ENOSPC (zobacz intro(2)) podczas zapisu pliku active, pliku
article lub bazy historii, to wyśle do siebie komendę ``throttle''. Stanie się tak
również, jeśli otrzyma zbyt wiele błędów wejścia-wyjścia podczas zapisu do jakiegoś pliku.
Niektóre parametry ustawiane w inn.conf(5) mogą być również podane w linii poleceń innd. W
tym wypadku, opcje z inn.conf(5) będą nadpisane przez opcje linii poleceń.
OPCJE
-a Domyślnie, jeśli host nie jest wymieniony w pliku incoming.conf to połączenie jest
przekazywane do nnrpd. Po użyciu tej flagi dowolny host może się podłączyć i
przesyłać artykuły.
-c innd odrzuca stare artykuły. Zasadniczo zachowanie to może być sterowane przez bazę
historii, lecz czasem stacja wyrzuca w sieć paczkę bardzo starych artykułów. Flaga
``odrzuca wszelkie artykuły, wysłane dawniej niż 21 dni temu. Wartość zerowa
powstrzymuje ten test. Domyślną wartością jest 14 dni, lecz można to zmienić opcją
``artcutoff'' w inn.conf(5)
-C Jeśli użyta jest flaga ``-C'', to innd przyjmie i przesyła dalej, ale nie
przetwarza wiadomości anulowania i powstrzymania. Jest to przeznaczone dla stacji,
w których nadużywane są anulowania i które wybierają mechanizm z lepszą
autoryzacją.
-d -f Innd normalnie przechodzi w tło, ustawia standardowe wyjścia na pliki raportowe i
odłącza się od terminala. Po użyciu flagi ``-d'' serwer tego nie robi, a po użyciu
flagi ``-f'', serwer pozostaje na pierwszym planie.
-H -T -X
Flagi ``-H'', ``-T'' i ``-X'' sterują liczbą połączeń dozwolonych na minutę. Ma to
w założeniach działać jako ochrona serwera przed czytnikami, które wykonują w ciągu
minuty zbyt wiele połączeń z serwerem. Zazwyczaj nie używa się tego, chyba że
rzeczywiście pojawia się jakiś problem. Tablica używana do tych sprawdzeń jest
ograniczona do 128 wpisów i jest używana jako pierścień (ring). Rozmiar został
wybrany do ułatwienia obliczania indeksu i do upewnienia się, że nie zabraknie ci
miejsca. Praktycznie wydaje się wątpliwe, żebyś wykorzystał nawet połowę tablicy
naraz.
Flaga ``-H'' określa maksymalną liczbę połączeń pochodzących z danego hosta z
serwerem podczas ``-X'' sekund. Domyślnie 2.
Flaga ``-T'' ogranicza całkowitą liczbę nadchodzących połączeń innda w okresie
``-X'' sekund. Maksymalną wartością jest 128. Domyślną 60.
Flaga ``-X'' ustawia liczbę sekund, używaną przez ``-H'' i ``-T''. Wartość zerowa
wyłącza sprawdzanie. Domyślnie jest 0.
-i Flaga ``-i'' ogranicza liczbę nadchodzących połączeń NNTP. Wartość zerowa wyłącza
to sprawdzenie. Domyślną wartością, jeśli w inn.conf(5) nie podano opcji
``maxconnections'' jest 50. Wymieniona opcja jest zastępowana wartością tej opcji.
-I Opcja ta umożliwia wiązanie innda do podanego adresu interfejsu IP. Adres IP musi
być w postaci kropkowej czwórki liczb (nnn.nnn.nnn.nnn). Zobacz też opcję
``bindaddress'' w inn.conf(5).
-l Flaga ``-l'' ogranicza rozmiar artykułu. Po użyciu tej flagi, wszystkie artykuły
większe niż rozmiar bajtów będą odrzucane. Domyślną wartością jest 1000000L bajtów.
Sprawdzanie można wyłączyć, używając wartości zerowej. Patrz także opcje
``maxartsize'' i ``localmaxartsize'' w inn.conf(5).
-m Flaga ``-m'' służy do uruchamiania serwera w zatrzymanym lub stłumionym stanie
(zobacz ctlinnd(8)). Argument rozpoczyna się pojedynczą literą: g, p lub t,
wskazujące odpowiednio na ``go'' (startuj), ``pause'' (zatrzymaj) lub ``throttle''
(stłum).
-n Flaga ``-n'' określa czy pauzowanie lub stłumienie serwera powinno również wyłączyć
przyszłe procesy czytnikowe. Wartość ``y'' powoduje, że czytniki zachowują się jak
serwer, a wartość ``n'' umożliwia czytanie, nawet gdy serwer nie pracuje.
Domyślnie zezwala się na czytanie, a zmienić można to opcją ``readerswhenstopped''
w inn.conf(5).
-o Flaga ``-o'' służy ograniczaniu liczby plików, które są utrzymywane otwarte dla
wychodzących feedów plikowych. Domyślną wartością jest liczba dostępnych
deskryptorów minus część zarezerwowana do użytku wewnętrznego.
-p Po użyciu flagi ``-p'' przyjmuje się, że port NNTP jest otwierany na podanym
deskryptorze. (Jeśli użyta jest ta flaga, to innd zakłada, że pracuje z właściwymi
uprawnieniami i nie będzie wołał chown(2) na żadnych z tworzonych plików lub
katalogów.)
-P Jeśli użyta jest flaga ``-P'', to podany port jest używany do nasłuchiwania
połączeń. innd musi mieć wystarczające uprawnienia startowe by otworzyć podany
port.
-r Jeśli użyta jest flaga ``-r'', serwer przenumeruje plik active zupełnie tak, jak po
wysłaniu komendy ``renumber''.
-s Jeśli użyta jest flaga ``-s'', to innd nic nie będzie robić, lecz tylko sprawdzi
składnię pliku newsfeeds. Jeśli będą tam błędy, to zgłosi kod błędu; rzeczywiste
błędy będą natomiast zgłoszone w syslog(3).
-t Zmienia czas opóźnienia przed wypróżnieniem do timeout sekund.
-u Raporty są normalnie buforowane; flaga ta wyłącza to zachowanie.
Inndstart jest małym programem typu front-end, który otwiera port NNTP, ustawia uid i gid
na opiekuna news, a następnie uruchamia demona innd z flagą ``-p'' i minimalnym
bezpiecznym środowiskiem. Jest to mały front-end dla stacji, która nie chce uruchamiać
innd z uprawnieniami roota.
KOMUNIKATY STERUJĄCE
Artykuły przychodzące, mające nagłówek Control są nazywane komunikatami sterującymi. Poza
komunikatem anulowania, są one zaimplementowane przez zewnętrzne programy w katalogu
<pathcontrol w inn.conf> o ile <usecontrolchan w inn.conf> jest ustawione na ``false''.
(Komunikaty anulowania (cancel) odświeżają bazę historii, więc muszą być obsługiwane
wewnętrznie; koszt synchronizowania, blokowania i odblokowywania byłby zbyt wysoki przy
odbiorze wielu takich komunikatów.)
Gdy nadchodzi komunikat sterujący, pierwsze słowo tekstu jest konwertowane na małe litery
i jest używane jako nazwa uruchamianego programu. Jeśli program nie istnieje, wywoływany
jest domyślny program, określony przez <pathcontrol w inn.conf>/default.
Wszystkie programy sterujące są wywoływane z czterema parametrami. Pierwszym jest adres
nadawcy komunikatu; jest to pobierane z nagłówka Sender. Jeśli nagłówek ten jest pusty, to
dane są pobierane z nagłówka From. Następnym parametrem jest adres zwrotny replik;
pobierany z nagłówka Reply-To. Jeśli nagłówek ten jest pusty, użyty zostanie adres
nadawcy. Trzecim parametrem będzie nazwa pliku, w którym znajduje się artykuł względem
katalogu składowego news. Czwartym parametrem jest host, który wysłał artykuł. Jest to
odczytywane z linii Path.
Jeśli <usecontrolchan w inn.conf> jest ustawione na ``true'', to żaden komunikat sterujący
nie będzie przetwarzany przez program zewnętrzny, forkowany przez innda. Zamiast tego,
będzie przetwarzany przez skrypt controlchan, który jest wywoływany jako program kanałowy
innda. Musisz do używania tego skryptu skonfigurować newsfeeds(5). Przetwarzanie z
użyciem controlchan może zredukować nadmierne obciążenie, jeśli zbyt wiele komunikatów
sterujących pojawia się naraz.
Dystrybucja komunikatu sterującego jest odmienna od dystrybucji standardowych artykułów.
Komunikaty sterujące normalnie wpadają do grupy dyskusyjnej control. Mogą one być
zapisywane w podgrupach, lecz w oparciu o polecenie komunikatu sterującego. Na przykład
komunikat newgroup może być zapisany w grupie control.newgroup lub w ogólnym control,
jeśli specjalizowana podgrupa nie istnieje.
Stacje mogą jawnie udostępniać grupę ``control'' w ich listach zapisowych, lecz zwykle
lepiej jest ją wyłączyć. Jeśli komunikat sterujący jest wysyłany na grupę, której nazwa
kończy się czterema znakami ``.ctl'', to przyrostek jest obcinany, a to co pozostanie jest
używane jako nazwa grupy. Na przykład komunikat anulujący, wysłany na ``news.admin.ctl''
zostanie przesłany do wszystkich stacji zapisanych na grupy ``control'' lub
``news.admin''. Wiadomości newgroup lub rmgroup wymagają dodatkowego specjalnego
traktowania. Jeżeli wiadomość jest zaakceptowana i została wysłana do tworzonej lub
usuwanej grupy, to ta wiadomość zostanie przesłana do wszystkich serwerów, których wzorce
subskrypcji grup pozwoliłyby na odebranie wiadomości wysyłanych do tej grupy.
Jeśli <mergetogroups w inn.conf> jest ustawione na ``true'', to gdy artykuł jest wysyłany
na grupę, która rozpoczyna się trzema literami ``to.'', to zostanie potraktowany
specjalnie, jeśli grupa ta nie istnieje w pliku active: artukuł jest składowany do grupy
``to'' i jest wysyłany do pierwszej stacji, nazwanej po przedrostku. Na przykład,
wysyłanie do ``to.uunet'' zostanie złożone do ``to'' i przesłane do stacji ``uunet''.
file:
RÓŻNICE PROTOKOŁU
Innd implementuje komendy NNTP zdefiniowane w RFC 977 z następującymi odstępstwami:
1. Za ``list'' może występować dodatkowo argument ``active'', ``active.times'',
``newsgroups'' lub ``subscription''. Jest to popularne rozszerzenie, lecz nie w
pełni obsługiwane; zobacz nnrpd(8).
2. Zaimplementowane są komendy ``authinfo user'' oraz ``authinfo pass''. Zobacz
draft-barber-nntp-imp-07.txt dla dalszych szczegółów.
3. Udostępniona jest nowa komenda, ``mode reader''. Komenda ta powoduje, że serwer
przekazuje połączenie do nnrpd. Komenda ``mode query'' przeznaczona jest dla
przyszłych zastosowań i obecnie jest traktowana tak samo.
4. Udostępnione są komendy wspierające transfer strumieniowy: ``check messageid'' i
``takethis messageid''.
5. Udostępniona jest komenda transferu wsadowego ``xbatch liczba-bajtów''. Komenda ta
odczyta liczbę-bajtów bajtów i zapisze je dla dalszego przetwarzania przez rnews(1)
(który należy uruchomić oddzielnie). Obejrzyj programy innxbatch i sendxbatches.sh.
6. Pozostałymi zaimplementowanymi komendami są ``head'' , ``help'' , ``ihave'' ,
``quit'' oraz ``stat''.
MODYFIKACJE NAGŁÓWKÓW
Innd modyfikuje tak mało nagłówków, jak tylko się da, lecz mógłby być lepszy.
Oto lista nagłówków, które jeśli istnieją, są usuwane:
Date-Received
Posted
Posting-Version
Received
Relay-Version
Puste nagłówki oraz nagłówki składające się z białych spacji również są opuszczane.
Do nagłówka Path doklejana jest nazwa lokalnej stacji (określanej przez wartość
``pathhost'' w inn.conf(5)) i wyrzyknik (jeśli nazwa pierwszej stacji nagłówka różni się
od lokalnej).
Nagłówek Xref jest usuwany i tworzony jest nowy.
W przypadku nieobecności, nagłówek Lines jest dodawany.
Innd nie przepisuje nieprawidłowych nagłówków. Na przykład nie będzie zmieniać
nieprawidłowego nagłówka Lines, ale odrzuci artykuł.
RAPORTOWANIE
Innd raportuje wszystkie nadchodzące artykuły do pliku raportowego. Jest to plik tekstowy
o zmiennej ilości rozdzielanych spacjami pól o jednym z następujących formatów:
mon dd hh:mm:ss.mmm + feed <Message-ID> stacja...
mon dd hh:mm:ss.mmm j feed <Message-ID> stacja...
mon dd hh:mm:ss.mmm c feed <Message-ID> stacja...
mon dd hh:mm:ss.mmm - feed <Message-ID> powód...
mon dd hh:mm:ss.mmm ? feed <Message-ID> powód...
Po polu Message-ID może być również pole nazwy hosta i rozmiaru, zależnie od opcji
``nntplinklog'' i ``logsize'' z inn.conf(5).
Pierwsze trzy pola są polami daty i czasu w rozdzielczości milisekundowej. Piąte pole
jest stacją, która wysłała artykuł (odczytywane z nagłówka Path). Szóste pole jest
identyfikatorem artykułu; jeśli informacja jest niedostępna, pojawi się w jej miejscu
pytajnik.
Czwarte pole określa czy artykuł został przyjęty czy nie. Jeśli jest tam znak plus, to
został przyjęty. Jeśli ``j'', to został przyjęty, lecz wszystkie grupy mają w swoich
rekordach active ``j'', więc artykuł został złożony do grupy ``junk''. Jeśli w polu
pojawiła się litera ``c'', to przed pojawieniem się oryginalnego artykułu odebrany został
komunikat anulujący. We wszystkich tych przypadkach artykuł został przyjęty i pole
``stacja...'' zawiera rozdzieloną spacjami listę stacji, do których artykuł jest
przesyłany.
Jeśli czwarte pole zawiera znak minusa, o artykuł został odrzucony. Powodami odrzucenia
mogą być:
"%s" header too long (za długi nagłówek)
"%s" wants to cancel <%s> by "%s" ("%s" chce anulować <%c> poprzez "%s")
Article exceeds local limit of %s bytes (Artykuł przekracza lokalny
limit %s bajtów)
Article posted in the future -- "%s" (Artykuł wysłany w przyszłości -- "%s")
Bad "%s" header (Zły nagłówek "%s")
Can't write history (Nie mogę zapisać historii)
Duplicate (Duplikat)
Duplicate "%s" header (Zduplikowany nagłówek "%s")
EOF in headers (EOF w nagłówkach)
Linecount %s != %s +- %s (Liczba linii %s != %s +- %s)
Missing %s header (Brak nagłówka %s)
No body (Brak ciała)
No colon-space in "%s" header (Brak dwukropka-spacji w nagłówku "%s")
No space (Brak spacji (albo miejsca???))
Space before colon in "%s" header (Spacja przed dwukropkiem w nagłówku "%s")
Too old -- "%s" (Za stare -- "%s")
Unapproved for "%s" (Niezatwierdzone dla "%s")
Unwanted newsgroup "%s" (Niechciana grupa dyskusyjna "%s")
Unwanted distribution "%s" (Niechciana dystrybucja "%s")
Whitespace in "Newsgroups" header -- "%s" (Biała spacja w nagłówku
"Newsgroups" -- "%s")
Gdzie ``%s'' jest podmieniane przez konretniejsze informacje.
Jeżeli w czwartym polu wystąpi znak ``?'', oznzcza to, że atykuł zawiera dziwne łańcuchy
znaków, tj. CR bez LF lub LF bez CR. Te znaki są używane razem ``CRLF'', co oznacza koniec
linii. Obecnie taka informacja w logu oznacza dziwność tego artykułu, ale innd nigdy nie
odrzuca artykułu z tego powodu.
Zauważ, że jeśli artykuł jest przyjęty i <wanttrash w inn.conf> jest ustawione na ``yes''
i żadna z grup nie jest odpowiednia, to zostanie zraportowany w dwóch liniach: w linii
``j'' i ``-''.
Innd zgłasza też obszerne raporty poprzez sysloga. Pierwsze słowo komunikatu raportowego
będzie: nazwą stacji, jeśli wpis jest dla niej specyficzny (np. komunikat ``connected'');
słowem ``SERVER'', jeśli komunikat jest związany z serwerem, np. gdy pojawi się błąd
odczytu.
Jeśli drugim słowem są cztery litery ``cant'', to zgłaszany jest błąd. W tym przypadku
następne dwa słowa ogólnie nazywają wywołanie systemowe lub funkcję biblioteczną, która
się nie powiodła oraz obiekt, wokół którego wykonywane były działania. Reszta linii może
zawierać inne informacje.
W innych przypadkach, drugie słowa określa rodzaj zmiany, a reszta linii uściśla tę
informację. Słowo ``internal'' ogólnie oznacza wewnętrzny błąd logiczny.
SYGNAŁY
Innd przechwytuje sygnały SIGTERM i SIGDANGER i wyłącza się po nich. Jeśli użyta jest
flaga ``-d'', przechwytywany będzie również SIGINT i będzie działał analogicznie.
Innd przechwytuje sygnał SIGUSR1 i odtwarza kanał sterujący, wykorzystywany normalnie
przez ctlinnd(8).
HISTORIA
Napisane przez Richa $alza <rsalz@uunet.uu.net> dla InterNetNews. Jest to rewizja
1.24.2.4, z dnia 2000/08/20.
ZOBACZ TAKŻE
active(5), ctlinnd(8), dbz(3), history(5), incoming.conf(5), inn.conf(5), newsfeeds(5),
nnrpd(8), rnews(1), syslog(8).
INFORMACJE O TŁUMACZENIU
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może
nie być aktualne. W razie zauważenia różnic między powyższym opisem a rzeczywistym
zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie się z oryginalną
(angielską) wersją strony podręcznika za pomocą polecenia:
man --locale=C 8 innd
Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.
INND(8)