From 83f9dfab4d40f9a96a2fd190e705784ced2a961b Mon Sep 17 00:00:00 2001 From: Garrett Wollman Date: Fri, 12 May 1995 19:10:09 +0000 Subject: [PATCH] My utility to specify where you want crash dumps to go. More user and kernel support to follow. --- sbin/dumpon/Makefile | 6 ++ sbin/dumpon/dumpon.8 | 101 +++++++++++++++++++++++++++++++++ sbin/dumpon/dumpon.c | 129 +++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 236 insertions(+) create mode 100644 sbin/dumpon/Makefile create mode 100644 sbin/dumpon/dumpon.8 create mode 100644 sbin/dumpon/dumpon.c diff --git a/sbin/dumpon/Makefile b/sbin/dumpon/Makefile new file mode 100644 index 000000000000..da6f36506679 --- /dev/null +++ b/sbin/dumpon/Makefile @@ -0,0 +1,6 @@ +# $Id$ + +PROG= dumpon +MAN8= dumpon.8 + +.include diff --git a/sbin/dumpon/dumpon.8 b/sbin/dumpon/dumpon.8 new file mode 100644 index 000000000000..7a1593be22d0 --- /dev/null +++ b/sbin/dumpon/dumpon.8 @@ -0,0 +1,101 @@ +.\" Copyright (c) 1980, 1991, 1993 +.\" The Regents of the University of California. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by the University of +.\" California, Berkeley and its contributors. +.\" 4. Neither the name of the University nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" From: @(#)swapon.8 8.1 (Berkeley) 6/5/93 +.\" $Id$ +.\" +.Dd May 12, 1995 +.Dt DUMPON 8 +.Os FreeBSD 2.1 +.Sh NAME +.Nm dumpon +.Nd "specify a device for crash dumps" +.Sh SYNOPSIS +.Nm dumpon +.Op Fl v +.Ar special_file +.Sh DESCRIPTION +.Nm Dumpon +is used to specify a device where the kernel can save a crash dump in +the case of a panic. +The system begins with no dump area configured for safety, unless a +.Dq dumps on +clause was specified in the input to +.Xr config 8 . +The dump device must be one of the swap areas +specified in the configuration file, and it must be at least the size +of physical memory. +Calls to +.Nm dumpon +normally occur in the system multi-user initialization file +.Pa /etc/rc , +before the +.Xr savecore 8 +program is run. +The +.Fl v +flag can be specified to cause the +.Nm +program to be verbose about its activity. +.Pp +The +.Nm +program operates by setting the +.Xr sysctl 3 +MIB variable +.Dq kern.dumpdev +to the device number of the designated +.Ar special_file +or to +.Dv NODEV +(meaning that no dumps are to be taken) if +.Ar special_file +is the text string +.Dq Li off . +.Sh SEE ALSO +.Xr dumpon 2 , +.Xr init 8 , +.Xr rc 8 , +.Xr savecore 8 +.Sh FILES +.Bl -tag -width /dev/[ws]d?b -compact +.It Pa /dev/[ws]d?b +standard paging devices +.El +.Sh BUGS +Because the filesystem layer is already dead by the time a crash dump +is taken, it is not possible to send crash dumps directly to a file. +.Sh HISTORY +The +.Nm +command appeared in +.Tn FreeBSD +2.1. diff --git a/sbin/dumpon/dumpon.c b/sbin/dumpon/dumpon.c new file mode 100644 index 000000000000..649a73a991af --- /dev/null +++ b/sbin/dumpon/dumpon.c @@ -0,0 +1,129 @@ +/* + * Copyright (c) 1980, 1993 + * The Regents of the University of California. All rights reserved. + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * 1. Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * 2. Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in the + * documentation and/or other materials provided with the distribution. + * 3. All advertising materials mentioning features or use of this software + * must display the following acknowledgement: + * This product includes software developed by the University of + * California, Berkeley and its contributors. + * 4. Neither the name of the University nor the names of its contributors + * may be used to endorse or promote products derived from this software + * without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND + * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE + * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE + * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE + * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL + * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS + * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) + * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT + * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY + * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF + * SUCH DAMAGE. + */ + +#ifndef lint +static char copyright[] = +"@(#) Copyright (c) 1980, 1993\n\ + The Regents of the University of California. All rights reserved.\n"; +#endif /* not lint */ + +#ifndef lint +/*static char sccsid[] = "From: @(#)swapon.c 8.1 (Berkeley) 6/5/93";*/ +static const char rcsid[] = + "$Id$"; +#endif /* not lint */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +void usage __P((void)) __dead2; +static char *whoami; + +int +main(int argc, char **argv) +{ + extern char *optarg; + extern int optind; + int ch, verbose, rv; + struct stat stab; + int mib[2]; + + verbose = rv = 0; + whoami = argv[0]; + while ((ch = getopt(argc, argv, "v")) != EOF) + switch((char)ch) { + case 'v': + verbose = 1; + break; + case '?': + default: + usage(); + } + argv += optind; + + if (!argv[0] || argv[1]) + usage(); + + if (strcmp(argv[0], "off")) { + rv = stat(argv[0], &stab); + if (rv) { + err(EX_OSFILE, "%s", argv[0]); + } + + if (!S_ISBLK(stab.st_mode)) { + errx(EX_USAGE, "%s: must specify a block device", + argv[0]); + } + } else { + stab.st_rdev = NODEV; + } + + mib[0] = CTL_KERN; + mib[1] = KERN_DUMPDEV; + + rv = sysctl(mib, 2, (void *)0, (size_t *)0, &stab.st_rdev, + sizeof stab.st_rdev); + if (rv) { + err(EX_OSERR, "sysctl: kern.dumpdev"); + } + + if (verbose) { + if (stab.st_rdev == NODEV) { + printf("%s: crash dumps disabled\n", whoami); + } else { + printf("%s: crash dumps to %s (%lu, %lu)\n", + whoami, argv[0], + (unsigned long)major(stab.st_rdev), + (unsigned long)minor(stab.st_rdev)); + } + } + + return 0; +} + +void +usage() +{ + fprintf(stderr, + "usage: %s [-v] special_file\n" + " %s [-v] off\n", whoami, whoami); + exit(EX_USAGE); +}