| # ffx process |
| |
| This `ffx` plugin allows retrieving information about Fuchsia processes. |
| |
| In particular, the plugin can list channels, event and sockets held by processes |
| on a running Fuchsia device, allowing analysis of the topology of connections |
| between processes. |
| |
| ## Run |
| |
| To run the plugin, execute: |
| |
| ``` |
| ffx process |
| ``` |
| |
| ## Usage example |
| |
| ``` |
| $ ffx process list | grep archivist |
| 2257 archivist.cm |
| |
| $ ffx process filter 2257 |
| Total processes found: 1 |
| |
| Process name: archivist.cm |
| Process koid: 2257 |
| Total objects: 1139 |
| Processes: 1 |
| Koid: 2257 Related Koid: 2063 Peer Owner Koid: 2257 |
| Threads: 5 |
| Koid: 2848 Related Koid: 2257 Peer Owner Koid: 0 |
| Koid: 2762 Related Koid: 2257 Peer Owner Koid: 0 |
| Koid: 2751 Related Koid: 2257 Peer Owner Koid: 0 |
| Koid: 2735 Related Koid: 2257 Peer Owner Koid: 0 |
| Koid: 2262 Related Koid: 2257 Peer Owner Koid: 0 |
| VMOs: 47 |
| Koid: 53556 Related Koid: 0 Peer Owner Koid: 0 |
| Koid: 53552 Related Koid: 0 Peer Owner Koid: 0 |
| Koid: 53386 Related Koid: 0 Peer Owner Koid: 0 |
| Koid: 53287 Related Koid: 0 Peer Owner Koid: 0 |
| Koid: 29030 Related Koid: 0 Peer Owner Koid: 0 |
| Koid: 5495 Related Koid: 0 Peer Owner Koid: 0 |
| Koid: 5449 Related Koid: 0 Peer Owner Koid: 0 |
| (...) |
| ``` |
| |
| ## Run tests |
| |
| Build the Fuchsia image with the following additional package: |
| |
| ``` |
| $ fx set [...] --with //src/developer/ffx:tests |
| ``` |
| |
| Run the unit tests: |
| |
| ``` |
| $ fx test ffx_process_test |
| ``` |
