mirror of
https://github.com/fish-shell/fish-shell
synced 2024-11-10 15:14:44 +00:00
3a23fdf359
Includes harmonizing the display of options and arguments, standardising terminology, using the envvar directive more broadly, adding help options to all commands that support them, simplifying some language, and tidying up multiple formatting issues. string documentation is not changed.
56 lines
1.7 KiB
ReStructuredText
56 lines
1.7 KiB
ReStructuredText
.. _cmd-jobs:
|
|
|
|
jobs - print currently running jobs
|
|
===================================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
.. synopsis::
|
|
|
|
jobs [OPTIONS] [PID | %JOBID]
|
|
|
|
|
|
Description
|
|
-----------
|
|
|
|
``jobs`` prints a list of the currently running :ref:`jobs <syntax-job-control>` and their status.
|
|
|
|
``jobs`` accepts the following options:
|
|
|
|
**-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 **--query**
|
|
Prints no output for evaluation of jobs by exit status only. For compatibility with old fish versions this is also **--quiet** (but this is deprecated).
|
|
|
|
**-h** or **--help**
|
|
Displays help about using this command.
|
|
|
|
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\%.
|
|
|
|
Arguments of the form *PID* or *%JOBID* restrict the output to jobs with the selected process identifiers or job numbers respectively.
|
|
|
|
If the output of ``jobs`` is redirected or if it is part of a command substitution, the column header that is usually printed is omitted, making it easier to parse.
|
|
|
|
The exit status of ``jobs`` is ``0`` if there are running background jobs and ``1`` otherwise.
|
|
|
|
Example
|
|
-------
|
|
|
|
``jobs`` outputs a summary of the current jobs, such as two long-running tasks in this example:
|
|
|
|
.. code-block:: none
|
|
|
|
Job Group State Command
|
|
2 26012 running nc -l 55232 < /dev/random &
|
|
1 26011 running python tests/test_11.py &
|