Differential D1832 Diff 4152 head/share/man/man5/core.5

Changeset View

Standalone View

head/share/man/man5/core.5

	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.
	.\"			.\"
	.\" @(#)core.5 8.3 (Berkeley) 12/11/93			.\" @(#)core.5 8.3 (Berkeley) 12/11/93
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd November 22, 2012			.Dd March 8, 2015
	.Dt CORE 5			.Dt CORE 5
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm core			.Nm core
	.Nd memory image file format			.Nd memory image file format
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.In sys/param.h			.In sys/param.h
	.Sh DESCRIPTION			.Sh DESCRIPTION
	▲ Show 20 Lines • Show All 56 Lines • ▼ Show 20 Lines
	real or effective will not create a corefile.			real or effective will not create a corefile.
	This behaviour can be			This behaviour can be
	changed to generate a core dump by setting the			changed to generate a core dump by setting the
	.Xr sysctl 8			.Xr sysctl 8
	variable			variable
	.Va kern.sugid_coredump			.Va kern.sugid_coredump
	to 1.			to 1.
	.Pp			.Pp
	Corefiles can be compressed by the kernel if the following items			Corefiles can be compressed by the kernel if the following item
	are included in the kernel configuration file:			is included in the kernel configuration file:
	.Bl -tag -width "1234567890" -compact -offset "12345"			.Bl -tag -width "1234567890" -compact -offset "12345"
	.It options			.It options
	COMPRESS_USER_CORES			GZIO
	.It devices
	gzio
	.El			.El
	.Pp			.Pp
	When COMPRESS_USER_CORES is included the following sysctls can control			When the GZIO option is included, the following sysctls control whether core
	if core files will be compressed:			files will be compressed:
	.Bl -tag -width "kern.compress_user_cores_gzlevel" -compact -offset "12345"			.Bl -tag -width "kern.compress_user_cores_gzlevel" -compact -offset "12345"
	.It Em kern.compress_user_cores_gzlevel			.It Em kern.compress_user_cores_gzlevel
	Gzip compression level.			Gzip compression level.
	Defaults to -1.			Defaults to 6.
	.It Em kern.compress_user_cores			.It Em kern.compress_user_cores
	Actually compress user cores.			Actually compress user cores.
	Core files will have the suffix			Compressed core files will have a suffix of
	.Em .gz			.Ql .gz
	appended to them.			appended to them.
	.El			.El
	.Sh EXAMPLES			.Sh EXAMPLES
	In order to store all core images in per-user private areas under			In order to store all core images in per-user private areas under
	.Pa /var/coredumps ,			.Pa /var/coredumps ,
	the following			the following
	.Xr sysctl 8			.Xr sysctl 8
	command can be used:			command can be used:
	Show All 13 Lines