MSTFWMANAGER(1)

👑 MSTFWMANAGER(1) — the Mellanox Firmware Manager glow-up ✨

okay bestie, sit down, hydrate, because we're about to talk about mstfwmanager — aka the Mellanox Firmware Manager 💅 this is a User Commands girlie and she is serving.

---

🌸 NAME 🌸

mstfwmanager — Mellanox Firmware Manager. that's it, that's the name, she's iconic 🎀

---

💜 DESCRIPTION 💜

okay so the original page is doing a little nesting situation, like a matryoshka doll of documentation, and we're keeping every layer because we don't gatekeep 🙈

✨ NAME ✨

mstfwmanager — yes queen, again, we love consistency 💖

🦋 SYNOPSIS 🦋

the whole vibe, verbatim, no notes:

mstfwmanager

[-d|--dev DeviceName] [-h|--help] [-v|--version] [--query]
[--query-format Format] [-u|--update] [-i|--image-file FileName]
[-D|--image-dir DirectoryName] [-f|--force] [--no_fw_ctrl]
[-y|--yes] [--no] [--clear-semaphore] [--exe-rel-path]
[-l|--list-content] [--archive-names] [--nofs] [--log]
[-L|--log-file LogFileName] [--no-progress] [-o|--outfile
OutputFileName] [--online] [--online-query-psid PSIDs] [--key
key] [--download DirectoryName] [--download-default]
[--get-download-opt OPT] [--download-device Device]
[--download-os OS] [--download-type Type] [--ssl-certificate
Certificate]

🌈 DESCRIPTION 🌈

Mellanox Firmware Manager. literally that. short, sweet, main character energy 👑

🍓 OPTIONS 🍓

mstfwmanager — and here come the flags, bestie, all of them, no skips, we're doing the full tour 💅

---

💖 OPTIONS 💖

• -d, --dev DeviceName — do the thing for the mst device(s) you named. run mst status to see what devices you actually have, because guessing is not the vibe 🙈 you can stack multiple devices by separating them with semicolons. and if your device list has semicolons in it, you must quote it, fr fr — the shell will absolutely eat it otherwise 😭
• -h, --help — show this message and dip. bye bestie 👋
• -v, --version — show the executable version and exit. cute little flex 💅
• --query — query the device(s) for info. get to know her 🔍
• --query-format Format — the output format for (Query | Online query): XML or Text — and the default is Text ✨
• -u, --update — update the firmware image(s) on the device(s). glow-up time 🌟
• -i, --image-file FileName — the specific image file you wanna use 🎀
• -D, --image-dir DirectoryName — point at a specific directory instead of the default one, for locating image files 🗂️
• -f, --force — force the image update. no questions, we're doing this 🔥
• --no_fw_ctrl — don't use FW Ctrl update 🚫
• -y, --yes — the answer is yes at prompts. consent given in advance, love that for us 💖
• --no — the answer is no at prompts. respectfully declining 🫶
• --clear-semaphore — force clear the flash semaphore on the device. no command is allowed when this flag is used. NOTE: this may result in system instability or flash corruption if the device or another application is currently using the flash. exercise caution ⚠️ like, genuinely, be careful, this is the one that can ruin your whole day 💀
• --exe-rel-path — use paths relative to the location of the executable 📍
• -l, --list-content — list file/directory content. used together with the --image-dir and --image-file flags 📋
• --archive-names — display archive names in the listing 🗃️
• --nofs — burn image in a non failsafe manner 😬 (yes, that's the actual description, proceed with the knowledge that "non failsafe" is right there in the name)
• --log — create a log file 📝
• -L, --log-file LogFileName — use the log file you specify 🖊️
• --no-progress — do not show progress. no bar, no drama, just vibes 🤫
• -o, --outfile OutputFileName — write to the output file you specify 📤
• --online — fetch the required FW images online from the Mellanox server 🌐
• --online-query-psid PSIDs — query FW info, with PSID(s) separated by commas 🧾
• --key key — the key for custom download/update 🔑
• --download DirectoryName — download files from the server into a directory you specify 📥
• --download-default — use default values for the download. we love a preset 🎁
• --get-download-opt OPT — get download options for OS or Device. the options are: OS, Device 🔎
• --download-device Device — use the --get-download-opt Device option to view the available devices for device-specific downloads 📱
• --download-os OS — only for self_extractor download: use the --get-download-opt OS option to view the available OS for sfx download 💻
• --download-type Type — MFA | self_extractor — default is All 📦
• --ssl-certificate Certificate — SSL certificate, for a secure connection 🔒

---

🧚 EXAMPLES 🧚

okay now the part everyone actually scrolls to, the receipts 💅

1. query a specific device, or all devices if no device was supplied >> mstfwmanager [-d <device>] [--query]
2. burn a device with a specific image / MFA / images directory >> mstfwmanager -d <device> [-i <image file/MFA file> | -D <images dir>]
3. update the card's firmware >> mstfwmanager -u
4. update the card's firmware from the latest version on the web >> mstfwmanager --online -u
5. download the latest FW package from the web >> mstfwmanager --download-default --download-os Linux_x64 --download-type self_extractor

---

🌟 SEE ALSO 🌟

• mstflint(1) — her sister, go say hi 🫶

---

and that's the whole page bestie, you ate it, no crumbs left 🎀 this lil manual is from the mstflint source, March 2020 vintage — yeah she's a lil retro but she still slays, periodt ✨💖🦋