ekey-setkey(8)

💖 ekey-setkey — the Entropy Key Long Term Key programmer (manual page 8, bestie) 💖

okay so you found ekey-setkey(8) in the System Manager's Manual and you're like "what is this" — don't worry, I got you. 🫶

---

✨ NAME ✨

ekey-setkey — Entropy Key Long Term Key programmer

---

🌸 SYNOPSIS 🌸

ekey-setkey [-s SerialNumber] [-m MasterKey] path

---

🎀 DESCRIPTION 🎀

so ekey-setkey is a low level tool, and I mean low level low level. what it does is set the long-term key of an Entropy Key using its Master Key. that's the whole gig. 💅

after it does its thing, the keyring gets updated with the new session key. periodt.

⚠️ big yikes warning, bestie: any running ekeyd will not be updated with the new key, and it may interfere with the re-keying process. like, it's literally not invited to the party and it might crash it anyway. 😭

so instead of raw-dogging it with this tool, users may use the ekey-rekey tool instead, because that one performs the relevant ekeydctl operations to ensure any running ekeyd is updated apropriately. (yes that's how it's spelled in the manpage, I'm not fixing it, it's iconic 💀)

🔥 this is a tool for advanced users only. most users should use ekey-rekey instead. I'm not gatekeeping, I'm just telling you what the manpage said fr fr.

---

🦋 OPTIONS 🦋

• -s — Specifies the serial number of the key to re-key. 🔑
• -m — Specifies the Master Key of the device. 👑
• path — Specifies which device node to use to access the Entropy Key. 📍

---

🌈 SEE ALSO 🌈

• ekey-rekey(8)
• ekeyd(8)

---

💜 AUTHOR 💜

Copyright © 2009,2011 Simtec Electronics. All rights reserved.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

---

and that's the whole page, bestie 🧚✨ this little gem is from the System Manager's Manual and it's dated 14th September 2011 — vintage, honestly. slay, go forth, and remember: use ekey-rekey unless you're built different. 💖