2.3.1. Обращение к справочнику

При запуске команды who мы получаем определенную информацию о том, что эта команда! делает. Для более подробного изучения вопроса о назначении команды можно обратиться к электронному справочнику. Каждая из систем Unix поступает с документацией обо всем командах. Иногда система Unix поступает с печатным справочником, где для каждой команды представлена документация в одну или две страницы. Чаще всего теперь справочник расположен на диске. Команда для чтения информации из справочника - man . Для получения описания команды who следует выполнить команду:

$ man who
who(1)	who(1)
NAME
who - Identifies users currently logged in
SYNOPSIS
who [-a] |[-AbdhHlmMpqrstTu] [file]
who am i
who am I
whoami

The who command displays information about users and processes on the local system.

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

who: XPG4.XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated

tags.

OPTIONS

-a Specifies all options; processes /var/adm/utmp or the named file

with all options on. Equivalent to using the -b, -d, -I, -p, -r,

-t, -T, and -u options.

more (10%)

Все страницы руководства, которые часто называют manpages, имеют одинаковый базо­вый формат. Заголовок служит для представления имени команды и обозначает раздел справочника, в котором находится данный документ. В данном примере это изображается как who {1), что обозначает команду who и раздел 1. В разделе 1 содержится документация обо всех пользовательских командах. Обратитесь к справочнику на вашей системе и по­смотрите, что находится в других разделах справочника.

Секция name на странице документации содержит имя команды и однострочное представ­ление назначения команды.

Секция synopsis представляет, как можно использовать команду. Здесь показано, что сле­дует набирать при вызове команды, список аргументов и опций, которые возможно использовать при вызове команды. Каждая опция обычно начинается со знака дефиса, за которым следуют один или более символов. С помощью опций можно указывать вари­ант исполнения команды.

В тексте страницы справочника можно использовать квадратные скобки ([-а]), чтобы по­казать, что данный элемент не является обязательным для команды, но может быть при не­обходимости включен в текст командной строки при вызове команды. В примере страни­цы документации для команды who показано, что вы можете обращаться к команде просто набором ее имени who, или можете набрать: who -а (произносится who минус а), или вы мо­жете набрать who с последующим набором знака "минус" и некоторой комбинации симво­лов, затем указать имя файла, которое вам понравится.

На странице документации для команды who представлены еще три формы обращения к команде:

who am i

who am I

whoami

Вы можете прочитать о назначении этих альтернативных форм вызова команды в спра­вочнике или попытаться поработать с ними.

В секции description находится описание того, что делает команда. Эти описания весьма сильно варьируются от команды к команде, от одной версии Unix к другой. Некоторые тексты описаний краткие, но точные. В некоторых описаниях представлено большее чис­ло деталей и несколько примеров. В любом случае описания представляют все свойства команды и содержат надлежащие авторитетные ссылки.

В секции options представлен список допустимых опций и описание, для чего предна­значена каждая опция. В давние времена каждая команда в Unix была простой. Каждая вы­полняла некоторое действие и имела одну или две опции. С годами многие команды были усовершенствованы за счет введения в их состав новых возможностей, каждая из которых

может быть активизирована с помощью опций при обращении к команде с уровня команд­ной строки. Некоторые команды, подобные рассматриваемой версии команды who, имеют весьма много опций.

В секции see also представлен список тем в справочнике, связанных с командой. В неко­торых страницах справочника есть еще секция bugs.