Previous Next  

Element: SharedData

Document type

Module

Document XPath

/Module/SharedDataRegions/SharedData

Schema XPath

/ConfigRecord/Module/SharedDataRegions/SharedData

Description

The SharedData element defines the name of an shared data region and includes a SharedDataDescription document that defines the configuration of a shared data region or a SharedIODescription document that defines the configuration of a shared I/O region.

You include the SharedDataDescription or SharedIODescription using an xi:include statement.

<SharedDataRegions>
 <SharedData Name="my-sdr">
  <xi:include href="my-SharedDataDescription.xml"/>
 </SharedData>
 <SharedData Name="my-sior">
  <xi:include href="my-SharedIODescription.xml"/>
 </SharedData>
 ...
</SharedDataRegions>
			

You can also include the SharedDataDescription or SharedIODescription inline:

<SharedDataRegions>
 <SharedData Name="my-sdr">
  <SharedDataDescription>
	 ...
	</SharedDataDescription>
	...
 </SharedData>
 <SharedData Name="my-sior">
  <SharedIODescription>
	 ...
	</SharedIODescription>
	...
 </SharedData>
 ...
</SharedDataRegions>
			

Notice that while the configuration of the shared data region or shared I/O region is included from a SharedDataDescription or SharedIODescription document, the name of the shared region must be supplied in the attribute of the SharedData element itself. This allows you to include the same shared region description in different systems, giving the shared region a different name in each.

Use

Optional, unbounded

Children

SharedDataDescription

SharedIODescription

xi:include

Attributes

Name

Restrictions

None

Attribute: Name

Document XPath
/Module/SharedDataRegions/SharedData/@Name
Schema XPath
/ConfigRecord/Module/SharedDataRegions/SharedData/@Name
Description

The name of the shared data region. The shared data region name is used in /PartitionDescription/SharedDataRegion/@NameRef of a PartitionDescription document to give a partition access to a shared data region. You can also use this name in application code to refer to a shared data region using the appropriate APIs.

Applications and the core OS will access the shared data region using its name with the appropriate APIs, or by using its memory pool name, which is its name followed by the string “Pool”. System integrators, platform providers, and application developers must communicate to ensure that the names of all relevant shared data regions are agreed on and used consistently.

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



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