Previous Next  

Element: SharedLibraryDescription

Document type

SharedLibraryDescription

Document XPath

/SharedLibraryDescription

Schema XPath

/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription

Description

The SharedLibraryDescription element is the root element of the SharedLibraryDescription document type. A SharedLibraryDescription document describes the configuration of a shared library.

You create a shared library configuration as a file with SharedLibraryDescription as its root element. You include the shared library configuration file into your system configuration using an xi:include element in the SharedLibrary element. Optionally, you can include the SharedLibraryDescription document inline in the SharedLibrary element.

When creating a shared library description as a separate file, you should begin with an XML declaration:

<?xml version="1.0" encoding="UTF-8"?>
			

Following the XML declaration, insert the SharedLibraryDescription element:

<SharedLibraryDescription 
 xmlns="http://www.windriver.com/vxWorks653/ConfigRecord"
 xmlns:xi="http://www.w3.org/2001/XInclude"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://www.windriver.com/vxWorks653/ConfigRecord ../cleanschema/Application.xsd"
 SystemSharedLibrary="true">
</SharedLibraryDescription>
			

The first three attributes are standard and should be entered exactly as shown. The xsi:schemaLocation attribute associates the namespace (http://www.windriver.com/vxWorks653/ConfigRecord) with the schema file (Application.xsd). You must enter the correct path for the schema file on your system. The location of the schema files in the installation is /target/config/xml/cleanschema. If you use a schema-aware XML editor, it will probably enter these attributes for you.

Use

Required

Children

Extensions

MemorySize

Attributes

SystemSharedLibrary

VirtualAddress

Restrictions

None

Attribute: SystemSharedLibrary

Document XPath
/SharedLibraryDescription/@SystemSharedLibrary
Schema XPath
/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/@SystemSharedLibrary
Description

If this library contains a partition operating system, then it must be configured as a system shared library, the value must be true. If library does not contain a partition operating system, the value must be false.

Use

Required

Target location

None

XML data type

xs:boolean

Destination data type

Boolean

Behavior if not specified

N/A

Values with special meanings

false: The library is not a system shared library

true: The library is a system shared library

Restrictions

None

Attribute: VirtualAddress

Document XPath
/SharedLibraryDescription/@VirtualAddress
Schema XPath
/ConfigRecord/Module/SharedLibraryRegions/SharedLibrary/SharedLibraryDescription/@VirtualAddress
Description

The virtual address of the shared library.

You can calculate the virtual address by hand, by constructing a virtual memory map of the module and placing each object in a suitable location, or you can use the VxWorks 653 tools to calculate addresses for you.

To calculate a suitable virtual address for a shared library, use the following procedure:

  1. Construct a Module XML document that lists each of your SharedLibraryDescription documents via a xi:include element. This does not need to be a complete Module document and does not need to conform to the Module document type, as long as the XPath location of the xi:include elements is correct.
  2. From each SharedLibraryDescription documents completely remove the from the SharedLibraryDescription file. (You must remove the entire attribute, not merely its value).
  3. For the first library, call the XMLGen tool with the virtaddr option: xmlgen --virtaddr module.xml my-sl (where "module.xml" is the name of the Module file that you created for this purpose, and "my-sl" is the name of the shared library as expressed by /Module/SharedLibraryRegions/SharedLibrary/@Name.
  4. For the first SharedLibraryDescription document, restore the the and give it the value generated by the XMLGen tool.
  5. Repeat for each SharedLibraryDescription document, making sure that the virtual address of the previous shared library had be entered into its SharedLibraryDescription document. (The addresses of the other libraries are needed to calculate a correct address for the current library.)
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



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