Previous Next  

Element: kernelRegion

Document type

CoreOSDescription

Document XPath

/CoreOSDescription/HardwareConfiguration/PhysicalMemory/kernelRegion

Schema XPath

/ConfigRecord/Module/CoreOS/CoreOSDescription/HardwareConfiguration/PhysicalMemory/kernelRegion

Description

The kernelRegion element defines the physical memory region allocated for the use of user regions which must reside in the core OS memory context. They are primarily used for online-loaded partitions.

To support an online-loaded partition, you must define a kernel region where the online-loaded partition will be loaded at run time:

<PhysicalMemory>
 ...
 <kernelRegion
  PoolName="my-application-B-partition"
  Size="0x400000"
  WriteProtected="false"/>
</PhysicalMemory>
 			

NOTE: To support online-loaded partitions, you must include the INCLUDE_KERNEL_FULL component when you build the core OS.

   
Use

Optional, unbounded

Children

None

Attributes

PoolName

Size

WriteProtected

Restrictions

None

Attribute: PoolName

Document XPath
/CoreOSDescription/HardwareConfiguration/PhysicalMemory/kernelRegion/@PoolName
Schema XPath
/ConfigRecord/Module/CoreOS/CoreOSDescription/HardwareConfiguration/PhysicalMemory/kernelRegion/@PoolName
Description

The name of the kernel region. This name (with the string "Pool" appended) is used by the routine rgnLookupByPoolName() to retrieve the address of the kernel region.

Use

Required

Target location

ConfigRecord

XML data type

xs:string

Destination data type

String

Behavior if not specified

N/A

Values with special meanings

None

Restrictions

Attribute: Size

Document XPath
/CoreOSDescription/HardwareConfiguration/PhysicalMemory/kernelRegion/@Size
Schema XPath
/ConfigRecord/Module/CoreOS/CoreOSDescription/HardwareConfiguration/PhysicalMemory/kernelRegion/@Size
Description

The total size (in bytes) needed for a user specified RAM region in core OS memory space.

If the kernelRegion is to be use for an online loaded partition then the size must be greater than or equal to the size of the black box for the application in the online-loaded partition, which consists of the sum of the application memory sections as specified in /ApplicationDescription/MemorySize, plus the sum of the sizes of all additional memory sections as defined in /ApplicationDescription/MemorySize/AdditionalSection/@Size.

Use

Required

Target location

ConfigRecord

XML data type

DecOrHexValueType

Destination data type

Unsigned 32 bit integer

Behavior if not specified

N/A

Values with special meanings

None

Restrictions

Attribute: WriteProtected

Document XPath
/CoreOSDescription/HardwareConfiguration/PhysicalMemory/kernelRegion/@WriteProtected
Schema XPath
/ConfigRecord/Module/CoreOS/CoreOSDescription/HardwareConfiguration/PhysicalMemory/kernelRegion/@WriteProtected
Description

Determines whether the kernel region will be writable after initialization.

Use

Required

Target location

ConfigRecord

XML data type

xs:string

Destination data type

Boolean

Behavior if not specified

N/A

Values with special meanings

false: The core OS memory region will be writable after initialization.

true: The core OS memory region will not be writable after initialization.

Restrictions

None




Generated on 2007-10-15 17:17:22.