:kill

Arguments: &optional process &rest processes

This command uses process-kill to kill each identified process. Confirmation is sought if the user tries to kill the last running process. If there are processes that a listener process has left in an arrested state, :kill of that listener is disallowed and a warning is given. If the focused process is killed, the listener process is automatically refocused. This new focus is printed before :kill returns. (See the description of the command :focus above for a discussion of which process will become the focused process.)

The process and processes arguments can specify as many processes as desired. Each argument can be:

• A string, which is processed as described below.
• A symbol, which is evaluated to produce a process object, a string, an integer, or a symbol. If the value is a symbol, its print name is used as if that were the string provided.
• A list, which is evaluated to produce a process object, a string, an integer, or a symbol. If the value is a symbol, its print name is used as if that were the string provided.
• An integer, which designated the process whose process-sequence value is that integer.

Strings are compared with process names. All processes whose names exactly match the string are considered matches. If no process name exactly matches, then all processes whose names contain the string as a substring are considered matches. (For example, if there are processes with names "Listener 1" and "Initial Lisp Listener", both match the string "ener".) For this command, multiple matches of parts of names with the string are considered ambiguous and the command fails with a diagnostic.

Strings which match no process cause the command to fail with a diagnostic.

The minimal abbreviation of :kill is :ki.

See top-level.htm for more information on top-level commands. See multiprocessing.htm for information on processes.

Copyright (c) 1998-2022, Franz Inc. Lafayette, CA., USA. All rights reserved.
This page has had moderate revisions compared to the 10.0 page.
Created 2019.8.20.