feat: implement SOL (Serial Over LAN) payload functionality

- Added SOL payload request and response types to support SOL communication.
- Introduced SOLActivate method for activating SOL payload sessions.
- Enhanced UDP client with ExchangeUntilMatch for filtering responses.

Author: bougou

.gitignore

@@ -44,3 +44,4 @@ cmd/goipmi/goipmi
 
 # asdf
 .tool-versions
+goipmi

README.md

@@ -328,6 +328,7 @@ The implementation logic of IPMI commands is largely consistent. See [Contributi
 | GetUserCallbackOptions     |                    |                              |
 | SetSerialRoutingMux        |                    |                              |
 | SOLActivating              | :white_check_mark: |                              |
+| SOLActivate (\*)           | :white_check_mark: | sol activate                 |
 | SetSOLConfigParam          | :white_check_mark: |                              |
 | SetSOLConfigParamFor (\*)  | :white_check_mark: |                              |
 | GetSOLConfigParam          | :white_check_mark: |                              |

client.go

@@ -265,6 +265,12 @@ func (c *Client) Close(ctx context.Context) error {
 }
 
 func (c *Client) Exchange(ctx context.Context, request Request, response Response) error {
+	if c.Interface != InterfaceLanplus {
+		if _, ok := request.(*SOLPayloadRequest); ok {
+			return fmt.Errorf("SOL payload exchange requires lanplus interface")
+		}
+	}
+
 	switch c.Interface {
 	case "", InterfaceOpen:
 		return c.exchangeOpen(ctx, request, response)

cmd/goipmi/commands/sol.go

@@ -3,7 +3,9 @@ package commands
 import (
 	"context"
 	"fmt"
+	"os"
 
+	"github.com/bougou/go-ipmi"
 	"github.com/spf13/cobra"
 )
 
@@ -21,6 +23,7 @@ func NewCmdSOL() *cobra.Command {
 		},
 	}
 	cmd.AddCommand(NewCmdSOLInfo())
+	cmd.AddCommand(NewCmdSOLActivate())
 
 	return cmd
 }
@@ -40,3 +43,40 @@ func NewCmdSOLInfo() *cobra.Command {
 	}
 	return cmd
 }
+
+func NewCmdSOLActivate() *cobra.Command {
+	usage := `
+	activate [<payload instance>]
+	`
+
+	cmd := &cobra.Command{
+		Use:   "activate",
+		Short: "activate SOL payload",
+		Run: func(cmd *cobra.Command, args []string) {
+			payloadInstance := uint8(1)
+			if len(args) >= 1 {
+				id, err := parseStringToInt64(args[0])
+				if err != nil {
+					CheckErr(fmt.Errorf("invalid payload instance, err: %w", err))
+				}
+				if id < 0 || id > 0x3f {
+					CheckErr(fmt.Errorf("invalid payload instance, usage: %s", usage))
+				}
+				payloadInstance = uint8(id)
+			}
+
+			ctx := context.Background()
+			var opts *ipmi.SOLActivateOptions
+			if payloadInstance != 1 {
+				opts = &ipmi.SOLActivateOptions{
+					PayloadInstance: payloadInstance,
+				}
+			}
+
+			if err := client.SOLActivate(ctx, os.Stdin, os.Stdout, opts); err != nil {
+				CheckErr(err)
+			}
+		},
+	}
+	return cmd
+}

cmd_activate_session.go

@@ -149,6 +149,11 @@ func (c *Client) ActivateSession(ctx context.Context) (response *ActivateSession
 	// Todo, validate the SessionID
 	c.session.v15.sessionID = response.SessionID
 
+	// Authentication type for the remainder of the session (response data[0]). When per-message
+	// authentication is disabled, BMCs typically return NONE here even though challenge/activate
+	// used MD5; subsequent RMCP session headers must match this (see ipmitool with Per-msg auth off).
+	c.session.authType = response.AuthType
+
 	// The remote console must increment the inbound session sequence number
 	// by one (1) for each subsequent message it sends to the BMC
 	c.session.v15.inSeq = response.InitialInboundSequenceNumber