From bde40aafa32c2b90720778a36f98cfc772fb99ff Mon Sep 17 00:00:00 2001 From: cvsdist Date: Thu, 9 Sep 2004 08:18:17 +0000 Subject: [PATCH] auto-import changelog data from man-pages-1.67-1.src.rpm Fri Aug 20 2004 Adrian Havill 1.67-1 - updated to latest - getrpcent/setrpcent typo (#73836) - add new resolver.5 page (#126557) - add SHM_HUGETLB option to shmget (#128837) Tue Jun 15 2004 Elliot Lee - rebuilt Fri Apr 16 2004 Adrian Havill 1.66-3 - fixed minor typo (#118169) --- .cvsignore | 2 +- man-pages.spec | 28 ++++-- resolver.5 | 239 +++++++++++++++++++++++++++++++++++++++++++++++++ sources | 2 +- 4 files changed, 264 insertions(+), 7 deletions(-) create mode 100644 resolver.5 diff --git a/.cvsignore b/.cvsignore index 0884881..a4ba537 100644 --- a/.cvsignore +++ b/.cvsignore @@ -1,3 +1,3 @@ -man-pages-1.66.tar.bz2 +man-pages-1.67.tar.gz man-pages-extralocale.tar.bz2 man2.tar.gz diff --git a/man-pages.spec b/man-pages.spec index 406c022..40d6e62 100644 --- a/man-pages.spec +++ b/man-pages.spec @@ -1,11 +1,12 @@ Summary: Man (manual) pages from the Linux Documentation Project. Name: man-pages -Version: 1.66 -Release: 2 +Version: 1.67 +Release: 1 License: distributable Group: Documentation -Source0: http://www.kernel.org/pub/linux/docs/manpages/man-pages-%{version}.tar.bz2 +Source0: http://www.kernel.org/pub/linux/docs/manpages/man-pages-%{version}.tar.gz Source1: rpcgen.1 +Source2: resolver.5 Source6: man-pages-extralocale.tar.bz2 Source9: man2.tar.gz Patch0: man-pages-1.44-ext3.patch @@ -21,6 +22,9 @@ Patch11: man-pages-1.60-shmget.patch Patch12: man-pages-1.60-wait.patch Patch14: man-pages-1.60-fs.patch Patch15: man-pages-1.60-issue.patch +Patch16: man-pages-1.66-typos.patch +Patch17: man-pages-1.67-getrpcent.patch + Buildroot: %{_tmppath}/%{name}-%{version}-root Autoreq: false BuildArch: noarch @@ -34,6 +38,7 @@ Documentation Project (LDP). tar jxf %{SOURCE6} cp -a %{SOURCE1} man1 +cp -a %{SOURCE2} man5 %patch0 -p1 %patch1 -p1 @@ -48,6 +53,8 @@ cp -a %{SOURCE1} man1 %patch12 -p1 %patch14 -p1 %patch15 -p1 +%patch16 -p1 +%patch17 -p1 %build @@ -79,8 +86,7 @@ rm -fv man5/exports.5 rm -fv man5/nfs.5 # Part of bind-utils -rm -fv man5/resolver.5 -#rm -fv man5/resolv.conf.5 - kept anyway, as it makes sense to have available +#rm -fv man5/resolv.conf.5 # kept anyway, as it makes sense to have available # Obsolete rm -f man3/infnan.3 @@ -135,6 +141,18 @@ rm -rf $RPM_BUILD_ROOT %{_mandir}/en/man*/* %changelog +* Fri Aug 20 2004 Adrian Havill 1.67-1 +- updated to latest +- getrpcent/setrpcent typo (#73836) +- add new resolver.5 page (#126557) +- add SHM_HUGETLB option to shmget (#128837) + +* Tue Jun 15 2004 Elliot Lee +- rebuilt + +* Fri Apr 16 2004 Adrian Havill 1.66-3 +- fixed minor typo (#118169) + * Fri Feb 13 2004 Elliot Lee - rebuilt diff --git a/resolver.5 b/resolver.5 new file mode 100644 index 0000000..8281f30 --- /dev/null +++ b/resolver.5 @@ -0,0 +1,239 @@ +.\" Copyright (c) 1986 The Regents of the University of California. +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms are permitted +.\" provided that the above copyright notice and this paragraph are +.\" duplicated in all such forms and that any documentation, +.\" advertising materials, and other materials related to such +.\" distribution and use acknowledge that the software was developed +.\" by the University of California, Berkeley. The name of the +.\" University may not be used to endorse or promote products derived +.\" from this software without specific prior written permission. +.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR +.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED +.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. +.\" +.\" @(#)resolver.5 5.9 (Berkeley) 12/14/89 +.\" $Id: resolver.5,v 8.6 1999/05/21 00:01:02 vixie Exp $ +.\" +.Dd November 11, 1993 +.Dt RESOLVER 5 +.Os BSD 4 +.Sh NAME +.Nm resolver +.Nd resolver configuration file +.Sh SYNOPSIS +.Pa /etc/resolv.conf +.Sh DESCRIPTION +The +.Nm resolver +is a set of routines in the C library +.Pq Xr resolve 3 +that provide access to the Internet Domain Name System. +The +.Nm resolver +configuration file contains information that is read +by the +.Nm resolver +routines the first time they are invoked by a process. +The file is designed to be human readable and contains a list of +keywords with values that provide various types of +.Nm resolver +information. +.Pp +On a normally configured system, this file should not be necessary. +The only name server to be queried will be on the local machine, +the domain name is determined from the host name, +and the domain search path is constructed from the domain name. +.Pp +The different configuration directives are: +.Bl -tag -width "nameser" +.It Li nameserver +Internet address (in dot notation) of a name server that the +.Nm resolver +should query. Up to +.Dv MAXNS +(see +.Pa ) +name servers may be listed, one per keyword. +If there are multiple servers, the +.Nm resolver +library queries them in the order listed. +If no +.Li nameserver +entries are present, the default is to use the name server on the local machine. +(The algorithm used is to try a name server, and if the query times out, +try the next, until out of name servers, +then repeat trying all the name servers +until a maximum number of retries are made). +.It Li domain +Local domain name. +Most queries for names within this domain can use short names +relative to the local domain. +If no +.Li domain +entry is present, the domain is determined from the local host name returned by +.Xr gethostname 2 ; +the domain part is taken to be everything after the first +.Sq \&. . +Finally, if the host name does not contain a domain part, the root +domain is assumed. +.It Li search +Search list for host-name lookup. +The search list is normally determined from the local domain name; +by default, it contains only the local domain name. +This may be changed by listing the desired domain search path +following the +.Li search +keyword with spaces or tabs separating the names. +Most +.Nm resolver +queries will be attempted using each component +of the search path in turn until a match is found. +Note that this process may be slow and will generate a lot of network +traffic if the servers for the listed domains are not local, +and that queries will time out if no server is available +for one of the domains. +.Pp +The search list is currently limited to six domains +with a total of 256 characters. +.It Li sortlist +Allows addresses returned by gethostbyname to be sorted. +A +.Li sortlist +is specified by IP address netmask pairs. The netmask is +optional and defaults to the natural netmask of the net. The IP address +and optional network pairs are separated by slashes. Up to 10 pairs may +be specified. For example: +.Bd -literal -offset indent +sortlist 130.155.160.0/255.255.240.0 130.155.0.0 +.Ed +.It Li options +Allows certain internal +.Nm resolver +variables to be modified. +The syntax is +.D1 Li options Ar option ... +where +.Ar option +is one of the following: +.Bl -tag -width "ndots:n " +.It Li debug +sets +.Dv RES_DEBUG +in +.Ft _res.options . +.It Li ndots: Ns Ar n +sets a threshold for the number of dots which +must appear in a name given to +.Fn res_query +(see +.Xr resolver 3 ) +before an +.Em initial absolute query +will be made. The default for +.Ar n +is +.Dq 1 , +meaning that if there are +.Em any +dots in a name, the name will be tried first as an absolute name before any +.Em search list +elements are appended to it. +.It Li timeout: Ns Ar n +sets the amount of time the resolver will wait for a response from a remote +name server before retrying the query via a different name server. Measured in +seconds, the default is +.Dv RES_TIMEOUT +(see +.Pa ). +.It Li attempts: Ns Ar n +sets the number of times the resolver will send a query to its name servers +before giving up and returning an error to the calling application. The +default is +.Dv RES_DFLRETRY +(see +.Pa ). +.It Li rotate +sets +.Dv RES_ROTATE +in +.Ft _res.options , +which causes round robin selection of nameservers from among those listed. +This has the effect of spreading the query load among all listed servers, +rather than having all clients try the first listed server first every time. +.It Li no-check-names +sets +.Dv RES_NOCHECKNAME +in +.Ft _res.options , +which disables the modern BIND checking of incoming host names and mail names +for invalid characters such as underscore (_), non-ASCII, or control characters. +.It Li inet6 +sets +.Dv RES_USE_INET6 +in +.Ft _res.options . +This has the effect of trying a AAAA query before an A query inside the +.Ft gethostbyname +function, and of mapping IPv4 responses in IPv6 ``tunnelled form'' if no +AAAA records are found but an A record set exists. +.It Li ip6-dotint / no-ip6-dotint +sets / clears the +.Dv RES_NOIP6DOTINT +bit in +.Ft _res.options , +which when set (ip6-dotint) will enable reverse IPv6 lookups to be made in the (deprecated) +ip6.int zone; when clear (no-ip6-dotint), reverse IPv6 lookups are made in the ip6.arpa zone +by default. +.It Li ip6-bytestring +sets +.Dv RES_USEBSTRING +in +.Ft _res.options . +This causes reverse IPv6 lookups to be made using the bit-label +format of RFC 2673; if not set, then nibble format is used. +.El +.El +.Pp +The +.Li domain +and +.Li search +keywords are mutually exclusive. +If more than one instance of these keywords is present, +the last instance wins. +.Pp +The +.Li search +keyword of a system's +.Pa resolv.conf +file can be +overridden on a per-process basis by setting the environment variable +.Dq Ev LOCALDOMAIN +to a space-separated list of search domains. +.Pp +The +.Li options +keyword of a system's +.Pa resolv.conf +file can be amended on a per-process basis by setting the environment variable +.Dq Ev RES_OPTIONS to a space-separated list of +.Nm resolver +options as explained above under +.Li options . +.Pp +The keyword and value must appear on a single line, and the keyword +(e.g., +.Li nameserver ) +must start the line. The value follows the keyword, separated by white space. +.Sh FILES +.Pa /etc/resolv.conf +.Pa +.Sh SEE ALSO +.Xr gethostbyname 3 , +.Xr hostname 7 , +.Xr named 8 , +.Xr resolver 3 , +.Xr resolver 5 . +.Dq Name Server Operations Guide for Sy BIND diff --git a/sources b/sources index fd5bd63..22a7100 100644 --- a/sources +++ b/sources @@ -1,3 +1,3 @@ -dd510bb621064873219cc692e3ba808d man-pages-1.66.tar.bz2 +47e2f0d89dbd1b231fb5b57331644ed1 man-pages-1.67.tar.gz 57f2e0500d177e05647990eae439a8ee man-pages-extralocale.tar.bz2 af09d031dcee66929510e078d00066f2 man2.tar.gz