MODEMMANAGER(8)

💖 MODEMMANAGER(8) 💖

✨ NAME ✨

okay so the name of this thing is ModemManager, and it's a mobile broadband modem management daemon 📱🦋

🎀 SYNOPSIS 🎀

ModemManager [OPTION...]

💅 DESCRIPTION 💅

okay so ModemManager gives you one unified, high level API for talking to mobile broadband modems. ✨ It doesn't matter what protocol the actual device speaks (Generic AT, vendor-specific AT, QCDM, QMI, MBIM... the whole alphabet soup 🍓), ModemManager handles it for you.

ModemManager is a DBus-based system daemon, so it's not meant to be used directly from the command line. 🙈

bestie, seriously, don't go poking at it from your terminal like it's a normal app. It's a daemon. Let it do its thing in the background. 💀

🌸 APPLICATION OPTIONS 🌸

• --filter-policy=<policy> — this one decides which ports get probed and how 🔍
  • 'ALLOWLIST-ONLY' — only devices or ports that are explicitly allowlisted with the 'ID_MM_DEVICE_PROCESS' udev tag get probed
  • 'STRICT' — only the TTY ports that are heuristically determined to be very likely modem ports get probed. It may end up ignoring some devices, so heads up 🥺
• --no-auto-scan — fully disables the udev-based auto-scan that goes looking for devices 🚫
• --initial-kernel-events=<filename> — tells it where to find the file with the list of initial kernel events. The ModemManager daemon will process that file on startup 📂
• --debug — runs ModemManager with the "DEBUG" log level and without daemonizing. Super useful for debugging, because log output goes to your controlling terminal as well as syslog 🔧
• -V, --version — prints the ModemManager software version and exits 🏷️
• -h, --help — shows the application options 💁‍♀️

📝 LOGGING OPTIONS 📝

• --log-level=<level> — controls how much info ModemManager sends to the log destination (usually syslog's "daemon" facility). By default only informational, warning, and error messages get logged. Your level has to be one of "ERR", "WARN", "INFO" or "DEBUG" ⭐
• --log-file=<filename> — picks a file to dump the log messages into, instead of syslog 🗂️
• --log-journal — outputs log messages to the systemd journal 📓
• --log-timestamps — adds absolute timestamps to the log output 🕰️
• --log-relative-timestamps — adds timestamps relative to the start time of the daemon to the log output ⏱️

🧪 TEST OPTIONS 🧪

• --test-session — runs the ModemManager daemon on the Session bus instead of the System bus 🚌
• --test-enable — enables the Test DBus interface in the daemon 🧚
• --test-plugin-dir=[PATH] — points the daemon at an alternate directory to look for vendor plugins in 📁

👑 AUTHOR 👑

Aleksander Morgado <aleksander@aleksander.es> 🫶

🔗 SEE ALSO 🔗

mmcli(1), NetworkManager(8) 💜

okay that's the whole tea ☕💖 MODEMMANAGER(8) from 5 September 2014, and you now officially know more about modem daemons than most people. slay, bestie 💅✨