CopyTarget File Operations
CopyTarget supports a limited number of file operations and to have CopyTarget execute a particular operation, a combination of file attributes must be specified. Any invalid combination is raised as an error by CopyTarget and an error message with a pointer to the offending file attribute is presented to the user to resolve.
The following sections describe each of the valid operations and the required attributes to trigger the operation.
Copy
Copy file from ${WORKSPACE}/libraries/lib_nvidia.so to
${TARGET_DIRECTORY}/usr/lib/lib_nvidia.so with
ownership
root:root and permission 0777; where
${TARGET_DIRECTORY} is the target directory provided to CopyTarget,
pdk_sdk_installed_path is the source type, and
${WORKSPACE} is the workspace directory provided to CopyTarget.
|
Attribute |
Requirement |
Example |
|---|---|---|
|
destination |
Required. |
/usr/lib/lib_nvidia.so |
|
source |
Required (unless an imported manifest already defines it). |
pdk_sdk_installed_path: libraries/lib_nvidia.so |
|
perm |
Required (unless an imported manifest already defines it). |
0777 |
|
owner |
Required (unless an imported manifest already defines it). |
root |
|
group |
Required (unless an imported manifest already defines it). |
root |
|
create_symlink |
Can be absent (default is false) or must be set to false. |
false |
|
remove |
Can be absent (default is false) or must be set to false. |
false |
Create Directory
Create directory at ${TARGET_DIRECTORY}/
usr
/lib/
nvidia
with ownership
root:root and permission 0777; where ${TARGET_DIRECTORY} is the target
directory provided to CopyTarget.
|
Attribute |
Requirement |
Examples |
|---|---|---|
|
destination |
Required (must end with a trailing slash; otherwise, an error is reported). |
/usr/lib/nvidia/ |
|
source |
Must be absent. |
|
|
perm |
Required (unless an imported manifest already defines it). |
0777 |
|
owner |
Required (unless an imported manifest already defines it). |
root |
|
group |
Required (unless an imported manifest already defines it). |
root |
|
create_symlink |
Can be absent (default is false) or must be set to false. |
false |
|
remove |
Can be absent (default is false) or must be set to false. |
false |
Update File Metadata
Set file ${TARGET_DIRECTORY}/usr/lib/lib_nvidia.so with ownership nvidia:nvidia and permission 0644; where ${TARGET_DIRECTORY} is the target directory provided to CopyTarget.
|
Attribute |
Requirement |
Example |
|---|---|---|
|
destination |
Required. |
/usr/lib/lib_nvidia.so |
|
source |
Must be absent. |
|
|
perm |
Required (unless an imported manifest already defines it). |
0644 |
|
owner |
Required (unless an imported manifest already defines it). |
nvidia |
|
group |
Required (unless an imported manifest already defines it). |
nvidia |
|
create_symlink |
Can be absent (default is false) or must be set to false. |
false |
|
remove |
Can be absent (default is false) or must be set to false. |
false |
Update Directory Metadata
Set directory ${TARGET_DIRECTORY}/
usr
/lib/
nvidia with ownership
nvidia:nvidia and permission 0644; where ${TARGET_DIRECTORY} is the target
directory provided to CopyTarget.
|
Attribute |
Requirement |
Example |
|---|---|---|
|
destination |
Required. |
/usr/lib/nvidia/ |
|
source |
Must be absent. |
|
|
perm |
Required (unless an imported manifest already defines it). |
0644 |
|
owner |
Required (unless an imported manifest already defines it). |
nvidia |
|
group |
Required (unless an imported manifest already defines it). |
nvidia |
|
create_symlink |
Can be absent (default is false) or must be set to false. |
false |
|
remove |
Can be absent (default is false) or must be set to false. |
false |
Remove a File
Remove file ${TARGET_DIRECTORY}/
usr
/lib/lib_nvidia.so; where ${TARGET_DIRECTORY} is the target directory provided to
CopyTarget.
|
Attribute |
Requirement |
Example |
|---|---|---|
|
destination |
Required. |
/usr/lib/lib_nvidia.so |
|
source |
Should be absent. |
- |
|
perm |
Should be absent (if specified, is ignored). |
- |
|
owner |
Should be absent (if specified, is ignored). |
- |
|
group |
Should be absent (if specified, is ignored). |
- |
|
create_symlink |
Should be absent (default is false) or must be set to false. Setting this to true causes an error to be thrown. |
false |
|
remove |
Must be set to true. (unless an imported manifest already defines it). |
true |
Remove Empty Directory
Remove empty directory ${TARGET_DIRECTORY}/
usr
/lib/
nvidia
/; where ${TARGET_DIRECTORY} is the target directory provided to CopyTarget.
|
Attribute |
Requirement |
Example |
|---|---|---|
|
destination |
Required. |
/usr/lib/nvidia/ |
|
source |
Should be absent. |
- |
|
perm |
Should be absent (if specified, is ignored). |
- |
|
owner |
Should be absent (if specified, is ignored). |
- |
|
group |
Should be absent (if specified, is ignored). |
- |
|
create_symlink |
Must be set to false (unless an imported manifest already defines it). Setting this to true causes an error to be thrown. |
false |
|
remove |
Must be set to true (unless an imported manifest already defines it). |
true |
Create Symlink
Create symlink
at ${TARGET_DIRECTORY}/
usr
/lib/lib_nvidia.so.1 pointing to /
usr
/lib/lib_nvidia.so; where ${TARGET_DIRECTORY} is the target directory provided to
CopyTarget.
|
Attribute |
Requirement |
Example |
|---|---|---|
|
destination |
Required. |
/usr/lib/lib_nvidia.so.1 |
|
source |
Required (unless an imported manifest already defines it). |
pdk_sdk_installed_path: /usr/lib/lib_nvidia.so |
|
perm |
Should be absent (if specified, is ignored). |
- |
|
owner |
Required (unless an imported manifest already defines it). |
nvidia |
|
group |
Required (unless an imported manifest already defines it). |
nvidia |
|
create_symlink |
Must be set to true (unless an imported manifest already defines it). |
true |
|
remove |
Must be set to false (unless an imported manifest already defines it). Setting this to true causes an error to be thrown. |
false |