From owner-freebsd-doc  Fri Feb  8 18:30: 9 2002
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 6F15637B41C
	for <freebsd-doc@freebsd.org>; Fri,  8 Feb 2002 18:30:01 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.6/8.11.6) id g192U1d22038;
	Fri, 8 Feb 2002 18:30:01 -0800 (PST)
	(envelope-from gnats)
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
X-Send-Pr-Version: 3.113
Subject: docs/34743: nfsd(8) lacking signal explanation
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         34743
>Category:       docs
>Synopsis:       nfsd(8) lacking signal explanation
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Feb 08 18:30:01 PST 2002
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message