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 abreakpointcommand. See also thefish_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. Alsocurrent-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). Alsocurrent-function,-uor--current-function.line-numberprints the line number of the currently running script. Alsocurrent-line-number,-nor--current-line-number.stack-traceprints a stack trace of all function calls on the call stack. Alsoprint-stack-trace,-tor--print-stack-trace.job-control CONTROL-TYPEsets the job control type, which can benone,full, orinteractive. 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.