diff --git a/.cvsignore b/.cvsignore index d04e18b..3809dd3 100644 --- a/.cvsignore +++ b/.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 diff --git a/gai.conf.5 b/gai.conf.5 new file mode 100644 index 0000000..59e7fc9 --- /dev/null +++ b/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 +.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 + +.SH SEE ALSO +.BR getaddrinfo(3), +RFC 3484 diff --git a/man-pages.spec b/man-pages.spec index 533d240..5588f2d 100644 --- a/man-pages.spec +++ b/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 2.32-1 +- update to 2.32 +- add gai.conf.5 man page (#191656) + * Mon Apr 18 2006 Ivana Varekova 2.29-1 - update to 2.29 - fix sigprocmask(2) man page (#189121) diff --git a/sources b/sources index 054b611..6f0d3c2 100644 --- a/sources +++ b/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