Skip to content

Commit

Permalink
Clarify whether env vars will be expanded
Browse files Browse the repository at this point in the history
  • Loading branch information
caizixian committed Nov 20, 2023
1 parent fdbd1ac commit 6d76db7
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 0 deletions.
9 changes: 9 additions & 0 deletions docs/src/references/modifier.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
`var`: name of the variable.

`val`: value of the variable.
Environment variables will be expanded.

### Description
Set an environment variable. Might override an environment variable inherited from the parent process.
Expand All @@ -14,6 +15,7 @@ Set an environment variable. Might override an environment variable inherited fr
### Keys
`val`: a single string with [shell-like syntax](https://docs.python.org/3/library/shlex.html#shlex.split).
Multiple arguments are space separated.
Environment variables will be expanded.

### Description
Specify arguments to a JVM, as opposed to the program.
Expand All @@ -23,6 +25,7 @@ Specify arguments to a JVM, as opposed to the program.
### Keys
`val`: a single string with [shell-like syntax](https://docs.python.org/3/library/shlex.html#shlex.split).
Multiple arguments are space separated.
Environment variables will be expanded.

### Description
Specify arguments to a JavaScript runtime (e.g., `d8`), as opposed to the program.
Expand All @@ -32,6 +35,7 @@ Specify arguments to a JavaScript runtime (e.g., `d8`), as opposed to the progra
### Keys
`val`: a single string with [shell-like syntax](https://docs.python.org/3/library/shlex.html#shlex.split).
Multiple classpaths are space separated.
Environment variables will be expanded.

### Description
Append a list of classpaths to the existing classpaths.
Expand All @@ -41,17 +45,20 @@ Append a list of classpaths to the existing classpaths.
### Keys
`val`: a single string with [shell-like syntax](https://docs.python.org/3/library/shlex.html#shlex.split).
Multiple classpaths are space separated.
Environment variables will be expanded.

### Description
Prepend a list of classpaths to the existing classpaths.

## `JVMClasspath`
A backward-compatibility alias of `JVMClasspathAppend`.
Environment variables will be expanded.

## `ProgramArg`
### Keys
`val`: a single string with [shell-like syntax](https://docs.python.org/3/library/shlex.html#shlex.split).
Multiple arguments are space separated.
Environment variables will be expanded.

### Description
Specify arguments to a program, as opposed to the runtime.
Expand All @@ -68,6 +75,7 @@ That is, you can use `ModifierSet` recursively.
### Keys
`val`: a single string with [shell-like syntax](https://docs.python.org/3/library/shlex.html#shlex.split).
Multiple arguments are space separated.
Environment variables will be expanded.

### Description
Specify a wrapper.
Expand All @@ -87,3 +95,4 @@ If a companion program also exist for the benchmark suite you use, this companio
### Keys
`val`: a single string with [shell-like syntax](https://docs.python.org/3/library/shlex.html#shlex.split).
Multiple arguments are space separated.
Environment variables will be expanded.
5 changes: 5 additions & 0 deletions docs/src/references/runtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,20 +13,25 @@ tandem with
## `D8` (preview ⚠️)
### Keys
`executable`: path to the `d8` executable.
Environment variables will be expanded.

## `SpiderMonkey` (preview ⚠️)
### Keys
`executable`: path to the `js` executable.
Environment variables will be expanded.

## `JavaScriptCore` (preview ⚠️)
### Keys
`executable`: path to the `jsc` executable.
Environment variables will be expanded.

## `JuliaMMTK` (preview ⚠️)
### Keys
`executable`: path to the `julia` executable.
Environment variables will be expanded.

## `JuliaStock` (preview ⚠️)
Julia with the stock GC. It does not allow setting a heap size, and will not throw OOM unless killed by the operating system.
### Keys
`executable`: path to the `julia` executable.
Environment variables will be expanded.
5 changes: 5 additions & 0 deletions docs/src/references/suite.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ The value is required.

`path`: path to the DaCapo `jar`.
The value is required.
Environment variables will be expanded.

`minheap`: a string that selects one of the `minheap_values` sets to use.

Expand Down Expand Up @@ -120,6 +121,7 @@ The value is required.
`path`: path to the `jar`.
The value is required.
Note that the property file should reside in `path/../config/specjbb2015.props` per the standard folder structure of the ISO image provided by SPEC.
Environment variables will be expanded.

### Benchmark Specification
Only strings are allowed, which should correspond to the the mode of the SPECjbb2015 controller.
Expand Down Expand Up @@ -154,6 +156,7 @@ The value is required.

`path`: path to the SPECjvm98 folder, where you can find `SpecApplication.class`.
The value is required.
Environment variables will be expanded.

`timing_iteration`: specifying the timing iteration.
It can only be a number, which is passed to SpecApplication as `-i`.
Expand All @@ -175,6 +178,7 @@ The following are the benchmarks:
### Keys
`path`: path to the Octane benchmark folder.
The value is required.
Environment variables will be expanded.

`wrapper`: path to the Octane wrapper written by Wenyu Zhao.
The value is required.
Expand Down Expand Up @@ -206,6 +210,7 @@ GC benchmarks for Julia: https://github.com/JuliaCI/GCBenchmarks
### Keys
`path`: path to the GCBenchmarks folder.
The value is required.
Environment variables will be expanded.

`minheap`: a string that selects one of the `minheap_values` sets to use.

Expand Down

0 comments on commit 6d76db7

Please sign in to comment.