1 '\" te
2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
3 .\" Copyright 2013 Nexenta Systems, Inc. All Rights Reserved.
4 .\" Copyright (c) 2013 by Delphix. All rights reserved.
5 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
7 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
8 .TH DUMPADM 1M "Feb 15, 2013"
9 .SH NAME
10 dumpadm \- configure operating system crash dump
11 .SH SYNOPSIS
12 .LP
13 .nf
14 \fB/usr/sbin/dumpadm\fR [\fB-nuy\fR] [\fB-c\fR \fIcontent-type\fR] [\fB-d\fR \fIdump-device\fR]
15 [\fB-m\fR \fImin\fRk | \fImin\fRm | \fImin\fR%] [\fB-s\fR \fIsavecore-dir\fR]
16 [\fB-r\fR \fIroot-dir\fR] [\fB-z\fR on | off]
17 .fi
18
19 .SH DESCRIPTION
20 .sp
21 .LP
22 The \fBdumpadm\fR program is an administrative command that manages the
23 configuration of the operating system crash dump facility. A crash dump is a
24 disk copy of the physical memory of the computer at the time of a fatal system
25 error. When a fatal operating system error occurs, a message describing the
26 error is printed to the console. The operating system then generates a crash
27 dump by writing the contents of physical memory to a predetermined dump device,
28 which is typically a local disk partition. The dump device can be configured by
29 way of \fBdumpadm\fR. Once the crash dump has been written to the dump device,
30 the system will reboot.
31 .sp
32 .LP
33 Fatal operating system errors can be caused by bugs in the operating system,
34 its associated device drivers and loadable modules, or by faulty hardware.
169 below for details of the algorithm used to select an appropriate swap entry.
170 When the system is first installed with a UFS root file system, \fBdumpadm\fR
171 uses the value for \fBswap\fR to determine the initial dump device setting. A
172 given ZFS volume cannot be configured for both the swap area and the dump
173 device.
174 .RE
175
176 .sp
177 .ne 2
178 .na
179 \fB\fBnone\fR\fR
180 .ad
181 .sp .6
182 .RS 4n
183 If the special token \fBnone\fR is specified, the active dump device is removed
184 and crash dumps are disabled.
185 .RE
186
187 .RE
188
189 .sp
190 .ne 2
191 .na
192 \fB\fB-m\fR \fImin\fR\fBk\fR | \fImin\fR\fBm\fR | \fImin\fR\fB%\fR\fR
193 .ad
194 .sp .6
195 .RS 4n
196 Create a \fBminfree\fR file in the current savecore directory indicating that
197 \fBsavecore\fR should maintain at least the specified amount of free space in
198 the file system where the savecore directory is located. The \fBmin\fR argument
199 can be one of the following:
200 .sp
201 .ne 2
202 .na
203 \fB\fBk\fR\fR
204 .ad
205 .sp .6
206 .RS 4n
207 A positive integer suffixed with the unit \fBk\fR specifying kilobytes.
208 .RE
|
1 '\" te
2 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
3 .\" Copyright 2015 Nexenta Systems, Inc. All Rights Reserved.
4 .\" Copyright (c) 2013 by Delphix. All rights reserved.
5 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
6 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
7 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
8 .TH DUMPADM 1M "Apr 09, 2015"
9 .SH NAME
10 dumpadm \- configure operating system crash dump
11 .SH SYNOPSIS
12 .LP
13 .nf
14 \fB/usr/sbin/dumpadm\fR [\fB-enuy\fR] [\fB-c\fR \fIcontent-type\fR] [\fB-d\fR \fIdump-device\fR]
15 [\fB-m\fR \fImin\fRk | \fImin\fRm | \fImin\fR%] [\fB-s\fR \fIsavecore-dir\fR]
16 [\fB-r\fR \fIroot-dir\fR] [\fB-z\fR on | off]
17 .fi
18
19 .SH DESCRIPTION
20 .sp
21 .LP
22 The \fBdumpadm\fR program is an administrative command that manages the
23 configuration of the operating system crash dump facility. A crash dump is a
24 disk copy of the physical memory of the computer at the time of a fatal system
25 error. When a fatal operating system error occurs, a message describing the
26 error is printed to the console. The operating system then generates a crash
27 dump by writing the contents of physical memory to a predetermined dump device,
28 which is typically a local disk partition. The dump device can be configured by
29 way of \fBdumpadm\fR. Once the crash dump has been written to the dump device,
30 the system will reboot.
31 .sp
32 .LP
33 Fatal operating system errors can be caused by bugs in the operating system,
34 its associated device drivers and loadable modules, or by faulty hardware.
169 below for details of the algorithm used to select an appropriate swap entry.
170 When the system is first installed with a UFS root file system, \fBdumpadm\fR
171 uses the value for \fBswap\fR to determine the initial dump device setting. A
172 given ZFS volume cannot be configured for both the swap area and the dump
173 device.
174 .RE
175
176 .sp
177 .ne 2
178 .na
179 \fB\fBnone\fR\fR
180 .ad
181 .sp .6
182 .RS 4n
183 If the special token \fBnone\fR is specified, the active dump device is removed
184 and crash dumps are disabled.
185 .RE
186
187 .RE
188
189 .sp
190 .ne 2
191 .na
192 \fB\fB-e\fR\fR
193 .ad
194 .sp .6
195 .RS 4n
196 Estimates the size of the dump for the current running system.
197 .RE
198
199 .sp
200 .ne 2
201 .na
202 \fB\fB-m\fR \fImin\fR\fBk\fR | \fImin\fR\fBm\fR | \fImin\fR\fB%\fR\fR
203 .ad
204 .sp .6
205 .RS 4n
206 Create a \fBminfree\fR file in the current savecore directory indicating that
207 \fBsavecore\fR should maintain at least the specified amount of free space in
208 the file system where the savecore directory is located. The \fBmin\fR argument
209 can be one of the following:
210 .sp
211 .ne 2
212 .na
213 \fB\fBk\fR\fR
214 .ad
215 .sp .6
216 .RS 4n
217 A positive integer suffixed with the unit \fBk\fR specifying kilobytes.
218 .RE
|