Product SiteDocumentation Site

Rozdział 7. Rozwiązywanie problemów i poszukiwanie informacji

7.1. Źródła dokumentacji
7.1.1. Podręcznik systemowy
7.1.2. Dokumenty info
7.1.3. Szczegółowe Dokumentacje
7.1.4. Witryny internetowe
7.1.5. Tutoriale (HOWTO)
7.2. Powszechne procedury
7.2.1. Konfiguracja Programu
7.2.2. Monitorowanie co robią Deamony
7.2.3. Pytanie o pomoc poprzez listy mailingowe
7.2.4. Raportowanie błędu jeśli jest zbyt trudny do rozwiązania
Dla administratora, najważniejszą umiejętnością jest umiejętność poradzenia sobie z każdą sytuacją, znaną lub nie. Rozdział ten prezentuje różnorakie metody, które - jak ufamy - pozwolą Ci wyłuskać istotę dowolnego problemu, który napotkasz, aby łatwo sobie z nim poradzić.

7.1. Źródła dokumentacji

Zanim uda Ci się zrozumieć co się tak naprawdę dzieje, kiedy pojawia się problem, musisz poznać teorię dotyczącą tego, jaką rolę odgrywa każdy program, który jest związany z problemem. Aby to zrobić, najlepszym odruchem jest poradzenie się dokumentacji; ale ponieważ dokumentacji jest wiele i mogą być porozrzucane we wszystkie strony, powinieneś wiedzieć o wszystkich miejscach, gdzie można je znaleźć.

7.1.1. Podręcznik systemowy

Manual pages, while relatively terse in style, contain a great deal of essential information. We will quickly go over the command for viewing them. Simply type man manual-page — the manual page usually goes by the same name as the command whose documentation is sought. For example, to learn about the possible options for the cp command, you would type the man cp command at the shell prompt (see sidebar POWTÓRKA Powłoka, interpreter wiersza poleceń).
Man pages not only document programs accessible from the command line, but also configuration files, system calls, C library functions, and so forth. Sometimes names can collide. For example, the shell's read command has the same name as the read system call. This is why manual pages are organized in numbered sections:
  1. polecenia, które można wykonać z wiersza poleceń;
  2. wywołania systemowe (funkcje zapewnione przez jądro);
  3. funkcje biblioteczne (zapewnione przez biblioteki systemowe);
  4. urządzenia (w systemach uniksopodobnych są to specjalne pliki, zazwyczaj umieszczone w katalogu /dev/);
  5. pliki ustawień (formaty i konwencje);
  6. gry;
  7. zbiory makr i standardów;
  8. polecenia do administrowania systemem;
  9. procedury jądra.
Jest możliwość określenia konkretnej części strony podręcznika, której szukasz: aby zobaczyć dokumentację dla wywołania systemowego read, musiałbyś wpisać man 2 read. Kiedy nie określimy wprost konkretnej strony podręcznika, zostanie wyświetlona pierwsza część, która zawiera stronę z szukaną nazwą. Dlatego też man shadow zwraca shadow(5) ponieważ nie ma stron dla shadow w częściach od 1 do 4.
Oczywiście, jeżeli nie znasz nazw poleceń, podręcznik systemowy na niewiele Ci się zda. Na tę okazję powstało polecenie apropos, które pomaga przeprowadzić wyszukiwanie w podręczniku, lub ściślej mówiąc - w skróconych opisach. Każda strona podręcznika zasadniczo zaczyna się jednolinijkowym podsumowaniem. apropos zwraca listę stron podręcznika, których skrócone opisy zawierają poszukiwane wyrażenie. Jeżeli dobrze się je dobierze, bez problemu znajdzie się szukane polecenie.

Przykład 7.1. Szukanie cp z użyciem apropos

$ apropos "copy file"
cp (1)               - copy files and directories
cpio (1)             - copy files to and from archives
gvfs-copy (1)        - Copy files
gvfs-move (1)        - Copy files
hcopy (1)            - copy files from or to an HFS volume
install (1)          - copy files and set attributes
ntfscp (8)           - copy file to an NTFS volume.
The man command is not the only means of consulting the manual pages, since khelpcenter and konqueror (by KDE) and yelp (under GNOME) programs also offer this possibility. There is also a web interface, provided by the man2html package, which allows you to view manual pages in a web browser. On a computer where this package is installed, use this URL:
Zazwyczaj potrzebny jest do tego serwer. Dlatego należy zainstalować ten pakiet na jednym z serwerów: wszyscy użytkownicy będą mogli z niego korzystać (w tym użytkownicy systemów innych niż Linux) a Ty unikniesz ustawiania serwera HTTP na każdej stacji roboczej osobno. Jeżeli Twój serwer jest także dostępny z poziomu innych sieci, możesz chieć ograniczyć dostęp do tej usługi tylko dla użytkowników sieci lokalnej.
Last but not least, you can view all manual pages available in Debian (even those that are not installed on your machine) on the manpages.debian.org service. It offers each manual page in multiple versions, one for each Debian release.

7.1.2. Dokumenty info

The GNU project has written manuals for most of its programs in the info format; this is why many manual pages refer to the corresponding info documentation. This format offers some advantages, but the default program to view these documents (it is called info) is also slightly more complex. You would be well advised to use pinfo instead (from the pinfo package).
The info documentation has a hierarchical structure, and if you invoke pinfo without parameters, it will display a list of the nodes available at the first level. Usually, nodes bear the name of the corresponding commands.
With pinfo navigating between these nodes is easy to achieve with the arrow keys. Alternatively, you could also use a graphical browser, which is a lot more user-friendly. Again, konqueror and yelp work; the info2www also provides a web interface.
Note that the info system is not suitable for translation, unlike the man page system. info documents are thus almost always in English. However, when you ask the pinfo program to display a non-existing info page, it will fall back on the man page by the same name (if it exists), which might be translated.

7.1.3. Szczegółowe Dokumentacje

Każdy pakiet zawiera swoją własną dokumentację. Nawet najmniej popularne programy, zasadniczo, posiadają plik README, który zawiera pewne ciekawe lub ważne informacje na jego temat. Taka dokumentacja jest instalowana w katalogu /usr/share/doc/pakiet/ (gdzie pakiet oznacza nazwę pakietu). Jeżeli dokumentacja jest wyjątkowo obszerna, może nie być zawarta w głównym pakiecie programu, ale przerzucona do osobnego pakietu, który zazwyczaj ma nazwę w formie pakiet-doc. W głównym pakiecie ogólnie umieszcza się informację zachęcającą do pobrania pakietu dokumentacji, żeby było ją łatwiej znaleźć.
Katalog /usr/share/doc/pakiet/ zawiera również pewne pliki przygotowane przez Debiana, które dopełniają dokumentację określając szczegółowe informacje o pakiecie czy listę usprawnień w porównaniu do tradycyjnej instalacji oprogramowania. Plik README.Debian wskazuje także na wszelkie dostosowania programu, aby spełniał Politykę Debiana. Plik changelog.Debian.gz pozwala użytkownikowi śledzić zmiany, jakie zachodziły w pakiecie z czasem: przydaje się to do zrozumienia co się zmieniło pomiędzy dwiema zainstalowanymi wersjami tego samego programu, gdy zachowują się odmiennie. Pozostaje także ostatni plik, który może znajdować się w tym katalogu - NEWS.Debian.gz - dokumentuje on znaczące zmiany w danym programie, które mogą okazać się ważne z punktu widzenia administratora.

7.1.4. Witryny internetowe

In most cases, free software programs have websites that are used to distribute it and to bring together the community of its developers and users. These sites are frequently loaded with relevant information in various forms: official documentation, FAQ (Frequently Asked Questions), mailing list archives, etc. Problems that you may encounter have often already been the subject of many questions; the FAQ or mailing list archives may have a solution for it. A good mastery of search engines will prove immensely valuable to find relevant pages quickly (by restricting the search to the Internet domain or sub-domain dedicated to the program). If the search returns too many pages or if the results do not match what you seek, you can add the keyword debian to limit results and target relevant information.
If you do not know the address for the software's website, there are various means of getting it. First, check if there is a Homepage field in the package's meta-information (apt show package). Alternately, the package description may contain a link to the program's official website. If no URL is indicated, look at /usr/share/doc/package/copyright. The Debian maintainer generally indicates in this file where they got the program's source code, and this is likely to be the website that you need to find. If at this stage your search is still unfruitful, consult a free software directory, such as FSF's Free Software Directory, or search directly with a search engine, such as Google, DuckDuckGo, Yahoo, etc.
Możesz także chcieć sprawdzić wiki Debiana — internetową witrynę społecznościową, gdzie wszyscy, nawet zwykli odwiedzający, mogą tworzyć sugestie, bezpośrednio z poziomu przeglądarki WWW. Takie zachowanie jest stosowane w równym stopniu przez deweloperów, którzy projektują i specyfikują swoje projekty, jak też przez użytkowników, ktorzy dzielą się swoją wiedzą poprzez wspólne pisanie dokumentów.

7.1.5. Tutoriale (HOWTO)

Howto (w tłum. dosł. "jak zrobić") to dokument, który opisuje, w konkretnych terminach i krok po kroku, "jak coś zrobić", aby osiągnąć predefiniowany cel. Cele zawarte w tym dokumencie mogą być różne, lecz najczęściej są natury technicznej. Na przykład, jak skonfigurować "maskaradę" IP (ang. IP Masquerading), jak skonfigurować oprogramowanie RAID, jak zainstalować serwer Samba itd. Te dokumenty często usiłują opisać wszelkie potencjalne problemy, które (prawdopodobnie) mogą się pojawić podczas implementacji danej technologii.
Wiele takich tutoriali jest zarządzanych poprzez Projekt Dokumentacji Linuksa (ang. Linux Documentation Project — LDP), którego witryna internetowa hostuje te wszystkie dokumenty:
Dokumenty te należy traktować trochę z dystansem. Często mają już po kilka lat; informacje w nich zawarte czasem są przestarzałe. Zjawisko to jest jeszcze częstsze w przypadku ich przekładów, ponieważ aktualizacje przekładów nie są wydawane ani systematycznie, ani natychmiastowo po publikacji nowej wersji oryginalnych dokumentów. To część uroków pracy w wolontariacie i bez ścisłych obostrzeń…