IUSER(8)

🎀 NAME 🎀

hey bestie, welcome to the IUSER(8) page from the System Manager's Manual 💖 the star of the show is ipmiutil_user, and what it does is handle user functions. that's the whole vibe, no cap.

---

✨ SYNOPSIS ✨

ipmiutil user [-cmsx -NUPREFTVY] <function>

---

🦋 DESCRIPTION 🦋

so this ipmiutil user subcommand handles IPMI LAN user functions separately, like it's got its own little lane and it's thriving in it. 🫶

and lowkey you don't have to come through this door — these same functions can also be handled from ipmiutil lan -q, -u, -p, -v. options, bestie, we love options. 💅

as for how this utility talks to your box, it can use any of these:

• the /dev/ipmi0 driver from OpenIPMI
• the /dev/imb driver from Intel
• the /dev/ipmikcs driver from valinux
• direct user-space IOs
• or the IPMI LAN interface, if you pass -N

---

🌈 OPTIONS 🌈

command line options, explained below, let's goooo ✨

• -c — canonical, delimited output format. clean, structured, iconic. 🎀
• -m 002000 — target a specific MC (like, bus 00, sa 20, lun 00). this could be used for PICMG or ATCA blade systems. the trailing character, if there is one, tells you the addressing: SMI addressing if it's s, or IPMB addressing if it's i or if there's nothing there at all. 👑
• -s — when you're getting info, also get the DCMI sensor information. more data, more better. 🍓
• -x — causes extra debug messages to be displayed. the "not me leaking everything to the terminal" option fr fr. 💀
• -N nodename — nodename or IP address of the remote target system. if you give a nodename, the IPMI LAN interface gets used. otherwise, the local system management interface is the one. 🌸
• -U rmt_user — remote username for the nodename you gave. the default is a null username. 🙈
• -P/-R rmt_pswd — remote password for the nodename you gave. the default is a null password. 🔐
• -E — use the remote password from the Environment variable IPMI_PASSWORD. keep your secrets in the environment, bestie, very main character. 💜
• -F drv_t — force the driver type to one of the following: imb, va, open, gnu, landesk, lan, lan2, lan2i, kcs, smb. note that lan2i means lan2 with intelplus. the default is to detect any available driver type and use it. ✨
• -J — use the specified LanPlus cipher suite (0 thru 17): 0=none/none/none, 1=sha1/none/none, 2=sha1/sha1/none, 3=sha1/sha1/cbc128, 4=sha1/sha1/xrc4_128, 5=sha1/sha1/xrc4_40, 6=md5/none/none, ... 14=md5/md5/xrc4_40. default is 3. 🔥
• -T — use a specified IPMI LAN Authentication Type: 0=None, 1=MD2, 2=MD5, 4=Straight Password, 5=OEM. 🦋
• -V — use a specified IPMI LAN privilege level. 1=Callback level, 2=User level, 3=Operator level, 4=Administrator level (default), 5=OEM level. 👑
• -Y — yes, do prompt the user for the IPMI LAN remote password. the alternatives for the password are -E or -P. 🫶

---

💫 FUNCTIONS 💫

• list [channel] — list the IPMI LAN users with enabled status, privilege level, and username. you can optionally specify a channel number. the receipts, basically. 🧾
• enable <user_num> [channel] — enable the specified user number, and optionally specify an IPMI LAN channel number. welcome back bestie 💖
• disable <user_num>] — disable the specified user number, so that it has 'No access'. (yep, the stray ] is right there in the original, i'm just the messenger 💀)
• set <user_num> name <username> — set the username for a specified user number. ✨
• set <user_num> password <password> — set the password for a specified user number. 🔐
• set <user_num> priv <priv_level> [channel] — set the privilege level for a specified user number, where the privilege level is 4=Admin, 3=Operator, 2=User. also optionally specify a channel number. 👑
• help — show the help (usage) message. when in doubt, ask for help, no shame. 🌸

---

🌟 EXAMPLES 🌟

ipmiutil user set 2 name user2

sets the username for user 2 to "user2". ate, and left no crumbs. 💅

---

👀 SEE ALSO 👀

ipmiutil(8) ialarms(8) iconfig(8) idiscover(8) ievents(8) ifru(8) igetevent(8) ihealth(8) ilan(8) ireset(8) isel(8) isensor(8) iserial(8) isol(8) iwdt(8)

the whole friend group, honestly. 🫶

---

⚠️ WARNINGS ⚠️

see http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil and any bug fix list. go look, bestie, it's giving responsible user energy. 🔍

---

©️ COPYRIGHT ©️

Copyright (C) 2017 Andy Cress

see the file COPYING in the distribution for more details regarding redistribution. 📄

this utility is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY. fr fr, no promises, read the fine print. 😭

---

💜 AUTHOR 💜

Andy Cress <arcress at users.sourceforge.net>

---

okay that's the whole page, thank you for coming to my ted talk 🎀 and just so you have the receipts: this was Version 1.0: 23 Feb 2017, filed under IUSER(8), and you absolutely slayed for reading all the way down. mwah 💖✨🦋