github.com/system-transparency/u-root@v6.0.1-0.20190919065413-ed07a650de4c+incompatible/pkg/smbios/table.go

// Copyright 2016-2019 the u-root Authors. All rights reserved
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

package smbios

import (
	"bytes"
	"encoding/binary"
	"errors"
	"fmt"
	"strings"
)

// Table is a generic type of table that does not parsed fields,
// it only allows access to its contents by offset.
type Table struct {
	Header
	data    []byte   `smbios:"-"` // Structured part of the table.
	strings []string `smbios:"-"` // Strings section.
}

var (
	// ErrTableNotFound is retuned if table with specified type is not found.
	ErrTableNotFound = errors.New("table not found")

	// ErrUnsupportedTableType is returned by ParseTypedTable if this table type is not supported and cannot be parsed.
	ErrUnsupportedTableType = errors.New("unsupported table type")

	errEndOfTable = errors.New("end of table")
)

// Len returns length of the structured part of the table.
func (t *Table) Len() int {
	return len(t.data)
}

// GetByteAt returns a byte from the structured part at the specified offset.
func (t *Table) GetByteAt(offset int) (uint8, error) {
	if offset > len(t.data)-1 {
		return 0, fmt.Errorf("invalid offset %d", offset)
	}
	return t.data[offset], nil
}

// GetBytesAt returns a number of bytes from the structured part at the specified offset.
func (t *Table) GetBytesAt(offset, length int) ([]byte, error) {
	if offset > len(t.data)-length {
		return nil, fmt.Errorf("invalid offset %d", offset)
	}
	return t.data[offset : offset+length], nil
}

// GetWordAt returns a 16-bit word from the structured part at the specified offset.
func (t *Table) GetWordAt(offset int) (res uint16, err error) {
	if offset > len(t.data)-2 {
		return 0, fmt.Errorf("invalid offset %d", offset)
	}
	err = binary.Read(bytes.NewReader(t.data[offset:offset+2]), binary.LittleEndian, &res)
	return res, err
}

// GetDWordAt returns a 32-bit word from the structured part at the specified offset.
func (t *Table) GetDWordAt(offset int) (res uint32, err error) {
	if offset > len(t.data)-4 {
		return 0, fmt.Errorf("invalid offset %d", offset)
	}
	err = binary.Read(bytes.NewReader(t.data[offset:offset+4]), binary.LittleEndian, &res)
	return res, err
}

// GetQWordAt returns a 64-bit word from the structured part at the specified offset.
func (t *Table) GetQWordAt(offset int) (res uint64, err error) {
	if offset > len(t.data)-8 {
		return 0, fmt.Errorf("invalid offset %d", offset)
	}
	err = binary.Read(bytes.NewReader(t.data[offset:offset+8]), binary.LittleEndian, &res)
	return res, err
}

// GetStringAt returns a string pointed to by the byte at the specified offset in the structured part.
// NB: offset is not the string index.
func (t *Table) GetStringAt(offset int) (string, error) {
	if offset >= len(t.data) {
		return "", fmt.Errorf("invalid offset %d", offset)
	}
	stringIndex := t.data[offset]
	switch {
	case stringIndex == 0:
		return "", nil
	case int(stringIndex) <= len(t.strings):
		return t.strings[stringIndex-1], nil
	default:
		return "", fmt.Errorf("invalid string index %d", stringIndex)
	}
}

func (t *Table) String() string {
	lines := []string{
		t.Header.String(),
		"\tHeader and Data:",
	}
	data := t.data
	for len(data) > 0 {
		ld := data
		if len(ld) > 16 {
			ld = ld[:16]
		}
		ls := make([]string, len(ld))
		for i, d := range ld {
			ls[i] = fmt.Sprintf("%02X", d)
		}
		lines = append(lines, "\t\t"+strings.Join(ls, " "))
		data = data[len(ld):]
	}
	if len(t.strings) > 0 {
		lines = append(lines, "\tStrings:")
		for _, s := range t.strings {
			lines = append(lines, "\t\t"+s)
		}
	}
	return strings.Join(lines, "\n")
}

// ParseTable parses a table from byte stream.
// Returns the parsed table and remaining data.
func ParseTable(data []byte) (*Table, []byte, error) {
	var err error
	var h Header
	if err = h.Parse(data); err != nil {
		return nil, data, err
	}
	if len(data) < int(h.Length)+2 /* string terminator length */ {
		return nil, data, errors.New("data too short")
	}
	structData := data[:h.Length]
	data = data[h.Length:]
	var strings []string
	for len(data) > 0 && err == nil {
		end := bytes.IndexByte(data, 0)
		if end < 0 {
			return nil, data, errors.New("unterminated string")
		}
		s := string(data[:end])
		data = data[end+1:]
		if len(s) > 0 {
			strings = append(strings, s)
		}
		if end == 0 { // End of strings
			if len(strings) == 0 {
				// There's an extra 0 at the end.
				data = data[1:]
			}
			break
		}
	}
	if h.Type == TableTypeEndOfTable {
		err = errEndOfTable
	}
	return &Table{Header: h, data: structData, strings: strings}, data, err
}