Previous Next  

Element: MemorySize

Document type

SharedLibraryDescription

Document XPath

/SharedLibraryDescription/MemorySize

Schema XPath

/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/MemorySize

Description

The MemorySize element defines a black box for the shared library. You must ensure that the memory provided will be sufficient for the shared library. If the final shared library requires more memory than is provided for it in the black box, the build will fail.

<SharedLibraryDescription ...>
 <MemorySize 
  MemorySizeBss="0x4000" 
  MemorySizeText="0x60000"
  MemorySizeData="0x8000" 
  MemorySizeRoData="0xa000"/>
</SharedLibraryDescription>
			

If your library requires additional ELF sections, add an AdditionalSection element for each additional section:

<SharedLibraryDescription ...>
 <MemorySize 
  MemorySizeBss="0x4000" 
  MemorySizeText="0x60000"
  MemorySizeData="0x8000" 
  MemorySizeRoData="0xa000"/>
	<AdditionalSection ...">
</SharedLibraryDescription>
			

To minimize the impact of change on the configuration and certification on the library and the module as a whole, you should size each section to accommodate the largest reasonably foreseeable size of the section, rather than setting it to the minimum size required to accommodate the current section.

If you increase the size of the shared library region, you may also have to change the values of the following settings to accommodate the increased size of the shared library:

Use

Required

Children

AdditionalSection

Attributes

MemorySizeBss

MemorySizeData

MemorySizePersistentBss

MemorySizePersistentData

MemorySizeRoData

MemorySizeText

Restrictions

None

Attribute: MemorySizeBss

Document XPath
/SharedLibraryDescription/MemorySize/@MemorySizeBss
Schema XPath
/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/MemorySize/@MemorySizeBss
Description

The maximum size (in bytes) of the shared library’s BSS section of the ELF file.

Use

Optional

Target location

ConfigRecord

XML data type

DecOrHexValueType

Destination data type

Unsigned 32 bit integer

Behavior if not specified

A value of 0 is used.

Values with special meanings

None

Restrictions

Attribute: MemorySizeData

Document XPath
/SharedLibraryDescription/MemorySize/@MemorySizeData
Schema XPath
/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/MemorySize/@MemorySizeData
Description

The maximum size (in bytes) of the shared library’s Data section of the ELF file.

Use

Optional

Target location

ConfigRecord

XML data type

DecOrHexValueType

Destination data type

Unsigned 32 bit integer

Behavior if not specified

A value of 0 is used.

Values with special meanings

None

Restrictions

Attribute: MemorySizePersistentBss

Document XPath
/SharedLibraryDescription/MemorySize/@MemorySizePersistentBss
Schema XPath
/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/MemorySize/@MemorySizePersistentBss
Description

The maximum size (in bytes) of the shared library’s PersistentBSS section of the ELF file.

Use

Optional

Target location

None

XML data type

DecOrHexValueType

Destination data type

Unsigned 32 bit integer

Behavior if not specified

A value of 0 is used.

Values with special meanings

None

Restrictions

Attribute: MemorySizePersistentData

Document XPath
/SharedLibraryDescription/MemorySize/@MemorySizePersistentData
Schema XPath
/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/MemorySize/@MemorySizePersistentData
Description

The maximum size (in bytes) of the shared library’s PersistentData section of the ELF file.

Use

Optional

Target location

ConfigRecord

XML data type

DecOrHexValueType

Destination data type

Unsigned 32 bit integer

Behavior if not specified

A value of 0 is used.

Values with special meanings

None

Restrictions

Attribute: MemorySizeRoData

Document XPath
/SharedLibraryDescription/MemorySize/@MemorySizeRoData
Schema XPath
/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/MemorySize/@MemorySizeRoData
Description

The maximum size (in bytes) of the shared library’s RoData section of the ELF file.

Use

Optional

Target location

ConfigRecord

XML data type

DecOrHexValueType

Destination data type

Unsigned 32 bit integer

Behavior if not specified

A value of 0 is used.

Values with special meanings

None

Restrictions

Attribute: MemorySizeText

Document XPath
/SharedLibraryDescription/MemorySize/@MemorySizeText
Schema XPath
/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/MemorySize/@MemorySizeText
Description

The maximum size (in bytes) of the shared library’s Text section of the ELF file.

Use

Optional

Target location

ConfigRecord

XML data type

DecOrHexValueType

Destination data type

Unsigned 32 bit integer

Behavior if not specified

A value of 0 is used.

Values with special meanings

None

Restrictions



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