cleaned up; new section on newer models

1 files changed, 130 insertions, 13 deletions

diff --git a/share/man/man4/man4.vax/cons.4 b/share/man/man4/man4.vax/cons.4
index c0a3aeccf90..4faad273a17 100644
--- a/share/man/man4/man4.vax/cons.4
+++ b/share/man/man4/man4.vax/cons.4
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cons.4,v 1.3 1999/06/05 13:18:37 aaron Exp $
+.\"	$OpenBSD: cons.4,v 1.4 2000/07/22 04:56:12 bjc Exp $
 .\"
 .\" Copyright (c) 1980, 1991 Regents of the University of California.
 .\" All rights reserved.
@@ -38,18 +38,21 @@
 .Os
 .Sh NAME
 .Nm cons
-.Nd "VAX-11 console interface"
+.Nd "VAX console interface"
 .Sh DESCRIPTION
 The console is available to the processor through the console registers.
 It acts like a normal terminal, except that when the local functions are
-not disabled,
-.Ic \&^P
-(control-P) puts the console in local console mode (where
-the prompt is
-.Sq Li >>> ) .
+not disabled, a special command character puts the console in local console
+mode.  The character itself is dependent upon the model of VAX and the 
+type of console in use.  The prompt in console mode is
+.Sq Li >>> ,
+also called the
+.Sq chevron
+prompt.
+
 The operation of the console in this mode varies
-slightly per-processor.
-.Ss Tn VAX No 11/780 or 785
+among different VAX models.  
+.Ss VAX-11/780 or 785
 On either the
 .Tn VAX
 11/780 or 785 the following commands may be used
@@ -88,7 +91,7 @@ will go into
 (console debugger mode).
 .El
 .Pp
-.Ss Tn VAX No 11/750 or 11/730
+.Ss VAX-11/750 or 11/730
 On an 11/750
 or an 11/730
 the processor is halted whenever the console is not in conversational mode.
@@ -107,10 +110,10 @@ When in console mode on an 11/750 which has a remote diagnosis module,
 a
 .Ic \&^D
 will put you in remote diagnosis mode, where the prompt will be
-.ql RDM> .
+.Ql RDM> .
 .El
 .Pp
-.Ss Tn VAX No 8600 or 8650
+.Ss VAX 8600 or 8650
 The
 .Tn VAX
 8600 (8650) console normally works in the same way as the 11/750,
@@ -130,8 +133,122 @@ debug enabled.
 .It Ic p
 Halt the processor if in normal mode.
 .El
+.Ss VAX 4000, MicroVAX, VAXstation, others
+If the console is a serial console, sending a break will likely cause the
+machine to halt and enter console mode. The set of commands available at 
+the console varies from machine to machine, although there are several 
+commands which are common to most or all models.
+.Bl -tag -width continue -compact -offset 4n
+.It Ic c
+.It Ic continue
+Return to the currently executing program.
+.Pp
+.It Ic halt
+Halt the processor.
+.Pp
+.It Ic help
+Display a list of available console commands.
+.Pp
+.It Xo
+.Oo Ic e Oc Ns
+.Ic xamine
+.Op Cm /bwl Ns
+.Op Cm /ins
+.Op Cm /pgiv
+.Op Cm /n: Ns Ar n
+.Op Ar addr 
+.Xc
+Display the contents at address 
+.Ar addr
+according to the options specified.
+.Pp
+The options are:
+.Pp
+.Bl -tag -width 5n -compact
+.It Cm /bwl
+.It Cm /ins
+Size of data to examine.  Your choices are examining values as bytes (8 bits), 
+words (16 bits), or longwords (32 bits).  On systems that support it, you 
+can use
+the 
+.Cm /ins
+option to display the mnemonic representation of the instruction located at
+.Ar addr .
+.Pp
+.It Cm /pvgi
+These options describe the meaning of 
+.Ar addr .
+With the
+.Cm /p
+option,
+.Ar addr
+will be treated as an address in physical memory.  With the 
+.Cm /v
+option,
+.Ar addr 
+will be treated as a virtual address.  The 
+.Cm /g 
+option will let you examine the general registers.
+From 0 to F (base 16), general registers are R0-R12(AP), FP, SP, and PC.
+The
+.Cm /i
+option will let you view the internal processor registers.  These vary
+from processor to processor, but a relatively complete description may be 
+found in 
+.Pa /usr/include/vax/mtpr.h .
+.Pp
+.It Cm /n: Ns Ar count
+The
+.Cm /n
+option specifies that the command will repeat
+.Ar count
+times after executing once, automatically incrementing
+.Ar addr 
+while doing so.
+.El
+.Pp
+.It Xo
+.Oo Ic d Oc Ns
+.Ic eposit
+.Op Cm /bwl
+.Op Cm /pgiv
+.Op Cm /n: Ns Ar n
+.Op Ar addr 
+.Op Ar value
+.Xc
+Insert the value 
+.Ar value
+into the address 
+.Ar addr
+according to the options specified.
+.Pp
+The options are:
+.Pp
+.Bl -tag -width 5n -compact
+.It Cm /bwl
+Size of data to insert.  Your choices are inserting values as bytes (8 bits), 
+words (16 bits), or longwords (32 bits).  
+.Pp
+.It Cm /pvgi
+These options describe the meaning of 
+.Ar addr .
+Their meanings are identical to their respective meanings in the 
+.Cm examine
+command.
+.Pp
+.It Cm /n: Ns Ar count
+The
+.Cm /n
+option specifies that the command will repeat
+.Ar count
+times after executing once, automatically incrementing
+.Ar addr 
+while doing so.
+.El
+.Pp
+.El
 .Pp
-With the above proviso's the console works like any other
+With the above provisos the console works like any other
 .Ux
 terminal.
 .Sh FILES