[unix-history] / usr / src / sbin / mount_kernfs / mount_kernfs.8

.\"
.\" Copyright (c) 1992 The Regents of the University of California
.\" Copyright (c) 1990, 1992 Jan-Simon Pendry
.\" All rights reserved.
.\"
.\" This code is derived from software donated to Berkeley by
.\" Jan-Simon Pendry.
.\"
.\" %sccs.include.redist.roff%
.\"
.\"	@(#)mount_kernfs.8	5.2 (Berkeley) %G%
.\"
.\"
.Dd 
.Dt MOUNT_KERNFS 8
.Os BSD 4.4
.Sh NAME
.Nm mount_kernfs
.Nd mount the /kern file system
.Sh SYNOPSIS
.Nm mount_kernfs
.Op Fl F Ar fsoptions
.Pa /kern
.Pa mount_point
.Sh DESCRIPTION
The
.Nm mount_kern
command attaches an instance of the kernel parameter
namespace to the global filesystem namespace.
The conventional mount point is
.Pa /kern .
This command is normally executed by
.Xr mount 8
at boot time.
.Pp
The filesystem includes several regular files which can be read,
some of which can also be written.
The contents of the files is in a machine-independent format,
either a string, or an integer in decimal ASCII.
Where numbers are returned, a trailing newline character is also added.
.Sh FILES
.Bl -tag -width copyright -compact
.It Pa boottime
the time at which the system was last booted (decimal ASCII).
.It Pa copyright
kernel copyright message.
.It Pa hostname
the hostname, with a trailing newline.
The hostname can be changed by writing to this file.
A trailing newline will be stripped from the hostname being written.
.It Pa hz
the frequency of the system clock (decimal ASCII).
.It Pa loadavg
the 1, 5 and 15 minute load average in kernel fixed-point format.
The final integer is the fix-point scaling factor.
All numbers are in decimal ASCII.
.It Pa pagesize
the machine pagesize (decimal ASCII).
.It Pa physmem
the number of pages of physical memory in the machine (decimal ASCII).
.It Pa root
the system root directory.
In a chroot'ed environment,
.Nm
can be used to create a new
.Pa /kern
mount point.
.Pa /kern/root
will then refer to the system global root, not the current process root.
.It Pa rootdev
the root device.
.It Pa rrootdev
the raw root device.
.It Pa time
the second and microsecond value of the system clock.
Both numbers are in decimal ASCII.
.It Pa version
the kernel version string.
The head line for
.Pa /etc/motd
can be generated by running:
.Dq Ic "sed 1q /kern/version"
.El
.Sh SEE ALSO
.Xr mount 2 ,
.Xr unmount 2 ,
.Xr fstab 5
.Sh CAVEATS
This filesystem may not be NFS-exported.
.Sh HISTORY
The
.Nm
filesystem
is
.Ud
Commit	Line	Data
0fe35f8e JSP	1	.\"
	2	.\" Copyright (c) 1992 The Regents of the University of California
	3	.\" Copyright (c) 1990, 1992 Jan-Simon Pendry
	4	.\" All rights reserved.
	5	.\"
	6	.\" This code is derived from software donated to Berkeley by
	7	.\" Jan-Simon Pendry.
	8	.\"
	9	.\" %sccs.include.redist.roff%
	10	.\"
34b48aa6	11	.\" @(#)mount_kernfs.8 5.2 (Berkeley) %G%
0fe35f8e JSP	12	.\"
	13	.\"
	14	.Dd
	15	.Dt MOUNT_KERNFS 8
	16	.Os BSD 4.4
	17	.Sh NAME
	18	.Nm mount_kernfs
	19	.Nd mount the /kern file system
	20	.Sh SYNOPSIS
	21	.Nm mount_kernfs
	22	.Op Fl F Ar fsoptions
	23	.Pa /kern
	24	.Pa mount_point
	25	.Sh DESCRIPTION
	26	The
	27	.Nm mount_kern
	28	command attaches an instance of the kernel parameter
	29	namespace to the global filesystem namespace.
	30	The conventional mount point is
	31	.Pa /kern .
	32	This command is normally executed by
	33	.Xr mount 8
	34	at boot time.
	35	.Pp
34b48aa6 JSP	36	The filesystem includes several regular files which can be read,
	37	some of which can also be written.
	38	The contents of the files is in a machine-independent format,
	39	either a string, or an integer in decimal ASCII.
	40	Where numbers are returned, a trailing newline character is also added.
0fe35f8e	41	.Sh FILES
34b48aa6 JSP	42	.Bl -tag -width copyright -compact
	43	.It Pa boottime
	44	the time at which the system was last booted (decimal ASCII).
	45	.It Pa copyright
0fe35f8e	46	kernel copyright message.
34b48aa6 JSP	47	.It Pa hostname
	48	the hostname, with a trailing newline.
	49	The hostname can be changed by writing to this file.
	50	A trailing newline will be stripped from the hostname being written.
	51	.It Pa hz
	52	the frequency of the system clock (decimal ASCII).
	53	.It Pa loadavg
	54	the 1, 5 and 15 minute load average in kernel fixed-point format.
	55	The final integer is the fix-point scaling factor.
	56	All numbers are in decimal ASCII.
	57	.It Pa pagesize
	58	the machine pagesize (decimal ASCII).
	59	.It Pa physmem
	60	the number of pages of physical memory in the machine (decimal ASCII).
	61	.It Pa root
	62	the system root directory.
	63	In a chroot'ed environment,
	64	.Nm
	65	can be used to create a new
	66	.Pa /kern
	67	mount point.
	68	.Pa /kern/root
	69	will then refer to the system global root, not the current process root.
	70	.It Pa rootdev
0fe35f8e	71	the root device.
34b48aa6 JSP	72	.It Pa rrootdev
	73	the raw root device.
	74	.It Pa time
	75	the second and microsecond value of the system clock.
	76	Both numbers are in decimal ASCII.
	77	.It Pa version
0fe35f8e	78	the kernel version string.
34b48aa6 JSP	79	The head line for
	80	.Pa /etc/motd
	81	can be generated by running:
	82	.Dq Ic "sed 1q /kern/version"
0fe35f8e JSP	83	.El
	84	.Sh SEE ALSO
	85	.Xr mount 2 ,
	86	.Xr unmount 2 ,
	87	.Xr fstab 5
	88	.Sh CAVEATS
	89	This filesystem may not be NFS-exported.
	90	.Sh HISTORY
	91	The
	92	.Nm
	93	filesystem
	94	is
	95	.Ud