On second thought, rename this field to 'pid'.

This is more consistent with the already existing 'tid' field. It's not just a UUID, it's an identifier of the running process.
NuxiNL · Nov 8, 2017 · 8957360 · 8957360
1 parent 0713454
commit 8957360
Show file tree

Hide file tree

Showing 4 changed files with 37 additions and 37 deletions.
diff --git a/cloudabi.txt b/cloudabi.txt
@@ -137,6 +137,16 @@ enum uint32 auxtype
 		| executable.
 	4   phnum
 		| Number of ELF program headers of the executable.
+	263 pid
+		| Identifier of the process.
+		|
+		| This environment does not provide any simple numerical
+		| process identifiers, for the reason that these are not
+		| useful in distributed contexts. Instead, processes are
+		| identified by a UUID.
+		|
+		| This record should point to sixteen bytes of binary
+		| data, containing a version 4 UUID (fully random).
 	262 sysinfo_ehdr
 		| Address of the ELF header of the vDSO.
 		|
@@ -160,16 +170,6 @@ enum uint32 auxtype
 		| system calls.
 	261 tid
 		| Thread ID of the initial thread of the process.
-	263 uuid
-		| Universally unique identifier of the process.
-		|
-		| This environment does not provide any simple numerical
-		| process identifiers, for the reason that these are not
-		| useful in distributed contexts. Instead, processes are
-		| identified by a UUID.
-		|
-		| This record should point to sixteen bytes of binary
-		| data, containing a version 4 UUID (fully random).
 
 enum uint32 clockid
 	| Identifiers for clocks.
@@ -952,7 +952,7 @@ struct auxv
 		argdatalen canarylen ncpus pagesz phnum tid
 			size a_val
 				| A numerical value.
-		argdata base canary phdr sysinfo_ehdr uuid
+		argdata base canary phdr pid sysinfo_ehdr
 			ptr void a_ptr
 				| A pointer value.
 

diff --git a/docs/cloudabi.html b/docs/cloudabi.html
@@ -1490,6 +1490,17 @@ <h4><a href="#auxtype" name="auxtype"></a><code>cloudabi_auxtype_t</code> (<code
 <li><p><a href="#auxtype.phnum" name="auxtype.phnum"></a><strong><code>CLOUDABI_AT_PHNUM</code></strong></p>
 
 <p>Number of ELF program headers of the executable.</p></li>
+<li><p><a href="#auxtype.pid" name="auxtype.pid"></a><strong><code>CLOUDABI_AT_PID</code></strong></p>
+
+<p>Identifier of the process.</p>
+
+<p>This environment does not provide any simple numerical
+process identifiers, for the reason that these are not
+useful in distributed contexts. Instead, processes are
+identified by a UUID.</p>
+
+<p>This record should point to sixteen bytes of binary
+data, containing a version 4 UUID (fully random).</p></li>
 <li><p><a href="#auxtype.sysinfo_ehdr" name="auxtype.sysinfo_ehdr"></a><strong><code>CLOUDABI_AT_SYSINFO_EHDR</code></strong></p>
 
 <p>Address of the ELF header of the vDSO.</p>
@@ -1515,17 +1526,6 @@ <h4><a href="#auxtype" name="auxtype"></a><code>cloudabi_auxtype_t</code> (<code
 <li><p><a href="#auxtype.tid" name="auxtype.tid"></a><strong><code>CLOUDABI_AT_TID</code></strong></p>
 
 <p>Thread ID of the initial thread of the process.</p></li>
-<li><p><a href="#auxtype.uuid" name="auxtype.uuid"></a><strong><code>CLOUDABI_AT_UUID</code></strong></p>
-
-<p>Universally unique identifier of the process.</p>
-
-<p>This environment does not provide any simple numerical
-process identifiers, for the reason that these are not
-useful in distributed contexts. Instead, processes are
-identified by a UUID.</p>
-
-<p>This record should point to sixteen bytes of binary
-data, containing a version 4 UUID (fully random).</p></li>
 </ul>
 
 <h4><a href="#auxv" name="auxv"></a><code>cloudabi_auxv_t</code> (<code>struct</code>)</h4>
@@ -1556,7 +1556,7 @@ <h4><a href="#auxv" name="auxv"></a><code>cloudabi_auxv_t</code> (<code>struct</
 
 <p>A numerical value.</p></li>
 </ul></li>
-<li><p>When <code>a_type</code> is <a href="#auxtype.argdata"><code>CLOUDABI_AT_ARGDATA</code></a>, <a href="#auxtype.base"><code>CLOUDABI_AT_BASE</code></a>, <a href="#auxtype.canary"><code>CLOUDABI_AT_CANARY</code></a>, <a href="#auxtype.phdr"><code>CLOUDABI_AT_PHDR</code></a>, <a href="#auxtype.sysinfo_ehdr"><code>CLOUDABI_AT_SYSINFO_EHDR</code></a>, or <a href="#auxtype.uuid"><code>CLOUDABI_AT_UUID</code></a>:</p>
+<li><p>When <code>a_type</code> is <a href="#auxtype.argdata"><code>CLOUDABI_AT_ARGDATA</code></a>, <a href="#auxtype.base"><code>CLOUDABI_AT_BASE</code></a>, <a href="#auxtype.canary"><code>CLOUDABI_AT_CANARY</code></a>, <a href="#auxtype.phdr"><code>CLOUDABI_AT_PHDR</code></a>, <a href="#auxtype.pid"><code>CLOUDABI_AT_PID</code></a>, or <a href="#auxtype.sysinfo_ehdr"><code>CLOUDABI_AT_SYSINFO_EHDR</code></a>:</p>
 
 <ul>
 <li><p><a href="#auxv.a_ptr" name="auxv.a_ptr"></a><code>void *<strong>a_ptr</strong></code></p>

diff --git a/docs/cloudabi.md b/docs/cloudabi.md
@@ -1322,6 +1322,18 @@ Possible values:
 
     Number of ELF program headers of the executable.
 
+- <a href="#auxtype.pid" name="auxtype.pid"></a>**`CLOUDABI_AT_PID`**
+
+    Identifier of the process.
+
+    This environment does not provide any simple numerical
+    process identifiers, for the reason that these are not
+    useful in distributed contexts. Instead, processes are
+    identified by a UUID.
+
+    This record should point to sixteen bytes of binary
+    data, containing a version 4 UUID (fully random).
+
 - <a href="#auxtype.sysinfo_ehdr" name="auxtype.sysinfo_ehdr"></a>**`CLOUDABI_AT_SYSINFO_EHDR`**
 
     Address of the ELF header of the vDSO.
@@ -1349,18 +1361,6 @@ Possible values:
 
     Thread ID of the initial thread of the process.
 
-- <a href="#auxtype.uuid" name="auxtype.uuid"></a>**`CLOUDABI_AT_UUID`**
-
-    Universally unique identifier of the process.
-
-    This environment does not provide any simple numerical
-    process identifiers, for the reason that these are not
-    useful in distributed contexts. Instead, processes are
-    identified by a UUID.
-
-    This record should point to sixteen bytes of binary
-    data, containing a version 4 UUID (fully random).
-
 #### <a href="#auxv" name="auxv"></a>`cloudabi_auxv_t` (`struct`)
 
 Auxiliary vector entry.
@@ -1388,7 +1388,7 @@ Members:
 
         A numerical value.
 
-- When `a_type` is [`CLOUDABI_AT_ARGDATA`](#auxtype.argdata), [`CLOUDABI_AT_BASE`](#auxtype.base), [`CLOUDABI_AT_CANARY`](#auxtype.canary), [`CLOUDABI_AT_PHDR`](#auxtype.phdr), [`CLOUDABI_AT_SYSINFO_EHDR`](#auxtype.sysinfo_ehdr), or [`CLOUDABI_AT_UUID`](#auxtype.uuid):
+- When `a_type` is [`CLOUDABI_AT_ARGDATA`](#auxtype.argdata), [`CLOUDABI_AT_BASE`](#auxtype.base), [`CLOUDABI_AT_CANARY`](#auxtype.canary), [`CLOUDABI_AT_PHDR`](#auxtype.phdr), [`CLOUDABI_AT_PID`](#auxtype.pid), or [`CLOUDABI_AT_SYSINFO_EHDR`](#auxtype.sysinfo_ehdr):
 
     - <a href="#auxv.a_ptr" name="auxv.a_ptr"></a><code>void *<strong>a\_ptr</strong></code>
 

diff --git a/headers/cloudabi_types_common.h b/headers/cloudabi_types_common.h
@@ -56,9 +56,9 @@ typedef uint32_t cloudabi_auxtype_t;
 #define CLOUDABI_AT_PAGESZ         6
 #define CLOUDABI_AT_PHDR           3
 #define CLOUDABI_AT_PHNUM          4
+#define CLOUDABI_AT_PID          263
 #define CLOUDABI_AT_SYSINFO_EHDR 262
 #define CLOUDABI_AT_TID          261
-#define CLOUDABI_AT_UUID         263
 
 typedef uint32_t cloudabi_clockid_t;
 #define CLOUDABI_CLOCK_MONOTONIC          1