dumpon.8 (c2c014f24c10f90d85126ac5fbd4d8524de32b1c) dumpon.8 (6026dcd7ca888f3433f4df34ede69a77c1eb7701)
1.\" Copyright (c) 1980, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 14 unchanged lines hidden (view full) ---

23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\" From: @(#)swapon.8 8.1 (Berkeley) 6/5/93
29.\" $FreeBSD$
30.\"
1.\" Copyright (c) 1980, 1991, 1993
2.\" The Regents of the University of California. All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\" notice, this list of conditions and the following disclaimer.

--- 14 unchanged lines hidden (view full) ---

23.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26.\" SUCH DAMAGE.
27.\"
28.\" From: @(#)swapon.8 8.1 (Berkeley) 6/5/93
29.\" $FreeBSD$
30.\"
31.Dd October 24, 2017
31.Dd February 13, 2018
32.Dt DUMPON 8
33.Os
34.Sh NAME
35.Nm dumpon
36.Nd "specify a device for crash dumps"
37.Sh SYNOPSIS
38.Nm
39.Op Fl v
40.Op Fl k Ar public_key_file
41.Op Fl z
32.Dt DUMPON 8
33.Os
34.Sh NAME
35.Nm dumpon
36.Nd "specify a device for crash dumps"
37.Sh SYNOPSIS
38.Nm
39.Op Fl v
40.Op Fl k Ar public_key_file
41.Op Fl z
42.Op Fl Z
42.Ar special_file
43.Nm
44.Op Fl v
45.Cm off
46.Nm
47.Op Fl v
48.Fl l
49.Sh DESCRIPTION

--- 61 unchanged lines hidden (view full) ---

111.Xr rc 8
112script.
113This flag requires a kernel compiled with the
114.Dv EKCD
115kernel option.
116.Pp
117The
118.Fl z
43.Ar special_file
44.Nm
45.Op Fl v
46.Cm off
47.Nm
48.Op Fl v
49.Fl l
50.Sh DESCRIPTION

--- 61 unchanged lines hidden (view full) ---

112.Xr rc 8
113script.
114This flag requires a kernel compiled with the
115.Dv EKCD
116kernel option.
117.Pp
118The
119.Fl z
119option configures the kernel to compress the dump in gzip format before writing
120it to the dump device.
120and
121.Fl Z
122options configure the kernel to compress the dump before writing it to
123the dump device.
121This reduces the amount of space required for the dump and accelerates
122recovery with
123.Xr savecore 8
124since less data needs to be copied from the dump device.
125When compression is enabled, the
126.Nm
127utility will not verify that the dump device is sufficiently large for a full
128dump.
124This reduces the amount of space required for the dump and accelerates
125recovery with
126.Xr savecore 8
127since less data needs to be copied from the dump device.
128When compression is enabled, the
129.Nm
130utility will not verify that the dump device is sufficiently large for a full
131dump.
129This flag requires a kernel compiled with the
132The
133.Fl z
134and
135.Fl Z
136options cause the dump to be written in
137.Xr gzip 1
138and
139.Xr zstd 1
140format, respectively.
141These flags require a kernel compiled with the
130.Dv GZIO
142.Dv GZIO
131kernel option.
143or
144.Dv ZSTDIO
145kernel options.
132.Pp
146.Pp
147.Pp
133The
134.Fl l
135flag causes
136.Nm
137to print the current dump device or _PATH_DEVNULL ("/dev/null") if no device is
138configured.
139.Pp
140The

--- 123 unchanged lines hidden (view full) ---

264or shorter:
265.Pp
266.Dl # kgdb -n # /usr/obj/sys/GENERIC/kernel.debug
267.Pp
268The core was decrypted properly if
269.Xr kgdb 1
270does not print any errors.
271.Sh SEE ALSO
148The
149.Fl l
150flag causes
151.Nm
152to print the current dump device or _PATH_DEVNULL ("/dev/null") if no device is
153configured.
154.Pp
155The

--- 123 unchanged lines hidden (view full) ---

279or shorter:
280.Pp
281.Dl # kgdb -n # /usr/obj/sys/GENERIC/kernel.debug
282.Pp
283The core was decrypted properly if
284.Xr kgdb 1
285does not print any errors.
286.Sh SEE ALSO
287.Xr gzip 1 ,
272.Xr kgdb 1 ,
288.Xr kgdb 1 ,
289.Xr zstd 1 ,
273.Xr ddb 4 ,
274.Xr fstab 5 ,
275.Xr rc.conf 5 ,
276.Xr config 8 ,
290.Xr ddb 4 ,
291.Xr fstab 5 ,
292.Xr rc.conf 5 ,
293.Xr config 8 ,
294.Xr decryptcore 8 ,
277.Xr init 8 ,
278.Xr loader 8 ,
279.Xr rc 8 ,
295.Xr init 8 ,
296.Xr loader 8 ,
297.Xr rc 8 ,
280.Xr decryptcore 8 ,
281.Xr savecore 8 ,
282.Xr swapon 8 ,
283.Xr panic 9
284.Sh HISTORY
285The
286.Nm
287utility appeared in
288.Fx 2.0.5 .
289.Sh BUGS
290Because the file system layer is already dead by the time a crash dump
291is taken, it is not possible to send crash dumps directly to a file.
292.Pp
293It is currently not possible to configure both compression and encryption.
294The encrypted dump format assumes that the kernel dump size is a multiple
295of the cipher block size, which may not be true when the dump is compressed.
298.Xr savecore 8 ,
299.Xr swapon 8 ,
300.Xr panic 9
301.Sh HISTORY
302The
303.Nm
304utility appeared in
305.Fx 2.0.5 .
306.Sh BUGS
307Because the file system layer is already dead by the time a crash dump
308is taken, it is not possible to send crash dumps directly to a file.
309.Pp
310It is currently not possible to configure both compression and encryption.
311The encrypted dump format assumes that the kernel dump size is a multiple
312of the cipher block size, which may not be true when the dump is compressed.