]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man5/gai.conf.5
proc.5, proc_uptime.5: Split /proc/uptime from proc(5)
[thirdparty/man-pages.git] / man5 / gai.conf.5
index f063fa0994367578d77910021d805ffeb5f4cacd..864f2a4a1aa4aee4847c0948721ffdb3495a615d 100644 (file)
@@ -1,22 +1,9 @@
 .\" 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
@@ -31,26 +18,26 @@ For this reason,
 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
@@ -60,7 +47,7 @@ causes the default table to not be used.
 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".
@@ -71,11 +58,17 @@ By default, the scope IDs described in section 3.2 in RFC\ 3438 are used.
 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
@@ -86,7 +79,8 @@ precedence  ::/0          40
 precedence  2002::/16     30
 precedence ::/96          20
 precedence ::ffff:0:0/96  10
-.fi
+.EE
+.in
 .\" .SH AUTHOR
 .\" Ulrich Drepper <drepper@redhat.com>
 .\"