From gordont@gnf.org  Fri Feb  8 18:22:50 2002
Return-Path: <gordont@gnf.org>
Received: from relay.gnf.org (relay.gnf.org [208.44.31.36])
	by hub.freebsd.org (Postfix) with ESMTP id 3384637B419
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  8 Feb 2002 18:22:42 -0800 (PST)
Received: from mail.gnf.org (smtp.gnf.org [10.0.0.11])
	by relay.gnf.org (8.11.6/8.11.6) with ESMTP id g192Mgw06086
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 8 Feb 2002 18:22:42 -0800
Received: from fountainhead.gnf.org (fountainhead.gnf.org [10.0.200.10])
	by mail.gnf.org (Postfix) with ESMTP id B6DDD11E511
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  8 Feb 2002 18:20:12 -0800 (PST)
Received: (from gordont@localhost)
	by fountainhead.gnf.org (8.11.6/8.11.6) id g192IgA22013;
	Fri, 8 Feb 2002 18:18:42 -0800 (PST)
	(envelope-from gordont)
Message-Id: <200202090218.g192IgA22013@fountainhead.gnf.org>
Date: Fri, 8 Feb 2002 18:18:42 -0800 (PST)
From: Gordon Tetlow <gordont@gnf.org>
To: FreeBSD-gnats-submit@freebsd.org
Subject: nfsd(8) lacking signal explanation
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         34743
>Category:       docs
>Synopsis:       nfsd(8) lacking signal explanation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gordon
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Feb 08 18:30:01 PST 2002
>Closed-Date:    Thu May 23 15:48:58 PDT 2002
>Last-Modified:  Thu May 23 15:48:58 PDT 2002
>Originator:     Gordon Tetlow
>Release:        FreeBSD 4.4-STABLE i386
>Organization:
Novartis Institute of Functional Genomics
>Environment:
System: FreeBSD fountainhead.gnf.org 4.4-STABLE FreeBSD 4.4-STABLE #1: Tue Oct 16 19:33:20 PDT 2001 gordont@fountainhead.gnf.org:/local/usr.obj/usr/src/sys/FOUNTAINHEAD i386

>Description:
        nfsd(8) in -STABLE doesn't explain that you can use kill -USR1 to kill
        nfsd. -CURRENT has it documented, it's just never been MFC'd
>How-To-Repeat:
	man nfsd
>Fix:

Here is a partial MFC of /usr/src/sbin/nfsd/nfsd.8 1.14

--- nfsd.8.orig	Mon Feb  4 11:14:58 2002
+++ nfsd.8	Mon Feb  4 11:17:10 2002
@@ -147,6 +147,22 @@
 would then be used to block nfs-related packets that come in on the outside
 interface.
 .Pp
+.Nm
+has to be terminated with
+.Dv SIGUSR1
+and cannot be killed with
+.Dv SIGTERM
+or
+.Dv SIGQUIT .
+.Nm
+needs to ignore these signals in order to stay alive as long
+as possible during a shutdown, otherwise loopback mounts will
+not be able to unmount.
+If you have to kill
+.Nm
+just do a
+.Dq Li "kill -USR1 <PID of master nfsd>"
+.Pp
 The
 .Nm
 utility exits 0 on success, and >0 if an error occurs.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->feedback 
State-Changed-By: gordon 
State-Changed-When: Mon May 20 00:12:07 PDT 2002 
State-Changed-Why:  
Take over pr now that I'm a committer. Sent a request to re@ for the MFC. 


Responsible-Changed-From-To: freebsd-doc->gordon 
Responsible-Changed-By: gordon 
Responsible-Changed-When: Mon May 20 00:12:07 PDT 2002 
Responsible-Changed-Why:  
Take over pr now that I'm a committer. Sent a request to re@ for the MFC. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=34743 
State-Changed-From-To: feedback->closed 
State-Changed-By: gordon 
State-Changed-When: Thu May 23 15:48:18 PDT 2002 
State-Changed-Why:  
Committed enclosed patch. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=34743 
>Unformatted:
