Differential D4712 Diff 15199 sbin/savecore/savecore.8

Changeset View

Standalone View

sbin/savecore/savecore.8

	Show All 22 Lines
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" 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			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" From: @(#)savecore.8 8.1 (Berkeley) 6/5/93			.\" From: @(#)savecore.8 8.1 (Berkeley) 6/5/93
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd December 1, 2015			.Dd December 1, 2015
				delphijUnsubmitted Not Done Inline Actions Should be bumped when committed. delphij: Should be bumped when committed.
				defAuthorUnsubmitted Not Done Inline Actions Ok. def: Ok.
	.Dt SAVECORE 8			.Dt SAVECORE 8
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm savecore			.Nm savecore
	.Nd "save a core dump of the operating system"			.Nd "save a core dump of the operating system"
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Fl c			.Fl c
	▲ Show 20 Lines • Show All 74 Lines • ▼ Show 20 Lines
	The			The
	.Nm			.Nm
	utility			utility
	checks the core dump in various ways to make sure that it is complete.			checks the core dump in various ways to make sure that it is complete.
	If it passes these checks, it saves the core image in			If it passes these checks, it saves the core image in
	.Ar directory Ns Pa /vmcore.#			.Ar directory Ns Pa /vmcore.#
	and information about the core in			and information about the core in
	.Ar directory Ns Pa /info.# .			.Ar directory Ns Pa /info.# .
				If the core is encrypted, it saves the dump key in
				.Ar directory Ns Pa /key.# .
				The core can be later decrypted using
				.Xr decryptcore 8 .
	For kernel textdumps generated with the			For kernel textdumps generated with the
	.Xr textdump 4			.Xr textdump 4
	facility, output will be stored in the			facility, output will be stored in the
	.Xr tar 5			.Xr tar 5
	format and named			format and named
	.Ar directory Ns Pa /textdump.tar.# .			.Ar directory Ns Pa /textdump.tar.# .
	The			The
	.Dq #			.Dq #
	Show All 31 Lines
	.Xr rc 8 ) .			.Xr rc 8 ) .
	.Sh SEE ALSO			.Sh SEE ALSO
	.Xr gzip 1 ,			.Xr gzip 1 ,
	.Xr getbootfile 3 ,			.Xr getbootfile 3 ,
	.Xr libxo 3 ,			.Xr libxo 3 ,
	.Xr xo_parse_args 3 ,			.Xr xo_parse_args 3 ,
	.Xr textdump 4 ,			.Xr textdump 4 ,
	.Xr tar 5 ,			.Xr tar 5 ,
				.Xr decryptcore 8 ,
	.Xr dumpon 8 ,			.Xr dumpon 8 ,
	.Xr syslogd 8			.Xr syslogd 8
	.Sh HISTORY			.Sh HISTORY
	The			The
	.Nm			.Nm
	utility appeared in			utility appeared in
	.Bx 4.1 .			.Bx 4.1 .
	.Pp			.Pp
	Support for kernel textdumps appeared in			Support for kernel textdumps appeared in
	.Fx 7.1 .			.Fx 7.1 .
	.Sh BUGS			.Sh BUGS
	The minfree code does not consider the effect of compression or sparse files.			The minfree code does not consider the effect of compression or sparse files.