2019-03-31 17:05:09 +08:00
.. _cmd-jobs:
2018-12-17 09:39:33 +08:00
jobs - print currently running jobs
2019-01-03 12:10:47 +08:00
===================================
2018-12-17 09:39:33 +08:00
2018-12-18 09:58:24 +08:00
Synopsis
--------
2018-12-17 05:08:41 +08:00
2019-09-17 17:59:04 +08:00
::
jobs [OPTIONS] [PID]
2018-12-18 09:58:24 +08:00
2018-12-17 05:08:41 +08:00
2018-12-19 10:44:30 +08:00
Description
2019-01-03 12:10:47 +08:00
-----------
2018-12-17 05:08:41 +08:00
2019-03-31 03:44:07 +08:00
`` jobs `` prints a list of the currently running `jobs <index.html#syntax-job-control> `__ and their status.
2018-12-17 05:08:41 +08:00
jobs accepts the following switches:
2018-12-20 04:02:45 +08:00
- `` -c `` or `` --command `` prints the command name for each process in jobs.
2018-12-17 05:08:41 +08:00
2018-12-20 04:02:45 +08:00
- `` -g `` or `` --group `` only prints the group ID of each job.
2018-12-17 05:08:41 +08:00
2018-12-20 04:02:45 +08:00
- `` -l `` or `` --last `` prints only the last job to be started.
2018-12-17 05:08:41 +08:00
2018-12-20 04:02:45 +08:00
- `` -p `` or `` --pid `` prints the process ID for each process in all jobs.
2018-12-17 05:08:41 +08:00
2019-09-17 16:31:39 +08:00
- `` -q `` or `` --quiet `` prints no output for evaluation of jobs by exit status only.
2018-12-17 05:08:41 +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\%.
2019-09-17 16:31:39 +08:00
The exit status of the `` jobs `` builtin is `` 0 `` if there are running background jobs and `` 1 `` otherwise.
2018-12-17 05:08:41 +08:00
2018-12-19 10:44:30 +08:00
no output.
2019-01-03 12:10:47 +08:00
----------
2018-12-17 05:08:41 +08:00
2018-12-19 10:44:30 +08:00
Example
2019-01-03 12:10:47 +08:00
-------
2018-12-17 05:08:41 +08:00
2018-12-20 04:02:45 +08:00
`` jobs `` outputs a summary of the current jobs.