Print this page
11622 clean up rarer mandoc lint warnings

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/monitor.1m
          +++ new/usr/src/man/man1m/monitor.1m
   1    1  '\" te
   2    2  .\" Copyright (c) 2003, Sun Microsystems, Inc.
   3    3  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4    4  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5    5  .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6    6  .TH MONITOR 1M "Jul 24, 2003"
   7    7  .SH NAME
   8    8  monitor \- SPARC system PROM monitor
   9    9  .SH SYNOPSIS
  10      -.LP
  11   10  .nf
  12   11  \fBSTOP\(miA\fR
  13   12  .fi
  14   13  
  15   14  .LP
  16   15  .nf
  17   16  \fBBREAK\fR
  18   17  .fi
  19   18  
  20   19  .LP
  21   20  .nf
  22   21  \fBinitial system power-on\fR
  23   22  .fi
  24   23  
  25   24  .LP
  26   25  .nf
  27   26  \fBexit from a client program, e.g., the Operating System\fR
  28   27  .fi
  29   28  
  30   29  .SH DESCRIPTION
  31      -.sp
  32      -.LP
  33   30  The \fBCPU\fR board of a workstation contains one or more \fBEPROMs\fR or
  34   31  \fBEEPROMs.\fR The program which executes from the \fBPROMs\fR is referred to
  35   32  as "the monitor". Among other things, the monitor performs system
  36   33  initialization at power-on and provides a user interface.
  37   34  .SS "Monitor Prompt"
  38      -.sp
  39      -.LP
  40   35  The monitor of earlier workstations was known as the \fBSunMON\fR monitor and
  41   36  displayed the \fB>\fR for its prompt. See the \fBSunMON MONITOR USAGE\fR
  42   37  section for further details.
  43   38  .sp
  44   39  .LP
  45   40  Existing workstations use a monitor which is known as the OpenBoot monitor.
  46   41  The OpenBoot monitor typically displays \fBok\fR as its prompt, but it may also
  47   42  display the \fB>\fR prompt under certain circumstances.
  48   43  .sp
  49   44  .LP
↓ open down ↓ 10 lines elided ↑ open up ↑
  60   55  .sp
  61   56  .LP
  62   57  When the \fBNVRAM\fR \fB\&'security-mode'\fR parameter has been turned on, or
  63   58  when the value of the \fB\&'sunmon-compat?'\fR parameter is true, then the
  64   59  OpenBoot monitor displays the message: \fBType b (boot), c (continue), or n
  65   60  (new command mode)\fR
  66   61  .sp
  67   62  .LP
  68   63  and the \fB>\fR prompt appears.
  69   64  .SH OPENBOOT PROM USAGE
  70      -.sp
  71      -.LP
  72   65  Some of the more useful commands that can be issued from OpenBoot's \fBok \fR
  73   66  prompt are described here.  Refer to the   book for a complete list of
  74   67  commands.
  75   68  .SS "Help"
  76      -.sp
  77      -.LP
  78   69  Help for various functional areas of the OpenBoot monitor can be obtained by
  79   70  typing \fBhelp\fR. The help listing provides a number of other key words which
  80   71  can then be used in the help command to provide further details.
  81   72  .SS "NVRAM Parameters"
  82      -.sp
  83      -.LP
  84   73  Each workstation contains one or more \fBNVRAM\fR devices which contains unique
  85   74  system ID information, as well as a set of user-configurable parameters.  The
  86   75  \fBNVRAM\fR parameters allow the user a certain level of flexibility in
  87   76  configuring the system to act in a given manner under a specific set of
  88   77  circumstances.
  89   78  .sp
  90   79  .LP
  91   80  See \fBeeprom\fR(1M) for a description of the parameters and information
  92   81  regarding setting the parameters from the OS level.
  93   82  .sp
↓ open down ↓ 34 lines elided ↑ open up ↑
 128  117  .na
 129  118  \fB\fBset-defaults\fR\fR
 130  119  .ad
 131  120  .RS 18n
 132  121  Used to reset all parameters to their default values.  (Note that
 133  122  \fB\&'set-defaults'\fR only affects parameters that have assigned default
 134  123  values.)
 135  124  .RE
 136  125  
 137  126  .SS "Security Parameters"
 138      -.sp
 139      -.LP
 140  127  Newer OpenBoot monitors contain user interfaces that support the storage and
 141  128  listing of keys for later use by client programs.
 142  129  .sp
 143  130  .ne 2
 144  131  .na
 145  132  \fB\fBlist-security-keys\fR\fR
 146  133  .ad
 147  134  .sp .6
 148  135  .RS 4n
 149  136  Lists the names of keys currently stored on a machine.
↓ open down ↓ 7 lines elided ↑ open up ↑
 157  144  .sp .6
 158  145  .RS 4n
 159  146  Stores key data \fIkeydata\fR in a key named \fIkeyname\fR. Actual key data can
 160  147  be up to 32 bytes in length. The maximum length of \fIkeyname\fR is 64 bytes,
 161  148  which allows for the hex-formatted ASCII used to present the key data. If
 162  149  \fIkeydata\fR is not present, \fIkeyname\fR and its corresponding data is
 163  150  deleted.
 164  151  .RE
 165  152  
 166  153  .SS "Hardware Checks and Diagnostics"
 167      -.sp
 168      -.LP
 169  154  The following commands are available for testing or checking the system's
 170  155  hardware.  If the \fB\&'diag-switch?'\fR \fBNVRAM\fR parameter is set to true
 171  156  when the system is powered on, then a Power-On Self Test (POST) diagnostic is
 172  157  run, if present, sending its results messages to the system's serial port A.
 173  158  Not all of the commands shown are available on all workstations.
 174  159  .sp
 175  160  .ne 2
 176  161  .na
 177  162  \fB\fBtest-all\fR\fR
 178  163  .ad
↓ open down ↓ 53 lines elided ↑ open up ↑
 232  217  .sp
 233  218  .ne 2
 234  219  .na
 235  220  \fB\fBwatch-clock\fR\fR
 236  221  .ad
 237  222  .RS 17n
 238  223  Test the system's clock function.
 239  224  .RE
 240  225  
 241  226  .SS "System Information"
 242      -.sp
 243      -.LP
 244  227  The following commands are available for displaying information about the
 245  228  system.  Not all commands are available on all workstations.
 246  229  .sp
 247  230  .ne 2
 248  231  .na
 249  232  \fB\fBbanner\fR\fR
 250  233  .ad
 251  234  .RS 18n
 252  235  Display the power-on banner.
 253  236  .RE
↓ open down ↓ 110 lines elided ↑ open up ↑
 364  347  .sp
 365  348  .ne 2
 366  349  .na
 367  350  \fB\fB\&.version\fR\fR
 368  351  .ad
 369  352  .RS 18n
 370  353  Display the version and date of the OpenBoot PROM.
 371  354  .RE
 372  355  
 373  356  .SS "Emergency Commands"
 374      -.sp
 375      -.LP
 376  357  These commands must be typed from the keyboard, they do not work from a console
 377  358  which is attached by way of the serial ports.  With the exception of the
 378  359  \fBStop-A\fR command, these commands are issued by pressing and holding down
 379  360  the indicated keys on the keyboard immediately after the system has been
 380  361  powered on.  The keys must be held down until the monitor has checked their
 381  362  status.  The \fBStop-A\fR command can be issued at any time after the console
 382  363  display begins, and the keys do not need to be held down once they've been
 383  364  pressed. The \fBStop-D,\fR \fBStop-F\fR and \fBStop-N\fR commands are not
 384  365  allowed when one of the security modes has been set.  Not all commands are
 385  366  available on all workstations.
↓ open down ↓ 43 lines elided ↑ open up ↑
 429  410  .ne 2
 430  411  .na
 431  412  \fB\fBStop-N (L1-N)\fR\fR
 432  413  .ad
 433  414  .RS 17n
 434  415  Causes the \fBNVRAM\fR parameters to be reset to their default values.  Note
 435  416  that not all parameters have default values.
 436  417  .RE
 437  418  
 438  419  .SS "Line Editor Commands"
 439      -.sp
 440      -.LP
 441  420  The following commands can be used while the monitor is displaying the \fBok\fR
 442  421  prompt.  Not all of these editing commands are available on all workstations.
 443  422  .sp
 444  423  .ne 2
 445  424  .na
 446  425  \fB\fBCTRL-A\fR\fR
 447  426  .ad
 448  427  .RS 10n
 449  428  Place the cursor at the start of line.
 450  429  .RE
↓ open down ↓ 147 lines elided ↑ open up ↑
 598  577  .ne 2
 599  578  .na
 600  579  \fB\fBCTRL-Y\fR\fR
 601  580  .ad
 602  581  .RS 10n
 603  582  Insert the contents of the memory buffer into the line, in front (to the left)
 604  583  of the cursor.
 605  584  .RE
 606  585  
 607  586  .SS "nvramrc"
 608      -.sp
 609      -.LP
 610  587  The \fBnvramrc\fR is an area of the system's \fBNVRAM\fR where users may store
 611  588  Forth programs. The programs which are stored in the \fBnvramrc\fR are executed
 612  589  each time the system is reset, provided that the \fB\&'use-nvramrc?'\fR
 613  590  \fBNVRAM\fR parameter has been set to \fB\&'true'\fR. Refer to the book for
 614  591  information on how to edit and use the \fBnvramrc\fR.
 615  592  .SS "Restricted Monitor"
 616      -.sp
 617      -.LP
 618  593  The command \fB\&'old-mode'\fR is used to move OpenBoot into a restricted
 619  594  monitor mode, causing the \fB> \fR prompt to be displayed.  Only three commands
 620  595  are allowed while in the restricted monitor; the \fB\&'go'\fR command (to
 621  596  resume a program which was interrupted with the \fBStop-A\fR command), the
 622  597  \fB\&'n'\fR command (to return to the normal OpenBoot monitor), and boot
 623  598  commands.  The restricted monitor's boot commands approximate the older
 624  599  \fBSunMON\fR monitor's boot command syntax. If a \fB\&'security-mode'\fR has
 625  600  been turned on then the restricted monitor becomes the default monitor
 626  601  environment.  The restricted monitor may also become the default environment if
 627  602  the \fB\&'sunmon-compat?' \fR \fBNVRAM\fR parameter is set to true.  Not all
 628  603  workstations have the \fB\&'sunmon-compat?'\fR parameter.
 629  604  .SH SUNMON PROM USAGE
 630      -.sp
 631      -.LP
 632  605  The following commands are available systems with older  \fBSunMON\fR-based
 633  606  PROM:
 634  607  .sp
 635  608  .ne 2
 636  609  .na
 637  610  \fB\fB+\fR|\fB\(mi\fR\fR
 638  611  .ad
 639  612  .sp .6
 640  613  .RS 4n
 641  614  Increment or decrement the current address and display the contents of the new
↓ open down ↓ 1135 lines elided ↑ open up ↑
1777 1750  \fB\fBs\fR\fR
1778 1751  .ad
1779 1752  .RS 5n
1780 1753  flush the segment beginning at \fIvirtual_address\fR within context
1781 1754  \fIcontext_number\fR
1782 1755  .RE
1783 1756  
1784 1757  .RE
1785 1758  
1786 1759  .SH ATTRIBUTES
1787      -.sp
1788      -.LP
1789 1760  See \fBattributes\fR(5) for descriptions of the following attributes:
1790 1761  .sp
1791 1762  
1792 1763  .sp
1793 1764  .TS
1794 1765  box;
1795 1766  c | c
1796 1767  l | l .
1797 1768  ATTRIBUTE TYPE  ATTRIBUTE VALUE
1798 1769  _
1799 1770  Architecture    SPARC
1800 1771  .TE
1801 1772  
1802 1773  .SH SEE ALSO
1803      -.sp
1804      -.LP
1805 1774  \fBtip\fR(1), \fBboot\fR(1M), \fBeeprom\fR(1M), \fBattributes\fR(5)
1806      -.sp
1807      -.LP
1808      -
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX