neysx 05/06/27 14:41:53 Modified: xml/htdocs/doc/en gentoo-sparc-obpreference.xml Log: Applied coding style **No Content Change**
Revision Changes Path 1.5 +424 -245 xml/htdocs/doc/en/gentoo-sparc-obpreference.xml file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-sparc-obpreference.xml?rev=1.5&content-type=text/x-cvsweb-markup&cvsroot=gentoo plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-sparc-obpreference.xml?rev=1.5&content-type=text/plain&cvsroot=gentoo diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/gentoo-sparc-obpreference.xml.diff?r1=1.4&r2=1.5&cvsroot=gentoo Index: gentoo-sparc-obpreference.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-obpreference.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- gentoo-sparc-obpreference.xml 22 Sep 2004 21:57:14 -0000 1.4 +++ gentoo-sparc-obpreference.xml 27 Jun 2005 14:41:53 -0000 1.5 @@ -1,11 +1,14 @@ <?xml version='1.0' encoding="UTF-8"?> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-obpreference.xml,v 1.4 2004/09/22 21:57:14 neysx Exp $ --> + +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoo-sparc-obpreference.xml,v 1.5 2005/06/27 14:41:53 neysx Exp $ --> + <guide link="/doc/en/gentoo-sparc-obpreference.xml"> <title>OpenBoot PROM (OBP) Reference</title> -<!-- {{{ header stuff --> -<author title="Author"><mail link="[EMAIL PROTECTED]">Ciaran McCreesh</mail></author> +<author title="Author"> + <mail link="[EMAIL PROTECTED]">Ciaran McCreesh</mail> +</author> <abstract> The OpenBoot PROM (OBP) Reference provides a list of useful OBP commands that @@ -15,108 +18,173 @@ <license /> <version>1.2</version> -<date>August 27th, 2004</date> -<!-- }}} --> +<date>2004-08-27</date> + +<chapter> +<title>About this Document</title> +<section> +<body> + +<p> +This document provides a list of useful OBP commands that can be helpful when +booting, configuring and performing diagnostics upon Sun SPARC hardware and +clones. +</p> + +<p> +Note that not all commands are available on all PROM versions. In particular, +sun4c systems have a different input mode, and some JavaStation models are +missing a lot of OBP functionality. +</p> + +<p> +OBP is somewhat inconsistent when it comes to command names. Sometimes hyphens +are used to seperate words, sometimes they are not. Some commands which display +information start with or contain a dot (this is a FORTH convention). +</p> + +<p> +The terms "OBP", "OpenBoot PROM" and "PROM" are used interchangably in this +document. +</p> + +</body> +</section> +</chapter> + +<chapter> +<title>Entering OBP</title> +<section> +<title>Systems with Sun Keyboards</title> +<body> + +<p> +On regular Sun systems (and clones which use Sun keyboards), press +<c>Stop+A</c> when the system boots to enter OBP. The <c>Stop</c> key is the +top left key on the extra block of keys on the left hand side of the keyboards +(on really old systems it might be marked <c>L1</c>). +</p> + +<p> +The <c>Stop+N</c> keyboard combination at boot will reset many systems to the +default PROM settings. <c>Stop+D</c> will enable diagnostics on some boards. +</p> + +</body> +</section> +<section> +<title>Over Serial Console</title> +<body> + +<p> +To enter OBP over serial console, send a break. In minicom, do this by pressing +<c>ctrl+A F</c>. In xc, use <c>ctrl+A B</c>. +</p> + +</body> +</section> +<section> +<title>Systems with Non-Sun (PC Style) Keyboards</title> +<body> + +<p> +On systems with PC-style keyboards (such as JavaStations and some Ultra +clones), <c>ctrl+break</c> or <c>alt+ctrl+break</c> is generally used. +</p> + +<p> +Note that on the JavaStation JK, <c>ctrl+break</c> will restart the box rather +than enter PROM. To get at OBP, you will need to set jumper J1300 pins 7-8 on +the mainboard. +</p> + +</body> +</section> +</chapter> -<chapter><title>About this Document</title> <!-- {{{ --> +<chapter> +<title>Basic System Commands</title> <section> +<title>Halting and Restarting</title> <body> - <p>This document provides a list of useful OBP commands that can be helpful - when booting, configuring and performing diagnostics upon Sun SPARC hardware - and clones.</p> - <p>Note that not all commands are available on all PROM versions. In - particular, sun4c systems have a different input mode, and some JavaStation - models are missing a lot of OBP functionality.</p> - <p>OBP is somewhat inconsistent when it comes to command names. Sometimes - hyphens are used to seperate words, sometimes they are not. Some commands - which display information start with or contain a dot (this is a FORTH - convention).</p> - <p>The terms "OBP", "OpenBoot PROM" and "PROM" are used interchangably in this - document.</p> -</body> -</section> -</chapter> <!-- }}} --> - -<chapter><title>Entering OBP</title> <!-- {{{ --> - <section><title>Systems with Sun Keyboards</title> <!-- {{{ --> - <body> - <p>On regular Sun systems (and clones which use Sun keyboards), press - <c>Stop+A</c> when the system boots to enter OBP. The <c>Stop</c> key is - the top left key on the extra block of keys on the left hand side of the - keyboards (on really old systems it might be marked <c>L1</c>).</p> - <p>The <c>Stop+N</c> keyboard combination at boot will reset many systems to - the default PROM settings. <c>Stop+D</c> will enable diagnostics on some - boards.</p> - </body> - </section> <!-- }}} --> - <section><title>Over Serial Console</title> <!-- {{{ --> - <body> - <p>To enter OBP over serial console, send a break. In minicom, do this by - pressing <c>ctrl+A F</c>. In xc, use <c>ctrl+A B</c>.</p> - </body> - </section> <!-- }}} --> - <section><title>Systems with Non-Sun (PC Style) Keyboards</title> <!-- {{{ --> - <body> - <p>On systems with PC-style keyboards (such as JavaStations and some Ultra - clones), <c>ctrl+break</c> or <c>alt+ctrl+break</c> is generally used.</p> - <p>Note that on the JavaStation JK, <c>ctrl+break</c> will restart the box - rather than enter PROM. To get at OBP, you will need to set jumper J1300 - pins 7-8 on the mainboard.</p> - </body> - </section> <!-- }}} --> -</chapter> <!-- }}} --> - -<chapter><title>Basic System Commands</title> <!-- {{{ --> - <section><title>Halting and Restarting</title> <!-- {{{ --> - <body> - <p>The <c>power-off</c> command will halt the box and turn off power. This - command is sometimes screwy on Ultra5/10 systems.</p> - <p>The <c>reset</c> command will perform a soft reset. If diagnostics are - enabled, they will <e>not</e> be rerun. In some documents, this command is - refered to as <c>reset-all</c>.</p> - <p>The <c>boot</c> command boots the system. A parameter may be provided to - override the default boot device -- this can be a full device name or a - device alias such as <c>disk</c>, <c>cdrom</c> or <c>net</c>. Any - additional arguments are passed to the bootloader or operating system.</p> - </body> - </section> <!-- }}} --> - - <section><title>PROM and System Information</title> <!-- {{{ --> - <body> - <p>The <c>.version</c> command will show the OBP version.</p> -<pre caption=".version output"><![CDATA[ + +<p> +The <c>power-off</c> command will halt the box and turn off power. This command +is sometimes screwy on Ultra5/10 systems. +</p> + +<p> +The <c>reset</c> command will perform a soft reset. If diagnostics are enabled, +they will <e>not</e> be rerun. In some documents, this command is refered to as +<c>reset-all</c>. +</p> + +<p> -- [email protected] mailing list
