- update to 2.32

- add gai.conf.5 man page (#191656)

.cvsignore

@@ -1,3 +1,3 @@
 man-pages-extralocale.tar.bz2
 man2.tar.gz
-man-pages-2.29.tar.bz2
+man-pages-2.32.tar.bz2

gai.conf.5

@@ -0,0 +1,92 @@
+.\" A man page for gai.conf. -*- nroff -*-
+.\"
+.\" Copyright (C) 2006 Red Hat, Inc. All rights reserved.
+.\"
+.\" 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.
+.\"
+.\" 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 program; if not, write to the Free Software Foundation, Inc.,
+.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+.\"
+.\" Author: Ulrich Drepper <drepper@redhat.com>
+.TH gai.conf 5 "May 2006" gai.conf
+
+.SH NAME
+gai.conf \- getaddrinfo(3) configuration file
+
+.SH DESCRIPTION
+A call to
+.BR getaddrinfo (3)
+might return multiple answers.  According to RFC 3484 these answers must
+be sorted so that the answer with the highest success rate is first in
+the list.  The RFC provides and algorithm for the sorting.  The static
+rules are not always adequate, though.  For this reason the RFC also
+requires that system administrators get the chance to dynamically change
+the sorting.  For the glibc implementation this can be achieved with
+the
+.BR /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 `#' 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.  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.
+
+.TP
+\fBprecedence\fR \fInetmask\fR \fIprecedence\fR
+This  keyword is similar to \fBlabel\fR but instead the value is added
+to the precendence table as specified in RFC 3484.  Once again, the
+presence of a single \fBprecedence\fR line in the configuration file
+causes the default table to not be used.
+
+.TP
+\fBreload\fR <\fByes\fR|\fBno\fR>
+This keyword control whether a process checks whether the configuration
+file has been changes since the last time it was read.  If the value is
+`\fByes\fR' the file is re-read.  This might cause problems in multi-threaded
+applications and is generally a bad idea.  The default is `\fBno\fR'.
+
+
+.SH EXAMPLE
+
+The default table according to RFC 3484 would be specified with the
+following configuration file:
+
+.nf
+label  ::1/128       0
+label  ::/0          1
+label  2002::/16     2
+label ::/96          3
+label ::ffff:0:0/96  4
+precendence  ::1/128       50
+precendence  ::/0          40
+precendence  2002::/16     30
+precendence ::/96          20
+precendence ::ffff:0:0/96  10
+
+
+.SH FILES
+\fI/etc/gai.conf\fR
+
+.SH AUTHOR
+Ulrich Drepper <drepper@redhat.com>
+
+.SH SEE ALSO
+.BR getaddrinfo(3),
+RFC 3484

man-pages.spec

@@ -1,6 +1,6 @@
 Summary: Man (manual) pages from the Linux Documentation Project.
 Name: man-pages
-Version: 2.29
+Version: 2.32
 Release: 1
 License: distributable
 Group: Documentation
@@ -11,17 +11,18 @@ Source6: man-pages-extralocale.tar.bz2
 Source9: man2.tar.gz
 Source10: sln.8
 Source11: man2_sys.tar.gz
+Source12: gai.conf.5
 Patch1: man-pages-1.51-iconv.patch
 Patch2: man-pages-1.51-nopent.patch
-Patch3: man-pages-1.53-langinfo.patch
+Patch3: man-pages-2.32-langinfo.patch
 Patch4: man-pages-1.60-re_comp.patch
 Patch8: man-pages-1.60-fs.patch
 Patch9: man-pages-1.60-issue.patch
-Patch12: man-pages-1.67-shm_hugetlb.patch
+Patch12: man-pages-2.32-shm_hugetlb.patch
 Patch16: man-pages-2.05-issue.patch
-Patch19: man-pages-2.07-termcap.patch
+Patch19: man-pages-2.32-termcap.patch
 Patch20: man-pages-2.13-aio.patch
-Patch21: man-pages-2.16-mmap.patch
+Patch21: man-pages-2.32-mmap.patch
 Patch22: man-pages-2.20-nscd.conf.patch
 Patch23: man-pages-2.25-dbopen.patch
 Patch24: man-pages-2.25-malloc.patch
@@ -43,6 +44,7 @@ tar jxf %{SOURCE6}
 cp -a %{SOURCE1} man1
 cp -a %{SOURCE2} man5
 cp -a %{SOURCE10} man8
+cp -a %{SOURCE12} man5
 tar xzf %{SOURCE11}
 
 %patch1 -p1
@@ -151,11 +153,15 @@ rm -rf $RPM_BUILD_ROOT
 
 %files
 %defattr(0644,root,root,0755)
-%doc README man-pages-2.28.Announce POSIX-COPYRIGHT
+%doc README man-pages-%{version}.Announce POSIX-COPYRIGHT
 %{_mandir}/man*/*
 %{_mandir}/en/man*/*
 
 %changelog
+* Mon May 15 2006 Ivana Varekova <varekova@redhat.com> 2.32-1
+- update to 2.32
+- add gai.conf.5 man page (#191656)
+
 * Mon Apr 18 2006 Ivana Varekova <varekova@redhat.com> 2.29-1
 - update to 2.29
 - fix sigprocmask(2) man page (#189121)

sources

@@ -1,3 +1,3 @@
 57f2e0500d177e05647990eae439a8ee  man-pages-extralocale.tar.bz2
 af09d031dcee66929510e078d00066f2  man2.tar.gz
-4f3314650ea0ee615fb6468ff1cb1207  man-pages-2.29.tar.bz2
+8e90f8312bdd35ec3e789bf67c9b0ee3  man-pages-2.32.tar.bz2