HylaFax.config (русс)
Содержание
Наименование
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. |
