<entryList> Element

The <entryList> element is a required child of the <resourceDescriptor> element. This element is used to list the files and directories included in this resource and describes the settings that are associated with the files and directories.

The <entryList> element has two optional child elements that, if present, must appear in this order:

• <defaultEntry>

• <entry>

If specified, the <defaultEntry> element can only appear one time. The <entry> element describes the settings for a single file or directory. Thus, you can specify more than one <entry> element in the resource descriptor file.

<defaultEntry> Element

The <defaultEntry> element is an optional child of the <entryList> element. This element specifies the default owner, group, and permission settings for resource files that are not listed in <entry> elements in the resource descriptor file.

If this element is omitted, the file and directories listed in this <entryList> block use the setting values determined at check-in time. If specified, this element can only appear one time.

<settings> Element

The <settings> element is a required child element of the <defaultEntry> element and of the <entry> element.

The <settings> element behaves differently when used as a child of these elements:

• <defaultEntry> element – Specifies the setting values to be used as defaults for any file that is not associated with its own <entry> element

• <entry> element – Specifies the setting values to be used by the file associated with this <entry> element

  If any attributes are omitted, the corresponding attribute value in the <defaultEntry> element for this <entryList> is used. If no <defaultEntry> element is specified, the check-in time settings are used.

Attributes for the <settings> Element

The <settings> element has these optional attributes:

• group – An optional string that is the group of this entry. The group must be a group name, not a group ID.

• owner – An optional string that is the owner of this entry. The owner must be a user name, not a user ID.

• permissions – An optional string that is the permissions settings for a file or directory. The string is in the format of an octal triplet, as defined by the UNIX chmod command. See the chmod(1M) man page.

You can specify a value of :NONE: for any of these attributes. Use the :NONE: value to tell N1 SPS to use the default settings from the file system on which the component will be deployed.

<entry> Element

The <entry> element is an optional child element of the <entryList> element. This element specifies the owner, group, and permission settings for one entry in the resource. The <entry> element has one required element, <settings>. See <settings> Element.

Files and directories that do not appear as <entry> elements in the <entryList> block use the following:

• Setting values specified in the <defaultEntry> block

• Setting values determined at check-in time

Attributes for the <entry> Element

The <entry> element has one required attribute, name. The name value is a string that defines the name of this entry, relative to the root of the resource. The name of the top-level resource should always be root.

For example, if the resource created a directory hierarchy starting with topDir, the name attribute for the top level directory is root. The name attribute for a nested directory subDir would be root/subDir. For a file resource named file.txt, the name attribute would be root.

Trailing slash (/) characters are not permitted.

See Sample XML for the <resourceDescriptor> Element.