_jobs.txt

Jobs built-in

The dfn:[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

{{job}}s

The job IDs of jobs to be reported. When no {{job}} is specified, all jobs under the shell’s control are reported.

The percent sign (%) at the beginning of a job ID can be omitted if the shell is not in the POSIXly-correct mode.

Exit status

The exit status of the jobs built-in is zero unless there is any error.

Notes

The jobs built-in is a mandatory 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.