The lsof module provides a more intuitive way to interact with the system's open file list. It supports an interactive TUI for exploration and allows exporting results in common data formats.
When to Activate
- When investigating file locking issues or identifying process ownership of files.
- When performing interactive searches of open files using FZF.
- When exporting open file data to CSV or TSV for script processing.
- When needing thread-level details (
--task) for open files.
Core Principles & Rules
- Interactive TUI: Automatically displays a TUI when connected to a terminal; otherwise, defaults to TSV.
- Data-Centric: Use
--csvor--tsvwhen the output is intended for automation or external analysis. - Searchable: Leverage the
fzsubcommand for fast interactive filtering.
Patterns & Examples
Interactive Search
# Interactively search and view open files via FZF
x lsof fz
Export to CSV
# Output current open files as a CSV for processing
x lsof --csv
View Thread Info
# Display task (thread) IDs and names for open files
x lsof --task
Checklist
- Confirm if the user needs an interactive view or a static data export.
- Verify if thread-level information is required.
- Ensure the correct export format (CSV/TSV) is selected if needed.