.\"
.\" $DragonFly: src/share/man/man5/kernconf.5,v 1.8 2008/07/16 01:02:07 thomas Exp $
.\"
-.Dd September 28, 2009
-.Os
+.Dd November 14, 2009
.Dt KERNCONF 5
+.Os
.Sh NAME
.Nm kernconf
.Nd kernel configuration file
The following keywords are recognized in a configuration file:
.Pp
.Bl -tag -width indent -compact
-.It Sy cpu Xo
-.Ar name
-.Xc
+.It Sy cpu Ar name
This system is to run on the CPU type
.Ar name .
Legal types are, for
.Tn ( x86-64 ) .
More than one CPU type specification can appear in a configuration file.
.Pp
-.It Sy device Xo
-.Ar name
-.Op Sy at Ar bus
-.Op Sy port Ar num
-.Op Sy irq Ar num
-.Op Sy drq Ar num
-.Op Sy iomem Ar num
-.Op Sy iosiz Ar num
-.Op Sy flags Ar num
-.Xc
+.It Sy device Ar name \
+Oo Sy at Ar bus Oc \
+Oo Sy port Ar num Oc \
+Oo Sy irq Ar num Oc \
+Oo Sy drq Ar num Oc \
+Oo Sy iomem Ar num Oc \
+Oo Sy iosiz Ar num Oc \
+Op Sy flags Ar num
Configures support for device
.Ar name .
Additional parameters may be passed to specify
-.Tm I/O
+.Tn I/O
configuration settings (most often for
.Xr isa 4
devices):
specifies a bus to which the device is attached.
.It Sy port
specifies the start address of
-.Tm I/O
+.Tn I/O
ports to be used by the device.
.It Sy irq
specifies the number of ports used by the device.
sets various flag bits for the device.
.El
.Pp
-.It Sy ident Xo
-.Ar string
-.Xc
+.It Sy ident Ar string
Sets the kernel identification string to
.Ar string .
.Pp
-.It Sy machine Xo
-.Ar name
-.Xc
+.It Sy machine Ar name
The system is to run on the machine type
.Ar name .
This is a legacy keyword, it is normally set to same value as
.Sy machine_arch .
.Pp
-.It Sy machine_arch Xo
-.Ar name
-.Xc
+.It Sy machine_arch Ar name
The system is to run on the machine architecture
.Ar name .
The legal architectures are
and
.Sy x86_64 .
.Pp
-.It Sy makeoptions Xo
-.Ar name Ns Sy = Ns Ar value
-.Xc
+.It Sy makeoptions Ar name Ns Sy = Ns Ar value
Defines a
.Xr make 1
macro
.Ar value
in the kernel Makefile.
.Pp
-.It Sy maxusers Xo
-.Ar integer
-.Xc
+.It Sy maxusers Ar integer
Set the
.Va maxusers
variable in the kernel.
.Pp
-.It Sy options Xo
-.Ar name Ns Op Sy = Ns Ar value
-.Xc
+.It Sy options Ar name Ns Op Sy = Ns Ar value
Sets the option
.Ar name .
Some options expect to be assigned a value, which may be an integer,
.\".Sx OPTIONS
.\"section.
.Pp
-.It Sy platform Xo
-.Ar name
-.Xc
+.It Sy platform Ar name
Sets the platform of this kernel to
.Ar name .
Legal platforms are
.Tn AMD
architecture, or a virtual kernel.
.Pp
-.It Sy pseudo-device Xo
-.Ar name
-.Op Ar N
-.Xc
+.It Sy pseudo-device Ar name Op Ar N
Includes support for the pseudo-device
.Ar name .
Some pseudo-devices can have multiple or
.\".Sh OPTIONS
.Sh FILES
.Bl -tag -width ".Pa /sys/config/X86_64_GENERIC"
-.It Pa /sys/config/LINT
-description of kernel configuration options
-.It Pa /sys/config/X86_64_GENERIC
-default
-.Sy x86_64
-kernel configuration file
.It Pa /sys/config/GENERIC
default
.Sy i386
kernel configuration file
+.It Pa /sys/config/LINT
+kernel configuration file for checking all the sources,
+includes description of kernel configuration options
.It Pa /sys/config/VKERNEL
default
.Xr vkernel 7
kernel configuration file
+.It Pa /sys/config/X86_64_GENERIC
+default
+.Sy x86_64
+kernel configuration file
.El
.Sh SEE ALSO
.Xr make 1 ,
.\" $FreeBSD: src/usr.sbin/config/config.8,v 1.21.2.7 2003/04/23 07:32:39 brueffer Exp $
.\" $DragonFly: src/usr.sbin/config/config.8,v 1.10 2008/07/10 00:46:57 thomas Exp $
.\"
-.Dd July 4, 2001
+.Dd November 14, 2009
.Dt CONFIG 8
.Os
.Sh NAME
.Bl -tag -width ".It Pa /sys/platform/ Ns Va PLATFORM Ns Pa /conf/Makefile" -compact
.It Pa /sys/conf/files
list of common files system is built from
-.It Pa /sys/platform/ Ns Va PLATFORM Ns Pa /conf/Makefile
-generic makefile for the
-.Va PLATFORM
-.It Pa /sys/platform/ Ns Va PLATFORM Ns Pa /conf/files
-list of
-.Va PLATFORM
-specific files
.It Pa /sys/config/ Ns Ar SYSTEM_NAME
default location for kernel configuration file
.It Pa /sys/config/GENERIC
-default kernel configuration file
+default
+.Sy i386
+kernel configuration file
+.It Pa /sys/config/LINT
+kernel configuration file for checking all the sources,
+includes description of kernel configuration options
.It Pa /sys/config/VKERNEL
default
.Xr vkernel 7
kernel configuration file
-.It Pa /sys/config/LINT
-kernel configuration file for checking all the sources
+.It Pa /sys/config/X86_64_GENERIC
+default
+.Sy x86_64
+kernel configuration file
.It Pa /sys/compile/ Ns Ar SYSTEM_NAME
default kernel build directory for system
-.Ar SYSTEM_NAME .
+.Ar SYSTEM_NAME
+.It Pa /sys/platform/ Ns Va PLATFORM Ns Pa /conf/Makefile
+generic makefile for the
+.Va PLATFORM
+.It Pa /sys/platform/ Ns Va PLATFORM Ns Pa /conf/files
+list of
+.Va PLATFORM
+specific files
.El
.Sh SEE ALSO
+.Xr gprof 1 ,
+.Xr kgdb 1 ,
+.Xr make 1 ,
.Xr kernconf 5 ,
.Xr build 7 ,
-.Xr vkernel 7
+.Xr vkernel 7 ,
+.Xr kgmon 8
.Pp
The
.Sx SYNOPSIS