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