.\" Copyright (C) 2006 Red Hat, Inc. All rights reserved.
.\" Author: Ulrich Drepper <drepper@redhat.com>
.\"
-.\" %%%LICENSE_START(GPLv2_MISC)
-.\" This copyrighted material is made available to anyone wishing to use,
-.\" modify, copy, or redistribute it subject to the terms and conditions of the
-.\" GNU General Public License v.2.
+.\" SPDX-License-Identifier: GPL-2.0-only
.\"
-.\" This program is distributed in the hope that it will be useful, but WITHOUT
-.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-.\" more details.
-.\"
-.\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, see
-.\" <http://www.gnu.org/licenses/>.
-.\" %%%LICENSE_END
-.\"
-.TH GAI.CONF 5 2013-02-13 "Linux" "Linux Programmer's Manual"
+.TH gai.conf 5 (date) "Linux man-pages (unreleased)"
.SH NAME
gai.conf \- getaddrinfo(3) configuration file
.SH DESCRIPTION
the RFC also requires that system administrators should have the possibility
to dynamically change the sorting.
For the glibc implementation, this can be achieved with the
-.IR /etc/gai.conf
+.I /etc/gai.conf
file.
.PP
Each line in the configuration file consists of a keyword and its parameters.
White spaces in any place are ignored.
-Lines starting with \(aq#\(aq are comments and are ignored.
+Lines starting with \[aq]#\[aq] are comments and are ignored.
.PP
The keywords currently recognized are:
.TP
\fBlabel\fR \fInetmask\fR \fIprecedence\fR
The value is added to the label table used in the RFC\ 3484 sorting.
-If any \fBlabel\fR definition is present in the configuration file
-is present, the default table is not used.
+If any \fBlabel\fR definition is present in the configuration file,
+the default table is not used.
All the label definitions
of the default table which are to be maintained have to be duplicated.
Following the keyword,
-the line has to contain a network mask and a label value.
+the line has to contain a network mask and a precedence value.
.TP
\fBprecedence\fR \fInetmask\fR \fIprecedence\fR
-This keyword is similar to \fBlabel\fR, but instead the value is added
+This keyword is similar to \fBlabel\fR, but instead the value is added
to the precedence table as specified in RFC\ 3484.
Once again, the
presence of a single \fBprecedence\fR line in the configuration file
This keyword controls whether a process checks whether the configuration
file has been changed since the last time it was read.
If the value is
-"\fByes\fR" the file is re-read.
+"\fByes\fR", the file is reread.
This might cause problems in multithreaded
applications and is generally a bad idea.
The default is "\fBno\fR".
Changing these defaults should hardly ever be necessary.
.SH FILES
\fI/etc/gai.conf\fR
-.SH EXAMPLE
+.SH VERSIONS
+The
+.I gai.conf
+.\" Added in 2006
+file is supported since glibc 2.5.
+.SH EXAMPLES
The default table according to RFC\ 3484 would be specified with the
following configuration file:
-
-.nf
+.PP
+.in +4n
+.EX
label ::1/128 0
label ::/0 1
label 2002::/16 2
precedence 2002::/16 30
precedence ::/96 20
precedence ::ffff:0:0/96 10
-.fi
+.EE
+.in
.\" .SH AUTHOR
.\" Ulrich Drepper <drepper@redhat.com>
.\"