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 |