Print this page
13507 some man pages need update following 13405
6308 some man pages are obsolete after moving to ksh builtins

@@ -42,48 +42,18 @@
 .\"
 .\" Copyright 1989 AT&T
 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
 .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures
 .\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved
+.\" Copyright 2021 OmniOS Community Edition (OmniOSce) Association.
 .\"
-.TH JOBS 1 "Nov 2, 2007"
+.TH JOBS 1 "Feb 9, 2021"
 .SH NAME
 jobs, fg, bg, stop, notify \- control process execution
 .SH SYNOPSIS
-.SS "sh"
-.LP
-.nf
-\fBjobs\fR [\fB-p\fR | \fB-l\fR] [% \fIjob_id\fR...]
-.fi
 
-.LP
-.nf
-\fBjobs\fR \fB-x\fR \fIcommand\fR [\fIarguments\fR]
-.fi
-
-.LP
-.nf
-\fBfg\fR [% \fIjob_id\fR...]
-.fi
-
-.LP
-.nf
-\fBbg\fR [% \fIjob_id\fR...]
-.fi
-
-.LP
-.nf
-\fBstop\fR % \fIjob_id\fR...
-.fi
-
-.LP
-.nf
-\fBstop\fR \fIpid\fR...
-.fi
-
 .SS "csh"
-.LP
 .nf
 \fBjobs\fR [\fB-l\fR]
 .fi
 
 .LP

@@ -109,38 +79,11 @@
 .LP
 .nf
 \fBstop\fR \fIpid\fR...
 .fi
 
-.SS "ksh"
-.LP
-.nf
-\fBjobs\fR [\fB-lnp\fR] [% \fIjob_id\fR...]
-.fi
-
-.LP
-.nf
-\fBfg\fR [% \fIjob_id\fR...]
-.fi
-
-.LP
-.nf
-\fBbg\fR [% \fIjob_id\fR...]
-.fi
-
-.LP
-.nf
-\fBstop\fR % \fIjob_id\fR...
-.fi
-
-.LP
-.nf
-\fBstop\fR \fIpid\fR...
-.fi
-
 .SS "ksh93"
-.LP
 .nf
 \fBjobs\fR [\fB-lnp\fR] [\fIjob_id\fR...]
 .fi
 
 .LP

@@ -152,156 +95,11 @@
 .nf
 \fBbg\fR [\fIjob_id\fR...]
 .fi
 
 .SH DESCRIPTION
-.SS "sh"
-.sp
-.LP
-When Job Control is enabled, the Bourne shell built-in \fBjobs\fR reports all
-jobs that are stopped or executing in the background. If \fB%\fR\fIjob_id\fR is
-omitted, all jobs that are stopped or running in the background is reported.
-The following options modify or enhance the output of \fBjobs\fR:
-.sp
-.ne 2
-.na
-\fB\fB-l\fR\fR
-.ad
-.RS 6n
-Reports the process group \fBID\fR and working directory of the jobs.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB-p\fR\fR
-.ad
-.RS 6n
-Reports only the process group \fBID\fR of the jobs.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB-x\fR\fR
-.ad
-.RS 6n
-Replaces any \fIjob_id\fR found in \fIcommand\fR or \fIarguments\fR with the
-corresponding process group \fBID\fR, and then executes \fIcommand\fR passing
-it \fIarguments\fR.
-.RE
-
-.sp
-.LP
-When the shell is invoked as \fBjsh\fR, Job Control is enabled in addition to
-all of the functionality described previously for \fBsh\fR. Typically Job
-Control is enabled for the interactive shell only. Non-interactive shells
-typically do not benefit from the added functionality of Job Control.
-.sp
-.LP
-With Job Control enabled every command or pipeline the user enters at the
-terminal is called a \fIjob_id\fR. All jobs exist in one of the following
-states: foreground, background or stopped. These terms are defined as follows:
-.RS +4
-.TP
-1.
-A job in the \fBforeground\fR has read and write access to the controlling
-terminal.
-.RE
-.RS +4
-.TP
-2.
-A job in the \fBbackground\fR is denied read access and has conditional
-write access to the controlling terminal (see \fBstty\fR(1))
-.RE
-.RS +4
-.TP
-3.
-A \fBstopped\fR job is a job that has been placed in a suspended state,
-usually as a result of a \fBSIGTSTP\fR signal (see \fBsignal.h\fR(3HEAD)).
-.RE
-.sp
-.LP
-Every job that the shell starts is assigned a positive integer, called a
-\fIjob_id number\fR which is tracked by the shell and are used as an identifier
-to indicate a specific job. Additionally, the shell keeps track of the
-\fBcurrent\fR and \fBprevious\fR jobs. The \fBcurrent job\fR is the most recent
-job to be started or restarted. The \fBprevious job\fR is the first non-current
-job.
-.sp
-.LP
-The acceptable syntax for a Job Identifier is of the form:
-.sp
-.LP
-\fB%\fR\fIjob_id\fR
-.sp
-.LP
-where \fIjob_id\fR can be specified in any of the following formats:
-.sp
-.ne 2
-.na
-\fB\fB%\fR or \fB+\fR\fR
-.ad
-.RS 13n
-for the current job
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB\(mi\fR\fR
-.ad
-.RS 13n
-for the previous job
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB?\fR\fI<string>\fR\fR
-.ad
-.RS 13n
-specify the job for which the command line uniquely contains \fIstring\fR.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fIn\fR\fR
-.ad
-.RS 13n
-for job number \fIn\fR, where \fIn\fR is a job number
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fIpref\fR\fR
-.ad
-.RS 13n
-where \fIpref\fR is a unique prefix of the command name (for example, if the
-command \fBls \(mil name\fR were running in the background, it could be
-referred to as \fB%ls\fR); \fIpref\fR cannot contain blanks unless it is
-quoted.
-.RE
-
-.sp
-.LP
-When Job Control is enabled, \fBfg\fR resumes the execution of a stopped job in
-the foreground, also moves an executing background job into the foreground. If
-\fB%\fR\fIjob_id\fR is omitted the current job is assumed.
-.sp
-.LP
-When Job Control is enabled, \fBbg\fR resumes the execution of a stopped job in
-the background. If \fB%\fR\fIjob_id\fR is omitted the current job is assumed.
-.sp
-.LP
-\fBstop\fR stops the execution of a background job(s) by using its
-\fIjob_id\fR, or of any process by using its \fIpid\fR; see \fBps\fR(1).
 .SS "csh"
-.sp
-.LP
 The C shell built-in, \fBjobs\fR, without an argument, lists the active jobs
 under job control.
 .sp
 .ne 2
 .na

@@ -394,180 +192,11 @@
 \fIjob_id\fR, or of any process by using its \fIpid\fR; see \fBps\fR(1).
 .sp
 .LP
 \fBnotify\fR notifies the user asynchronously when the status of the current
 job or specified jobs changes.
-.SS "ksh"
-.sp
-.LP
-\fBjobs\fR displays the status of the jobs that were started in the current
-shell environment. When \fBjobs\fR reports the termination status of a job, the
-shell removes its process \fBID\fR from the list of those known in the current
-shell execution environment.
-.sp
-.LP
-\fIjob_id\fR specifies the jobs for which the status is to be displayed. If no
-\fIjob_id\fR is specified, the status information for all jobs are displayed.
-.sp
-.LP
-The following options modify or enhance the output of \fBjobs\fR:
-.sp
-.ne 2
-.na
-\fB\fB-l\fR\fR
-.ad
-.RS 6n
-(The letter ell.) Provides more information about each job listed. This
-information includes the job number, current job, process group \fBID\fR, state
-and the command that formed the job.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB-n\fR\fR
-.ad
-.RS 6n
-Displays only jobs that have stopped or exited since last notified.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB-p\fR\fR
-.ad
-.RS 6n
-Displays only the process \fBID\fRs for the process group leaders of the
-selected jobs.
-.RE
-
-.sp
-.LP
-By default, \fBjobs\fR displays the status of all the stopped jobs, running
-background jobs, and all jobs whose status has changed and have not been
-reported by the shell.
-.sp
-.LP
-If the \fBmonitor\fR option of the \fBset\fR command is turned on, an
-interactive shell associates a \fBjob\fR with each pipeline. It keeps a table
-of current jobs, printed by the \fBjobs\fR command, and assigns them small
-integer numbers. When a job is started asynchronously with \fB&\fR, the shell
-prints a line which looks like:
-.sp
-.LP
-\fB[1]\fR \fB1234\fR
-.sp
-.LP
-indicating that the job, which was started asynchronously, was job number
-\fB1\fR and had one (top-level) process, whose process id was \fB1234\fR.
-.sp
-.LP
-If you are running a job and wish to do something else you can hit the key ^Z
-(Control-Z) which sends a \fBSTOP\fR signal to the current job. The shell then
-normally indicates that the job has been "\fBStopped\fR" (see \fBOUTPUT\fR
-below), and print another prompt. You can then manipulate the state of this
-job, putting it in the background with the \fBbg\fR command, or run some other
-commands and then eventually bring the job back into the foreground with the
-foreground command \fBfg\fR. A ^Z takes effect immediately and is like an
-interrupt, in that pending output and unread input are discarded when it is
-typed.
-.sp
-.LP
-There are several ways to refer to jobs in the shell. A job can be referred to
-by the process id of any process of the job or by one of the following:
-.sp
-.ne 2
-.na
-\fB\fB%\fR\fInumber\fR\fR
-.ad
-.RS 12n
-The job with the specified number.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB%\fR\fIstring\fR\fR
-.ad
-.RS 12n
-Any job whose command line begins with \fIstring\fR; works only in the
-interactive mode when the history file is active.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB%?\fR\fIstring\fR\fR
-.ad
-.RS 12n
-Any job whose command line contains \fIstring\fR; works only in the interactive
-mode when the history file is active.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB%%\fR\fR
-.ad
-.RS 12n
-Current job.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB%+\fR\fR
-.ad
-.RS 12n
-Equivalent to \fB%%\fR.
-.RE
-
-.sp
-.ne 2
-.na
-\fB\fB%\(mi\fR\fR
-.ad
-.RS 12n
-Previous job.
-.RE
-
-.sp
-.LP
-The shell learns immediately whenever a process changes state. It normally
-informs you whenever a job becomes blocked so that no further progress is
-possible, but only just before it prints a prompt. This is done so that it does
-not otherwise disturb your work. When the monitor mode is on, each background
-job that completes triggers any trap set for \fBCHLD\fR. When you try to leave
-the shell while jobs are running or stopped, you are warned that `You have
-stopped (running) jobs.' You can use the \fBjobs\fR command to see what they
-are. If you do this or immediately try to exit again, the shell does not warn
-you a second time, and the stopped jobs are terminated.
-.sp
-.LP
-\fBfg\fR moves a background job from the current environment into the
-foreground. Using \fBfg\fR to place a job in the foreground removes its process
-\fBID\fR from the list of those known in the current shell execution
-environment. The \fBfg\fR command is available only on systems that support job
-control. If \fIjob_id\fR is not specified, the current job is brought into the
-foreground.
-.sp
-.LP
-\fBbg\fR resumes suspended jobs from the current environment by running them as
-background jobs. If the job specified by \fIjob_id\fR is already a running
-background job, \fBbg\fR has no effect and exits successfully. Using \fBbg\fR
-to place a job into the background causes its process \fBID\fR to become `known
-in the current shell execution environment, as if it had been started as an
-asynchronous list. The \fBbg\fR command is available only on systems that
-support job control. If \fIjob_id\fR is not specified, the current job is
-placed in the background.
-.sp
-.LP
-\fBstop\fR stops the execution of a background job(s) by using its
-\fIjob_id\fR, or of any process by using its \fIpid\fR. See \fBps\fR(1).
 .SS "ksh93"
-.sp
-.LP
 \fBjobs\fR displays information about specified jobs that were started by the
 current shell environment on standard output. The information contains the job
 number enclosed in \fB[...]\fR, the status, and the command line that started
 the job.
 .sp

@@ -690,12 +319,10 @@
 .LP
 \fBbg\fR places the specified jobs into the background and sends a \fBCONT\fR
 signal to start them running. If \fIjob_id\fR is omitted, the most recently
 started or stopped background job is resumed or continued in the background.
 .SH OUTPUT
-.sp
-.LP
 If the \fB-p\fR option is specified, the output consists of one line for each
 process \fBID\fR:
 .sp
 .LP
 \fB"%d\en",\fR \fI"process ID"\fR

@@ -839,19 +466,15 @@
 If the \fB-l\fR option is specified, a field containing the process group
 \fBID\fR is inserted before the \fBstate\fR field. Also, more processes in a
 process group can be output on separate lines, using only the process \fBID\fR
 and \fBcommand\fR fields.
 .SH ENVIRONMENT VARIABLES
-.sp
-.LP
 See \fBenviron\fR(5) for descriptions of the following environment variables
 that affect the execution of \fBjobs\fR, \fBfg\fR, and \fBbg\fR: \fBLANG\fR,
 \fBLC_ALL\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
 .SH EXIT STATUS
-.SS "sh, csh, ksh"
-.sp
-.LP
+.SS "csh"
 The following exit values are returned for \fBjobs\fR, \fBfg\fR, and \fBbg\fR:
 .sp
 .ne 2
 .na
 \fB\fB0\fR\fR

@@ -868,12 +491,10 @@
 .RS 6n
 An error occurred.
 .RE
 
 .SS "ksh93"
-.sp
-.LP
 The following exit values are returned for \fBjobs\fR:
 .sp
 .ne 2
 .na
 \fB\fB0\fR\fR

@@ -932,17 +553,12 @@
 .RS 6n
 One more jobs does not exist or there are no background jobs.
 .RE
 
 .SH ATTRIBUTES
-.sp
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
-.SS "csh, sh, ksh"
-.sp
-
-.sp
+.SS "csh"
 .TS
 box;
 c | c
 l | l .
 ATTRIBUTE TYPE  ATTRIBUTE VALUE

@@ -951,13 +567,10 @@
 _
 Standard        See \fBstandards\fR(5).
 .TE
 
 .SS "ksh93"
-.sp
-
-.sp
 .TS
 box;
 c | c
 l | l .
 ATTRIBUTE TYPE  ATTRIBUTE VALUE

@@ -964,11 +577,9 @@
 _
 Interface Stability     Uncommitted
 .TE
 
 .SH SEE ALSO
-.sp
-.LP
-\fBcsh\fR(1), \fBkill\fR(1), \fBksh\fR(1), \fBksh93\fR(1), \fBps\fR(1),
-\fBsh\fR(1), \fBstop\fR(1), \fBshell_builtins\fR(1), \fBstty\fR(1),
+\fBcsh\fR(1), \fBkill\fR(1), \fBksh93\fR(1), \fBps\fR(1),
+\fBstop\fR(1), \fBshell_builtins\fR(1), \fBstty\fR(1),
 \fBwait\fR(1), \fBsignal.h\fR(3HEAD), \fBattributes\fR(5), \fBenviron\fR(5),
 \fBstandards\fR(5)