github.com/lmorg/murex@v0.0.0-20240217211045-e081c89cd4ef/docs/commands/fid-kill.md (about)

     1  # `fid-kill`
     2  
     3  > Terminate a running Murex function
     4  
     5  ## Description
     6  
     7  `fid-kill` will terminate a running Murex function in a similar way
     8  that the POSIX `kill` (superficially speaking).
     9  
    10  ## Usage
    11  
    12  ```
    13  fid-kill fid
    14  ```
    15  
    16  ## Detail
    17  
    18  `fid-kill` doesn't send a kernel signal to the process since Murex is
    19  a multi-threaded shell with a single signal, `fid-kill` will send a
    20  cancellation context to any builtins executing (which covers builtins,
    21  aliases, public and private functions and any external executables running
    22  which were launched within the current Murex shell).
    23  
    24  The FID (function ID) sent is not the same as a POSIX (eg Linux, macOS, BSD)
    25  PID (process ID). You can obtain a FID from `fid-list`.
    26  
    27  ## See Also
    28  
    29  * [`bexists`](../commands/bexists.md):
    30    Check which builtins exist
    31  * [`bg`](../commands/bg.md):
    32    Run processes in the background
    33  * [`builtins`](../commands/runtime.md):
    34    Returns runtime information on the internal state of Murex
    35  * [`exec`](../commands/exec.md):
    36    Runs an executable
    37  * [`fexec` ](../commands/fexec.md):
    38    Execute a command or function, bypassing the usual order of precedence.
    39  * [`fg`](../commands/fg.md):
    40    Sends a background process into the foreground
    41  * [`fid-killall`](../commands/fid-killall.md):
    42    Terminate _all_ running Murex functions
    43  * [`fid-list`](../commands/fid-list.md):
    44    Lists all running functions within the current Murex session
    45  * [`jobs`](../commands/fid-list.md):
    46    Lists all running functions within the current Murex session
    47  * [`murex-update-exe-list`](../commands/murex-update-exe-list.md):
    48    Forces Murex to rescan $PATH looking for executables
    49  
    50  <hr/>
    51  
    52  This document was generated from [builtins/core/processes/kill_doc.yaml](https://github.com/lmorg/murex/blob/master/builtins/core/processes/kill_doc.yaml).