# Linux Modules
[](https://github.com/RichardLitt/standard-readme)
[](https://crates.io/crates/linux_modules)
[](https://docs.rs/linux_modules)
Tool To Manage Linux Kernel Modules
This is a tool to manage your Linux Kernel Modules.
It is an alternative to `modprobe`, and supports listing, adding, and removing modules,
as well as displaying information on them.
It does not yet support modprobe style dependencies or aliases,
and is not capable of displaying module signature data, except whether one exists or not.
## Install
```shell
cargo install linux_modules
```
## Usage
### CLI
```shell
$ nms info loop
╭───────────────────┬──────────────────────────────────────╮
│ File ┆ /lib/modules/6.3.1-arch2-1/kernel/dr │
│ ┆ ivers/block/loop.ko.zst │
╞═══════════════════╪══════════════════════════════════════╡
│ Authors ┆ │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ License ┆ GPL │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Description ┆ │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Version ┆ │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Firmware ┆ │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Alias ┆ devname:loop-control │
│ ┆ char-major-10-237 │
│ ┆ block-major-7-* │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Dependencies ┆ │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Soft Dependencies ┆ │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Imports ┆ │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ In Tree ┆ true │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Retpoline ┆ true │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Staging ┆ false │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Version Magic ┆ 6.3.1-arch2-1 SMP preempt mod_unload │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Source Checksum ┆ B9EBD1F7F134B1C20C5B09B │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Parameters ┆ ╭────────────┬───────────┬─────────╮ │
│ ┆ │ Name ┆ Descripti ┆ Type │ │
│ ┆ │ ┆ on ┆ │ │
│ ┆ ╞════════════╪═══════════╪═════════╡ │
│ ┆ │ hw_queue_d ┆ Queue ┆ Unknown │ │
│ ┆ │ epth ┆ depth for ┆ │ │
│ ┆ │ ┆ each ┆ │ │
│ ┆ │ ┆ hardware ┆ │ │
│ ┆ │ ┆ queue. ┆ │ │
│ ┆ │ ┆ Default: ┆ │ │
│ ┆ │ ┆ 128 ┆ │ │
│ ┆ ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤ │
│ ┆ │ max_loop ┆ Maximum ┆ Int │ │
│ ┆ │ ┆ number of ┆ │ │
│ ┆ │ ┆ loop ┆ │ │
│ ┆ │ ┆ devices ┆ │ │
│ ┆ ├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌┤ │
│ ┆ │ max_part ┆ Maximum ┆ Int │ │
│ ┆ │ ┆ number of ┆ │ │
│ ┆ │ ┆ partition ┆ │ │
│ ┆ │ ┆ s per ┆ │ │
│ ┆ │ ┆ loop ┆ │ │
│ ┆ │ ┆ device ┆ │ │
│ ┆ ╰────────────┴───────────┴─────────╯ │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Certificate ┆ ╭───────────┬──────────────────────╮ │
│ ┆ │ Issuer ┆ Build time │ │
│ ┆ │ ┆ autogenerated kernel │ │
│ ┆ │ ┆ key │ │
│ ┆ ├╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤ │
│ ┆ │ Key ┆ 4E:B6:01:3E:90:BF:CB │ │
│ ┆ │ ┆ :2F:16:A8:7B:E8:BD:D │ │
│ ┆ │ ┆ 9:84:E2:62:13:DA:93 │ │
│ ┆ ├╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤ │
│ ┆ │ Hash ┆ SHA-512 │ │
│ ┆ ├╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤ │
│ ┆ │ Signature ┆ 30:65:02:30:10:6E:4F │ │
│ ┆ │ ┆ :14:BB:47:BA:27:BD:3 │ │
│ ┆ │ ┆ 6:70:AE:1F:29:DD:DB: │ │
│ ┆ │ ┆ 8E:30:83:B1:BB:EF:62 │ │
│ ┆ │ ┆ :90:B1:8E:33:87:E2:5 │ │
│ ┆ │ ┆ 2:16:A4:19:DA:21:2B: │ │
│ ┆ │ ┆ 9D:44:89:EB:24:8A:07 │ │
│ ┆ │ ┆ :2E:5E:0D:F0:38:02:3 │ │
│ ┆ │ ┆ 1:00:CC:5E:DF:B0:15: │ │
│ ┆ │ ┆ EE:96:D9:49:98:A1:16 │ │
│ ┆ │ ┆ :75:28:45:80:4A:8B:7 │ │
│ ┆ │ ┆ B:9D:C7:11:06:C6:C6: │ │
│ ┆ │ ┆ 99:31:4C:56:8D:7D:37 │ │
│ ┆ │ ┆ :72:4E:83:6D:6F:4D:8 │ │
│ ┆ │ ┆ 9:6A:D8:29:14:D4:25: │ │
│ ┆ │ ┆ B1:83:C5 │ │
│ ┆ ╰───────────┴──────────────────────╯ │
╰───────────────────┴──────────────────────────────────────╯
```
Note that the table size will adapt to your terminal.
This example uses size `60`, chosen for best fit on <https://crates.io>
### Pager
`nms info` and `nms list` automatically pipe output to a pager,
defaulting to `less`, but this may be customized through environment variables.
See the [`pager`](https://crates.io/crates/pager) crate for details on
how to customize what pager is used.
## Changelog
Please see [CHANGELOG](CHANGELOG.md) for version history
## Contributing
This crate is not looking for contributors at this time.
However, feel free to ask questions and request bindings using github issues,
or suggest/discuss API improvements.
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as below, without any additional terms or conditions.
## License
Licensed under either of
- Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or <http://www.apache.org/licenses/LICENSE-2.0)>
- MIT license
([LICENSE-MIT](LICENSE-MIT) or <http://opensource.org/licenses/MIT)>
at your option.