1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-10-19 02:29:40 +00:00

kgzip.8: note that it is deprecated and clarify BUGS section

kgzip is only useful on i386 and has a number of other limitations.
We're better served by officially deprecating it and encouraging users
to use loader(8) instead.

Reviewed by:	dteske, wblock
Differential Revision:	https://reviews.freebsd.org/D7098
This commit is contained in:
Ed Maste 2016-08-02 21:48:26 +00:00
parent 72a3cf0f41
commit bfbeda91fe
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=303682

View File

@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
.Dd July 19, 1999
.Dd August 2, 2016
.Dt KGZIP 8
.Os
.Sh NAME
@ -38,6 +38,14 @@
.Op Fl o Ar output
.Ar file
.Sh DESCRIPTION
.Bf -symbolic
This utility is deprecated.
Users are advised to use
.Xr loader 8
and compress the kernel with
.Xr gzip 1 .
.Ef
.Pp
The
.Nm
utility compresses a kernel or some other bootable binary.
@ -137,7 +145,12 @@ The default loader
As symbols are lost, the usefulness of this utility for compressing
kernels is limited to situations where
.Xr loader 8
cannot be used; otherwise the preferred method of compressing a kernel
cannot be used.
.Pp
.Pa kgzldr.o
is only available for the i386 and pc98 architectures.
.Pp
The preferred method of compressing a kernel
is simply to
.Xr gzip 1
it.