summaryrefslogtreecommitdiffstats
path: root/OPTIONS
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--OPTIONS32
-rw-r--r--OPTIONS.md29
2 files changed, 61 insertions, 0 deletions
diff --git a/OPTIONS b/OPTIONS
new file mode 100644
index 0000000..d934a05
--- /dev/null
+++ b/OPTIONS
@@ -0,0 +1,32 @@
+Setting the STD_CDEFINES environment variable before running configure can
+be used to enable certain compile-time options that are not explicitly
+defined in configure.
+
+Some of these settings are:
+
+Setting Description
+ Don't ovewrite memory when allocating or freeing
+-DISC_MEM_FILL=0 it; this improves performance but makes
+ debugging more difficult.
+ Don't track memory allocations by file and line
+-DISC_MEM_TRACKLINES=0 number; this improves performance but makes
+ debugging more difficult.
+-DISC_FACILITY=LOG_LOCAL0 Change the default syslog facility for named
+-DNS_CLIENT_DROPPORT=0 Disable dropping queries from particular
+ well-known ports:
+-DCHECK_SIBLING=0 Don't check sibling glue in named-checkzone
+-DCHECK_LOCAL=0 Don't check out-of-zone addresses in
+ named-checkzone
+-DNS_RUN_PID_DIR=0 Create default PID files in ${localstatedir}/run
+ rather than ${localstatedir}/run/{named,lwresd}/
+ Enable DNSSEC signature chasing support in dig.
+-DDIG_SIGCHASE=1 (Note: This feature is deprecated. Use delv
+ instead.)
+ Increase the maximum number of configurable
+-DNS_RPZ_MAX_ZONES=64 response policy zones from 32 to 64; this is the
+ highest possible setting
+-DISC_HEAP_CHECK Test heap consistency after every heap
+ operation; used when debugging
+ Disable the use of inline functions to implement
+-DISC_BUFFER_USEINLINE=0 the isc_buffer API: this reduces performance but
+ may be useful when debugging
diff --git a/OPTIONS.md b/OPTIONS.md
new file mode 100644
index 0000000..6fb9a44
--- /dev/null
+++ b/OPTIONS.md
@@ -0,0 +1,29 @@
+<!--
+ - Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+ -
+ - This Source Code Form is subject to the terms of the Mozilla Public
+ - License, v. 2.0. If a copy of the MPL was not distributed with this
+ - file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ -
+ - See the COPYRIGHT file distributed with this work for additional
+ - information regarding copyright ownership.
+-->
+Setting the `STD_CDEFINES` environment variable before running `configure`
+can be used to enable certain compile-time options that are not explicitly
+defined in `configure`.
+
+Some of these settings are:
+
+|Setting |Description |
+|-----------------------------------|----------------------------------------|
+|`-DISC_MEM_FILL=0`|Don't ovewrite memory when allocating or freeing it; this improves performance but makes debugging more difficult.|
+|`-DISC_MEM_TRACKLINES=0`|Don't track memory allocations by file and line number; this improves performance but makes debugging more difficult.|
+|<nobr>`-DISC_FACILITY=LOG_LOCAL0`</nobr>|Change the default syslog facility for `named`|
+|`-DNS_CLIENT_DROPPORT=0`|Disable dropping queries from particular well-known ports:|
+|`-DCHECK_SIBLING=0`|Don't check sibling glue in `named-checkzone`|
+|`-DCHECK_LOCAL=0`|Don't check out-of-zone addresses in `named-checkzone`|
+|`-DNS_RUN_PID_DIR=0`|Create default PID files in `${localstatedir}/run` rather than `${localstatedir}/run/{named,lwresd}/`|
+|`-DDIG_SIGCHASE=1`|Enable DNSSEC signature chasing support in `dig`. (Note: This feature is deprecated. Use `delv` instead.)|
+|`-DNS_RPZ_MAX_ZONES=64`|Increase the maximum number of configurable response policy zones from 32 to 64; this is the highest possible setting|
+|`-DISC_HEAP_CHECK`|Test heap consistency after every heap operation; used when debugging|
+|`-DISC_BUFFER_USEINLINE=0`|Disable the use of inline functions to implement the `isc_buffer` API: this reduces performance but may be useful when debugging |