Skip to content

Commit

Permalink
runtime: Drop the 'version' command
Browse files Browse the repository at this point in the history
Having a 'version' command to make it easy for a caller to report
which runtime they're using.  But we don't have a use-case that makes
it strictly necessary for interop, so we're leaving it out for now
[1].

[1]: http://ircbot.wl.linuxfoundation.org/meetings/opencontainers/2016/opencontainers.2016-07-20-21.03.log.html#l-75

Signed-off-by: W. Trevor King <wking@tremily.us>
  • Loading branch information
wking committed Feb 9, 2017
1 parent 5d0e44c commit 4c7901c
Showing 1 changed file with 1 addition and 24 deletions.
25 changes: 1 addition & 24 deletions runtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,33 +29,10 @@ Beyond the above rules, the behavior of the runtime in the presence of commands
## Character encodings

This API specification does not cover character encodings, but runtimes SHOULD conform to their native operating system.
For example, POSIX systems define [`LANG` and related environment variables][posix-lang] for [declaring][posix-locale-encoding] [locale-specific character encodings][posix-encoding], so a runtime in an `en_US.UTF-8` locale SHOULD write its [version](#version) to stdout in [UTF-8][].
For example, POSIX systems define [`LANG` and related environment variables][posix-lang] for [declaring][posix-locale-encoding] [locale-specific character encodings][posix-encoding], so a runtime in an `en_US.UTF-8` locale SHOULD write its [state](#state) to stdout in [UTF-8][].

## Commands

### version

Print the runtime version and exit.

* *Options* None are required, but the runtime MAY support options.
* *Standard streams*
* *stdin:* The runtime MUST NOT attempt to read from its stdin.
* *stdout:* The runtime MUST print its name, a space, and its version as the first line to its stdout.
The name MAY contain any Unicode characters, but MUST NOT contain control codes or newlines.
The runtime MAY print additional lines to its stdout, and the format for those lines is not specified in this document.
* *stderr:* The runtime MAY print diagnostic messages to stderr, and the format for those lines is not specified in this document.
* *Exit code:* The runtime MUST exit with zero.

#### Example

```
$ funC version
funC 1.0.0
Built for x86_64-pc-linux-gnu
$ echo $?
0
```

### start

Start a container from a bundle directory.
Expand Down

0 comments on commit 4c7901c

Please sign in to comment.