Następna strona Poprzednia strona Spis treści

1. Wstęp

Do napisania tego dokumentu zainspirował mnie znakomity BootPrompt-HOWTO Paula Gortmakera. Za zgodą Paula wykorzystałem jego pracę jako ramę, na której rozpiąłem swoje wywody. Różne części tego dokumentu zostały bezwstydnie, bez jakichkolwiek pozwoleń, skradzione z rozmaitych plików README i *.txt, które znaleźć można w katalogach źródłowych Linuxa. Składam szczere podziękowania wszystkim autorom tych tekstów - dzięki nim mógł powstać Module-HOWTO.

Struktura/kolejność modułów opisanych w niniejszym dokumencie jest w zasadzie analogiczna do zastosowanej w programie konfiguracyjnym jądra systemu - menuconfig, uruchomionym w trybie single_menu_mode=TRUE.

Zamieszczam tutaj wszystkie elementy, które w programie konfiguracyjnym mają opcję "moduł", niezależnie od faktu, czy mają one jakieś parametry ładowania czy też nie.

Wszystkie elementy opracowane są zgodnie z poniższym przykładowym schematem: 

Polecenie ładowania:
        /sbin/modprobe ne.o io=0x300 irq=5
            
        io = 0          (Wymaga jawnego określenia wartości "io=0xNNN")
        irq = 0         (Próbuje określić ustawione IRQ poprzez autoIRQ)
        (Sprawdza porty: 0x300, 0x280, 0x320, 0x340, 0x360)
            
        Wymaga 8390.o

Autorem i opiekunem Module-HOWTO jest:

Lauri Tischler, ltischler@efore.fi

Wersja polska:

Pawko Olszewski, alder@amg.com.pl

v1.0, 23 lutego 1997

1.1 Deklaracja i Prawa autorskie

Ten dokument nie jest wyrocznią. Prawdopodobnie zawiera on jednak najbardziej aktualne informacje, jakie można znaleźć. Za to, co dzieje się z twoimi urządzeniami nie odpowiada nikt inny, jak tylko ty sam. Jeśli twój sprzęt pójdzie z dymem (...prawie niemożliwe!), nie biorę za to żadnej odpowiedzialności. Tzn. AUTOR ANI TŁUMACZ NIE SĄ ODPOWIEDZIALNI ZA JAKIEKOLWIEK USZKODZENIA POWSTAŁE W WYNIKU PODJĘCIA DZIAŁAŃ OPARTYCH NA INFORMACJI ZAWARTEJ W NINIEJSZYM DOKUMENCIE.

Prawa autorskie tego dokumentu (c) 1996 są własnością Lauri Tischlera. Tłumaczenie na polski - Paweł Olszewski (c) 1997. Udziela się pozwolenia na wykonywanie i rozprowadzanie kopii tego podręcznika przy zachowaniu jego brzmienia, pod warunkiem, że nota o prawach autorskich i niniejsze pozwolenie znajdą się w każdej kopii.

Zezwala się również na wykonywanie i rozprowadzanie zmodyfikowanych kopii tego dokumentu w nie zmienionym brzmieniu, pod warunkiem, że niniejsza nota o prawach autorskich zostanie w nich zamieszczona dokładnie tak samo jak w wersji oryginalnej, oraz że cała powstała w oparciu o ten dokument praca będzie rozprowadzana wraz z zezwoleniem identycznym do tego.

Zezwala się na kopiowanie i rozprowadzanie innych wersji językowych tego dokumentu, przy zachowaniu powyżej opisanych zasad co do wersji zmodyfikowanych.

Jeśli zamierzasz włączyć ten dokument do prac przeznaczonych do publikacji, proszę, skontaktuj się z autorem, aby mógł zapewnić, że posiadasz możliwie najbardziej aktualną informację.

Zdarzyło się kiedyś, że opublikowano nieaktualne wersje dokumentów HOWTO dotyczących Linuxa. Skutkiem tego programiści rozwijający Linuxa narażeni zostali na zbędny wysiłek z powodu zalewu pytaniami, na które udzielono już odpowiedzi w uaktualnionych wersjach dokumentów.

1.2 Dodatkowa Dokumentacja

Zalecane są następujące HOWTO:

Plik Documentation/Configure.help udziela dość dobrej, ogólnej informacji o tym, którym częściom jądra nadawać postać modułów, a którym nie.

Również krocie rozmaitych plików README, porozsiewanych (niestety) po całym Drzewie Katalogów Źródłowych Linuxa są dobrą i pouczającą lekturą.

Najbardziej aktualną dokumentacją zawsze będzie sam Kod Źródłowy. Na przykład, jeśli chcesz się dowiedzieć, jakie parametry mogą zostać przekazane karcie ethernet smc-ultra, zaglądasz do karalogu linux/drivers/net i oglądasz plik smc-ultra.c -- zazwyczaj gdzieś pod koniec tego pliku można znaleźć procedurę zwaną init_module. W obrębie tej procedury lub w jej pobliżu znajdziesz definicje parametrów i ich struktury, odpowiadające parametrom modułu.

1.3 Linuxowe Grupy Dyskusyjne

Jeśli masz pytania dotyczące przekazywania modułom parametrów w trakcie ich ładowania, w pierwszej kolejności PRZECZYTAJ ten dokument. Jeśli nie znajdziesz odpowiedzi na swoje pytanie/pytania ani tutaj, ani we wcześniej wymienionej dokumentacji dodatkowej, możesz spróbować spytać w grupach dyskusyjnych.

Ogólne pytania na temat konfigurowania systemu należy kierować do grupy comp.os.linux.setup. Prosimy, abyś respektował tę ogólną zasadę dotyczącą treści listów i nie przesyłał swoich zapytań ogólnych do grup poświęconych konkretnym zagadnieniom.

1.4 Nowe Wersje Tego Dokumentu

Nowe wersje oryginału tego dokumentu pobrać można przez anonimowy FTP z sunsite.unc.edu, z katalogu /pub/Linux/docs/HOWTO/* i wielu linuxowych archiwów lustrzanych. Poprawki będą dokonywane w miarę pojawiania się informacji o nowych sterownikach. Jeśli kopia, którą czytasz ma więcej niż 3 miesiące, oznacza to, że jest albo nieaktualna, albo że byłem leniwy i jej nie zaktualizowałem.

Najnowsza wersja niniejszego dokumentu w wersji polskiej znajduje się w oficjalnym archiwum polskich wersji dokumentów Linux HOWTO ftp://ftp.ippt.gov.pl/pub/Linux/JTZ/, a także pod adresem http://www.amg.net.pl/Linux/JTZ/.

Ten dokument został przygotowany przy użyciu systemu SGML, specjalnie skonfigurowanego dla celów Projektu Linux Howto. Dostępne są różne formaty wyjściowe, do których zaliczyć można: postscript, dvi, ascii, html oraz wkrótce TeXinfo.

Zalecałbym oglądanie tego dokumentu w formacie html (w przeglądarce WWW) lub w formacie Postscript/dvi. Oba z nich zawierają aktywne powiązania, które nie występują w formacie ascii.

Jeśli chcesz otrzymać oficjalną kopię angielską z sunsite, oto URL:

Module-HOWTO

1.5 Moduły eksperymentalne (kod alpha) lub niepełna informacja.

Oto lista modułów określonych w skryptach konfiguracyjnych jako eksperymentalne, posiadających niewystarczające informacje, lub takich, których Kodów Źródłowych nie rozumiem, bo jestem zbyt ciemny. Wybór należy do ciebie.

1.6 Historia wersji.

Następna strona Poprzednia strona Spis treści