Интерфейс командной строки ПО tera-router

Параметры запуска ПО tera-router могут быть заданы: 

Для получения краткой информации по доступным параметрам командной строки следует выполнить:

tera-router --help
BASH

Для запуска ПО tera-router из командной строки используется следующий формат вызова:

tera-router [ключ] [значение]
BASH

Список доступных параметров приведен в таблице.

Параметры командной строки ПО tera-router

КлючОписание

-d

Включение отладочного уровня журналирования событий.

Альтернативный метод: задать переменную окружения TDSK_DEBUG.

Не требует указания значения

-a

Клиентская часть: включение запроса схем маршрутизации с сервера.

Не требует указания значения

-l

Включение определения типа канала по пакету состояния канала.

Ключ применим только для открытого трафика.

Формат значения: [type_offset]:[id_offset]

Пример значения: 20:21

-b

Прослушиваемый интерфейс. Можно указать несколько.

По умолчанию используется 0.0.0.0. Значение рекомендуется переопределить, указав реальный IP-адрес. При использовании значения по умолчанию будет использоваться адрес первого доступного сетевого интерфейса (не localhost).

Формат значения:

[тип_канала]:[идентификатор_канала]:[метка]:[IP-адрес]:[порт]<:[протокол]><:[время_ожидания]><:[размер_буфера]>.

Информация по параметрам, передающимся в значении, приведена в таблице.

Пример значения: 0:0:0:192.0.2.1:5800

-r

Маршрут для TCP/UDP трафика:

  • если применяется на клиентской стороне, то определяет маршрутизацию для TCP и UDP трафика;
  • если применяется на серверной стороне, то определяет обратную маршрутизацию UDP трафика.

Особенности функционирования:

  • для корректной работы TCP-маршрутизации необходимо, чтобы конфигурации сервера и клиента соответствовали друг другу;

  • при использовании UDP обязательна двусторонняя настройка маршрутов (-r) на обоих концах.

Формат значения:

[тип_канала]:[идентификатор_канала]:[метка]:[IP-адрес]:[порт]<:[протокол]><:[время_ожидания]><:[размер_буфера]>.

Информация по параметрам, передающимся в значении, приведена в таблице.

Пример значения: 0:0:0:192.0.2.2:5800

-с

Интерфейс для подключения. Можно указать несколько, в этом случае будет использоваться первый доступный.

Формат значения: 

[тип_канала]:[идентификатор_канала]:[метка]:[IP-адрес]:[порт]<:[протокол]><:[время_ожидания]><:[размер_буфера]>.

Информация по параметрам, передающимся в значении, приведена в таблице.

Пример значения: 0:0:0:127.0.0.1:5900

Параметры для значений ключей ПО tera-router

ПараметрОписание

[тип_канала]

Тип канала. Обязательный параметр.

Возможные значения:

  • 1 - MAIN;
  • 2 - DISPLAY;
  • 3 - INPUTS;
  • 4 - CURSOR;
  • 5 - PLAYBACK;
  • 6 - RECORD;
  • 7 - TUNNEL;
  • 8 - SMARTCARD;
  • 9 - USBREDIR;
  • 10 - PORT;
  • 11 - WEBDAV

[идентификатор_канала]

Идентификатор канала. Обязательный параметр

[метка]

Метка, выставляемая на пакеты. Обязательный параметр, устанавливается только для ключа -r

[IP-адрес]

IP-адрес. Обязательный параметр

[порт]

Порт. Обязательный параметр

[протокол]

Протокол. Необязательный параметр

Возможные значения:

  • 0 (умолчанию) для TCP;
  • любое другое целочисленное значение для UDP

[время_ожидания]

Время ожидания (в миллисекундах) для операций чтения или записи. Необязательный параметр

Значение по умолчанию: 1200 (1,2 секунды)

[размер_буфера]

Размер буфера (в Кбайтах) для чтения или записи данных. Необязательный параметр

Значение по умолчанию:

  • 16 КБ (TCP);
  • 8 КБ (UDP)

Примеры использования приведены в таблице.

Сценарии вызова ПО tera-router

СценарийПример

Передача всех каналов по протоколу TCP

Серверная часть (IP-адрес: 192.0.2.1):

tera-router -l 20:21 -b 0:0:0:192.0.2.1:5800 -c 0:0:0:127.0.0.1:5900
BASH

Клиентская часть (IP-адрес: 192.0.2.2):

tera-router -l 20:21 -b 0:0:0:127.0.0.1:5900 -r 0:0:0:192.0.2.2:5800
BASH

Раздельная маршрутизация по протоколам

Серверная часть (IP-адрес: 192.0.2.1):

tera-router -l 20:21 \
  -b 0:0:0:192.0.2.1:5800 \
  -b 10:0:0:192.0.2.1:5810:1 \
  -r 10:0:0:192.0.2.2:5810:1 \
  -c 0:0:0:127.0.0.1:5900
BASH

Клиентская часть (IP-адрес: 192.0.2.2):

tera-router -l 20:21 \
  -b 0:0:0:127.0.0.1:5900 \
  -r 0:0:0:192.0.2.1:5800 \
  -b 10:0:0:192.0.2.2:5810:1 \
  -r 10:0:0:192.0.2.1:5810:1
BASH

Пояснение:

  • канал 0:0 передается по TCP через порт 5800;

  • канал 10:0 передается по UDP (протокол = 1) через порт 5810;

  • на сервере и клиенте настроены взаимные UDP-маршруты для канала 10:0

Настройка серверной части для UDP-канала INPUTS (3) c идентификатором 0 и меткой 0

Значение для ключа -b: 3:0:0.

Примеры запуска:

tera-router -l 20:21 \
  -b 3:0:0:0.0.0.0:6010:1
BASH 
tera-router -l 20:21 \
  -b 3:0:0:${TERA_ROUTER_ADDRESS:-0.0.0.0}:6010:1
BASH

Настройка серверной части для UDP-каналов INPUTS и CURSOR

tera-router -l 20:21 \
  -b 3:0:0:0.0.0.0:6010:1 \
  -b 4:0:0:0.0.0.0:6020:1
BASH 
tera-router -l 20:21 \
  -b 3:0:0:${TERA_ROUTER_ADDRESS:-0.0.0.0}:6010:1 \
  -b 4:0:0:${TERA_ROUTER_ADDRESS:-0.0.0.0}:6020:1
BASH