The jobs built-in reports job status.
Syntax
- 
jobs [-lnprs] [job…]
Description
The jobs built-in prints information of jobs the shell is currently controlling.
By default, the following information is printed for each job, line by line:
- 
the job number, 
- 
the +or-symbol if the job is the current or previous job, respectively,
- 
the status, and 
- 
the command string. 
Options
- 
-l
- 
--verbose
- 
Print the process ID, status, and command string for each process in the jobs. 
- 
-n
- 
--new
- 
Print new jobs only: jobs whose status has never been reported since the status changed. 
- 
-p
- 
--pgid-only
- 
Print process group IDs of jobs only. 
- 
-r
- 
--running-only
- 
Print running jobs only. 
- 
-s
- 
--stopped-only
- 
Print stopped jobs only. 
Operands
- jobs
- 
The job IDs of jobs to be reported. When no job is specified, all jobs under the shell’s control are reported. 
Exit status
The exit status of the jobs built-in is zero unless there is any error.
Notes
The jobs built-in is a semi-special built-in.
The POSIX standard defines the -l and -p options only:
other options cannot be used in the POSIXly-correct mode.
In the POSIXly-correct mode, the effect of the -l option is different in
that status is reported for each job rather than for each process.
The process group ID of a job executed by yash is equal to the process ID of the first command of the pipeline that forms the job.