Configuration
[Base]

Defines
#define	PJ_DNS_MAX_IP_IN_A_REC   8
#define	PJ_DNS_SRV_MAX_ADDR   8
#define	PJ_DNS_MAX_NAMES_IN_NAMETABLE   16
#define	PJ_DNS_RESOLVER_MAX_NS   16
#define	PJ_DNS_RESOLVER_QUERY_RETRANSMIT_DELAY   2000
#define	PJ_DNS_RESOLVER_QUERY_RETRANSMIT_COUNT   5
#define	PJ_DNS_RESOLVER_MAX_TTL   (5*60)
#define	PJ_DNS_RESOLVER_INVALID_TTL   60
#define	PJ_DNS_RESOLVER_GOOD_NS_TTL   (10*60)
#define	PJ_DNS_RESOLVER_BAD_NS_TTL   (1*60)
#define	PJ_DNS_RESOLVER_MAX_UDP_SIZE   512
#define	PJ_DNS_RESOLVER_RES_BUF_SIZE   1000
#define	PJ_DNS_RESOLVER_TMP_BUF_SIZE   4000
#define	PJ_SCANNER_USE_BITWISE   1
#define	PJSTUN_MAX_ATTR   16
#define	PJ_STUN_MAX_ATTR   16
#define	PJ_CRC32_HAS_TABLES   1

---

Define Documentation

#define PJ_CRC32_HAS_TABLES   1

Specifies whether CRC32 algorithm should use the table based lookup table for faster calculation, at the expense of about 1KB table size on the executable. If zero, the CRC32 will use non-table based which is more than an order of magnitude slower.

Default: 1

#define PJ_DNS_MAX_IP_IN_A_REC   8

Maximum number of IP addresses in DNS A response.

#define PJ_DNS_MAX_NAMES_IN_NAMETABLE   16

This constant specifies the maximum names to keep in the temporary name table when performing name compression scheme when duplicating DNS packet (the pj_dns_packet_dup() function).

Generally name compression is desired, since it saves some memory (see PJ_DNS_RESOLVER_RES_BUF_SIZE setting). However it comes at the expense of a little processing overhead to perform name scanning and also a little bit more stack usage (8 bytes per entry on 32bit platform).

Default: 16

#define PJ_DNS_RESOLVER_BAD_NS_TTL   (1*60)

The interval on which nameservers which known to be bad to be probed again to determine whether it is still bad.

Default: 60 (one minute)

See also:

PJ_DNS_RESOLVER_GOOD_NS_TTL

#define PJ_DNS_RESOLVER_GOOD_NS_TTL   (10*60)

The interval on which nameservers which are known to be good to be probed again to determine whether they are still good. Note that this applies to both active nameserver (the one currently being used) and idle nameservers (good nameservers that are not currently selected). The probing to query the "goodness" of nameservers involves sending the same query to multiple servers, so it's probably not a good idea to send this probing too often.

Default: 600 (ten minutes)

See also:

PJ_DNS_RESOLVER_BAD_NS_TTL

#define PJ_DNS_RESOLVER_INVALID_TTL   60

The life-time of invalid DNS response in the resolver response cache. An invalid DNS response is a response which RCODE is non-zero and response without any answer section. These responses can be put in the cache too to minimize message round-trip.

Default: 60 (one minute).

See also:

PJ_DNS_RESOLVER_MAX_TTL

#define PJ_DNS_RESOLVER_MAX_NS   16

Maximum numbers of DNS nameservers that can be configured in resolver.

#define PJ_DNS_RESOLVER_MAX_TTL   (5*60)

Maximum life-time of DNS response in the resolver response cache, in seconds. If the value is zero, then DNS response caching will be disabled.

Default is 300 seconds (5 minutes).

See also:

PJ_DNS_RESOLVER_INVALID_TTL

#define PJ_DNS_RESOLVER_MAX_UDP_SIZE   512

Maximum size of UDP packet. RFC 1035 states that maximum size of DNS packet carried over UDP is 512 bytes.

Default: 512 byes

#define PJ_DNS_RESOLVER_QUERY_RETRANSMIT_COUNT   5

Maximum number of transmissions before timeout is declared for the query.

Default: 5

#define PJ_DNS_RESOLVER_QUERY_RETRANSMIT_DELAY   2000

Default retransmission delay, in miliseconds. The combination of retransmission delay and count determines the query timeout.

Default: 2000 (2 seconds, according to RFC 1035)

#define PJ_DNS_RESOLVER_RES_BUF_SIZE   1000

Size of memory pool allocated for each individual DNS response cache. This value here should be more or less the same as maximum UDP packet size (PJ_DNS_RESOLVER_MAX_UDP_SIZE), since the DNS replicator function (pj_dns_packet_dup()) is also capable of performing name compressions.

Default: 1000 (as a broad guidance, 400 is good for 4 SRV entries).

#define PJ_DNS_RESOLVER_TMP_BUF_SIZE   4000

Size of temporary pool buffer for parsing DNS packets in resolver.

default: 4000

#define PJ_DNS_SRV_MAX_ADDR   8

Maximum server address entries per one SRV record

#define PJ_SCANNER_USE_BITWISE   1

Macro PJ_SCANNER_USE_BITWISE is defined and non-zero (by default yes) will enable the use of bitwise for character input specification (cis). This would save several kilobytes of .bss memory in the SIP parser.

#define PJ_STUN_MAX_ATTR   16

Maximum number of attributes in the STUN packet (for the new STUN library).

Default: 16

#define PJSTUN_MAX_ATTR   16

Maximum number of attributes in the STUN packet (for the old STUN library).

Default: 16