IPICMG(8)

πŸ’– IPICMG(8) β€” ipmiutil_picmg πŸ’–

okay bestie, listen up, this is a page from the System Manager's Manual and it's all about ipmiutil picmg β€” the lil subcommand that yeets specific PICMG extended IPMI commands at your firmware. it's giving hardware whisperer. let's go πŸ¦‹


✨ NAME ✨

ipmiutil_picmg β€” send specific PICMG extended IPMI commands


🌸 SYNOPSIS 🌸

ipmiutil picmg [-mixNUPREFJTVY] parameters

πŸ’… DESCRIPTION πŸ’…

So the ipmiutil picmg subcommand sends specific PICMG/ATCA extended IPMI commands to the firmware. that's the whole vibe. no cap.

This utility can use either 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 -N. pick your fighter, they're all valid πŸ’–


πŸ‘‘ OPTIONS πŸ‘‘

Command line options are described below. yes queen, all of them, we're not skipping a single one πŸ™ˆ

  • -i 00 β€” this one specifies a specific FRU ID to show. the input value should be in hex (0b, 1a, etc.), exactly like it shows up from the sensor SDR output. the default FRU ID is zero (0). zero is the main character until you say otherwise πŸ’…
  • -m 002000 β€” show FRU for a specific MC (e.g. bus 00, sa 20, lun 00). this could be used for PICMG or ATCA blade systems, iykyk. the trailing character, if present, indicates SMI addressing if s, or IPMB addressing if i or not present. so like, the last letter is doing a lot of work here 😭
  • -x β€” causes extra debug messages to be displayed. she's nosy and we love her πŸŽ€
  • -N nodename β€” nodename or IP address of the remote target system. if a nodename is specified, IPMI LAN interface is used. otherwise the local system management interface is used. choose your adventure ✨
  • -U rmt_user β€” remote username for the nodename given. the default is a null username. it's giving anonymous but make it on purpose πŸ’€
  • -P/-R rmt_pswd β€” remote password for the nodename given. the default is a null password. again: nothing. iconic of them honestly 🫢
  • -E β€” use the remote password from Environment variable IPMI_PASSWORD. keep it secret, keep it safe 🧚
  • -F drv_t β€” force the driver type to one of the followng: 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. (also yes, "followng" β€” that's the original's spelling, we don't fix, we preserve πŸ’…)
  • -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. the ... is doing so much heavy lifting bestie, that's literally what it says 😭
  • -T β€” use a specified IPMI LAN Authentication Type: 0=None, 1=MD2, 2=MD5, 4=Straight Password, 5=OEM. (note: 3 is simply not invited to this party πŸŽ‰)
  • -V β€” use a specified IPMI LAN privilege level. 1=Callback level, 2=User level, 3=Operator level, 4=Administrator level (default), 5=OEM level. she runs admin by default because obviously πŸ’…
  • -Y β€” Yes, do prompt the user for the IPMI LAN remote password. Alternatives for the password are -E or -P. consent-based password acquisition, we stan 🌈

🌟 PARAMETERS 🌟

picmg parameters 🫧

  • properties β€” Get PICMG properties may be used to obtain and print Extension major version information, PICMG identifier, FRU Device ID and Max FRU Device ID. the whole lil ID card of your FRU bestie πŸ’–
  • addrinfo β€” Get address information. This command may return information on the Hardware address, IPMB-0 Address, FRU ID, Site/Entity ID, and Site/Entity Type. it's giving contact info πŸŽ€
  • frucontrol fru id options β€” Set various control options:
    • 0x00 β€” Cold Reset
    • 0x01 β€” Warm Reset
    • 0x02 β€” Graceful Reboot
    • 0x03 β€” Issue Diagnostic Interrupt
    • 0x04 β€” Quiesce [AMC only]
    • 0x05-0xFF β€” Cold Reset
  • activate fru id β€” Activate the specified FRU. wake up bestie ✨
  • deactivate fru id β€” Deactivate the specified FRU. nap time 😴
  • policy get fru id β€” Get FRU activation policy.
  • policy set fru id lockmask lock β€” Set FRU activation policy. lockmask is 1 or 0 to indicate action on the deactivation or activation locked bit respectively. lock is 1 or 0 to set/clear locked bit. two tiny numbers, so much power fr fr πŸ”₯
  • portstate set|getall|getgranted|getdenied parameters β€” Get or set various port states. See usage for parameter details. (yes, "see usage" β€” that's the actual instruction, we're not making stuff up 🫢)

πŸ”₯ EXAMPLES πŸ”₯

ipmiutil picmg properties

Gets PICMG properties from the default target address (slave address 0x20).

ipmiutil picmg -N 192.168.1.1 -U root -P pswd addrinfo

Gets PICMG Address Information from the specified IP address.

look at her go, absolute queen behavior πŸ‘‘


πŸ¦‹ 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 showed up to the function πŸ’œ


😭 WARNINGS 😭

See http://ipmiutil.sourceforge.net/ for the latest version of ipmiutil and any bug fix list. go check it, bestie, it's the source of truth ✨


Copyright (C) 2010 Kontron America, Inc.

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. read that again. no warranty. none. don't come for her πŸ’€


πŸŽ€ AUTHOR πŸŽ€

Andy Cress <arcress at users.sourceforge.net>


and that's the page!! Version 1.0, dated 04 Jun 2010, from the ipmiutil source, filed under the System Manager's Manual as IPICMG(8). mwah, go send some PICMG commands responsibly πŸ’–βœ¨πŸ¦‹