HylaFax.config (русс)

Материал из OpenWiki
Перейти к: навигация, поиск

Hylafax

Наименование

Config - файлы конфигурации

Описание

HylaFAX использует файлы конфигурации для планировщика очередей и для каждого факс-модема, подключенного к кормпьютеру.Эти файлы содержат информацию о модемах и о том, как сервер HylaFAX управляет работой этих модемов. Файлы конфигурации расположены в подкаталоге etc/ . Файл конфигурации для программы faxq(8C) называется config. Файлы конфигурации для модемов, используемые программами faxgetty (8C), faxsend (8C), и pagesend (8C) назваются config.devid, где devid - идентификатор, полученный из названия файла устройства модема; например ttym2 для/dev/ttym2, term_10 для/dev/term/10. Файлы конфигурации имеют простой формат и являются полностью ASCII. Параметр конфигурации имеет следующий формат:

tag: value

где tag - наименование параметра,value - символьное(string), числовое(numeric) или булево(boolean) значение. Комментарии начинаются с "#" и заканчиваются окончанием строки. Символльное значение начинается с первого не пустого символа после ":" и заканчивается перед первым не текстовым символом или в случае заключеня значения в двойные или одинарные кавычки ограничено тими кавычками. Символьное значение заключенное в кавычки может также использовать esc-проследовательности с соответствии с синтаксисом языка Си для строковых переменных - например "\n" - символ переноса строки "\xxx" для восмеричного значения. Числовое значение также,использует синтаксис языка Си - "0x" - для шестнадцатиричного значения, 0 для восмеричного, остальное десятичные значения,за исключением нескольких параметров, таких как RecvFileMode, значение которого интерпретируется строго как октальное число и PageChopThreshold, значние которого интерпретируется строго как число плавающей запятой. Булевые значения не чуствительны к регистру. За истинное значение принимается "Yes" или "On". За ложь принимается "No" или "Off".

В таблице ниже перечислены параметры их тип и значения по умолчанию. Первая часть перечисляет параметры, определенные для сервера в целом, в то время как второй части, перечислены параметры связанные с обслуживанием модема. Параметры, отмеченные ¹, используются только процессом планировщика HylaFAX и должны появиться только в файле, названном config. Параметры, отмеченные ², могут использоваться как планировщиком так непосредственно модемами и соответственно должны появиться во всех соответствующих файлах конфигурации (то есть в config соответствующих config.devs там где имеют смысл). Параметры, никак не отмеченные, должны появиться только в файлах конфигурации конкретных модемов.

Сводная таблица параметров

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

AdaptiveAnswer

тип значение по умолчанию Комментарий
boolean No включает адаптивный ответ на входящие вызовы

Параметр определяет, используется ли адаптивная стратегия ответа. Если используется то на входящий звонок возможен ответ различными способами согласно списку, определенному в параметре AnswerRotary. Например, если адаптивный ответ будет позволен, и AnswerRotary определяет "данные факса", то входящему звонку сначала ответят как факс, используя ModemAnswerFaxCmd и затем, если это потерпит неудачу, как данные, используя ModemAnswerDataCmd.Если адаптивная стратегия ответа не позволена, то на входящие звонки отвечают, используя соответствующий параметры ModemAnswer*Cmd (обычно ModemAnswerCmd - для оставленной без присмотра операции). Стоит отметить, что адаптивная стратегия ответа зависит от многих факторов, которые ограничивают ее полноценность. Когда сначала мы пытаемся принять факс, это типично только работает с модемом Класса 1, потому что важно, чтобы последовательность операций соотносилась с временем попытки ответить как факс и могла быть законченной в достаточно короткое время, чтобы последующий ответ для данных можно было бы успеть сделать до того как звонящая сторона вешает трубку (по этой причине, значение Class1RecvIdentTimer должно быть меньше чем FaxT1Timer.). Кроме того, необходимо отметить, что иногда необходимо договориться чтобы телефон быть заблокирован между последовательными ответами: это можно сделать, вставляя соответствующую команду в начале второго и последующего ModemAnswer*Cmds.

AnswerRotary

тип значение по умолчанию Комментарий
string any Варианты стратегии ответов на входящие вызовы

Последовательность возможных вариантов поведения сервера при ответе на входящие вызовы перебирается по кругу. Могут использоваться следующие значения :

fax - ответ факса,

data - ответ модема,

voice - голосовой ответ,

extern - использовать vgetty для ответа на вызов,

any - ответ на вызов тип которого неизвестен.

При неудачной попытке соединения сервер переходит к следующему варианту поведения при ответе по кругу. Если AdaptiveAnswer разрешен, то сервер попробует все методы ответа на каждый входящий звонок.

MaxDials¹

тип значение по умолчанию Комментарий
integer 12 Максимальное количество попыток отправить факс

Значение максимально возможного количества попыток передать факс. Это значение может быть изменено правилами в механизме JobControl. См. также MaxTries.

MaxTries¹

тип значение по умолчанию Комментарий
integer 3 Максимальное количество передать факс при установленном соединении

Маскимально возможное количество попыток общаться с удаленным факсом. Необходимо отметить что в данном случае учитывется только количество попыток, когда соединение было установлено в отличие от MaxDial, который ограничивает число попыток позвонить. Это значение может быть изменено правилами в механизме JobControl. См. также MaxDials.

ModemGroup¹

тип значение по умолчанию Комментарий
string - Определение группы модемов

Определение наименования группы модемов. Этот параметр может быть использован для определения имени группы модемов по которому клиенты могут использовать только модемы входящие в эту группу. Синтаксис '<name>:<regex>' где name - название группы и regex - регулярное выражение описывающее зданные модемы для прогдаммы faxq. Так например по умолчанию задания используют любой модем, что описывается как "any:.*". Этот параметр может использоваться многократно для определения нескольких групп модемов.Группы модемов могут пересекаться. Фактический состав группы определяется еще и степенью готовности модемов.


ModemPriority

тип значение по умолчанию Комментарий
integer 255 Приоритет использования модема планировщиком

Значение приоритета испольования модема может быть в диапазоне от 0 до 255. Чем меньше числовое значение тем выше приоритет этого модема (более желателен). Планировщик Hylafax назначает модем с самым высоким приоритетом из свободных для использования.

MaxConcurrentCalls¹

тип значение по умолчанию Комментарий
integer 1 Максимальное количество параллельных звонков для выполнения одного задания.

Если у получателей ваших факсов нет многоканальных телефонных вам вероятно стоит оставить это значение равным 1, а исключения обрабатывать механизмом jobControl.

NoCarrierRetrys

тип значение по умолчанию Комментарий
integer nn Устарело - смотри JobRetryNoCarrier

This is mapped onto JobRetryNoCarrier

NotifyCmd²

тип значение по умолчанию Комментарий
string -

имя скрипта отвечающего за процесс уведомления о событии изменения статуса задания

парамеры jobcontrol

параметр(tag) тип значение по умолчанию Комментарий Описание
JobControlCmd¹ тип что то по умолчанию The command to invoke to which provides Job Control information for a job. See jobcontrol(8C).
JobReqBusy тип что то по умолчанию The delay in seconds to wait before retrying a job whose dialing attempt failed with a ``BUSY status result.
JobReqDataConn тип что то по умолчанию The delay in seconds to wait before retrying a facsimile job whose dialing attempt failed because a data modem answered the phone.
JobReqNoAnswer тип что то по умолчанию The delay in seconds to wait before retrying a job whose dialing attempt failed with a ``NO ANSWER status result.
JobReqNoCarrier тип что то по умолчанию The delay in seconds to wait before retrying a job whose dialing attempt failed with a ``NO CARRIER status result.
JobReqNoFCon тип что то по умолчанию The delay in seconds to wait before retrying a facsimile job whose dialing attempt failed because the initial facsimile protocol handshake failed (i.e. no ``+FCON: result was received from a Class 2/2.0 modem).
JobReqOther² тип что то по умолчанию The delay in seconds to wait before retrying a job that failed for a reason not already covered by one of the JobReq* parameters.
JobReqProto тип что то по умолчанию The delay in seconds to wait before retrying a facsimile job that failed because of a fax protocol error.
JobRetryBusy тип что то по умолчанию The number of times to redial a phone number after receiving a ``BUSY result code when the number has not been successfully dialed before.
JobRetryDataConn тип что то по умолчанию The number of times to redial a phone number after the dialing attempt failed because a data modem answered the phone when the number has not been successfully dialed before.
JobRetryNoAnswer тип что то по умолчанию The number of times to redial a phone number after the dialing attempt failed because of NO ANSWER when the number has not been successfully dialed before.
JobRetryNoCarrier тип что то по умолчанию The number of times to redial a phone number after the dialing attempt failed because of NO CARRIER when the number has not been successfully dialed before. In normal operation the fax server will treat this result code to mean that a facsimile modem/machine did not answer the phone and reject the transmit job. This is done to avoid repeatedly dialing wrong phone numbers and depends on the modem distinguishing between no carrier and no answer. However, some modems are not capable of reliably distinguishing between no carrier and no answer, or when instructed to do so do not identify a busy signal correctly. For these modems one may find it necessary to increase the value of this parameter to compensate. It is strongly recommended, however, that this value not be set to a large number.
JobRetryOther тип что то по умолчанию The number of times to redial a phone number after the dialing attempt failed for a reason not already covered by one of the other JobRetry* parameters when the number has not been successfully dialed before.