From: Michal Nowak Date: Thu, 19 Nov 2020 09:35:57 +0000 (+0100) Subject: Revise OPTIONS.md X-Git-Tag: v9.17.8~19^2~1 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e0e644352c369246f042714f7f80f5bb25cdc2e9;p=thirdparty%2Fbind9.git Revise OPTIONS.md - The STD_CDEFINES build-time variable was dropped when the build system was migrated to Automake. CPPFLAGS is the variable which should now be used for setting preprocessor macros. - Sort the list of preprocessor macros which affect BIND behavior. Remove ISC_BUFFER_USEINLINE from the list as it can be controlled using its relevant ./configure option (--enable-buffer-useinline). Rename NS_RUN_PID_DIR to NAMED_RUN_PID_DIR to match the source code. - Tweak Markdown formatting. --- diff --git a/OPTIONS.md b/OPTIONS.md index 0382c6d7fc9..642d9549fcf 100644 --- a/OPTIONS.md +++ b/OPTIONS.md @@ -8,20 +8,19 @@ - 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`. +Setting the `CPPFLAGS` 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_DEFAULTFILL=1`|Overwrite memory with tag values when allocating or freeing it; this impairs performance but makes debugging of memory problems easier.| -|`-DISC_MEM_TRACKLINES=0`|Don't track memory allocations by file and line 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/`| -|`-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 | -|`-DISC_HEAP_CHECK`|Test heap consistency after every heap operation; used when debugging| +| Setting | Description | +| ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | +| `-DCHECK_LOCAL=0` | Don't check out-of-zone addresses in `named-checkzone` | +| `-DCHECK_SIBLING=0` | Don't check sibling glue in `named-checkzone` | +| `-DISC_FACILITY=LOG_LOCAL0` | Change the default syslog facility for `named` | +| `-DISC_HEAP_CHECK` | Test heap consistency after every heap operation; used when debugging | +| `-DISC_MEM_DEFAULTFILL=1` | Overwrite memory with tag values when allocating or freeing it; this impairs performance but makes debugging of memory problems easier | +| `-DISC_MEM_TRACKLINES=0` | Don't track memory allocations by file and line number; this improves performance but makes debugging more difficult | +| `-DNAMED_RUN_PID_DIR=0` | Create default PID files in `${localstatedir}/run` rather than `${localstatedir}/run/named/` | +| `-DNS_CLIENT_DROPPORT=0` | Disable dropping queries from particular well-known ports |