Skip to content

Commit 3fb7d4b

Browse files
committed
config: Bump POSIX spec references to IEEE Std 1003.1-2008, 2016 Edition
These references had been using IEEE Std 1003.1, 2004 Edition, but: $ curl -s http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap08.html | grep -B2 'newer edition' <center><font size="2">The Open Group Base Specifications Issue 6<br> IEEE Std 1003.1, 2004 Edition<br> Copyright &copy; 2001-2004 The IEEE and The Open Group, All Rights reserved.</font></center><center><font color="red">A newer edition of this document exists <a href="http://pubs.opengroup.org/onlinepubs/9699919799/" target="_parent">here</a></font></center> Shifting to 2016 also syncs us with the 'file' reference in config-linux.md. The initial reasoning for the 2004 edition is unclear to me (more on that in 70858bc, config: Adjust process.args to cite POSIX's execvp, 2016-05-19, #427), The change-log for the exec page [1] doesn't list any relevant changes, and skimming a diff of the two HTML pages didn't turn up anything significant. Diffing the two HTML pages for environment variables also turned up no significant changes. Both definition reference the Portable Character Set for uppercase letters, digits, and underscore, but the U#### values for those have not changed [2,3]. [1]: http://pubs.opengroup.org/onlinepubs/9699919799/functions/exec.html#tag_16_111_14 [2]: http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap06.html#tag_06_01 [3]: http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap06.html#tag_06_01 Signed-off-by: W. Trevor King <[email protected]>
1 parent f79b61d commit 3fb7d4b

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

config.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -142,8 +142,8 @@ For all platform-specific configuration values, the scope defined below in the [
142142
* **`width`** (uint, REQUIRED)
143143
* **`cwd`** (string, REQUIRED) is the working directory that will be set for the executable.
144144
This value MUST be an absolute path.
145-
* **`env`** (array of strings, OPTIONAL) with the same semantics as [IEEE Std 1003.1-2001's `environ`][ieee-1003.1-2001-xbd-c8.1].
146-
* **`args`** (array of strings, REQUIRED) with similar semantics to [IEEE Std 1003.1-2001 `execvp`'s *argv*][ieee-1003.1-2001-xsh-exec].
145+
* **`env`** (array of strings, OPTIONAL) with the same semantics as [IEEE Std 1003.1-2008's `environ`][ieee-1003.1-2008-xbd-c8.1].
146+
* **`args`** (array of strings, REQUIRED) with similar semantics to [IEEE Std 1003.1-2008 `execvp`'s *argv*][ieee-1003.1-2008-xsh-exec].
147147
This specification extends the IEEE standard in that at least one entry is REQUIRED, and that entry is used with the same semantics as `execvp`'s *file*.
148148
* **`capabilities`** (object, OPTIONAL) is an object containing arrays that specifies the sets of capabilities for the process(es) inside the container.
149149
Valid values are platform-specific.
@@ -375,10 +375,10 @@ On Linux, they are run after the container namespaces are created.
375375
* **`hooks`** (object, OPTIONAL) MAY contain any of the following properties:
376376
* **`prestart`** (array of objects, OPTIONAL) is an array of [pre-start hooks](#prestart).
377377
Entries in the array contain the following properties:
378-
* **`path`** (string, REQUIRED) with similar semantics to [IEEE Std 1003.1-2001 `execv`'s *path*][ieee-1003.1-2001-xsh-exec].
378+
* **`path`** (string, REQUIRED) with similar semantics to [IEEE Std 1003.1-2008 `execv`'s *path*][ieee-1003.1-2008-functions-exec].
379379
This specification extends the IEEE standard in that **`path`** MUST be absolute.
380-
* **`args`** (array of strings, OPTIONAL) with the same semantics as [IEEE Std 1003.1-2001 `execv`'s *argv*][ieee-1003.1-2001-xsh-exec].
381-
* **`env`** (array of strings, OPTIONAL) with the same semantics as [IEEE Std 1003.1-2001's `environ`][ieee-1003.1-2001-xbd-c8.1].
380+
* **`args`** (array of strings, OPTIONAL) with the same semantics as [IEEE Std 1003.1-2008 `execv`'s *argv*][ieee-1003.1-2008-functions-exec].
381+
* **`env`** (array of strings, OPTIONAL) with the same semantics as [IEEE Std 1003.1-2008's `environ`][ieee-1003.1-2008-xbd-c8.1].
382382
* **`timeout`** (int, OPTIONAL) is the number of seconds before aborting the hook.
383383
If set, `timeout` MUST be greater than zero.
384384
* **`poststart`** (array of objects, OPTIONAL) is an array of [post-start hooks](#poststart).
@@ -854,8 +854,8 @@ Here is a full example `config.json` for reference.
854854
[procfs_2]: https://www.kernel.org/doc/Documentation/filesystems/proc.txt
855855
[semver-v2.0.0]: http://semver.org/spec/v2.0.0.html
856856
[go-environment]: https://golang.org/doc/install/source#environment
857-
[ieee-1003.1-2001-xbd-c8.1]: http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap08.html#tag_08_01
858-
[ieee-1003.1-2001-xsh-exec]: http://pubs.opengroup.org/onlinepubs/009695399/functions/exec.html
857+
[ieee-1003.1-2008-xbd-c8.1]: http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap08.html#tag_08_01
858+
[ieee-1003.1-2008-xsh-exec]: http://pubs.opengroup.org/onlinepubs/9699919799/functions/exec.html
859859
[naming-a-volume]: https://aka.ms/nb3hqb
860860

861861
[capabilities.7]: http://man7.org/linux/man-pages/man7/capabilities.7.html

0 commit comments

Comments
 (0)