2
0
mirror of https://gitlab.isc.org/isc-projects/bind9 synced 2025-08-29 21:47:59 +00:00

Update documentation for named's -M option

Remove "external" from the list of legal values for the -M command-line
option as it has not been allowed since the internal memory allocator
was removed by commit 55ace5d3aa4cb8c1b70a94679e1dd6d716dfd8bb.

Make the style of the relevant paragraph more in line with the next one
and split its contents up into an unordered list of options for improved
readability.
This commit is contained in:
Michał Kępień 2022-07-15 10:23:03 +02:00
parent dde669f546
commit fc8e6a4cb2
2 changed files with 24 additions and 14 deletions

View File

@ -96,13 +96,17 @@ Options
.. option:: -M option
This option sets the default memory context options. If set to ``external``,
the internal memory manager is bypassed in favor of
system-provided memory allocation functions. If set to ``fill``, blocks
of memory are filled with tag values when allocated or freed, to
assist debugging of memory problems. ``nofill`` disables this behavior,
and is the default unless :program:`named` has been compiled with developer
options.
This option sets the default (comma-separated) memory context
options. The possible flags are:
- ``fill``: fill blocks of memory with tag values when they are
allocated or freed, to assist debugging of memory problems; this is
the implicit default if :program:`named` has been compiled with
``--enable-developer``.
- ``nofill``: disable the behavior enabled by ``fill``; this is the
implicit default unless :program:`named` has been compiled with
``--enable-developer``.
.. option:: -m flag

View File

@ -113,13 +113,19 @@ This option sets the log to the file \fBlogfile\fP by default, instead of the sy
.INDENT 0.0
.TP
.B \-M option
This option sets the default memory context options. If set to \fBexternal\fP,
the internal memory manager is bypassed in favor of
system\-provided memory allocation functions. If set to \fBfill\fP, blocks
of memory are filled with tag values when allocated or freed, to
assist debugging of memory problems. \fBnofill\fP disables this behavior,
and is the default unless \fBnamed\fP has been compiled with developer
options.
This option sets the default (comma\-separated) memory context
options. The possible flags are:
.INDENT 7.0
.IP \(bu 2
\fBfill\fP: fill blocks of memory with tag values when they are
allocated or freed, to assist debugging of memory problems; this is
the implicit default if \fBnamed\fP has been compiled with
\fB\-\-enable\-developer\fP\&.
.IP \(bu 2
\fBnofill\fP: disable the behavior enabled by \fBfill\fP; this is the
implicit default unless \fBnamed\fP has been compiled with
\fB\-\-enable\-developer\fP\&.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP