systemsoftware
/
Linux-Architecture-Reference
35
1
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

minor formatting updates

Browse Source
pull/2/head
Jeff Scheel 6 years ago
parent 331f07b778
commit 92f14bfc73
2 changed files with 60 additions and 50 deletions
Show Stats Download Patch File Download Diff File

42
DeviceTree/ch_devtree_pa.xml
Unescape Escape View File

@ -161,8 +161,10 @@
<para>OF shall use the memory resources within the space indicated by the <para>OF shall use the memory resources within the space indicated by the
<emphasis>real-base, real-size, virt-base</emphasis> and <emphasis role="bold"><literal>real-base</literal></emphasis>,
<emphasis>virt-size</emphasis> Configuration Variables defined for the PA. <emphasis role="bold"><literal>real-size</literal></emphasis>,
<emphasis role="bold"><literal>virt-base</literal></emphasis>, and
<emphasis role="bold"><literal>virt-size</literal></emphasis> Configuration Variables defined for the PA.
As described in the applicable platform binding, a mechanism is defined As described in the applicable platform binding, a mechanism is defined
to enable OF to determine if its current configuration is consistent with to enable OF to determine if its current configuration is consistent with
the requirements of the client.</para> the requirements of the client.</para>
@ -172,20 +174,20 @@
OF loads the client program, it inspects the program header, and if its OF loads the client program, it inspects the program header, and if its
current usage of physical memory or virtual address space conflicts with current usage of physical memory or virtual address space conflicts with
that specified in the program header, OF shall set the that specified in the program header, OF shall set the
<emphasis>real-base</emphasis>, <emphasis role="bold"><literal>real-base</literal></emphasis>,
<emphasis>real-size</emphasis>, <emphasis role="bold"><literal>real-size</literal></emphasis>,
<emphasis>virt-base</emphasis>, and <emphasis role="bold"><literal>virt-base</literal></emphasis>, and
<emphasis>virt-size</emphasis> to the configuration variables as specified <emphasis role="bold"><literal>virt-size</literal></emphasis> to the configuration variables as specified
in the header and restart itself. in the header and restart itself.
<emphasis>Real-base</emphasis>, <emphasis role="bold"><literal>Real-base</literal></emphasis>,
<emphasis>real-size</emphasis>, <emphasis role="bold"><literal>real-size</literal></emphasis>,
<emphasis>virt-base</emphasis>, and <emphasis role="bold"><literal>virt-base</literal></emphasis>, and
<emphasis>virt-size</emphasis> may be specified as -1, in which case the <emphasis role="bold"><literal>virt-size</literal></emphasis> may be specified as -1, in which case the
firmware is permitted to choose appropriate values for the variables firmware is permitted to choose appropriate values for the variables
specified as -1.</para> specified as -1.</para>
<para>If the values of the <para>If the values of the
<emphasis>real-size</emphasis> and/or <emphasis role="bold"><literal>real-size</literal></emphasis> and/or
<emphasis>virt-size</emphasis> configuration variables do not provide <emphasis role="bold"><literal>virt-size</literal></emphasis> configuration variables do not provide
sufficient memory and/or virtual address space for the firmware's own sufficient memory and/or virtual address space for the firmware's own
use, then the firmware shall not attempt to load a client program and the use, then the firmware shall not attempt to load a client program and the
condition should be reported to the user. The possibility of not being condition should be reported to the user. The possibility of not being
@ -242,12 +244,12 @@
interface handler, that is passed to the client, has to be a real interface handler, that is passed to the client, has to be a real
address.</para> address.</para>
<para>The Configuration Variables <para>The Configuration Variables
<emphasis>real-base</emphasis> and <emphasis role="bold"><literal>real-base</literal></emphasis> and
<emphasis>real-size</emphasis> should indicate the physical memory base <emphasis role="bold"><literal>real-size</literal></emphasis> should indicate the physical memory base
and size in which OF must locate itself. In Real-Mode, the Configuration and size in which OF must locate itself. In Real-Mode, the Configuration
Variables Variables
<emphasis>virt-base</emphasis> and <emphasis role="bold"><literal>virt-base</literal></emphasis> and
<emphasis>virt-size</emphasis> do not have meaning and should be set to <emphasis role="bold"><literal>virt-size</literal></emphasis> do not have meaning and should be set to
-1.</para> -1.</para>
</section> </section>
@ -263,11 +265,11 @@
interfaces to allow OF and its client to ensure that this single virtual interfaces to allow OF and its client to ensure that this single virtual
address model can be maintained.</para> address model can be maintained.</para>
<para>The Configuration Variables <para>The Configuration Variables
<emphasis>virt-base</emphasis> and <emphasis role="bold"><literal>virt-base</literal></emphasis> and
<emphasis>virt-size</emphasis> should indicate the virtual address space <emphasis role="bold"><literal>virt-size</literal></emphasis> should indicate the virtual address space
base address and size that OF should use. The Configuration Variables base address and size that OF should use. The Configuration Variables
<emphasis>real-base</emphasis> and <emphasis role="bold"><literal>real-base</literal></emphasis> and
<emphasis>real-size</emphasis> should indicate the physical memory base <emphasis role="bold"><literal>real-size</literal></emphasis> should indicate the physical memory base
and size in which OF must locate itself.</para> and size in which OF must locate itself.</para>
</section> </section>

68
DeviceTree/ch_devtree_system.xml
Unescape Escape View File

@ -540,7 +540,7 @@
<icon size=64,64 color-space=3,3,2><bitmap>hh ... hh1</bitmap></icon> <icon size=64,64 color-space=3,3,2><bitmap>hh ... hh1</bitmap></icon>
</chrp-boot>]]></programlisting></para> </chrp-boot>]]></programlisting></para>


<para>AIX Diagnostics Bootinfo Object Example: <para><emphasis role="bold">AIX Diagnostics Bootinfo Object Example:</emphasis>
<programlisting><![CDATA[<chrp-boot> <programlisting><![CDATA[<chrp-boot>
<description>AIX 4.2.D.0 Diagnostics</description> <description>AIX 4.2.D.0 Diagnostics</description>
<os-name>AIX 4.2.D.0 Diagnostics</os-name> <os-name>AIX 4.2.D.0 Diagnostics</os-name>
@ -4694,7 +4694,7 @@
<entry> <entry>
<para>0</para> <para>0</para>
</entry> </entry>
<entry morerows="1"> <entry morerows="1" valign="middle">
<para>0b11 for H_CONFER &amp; H_PROD</para> <para>0b11 for H_CONFER &amp; H_PROD</para>
</entry> </entry>
</row> </row>
@ -4707,7 +4707,7 @@
<entry> <entry>
<para>2</para> <para>2</para>
</entry> </entry>
<entry> <entry valign="middle">
<para>Set to 1 if H_PURR is implemented with a reduced volatile <para>Set to 1 if H_PURR is implemented with a reduced volatile
kill set of r3 &amp; r4; else set to 0.</para> kill set of r3 &amp; r4; else set to 0.</para>
</entry> </entry>
@ -4716,7 +4716,7 @@
<entry> <entry>
<para>3</para> <para>3</para>
</entry> </entry>
<entry morerows="4"> <entry morerows="4" valign="middle">
<para>Reserved for future expansion (0b0)</para> <para>Reserved for future expansion (0b0)</para>
</entry> </entry>
</row> </row>
@ -7544,16 +7544,21 @@
<para>The presence of the node indicates that all or some of the function <para>The presence of the node indicates that all or some of the function
has been implemented and will be reported using an interrupt.</para> has been implemented and will be reported using an interrupt.</para>
<para> <variablelist>
<emphasis role="bold"><literal>&#8220;name&#8221;</literal></emphasis></para> <varlistentry>
<para>Standard <term><emphasis role="bold"><literal>&#8220;name&#8221;</literal></emphasis> [S]</term>
<emphasis>property name</emphasis> that denotes the I/O sub-system <listitem>
events.</para> <para>Standard
<para> <emphasis>property name</emphasis> that denotes the I/O sub-system
<emphasis>prop-encoded-array</emphasis>: A string, encoded as with events.</para>
<emphasis role="bold"><literal>encode-string</literal></emphasis>.</para> <para>
<para>The value of this string shall be <emphasis>prop-encoded-array</emphasis>: A string, encoded as with
<literal>&#8220;ibm,io-events&#8221;</literal>.</para> <emphasis role="bold"><literal>encode-string</literal></emphasis>.</para>
<para>The value of this string shall be
<literal>&#8220;ibm,io-events&#8221;</literal>.</para>
</listitem>
</varlistentry>
</variablelist>
</section> </section>


@ -8419,7 +8424,7 @@
<para><emphasis role="bold"><literal>&#8220;status&#8221;</literal></emphasis></para> <para><emphasis role="bold"><literal>&#8220;status&#8221;</literal></emphasis></para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<para><emphasis>Optionally</emphasis> the children of the <para><emphasis role="bold">Optionally</emphasis> the children of the
<emphasis role="bold"><literal>/ibm,platform-facilities</literal></emphasis> node may contain as <emphasis role="bold"><literal>/ibm,platform-facilities</literal></emphasis> node may contain as
appropriate the following standard properties with their standard appropriate the following standard properties with their standard
definitions:</para> definitions:</para>
@ -8430,7 +8435,7 @@
</listitem> </listitem>
</itemizedlist> </itemizedlist>
<para><emphasis>Additionally</emphasis> the children of the <para><emphasis role="bold">Additionally</emphasis> the children of the
<emphasis role="bold"><literal>/ibm,platform-facilities</literal></emphasis> node may contain as <emphasis role="bold"><literal>/ibm,platform-facilities</literal></emphasis> node may contain as
appropriate the following unique properties:</para> appropriate the following unique properties:</para>
@ -9974,11 +9979,12 @@
the endian-ness specified by the EI-DATA field of the file.</para> the endian-ness specified by the EI-DATA field of the file.</para>
<para>The format of a Note Section header can be described by an OF <para>The format of a Note Section header can be described by an OF
struct as:</para> struct as:</para>
<para>struct \ Note Section header for OF</para>
<para>/L field ns.namesz \ length of ns.name, including NULL</para> <programlisting><![CDATA[struct \ Note Section header for OF
<para>/L field ns.descrsz</para> /L field ns.namesz \ length of ns.name, including NULL
<para>/L field ns.type</para> /L field ns.descrsz
<para>0 field ns.name \ NULL-terminated, /L padded</para> /L field ns.type
0 field ns.name \ NULL-terminated, /L padded]]></programlisting>


<section> <section>
<title>1275 PowerPC Note Definition</title> <title>1275 PowerPC Note Definition</title>
@ -9992,13 +9998,14 @@
depends upon the kind of Note Section in which it is contained. For the depends upon the kind of Note Section in which it is contained. For the
PowerPC OF note, the format of the Note Section&#8217;s descriptor can be PowerPC OF note, the format of the Note Section&#8217;s descriptor can be
described by an OF struct, as follows:</para> described by an OF struct, as follows:</para>
<para>struct \ Note Section descriptor for CHRP OF</para>
<para>/L field ns.real-mode</para> <programlisting><![CDATA[struct \ Note Section descriptor for CHRP OF</para>
<para>/L field ns.real-base</para> /L field ns.real-mode
<para>/L field ns.real-size</para> /L field ns.real-base
<para>/L field ns.virt-base</para> /L field ns.real-size
<para>/L field ns.virt-size</para> /L field ns.virt-base
<para>/L field ns.load-base</para> /L field ns.virt-size
/L field ns.load-base]]></programlisting>
<para>If the <para>If the
<emphasis role="bold"><literal>ns.load-base</literal></emphasis> value is not -1, then that value is <emphasis role="bold"><literal>ns.load-base</literal></emphasis> value is not -1, then that value is
compared against the current value of the compared against the current value of the
@ -10073,7 +10080,7 @@
the Note Section&#8217;s descriptor can be described by an OF struct, as the Note Section&#8217;s descriptor can be described by an OF struct, as
follows:</para> follows:</para>


<programlisting linenumbering="numbered"><![CDATA[struct \ Note Section descriptor for OF <programlisting><![CDATA[struct \ Note Section descriptor for OF
/L field ns.lparaffinity \= “0/1” (default assumption to be “N”) /L field ns.lparaffinity \= “0/1” (default assumption to be “N”)
/L field ns.min-rmo-size \Minimum size of the Real Mode Accessible Storage /L field ns.min-rmo-size \Minimum size of the Real Mode Accessible Storage
\ Area in MB \ Area in MB
@ -10092,7 +10099,8 @@
\ variables based upon the values in this \ variables based upon the values in this
\ header. \ header.
\ (default value 0) \ (default value 0)
/L field ns.large-page-ready \Flag to indicate the partition OS is prepared for large pages. /L field ns.large-page-ready \Flag to indicate the partition OS is prepared for
\ large pages.
/L field ns.force_alpha_mode]]></programlisting> /L field ns.force_alpha_mode]]></programlisting>


<para><emphasis role="bold">Note:</emphasis> The size of the /L field is based off of <para><emphasis role="bold">Note:</emphasis> The size of the /L field is based off of

Write Preview
Loading…
Cancel
Save