Initial commit: kmod-tui v1 — kernel module inspector TUI
Features: - Browse all loaded kernel modules from /proc/modules - Two-pane layout: scrollable list + detail pane - Full-screen detail view with modinfo, parameters, holders - Vim-style navigation (j/k, Enter, /, s, r, ?, q) - Edge-scrolling (cursor moves freely, viewport follows) - Filter by module name AND dependents (used_by) - Sort by name, size, refcnt, or dependents count - Lazy modinfo fetching (shells out only on selection) - 13 unit tests (parser, filter, scroll logic) Tech: Rust + ratatui + crossterm
This commit is contained in:
Hermes Agent
@@ -0,0 +1,5 @@
|
||||
/target
|
||||
*.rs.bk
|
||||
*.o
|
||||
*.so
|
||||
*.dylib
|
||||
Generated
+599
@@ -0,0 +1,599 @@
|
||||
# This file is automatically @generated by Cargo.
|
||||
# It is not intended for manual editing.
|
||||
version = 4
|
||||
|
||||
[[package]]
|
||||
name = "allocator-api2"
|
||||
version = "0.2.21"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "683d7910e743518b0e34f1186f92494becacb047c7b6bf616c96772180fef923"
|
||||
|
||||
[[package]]
|
||||
name = "bitflags"
|
||||
version = "2.13.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "b588b76d00fde79687d7646a9b5bdf3cc0f655e0bbd080335a95d7e96f3587da"
|
||||
|
||||
[[package]]
|
||||
name = "cassowary"
|
||||
version = "0.3.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "df8670b8c7b9dae1793364eafadf7239c40d669904660c5960d74cfd80b46a53"
|
||||
|
||||
[[package]]
|
||||
name = "castaway"
|
||||
version = "0.2.4"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "dec551ab6e7578819132c713a93c022a05d60159dc86e7a7050223577484c55a"
|
||||
dependencies = [
|
||||
"rustversion",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "cfg-if"
|
||||
version = "1.0.4"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
|
||||
|
||||
[[package]]
|
||||
name = "compact_str"
|
||||
version = "0.8.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "7fd622ebbb56a5b2ccb651b32b911cdeb2a9b4b11776b2473bf26a26a286244e"
|
||||
dependencies = [
|
||||
"castaway",
|
||||
"cfg-if",
|
||||
"itoa",
|
||||
"rustversion",
|
||||
"ryu",
|
||||
"static_assertions",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "crossterm"
|
||||
version = "0.28.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "829d955a0bb380ef178a640b91779e3987da38c9aea133b20614cfed8cdea9c6"
|
||||
dependencies = [
|
||||
"bitflags",
|
||||
"crossterm_winapi",
|
||||
"mio",
|
||||
"parking_lot",
|
||||
"rustix",
|
||||
"signal-hook",
|
||||
"signal-hook-mio",
|
||||
"winapi",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "crossterm_winapi"
|
||||
version = "0.9.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "acdd7c62a3665c7f6830a51635d9ac9b23ed385797f70a83bb8bafe9c572ab2b"
|
||||
dependencies = [
|
||||
"winapi",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "darling"
|
||||
version = "0.24.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ed17f5901b6630b993ca003def43f2f8ef4014fc13b047b57aad617ff32bc2ec"
|
||||
dependencies = [
|
||||
"darling_core",
|
||||
"darling_macro",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "darling_core"
|
||||
version = "0.24.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "6837e2cf7485aaae18f86181d2f0e9a7ed297a025e220aeabf63fdebd3a2ddff"
|
||||
dependencies = [
|
||||
"ident_case",
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"strsim",
|
||||
"syn 3.0.5",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "darling_macro"
|
||||
version = "0.24.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "2ac7135c3ef02b2f7833bbeb1be5ba7f966dcde8a87c6b87f65a778d71a02785"
|
||||
dependencies = [
|
||||
"darling_core",
|
||||
"quote",
|
||||
"syn 3.0.5",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "either"
|
||||
version = "1.18.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "252afb9ae5eaa683babdc6a068b3f5726eb19e05070c731f9b2a23a7c3e8ed34"
|
||||
|
||||
[[package]]
|
||||
name = "equivalent"
|
||||
version = "1.0.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
|
||||
|
||||
[[package]]
|
||||
name = "errno"
|
||||
version = "0.3.14"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
|
||||
dependencies = [
|
||||
"libc",
|
||||
"windows-sys 0.61.2",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "foldhash"
|
||||
version = "0.1.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "d9c4f5dac5e15c24eb999c26181a6ca40b39fe946cbe4c263c7209467bc83af2"
|
||||
|
||||
[[package]]
|
||||
name = "hashbrown"
|
||||
version = "0.15.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9229cfe53dfd69f0609a49f65461bd93001ea1ef889cd5529dd176593f5338a1"
|
||||
dependencies = [
|
||||
"allocator-api2",
|
||||
"equivalent",
|
||||
"foldhash",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "heck"
|
||||
version = "0.5.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
|
||||
|
||||
[[package]]
|
||||
name = "ident_case"
|
||||
version = "1.0.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
|
||||
|
||||
[[package]]
|
||||
name = "indoc"
|
||||
version = "2.0.7"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
|
||||
dependencies = [
|
||||
"rustversion",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "instability"
|
||||
version = "0.3.13"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "2bf84e73fa6f27f299dec58e13223cf70db80da872eb921d4f6138342a0eabc8"
|
||||
dependencies = [
|
||||
"darling",
|
||||
"indoc",
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"syn 3.0.5",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "itertools"
|
||||
version = "0.13.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "413ee7dfc52ee1a4949ceeb7dbc8a33f2d6c088194d9f922fb8318faf1f01186"
|
||||
dependencies = [
|
||||
"either",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "itoa"
|
||||
version = "1.0.18"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
|
||||
|
||||
[[package]]
|
||||
name = "kmod-tui"
|
||||
version = "0.1.0"
|
||||
dependencies = [
|
||||
"crossterm",
|
||||
"ratatui",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "libc"
|
||||
version = "0.2.189"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "3eaf3ede3fee6db1a4c2ee091bf8a8b4dccdc6d17f656fb07896ee72867612f2"
|
||||
|
||||
[[package]]
|
||||
name = "linux-raw-sys"
|
||||
version = "0.4.15"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "d26c52dbd32dccf2d10cac7725f8eae5296885fb5703b261f7d0a0739ec807ab"
|
||||
|
||||
[[package]]
|
||||
name = "lock_api"
|
||||
version = "0.4.14"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "224399e74b87b5f3557511d98dff8b14089b3dadafcab6bb93eab67d3aace965"
|
||||
dependencies = [
|
||||
"scopeguard",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "log"
|
||||
version = "0.4.34"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "f9f8bd3e56ce4dfc153cf470fffbfa98c7620958b312ca5c3a4b8d5181fd13c6"
|
||||
|
||||
[[package]]
|
||||
name = "lru"
|
||||
version = "0.12.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "234cf4f4a04dc1f57e24b96cc0cd600cf2af460d4161ac5ecdd0af8e1f3b2a38"
|
||||
dependencies = [
|
||||
"hashbrown",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "mio"
|
||||
version = "1.2.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "4b18443e9c262bfe8fa82f51666e2642c53393f7e5c27b3e1aeab922cff5b9d8"
|
||||
dependencies = [
|
||||
"libc",
|
||||
"log",
|
||||
"wasi",
|
||||
"windows-sys 0.61.2",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "parking_lot"
|
||||
version = "0.12.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "93857453250e3077bd71ff98b6a65ea6621a19bb0f559a85248955ac12c45a1a"
|
||||
dependencies = [
|
||||
"lock_api",
|
||||
"parking_lot_core",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "parking_lot_core"
|
||||
version = "0.9.12"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "2621685985a2ebf1c516881c026032ac7deafcda1a2c9b7850dc81e3dfcb64c1"
|
||||
dependencies = [
|
||||
"cfg-if",
|
||||
"libc",
|
||||
"redox_syscall",
|
||||
"smallvec",
|
||||
"windows-link",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "paste"
|
||||
version = "1.0.15"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
|
||||
|
||||
[[package]]
|
||||
name = "proc-macro2"
|
||||
version = "1.0.107"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "985e7ec9bb745e6ce6535b544d84d6cd6f7ad8bd711c398938ae983b91a766d9"
|
||||
dependencies = [
|
||||
"unicode-ident",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "quote"
|
||||
version = "1.0.47"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "1fbf4db142a473a8d80c26bbf18454ed458bf8d26c8219c331daecfdbd079001"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "ratatui"
|
||||
version = "0.28.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "fdef7f9be5c0122f890d58bdf4d964349ba6a6161f705907526d891efabba57d"
|
||||
dependencies = [
|
||||
"bitflags",
|
||||
"cassowary",
|
||||
"compact_str",
|
||||
"crossterm",
|
||||
"instability",
|
||||
"itertools",
|
||||
"lru",
|
||||
"paste",
|
||||
"strum",
|
||||
"strum_macros",
|
||||
"unicode-segmentation",
|
||||
"unicode-truncate",
|
||||
"unicode-width",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "redox_syscall"
|
||||
version = "0.5.18"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
|
||||
dependencies = [
|
||||
"bitflags",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "rustix"
|
||||
version = "0.38.44"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "fdb5bc1ae2baa591800df16c9ca78619bf65c0488b41b96ccec5d11220d8c154"
|
||||
dependencies = [
|
||||
"bitflags",
|
||||
"errno",
|
||||
"libc",
|
||||
"linux-raw-sys",
|
||||
"windows-sys 0.59.0",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "rustversion"
|
||||
version = "1.0.23"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "cf54715a573b99ac80df0bc206da022bcd442c974952c7b9720069370852e21f"
|
||||
|
||||
[[package]]
|
||||
name = "ryu"
|
||||
version = "1.0.23"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9774ba4a74de5f7b1c1451ed6cd5285a32eddb5cccb8cc655a4e50009e06477f"
|
||||
|
||||
[[package]]
|
||||
name = "scopeguard"
|
||||
version = "1.2.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
|
||||
|
||||
[[package]]
|
||||
name = "signal-hook"
|
||||
version = "0.3.18"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "d881a16cf4426aa584979d30bd82cb33429027e42122b169753d6ef1085ed6e2"
|
||||
dependencies = [
|
||||
"libc",
|
||||
"signal-hook-registry",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "signal-hook-mio"
|
||||
version = "0.2.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "b75a19a7a740b25bc7944bdee6172368f988763b744e3d4dfe753f6b4ece40cc"
|
||||
dependencies = [
|
||||
"libc",
|
||||
"mio",
|
||||
"signal-hook",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "signal-hook-registry"
|
||||
version = "1.4.8"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "c4db69cba1110affc0e9f7bcd48bbf87b3f4fc7c61fc9155afd4c469eb3d6c1b"
|
||||
dependencies = [
|
||||
"errno",
|
||||
"libc",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "smallvec"
|
||||
version = "1.16.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "b9be42f50aa861c555654aa3a37f52f4b1074bacf4e48fe0ef7fa584e80f1f0f"
|
||||
|
||||
[[package]]
|
||||
name = "static_assertions"
|
||||
version = "1.1.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "a2eb9349b6444b326872e140eb1cf5e7c522154d69e7a0ffb0fb81c06b37543f"
|
||||
|
||||
[[package]]
|
||||
name = "strsim"
|
||||
version = "0.11.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
|
||||
|
||||
[[package]]
|
||||
name = "strum"
|
||||
version = "0.26.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "8fec0f0aef304996cf250b31b5a10dee7980c85da9d759361292b8bca5a18f06"
|
||||
dependencies = [
|
||||
"strum_macros",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "strum_macros"
|
||||
version = "0.26.4"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "4c6bee85a5a24955dc440386795aa378cd9cf82acd5f764469152d2270e581be"
|
||||
dependencies = [
|
||||
"heck",
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"rustversion",
|
||||
"syn 2.0.119",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "syn"
|
||||
version = "2.0.119"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "872831b642d1a07999a962a351ed35b955ea2cfc8f3862091e2a240a84f17297"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"unicode-ident",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "syn"
|
||||
version = "3.0.5"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "12df2e0110f65b775f769bb17ef989067a1d931b2eb822bd4346631eeada89f9"
|
||||
dependencies = [
|
||||
"proc-macro2",
|
||||
"quote",
|
||||
"unicode-ident",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "unicode-ident"
|
||||
version = "1.0.24"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
|
||||
|
||||
[[package]]
|
||||
name = "unicode-segmentation"
|
||||
version = "1.13.3"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "c6f5d3c3b1bf09027a88a6bc961fc00497d651009560b5463668dc81b0fa87a8"
|
||||
|
||||
[[package]]
|
||||
name = "unicode-truncate"
|
||||
version = "1.1.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "b3644627a5af5fa321c95b9b235a72fd24cd29c648c2c379431e6628655627bf"
|
||||
dependencies = [
|
||||
"itertools",
|
||||
"unicode-segmentation",
|
||||
"unicode-width",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "unicode-width"
|
||||
version = "0.1.14"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "7dd6e30e90baa6f72411720665d41d89b9a3d039dc45b8faea1ddd07f617f6af"
|
||||
|
||||
[[package]]
|
||||
name = "wasi"
|
||||
version = "0.11.1+wasi-snapshot-preview1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ccf3ec651a847eb01de73ccad15eb7d99f80485de043efb2f370cd654f4ea44b"
|
||||
|
||||
[[package]]
|
||||
name = "winapi"
|
||||
version = "0.3.9"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "5c839a674fcd7a98952e593242ea400abe93992746761e38641405d28b00f419"
|
||||
dependencies = [
|
||||
"winapi-i686-pc-windows-gnu",
|
||||
"winapi-x86_64-pc-windows-gnu",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "winapi-i686-pc-windows-gnu"
|
||||
version = "0.4.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
|
||||
|
||||
[[package]]
|
||||
name = "winapi-x86_64-pc-windows-gnu"
|
||||
version = "0.4.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
|
||||
|
||||
[[package]]
|
||||
name = "windows-link"
|
||||
version = "0.2.1"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
|
||||
|
||||
[[package]]
|
||||
name = "windows-sys"
|
||||
version = "0.59.0"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "1e38bc4d79ed67fd075bcc251a1c39b32a1776bbe92e5bef1f0bf1f8c531853b"
|
||||
dependencies = [
|
||||
"windows-targets",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "windows-sys"
|
||||
version = "0.61.2"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "ae137229bcbd6cdf0f7b80a31df61766145077ddf49416a728b02cb3921ff3fc"
|
||||
dependencies = [
|
||||
"windows-link",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "windows-targets"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "9b724f72796e036ab90c1021d4780d4d3d648aca59e491e6b98e725b84e99973"
|
||||
dependencies = [
|
||||
"windows_aarch64_gnullvm",
|
||||
"windows_aarch64_msvc",
|
||||
"windows_i686_gnu",
|
||||
"windows_i686_gnullvm",
|
||||
"windows_i686_msvc",
|
||||
"windows_x86_64_gnu",
|
||||
"windows_x86_64_gnullvm",
|
||||
"windows_x86_64_msvc",
|
||||
]
|
||||
|
||||
[[package]]
|
||||
name = "windows_aarch64_gnullvm"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "32a4622180e7a0ec044bb555404c800bc9fd9ec262ec147edd5989ccd0c02cd3"
|
||||
|
||||
[[package]]
|
||||
name = "windows_aarch64_msvc"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "09ec2a7bb152e2252b53fa7803150007879548bc709c039df7627cabbd05d469"
|
||||
|
||||
[[package]]
|
||||
name = "windows_i686_gnu"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "8e9b5ad5ab802e97eb8e295ac6720e509ee4c243f69d781394014ebfe8bbfa0b"
|
||||
|
||||
[[package]]
|
||||
name = "windows_i686_gnullvm"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "0eee52d38c090b3caa76c563b86c3a4bd71ef1a819287c19d586d7334ae8ed66"
|
||||
|
||||
[[package]]
|
||||
name = "windows_i686_msvc"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "240948bc05c5e7c6dabba28bf89d89ffce3e303022809e73deaefe4f6ec56c66"
|
||||
|
||||
[[package]]
|
||||
name = "windows_x86_64_gnu"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "147a5c80aabfbf0c7d901cb5895d1de30ef2907eb21fbbab29ca94c5b08b1a78"
|
||||
|
||||
[[package]]
|
||||
name = "windows_x86_64_gnullvm"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "24d5b23dc417412679681396f2b49f3de8c1473deb516bd34410872eff51ed0d"
|
||||
|
||||
[[package]]
|
||||
name = "windows_x86_64_msvc"
|
||||
version = "0.52.6"
|
||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||
checksum = "589f6da84c646204747d1270a2a5661ea66ed1cced2631d546fdfb155959f9ec"
|
||||
+17
@@ -0,0 +1,17 @@
|
||||
[package]
|
||||
name = "kmod-tui"
|
||||
version = "0.1.0"
|
||||
edition = "2021"
|
||||
description = "A TUI for browsing and inspecting loaded Linux kernel modules"
|
||||
|
||||
[[bin]]
|
||||
name = "kmod-tui"
|
||||
path = "src/main.rs"
|
||||
|
||||
[dependencies]
|
||||
ratatui = "0.28"
|
||||
crossterm = "0.28"
|
||||
|
||||
[profile.release]
|
||||
opt-level = 2
|
||||
lto = "thin"
|
||||
@@ -0,0 +1,95 @@
|
||||
# kmod-tui
|
||||
|
||||
A terminal UI for Linux sysadmins to browse and inspect loaded kernel modules.
|
||||
Read-only — built for looking, not for changing module state.
|
||||
|
||||
## Why
|
||||
`lsmod` shows a flat table. `modinfo <mod>` shows one module. This tool gives
|
||||
you a navigable, filterable, sorted view of all loaded modules with rich
|
||||
per-module detail (license, author, description, parameters, holders,
|
||||
dependency info) a keystroke away.
|
||||
|
||||
## Data sources (read-only)
|
||||
- `/proc/modules` — the loaded module list
|
||||
- `/sys/module/<name>/` — refcnt, coresize, initsize, initstate, srcversion,
|
||||
taint, `parameters/`, `holders/`
|
||||
- `modinfo <name>` — filename, license, description, author, depends,
|
||||
vermagic, retpoline, intree, signature info (fetched lazily, only when a
|
||||
module is selected for detail, so the list view stays fast)
|
||||
|
||||
## Build & run
|
||||
```sh
|
||||
cargo run --release
|
||||
# or
|
||||
cargo build --release
|
||||
./target/release/kmod-tui
|
||||
```
|
||||
Requires the Rust toolchain (rustup stable). No other deps; ratatui/crossterm
|
||||
are vendored by cargo.
|
||||
|
||||
## Keys
|
||||
|
||||
List view:
|
||||
```
|
||||
j / ↓ move down
|
||||
k / ↑ move up
|
||||
g / Home top
|
||||
G / End bottom
|
||||
PgDn / PgUp scroll by 10
|
||||
Enter open full-detail screen for the selected module
|
||||
/ start filtering by module name (type, Esc to clear)
|
||||
s cycle sort: name → size → refcnt → dependents
|
||||
r refresh the module list from /proc/modules
|
||||
? toggle help overlay
|
||||
q quit
|
||||
```
|
||||
|
||||
Full-detail view:
|
||||
```
|
||||
j / ↓ , k / ↑ move selection (stays in full-detail, reloads detail)
|
||||
Esc / q back to list
|
||||
? help
|
||||
```
|
||||
|
||||
Filter mode (after `/`):
|
||||
```
|
||||
type append to filter
|
||||
Backspace delete last char
|
||||
Enter / Esc exit filter (Esc also clears)
|
||||
```
|
||||
|
||||
## Layout
|
||||
- Top bar: module count + kernel version + current sort/filter.
|
||||
- Middle: scrollable module table (#, name, size, refcnt, used-by, state).
|
||||
- Bottom: two-column detail pane for the highlighted module.
|
||||
- Footer: key hints (context-sensitive).
|
||||
|
||||
## Architecture
|
||||
```
|
||||
src/
|
||||
main.rs CLI bootstrap, event loop, key dispatch
|
||||
app.rs App state: module list, cursor, filter, sort, view mode, lazy fetches
|
||||
event.rs crossterm input polling
|
||||
model.rs Module/ModInfo types, /proc + /sys collection, modinfo parsing, tests
|
||||
ui/
|
||||
mod.rs frame composition, status bar, footer, help overlay
|
||||
list.rs module table
|
||||
detail.rs detail pane + full-detail screen
|
||||
```
|
||||
|
||||
## Tests
|
||||
```sh
|
||||
cargo test --release
|
||||
```
|
||||
Unit tests cover the /proc/modules `used-by` parser, the `modinfo` output
|
||||
parser, and the human-readable size formatter.
|
||||
|
||||
## Non-goals (v1)
|
||||
- Writing module parameters or loading/unloading modules — read-only by design.
|
||||
- Showing all installable (not-yet-loaded) modules — planned for v1.1.
|
||||
- Remote hosts — local only.
|
||||
|
||||
## Roadmap
|
||||
- v1.1: dependency tree view, all-available-modules toggle, CSV/TSV export,
|
||||
config file (`~/.config/kmod-tui/config.toml`).
|
||||
- v2: optional inotify auto-refresh on `/proc/modules`.
|
||||
@@ -0,0 +1,127 @@
|
||||
# kmod-tui — Kernel Module Inspector (Rust TUI)
|
||||
|
||||
A terminal UI for Linux sysadmins to browse and inspect loaded kernel modules.
|
||||
|
||||
## Goal
|
||||
Show all loaded kernel modules in a navigable, filterable list, with a detail
|
||||
view for each module's metadata, dependencies, parameters, and holders.
|
||||
|
||||
## Data Sources (verified on this host, kernel 6.8.0-137-generic, 130 modules)
|
||||
- `/proc/modules` — one line per loaded module:
|
||||
`name size refcnt used-by state addr`
|
||||
(e.g. `wireguard 114688 0 - Live 0xffffffffc125d000`)
|
||||
- `/sys/module/<name>/` — per-module sysfs dir with:
|
||||
`refcnt`, `initstate`, `coresize`, `initsize`, `version`, `srcversion`,
|
||||
`taint`, `holders/` (modules depending on this one), `parameters/` (tunable params)
|
||||
- `modinfo <name>` — richest metadata: filename, license, description, author,
|
||||
depends, retpoline, intree, vermagic, signature info
|
||||
|
||||
## Tech Stack
|
||||
- Rust (stable)
|
||||
- `ratatui` — TUI rendering (modern maintained fork of tui-rs)
|
||||
- `crossterm` — terminal backend (cross-platform, works everywhere)
|
||||
- `clap` — CLI args (optional: --sort, --filter, --no-modinfo for speed)
|
||||
- No shell-out to `modinfo`; parse `/proc/modules` + walk `/sys/module` directly.
|
||||
(Avoids a process spawn per module; modinfo data like license/description/author
|
||||
comes from the .ko file's modinfo section — we parse the relevant sysfs files
|
||||
and, where sysfs lacks it, read the module file's modinfo section directly.
|
||||
Decision: for v1, shell out to `modinfo` lazily only when a module is selected
|
||||
for detail — keeps the list fast and detail rich. Revisit later.)
|
||||
|
||||
## UI Layout
|
||||
```
|
||||
┌─ kmod-tui — 130 modules loaded (kernel 6.8.0-137-generic) ──────────────┐
|
||||
│ Filter: [_____________] Sort: name▼ Loaded only: on │
|
||||
├────┬──────────────────┬────────┬──────┬────────────────────┬────────────┤
|
||||
│ # │ Module │ Size │ Refc │ Used by │ State │
|
||||
├────┼──────────────────┼────────┼──────┼────────────────────┼────────────┤
|
||||
│ 1 │ cpuid │ 12288 │ 0 │ - │ Live │
|
||||
│ 2 │ wireguard │ 114688 │ 0 │ - │ Live │
|
||||
│ 3 │ curve25519_x86_64│ 36864 │ 1 │ wireguard │ Live │
|
||||
│ .. │ .. │ .. │ .. │ .. │ .. │
|
||||
├────┴──────────────────┴────────┴──────┴────────────────────┴────────────┤
|
||||
│ Detail: wireguard │
|
||||
│ Filename: /lib/modules/.../wireguard.ko.zst │
|
||||
│ License: GPL Description: ... Author: ... │
|
||||
│ Depends: (none) Holders: (none) Parameters: (none) │
|
||||
│ Coresize: 114688 Initsize: 0 Refcnt: 0 Srcversion: ... │
|
||||
└────────────────────────────────────────────────────────────────────────┘
|
||||
↑/↓ move Enter expand / filter s sort q quit
|
||||
```
|
||||
|
||||
Two-pane layout: scrollable module list (top ~70%), detail pane (bottom ~30%).
|
||||
Selecting a row populates the detail pane. Enter opens a full-screen detail
|
||||
view for the selected module with all sysfs fields, parameters, holders,
|
||||
and a dependency tree.
|
||||
|
||||
## Features
|
||||
### v1 (MVP — the "nice looking, human-navigable" baseline)
|
||||
1. Module list from /proc/modules with columns: #, name, size (human-readable),
|
||||
refcnt, used-by, state.
|
||||
2. Detail pane for highlighted module: filename, license, description, author,
|
||||
depends, holders, parameters (name + current value), coresize, initsize,
|
||||
refcnt, srcversion, taint, vermagic.
|
||||
3. Vim-style navigation: j/k or ↑/↓ to move, Enter for full detail, Esc/q back.
|
||||
4. Live filter (`/` then type, fuzzy or substring match on name).
|
||||
5. Sort cycle (`s`): name, size, refcnt, dependents-count.
|
||||
6. Footer help bar.
|
||||
7. Color: state (Live=green, Loading/Unloading=yellow), refcnt>0 (bold),
|
||||
module-with-dependents highlighted.
|
||||
8. Header shows module count, kernel version (from `uname -r`).
|
||||
|
||||
### v1.1 (polish)
|
||||
- Dependency tree view (expand a module → see what it depends on and what
|
||||
depends on it, recursively).
|
||||
- Parameter inspection with current values read from /sys/module/<n>/parameters.
|
||||
- Export current view to file (CSV/TSV).
|
||||
- Config file (~/.config/kmod-tui/config.toml) for default sort, columns.
|
||||
|
||||
### v2 (nice-to-have, later)
|
||||
- Show ALL installable modules (from /lib/modules/$(uname -r)/), not just
|
||||
loaded — mark loaded vs available-not-loaded.
|
||||
- Toggle between "loaded only" and "all available".
|
||||
- modprobe/insmod/rmmod actions (guarded, with confirmation — but see note:
|
||||
this is read-only for v1; mutating is a separate, deliberate decision).
|
||||
- Module loading state watch (inotify on /proc/modules, auto-refresh).
|
||||
|
||||
## Architecture (v1)
|
||||
```
|
||||
src/
|
||||
main.rs — CLI args, app bootstrap, event loop
|
||||
app.rs — App state: module list, cursor, filter, sort mode, focus
|
||||
model.rs — Module struct, data collection from /proc + /sys
|
||||
ui/
|
||||
mod.rs — frame composition, layout
|
||||
list.rs — module list table rendering
|
||||
detail.rs — detail pane + full detail view
|
||||
help.rs — help bar / overlay
|
||||
event.rs — crossterm input polling
|
||||
config.rs — (v1.1) config file load
|
||||
```
|
||||
|
||||
Data flow:
|
||||
collect_modules() → Vec<Module> (once on startup; refresh on 'r')
|
||||
App holds Vec<Module> + filter/sort/cursor state
|
||||
ratatui draws from App state each frame
|
||||
crossterm polls input; key handlers mutate App state; redraw on change
|
||||
(or redraw on a fixed tick — simpler: event-driven redraw)
|
||||
|
||||
## Open Decisions (for Isaac)
|
||||
1. Shelling out to `modinfo` for detail metadata (filename/license/desc/author)
|
||||
vs parsing .ko files directly? Recommend: shell out lazily on selection —
|
||||
simple and correct. We only parse /proc + /sys for the list.
|
||||
2. Read-only for v1 (no rmmod/modprobe)? Recommend: YES, read-only v1.
|
||||
3. Project location: /root/kmod-tui ? Recommend: yes.
|
||||
4. Install Rust via rustup (recommended) or apt rustc package?
|
||||
Recommend: rustup (stable toolchain, latest ratatui).
|
||||
5. Naming: `kmod-tui` ok?
|
||||
|
||||
## Build & Run
|
||||
cargo run --release
|
||||
(or `cargo build --release` then ./target/release/kmod-tui)
|
||||
|
||||
## Non-goals (v1)
|
||||
- Editing module parameters (write to /sys) — risky, out of scope.
|
||||
- Loading/unloading modules — risky, out of scope.
|
||||
- Remote hosts — local only (could add SSH later).
|
||||
- Persistent state — none needed.
|
||||
+305
@@ -0,0 +1,305 @@
|
||||
//! App state: the in-memory model the UI renders from.
|
||||
|
||||
use crate::model::{self, ModInfo, Module};
|
||||
use std::sync::mpsc;
|
||||
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub enum SortMode {
|
||||
Name,
|
||||
Size,
|
||||
Refcnt,
|
||||
Dependents,
|
||||
}
|
||||
|
||||
impl SortMode {
|
||||
pub fn next(self) -> Self {
|
||||
match self {
|
||||
SortMode::Name => SortMode::Size,
|
||||
SortMode::Size => SortMode::Refcnt,
|
||||
SortMode::Refcnt => SortMode::Dependents,
|
||||
SortMode::Dependents => SortMode::Name,
|
||||
}
|
||||
}
|
||||
pub fn label(self) -> &'static str {
|
||||
match self {
|
||||
SortMode::Name => "name",
|
||||
SortMode::Size => "size",
|
||||
SortMode::Refcnt => "refcnt",
|
||||
SortMode::Dependents => "dependents",
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Which screen is active.
|
||||
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
||||
pub enum View {
|
||||
List,
|
||||
FullDetail,
|
||||
}
|
||||
|
||||
pub struct App {
|
||||
/// All loaded modules (unfiltered, unsorted master copy).
|
||||
pub modules: Vec<Module>,
|
||||
/// Indices into `modules` after filtering + sorting.
|
||||
pub view: Vec<usize>,
|
||||
pub cursor: usize,
|
||||
pub filter: String,
|
||||
pub filter_active: bool,
|
||||
pub sort: SortMode,
|
||||
pub view_mode: View,
|
||||
pub kernel: String,
|
||||
/// Pending lazy modinfo fetches.
|
||||
pub pending: Vec<mpsc::Receiver<(String, Option<ModInfo>)>>,
|
||||
/// Whether the help overlay is shown.
|
||||
pub help: bool,
|
||||
pub should_quit: bool,
|
||||
/// Vertical scroll offset (index of the first visible row in the list).
|
||||
pub scroll: usize,
|
||||
/// Number of data rows visible in the list pane (set by the UI each draw).
|
||||
pub viewport_rows: usize,
|
||||
}
|
||||
|
||||
impl App {
|
||||
pub fn new() -> Self {
|
||||
let modules = model::collect_modules();
|
||||
let kernel = model::kernel_release();
|
||||
let mut app = App {
|
||||
modules,
|
||||
view: Vec::new(),
|
||||
cursor: 0,
|
||||
filter: String::new(),
|
||||
filter_active: false,
|
||||
sort: SortMode::Name,
|
||||
view_mode: View::List,
|
||||
kernel,
|
||||
pending: Vec::new(),
|
||||
help: false,
|
||||
should_quit: false,
|
||||
scroll: 0,
|
||||
viewport_rows: 0,
|
||||
};
|
||||
app.rebuild_view();
|
||||
app
|
||||
}
|
||||
|
||||
/// Rebuild the filtered + sorted view from the master module list.
|
||||
pub fn rebuild_view(&mut self) {
|
||||
let f = self.filter.to_lowercase();
|
||||
let mut idxs: Vec<usize> = self
|
||||
.modules
|
||||
.iter()
|
||||
.enumerate()
|
||||
.filter(|(_, m)| m.matches_filter(&f))
|
||||
.map(|(i, _)| i)
|
||||
.collect();
|
||||
idxs.sort_by(|&a, &b| {
|
||||
let ma = &self.modules[a];
|
||||
let mb = &self.modules[b];
|
||||
match self.sort {
|
||||
SortMode::Name => ma.name.cmp(&mb.name),
|
||||
SortMode::Size => mb.size.cmp(&ma.size),
|
||||
SortMode::Refcnt => mb.refcnt.cmp(&ma.refcnt),
|
||||
SortMode::Dependents => mb.used_by.len().cmp(&ma.used_by.len()),
|
||||
}
|
||||
});
|
||||
self.view = idxs;
|
||||
if self.cursor >= self.view.len() {
|
||||
self.cursor = self.cursor.saturating_sub(1);
|
||||
}
|
||||
}
|
||||
|
||||
/// Index into `modules` of the module under the cursor, if any.
|
||||
pub fn current_module(&self) -> Option<&Module> {
|
||||
self.view
|
||||
.get(self.cursor)
|
||||
.and_then(|&i| self.modules.get(i))
|
||||
}
|
||||
|
||||
/// Reserved for v1.1: mutating a selected module in place (e.g. on refresh).
|
||||
#[allow(dead_code)]
|
||||
pub fn current_module_mut(&mut self) -> Option<&mut Module> {
|
||||
self.view
|
||||
.get(self.cursor)
|
||||
.and_then(|&i| self.modules.get_mut(i))
|
||||
}
|
||||
|
||||
pub fn move_cursor(&mut self, delta: i32) {
|
||||
if self.view.is_empty() {
|
||||
return;
|
||||
}
|
||||
let n = self.view.len() as i32;
|
||||
let mut c = self.cursor as i32 + delta;
|
||||
if c < 0 {
|
||||
c = 0;
|
||||
}
|
||||
if c >= n {
|
||||
c = n - 1;
|
||||
}
|
||||
self.cursor = c as usize;
|
||||
}
|
||||
|
||||
pub fn toggle_sort(&mut self) {
|
||||
self.sort = self.sort.next();
|
||||
self.rebuild_view();
|
||||
self.cursor = 0;
|
||||
self.scroll = 0;
|
||||
}
|
||||
|
||||
/// Reserved for v1.1: set an explicit sort mode by key.
|
||||
#[allow(dead_code)]
|
||||
pub fn set_sort(&mut self, s: SortMode) {
|
||||
self.sort = s;
|
||||
self.rebuild_view();
|
||||
self.cursor = 0;
|
||||
self.scroll = 0;
|
||||
}
|
||||
|
||||
pub fn enter_filter(&mut self) {
|
||||
self.filter_active = true;
|
||||
}
|
||||
|
||||
pub fn push_filter_char(&mut self, c: char) {
|
||||
self.filter.push(c);
|
||||
self.rebuild_view();
|
||||
self.cursor = 0;
|
||||
self.scroll = 0;
|
||||
}
|
||||
|
||||
pub fn pop_filter_char(&mut self) {
|
||||
self.filter.pop();
|
||||
self.rebuild_view();
|
||||
self.cursor = 0;
|
||||
self.scroll = 0;
|
||||
}
|
||||
|
||||
pub fn clear_filter(&mut self) {
|
||||
self.filter.clear();
|
||||
self.filter_active = false;
|
||||
self.rebuild_view();
|
||||
self.cursor = 0;
|
||||
self.scroll = 0;
|
||||
}
|
||||
|
||||
pub fn refresh(&mut self) {
|
||||
self.modules = model::collect_modules();
|
||||
self.rebuild_view();
|
||||
}
|
||||
|
||||
/// Request modinfo for the module under the cursor (if not already loaded).
|
||||
pub fn ensure_modinfo(&mut self) {
|
||||
if let Some(m) = self.current_module() {
|
||||
if m.modinfo.is_none() {
|
||||
let name = m.name.clone();
|
||||
let rx = model::spawn_modinfo_fetch(name);
|
||||
self.pending.push(rx);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// Drain any completed lazy modinfo fetches and merge them into the
|
||||
/// matching module. Returns true if anything changed (needs redraw).
|
||||
pub fn poll_pending(&mut self) -> bool {
|
||||
let mut changed = false;
|
||||
let mut i = 0;
|
||||
while i < self.pending.len() {
|
||||
match self.pending[i].try_recv() {
|
||||
Ok((name, mi)) => {
|
||||
if let Some(m) = self.modules.iter_mut().find(|m| m.name == name) {
|
||||
m.modinfo = mi;
|
||||
changed = true;
|
||||
}
|
||||
self.pending.remove(i);
|
||||
}
|
||||
Err(mpsc::TryRecvError::Empty) => {
|
||||
i += 1;
|
||||
}
|
||||
Err(mpsc::TryRecvError::Disconnected) => {
|
||||
self.pending.remove(i);
|
||||
}
|
||||
}
|
||||
}
|
||||
changed
|
||||
}
|
||||
|
||||
/// Adjust the scroll offset so the cursor stays within the viewport.
|
||||
/// Edge-scrolling: only scrolls when the cursor would leave the visible
|
||||
/// area. Called by the UI after layout is known (viewport_rows is set).
|
||||
pub fn adjust_scroll(&mut self) {
|
||||
self.scroll = compute_scroll(self.cursor, self.scroll, self.viewport_rows, self.view.len());
|
||||
}
|
||||
}
|
||||
|
||||
/// Pure scroll-offset computation. Edge-scrolling: the cursor moves freely
|
||||
/// within the viewport; the viewport only scrolls when the cursor would
|
||||
/// leave it.
|
||||
///
|
||||
/// - `cursor` — index of the selected row
|
||||
/// - `current_scroll`— the current scroll offset (top visible row index)
|
||||
/// - `rows_visible` — how many data rows fit in the list pane
|
||||
/// - `total` — total number of rows in the view
|
||||
pub fn compute_scroll(cursor: usize, current_scroll: usize, rows_visible: usize, total: usize) -> usize {
|
||||
if rows_visible == 0 || total <= rows_visible {
|
||||
return 0;
|
||||
}
|
||||
let max_scroll = total - rows_visible;
|
||||
let mut scroll = current_scroll;
|
||||
if cursor < scroll {
|
||||
// Cursor is above the viewport — scroll up to reveal it.
|
||||
scroll = cursor;
|
||||
} else if cursor >= scroll + rows_visible {
|
||||
// Cursor is below the viewport — scroll down so it's the last row.
|
||||
scroll = cursor - rows_visible + 1;
|
||||
}
|
||||
// cursor is within [scroll, scroll+rows_visible) — no change needed.
|
||||
scroll.min(max_scroll)
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn scroll_no_scroll_when_all_fit() {
|
||||
// total (8) < rows_visible (10) — everything fits, no scrolling.
|
||||
assert_eq!(compute_scroll(5, 0, 10, 8), 0);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn scroll_stays_at_top_when_cursor_in_viewport() {
|
||||
// cursor 3 in [0,10) — no scroll change.
|
||||
assert_eq!(compute_scroll(3, 0, 10, 100), 0);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn scroll_down_when_cursor_below_viewport() {
|
||||
// cursor 10, viewport [0,10) — scroll to 1, cursor becomes last row.
|
||||
assert_eq!(compute_scroll(10, 0, 10, 100), 1);
|
||||
// cursor 15 — scroll to 6.
|
||||
assert_eq!(compute_scroll(15, 0, 10, 100), 6);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn scroll_up_when_cursor_above_viewport() {
|
||||
// cursor 5 < scroll 20 — scroll up to 5.
|
||||
assert_eq!(compute_scroll(5, 20, 10, 100), 5);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn scroll_no_change_when_cursor_in_middle_of_viewport() {
|
||||
// cursor 25 in [20,30) — no scroll change.
|
||||
assert_eq!(compute_scroll(25, 20, 10, 100), 20);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn scroll_clamps_at_bottom() {
|
||||
// Can't scroll past total - rows_visible = 90.
|
||||
assert_eq!(compute_scroll(99, 90, 10, 100), 90);
|
||||
// Even if cursor is at the very last row.
|
||||
assert_eq!(compute_scroll(99, 0, 10, 100), 90);
|
||||
}
|
||||
|
||||
#[test]
|
||||
fn scroll_handles_zero_rows() {
|
||||
assert_eq!(compute_scroll(5, 0, 0, 100), 0);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,16 @@
|
||||
//! Terminal input events via crossterm.
|
||||
|
||||
use crossterm::event::{self, Event, KeyEvent};
|
||||
use std::time::Duration;
|
||||
|
||||
/// Poll for a terminal event with a small timeout. Returns None if no event
|
||||
/// arrived within the poll window (lets the app stay responsive and do
|
||||
/// background work like receiving lazy modinfo fetches).
|
||||
pub fn poll(timeout_ms: u64) -> Option<KeyEvent> {
|
||||
if event::poll(Duration::from_millis(timeout_ms)).unwrap_or(false) {
|
||||
if let Ok(Event::Key(key)) = event::read() {
|
||||
return Some(key);
|
||||
}
|
||||
}
|
||||
None
|
||||
}
|
||||
+169
@@ -0,0 +1,169 @@
|
||||
//! kmod-tui — a TUI for browsing and inspecting loaded Linux kernel modules.
|
||||
//!
|
||||
//! Read-only. Data from /proc/modules, /sys/module/<name>/, and `modinfo`.
|
||||
|
||||
mod app;
|
||||
mod event;
|
||||
mod model;
|
||||
mod ui;
|
||||
|
||||
use std::io::{self, stdout};
|
||||
|
||||
use crossterm::event::{KeyCode, KeyEvent, KeyModifiers};
|
||||
use crossterm::execute;
|
||||
use crossterm::terminal::{
|
||||
disable_raw_mode, enable_raw_mode, EnterAlternateScreen, LeaveAlternateScreen,
|
||||
};
|
||||
use ratatui::backend::CrosstermBackend;
|
||||
use ratatui::Terminal;
|
||||
|
||||
use crate::app::View;
|
||||
|
||||
fn main() -> io::Result<()> {
|
||||
// Setup terminal.
|
||||
enable_raw_mode()?;
|
||||
let mut stdout = stdout();
|
||||
execute!(stdout, EnterAlternateScreen)?;
|
||||
let backend = CrosstermBackend::new(stdout);
|
||||
let mut terminal = Terminal::new(backend)?;
|
||||
|
||||
// Run the app.
|
||||
let result = run(&mut terminal);
|
||||
|
||||
// Restore terminal regardless of outcome.
|
||||
disable_raw_mode()?;
|
||||
execute!(terminal.backend_mut(), LeaveAlternateScreen)?;
|
||||
result
|
||||
}
|
||||
|
||||
fn run(terminal: &mut Terminal<CrosstermBackend<io::Stdout>>) -> io::Result<()> {
|
||||
let mut app = app::App::new();
|
||||
// Eagerly fetch modinfo for the first module so the detail pane isn't empty.
|
||||
app.ensure_modinfo();
|
||||
|
||||
loop {
|
||||
// Draw current state.
|
||||
terminal.draw(|f| ui::draw(f, &mut app))?;
|
||||
|
||||
// Poll for input (short timeout so we can drain background fetches).
|
||||
if let Some(key) = event::poll(100) {
|
||||
handle_key(&mut app, key);
|
||||
}
|
||||
|
||||
// Drain any completed modinfo fetches; redraw if something arrived.
|
||||
if app.poll_pending() {
|
||||
terminal.draw(|f| ui::draw(f, &mut app))?;
|
||||
}
|
||||
|
||||
if app.should_quit {
|
||||
break;
|
||||
}
|
||||
}
|
||||
Ok(())
|
||||
}
|
||||
|
||||
fn handle_key(app: &mut app::App, key: KeyEvent) {
|
||||
// Global: quit works anywhere (unless typing in filter).
|
||||
if !app.filter_active && matches!(key.code, KeyCode::Char('q')) {
|
||||
app.should_quit = true;
|
||||
return;
|
||||
}
|
||||
if !app.filter_active && matches!(key.code, KeyCode::Char('?')) {
|
||||
app.help = !app.help;
|
||||
return;
|
||||
}
|
||||
if app.help {
|
||||
// Any key (except ?) closes help.
|
||||
if matches!(key.code, KeyCode::Char('?')) {
|
||||
app.help = false;
|
||||
} else {
|
||||
app.help = false;
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if app.filter_active {
|
||||
handle_filter_key(app, key);
|
||||
return;
|
||||
}
|
||||
|
||||
match app.view_mode {
|
||||
View::List => handle_list_key(app, key),
|
||||
View::FullDetail => handle_detail_key(app, key),
|
||||
}
|
||||
}
|
||||
|
||||
fn handle_filter_key(app: &mut app::App, key: KeyEvent) {
|
||||
match key.code {
|
||||
KeyCode::Esc => app.clear_filter(),
|
||||
KeyCode::Enter => app.filter_active = false,
|
||||
KeyCode::Backspace => {
|
||||
app.pop_filter_char();
|
||||
}
|
||||
KeyCode::Char(c) => {
|
||||
if key.modifiers.contains(KeyModifiers::CONTROL) {
|
||||
if c == 'c' {
|
||||
app.clear_filter();
|
||||
}
|
||||
return;
|
||||
}
|
||||
app.push_filter_char(c);
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
|
||||
fn handle_list_key(app: &mut app::App, key: KeyEvent) {
|
||||
match key.code {
|
||||
KeyCode::Down | KeyCode::Char('j') => app.move_cursor(1),
|
||||
KeyCode::Up | KeyCode::Char('k') => app.move_cursor(-1),
|
||||
KeyCode::Char('G') => {
|
||||
if !app.view.is_empty() {
|
||||
app.cursor = app.view.len() - 1;
|
||||
}
|
||||
}
|
||||
KeyCode::Char('g') => {
|
||||
if key.modifiers.contains(KeyModifiers::CONTROL) || key.modifiers.is_empty() {
|
||||
app.cursor = 0;
|
||||
}
|
||||
}
|
||||
KeyCode::PageDown => {
|
||||
let step = 10;
|
||||
app.move_cursor(step);
|
||||
}
|
||||
KeyCode::PageUp => app.move_cursor(-10),
|
||||
KeyCode::Home => app.cursor = 0,
|
||||
KeyCode::End => {
|
||||
if !app.view.is_empty() {
|
||||
app.cursor = app.view.len() - 1;
|
||||
}
|
||||
}
|
||||
KeyCode::Enter => {
|
||||
app.view_mode = View::FullDetail;
|
||||
app.ensure_modinfo();
|
||||
}
|
||||
KeyCode::Char('/') => app.enter_filter(),
|
||||
KeyCode::Char('s') => app.toggle_sort(),
|
||||
KeyCode::Char('r') => app.refresh(),
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
|
||||
fn handle_detail_key(app: &mut app::App, key: KeyEvent) {
|
||||
match key.code {
|
||||
KeyCode::Esc | KeyCode::Char('q') => app.view_mode = View::List,
|
||||
KeyCode::Up | KeyCode::Char('k') => {
|
||||
app.view_mode = View::List;
|
||||
app.move_cursor(-1);
|
||||
app.ensure_modinfo();
|
||||
app.view_mode = View::FullDetail;
|
||||
}
|
||||
KeyCode::Down | KeyCode::Char('j') => {
|
||||
app.view_mode = View::List;
|
||||
app.move_cursor(1);
|
||||
app.ensure_modinfo();
|
||||
app.view_mode = View::FullDetail;
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
+407
@@ -0,0 +1,407 @@
|
||||
//! Data model: collect and represent loaded kernel modules.
|
||||
//!
|
||||
//! Data sources (read-only):
|
||||
//! - /proc/modules : one line per loaded module
|
||||
//! - /sys/module/<name>/ : refcnt, coresize, initsize, initstate, srcversion,
|
||||
//! taint, version, parameters/, holders/
|
||||
//! - `modinfo <name>` : filename, license, description, author, depends,
|
||||
//! vermagic, retpoline, intree, signature info
|
||||
//! (shelled out lazily, only when detail is requested,
|
||||
//! to keep the list view fast.)
|
||||
|
||||
use std::fs;
|
||||
use std::path::Path;
|
||||
use std::process::Command;
|
||||
use std::sync::mpsc;
|
||||
use std::thread;
|
||||
|
||||
/// One loaded kernel module.
|
||||
#[derive(Debug, Clone)]
|
||||
pub struct Module {
|
||||
pub name: String,
|
||||
/// Size in bytes from /proc/modules (this is the core size for most modules).
|
||||
pub size: usize,
|
||||
pub refcnt: i64,
|
||||
/// Modules that depend on this one (parsed from the "used-by" column).
|
||||
pub used_by: Vec<String>,
|
||||
pub state: String,
|
||||
/// Base address (hex string as in /proc/modules).
|
||||
pub addr: String,
|
||||
|
||||
// From /sys/module/<name>/
|
||||
pub coresize: Option<usize>,
|
||||
pub initsize: Option<usize>,
|
||||
pub initstate: Option<String>,
|
||||
pub srcversion: Option<String>,
|
||||
pub taint: Option<String>,
|
||||
pub version: Option<String>,
|
||||
/// Parameters and their current values (read from /sys/module/<name>/parameters).
|
||||
pub parameters: Vec<(String, String)>,
|
||||
/// Modules holding a reference (from /sys/module/<name>/holders).
|
||||
pub holders: Vec<String>,
|
||||
|
||||
// From `modinfo` (lazy; None until explicitly fetched).
|
||||
pub modinfo: Option<ModInfo>,
|
||||
}
|
||||
|
||||
impl Module {
|
||||
/// True if the module matches a substring filter: against its own name OR
|
||||
/// any of the modules that depend on it (`used_by`). Case-insensitive.
|
||||
pub fn matches_filter(&self, needle: &str) -> bool {
|
||||
if needle.is_empty() {
|
||||
return true;
|
||||
}
|
||||
let needle = needle.to_lowercase();
|
||||
if self.name.to_lowercase().contains(&needle) {
|
||||
return true;
|
||||
}
|
||||
self.used_by
|
||||
.iter()
|
||||
.any(|dep| dep.to_lowercase().contains(&needle))
|
||||
}
|
||||
}
|
||||
|
||||
/// The richest metadata, obtained from `modinfo`.
|
||||
#[derive(Debug, Clone, Default)]
|
||||
pub struct ModInfo {
|
||||
pub filename: String,
|
||||
pub license: String,
|
||||
pub description: String,
|
||||
pub author: String,
|
||||
pub depends: Vec<String>,
|
||||
pub vermagic: String,
|
||||
pub retpoline: String,
|
||||
pub intree: String,
|
||||
pub signer: String,
|
||||
pub sig_hashalgo: String,
|
||||
/// Other fields we didn't classify, kept as (key, value) pairs.
|
||||
pub other: Vec<(String, String)>,
|
||||
}
|
||||
|
||||
/// Read a sysfs file to a trimmed String. Returns None on any error.
|
||||
fn read_sysfs(path: &Path) -> Option<String> {
|
||||
fs::read_to_string(path).ok().map(|s| s.trim().to_string())
|
||||
}
|
||||
|
||||
/// Parse the "used-by" column of /proc/modules: tokens separated by commas,
|
||||
/// or "-" if nothing uses this module.
|
||||
fn parse_used_by(s: &str) -> Vec<String> {
|
||||
if s == "-" || s.is_empty() {
|
||||
Vec::new()
|
||||
} else {
|
||||
s.split_terminator(',')
|
||||
.map(|x| x.trim().trim_end_matches('[').trim_end_matches(']').to_string())
|
||||
.filter(|x| !x.is_empty())
|
||||
.collect()
|
||||
}
|
||||
}
|
||||
|
||||
/// Read parameters from /sys/module/<name>/parameters.
|
||||
fn read_parameters(name: &str) -> Vec<(String, String)> {
|
||||
let dir = Path::new("/sys/module").join(name).join("parameters");
|
||||
let mut out = Vec::new();
|
||||
if let Ok(entries) = fs::read_dir(&dir) {
|
||||
for ent in entries.flatten() {
|
||||
let pname = ent.file_name().to_string_lossy().to_string();
|
||||
let val = fs::read_to_string(ent.path())
|
||||
.unwrap_or_default()
|
||||
.trim()
|
||||
.to_string();
|
||||
out.push((pname, val));
|
||||
}
|
||||
}
|
||||
// Deterministic ordering.
|
||||
out.sort_by(|a, b| a.0.cmp(&b.0));
|
||||
out
|
||||
}
|
||||
|
||||
/// Read holders from /sys/module/<name>/holders.
|
||||
fn read_holders(name: &str) -> Vec<String> {
|
||||
let dir = Path::new("/sys/module").join(name).join("holders");
|
||||
let mut out = Vec::new();
|
||||
if let Ok(entries) = fs::read_dir(&dir) {
|
||||
for ent in entries.flatten() {
|
||||
out.push(ent.file_name().to_string_lossy().to_string());
|
||||
}
|
||||
}
|
||||
out.sort();
|
||||
out
|
||||
}
|
||||
|
||||
/// Collect all currently-loaded modules from /proc/modules and /sys/module.
|
||||
pub fn collect_modules() -> Vec<Module> {
|
||||
let proc = fs::read_to_string("/proc/modules").unwrap_or_default();
|
||||
let mut modules: Vec<Module> = Vec::new();
|
||||
|
||||
for line in proc.lines() {
|
||||
let parts: Vec<&str> = line.split_whitespace().collect();
|
||||
if parts.len() < 6 {
|
||||
continue;
|
||||
}
|
||||
// parts: name size refcnt used_by state addr [extra...]
|
||||
let name = parts[0].to_string();
|
||||
let size: usize = parts[1].parse().unwrap_or(0);
|
||||
let refcnt: i64 = parts[2].parse().unwrap_or(0);
|
||||
let used_by = parse_used_by(parts[3]);
|
||||
let state = parts.get(4).map(|s| s.to_string()).unwrap_or_default();
|
||||
let addr = parts.get(5).map(|s| s.to_string()).unwrap_or_default();
|
||||
|
||||
// Enrich from /sys/module/<name>.
|
||||
let sys = Path::new("/sys/module").join(&name);
|
||||
let coresize = read_sysfs(&sys.join("coresize")).and_then(|s| s.parse().ok());
|
||||
let initsize = read_sysfs(&sys.join("initsize")).and_then(|s| s.parse().ok());
|
||||
let initstate = read_sysfs(&sys.join("initstate"));
|
||||
let srcversion = read_sysfs(&sys.join("srcversion"));
|
||||
let taint = read_sysfs(&sys.join("taint"));
|
||||
let version = read_sysfs(&sys.join("version"));
|
||||
let parameters = read_parameters(&name);
|
||||
let holders = read_holders(&name);
|
||||
|
||||
modules.push(Module {
|
||||
name,
|
||||
size,
|
||||
refcnt,
|
||||
used_by,
|
||||
state,
|
||||
addr,
|
||||
coresize,
|
||||
initsize,
|
||||
initstate,
|
||||
srcversion,
|
||||
taint,
|
||||
version,
|
||||
parameters,
|
||||
holders,
|
||||
modinfo: None,
|
||||
});
|
||||
}
|
||||
|
||||
modules.sort_by(|a, b| a.name.cmp(&b.name));
|
||||
modules
|
||||
}
|
||||
|
||||
/// Fetch rich metadata via `modinfo <name>` and parse it into a ModInfo struct.
|
||||
pub fn fetch_modinfo(name: &str) -> Option<ModInfo> {
|
||||
let output = Command::new("modinfo").arg(name).output().ok()?;
|
||||
if !output.status.success() {
|
||||
return None;
|
||||
}
|
||||
let stdout = String::from_utf8_lossy(&output.stdout);
|
||||
Some(parse_modinfo(&stdout))
|
||||
}
|
||||
|
||||
/// Parse `modinfo` output. Each line: `key: value`. Multi-line values (like
|
||||
/// `signature`) are folded by detecting a leading tab/whitespace continuation.
|
||||
fn parse_modinfo(text: &str) -> ModInfo {
|
||||
let mut mi = ModInfo::default();
|
||||
let known: &[&str] = &[
|
||||
"filename",
|
||||
"license",
|
||||
"description",
|
||||
"author",
|
||||
"depends",
|
||||
"vermagic",
|
||||
"retpoline",
|
||||
"intree",
|
||||
"signer",
|
||||
"sig_hashalgo",
|
||||
"sig_id",
|
||||
"sig_key",
|
||||
"signature",
|
||||
"srcversion",
|
||||
"name",
|
||||
"version",
|
||||
];
|
||||
let mut last_key = String::new();
|
||||
for raw in text.lines() {
|
||||
// Continuation line (starts with whitespace) appends to last value.
|
||||
if raw.starts_with('\t') || (raw.starts_with(' ') && !raw.trim().is_empty()) {
|
||||
if !last_key.is_empty() {
|
||||
let cont = raw.trim();
|
||||
// Append to whichever field last_key refers to.
|
||||
append_to_field(&mut mi, &last_key, cont);
|
||||
}
|
||||
continue;
|
||||
}
|
||||
if let Some((k, v)) = raw.split_once(':') {
|
||||
let key = k.trim().to_string();
|
||||
let val = v.trim().to_string();
|
||||
last_key = key.clone();
|
||||
set_field(&mut mi, &key, &val, known);
|
||||
}
|
||||
}
|
||||
mi
|
||||
}
|
||||
|
||||
fn set_field(mi: &mut ModInfo, key: &str, val: &str, known: &[&str]) {
|
||||
match key {
|
||||
"filename" => mi.filename = val.to_string(),
|
||||
"license" => mi.license = val.to_string(),
|
||||
"description" => mi.description = val.to_string(),
|
||||
"author" => mi.author = val.to_string(),
|
||||
"depends" => {
|
||||
mi.depends = if val == "-" || val.is_empty() {
|
||||
Vec::new()
|
||||
} else {
|
||||
val.split(',').map(|s| s.trim().to_string()).collect()
|
||||
};
|
||||
}
|
||||
"vermagic" => mi.vermagic = val.to_string(),
|
||||
"retpoline" => mi.retpoline = val.to_string(),
|
||||
"intree" => mi.intree = val.to_string(),
|
||||
"signer" => mi.signer = val.to_string(),
|
||||
"sig_hashalgo" => mi.sig_hashalgo = val.to_string(),
|
||||
_ => {
|
||||
let _ = known;
|
||||
mi.other.push((key.to_string(), val.to_string()));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
fn append_to_field(mi: &mut ModInfo, key: &str, val: &str) {
|
||||
match key {
|
||||
"description" => {
|
||||
if !mi.description.is_empty() {
|
||||
mi.description.push(' ');
|
||||
}
|
||||
mi.description.push_str(val);
|
||||
}
|
||||
"signature" | "sig_key" => {
|
||||
// Append to the most recent 'other' entry if it matches.
|
||||
if let Some(last) = mi.other.last_mut() {
|
||||
if last.0 == key {
|
||||
last.1.push_str(val);
|
||||
}
|
||||
}
|
||||
}
|
||||
_ => {}
|
||||
}
|
||||
}
|
||||
|
||||
/// Spawn a thread to fetch modinfo for a module, returning a channel that
|
||||
/// yields (name, Option<ModInfo>) when ready. Lets the UI stay responsive.
|
||||
pub fn spawn_modinfo_fetch(name: String) -> mpsc::Receiver<(String, Option<ModInfo>)> {
|
||||
let (tx, rx) = mpsc::channel();
|
||||
thread::spawn(move || {
|
||||
let mi = fetch_modinfo(&name);
|
||||
let _ = tx.send((name, mi));
|
||||
});
|
||||
rx
|
||||
}
|
||||
|
||||
/// Human-readable byte size, /proc/modules style: 12288 -> "12K", 114688 -> "112K".
|
||||
pub fn human_size(bytes: usize) -> String {
|
||||
let k = 1024usize;
|
||||
let m = k * 1024;
|
||||
if bytes >= m {
|
||||
format!("{:.1}M", bytes as f64 / m as f64)
|
||||
} else if bytes >= k {
|
||||
format!("{}K", bytes / k)
|
||||
} else {
|
||||
format!("{}B", bytes)
|
||||
}
|
||||
}
|
||||
|
||||
/// Kernel release string, e.g. "6.8.0-137-generic".
|
||||
pub fn kernel_release() -> String {
|
||||
fs::read_to_string("/proc/sys/kernel/osrelease")
|
||||
.map(|s| s.trim().to_string())
|
||||
.unwrap_or_else(|_| "unknown".to_string())
|
||||
}
|
||||
|
||||
/// Count of modules currently loaded (cheap: line count of /proc/modules).
|
||||
/// Reserved for a future status-bar "loaded vs filtered" split.
|
||||
#[allow(dead_code)]
|
||||
pub fn loaded_count() -> usize {
|
||||
fs::read_to_string("/proc/modules")
|
||||
.map(|s| s.lines().filter(|l| !l.is_empty()).count())
|
||||
.unwrap_or(0)
|
||||
}
|
||||
|
||||
#[cfg(test)]
|
||||
mod tests {
|
||||
use super::*;
|
||||
|
||||
#[test]
|
||||
fn parse_used_by_dash() {
|
||||
assert!(parse_used_by("-").is_empty());
|
||||
}
|
||||
#[test]
|
||||
fn parse_used_by_list() {
|
||||
let v = parse_used_by("wireguard,curve25519_x86_64");
|
||||
assert_eq!(v, vec!["wireguard", "curve25519_x86_64"]);
|
||||
}
|
||||
#[test]
|
||||
fn filter_matches_name() {
|
||||
let m = Module {
|
||||
name: "wireguard".into(),
|
||||
size: 0,
|
||||
refcnt: 0,
|
||||
used_by: vec![],
|
||||
state: "Live".into(),
|
||||
addr: String::new(),
|
||||
coresize: None,
|
||||
initsize: None,
|
||||
initstate: None,
|
||||
srcversion: None,
|
||||
taint: None,
|
||||
version: None,
|
||||
parameters: vec![],
|
||||
holders: vec![],
|
||||
modinfo: None,
|
||||
};
|
||||
assert!(m.matches_filter("wire"));
|
||||
assert!(m.matches_filter("GUARD")); // case-insensitive
|
||||
assert!(!m.matches_filter("ipsec"));
|
||||
assert!(m.matches_filter("")); // empty matches all
|
||||
}
|
||||
#[test]
|
||||
fn filter_matches_dependents() {
|
||||
let m = Module {
|
||||
name: "curve25519_x86_64".into(),
|
||||
size: 0,
|
||||
refcnt: 1,
|
||||
used_by: vec!["wireguard".into()],
|
||||
state: "Live".into(),
|
||||
addr: String::new(),
|
||||
coresize: None,
|
||||
initsize: None,
|
||||
initstate: None,
|
||||
srcversion: None,
|
||||
taint: None,
|
||||
version: None,
|
||||
parameters: vec![],
|
||||
holders: vec![],
|
||||
modinfo: None,
|
||||
};
|
||||
// Name doesn't contain "wireguard" but a dependent does.
|
||||
assert!(m.matches_filter("wireguard"));
|
||||
assert!(m.matches_filter("curve")); // also still matches own name
|
||||
assert!(!m.matches_filter("chacha"));
|
||||
}
|
||||
#[test]
|
||||
fn parse_modinfo_basic() {
|
||||
let s = "filename: /lib/modules/6.8.0-137-generic/kernel/wireguard/wireguard.ko.zst\n\
|
||||
license: GPL\n\
|
||||
description: WireGuard secure tunnel\n\
|
||||
author: Jason A. Donenfeld <Jason@zx2c4.com>\n\
|
||||
depends: \n\
|
||||
retpoline: Y\n\
|
||||
intree: Y\n\
|
||||
name: wireguard\n\
|
||||
vermagic: 6.8.0-137-generic SMP preempt mod_unload modversions \n";
|
||||
let mi = parse_modinfo(s);
|
||||
assert_eq!(mi.license, "GPL");
|
||||
assert_eq!(mi.description, "WireGuard secure tunnel");
|
||||
assert_eq!(mi.author, "Jason A. Donenfeld <Jason@zx2c4.com>");
|
||||
assert!(mi.depends.is_empty());
|
||||
assert_eq!(mi.retpoline, "Y");
|
||||
}
|
||||
#[test]
|
||||
fn human_size_units() {
|
||||
assert_eq!(human_size(12288), "12K");
|
||||
assert_eq!(human_size(114688), "112K");
|
||||
assert_eq!(human_size(1048576), "1.0M");
|
||||
assert_eq!(human_size(512), "512B");
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,207 @@
|
||||
//! The detail pane (bottom of list view) and the full-screen detail view.
|
||||
|
||||
use ratatui::layout::{Alignment, Constraint, Layout, Rect};
|
||||
use ratatui::style::{Color, Modifier, Style};
|
||||
use ratatui::text::{Line, Span};
|
||||
use ratatui::widgets::{Block, Borders, List, ListItem, Paragraph, Wrap};
|
||||
use ratatui::Frame;
|
||||
|
||||
use crate::app::App;
|
||||
use crate::model::{human_size, Module};
|
||||
|
||||
/// Bottom detail pane: a compact two-column summary of the selected module.
|
||||
pub fn draw_pane(f: &mut Frame, area: Rect, app: &App) {
|
||||
let title = match app.current_module() {
|
||||
Some(m) => format!(" Detail: {} ", m.name),
|
||||
None => " Detail ".to_string(),
|
||||
};
|
||||
let block = Block::default().borders(Borders::ALL).title(title);
|
||||
f.render_widget(block, area);
|
||||
let inner = area.inner(ratatui::layout::Margin {
|
||||
horizontal: 1,
|
||||
vertical: 1,
|
||||
});
|
||||
if inner.height < 1 {
|
||||
return;
|
||||
}
|
||||
let Some(m) = app.current_module() else {
|
||||
let p = Paragraph::new("No module selected.")
|
||||
.style(Style::default().fg(Color::DarkGray));
|
||||
f.render_widget(p, inner);
|
||||
return;
|
||||
};
|
||||
|
||||
let cols = Layout::horizontal([Constraint::Fill(1), Constraint::Fill(1)]).split(inner);
|
||||
let left = summary_lines(m);
|
||||
let right = meta_lines(m);
|
||||
f.render_widget(Paragraph::new(left).wrap(Wrap { trim: true }), cols[0]);
|
||||
f.render_widget(Paragraph::new(right).wrap(Wrap { trim: true }), cols[1]);
|
||||
}
|
||||
|
||||
fn kv<'a>(k: &str, v: &str) -> Line<'a> {
|
||||
Line::from(vec![
|
||||
Span::styled(
|
||||
format!("{:<11}", k),
|
||||
Style::default().fg(Color::Cyan).add_modifier(Modifier::BOLD),
|
||||
),
|
||||
Span::raw(v.to_string()),
|
||||
])
|
||||
}
|
||||
|
||||
fn summary_lines<'a>(m: &Module) -> Vec<Line<'a>> {
|
||||
let mut lines = vec![
|
||||
kv("Name", &m.name),
|
||||
kv("Size", &human_size(m.size)),
|
||||
kv("Refcnt", &m.refcnt.to_string()),
|
||||
kv("State", &m.state),
|
||||
kv("Address", &m.addr),
|
||||
];
|
||||
if let Some(cs) = m.coresize {
|
||||
lines.push(kv("Coresize", &human_size(cs)));
|
||||
}
|
||||
if let Some(is) = m.initsize {
|
||||
lines.push(kv("Initsize", &human_size(is)));
|
||||
}
|
||||
if let Some(v) = &m.initstate {
|
||||
lines.push(kv("Initstate", v));
|
||||
}
|
||||
if let Some(v) = &m.taint {
|
||||
if !v.is_empty() {
|
||||
lines.push(kv("Taint", v));
|
||||
}
|
||||
}
|
||||
if let Some(v) = &m.version {
|
||||
lines.push(kv("Version", v));
|
||||
}
|
||||
if let Some(v) = &m.srcversion {
|
||||
lines.push(kv("Srcversion", v));
|
||||
}
|
||||
lines
|
||||
}
|
||||
|
||||
fn meta_lines<'a>(m: &Module) -> Vec<Line<'a>> {
|
||||
let mut lines: Vec<Line> = Vec::new();
|
||||
match &m.modinfo {
|
||||
Some(mi) => {
|
||||
lines.push(kv("Filename", &mi.filename));
|
||||
lines.push(kv("License", &mi.license));
|
||||
lines.push(kv("Author", &mi.author));
|
||||
lines.push(kv("Vermagic", &mi.vermagic));
|
||||
lines.push(kv("Retpoline", &mi.retpoline));
|
||||
lines.push(kv("Intree", &mi.intree));
|
||||
lines.push(kv("Signer", &mi.signer));
|
||||
}
|
||||
None => {
|
||||
lines.push(Line::from(Span::styled(
|
||||
"Loading modinfo…",
|
||||
Style::default().fg(Color::DarkGray),
|
||||
)));
|
||||
}
|
||||
}
|
||||
let dep = if m.used_by.is_empty() {
|
||||
"(none)".to_string()
|
||||
} else {
|
||||
m.used_by.join(", ")
|
||||
};
|
||||
lines.push(kv("Used by", &dep));
|
||||
let holders = if m.holders.is_empty() {
|
||||
"(none)".to_string()
|
||||
} else {
|
||||
m.holders.join(", ")
|
||||
};
|
||||
lines.push(kv("Holders", &holders));
|
||||
let params = if m.parameters.is_empty() {
|
||||
"(none)".to_string()
|
||||
} else {
|
||||
m.parameters
|
||||
.iter()
|
||||
.map(|(k, v)| format!("{k}={v}"))
|
||||
.collect::<Vec<_>>()
|
||||
.join(", ")
|
||||
};
|
||||
lines.push(kv("Params", ¶ms));
|
||||
lines
|
||||
}
|
||||
|
||||
/// Full-screen detail view for the selected module.
|
||||
pub fn draw_full(f: &mut Frame, area: Rect, app: &App) {
|
||||
let title = match app.current_module() {
|
||||
Some(m) => format!(" {} — full detail (Esc to return) ", m.name),
|
||||
None => " Full detail ".to_string(),
|
||||
};
|
||||
let block = Block::default().borders(Borders::ALL).title(title);
|
||||
f.render_widget(block, area);
|
||||
let inner = area.inner(ratatui::layout::Margin {
|
||||
horizontal: 1,
|
||||
vertical: 1,
|
||||
});
|
||||
let Some(m) = app.current_module() else {
|
||||
return;
|
||||
};
|
||||
|
||||
// Three sections: summary, modinfo/depends, parameters+holders.
|
||||
let chunks = Layout::vertical([
|
||||
Constraint::Length(9),
|
||||
Constraint::Length(8),
|
||||
Constraint::Min(5),
|
||||
])
|
||||
.split(inner);
|
||||
|
||||
f.render_widget(Paragraph::new(summary_lines(m)), chunks[0]);
|
||||
|
||||
let mut meta = meta_lines_full(m);
|
||||
f.render_widget(Paragraph::new(meta.drain(..).collect::<Vec<_>>()), chunks[1]);
|
||||
|
||||
// Parameters and holders as lists.
|
||||
let sub = Layout::horizontal([Constraint::Fill(1), Constraint::Fill(1)]).split(chunks[2]);
|
||||
let pitems: Vec<ListItem> = if m.parameters.is_empty() {
|
||||
vec![ListItem::new("(none)")]
|
||||
} else {
|
||||
m.parameters
|
||||
.iter()
|
||||
.map(|(k, v)| ListItem::new(format!("{} = {}", k, v)))
|
||||
.collect()
|
||||
};
|
||||
f.render_widget(
|
||||
List::new(pitems).block(Block::default().borders(Borders::ALL).title("Parameters")),
|
||||
sub[0],
|
||||
);
|
||||
let hitems: Vec<ListItem> = if m.holders.is_empty() {
|
||||
vec![ListItem::new("(none)")]
|
||||
} else {
|
||||
m.holders.iter().map(|h| ListItem::new(h.clone())).collect()
|
||||
};
|
||||
f.render_widget(
|
||||
List::new(hitems).block(Block::default().borders(Borders::ALL).title("Holders")),
|
||||
sub[1],
|
||||
);
|
||||
}
|
||||
|
||||
fn meta_lines_full<'a>(m: &Module) -> Vec<Line<'a>> {
|
||||
let mut lines: Vec<Line> = Vec::new();
|
||||
if let Some(mi) = &m.modinfo {
|
||||
lines.push(kv("Filename", &mi.filename));
|
||||
lines.push(kv("License", &mi.license));
|
||||
lines.push(kv("Description", &mi.description));
|
||||
lines.push(kv("Author", &mi.author));
|
||||
lines.push(kv("Vermagic", &mi.vermagic));
|
||||
let dep = if mi.depends.is_empty() {
|
||||
"(none)".to_string()
|
||||
} else {
|
||||
mi.depends.join(", ")
|
||||
};
|
||||
lines.push(kv("Depends", &dep));
|
||||
lines.push(kv("Retpoline", &mi.retpoline));
|
||||
} else {
|
||||
lines.push(Line::from(Span::styled(
|
||||
"Loading modinfo… (press Enter again if it stalls)",
|
||||
Style::default().fg(Color::DarkGray),
|
||||
)));
|
||||
}
|
||||
lines
|
||||
}
|
||||
|
||||
#[allow(dead_code)]
|
||||
fn _alignment_unused() -> Alignment {
|
||||
Alignment::Left
|
||||
}
|
||||
@@ -0,0 +1,91 @@
|
||||
//! The module list pane (top of the list view).
|
||||
//!
|
||||
//! Scrolling is edge-based: the cursor moves freely within the viewport and
|
||||
//! the list only scrolls when the cursor would leave the visible area. The
|
||||
//! scroll offset lives in `App` (set by `ui::mod` via `adjust_scroll`) so it's
|
||||
//! stateful and stable across draws.
|
||||
|
||||
use ratatui::layout::{Constraint, Rect};
|
||||
use ratatui::style::{Color, Modifier, Style};
|
||||
use ratatui::widgets::{Block, Borders, Row, Table};
|
||||
use ratatui::Frame;
|
||||
|
||||
use crate::app::App;
|
||||
use crate::model::human_size;
|
||||
|
||||
/// Column widths.
|
||||
const WIDTHS: [Constraint; 6] = [
|
||||
Constraint::Length(4), // #
|
||||
Constraint::Min(22), // name
|
||||
Constraint::Length(8), // size
|
||||
Constraint::Length(5), // refcnt
|
||||
Constraint::Min(18), // used by
|
||||
Constraint::Length(7), // state
|
||||
];
|
||||
|
||||
/// How many data rows fit in the list pane for the given area (excludes the
|
||||
/// header row and the border). Used by `ui::mod` to size the viewport before
|
||||
/// the list is drawn.
|
||||
pub fn visible_rows(area: Rect) -> usize {
|
||||
let inner = area.inner(ratatui::layout::Margin {
|
||||
horizontal: 1,
|
||||
vertical: 1,
|
||||
});
|
||||
inner.height.saturating_sub(1) as usize // account for the header row
|
||||
}
|
||||
|
||||
pub fn draw(f: &mut Frame, area: Rect, app: &App) {
|
||||
let block = Block::default()
|
||||
.borders(Borders::ALL)
|
||||
.title(format!(" Loaded modules: {} ", app.view.len()));
|
||||
f.render_widget(block, area);
|
||||
let inner = area.inner(ratatui::layout::Margin {
|
||||
horizontal: 1,
|
||||
vertical: 1,
|
||||
});
|
||||
if inner.height < 1 {
|
||||
return;
|
||||
}
|
||||
|
||||
let header = Row::new(vec!["#", "Module", "Size", "Refc", "Used by", "State"])
|
||||
.style(Style::default().add_modifier(Modifier::BOLD).fg(Color::Cyan));
|
||||
|
||||
let rows_visible = visible_rows(area);
|
||||
let start = app.scroll;
|
||||
|
||||
let rows: Vec<Row> = app
|
||||
.view
|
||||
.iter()
|
||||
.enumerate()
|
||||
.skip(start)
|
||||
.take(rows_visible)
|
||||
.map(|(vn, &idx)| {
|
||||
let m = &app.modules[idx];
|
||||
let used = if m.used_by.is_empty() {
|
||||
"-".to_string()
|
||||
} else {
|
||||
m.used_by.join(",")
|
||||
};
|
||||
let selected = vn == app.cursor;
|
||||
let row_style = if selected {
|
||||
Style::default()
|
||||
.bg(Color::DarkGray)
|
||||
.add_modifier(Modifier::BOLD)
|
||||
} else {
|
||||
Style::default()
|
||||
};
|
||||
Row::new(vec![
|
||||
format!("{}", vn + 1),
|
||||
m.name.clone(),
|
||||
human_size(m.size),
|
||||
format!("{}", m.refcnt),
|
||||
used,
|
||||
m.state.clone(),
|
||||
])
|
||||
.style(row_style)
|
||||
})
|
||||
.collect();
|
||||
|
||||
let table = Table::new(rows, WIDTHS).header(header);
|
||||
f.render_widget(table, inner);
|
||||
}
|
||||
+171
@@ -0,0 +1,171 @@
|
||||
pub mod list;
|
||||
pub mod detail;
|
||||
|
||||
use ratatui::layout::{Constraint, Layout, Rect};
|
||||
use ratatui::style::{Color, Modifier, Style};
|
||||
use ratatui::text::{Line, Span};
|
||||
use ratatui::widgets::{Block, Borders, Clear, Paragraph};
|
||||
use ratatui::Frame;
|
||||
|
||||
use crate::app::{App, View};
|
||||
|
||||
/// Compose the whole frame from the app state.
|
||||
pub fn draw(f: &mut Frame, app: &mut App) {
|
||||
let area = f.area();
|
||||
let chunks = Layout::vertical([
|
||||
Constraint::Length(3), // status/filter bar
|
||||
Constraint::Min(5), // main area
|
||||
Constraint::Length(2), // footer
|
||||
])
|
||||
.split(area);
|
||||
|
||||
draw_status(f, chunks[0], app);
|
||||
|
||||
match app.view_mode {
|
||||
View::List => {
|
||||
let main = Layout::vertical([Constraint::Fill(2), Constraint::Length(10)])
|
||||
.split(chunks[1]);
|
||||
// Set how many rows the list pane can show, then edge-scroll so
|
||||
// the cursor stays visible without centering it.
|
||||
app.viewport_rows = list::visible_rows(main[0]);
|
||||
app.adjust_scroll();
|
||||
list::draw(f, main[0], app);
|
||||
detail::draw_pane(f, main[1], app);
|
||||
}
|
||||
View::FullDetail => {
|
||||
detail::draw_full(f, chunks[1], app);
|
||||
}
|
||||
}
|
||||
|
||||
draw_footer(f, chunks[2], app);
|
||||
|
||||
if app.help {
|
||||
draw_help(f, area);
|
||||
}
|
||||
}
|
||||
|
||||
fn draw_status(f: &mut Frame, area: Rect, app: &App) {
|
||||
let title = format!(
|
||||
" kmod-tui — {} modules loaded (kernel {}) ",
|
||||
app.view.len(),
|
||||
app.kernel
|
||||
);
|
||||
let block = Block::default().borders(Borders::ALL).title(title);
|
||||
f.render_widget(block, area);
|
||||
let inner = area.inner(ratatui::layout::Margin {
|
||||
horizontal: 1,
|
||||
vertical: 1,
|
||||
});
|
||||
|
||||
let line = if app.filter_active {
|
||||
Line::from(vec![
|
||||
Span::styled(
|
||||
"Filter: ",
|
||||
Style::default().fg(Color::Cyan).add_modifier(Modifier::BOLD),
|
||||
),
|
||||
Span::raw(app.filter.clone()),
|
||||
Span::styled("_", Style::default().fg(Color::Gray)),
|
||||
Span::raw(" "),
|
||||
Span::raw(format!("Sort: {}", app.sort.label())),
|
||||
])
|
||||
} else {
|
||||
Line::from(vec![
|
||||
Span::styled(
|
||||
"Sort: ",
|
||||
Style::default().fg(Color::Cyan).add_modifier(Modifier::BOLD),
|
||||
),
|
||||
Span::raw(app.sort.label()),
|
||||
Span::raw(" "),
|
||||
Span::styled(
|
||||
format!("Filter: {}", if app.filter.is_empty() { "(none)" } else { &app.filter }),
|
||||
Style::default().fg(Color::Gray),
|
||||
),
|
||||
])
|
||||
};
|
||||
f.render_widget(Paragraph::new(line), inner);
|
||||
}
|
||||
|
||||
fn draw_footer(f: &mut Frame, area: Rect, app: &App) {
|
||||
let block = Block::default().borders(Borders::TOP);
|
||||
f.render_widget(block, area);
|
||||
let inner = area.inner(ratatui::layout::Margin {
|
||||
horizontal: 1,
|
||||
vertical: 0,
|
||||
});
|
||||
let keys = match app.view_mode {
|
||||
View::List => {
|
||||
if app.filter_active {
|
||||
"Esc clear Backspace del type to filter Enter accept q quit"
|
||||
} else {
|
||||
"↑/j down ↓/k up Enter detail / filter s sort r refresh ? help q quit"
|
||||
}
|
||||
}
|
||||
View::FullDetail => "Esc back ? help q quit",
|
||||
};
|
||||
let line = Line::from(Span::styled(
|
||||
keys,
|
||||
Style::default().fg(Color::DarkGray),
|
||||
));
|
||||
f.render_widget(Paragraph::new(line), inner);
|
||||
}
|
||||
|
||||
fn draw_help(f: &mut Frame, area: Rect) {
|
||||
let help_text = vec![
|
||||
Line::from(Span::styled(
|
||||
"kmod-tui — help",
|
||||
Style::default().fg(Color::Cyan).add_modifier(Modifier::BOLD),
|
||||
)),
|
||||
Line::from(""),
|
||||
Line::from(vec![
|
||||
Span::styled(" ↑/j ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("move selection down"),
|
||||
]),
|
||||
Line::from(vec![
|
||||
Span::styled(" ↓/k ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("move selection up"),
|
||||
]),
|
||||
Line::from(vec![
|
||||
Span::styled(" Enter ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("open full detail for selected module"),
|
||||
]),
|
||||
Line::from(vec![
|
||||
Span::styled(" / ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("start filtering by module name"),
|
||||
]),
|
||||
Line::from(vec![
|
||||
Span::styled(" Esc ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("clear filter / close full detail"),
|
||||
]),
|
||||
Line::from(vec![
|
||||
Span::styled(" s ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("cycle sort: name → size → refcnt → dependents"),
|
||||
]),
|
||||
Line::from(vec![
|
||||
Span::styled(" r ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("refresh module list from /proc/modules"),
|
||||
]),
|
||||
Line::from(vec![
|
||||
Span::styled(" ? ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("toggle this help overlay"),
|
||||
]),
|
||||
Line::from(vec![
|
||||
Span::styled(" q ", Style::default().fg(Color::Yellow)),
|
||||
Span::raw("quit"),
|
||||
]),
|
||||
];
|
||||
let width = 52;
|
||||
let height = help_text.len() as u16 + 4;
|
||||
let x = area.width.saturating_sub(width) / 2;
|
||||
let y = area.height.saturating_sub(height) / 2;
|
||||
let popup = Rect::new(x, y, width, height);
|
||||
f.render_widget(Clear, popup);
|
||||
let block = Block::default()
|
||||
.borders(Borders::ALL)
|
||||
.title(" Help (press ? to close) ");
|
||||
f.render_widget(block, popup);
|
||||
let inner = popup.inner(ratatui::layout::Margin {
|
||||
horizontal: 1,
|
||||
vertical: 1,
|
||||
});
|
||||
f.render_widget(Paragraph::new(help_text), inner);
|
||||
}
|
||||
Reference in New Issue
Block a user