stop — Suspend a process or job

Description

stop is an alias for kill –STOP. Like kill –STOP, stop sends a SIGSTOP to the process you specify.

For more information, see kill — End a process or job, or send it a signal.

In the tcsh shell, stop stops the specified jobs or processes which are executing in the background. job can be a number, a string, '', %, + or - . There is no default job. Specifying stop alone does not stop the current job. See tcsh — Invoke a C shell.

Options

job-identifier

Is the job identifier reported by the shell when a process is started with &. It is one way to identify a process. It is also reported by the jobs command. When using the job identifier with the stop command, the job identifier must be prefaced with a percent (%) sign. For example, if the job identifier is 2, the stop command would be entered as follows:

stop %2

pid

Is the process ID that the shell reports when a process is started with &. You can also find it using the ps command. The pid argument is a number that can be specified as octal, decimal, or hexadecimal. Process IDs are reported in decimal. stop supports negative values for pid.

If pid is negative but not -1, the signal is sent to all processes whose process group ID is equal to the absolute value of pid. The negative pid is specified in this way:

stop –– –nn

where nn is the process group ID and can have a range of 2 to 7 digits (nn to nnnnnnn).

stop –– –9812753

The format must include the –– before the –nn in order to specify the process group ID.

If pid is 0, the signal is sent to all processes in the process group of the invoker.

The process to be killed must belong to the current user, unless that user is the superuser.

Related information

kill, jobs, sh, suspend, tcsh