Skip to main content


Laurence MorganAbout 1 min


Lists all running functions within the current Murex session


fid-list is a tool for outputting all the functions currently managed by that Murex session. Those functions could be Murex functions, builtins or any external executables launched from Murex.

Conceptually fid-list is a little like ps (on POSIX systems) however fid-list was not written to be POSIX compliant.

Multiple flags cannot be used with each other.


fid-list [ flag ] -> <stdout>

jobs is an alias for fid-list: --jobs:

jobs -> <stdout>


  • --background Returns a json map of background jobs
  • --csv Output table in a csv format
  • --help Outputs a list of parameters and a descriptions
  • --jobs Show background and stopped jobs
  • --jsonl Output table in a jsonlines (jsonl) format (defaulted to when piped)
  • --stopped Returns a json map of stopped jobs
  • --tty Force default TTY output even when piped


Because Murex is a multi-threaded shell, builtins are not forked processes like in a traditional / POSIX shell. This means that you cannot use the operating systems default process viewer (eg ps) to list Murex functions. This is where fid-list comes into play. It is used to view all the functions and processes that are managed by the current Murex session. That would include:

  • any aliases within Murex
  • public and private Murex functions
  • builtins (eg fid-list is a builtin command)
  • any external processes that were launched from within this shell session
  • any background functions or processes of any of the above


  • fid-list
  • jobs

See Also

  • * (generic): generic (primitive)
  • bexists: Check which builtins exist
  • bg: Run processes in the background
  • builtins: Returns runtime information on the internal state of Murex
  • csv: CSV files (and other character delimited tables)
  • exec: Runs an executable
  • fexec: Execute a command or function, bypassing the usual order of precedence.
  • fg: Sends a background process into the foreground
  • fid-kill: Terminate a running Murex function
  • fid-killall: Terminate all running Murex functions
  • jobs: Lists all running functions within the current Murex session
  • jsonl: JSON Lines
  • murex-update-exe-list: Forces Murex to rescan $PATH looking for executables

This document was generated from builtins/core/processes/fid-list_doc.yamlopen in new window.

Last update:
Contributors: Laurence Morgan,Laurence Morgan