:processes

Arguments: &rest processes

Prints information about the state of the processes running in Lisp. If no processes are specified, all live processes are described. The information is displayed in columns. :help  proc describes the fields in the display.

The processes argument 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 :processes is :pro.

See here in top-level.htm for an example showing the output of :processes and details of the column headings.

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

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