Як читати використання Unix


16

Я здійснив пошук, але не можу знайти документацію про те, як працює використання Unix . Я щось знаю (в основному через проби та помилки), але, наприклад, як я це знаю

/usr/bin/ls  [-aAbcCdeEfFghHilLmnopqrRstuvVx1@] [file]...

означає, що ви можете включити кілька варіантів? Тобто,

ls -la

Де є документація щодо того, що таке синтаксис використання?


POSIX дійсно говорить про те, як слід форматувати дисплеї використання / довідки, але поза основними утилітами (GNU) мало хто дотримується цього.
Tim Post

@Tim, я нічого не використовую там.
шістдесят футів

Відповіді:


34

Це правда, що немає RFC або чогось іншого, але ви не надто далеко від бази, якщо дотримуєтесь цих вказівок:

  1. Що-небудь у кутових дужках < >означає, що потрібен варіант:
    <foo>

  2. Що-небудь у квадратних дужках [ ]означає, що варіант необов’язковий:
    [bar]

  3. Опції, розділені трубою, |означають, що це дійсні значення:
    --baz=one|two|three

  4. Параметри з однієї літери починаються з одного тире:
    -a

  5. Параметри з декількома літерами починаються з двох тире:
    --foo-bar

  6. (на основі №4) Один тире з кількома літерами зазвичай означає об'єднання цих окремих варіантів, а не багатолітерний варіант. Не всі команди підтримують такий тип об'єднання. Приклад:
    -aAbBcCте саме, що-a -A -b -B -c -C


1
man man or man 5 man
mpez0

1
Тут немає RFC, але є специфікації POSIX , до яких належать утилітні конвенції
Wildcard

6

Немає суворої структури чоловічих сторінок, але наступне охоплює більшість команд.

З КОРИСТУВАННЯ СТОРІН (5), Посібник з форматів файлів BSD , розділ "РУКОВИЙ СИНТАКС СТРАНИЦІ":

У синтаксисі сторінки вручну потрібний текст у звичайному шрифті. Все, що є шрифтом жирного шрифту - це прапор або підкоманда. Що-небудь підкреслене - це аргумент, визначений користувачем, наприклад, ім'я файлу.

Будь-який аргумент, оточений дужками, вважається необов’язковим. Наприклад, [ім'я файлу] вказуватиме необов'язковий аргумент імені файлу.

Прапори, аргументи або підкоманди, розділені вертикальним роздільником (|), взаємно виключають. Наприклад, якщо -a вмикає опцію і -b вимикає опцію, синтаксис для цієї команди може бути -a | -б.

У деяких випадках ви навіть можете бачити цілі групи аргументів, загорнуті дужками та розділені вертикальним роздільником. Це один із способів показати, що команда має більше ніж один дійсний синтаксис. На інших сторінках керівництва це виражається наявністю декількох рядків у конспекті, кожен з яких починається з імені команди. Розділений формат є більш поширеним (і читабельнішим), але не завжди можливий для команд з особливо складним синтаксисом.

Нарешті, найважливішою умовною умовою є використання еліпсису (...). Це вказує на те, що в цей момент можуть бути додані додаткові аргументи.


5

Лінії використання не відповідають нічого послідовного.

Вам слід використовувати man lsабо info lsдля отримання більш послідовного рівня інформації.

Використовуючи наш веб-сайт, ви визнаєте, що прочитали та зрозуміли наші Політику щодо файлів cookie та Політику конфіденційності.
Licensed under cc by-sa 3.0 with attribution required.