[PATCH] nscd.8: Correct NOTES section on reloading configuration files

[PATCH] nscd.8: Correct NOTES section on reloading configuration files

[Petr Baudis]

The original notes were obsolete, current nscd watches changes in
config files.

Signed-off-by: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>

diff --git a/man8/nscd.8 b/man8/nscd.8
index ecbd9ba..987efcb 100644
--- a/man8/nscd.8
+++ b/man8/nscd.8
@@ -17,7 +17,10 @@
 .\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 .\" Boston, MA 02111-1307, USA.
 .\"
-.TH NSCD 8 1999-10-01 "GNU" "Linux Programmer's Manual"
+.\" 2008-12-05 Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
+.\"	Rewrite the NOTES section to reflect modern reality
+.\"
+.TH NSCD 8 2008-12-05 "GNU" "Linux Programmer's Manual"
 .SH NAME
 /usr/sbin/nscd \- name service cache daemon
 .SH DESCRIPTION
@@ -55,16 +58,29 @@ calls remain uncached as a result.
 .B "\-\-help"
 will give you a list with all options and what they do.
 .SH NOTES
-Nscd doesn't know anything about the underlying protocols for a
-service.
-This also means, that if you change
-.I /etc/resolv.conf
-for DNS queries, nscd will continue to use the old one if you have
-configured
-.I /etc/nsswitch.conf
-to use DNS for host lookups.
-In such a case, you need to restart
-nscd.
+The daemon will try to watch for changes in configuration files
+appropriate for each database (e.g.
+.I /etc/passwd
+for the
+.I passwd
+database or
+.IR "/etc/hosts " and " /etc/resolv.conf"
+for the
+.I hosts
+database) and flush the cache when these are changed.
+However, this will happen only after a short delay
+(unless the
+.BR inotify (7)
+mechanism is available and glibc-2.9 or newer is used)
+and this auto-detection does not cover configuration files
+required by non-standard NSS modules, if any are specified in
+.IR /etc/nsswitch.conf .
+In that case, you need to call
+.I nscd -i DATABASE
+after changing the configuration file of the database
+so that
+.B nscd
+invalidates its cache.
 .SH "SEE ALSO"
 .BR nscd.conf (5),
 .BR nsswitch.conf (5)
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] nscd.8: Correct NOTES section on reloading configuration files

[Michael Kerrisk]

Hi Petr,

On Fri, Dec 5, 2008 at 6:17 PM, Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org> wrote:
> The original notes were obsolete, current nscd watches changes in
> config files.

Can you provide some supporting information here.  Pointers to
relevant sources, or email threads.  I think what I'm really meaning
is: could you write a nice changelog entry for this patch.  Also, my
reading of the patch is that you are changing the page because glibc
changed at a certain point.  If this is the case, it would be good to
note in which glibc version the change occurred, and then it would be
better to rewrite the page to describe old and new behaviors, rather
than just dropping the text that describes the old behavior.  Do you
see what I mean?

Cheers,

Michael


> Signed-off-by: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
>
> diff --git a/man8/nscd.8 b/man8/nscd.8
> index ecbd9ba..987efcb 100644
> --- a/man8/nscd.8
> +++ b/man8/nscd.8
> @@ -17,7 +17,10 @@
>  .\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
>  .\" Boston, MA 02111-1307, USA.
>  .\"
> -.TH NSCD 8 1999-10-01 "GNU" "Linux Programmer's Manual"
> +.\" 2008-12-05 Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
> +.\"    Rewrite the NOTES section to reflect modern reality
> +.\"
> +.TH NSCD 8 2008-12-05 "GNU" "Linux Programmer's Manual"
>  .SH NAME
>  /usr/sbin/nscd \- name service cache daemon
>  .SH DESCRIPTION
> @@ -55,16 +58,29 @@ calls remain uncached as a result.
>  .B "\-\-help"
>  will give you a list with all options and what they do.
>  .SH NOTES
> -Nscd doesn't know anything about the underlying protocols for a
> -service.
> -This also means, that if you change
> -.I /etc/resolv.conf
> -for DNS queries, nscd will continue to use the old one if you have
> -configured
> -.I /etc/nsswitch.conf
> -to use DNS for host lookups.
> -In such a case, you need to restart
> -nscd.
> +The daemon will try to watch for changes in configuration files
> +appropriate for each database (e.g.
> +.I /etc/passwd
> +for the
> +.I passwd
> +database or
> +.IR "/etc/hosts " and " /etc/resolv.conf"
> +for the
> +.I hosts
> +database) and flush the cache when these are changed.
> +However, this will happen only after a short delay
> +(unless the
> +.BR inotify (7)
> +mechanism is available and glibc-2.9 or newer is used)
> +and this auto-detection does not cover configuration files
> +required by non-standard NSS modules, if any are specified in
> +.IR /etc/nsswitch.conf .
> +In that case, you need to call
> +.I nscd -i DATABASE
> +after changing the configuration file of the database
> +so that
> +.B nscd
> +invalidates its cache.
>  .SH "SEE ALSO"
>  .BR nscd.conf (5),
>  .BR nsswitch.conf (5)
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] nscd.8: Correct NOTES section on reloading configuration files

[Petr Baudis]

  Hi,

On Fri, Dec 05, 2008 at 06:49:09PM -0500, Michael Kerrisk wrote:
> On Fri, Dec 5, 2008 at 6:17 PM, Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org> wrote:
> > The original notes were obsolete, current nscd watches changes in
> > config files.
> 
> Can you provide some supporting information here.  Pointers to
> relevant sources, or email threads.

  nscd/connections.c, git log nscd/connections.c. ;-)

> I think what I'm really meaning
> is: could you write a nice changelog entry for this patch.  Also, my
> reading of the patch is that you are changing the page because glibc
> changed at a certain point.  If this is the case, it would be good to
> note in which glibc version the change occurred, and then it would be
> better to rewrite the page to describe old and new behaviors, rather
> than just dropping the text that describes the old behavior.  Do you
> see what I mean?

  It behaved this way at least since "Sun Oct 18 15:02:11 1998 +0000",
some four months after including the nscd implementation in glibc. But
there does seem to be a short window between glibc-2.1 and glibc-2.1.3
when nscd -i was not available, I don't think it's worth muddling the
point of the page with that, though.

-- 
				Petr "Pasky" Baudis
People who take cold baths never have rheumatism, but they have
cold baths.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH] nscd.8: Correct NOTES section on reloading configuration files

[Michael Kerrisk]

[CC+=Thorsten Kukuk <kukuk-l3A5Bk7waGM@public.gmane.org>, since he wrote the original page,
and may have some input to make as well]

Hi Petr,

On Fri, Dec 5, 2008 at 6:17 PM, Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org> wrote:
> The original notes were obsolete, current nscd watches changes in
> config files.

I've applied this for man-pages-3.16, with a few very small tweaks.

Thanks,

Michael

> Signed-off-by: Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
>
> diff --git a/man8/nscd.8 b/man8/nscd.8
> index ecbd9ba..987efcb 100644
> --- a/man8/nscd.8
> +++ b/man8/nscd.8
> @@ -17,7 +17,10 @@
>  .\" write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
>  .\" Boston, MA 02111-1307, USA.
>  .\"
> -.TH NSCD 8 1999-10-01 "GNU" "Linux Programmer's Manual"
> +.\" 2008-12-05 Petr Baudis <pasky-AlSwsSmVLrQ@public.gmane.org>
> +.\"    Rewrite the NOTES section to reflect modern reality
> +.\"
> +.TH NSCD 8 2008-12-05 "GNU" "Linux Programmer's Manual"
>  .SH NAME
>  /usr/sbin/nscd \- name service cache daemon
>  .SH DESCRIPTION
> @@ -55,16 +58,29 @@ calls remain uncached as a result.
>  .B "\-\-help"
>  will give you a list with all options and what they do.
>  .SH NOTES
> -Nscd doesn't know anything about the underlying protocols for a
> -service.
> -This also means, that if you change
> -.I /etc/resolv.conf
> -for DNS queries, nscd will continue to use the old one if you have
> -configured
> -.I /etc/nsswitch.conf
> -to use DNS for host lookups.
> -In such a case, you need to restart
> -nscd.
> +The daemon will try to watch for changes in configuration files
> +appropriate for each database (e.g.
> +.I /etc/passwd
> +for the
> +.I passwd
> +database or
> +.IR "/etc/hosts " and " /etc/resolv.conf"
> +for the
> +.I hosts
> +database) and flush the cache when these are changed.
> +However, this will happen only after a short delay
> +(unless the
> +.BR inotify (7)
> +mechanism is available and glibc-2.9 or newer is used)
> +and this auto-detection does not cover configuration files
> +required by non-standard NSS modules, if any are specified in
> +.IR /etc/nsswitch.conf .
> +In that case, you need to call
> +.I nscd -i DATABASE
> +after changing the configuration file of the database
> +so that
> +.B nscd
> +invalidates its cache.
>  .SH "SEE ALSO"
>  .BR nscd.conf (5),
>  .BR nsswitch.conf (5)
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html
Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html