Коротко о документации. Организация man-страниц
Невозможно изучать или пользоваться UNIX, не имея руководства по системе. Печатное руководство поставляется только с коммерческими системами, да и то не всегда. Кроме того, печатные руководства, как правило, куда-то исчезают именно в тот момент, когда они вам позарез нужны.
К счастью, любой диалект UNIX устанавливается вместе с электронной копией документации. Эта документация состоит из нескольких разделов (обычно их семь или восемь, иногда больше). Каждый раздел содержит статьи, каждая из которых посвящена одной команде, файлу, понятию или системному вызову UNIX. Любая статья имеет свой заголовок, в котором есть имя команды (файла, вызова и т.п.) и ее очень короткое описание, например:
cp - copy files and directories
Руководство вызывается командой man. Программа man форматирует страницу руководства и показывает ее на экране с помощью программы форматирования nroff и программы поэкранной выдачи текста more (или ее аналога - page, pg, less). На диске страницы руководства хранятся в неформатированном виде, так как это экономит место на диске. Страницы руководства хранятся в каталогах /usr/share/man/manN (N - номер раздела) или /usr/man/manN либо в каком-нибудь похожем подкаталоге /usr. Однажды отформатированные страницы man складывает в подкаталоги catN. Иногда они расположены там же, где и manN, иногда - нет. Программу man можно запустить с ключом -M, чтобы указать, в каком каталоге искать страницы руководства. Иногда при установке некоторых программ руководства по ним размещаются вне стандартного дерева каталогов man, тогда этот ключ может пригодиться.
Ссылки на man-страницы в литературе обычно включают номер раздела, в котором расположена статья, например, inetd.conf(5) означает статью о конфигурационном файле inetd.conf демона inetd в пятом разделе руководства. В этой книге мы тоже будем так ссылаться на статьи руководства по системе.
В таблице 2.3 перечислены разделы руководства, к которым обращается man. В BSD и System V руководства организованы немного по-разному.
| 1 | Команды | |
| 2 | Системные вызовы | |
| 3 | Библиотечные несистемные вызовы (например, из библиотеки Perl) | |
| 4 | Драйверы устройств, файлы и протоколы | |
| 5 | Разные документы | файлы конфигурации |
| 6 | Игры и демонстрационные программы | игры и демонстрационные программы |
| 7 | Драйверы устройств и сетевые протоколы (другие System V системы) | тексты, кодировки, выражения |
| 8 | утилиты системного администрирования | |
Некоторые коммерческие системы UNIX имеют дополнительные страницы руководства, описывающие специфические элементы данной системы. Они обозначаются, как правило, номером раздела с какой-нибудь буквой, например 1b.
Чтобы получить справку по любой команде UNIX или даже понятию, наберите
man то_что_Вас_интересует
Набирайте man -k тема для поиска подстроки тема в заголовках статей руководства.
Команда man -k предполагает, что существует индексированный список заголовков статей руководства. Этот список создается командой catman или каким-нибудь ее аналогом. Синоним man -k - это команда apropos. Для поиска информации о программах можно использовать еще и команду whatis.
Некоторые команды в UNIX - это встроенные команды командного процессора, а не отдельные программы. Например, alias и jobs. Поэтому, если вы не можете найти справку по таким командам, попробуйте почитать man по командному процессору, которым вы пользуетесь (скорее всего, sh или bash).
Кроме man, документация содержится в гипертекстовых файлах формата info и файлах HOWTO. Файлы info нужно читать программой info. Можно ее запустить без параметров и затем дать команду ? для знакомства с системой встроенных команд info. Она отличается от man своей "гипер-текстовостью" и позволяет переходить по ссылкам как внутри документа, так и между документами.
HOWTO - это набор документации, распространенный в Linux. В документах HOWTO разъясняются многие действия, которые могут понадобиться при администрировании. HOWTO распространяется в формате html или в виде текстовых файлов. В отличие от man, не существует жесткой структуры HOWTO. Это просто набор документов, и на одном сайте он может оказаться более полным, чем на другом.
В Интернете есть несколько сайтов, на которых размещен перевод на русский язык man и HOWTO в формате html. Перевод не всегда хорош, поэтому если вы не в состоянии понять, что написано в переводе документации, остается в сердцах ругать переводчика и обращаться к оригиналу.
