Make the examples fit into 80 columns. Use .Tn.

This commit is contained in:
jruoho 2010-04-21 02:59:29 +00:00
parent 0c6d62cfe9
commit 3ae479ecfd
1 changed files with 40 additions and 16 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: cmos.4,v 1.6 2009/10/19 23:19:38 rmind Exp $
.\" $NetBSD: cmos.4,v 1.7 2010/04/21 02:59:29 jruoho Exp $
.\"
.\" Copyright (c) 2007 David Young. All rights reserved.
.\"
@ -27,7 +27,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd February 5, 2007
.Dd April 21, 2010
.Dt CMOS 4 i386
.Os
.Sh NAME
@ -36,13 +36,23 @@
.Sh SYNOPSIS
.Cd pseudo-device cmos
.Sh DESCRIPTION
Use
The
.Nm
to read the real-time clock and ISA configuration data from an
ISA-compatible CMOS RAM, and to write the ISA configuration data.
pseudo-device can be used to read the real-time clock and
.Tn ISA
configuration data from an ISA-compatible
.Tn CMOS
.Tn RAM ,
and to write the
.Tn ISA
configuration data.
.Pp
A program reads between 0 and 48 bytes from the CMOS RAM, starting at
byte 0 of the RAM, using a single call to
A program reads between 0 and 48 bytes from the
.Tn CMOS
.Tn RAM , starting at
byte 0 of the
.Tn RAM ,
using a single call to
.Xr read 2 .
Likewise, a program writes between 0 and 48 bytes to the CMOS RAM,
starting at byte 0 of the RAM, using a single call to
@ -51,16 +61,24 @@ starting at byte 0 of the RAM, using a single call to
.Nm
does not allow programs to overwrite the real-time clock data
(bytes 0 through 9), the status registers (10 through 13),
the diagnostic status or CMOS shutdown status (bytes 14 and 15),
or the CMOS checksum (bytes 46 and 47).
the diagnostic status or
.Tn CMOS
shutdown status (bytes 14 and 15),
or the
.Tn CMOS
checksum (bytes 46 and 47).
Writes to those bytes are ignored.
.Pp
On writes,
.Nm
recomputes the CMOS checksum and writes it to the CMOS RAM.
recomputes the
.Tn CMOS
checksum and writes it to the
.Tn CMOS
.Tn RAM .
.Sh EXAMPLES
Display entire contents of CMOS RAM:
.Bd -literal -offset indent
.Bd -literal -offset 2n
# dd if=/dev/cmos bs=48 count=1 | od -t x1
0000000 37 00 09 00 22 00 06 13 04 80 26 02 50 80 00 00
0000020 00 51 f0 00 01 80 02 00 fc 0f 2f 00 00 00 00 00
@ -68,9 +86,14 @@ Display entire contents of CMOS RAM:
0000060
.Ed
.Pp
Change boot order on Soekris net4521 to PXE ROM, Primary HDD,
Secondary HDD:
.Bd -literal -offset indent
Change boot order on Soekris net4521 to
.Tn PXE
.Tn ROM ,
Primary
.Tn HDD ,
Secondary
.Tn HDD :
.Bd -literal -offset 2n
# dd if=/dev/cmos of=/tmp/cmos0 bs=48 count=1
1+0 records in
1+0 records out
@ -88,12 +111,13 @@ Secondary HDD:
.Sh ERRORS
A program can read or write no more than 48 bytes to
.Nm .
Both
.Xr read 2
/
and
.Xr write 2
will return
.Er EINVAL
if more than 48 bytes are read / written at once.
if more than 48 bytes are read or written at once.
.Sh AUTHORS
The original
.Nm