---
name: "destctrls"
section: "5"
platform: "linux"
package: "hylafax-server"
version: "1:4.2.1-5sarge3"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/destctrls"
---

# destctrls(5)

per-destination controls for HylaFAX servers

## NAME

destctrls - per-destination controls for *HylaFAX* servers

## DESCRIPTION

The *HylaFAX* configuration parameter **DestControls** specifies whether or not to apply per-destination controls on job characteristics such as the time-of-day to place a call.

The controls file is a simple ASCII file containing a series of records of the form:

*dest*	param = value ... param = value

where *dest* is a regular expression matched against the canonical form of a destination phone number and parameters are specified by named assignments (though the \`\`='' can also be left out). Whitespace may be used freely though it is used to identify the end of *dest* and the start of the parameter list. Parameter values are parsed exactly as specified in [*hylafax-config*(5)](/hylafax-config/5.md); i.e. values with embedded whitespace may be enclosed in quote marks (\`\`"'').

Comments are introduced with a \`\`#'' character and extend to the end of the line. Parameter lists may be continued across lines by starting subsequent lines with a whitespace character (lines commented out with \`\`#'' are also considered to be part of a continued record).

The order of entries in a file is important. When a parameter value is needed *faxq* sequentially scans the file until it finds a record that matches the canonical form of the destination phone number. If the requested parameter is defined in this record, then the value is returned, otherwise a default value is used from the *faxq* configuration file.

The following parameters may be specified on a per-destination basis; consult [*hylafax-config*(5)](/hylafax-config/5.md) for a description of each parameter (except **RejectNotice** which is described below).

```
Tag	Type	Default	Description
MaxConcurrentCalls	integer		max concurrent jobs to process for a destination
MaxDials	integer	unlimited	max phone calls to make to transmit a job
MaxSendPages	integer	unlimited	max pages to permit in a send
MaxTries	integer		max attempts to transmit a job
Modem	string	Any	ModemGroup to use for destination
RejectNotice	string	-	rejection notice for transmit job
TimeOfDay	string	Any	default time-of-day restrictions
VRes	integer	-	Vertical resolution
UseXVRes	integer	-	Usage of extended resolutions
```

The **Modem** parameter controls which **ModemGroup** is used in sending faxes to the destination.  If the user assigns a **ModemGroup** for a specific job where all modems are outside of this **ModemGroup** matching a destination, then the value of **Modem** is overridden by the user's assignment.  Likewise, if the user assigns a **ModemGroup** for a specific job where some, but not all, of the modems are included in this **ModemGroup** matching a destination, then the value of **Modem** is overridden by the inclusive set of modems found in both.

The **RejectNotice** parameter controls whether or not to reject jobs to the destination. Jobs that are rejected are done so without placing a phone call and the associated message is returned to the job submitter. This facility can be used to disallow calling sensitive phone numbers; for example

```
 .*911$    RejectNotice = "Calls to emergency numbers are not permitted"
```

The **VRes** parameter controls the vertical resolution. Possible values are 98 (normal resolution, equivalent to *sendfax* -l option) and 196 (fine resolution, equivalent toi *sendfax* -m option).

The **UseXVRes** parameter is used to enable or disable the usage of extended resolutions supported by the receiver. Possible values are 1 (enable extended resolutions usage, equivalent to *sendfax* -G option) and 0 (disable extended resolutions usage). This parameter supercedes the usage of **VRes.**

In addition to the above parameters, any other parameters that are specified are automatically accumulated and passed to programs invoked by *faxq*, such as *faxsend* and *pagesend*. This is a convenient mechanism for defining configuration parameters for all modems without having to modify each modem-specific configuration file.  For example,

```
 .*    SessionTracing = 0x4f
```

This mechanism also makes it easy to control transmit-related parameters according to the destination phone number.  For example, to disable use of  ECM and restrict the transmit speed when placing international phone calls one might use:

```
 [+][^1]    DesiredBR=3 DesiredEC=0
```

## NOTES

Beware that canonical phone numbers have a leading \`\`+'' which is a special character for regular expressions.  An easy way to match \`\`+'' is with \`\`\[+\]''; e.g. \`\`\[+\]14159657824''.

## SEE ALSO

[*faxq*(8)](/faxq/8.md), [*hylafax-config*(5)](/hylafax-config/5.md), [*re\_format*(7)](/re_format/7.md).