2005-09-20 21:31:55 +08:00
\section jobs jobs - print currently running jobs
2013-04-22 09:13:18 +08:00
\subsection jobs-synopsis Synopsis
2014-08-01 20:25:41 +08:00
\fish{synopsis}
2014-08-01 10:37:32 +08:00
jobs [OPTIONS] [PID]
\endfish
2005-09-20 21:31:55 +08:00
\subsection jobs-description Description
2014-08-19 20:41:23 +08:00
`jobs` prints a list of the currently running <a href="index.html#syntax-job-control">jobs</a> and their status.
2005-09-20 21:31:55 +08:00
2005-12-12 07:30:01 +08:00
jobs accepts the following switches:
2014-08-01 10:37:32 +08:00
- `-c` or `--command` prints the command name for each process in jobs.
2014-08-19 20:41:23 +08:00
2014-08-01 10:37:32 +08:00
- `-g` or `--group` only prints the group ID of each job.
2014-08-19 20:41:23 +08:00
2014-08-01 10:37:32 +08:00
- `-l` or `--last` prints only the last job to be started.
2014-08-19 20:41:23 +08:00
2014-08-01 10:37:32 +08:00
- `-p` or `--pid` prints the process ID for each process in all jobs.
2005-12-12 07:30:01 +08:00
2018-03-05 05:21:31 +08:00
- `-q` or `--quiet` prints no output for evaluation of jobs by exit code only.
2014-08-19 20:41:23 +08:00
On systems that supports this feature, jobs will print the CPU usage of each job since the last command was executed. The CPU usage is expressed as a percentage of full CPU activity. Note that on multiprocessor systems, the total activity may be more than 100\%.
2018-03-05 05:21:31 +08:00
The exit code of the `jobs` builtin is `0` if there are running background jobs and `1` otherwise.
\subsection prints no output.
Help cleanup
Large list of changes, including formatting and typos for most commands.
More substantive changes have been made to alias, bind, block, break,
builtin, case, cd, commandline, count, else, emit, fish_config, funced,
function, functions, history, math, mimedb, nextd, not, popd, prevd,
pushd, pwd, random, read, set, set_color, switch, test, trap, type,
ulimit, umask, and while.
2013-05-12 15:56:01 +08:00
\subsection jobs-example Example
2014-08-01 10:37:32 +08:00
`jobs` outputs a summary of the current jobs.