Why Sponsor Oils? | source | all docs for version 0.19.0 | all versions | oilshell.org

Warning: Work in progress! Leave feedback on Zulip or Github if you'd like this doc to be updated.

Special Variables

This chapter in the Oils Reference describes special variables for OSH and YSH.

Shell Vars

`ARGV`

Replacement for "$@"

`_DIALECT`

Name of a dialect being evaluated.

`_this_dir`

The directory the current script resides in. This knows about 3 situations:

The location of oshrc in an interactive shell
The location of the main script, e.g. in osh myscript.sh
The location of script loaded with the source builtin

It's useful for "relative imports".

Platform

OIL_VERSION

The version of Oil that is being run, e.g. 0.9.0.

Exit Status

`_status`

Set by the try builtin.

try ls /bad
if (_status !== 0) {
  echo 'failed'
}

`_pipeline_status`

Alias for PIPESTATUS.

`_process_sub_status`

The exit status of all the process subs in the last command.

Tracing

SHX_indent

SHX_punct

SHX_pid_str

Environment Variables

Shell Options

SHELLOPTS

For the 'set' builtin.

BASHOPTS

For the 'shopt' builtin.

Other Env

HOME

$HOME is used for:

~ expansion
~ abbreviation in the UI (the dirs builtin, \W in $PS1).

Note: The shell doesn't set $HOME. According to POSIX, the program that invokes the login shell sets it based on /etc/passwd.

PATH

A colon-separated string that's used to find executables to run.

IFS

Used for word splitting. And the builtin split() function.

Oil Paths