[src/trunk]: src/sbin/savecore Document more explicitly that the kernel must ...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/f14a41119716
branches:  trunk
changeset: 514043:f14a41119716
user:      wiz <wiz%NetBSD.org@localhost>
date:      Mon Aug 20 14:23:59 2001 +0000

description:
Document more explicitly that the kernel must be `secure' according to
secure_path to be used automatically. (Of course, you can override with the
-N option.)
Addresses bin/13665.

diffstat:

 sbin/savecore/savecore.8 |  20 +++++++++++++++-----
 1 files changed, 15 insertions(+), 5 deletions(-)

diffs (61 lines):

diff -r 5e93aceaeeeb -r f14a41119716 sbin/savecore/savecore.8
--- a/sbin/savecore/savecore.8  Mon Aug 20 13:53:47 2001 +0000
+++ b/sbin/savecore/savecore.8  Mon Aug 20 14:23:59 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: savecore.8,v 1.21 2001/06/13 23:24:32 wiz Exp $
+.\"    $NetBSD: savecore.8,v 1.22 2001/08/20 14:23:59 wiz Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -38,7 +38,7 @@
 .Os
 .Sh NAME
 .Nm savecore
-.Nd "save a core dump of the operating system"
+.Nd save a core dump of the operating system
 .Sh SYNOPSIS
 .Nm
 .Fl c
@@ -103,6 +103,15 @@
 .Ar system
 as the kernel instead of the default (returned by
 .Xr getbootfile 3 ) .
+Note that 
+.Xr getbootfile 3
+uses
+.Xr secure_path 3
+to check that kernel file is
+.Dq secure
+and will default to
+.Pa /netbsd
+if the check fails.
 .It Fl v
 Prints out some additional debugging information.
 .It Fl z
@@ -132,12 +141,12 @@
 .Pp
 .Nm
 also checks the available disk space before attempting to make the copies.
-If there is insufficient disk space in the filesystem containing
+If there is insufficient disk space in the file system containing
 .Ar directory ,
 or if the file
 .Ar directory Ns Pa /minfree
 exists and the number of free kilobytes (for non-superusers) in the
-filesystem after the copies were made would be less than the number
+file system after the copies were made would be less than the number
 in the first line of this file, the copies are not attempted.
 .Pp
 If
@@ -152,9 +161,10 @@
 .Xr fstat 1 ,
 .Xr gdb 1 ,
 .Xr gzip 1 ,
-.Xr send-pr 1 ,
 .Xr netstat 1 ,
 .Xr ps 1 ,
+.Xr send-pr 1 ,
+.Xr secure_path 3 ,
 .Xr dmesg 8 ,
 .Xr iostat 8 ,
 .Xr pstat 8 ,