Next: , Previous: First Run, Up: Usage


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