Ipmidetect(8)

πŸ’… IPMIDETECT(8) β€” like, the ipmidetect manual, bestie

okay so real quick: this is the man page for ipmidetect, and it lives in section 8 of the manual (the big-girl system-admin section, yes ma'am πŸ‘‘). Let's get into it.


✨ NAME ✨

ipmidetect β€” lists which IPMI interfaces in your cluster got detected and/or undetected. That's the whole vibe check. πŸ”


🌸 SYNOPSIS 🌸

ipmidetect [OPTION...] [NODES...]

πŸ¦‹ DESCRIPTION πŸ¦‹

ipmidetect tells you which IPMI nodes in a cluster have been detected and which haven't. Where does that tea come from? The libipmidetect(3) library and the ipmidetectd(8) daemon, periodt.

So here's how it works: ipmidetect prints out the status of every IPMI node that's been configured with ipmidetectd(8) β€” unless you name specific ones on the command line, in which case it only cares about those.

Oh and a fun little detail πŸ‘€ β€” if the first node you list is -, then nodes get read in from standard input instead. Very iykyk.

You can list nodes in hostrange format, comma separated lists, or space separated lists. The whole hostrange thing has its own section down below (it's giving main character energy, honestly), so scroll for that. Important though: the hostnames you list must be the shortened names of hostnames. Like, the short ones. Don't come in here with the long ones. 🚫


πŸŽ€ OPTIONS πŸŽ€

  • -h STRING, --hostname=STRING β€” the server hostname. default is localhost (yes, it's always localhost, we love a homebody πŸ’–)
  • -p INT, --port=INT β€” the server port. default is 9225
  • -d, --detected β€” only list the nodes that got detected
  • -u, --undetected β€” only list the nodes that did not get detected (they're not like the other nodes 😭)
  • -q, --hostrange β€” list nodes in hostrange format. this is the default, so if you don't pick anything, this is what you get
  • -c, --comma β€” list nodes comma separated
  • -n, --newline β€” list nodes newline separated
  • -s, --space β€” list nodes space separated
  • -V, --version β€” print the version and dip out. bye bestie πŸ‘‹

🌈 HOSTRANGED SUPPORT 🌈

okay so you can feed in multiple hosts two ways:

  1. as an explicit comma separated list of hosts, or
  2. as a range of hostnames in the general form:
prefix[n-m,l-k,...]

where n < m and l < k, etc. πŸ“

⚠️ Do not confuse this range form with regular expression character classes (which are also written with []). Genuinely not the same thing, bestie, don't do it. For example, foo[19] does not mean foo1 or foo9 β€” it represents a degenerate range: foo19. Like, it's just foo19. That's it. 😭

This range syntax is purely a convenience thing for clusters that use the prefixNN naming convention. You should not consider specifying ranges necessary β€” the list foo1,foo9 could be written exactly like that, or as the range foo[1,9]. Both are valid. Slay either way. ✨

Some examples of range usage, since examples ate:

foo[01-05] instead of foo01,foo02,foo03,foo04,foo05
foo[7,9-10] instead of foo7,foo9,foo10
foo[0-3] instead of foo0,foo1,foo2,foo3
🐚 Friendly reminder: some shells will interpret brackets ([ and ]) for pattern matching. Depending on your shell, you may need to enclose ranged lists within quotes. Don't get got by your own shell, bestie. πŸ’€

πŸ’€ DIAGNOSTICS πŸ’€

The exit value of ipmidetect depends on which options you performed on the command line. Let's break it down, because this is highkey the part people get wrong πŸ™ˆ

  • If the default output is used, the exit value will be 0 if the command succeeds without error. easy 🫢
  • If the --detected option is used and no undetected nodes have been discovered, the exit value will be 0.
  • If undetected nodes are found, the exit value will be 1.
  • If the --undetected option is used and no detected nodes have been discovered, the exit value will be 0.
  • If detected nodes are found, the exit value will be 1.
  • On errors, the exit value will be 2. 😭 (on errors it's always 2)

πŸ”₯ REPORTING BUGS πŸ”₯

Found a bug? Report it to <freeipmi-users@gnu.org> or <freeipmi-devel@gnu.org>. They want to know, fr fr. πŸ›


Copyright (C) 2007-2015 Lawrence Livermore National Security, LLC. Copyright (C) 2007 The Regents of the University of California.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.


πŸ’œ SEE ALSO πŸ’œ

libipmidetect(3), ipmidetect.conf(5), ipmidetectd(8)

http://www.gnu.org/software/freeipmi/


aaaand that's the page, bestie! πŸŽ€ This lil masterpiece is Ipmidetect 1.6.20, dated 2026-10-05 β€” go forth and detect those interfaces, you absolute icon πŸ’…βœ¨

πŸ“¦ where this page comes from