Filelist

The filelist section defines an itemized list of files to be copied from source to destination. The list is processed in the order specified in the section. The filelist contains zero, one, or more file sections. Each file section includes the following information as captured and detailed in the table.

Attribute

Description

Required

Default

Domain

Example(s)

destination

Specifies the path of the file, directory, or symlink that needs to be copied to or created in the target directory.

The name of the destination file does not need to match the filename specified in the source attribute; when there is a difference, the file will be renamed accordingly.

The value specified in destination attribute is relative to ${TARGET_DIRECTORY}, which must be specified to CopyTarget.

Mandatory

-

Valid Linux filepath.

destination:

'/lib/nvidia/lib_nvidia.so'

source

Specifies the source path of a file or symlink that needs to be copied from.

Sources must be specified using a dictionary data type. The key defines the source type and the corresponding value specifies the path. While executing copytarget, the key to be selected is determined by the --source-type parameter.

This attribute should not be set when creating a directory or changing the permission of an already existing file or directory.

The value specified in source attribute is relative to ${WORKSPACE}, which must be specified to CopyTarget (except when creating symlinks).

Optional

""

Dictionary

Key: Sting

Value: Valid Linux filepath.

source:

pdk_sdk_installed_path: /drive/libnvidia.so

build_tree_path: /lib/libnvidia.so

perm

Specifies the permission of the file or directory in octal notation.

Mandatory

(exception: creating symlinks)

-

Valid Octal notation of Linux permission.

perm: 0777

owner

Specifies the owner identifier of the file, directory, or symlink and can be assigned a numeric UID or a string specifying the username.

Strings are converted to numeric UID when a User Identifier Dictionary is provided to CopyTarget, see Identifier Dictionary section.

Mandatory 

-

Valid Linux UID, or UID alias.

owner: root

owner: 0

group

Specifies the group identifier of the file, directory, or symlink and can be assigned a numeric GID or a string specifying the groupname.

Strings are converted to numeric GID when a Group Identifier Dictionary is provided to CopyTarget, see Identifier Dictionary section.

Mandatory

-

Valid Linux GID, or GID alias. 

group: root

group: 0

filesystems

Specifies the filesystem types that a file can be copied into.

The key specifies the name of filesystem. The value field is a dictionary that defines whether a file can be copied into this filesystem by setting required:yes or required:no. The value field can also define addditional key:values for puropses of bookkeeping. The additional fields are however not processed by CopyTarget.

If this field is not defined, the file item is processed for ALL filesystem-types.

Optional

ALL filesystem types

Dictionary

Key: Sting

Value: Dictionary

filesystems:

standard:

required: no

safety:

required: yes

jama: XYZ

create_symlink

If set to true, a symlink is created at the destination location. The symlink points to the value specified in the attribute source.

By default, this field is set to false.

Optional

 false

 true, false

create_symlink : true

remove

If set to true, the file specified in the destination attribute is removed.

If the destination attribute points to a directory, the directory must be empty; otherwise, CopyTarget reports an error; this is intentional and prevents inappropriate deletion.

By default, this field is set to false.

Optional 

 false

 true, false

remove: true