Канал CTRL
ver.2.4 build 0030, 2003-05-04
Описание
Управляющий канал может быть создан только в единственном экземпляре при помощи соответствующей секции <Channel> в конфигурационном файле.
В Unix-версии управляющий канал создает файл типа FIFO, через который программа получает команды. Этот файл открывается программой для чтения. После того, как другая программа откроет этот файл для записи, поместит в него команду и закроет файл, управляющий канал прочитает этот файл, закроет его, выполнит команду и вновь откроет файл для чтения. Такой алгоритм позволяет для записи команд в файл использовать echo или cat.
Параметры канала
- Ключ Fifo
- Win32[+] Unix[+]
- Ключ задает имя FIFO-файла (Unix) или конвейера - named pipe - (WinNT),
через который передаются команды для управляющего канала.
По умолчанию: dia.ctrl
Распознаваемые команды
- hide - убрать управляющую консоль (только Win32).
- exit - завершение работы.
- restart - перезапуск программы.
- chnlstat - вывести в журнал список и состояние каналов.
- devstat - вывести в журнал список и текущее значение устройств.
- chnldel ChnlName или chnldel ChnlNum - удаление канала, где ChnlName - имя канала, а ChnlNum - номер канала.
- add ProfileData - добавить кусок конфигурации (создание каналов и устройств). Текст после пробела и до конца команды (возможно многострочной) интерпретируется как "конфигурационный".
- profile - вывести в журнал конфигурацию программы.
- dumpon ChnlName или dumpon ChnlNum - включить протоколирование входящего потока для указанного канала (все полученные каналом байты будут помещаться в журнал программы).
- dumpoff ChnlName или dumpoff ChnlNum - выключить протоколирование входящего потока для указанного канала.
Примеры:
echo chnlstat >dia.ctrl
В журнал выводится список каналов и их состояние.
echo chnldel TCP#4 >dia.ctrl
Удаляется канал с именем 'TCP#4'.
echo "add (Type=DEMO;ID=0.0/9)" >dia.ctrl
Добавляется канал типа DEMO. В этом примере требуются кавычки, т.к. скобки и точка с запятой для командного интерпретатора имеют специальное значение.
cat prof >dia.ctrl
Если файл prof имеет такое содержание:add <Device> ID=0.1/9 RxChannel=(Type=DEMO) TxChannel=(Type=LOG;File=9.log) </Device>то будет создано устройство и два канала с соответствующими параметрами.