fish-shell/doc_src/cmds/jobs.rst
Fabian Homborg fd45877848 docs: Link builtins
When we say "the XYZ command/builtin", we should typically include a
link. The exceptions are

- In the documentation for that command - no need to link to ulimit in
  the ulimit page
- When we've already linked before - not every thing needs to be
  clickable, or clicking it will cause the browser to mark fifty words
  as visited. This is roughly what wikipedia does for crosslinks.

[ci skip]
2020-03-21 15:31:25 +01:00

43 lines
1.1 KiB
ReStructuredText

.. _cmd-jobs:
jobs - print currently running jobs
===================================
Synopsis
--------
::
jobs [OPTIONS] [PID]
Description
-----------
``jobs`` prints a list of the currently running :ref:`jobs <syntax-job-control>` and their status.
jobs accepts the following switches:
- ``-c`` or ``--command`` prints the command name for each process in jobs.
- ``-g`` or ``--group`` only prints the group ID of each job.
- ``-l`` or ``--last`` prints only the last job to be started.
- ``-p`` or ``--pid`` prints the process ID for each process in all jobs.
- ``-q`` or ``--quiet`` prints no output for evaluation of jobs by exit status only.
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\%.
The exit status of ``jobs`` is ``0`` if there are running background jobs and ``1`` otherwise.
no output.
----------
Example
-------
``jobs`` outputs a summary of the current jobs.