status - query fish runtime information¶
Synopsis¶
status
status is-login
status is-interactive
status is-block
status is-breakpoint
status is-command-substitution
status is-no-job-control
status is-full-job-control
status is-interactive-job-control
status current-command
status filename
status fish-path
status function
status line-number
status stack-trace
status job-control CONTROL-TYPE
status features
status test-feature FEATURE
Description¶
With no arguments, status displays a summary of the current login and job control status of the shell.
The following operations (sub-commands) are available:
- is-command-substitutionreturns 0 if fish is currently executing a command substitution. Also- -cor- --is-command-substitution.
- is-blockreturns 0 if fish is currently executing a block of code. Also- -bor- --is-block.
- is-breakpointreturns 0 if fish is currently showing a prompt in the context of a- breakpointcommand. See also the- fish_breakpoint_promptfunction.
- is-interactivereturns 0 if fish is interactive - that is, connected to a keyboard. Also- -ior- --is-interactive.
- is-loginreturns 0 if fish is a login shell - that is, if fish should perform login tasks such as setting up the PATH. Also- -lor- --is-login.
- is-full-job-controlreturns 0 if full job control is enabled. Also- --is-full-job-control(no short flag).
- is-interactive-job-controlreturns 0 if interactive job control is enabled. Also,- --is-interactive-job-control(no short flag).
- is-no-job-controlreturns 0 if no job control is enabled. Also- --is-no-job-control(no short flag).
- current-commandprints the name of the currently-running function or command, like the deprecated- _variable.
- filenameprints the filename of the currently running script. Also- current-filename,- -for- --current-filename.
- fish-pathprints the absolute path to the currently executing instance of fish.
- functionprints the name of the currently called function if able, when missing displays "Not a function" (or equivalent translated string). Also- current-function,- -uor- --current-function.
- line-numberprints the line number of the currently running script. Also- current-line-number,- -nor- --current-line-number.
- stack-traceprints a stack trace of all function calls on the call stack. Also- print-stack-trace,- -tor- --print-stack-trace.
- job-control CONTROL-TYPEsets the job control type, which can be- none,- full, or- interactive. Also- -j CONTROL-TYPEor- --job-control=CONTROL-TYPE.
- featureslists all available feature flags.
- test-feature FEATUREreturns 0 when FEATURE is enabled, 1 if it is disabled, and 2 if it is not recognized.
Notes¶
For backwards compatibility each subcommand can also be specified as a long or short option. For example, rather than status is-login you can type status --is-login. The flag forms are deprecated and may be removed in a future release (but not before fish 3.0).
You can only specify one subcommand per invocation even if you use the flag form of the subcommand.