[Spis treści] [Sekcja 1 - Wstęp do OpenBSD] [Sekcja 3 - Jak zdobyć OpenBSD?]

2 - Inne źródła informacji o OpenBSD

Spis treści

• 2.1 - Strony internetowe
• 2.2 - Listy mailingowe
• 2.3 - Podręcznik systemowy man
• 2.4 - Zgłaszanie błędów

2.1 - Strony internetowe dla zainteresowanych

Oficjalna strona Projektu OpenBSD dostępna jest pod adresem: http://www.OpenBSD.org.

Można tutaj znaleźć wiele cennych informacji dotyczących Projektu OpenBSD.

Witryna OpenBSD Journal jest serwisem w którym można znaleźć informacje i opinie ze świata OpenBSD.

Witryna OpenBSDsupport.org zawiera "zarządzaną przez użytkowników" dokumentację o różnej zawartości, często obejmującej tematy spoza tego FAQ lub innej oficjalnej dokumentacji.

Wielu użytkowników OpenBSD posiada własne strony internetowe, na których umieszcza różne użyteczne informacje. Jak ze wszystkim w Internecie dobra wyszukiwarka czyni życie łatwiejszym, podobnie jak odrobina sceptycyzmu. Po prostu nigdy nie przepisuj ślepo poleceń (ani nie uruchamiaj żadnych programów) wprost na swoim komputerze jeśli ich nie rozumiesz!

2.2 - Listy mailingowe

Projekt OpenBSD utrzymuje kilka popularnych list mailingowych, które użytkownicy powinni subskrybować i regularnie śledzić. Aby zapisać się na listę mailingową, wystarczy wysłać wiadomość e-mail na adres: majordomo@openbsd.org. Jest to usługa pozwalająca na automatyczne zapisanie się na listę mailingową. Treść wiadomości powinna zawierać pojedynczą linię z komendą zapisującą użytkownika na wybraną listę. Na przykład:

subscribe announce

Automat, wysyłając wiadomość do użytkownika, poprosi o potwierdzenie chęci subskrybowania listy. Celem takiego działania jest zabezpieczenie użytkownika przed złośliwym żartem, który spowoduje zasypanie skrzynki niechcianą pocztą. Istnieje kilka możliwości potwierdzenia: skorzystanie z linku do interfejsu webowego serwera list, wysłanie odpowiedzi lub maila na adres majordomo@openbsd.org. Bez względu na wybór metody, proszę zauważyć, że łączy je unikatowy numer identyfikacyjny, jak np. A56D-70D4-52C3. Dodatkowym warunkiem jest odpowiedź przed upływem określonego czasu, aby upewnić się, że ty jesteś prawdziwoą osobą, która zarządała subskrybcji listy (to jest prawdziwy "opt-in").

Po potwierdzeniu chęci przystąpienia do listy, zostaniesz natychmiast do niej dodany, a automat powiadomi Cię o tym.

Aby wypisać się z listy, musisz wysłać wiadomość e-mail na adres majordomo@openbsd.org. Może ona wyglądać tak:

unsubscribe announce

Jeżeli masz jakieś trudności z obsługą systemu list mailingowych, przeczytaj najpierw wszystkie instrukcje. Można je otrzymać wysyłając e-mail na adres majordomo@openbsd.org o treści "help".

Istnieje możliwość zarządzania subskrypcją list poprzez bardzo przyjazny interfejs www na stronie http://lists.openbsd.org Najbardziej popularnymi listami mailingowymi są:

• announce - Ważne ogłoszenia. Jest to bardzo "cicha" lista.
• security-announce - Ogłoszenia dotyczące bezpieczeństwa. Jest to także "cicha" lista.
• misc - Ogólne pytania i odpowiedzi użytkowników. Jest to najbardziej aktywna lista i to właśnie na nią powinno się kierować większość pytań.
• bugs - Błędy otrzymane przez sendbug(1) oraz dyskusja na ich temat.
• source-changes - Zautomatyzowana grupa dotycząca zmian w drzewie źródeł. Kiedy pojawia się nowa wersja źródeł, CVS automatycznie wysyła informacje na listę o zmianach jakie zaszły w plikach źródłowych.
• ports - Dyskusje o drzewie portów.
• ports-changes - Zautomatyzowana lista zmian w drzewie portów.
• advocacy - Dyskusje na temat promowania OpenBSD, oraz pytania, które nie nadają się na misc.

Przed wysłaniem pytania na misc lub na jakąkolwiek inną listę, sprawdź archiwum, gdyż większość pospolitych pytań była już zadawana wielokrotnie. Dla Ciebie może to być pierwsze spotkanie z tym problemem, ale inni użytkownicy list mailingowych mogli już kilka razy widzieć to pytanie i nie zainteresują się widząc je ponownie. Jeśli pytanie odnosi się do sprzętu, zawsze do pytania dołącz wynik polecenia dmesg!

Archiwa oraz wskazówki dotyczące samych list dyskusyjnych można znaleźć pod adresem: http://www.openbsd.org/mail.html.

Nieoficjalną lista dyskusyjna, która może zainteresować nowych użytkowników OpenBSD i w ogóle systemu UNIX jest: OpenBSD Newbies.

2.3 - Podręcznik systemowy man

OpenBSD dostarczany jest z rozległą dokumentacją w formie stron podręcznika man, powiązanych z poszczególnymi aplikacjami. Wiele wysiłku wkładane jest w utrzymanie ich w ciągle aktualnym stanie. We wszystkich przypadkach strony man są podstawowym źródłem informacji na temat OpenBSD.

Aby móc korzystać z podręcznika systemowego, a także innej dokumentacji, należy włączyć do systemu man42.tgz oraz misc42.tgz z pakietów instalacyjnych

A oto lista niektórych stron podręcznika systemowego pomocnych nowym użytkownikom:

Dla początkujących

• afterboot(8) - czynności do wykonania po pierwszym uruchomieniu.
• help(1) - pomoc dla nowych użytkowników i administratorów.
• hier(7) - układ katalogów głównego systemu plików.
• man(1) - informacje o podręczniku systemowym.
• intro(1) - wprowadzenie do podstawowych komend, warto także zobaczyć wprowadzenia dotyczące innych części podręcznika: intro(2), intro(3), intro(4) (UWAGA: intro(4) jest zależne od danej platformy), intro(5), intro(6), intro(7), intro(8), i intro(9).
• adduser(8) - polecenie dodające nowych użytkowników.
• vipw(8) - edycja głównago pliku haseł.
• disklabel(8) - wyświetlanie i modyfikacja struktury partycji na dyskach.
• reboot, halt(8) - wyłączanie i restartowanie systemu.
• shutdown(8) - zamknięcie systemu o zadanej godzinie.
• dmesg(8) - wyświetlenie informacji z uruchomienia jądra systemu.
• sudo(8) - nie logujesz się jako root, ale uruchamiasz polecenia z jego uprawnieniami.
• mg(1) - edytor tekstu kompatybilny z Emacsem.

• boot(8) - procedury rozruchowe systemu.
• boot_config(8) - opis zmiany konfiguracji jądra podczas startu.
• gcc_local(1) - specyficzne dla OpenBSD zmiany w gcc(1).
• ifconfig(8) - konfiguracja interfejsów sieciowych.
• login.conf(5) - opis pliku konfiguracyjnego procesu logowania.
• netstat(1) - informacje na temat stanu sieci.
• release(8) - budowanie systemu OpenBSD.
• sendbug(1) - wysyła raport o błędach do centralnego systemu zgłaszania błędów.
• style(9) - informacje na temat stylu kodowania jądra OpenBSD.
• sysctl(8) - sprawdzenie/modyfikacja zmiennych kernela.

Możesz znaleźć strony podręcznika OpenBSD na stronie http://www.openbsd.org/cgi-bin/man.cgi, a także w swoim systemie, jeśli zainstalowałeś man42.tgz.

Generalnie, znając nazwę polecenia lub strony podręcznika, można przeczytać ją, używając polecenia "man polecenie". Na przykład: "man vi", aby przeczytać o edytorze vi. Nie znając nazwy polecenia lub polecenie "man polecenie" nie jest w stanie znaleźć żądanej strony podręcznika, można spróbować odnaleźć stronę zawierającą interesujące informacje, używając "apropos slowo_kluczowe" lub "man -k slowo_kluczowe", gdzie "slowo_kluczowe" jest słowem, które może wystąpić w tytule strony podręcznika. Na przykład:

# apropos "time zone" tzfile (5) - time zone information zdump (8) - time zone dumper zic (8) - time zone compiler

Numery w nawiasach wskazują sekcję stron podręcznika, w której to słowo zostało znalezione. Czasami dane słowo występuje w różnych częściach tego samego dokumentu. Załóżmy, że użytkownik chce wiedzieć, jak wygląda plik konfiguracyjny demona cron. Znając numer sekcji strony podręcznika wystarczy wykonać polecenie "man n nazwa_polecenia", gdzie n jest właśnie numerem sekcji podręcznika.

# man -k cron cron (8) - clock daemon crontab (1) - maintain crontab files for individual users crontab (5) - tables for driving cron # man 5 crontab

Oprócz podręcznika systemowego man, dostępna jest również dodatkowa dokumentacja (dołączona w pakiecie instalacyjnym misc42.tgz). Mieści się ona w katalogu /usr/share/doc. Jeśli zainstalowany został pakiet textXX.tgz, można sformatować każdy zestaw dokumentów poleceniem "make", wydanym w odpowiednim podkatalogu. Podkatalog psd zawiera rozdział "Dokumentacja uzupełniająca dla programisty" (ang. "Programmer's Supplementary Documents"). Podkatalog smm zawiera "Podręcznik administratora systemu" (ang. "System Manager's Manual"). Podkatalog usd to "Dokumentacja uzupełniająca dla użytkownika" (ang. "User's Supplementary Documents"). Można wywołać make w nadrzędnym katalogu lub wybrać tylko poszczególne podkatalogi i tam wykonać polecenie 'make'.

Niektóre podkatalogi są puste. Domyślnie, 'make' utworzy dokumenty w formacie PostScript, czyli gotowym do wydruku. Wersja w formacie PostScript może być całkiem duża - zakłada się około 250-300% wzrost na każdej części. Nie mając dostępu do drukarki lub wyświetlacza dokumentów PostScript, można sformatować pliki wyjściowe tak, aby możliwe było przeczytanie ich wprost na terminalu. W każdym podkatalogu można zbudować dokumenty wprost w formacie ASCII (nazywane 'paper.txt') przy pomocy make(1). Na przykład:

# cd /usr/share/doc/usd/04.csh # make paper.txt # more paper.txt

Proszę zauważyć, że do zbudowania interesującej dokumentacji mogą być niezbędne prawa superużytkownika, a także konieczne może być wywołanie polecenia make clean, które usunie poprzednio wygenerowane dokumenty. Dodatkowe informacje na ten temat znajdują się w pliku /usr/share/doc/README.

Strony Uniksowego podręcznika są bardziej aktualne i godne zaufania, niż dokumenty złożone. Jednak dokumenty złożone szczegółowiej wyjaśniają działanie skomplikowanych aplikacji, aniżeli strony podręcznika.

Dla wielu osób, posiadanie kopii podręcznika na twardym dysku może być bardzo przydatne. Tutaj znajdują się wskazówki dotyczące tworzenia drukowalnych kopii podręcznika.

Jak mogę wyświetlić plik źródłowy strony podręcznika? (tj. taki którego nazwa kończy się numerem, np. tcpdump.8)?

Można go znaleźć w drzewie src. Strony podręcznika są niesformatowane i wielokrotnie uaktualniane poprzez CVS. Aby przejrzeć tą stronę użyj:

# nroff -Tascii -mandoc <file> | more

Jak mogę otrzymać przejrzystą stronę podręcznika, bez znaków kontrolnych lub formatowania?

Przydatne jest otrzymanie prostej strony podręcznika bez niedrukowalnych znaków.
Można to zrobić w ten sposób:

#man <command> | col -b

Jak otrzymać gotową do druku, PostSricpt'ową wersję strony podręcznika?

Zauważ, że <file> musi być plikiem źródłowym podręcznika (prawdopodobnie plik, który kończy się liczbą; np. tcmdump.8). Wersja PostScript'owa wygląda całkiem nieźle. Może być drukowana lub przeglądana na ekranie programem typu gv (GhostView). Można go znaleźć w kolekcji pakietów. Polecenie nroff(1), pomoże uzyskać PostScriptową wersję podręcznika OpenBSD:

# nroff -Tps -mandoc -Tps <file> > outfile.ps

Jak wygenerować skompresowane strony podręcznika systemowego?

Dla ludzi, którzy budują system ze źródeł, dostępnych jest wiele opcji kontrolujących sposób w jaki mają być przygotowane strony man. Można je umieścić w pliku /etc/mk.conf (może być konieczne utworzenie tego pliku samodzielnie) skąd zostaną pobrane w trakcie kompilacji systemu. Jedną, szczególnie użyteczną, opcją jest wygenerowanie skompresowanych stron podręcznika, dzięki czemu można zaoszczędzić trochę miejsca na dysku. Wystarczy dodać następującą linijkę do pliku /etc/mk.conf:

MANZ=yes

Co to są pliki info?

Część dokumentacji dla OpenBSD dostarczana jest w formie plików info, które znajdują się w katalogu /usr/share/info. Jest alternatywny format dokumentacji dostarczany przez GNU. Wiele z tych plików zawiera aktualniejsze informacje od tych zawartych w podręczniku systemowym GNU, a można je przeglądać przy pomocy polecenia info(1). Na przykład, by obejrzeć informacje o kompilatorze gcc(1) napisz:

# info gcc

Jak mogę wyświetlić strony man w kolorze na XTermie?

Domyślny plik konfiguracyjny dla xterm(1) nie wyświetla stron podręcznika w kolorze. Aby zmusić xterm do wyświetlania stron man w kolorze, wystarczy skopiować plik /etc/X11/app-defaults/XTerm-color do swojego domowego katalogu i zmienić jego nazwę na ".Xdefaults". Należy uważać by nie nadpisać żadnych aktualnych ustawień w pliku ".Xdefaults". Plik ten zawiera w sobie wszystkie opcje niezbędne do włączenia kolorowania stron man w XTermie. Trzy poniższe linie powinny zostać odkomentowane:

!*VT100*colorULMode: on !*VT100*underLine: off !*VT100*colorBDMode: on

*VT100*colorUL: yellow *VT100*colorBD: white

Jak samodzielnie tworzyć strony podręcznika man?

Dobry przewodnik dla ludzi chcących samodzielnie przygotować stronę man znajduje się w mdoc.samples(7), a szczegółowe informacje w mdoc(7)

2.4 - Zgłaszanie błędów

Wreszcie: przed złożeniem jakiegokolwiek raportu o błędach, przeczytaj najpierw http://www.openbsd.org/report.html.

Zgłaszanie błędów jest jednym z najważniejszych obowiązków użytkowników. Aby rozpoznać większość poważnych dziur, potrzebne są szczegółowe informacje na ich temat. Developerzy często otrzymują zgłoszenia o błędach podobne to tego:

Mamy nadzieję, że większość ludzi rozumie dlaczego tego typu zgłoszenia są po prostu usuwane. Wszystkie raporty o błędach powinny zawierać szczegółowe informacje. Jeżeli JoeUser naprawdę oczekuje, że ktoś pomoże mu rozwiązać jego problem, to powinien dostarczyć więcej informacji. Na przykład takich:

report.html. Zasadniczo, szczegółowe informacje o sprzęcie są konieczne, jeśli podejżewasz, że błąd może być w jakikolwiek sposób związany z daną konifiguracją sprzętową. Narzędzie dmesg(8) powinno być pod tym względem wystarczające. Następnie, konieczny jest szczegółowy opis problemu. Zwróć uwagę, że dmesg opisuje sprzęt, tekst wyjaśnia dlaczego Smart User myślał, że system nie jest zepsuty (działało dobrze na 3.2), jak doszło do zawieszenia się systemu (uruchamiając X), a także wyniki poleceń debugger'a: "ps" i "trace". W tym przypadku, Smart User dostarczył wynik przechwycony na konsoli szeregowej, jeśli będzie trzeba pomóż sobie kartką i ołówkiem, aby zapisać komunikaty o problemie. (Powyższy mail to prawdziwy list, a informacje z powyższego raportu pomogły rozwiązać problem, który dotknął systemy Sun4c).

Jeżeli Bystry Użytkownik ma działający system OpenBSD, z którego chciałby wysłać raport o błędzie, powinien skorzystać z narzędzia sendbug(1), które wyśle informacje o jego błędzie do systemu śledzenia problemów GNATS. Jeśli nie można użyć sendbug(1), ponieważ system nie chce wystartować, zgłoś problem w jakikolwiek sposób, jednak wskazane jest używać sendbug kiedy to tylko możliwe. Oczywiście, nadal do raportu, musisz włączyć szczegółowe informacje o tym, co się stało, dokładną konfigurację systemu, oraz to kiedy dany problem występuje. Polecenie sendbug(1) wymaga, aby Twój system był w stanie wysłać maila do Internetu. Zwróć uwagę, że serwer pocztowy korzysta z spamd(8) opartego na "szarych listach", zatem może upłynąć pół godziny zanim serwer pocztowy zaakceptuje twoje zgłoszenie błędu. Bądź więc cierpliwy.

Po wysłaniu raportu o błędzie poprzez sendbug(1), zostaniesz zawiadomiony przez e-mail o ważności błędu. Developerzy mogą się z Tobą skontaktować, prosząc o dodatkowe informacje lub dostarczając łatki do przetestowania. Można również śledzić archiwa listy mailingowej bugs@openbsd.org, lub obserwować status raportu o błędzie w bazie danych on-line, pod adresem list mailingowych, lub poprzez bazę danych błędów na stronie Bug Tracking System.

Zdobywanie użytecznych informacji dla developerów

Poniżej jest kilka użytecznych porad:

Utracony "Panic message"?
W niektórych okolicznościach, możesz stracić pierwszy komunikat "panic", zawierający przyczynę problemu. Jest to bardzo ważna wiadomość, możesz chcieć ją również dołączyć do raportu. Możesz ją odzyskać używając polecenia "show panic" w ddb>, podobnie jak w przypadku poniżej:

ddb> show panic 0: kernel: page fault trap, code=0 ddb>

W tym przypadku interesuje nas "Kernel: page fault trap, code=0".

Specjalna nota dla użytkowników SMP
Powinieneś pobrać "ślad" dla każdego procesora i załączyć do raportu:

ddb{0}> trace pool_get(d05e7c20,0,dab19ef8,d0169414,80) at pool_get+0x226 fxp_add_rfabuf(d0a62000,d3c12b00,dab19f10,dab19f10) at fxp_add_rfabuf+0xa5 fxp_intr(d0a62000) at fxp_intr+0x1e7 Xintr_ioapic0() at Xintr_ioapic0+0x6d --- interrupt --- idle_loop+0x21: ddb{0}> machine ddb 1 Stopped at Debugger+0x4: leave ddb{1}> trace Debugger(d0319e28,d05ff5a0,dab1bee8,d031cc6e,d0a61800) at Debugger+0x4 i386_ipi_db(d0a61800,d05ff5a0,dab1bef8,d01eb997) at i386_ipi_db+0xb i386_ipi_handler(b0,d05f0058,dab10010,d01d0010,dab10010) at i386_ipi_handler+0x 4a Xintripi() at Xintripi+0x47 --- interrupt --- i386_softintlock(0,58,dab10010,dab10010,d01e0010) at i386_softintlock+0x37 Xintrltimer() at Xintrltimer+0x47 --- interrupt --- idle_loop+0x21: ddb{1}>

Powtórz "machine ddb x" poprzedzone "trace" dla każdego procesora w twojej maszynie.

[Spis treści] [Sekcja 1 - Wstęp do OpenBSD] [Sekcja 3 - Jak zdobyć OpenBSD?]

---

www@openbsd.org
$OpenBSD: faq2.html,v 1.35 2007/11/23 19:30:03 tobias Exp $

---