aboutsummaryrefslogtreecommitdiffhomepage
path: root/tools/build_defs/pkg/README.md
diff options
context:
space:
mode:
authorGravatar Damien Martin-Guillerez <dmarting@google.com>2017-04-20 18:35:44 +0200
committerGravatar Vladimir Moskva <vladmos@google.com>2017-04-24 16:49:14 +0200
commit55928504a6c44629ebc1c54deef6282206def63f (patch)
tree4b7069a0ed7895cb8f8cd4251fb94e015c5c9260 /tools/build_defs/pkg/README.md
parent2c4dd1f3176371473667c551cd5a5ae5992f8154 (diff)
Add possibility to set ownership of files on pkg_tar
Change-Id: Ic8c57c0ce78b5875135d5d1f19629ee40fd8f5f2 PiperOrigin-RevId: 153718869
Diffstat (limited to 'tools/build_defs/pkg/README.md')
-rw-r--r--tools/build_defs/pkg/README.md66
1 files changed, 65 insertions, 1 deletions
diff --git a/tools/build_defs/pkg/README.md b/tools/build_defs/pkg/README.md
index 4369777cd7..4777c79ba6 100644
--- a/tools/build_defs/pkg/README.md
+++ b/tools/build_defs/pkg/README.md
@@ -188,7 +188,71 @@ Creates a tar file from a list of inputs.
<p>
<code>
modes = {
- "tools/py/2to3.sh": "0755
+ "tools/py/2to3.sh": "0755",
+ ...
+ },
+ </code>
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>owner</code></td>
+ <td>
+ <code>String, default to '0.0'</code>
+ <p>
+ <code>UID.GID</code> to set the default numeric owner for all files
+ provided in <code>files</code>.
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>owners</code></td>
+ <td>
+ <code>Dictionary, default to '{}'</code>
+ <p>
+ A string dictionary to change default owner of specific files from
+ <code>files</code>. Each key should be a path to a file before
+ appending the prefix <code>package_dir</code> and the corresponding
+ value the <code>UID.GID</code> numeric string for the owner of the
+ file. When determining owner ids, this attribute is looked first then
+ <code>owner</code>.
+ </p>
+ <p>
+ <code>
+ owners = {
+ "tools/py/2to3.sh": "42.24",
+ ...
+ },
+ </code>
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>ownername</code></td>
+ <td>
+ <code>String, optional</code>
+ <p>
+ <code>username.groupname</code> to set the default owner for all files
+ provided in <code>files</code> (by default there is no owner names).
+ </p>
+ </td>
+ </tr>
+ <tr>
+ <td><code>ownernames</code></td>
+ <td>
+ <code>Dictionary, default to '{}'</code>
+ <p>
+ A string dictionary to change default owner of specific files from
+ <code>files</code>. Each key should be a path to a file before
+ appending the prefix <code>package_dir</code> and the corresponding
+ value the <code>username.groupname</code> string for the owner of the
+ file. When determining ownernames, this attribute is looked first then
+ <code>ownername</code>.
+ </p>
+ <p>
+ <code>
+ owners = {
+ "tools/py/2to3.sh": "leeroy.jenkins",
...
},
</code>