Set Channel Access
更新时间: 2026/08/06
在Gitcode上查看源码

Set Channel Access

Change History

openUBMC VersionRevision DateDescription
25.062025/06/26Initial draft: add command details

Basic Information

Function Description

Set channel access.

Privilege

UserMgnt

Command Information

Request Information

ByteData Field
NetFnApp 06h
CMD40h
1[7:4]-reserved
[3:0]-Channel number
2[7:6]-00b=don't set or change Channel Access
01b=set non-volatile Channel Access according to bits [5:0]
10b=set volatile (active) setting of Channel Access according to bits
[5:0]
11b=reserved
[5]-PEF Alerting Enable/Disable
0b=enable PEF Alerting
1b=disable PEF Alerting on this channel (the Alert Immediate command can still be used to generate alerts)
[4]-0b=enable Per-message Authentication
1b=disable Per-message Authentication. [Authentication required to activate any session on this channel, but authentication not used on subsequent packets for the session.]
[3]-User Level Authentication Enable/Disable
Optional. Return a CCh 'invalid data field' error completion code if an attempt is made to set this bit, but the option is not supported.
0b=enable User Level Authentication. All User Level commands are to be authenticated per the Authentication Type that was negotiated when the session was activated
1b=disable User Level Authentication. Allow User Level commands to be executed without being authenticated
If the option to disable User Level Command authentication is accepted, the BMC will accept packets with Authentication Type set to None if they contain user level commands
For outgoing packets, the BMC returns responses with the same Authentication Type that was used for the request
[2:0]-Access Mode for IPMI messaging (PEF Alerting is enabled/disabled separately from IPMI messaging, see bit 5)
000b=disabled
channel disabled for IPMI messaging
001b=pre-boot only
channel only available when system is in a powered down state or in BIOS prior to start of boot
010b=always available channel always available for communication regardless of system mode. BIOS typically dedicates the serial connection to the BMC
011b=shared same as always available, but BIOS typically leaves the serial port available for software use
3Channel Privilege Level Limit. This value sets the maximum privilege level that can be accepted on the specified channel
[7:6]-00b=don't set or change channel Privilege Level Limit
01b=set non-volatile Privilege Level Limit according to bits [3:0]
10b=set volatile setting of Privilege Level Limit according to bits [3:0]
11b=reserved
[5:4]-reserved
[3:0]-Channel Privilege Level Limit
0h=reserved
1h=CALLBACK level
2h=USER level
3h=OPERATOR level
4h=ADMINISTRATOR level
5h=OEM Proprietary level

Response Information

ByteData Field
1Completion Code
generic, plus following command-specific completion codes:
82h=set not supported on selected channel (e.g. channel is sessionless)
83h=access mode not supported

Command Example

Set channel access.

Request:

bash
ipmicmd -k "0f 00 06 40 01 80 22" smi 0

Response:

text
0f 07 00 40 82

Back to Index