From 55928504a6c44629ebc1c54deef6282206def63f Mon Sep 17 00:00:00 2001
From: Damien Martin-Guillerez <dmarting@google.com>
Date: Thu, 20 Apr 2017 18:35:44 +0200
Subject: Add possibility to set ownership of files on pkg_tar

Change-Id: Ic8c57c0ce78b5875135d5d1f19629ee40fd8f5f2
PiperOrigin-RevId: 153718869
---
 tools/build_defs/pkg/README.md | 66 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 65 insertions(+), 1 deletion(-)

(limited to 'tools/build_defs/pkg/README.md')

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>
-- 
cgit v1.2.3