Получение дополнительной информации

Страницы руководства

Главная и основная документация любой системы UNIX - это страницы руководства. Руководство по Solaris хранится в подкаталогах каталога /usr/share/man/ и выдается постранично по команде man . Любители читать руководство в отдельном окне могут использовать xman для доступа к руководству.

Это руководство писали одновременно с написанием самой системы и системных программ, поэтому стиль изложения руководства вышел очень программистским. Если вы мыслите как программист, то читать это руководство будет очень легко. Поскольку с выходом новых версий Solaris руководство обновляется, стиль современного варианта уже достаточно адаптирован к нынешним задачам системного администрирования. Если вы мыслите как системный администратор, то страницы, объясняющие, как настроить программу или как ее запускать, вы найдете столь же полезными и понятными, сколь понятными покажутся описания системных функций программисту.

В Solaris, как и в любом другом UNIX, руководство освещает все мелочи, касающиеся системы. Единственное, на что руководство не дает ответа - это на вопрос "Как мне быть?" Если вы попали в затруднительную ситуацию и не понимаете, где искать информацию в руководстве, поможет следующее:

Руководство по Solaris

Руководство по Solaris разделено на несколько разделов. Номер раздела может быть цифрой, за которой, возможно, следует одна или несколько букв, в зависимости от названия раздела. Кроме того, раздел может называться одним словом, например, local, new или public. Каждая страница руководства представлена только в одном разделе. Однако в разных разделах могут быть таблицы с одним заголовком, например, passwd (1) и passwd (4), рассказывающие о связанных понятиях, файлах и программах. Так, страница passwd в разделе 1 рассказывает о программе passwd, а страница passwd в разделе 4 рассказывает о формате и назначении файла /etc/passwd. Разделы man делятся на подразделы, например, в разделе 1 есть подразделы 1m, 1b, 1c, 1f, 1s. Объяснение того, какие страницы содержатся в каждом из подразделов, дано в man intro. Страница intro есть в каждом разделе, от intro (1) до intro (9). Это - введение в справочный раздел. Если потребуется более подробное описание того, что содержится в нем, можно вызвать

man -s N intro

Поставьте вместо N номер того раздела, который вас заинтересовал (от 1 до 9). В таблице 8.1 перечислены основные разделы справочного руководства по Solaris. Многие системы UNIX содержат раздел 8, в котором находятся описания программ обслуживания системы. в Solaris все страницы, описывающие программы, собраны в разделе 1. Поэтому раздела 8 в руководстве по Solaris нет.

В страницах руководства номер раздела указывается в круглых скобках после команды, например halt(1M). Такая запись представляет как имя команды ( halt ), так и страницу руководства ( 1M ). При поиске подробной информации о чем-либо нужно обратиться к соответствующей странице документации. (Просмотреть страницу документации можно с помощью команды man (1) ).

Страница документации есть почти по каждой теме. Например, для просмотра страницы руководства по программе поиска подстрок grep нужно ввести следующую команду:

man grep

В ответ система выдаст следующую информацию:

Name
grep - search a file for a pattern 

Synopsis
/usr/bin/grep [-bchilnsvw] limited-regular-expression 
	[filename...]
/usr/xpg4/bin/grep [-E | -F] [-c | -l | -q] [-bhinsvwx] 
	-e pattern_list... [-f pattern_file]... [file...]
/usr/xpg4/bin/grep [-E | -F] [-c | -l | -q] [-bhinsvwx] 
	[-e pattern_list...] -f pattern_file... [file...]
/usr/xpg4/bin/grep [-E | -F] [-c | -l | -q] [-bhinsvwx] 
	pattern [file...] 

Description

The grep utility searches text files for a pattern and prints all
lines that contain that pattern. It uses a compact non-deterministic
algorithm.

Be careful using the characters $, *, [, ^, |, (, ), and \ in the
pattern_list because they are also meaningful to the shell. It is
safest to enclose the entire pattern_list in single quotes `... `.

If no files are specified, grep assumes standard input. Normally,
each line found is copied to standard output. The file name is
printed before each line found if there is more than one input file.

/usr/bin/grep

The /usr/bin/grep utility uses limited regular expressions like those
described on the regexp(5) manual page to match the patterns.

/usr/xpg4/bin/grep

The options -E and -F affect the way /usr/xpg4/bin/grep interprets
pattern_list. If -E is specified, /usr/xpg4/bin/grep interprets
pattern_list as a full

regular expression (see -E for description). If -F is specified, grep
interprets pattern_list as a fixed string. If neither are specified,
grep interprets pattern_list

as a basic regular expression as described on regex(5) manual page. 

Options

The following options are supported for both /usr/bin/grep and
/usr/xpg4/bin/grep:

-b

Precede each line by the block number on which it was found. This can
be useful in locating block numbers by context (first block is 0).

-c

Print only a count of the lines that contain the pattern.

-h

Prevents the name of the file containing the matching line from being
appended to that line. Used when searching multiple files.

-i

Large File Behavior

See largefile(5) for the description of the behavior of grep when
encountering files greater than or equal to 2 Gbyte ( 2 **31 bytes). 

Examples
Example 1: Finding all uses of a word
To find all uses of the word "Posix" (in any case) in the file text.mm, 
and write with line numbers:
example% /usr/bin/grep -i -n posix text.mm

Example 2: Finding all empty lines
To find all empty lines in the standard input:
example% /usr/bin/grep ^$
or
example% /usr/bin/grep -v .

Example 3: Finding lines containing strings
Both of the following commands print all lines containing strings abc or def or both:
example% /usr/xpg4/bin/grep -E `abc def'
example% /usr/xpg4/bin/grep -F `abc def'

Example 4: Finding lines with matching strings
Both of the following commands print all lines matching exactly abc or def:
example% /usr/xpg4/bin/grep -E `^abc$ ^def$'
example% /usr/xpg4/bin/grep -F -x `abc def' 

Environment Variables

See environ(5) for descriptions of the following environment
variables that affect the execution of grep: LC_COLLATE, LC_CTYPE,
LC_MESSAGES, and NLSPATH. 

Exit Status
The following exit values are returned: 
0
One or more matches were found.
1
No matches were found.
2
Syntax errors or inaccessible files (even if matches were found).

See Also
egrep(1) , fgrep(1) , sed(1) , sh(1) , attributes(5) , environ(5) , 
largefile(5) , regex(5) , regexp(5) , XPG4(5)

Notes
/usr/bin/grep

Lines are limited only by the size of the available virtual memory.
If there is a line with embedded nulls, grep will only match up to
the first null; if it matches, it will print the entire line.

/usr/xpg4/bin/grep

The results are unspecified if input files contain lines longer than
LINE_MAX bytes or contain binary data. LINE_MAX is defined in
/usr/include/limits.h.

Вывод man grep сильно сокращен, так как здесь нам требуется не детальный обзор grep, а общий вид какой-нибудь страницы руководства.

Первый блок информации, представленный в верхней строке, сообщает заголовок страницы руководства и номер раздела.

Обратите внимание на то, что в Solaris 9 поддерживается две версии grep - классическая ( /usr/bin/grep ) и расширенная ( /usr/xpg4/bin/grep ).

Ниже рассмотрены элементы страницы руководства, которые могут помочь вам не только разобраться в предмете, но и получить направление для нового поиска.

Части страницы руководства

В страницах руководства всегда есть несколько частей. Обычно присутствуют все стандартные части, перечисленные ниже, и в некоторых случаях - дополнительные, специфичные для данного описания.

NAME сообщает имя описываемой команды. В разделе NAME представлено еще и краткое описание программы.

SYNOPSIS описывает перечень доступных ключей командной строки при вызове команды и список возможных аргументов. Этого раздела может быть достаточно для того, чтобы освежить свою память и вспомнить ключ, который раньше помогал вам получить требуемый результат.

DESCRIPTION кратко описывает программу. Содержимое этого раздела зависит от темы, которая представлена на рассматриваемой странице руководства - к страницам о программах, файлах и базовых интерфейсах предъявляются совершенно разные требования.

OPTIONS (ключи) описывает ключи программы, их воздействие и, в зависимости от ключа, дополнительные аргументы, которые необходимо указать при использовании ключа.

SEE ALSO ("см. также") традиционно является последним разделом страницы, но зачастую - самым интересным.

Нелишне еще раз вспомнить, что для просмотра заголовков всех страниц, относящихся к определенной теме, нужно набрать man -k тема. В этом случае будет выполнен поиск по ключевому слову во всех заголовках страниц руководства. Для этой же цели можно воспользоваться командой apropos(1) - это легче запомнить, если не забыли, что означает "apropos"Apropos (фр.) -относительно, по поводу; что касается..

Для поиска какого-нибудь слова в странице руководства (когда вы ее уже смотрите с помощью man ) следует набрать "/" и затем само слово. После этого на экране можно будет увидеть первое употребление этого слова на странице. Последовательно вводя одиночный слэш ( / ), можно будет переходить к следующему вхождению этого слова.

Поиск в Интернете

Интернет велик, информации в нем много, и для понимания Solaris мы можем воспользоваться в Сети : списками часто задаваемых вопросов, документацией на сайте Sun Microsystems, архивами форумов (более или менее специализированных, официальных и неофициальных), почтовыми рассылками, телеконференциями сети Fidonet, поисковыми системами и знаниями гуру.

FAQ

В Сети есть разнообразные сборники часто задаваемых вопросов и ответов, связанных с администрированием Solaris. Надо начать поиск в них с http://sun.com (http://bigadmin.sun.com, http://docs.sun.com и т.п.). Довольно часто в FAQ собраны простые вопросы - много проще, чем тот, который вы хотите задать. Следует понимать, что в FAQ вряд ли есть ответы на вопросы о самой последней версии системы: списки вопросов и ответов составляются по материалам обсуждений в сети и проблем, обнаруженных компанией-производителем системы по прошествии некоторого времени после выпуска очередной версии ОС.

Форумы и документация на Sun.com

Компания Sun Microsystems предоставляет обширную базу данных для поиска требуемой информации на своем сайте. Вполне реально найти как оригинальную документацию на систему и руководства администратора, так и живое обсуждение проблем на форуме http://bigadmin.sun.com.

Форум Opennet

Русскоязычный сайт для администраторов Solaris расположен по адресу http://solaris.opennet.ru. Кроме статей, посвященных различным аспектам администрирования системы, здесь имеется форум, в котором можно встретить письма как новичков, так и опытных системных администраторов. Поиск по форуму выдает массу результатов; к сожалению, на момент написания книги автор не нашел, как разделить эти результаты на относящиеся исключительно к Solaris и касающиеся других систем UNIX: подобной функциональностью форум еще не снабдили.

Вот что рассказывает Максим Чирков, глава проекта Opennet, об истории http://solaris.opennet.ru: "Примерно в 1998 году Евгений Бобин создал сайт http://gene.chat.ru (сайт сохранился до сих пор), и я предложил ему предоставить поддомен http://solaris.opennet.ru и качественный хостинг. На http://solaris.opennet.ru планировалось создать переработанный вариант http://gene.chat.ru, вначале работа пошла активно, но потом развитие прекратилось, Евгению перестало хватать времени для поддержки сайта и в конце концов информация там устарела, половина ссылок и страниц не работали. В 2001 году на сервере сгорел жесткий диск и сайты пришлось переносить на другой сервер. Было решено не воссоздавать мертвый проект, и я просто создал страницу, на которой обобщил в одном месте ссылки на уже существующие разделы http://opennet.ru, посвященные Solaris, вынес отдельно блок новостей и статей. Вариант Евгения Бобина можно посмотреть в архиве: http://web.archive.org/web/19990901211748/http://solaris.opennet.ru/

В 2004 году появился еще один, автоматически компонуемый, вариант этой страницы - http://solaris.opennet.ru/mp/solaris/ ".

Конференции Fido

Конференции Fido доступны по протоколу nntp в формате сети Usenet, подробности можно выяснить по адресу http://www.fido7.ru, а специфическая телеконференция по Solaris доступна по адресу http://groups.google.com/groups?group=fido7.ru.unix.solaris.

Конференции сети Fidonet (сокращенно - Fido) возникли задолго до форумов в Интернете, и многие давно работающие с компьютерными системами специалисты предпочитают именно их для общения. Несмотря на то, что популярность Fido в России несравнима с популярностью сети Интернет, пренебрегать этим источником обмена опытом было бы неразумно.

Возможно, для участия в конференциях, для получения права писать письма в конференцию, вам придется зарегистрироваться и (или) установить новое программное обеспечение для чтения телеконференций в формате Usenet. Не волнуйтесь: затраты времени окупятся сторицей.

Поисковые машины

Для поиска информации в Сети есть прекрасные поисковые машины, такие как http://google.com, http://metacrawler.com, http://yahoo.com и многие другие. Как заставить эти творения ума человеческого искать нужные вам страницы?

Прежде всего, надо четко представить себе, какого рода информацию вы хотите найти.

Предположим, вы ищете смысл сообщения об ошибке, которое вы получили от системы. Тогда следует рассчитывать только на форумы. Довольно редко на сайтах можно встретить документацию по конкретным ошибкам, зато на форумах информации о том, что делать, если возникла ошибка, предостаточно. Можно искать письма коллег с таким же, как у вас, сообщением об ошибке на специализированных форумах (о них рассказано ниже), а можно в поисковой машине. Для этого в строке поиска следует привести сообщение об ошибке и запустить поиск.

Сообщение об ошибке следует очистить от всяких особенностей, специфических для вашей системы: от имени системы, возможно, от имени интерфейса, с которым связана ошибка. Например, сообщение

/dev/rdsk/c0d0t3s1: can't check file system

содержит указание на конкретный диск (c0d0t3s1); очевидно, что сообщение может встречаться в Сети в письмах о помощи на форумах, но имя диска у других страдальцев может оказаться иным. Поэтому, удалив имя диска, можно быстрее добраться до ссылки на форум с обсуждением произошедшей ошибки.

Кстати, перечень сообщений об ошибках в Solaris (с объяснением их возможных причин) можно найти в Сети, например, по адресам http://www.antioffline.com/solerrors.html и http://docs.sun.com/db/doc/802-2022. Помните, что достоверность ссылок проверена автором на момент написания книги; возможно, вы найдете эти списки в других местах.

Если ваша цель - отыскать документацию для выполнения конкретной задачи или получения информации о программе, следует как можно лучше представить себе, какими словами эта проблема описывается. Обычно в Сети нет толковых документов, которые найдутся по ключевой фразе "как прибиндить nameserver к интерфейсу".

Например, для поиска информации о том, как переключать язык ввода текста с клавиатуры в Solaris, следует догадаться, что ключевыми словами должны быть "keyboard layout" или "language layout", а не "keyboard switcher".

Для администрирования Solaris и любого другого варианта UNIX не обязательно знать язык С или С++ в совершенстве, можно не знать perl и язык командного процессора, но понимать английский текст надо обязательно. Если вы еще не знаете английского языка, выучите его.

Иногда можно найти в Сети обсуждение нужной вам темы по-русски или переведенную на русский язык документацию. В последнем случае качество переводов часто бывает настолько плохим, что перевод только запутывает и без того сложную проблему. Вероятность найти толковое, свежее, актуальное и русскоязычное решение проблемы с Solaris в Сети намного ниже, чем найти то же самое по-английски, хотя бы потому, что основная масса администраторов Solаris во всем мире говорит по-английски, а не по-русски.

Если не удается найти информацию на привычных вам поисковых серверах, попробуйте http://metacrawler.com - иногда мне удавалось с его помощью выудить жемчужину из навозной кучи.

Крик о помощи - письмо в форум или список рассылки

Если вы отчаялись найти решение самостоятельно, читая архивы форумов в Сети и документацию на всевозможных сайтах, и решили обратиться в форум или список рассылки за помощью, стоит помнить о некоторых правилах.

В письме о помощи следует привести всю информацию, которая имеется в вашем распоряжении. Если в письме не будет чего-то важного для решения проблемы, то либо ваш вопрос проигнорируют, либо вместо ответа вы получите массу сообщений, в которых вас попросят уточнить детали.

Поэтому в письмо о помощи надо включить, как минимум, следующее:

Постарайтесь также, чтобы ваше письмо было удобно читать: не пишите длинных вступлений и заключений общего характера ("Я работаю системным администратором в компании Газпром"), отправляйте письмо в формате plain text (ваши корреспонденты вряд ли любят читать письма в формате HTML, попробуйте сами с помощью программы mail, например), отправляйте письмо по тому адресу, с которого вправе ожидать помощь, и помните - письмо, возможно, придется писать по-английскиВ этой книге я много раз повторяю, что системное администрирование Solaris предполагает владение английским языком. В книге "UNIX. Практическое пособие администратора" я не делал этого достаточно часто и обнаружил, что многие читатели и слушатели курсов по UNIX ожидают, что я смогу им помочь работать с Solaris без знания языка. К сожалению, это не так, поэтому сейчас я честно пытаюсь показать, что английский будет серьезно необходим, даже если вы администрируете сеть в Хабаровске или Горно-Алтайске, вдали от англоязычных стран..

Практический поиск информации: реальный случай

Теперь возьмем относительно простую (казалось бы!) задачу и воспользуемся описанной методикой для ее решения. Часть этой книги набрана в пакете Open Office под Solaris 9. Для создания иллюстраций было необходимо делать "снимки" экрана, чтобы показать, как выглядят графические элементы CDE. Как сделать такие "снимки"?

Во-первых, я попробовал найти это в man . Попытки получить что-нибудь про print screen или screenshot с помощью man -k не удались.

Во-вторых, я попробовал найти эту информацию в Сети. Поскольку делать "снимки" графических окон - не самая частая необходимость администратора, поиск такой информации в FAQ и на форумах казался бесполезным. Для поиска в google требовалось придумать, как назвать эту функцию. Попробуем давно знакомый термин screenshot. Итак, ищем

Solaris 9 screenshot

Находятся ссылки на уже готовые "снимки"... смотрим дальше... вот! "to easily and quickly capture a screenshot" значится в описании страницы с http://docs.sun.com. Смотрим... "SDTImage Enhancements: The SDTImage screen snapshot feature now enables users to easily and quickly capture a screenshot image from the command line."

Похоже, это именно то, что мы ищем! Интересно, что найденный документ описывает расширения среды CDE, появившиеся в Solaris 8. А что такое SDTImage?

Попробуем man -k sdtimage:

bash-2.05# man -k sdtimage
sdtimage    sdtimage (1)  - Image viewer for CDE
bash-2.05#

О, да это средство для просмотра картинок... Запускаем

sdtimage

и оказывается, что в меню File имеется функция Snapshot... Задача решена! Удалось даже обойтись без помощи гуру...