3.2 Интерфейс командной строки.
Синтаксис запуска.
chestnut-dialer [основные опции] [команда [опции]
[имя_атрибута=значение | unset имя_атрибута]...]
Описание.
Без аргументов Chestnut Dialer запускается с интерфейсом пользователя,
указанным в файле ~/.chestnut-dialer/preferred-ui-X, где
~ – домашний каталог пользователя, X – X11 или console.
При отсутсвии этого файла программа пытается выбирать подходящий интерфейс
автоматически на основании текущего окружения (X11 или console).
Все команды, за исключением --dial, подавляют использование
интерфейса пользователя, или используют интерфейс none
.
После отработки команды программа завершается. Исключением является
команда --dial: c интерфейсом none
программа
продолжает свою работу пака сущестует соединение, с другими
интерфейсами программа продолжает свою работу пака пользователь не
остановит ее. Разорвать соединение, установленное с интерфейсом
none
, можно нажав на клавиатуре <Ctrl+C>.
Код завершения.
- 0
- Успешное завершение. Chestnut Dialer остановлен по просьбе пользователя.
- 1
- Ошибка при использовании командной строки (например, неправильная опция
или отсутствие аргумента).
- 2
- Переданы неправильные аргументы (например, неправильный идентификатор
учетной записи, неправильный интерфейс пользователя).
- 3
- Неизвестная ошибка.
- 4
- Нет гудка.
- 5
- Линия занята.
- 6
- Нет несущей.
- 7
- Неудача аутентификации.
- 8
- Внутренняя ошибка ПО.
- 9
- Ошибка операционной системы.
Основные опции.
- -i имя_интерфейса
- --ui=имя_интерфейса
- Использовать указанный интерфейс пользователя.
Чтобы получить список всех возможных интерфейсов, воспользуйтесь
командой --list-ui.
- --ui-param=имя:значение
- Передает параметр интерфейсу. Разрешено передавать несколько
таких опций одновременно.
Чтобы получить список допустимых параметров, воспользуйтесь
командой --list-ui-params.
- --debug=целое
- Устанавливает уровень вывода отладочной информации, которая
выводится на стандартный поток ошибок.
0 – выводить только фатальные ошибки. Увеличение значения
приводит к увеличению числа выводимых сообщений.
Значение по умолчанию 2.
- --no-headers
- Не выводить строку заголовка в списках.
- --daemon
- Отсоединится от контролирующего терминала.
Команды.
- -d
- --dial
- Дозвон.
- -s
- --disconnect
- Отключится.
- -e
- --erase
- Удалить учетную запись.
- -c
- --create
- Создать новую учетную запись и вывести ее идентификатор.
- -m
- --modify
- Изменить существующую учетную запись.
- -p
- --print
- Вывести учетную запись.
- --print-full
- Вывести учетную запись со всеми значениями по умолчанию.
- -l
- --list-accounts
- Вывести список учетных записей. Выводит таблицу, в первой колонке
которой указан идентификатор, а во второй – имя учетной записи.
- --list-ui
- Вывести список установленных интерфейсов пользователя.
Выводит таблицу, в первой колонке которой указано имя интерфейса,
во второй тип интерфейса, в третьей – автор, а в четвертой описание.
- --list-ui-params
- Вывести список параметров, обрабатываемых интерфейсом пользователя.
Выводит таблицу, в первой колонке которой указано имя параметра, во
второй – его тип а в третьей – описание.
- --list-acc-attrs
- Вывести список всех возможных атрибутов учетной записи.
Выводит таблицу, в первой колонке которой указано имя атрибута,
а во второй – его тип.
- -q
- --quit
- Отключится и завершить существующий процесс
(если нет такого процесса, Chestnut Dialer сообщит об этом).
- -?
- --help
- Вывести краткую справку об использовании.
- --version
- Вывести имя программы и версию.
Опции.
- -a целое
- --account=целое
- Выбирает учетную запись по идентификатору.
- -n имя
- --account-name=имя
- Выбирает учетную запись по имени. Будет выбрана первая найденная
учетная запись, чье имя содержит значение, переданное в качестве
аргумента. Поиск проходит без учета регистра.
Атрибуты.
Описание всех атрибутов учетной записи смотрите в
Атрибуты учетной записи.
Ключевое слово unset
используется для сброса атрибута
учетной записи, это означает что в качестве значения этого
атрибута будет использовано значение по умолчанию.
Значения атрибутов с типом boolean
записываются как
‘on’ или ‘off’ или ‘yes’ или ‘no’ или
‘1’ или ‘0’. Значения с типом list
записываются
в виде списка элементов разделенных запятой.
Примеры.
Создание учетной записи:
chestnut-dialer -c name="CoolOnline" phone_numbers=555,666 \
user=ivan passwd=secret
Дозвон по учетной записи с именем CoolOnline:
chestnut-dialer -i none -dn CoolOnline
Дозвон по модифицированной учетной записи с идентификатором 1
(новые значения атрибутов не сохраняются, а действуют только
в пределах одного сеанса связи):
chestnut-dialer -i none -da 1 phone_numbers=777 redial_attempts=5
Изменение учетной записи с именем CoolOnline:
chestnut-dialer -mn CoolOnline phone_numbers=777 redial_attempts=5
Вывод учетной записи с идентификатором 1:
chestnut-dialer -pa 1
Удаление учетной записи с идентификатором 1:
chestnut-dialer -ea 1