intro(1)

НАЗВАНИЕ

intro - введение в раздел команд и прикладных программ

ОПИСАНИЕ

Этот раздел справочного руководства (1) описывает, в алфавитном порядке, команды, включая пользовательские, программистские и административные.

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

   Синтаксис команд в справочном руководстве

Если не сказано иначе, команды, описанные в разделе "СИНТАКСИС" на странице справочного руководства, воспринимают опции и другие аргументы в соответствии со следующим синтаксисом:

имя [-опция ...] [аргумент_команды ...]

Эта нотация означает следующее:

   Стандарт синтаксиса команд: правила

Эти правила синтаксиса команд выполняются не всеми командами. Все процедуры командного интерпретатора должны использовать getopts(1) для разбора позиционных параметров и проверки допустимости опций. Она поддерживает Правила 3-10, представленные ниже. Выполнение других правил должна обеспечить сама команда.

1. Имена команд (имя выше) должны быть длиной от двух до девяти символов.
2. Имена команд должны содержать только строчные буквы и цифры.
3. Имена опций (опция выше) должны состоять из одного символа.
4. Все опции необходимо предварять дефисом ("-").
5. Опции без аргументов можно объединять после одного дефиса ("-").
6. Первый аргумент опции (optarg выше) после опции необходимо предварять пробелом.
7. Аргументы опций не могут быть необязательными.
8. Группы аргументов опции после нее должны либо разделяться запятыми, либо браться в кавычки и разделяться пробелами (например, -o xxx,z,yy или -o "xxx z yy").
9. Все опции в командной строке должны предшествовать операндам (аргумент_команды выше).
10. "--" можно использовать для указания того, что опции закончились.
11. Порядок опций относительно друг друга не должен иметь значения.
12. Порядок операндов (аргумент_команды выше) может влиять на их интерпретацию так, как определяет команда, в которой они задаются.
13. Дефис ("-"), перед которым и после которого идут пробельные символы, должен использоваться только для обозначения входного потока.

ДИАГНОСТИКА

По завершении работы каждая команда возвращает два байта статуса, первый задается системой и определяет причину завершения, и (в случае "нормального" завершения) второй задается программой (см. wait(2) и exit(2)). Первый байт имеет значение 0 при нормальном завершении; второй, по соглашению, имеет значение 0 при успешном завершении и ненулевое значение, показывающее проблемы вроде ошибочных параметров, неправильных или недоступных данных. Его часто называют по-разному: код выхода ("exit code"), cтатус выхода ("exit status") или код возврата ("return code") и описывают только в случае использования специальных договоренностей.

Copyright 1994 Novell, Inc.
Copyright 2000 В. Кравчук, OpenXS Initiative, перевод на русский язык