💻 🔍 go library parsing linux pci information from sysfs

go golang hacktoberfest hwinfo library linux pci sysfs

Go 99.6%
Makefile 0.4%

Find a file

Michael Hertig 4f6d3c3043 Merge pull request #3 from hertg/funding update readme, add funding.yml		2022年10月10日 18:56:54 +00:00
.github/workflows	initial commit	2022年07月31日 01:43:23 +02:00
pkg	change pci domain to be 32bit, closes #1	2022年09月24日 19:30:48 +02:00
FUNDING.yml	update readme, add funding.yml	2022年10月10日 20:51:41 +02:00
go.mod	run go mod tidy	2022年09月24日 19:32:27 +02:00
go.sum	run go mod tidy	2022年09月24日 19:32:27 +02:00
LICENSE	add mit license	2022年08月10日 22:31:54 +02:00
Makefile	parse more info, add addr methods, update tests	2022年08月03日 00:45:47 +02:00
pci.ids	implement pciids parser	2022年08月01日 02:38:21 +02:00
README.md	update readme	2022年10月10日 20:54:32 +02:00

README.md

gopci

A minimal and fast library to parse pci device info from sysfs.

Go Report Card License Information

Description

This library provides methods to get PCI information on a linux system. It has been created as a minimalistic and more performant alternative to the pci parsing capabilities of jaypipes/ghw.

If you need non-pci or non-linux hardware information, ghw offers an all-in-one solution. If you simply care about linux pci information, this library offers a significant performance benefit over ghw (see comparison).

Usage

Install

go get github.com/hertg/gopci

Scan

devices,_:=pci.Scan()for_,device:=rangedevices{// ...}

The Device struct contains information like Vendor, Device, Class, Subvendor, Subdevice, etc. More detailed information is made available in the Config field which contains the raw parsed PCI config header.

If more information from sysfs shall be processed, the SysfsPath() method can be used to get a direct link to the PCI devices sysfs path which can be used for further custom information gathering.

Filter

The Scan() method allows optional Filter arguments to only include matching devices in the resulting list of devices.

classFilter:=func(d*pci.Device)bool{returnd.Class.Class==0x03}devices,_:=pci.Scan(classFilter)

Comparison

Device configuration is parsed directly as bytes (from config) instead of reading strings and parsing from there. This prevents unnecessary string allocationis and significantly improves performance.

It has been found that this library parses at more than 10x the speed while using 50x less memory compared to jaypipes/ghw.

goos: linux
goarch: amd64
pkg: github.com/hertg/gopci/pkg/pci
cpu: AMD Ryzen 9 5950X 16-Core Processor
BenchmarkGoPci
BenchmarkGoPci-32 518 2554827 ns/op 297709 B/op 5178 allocs/op
BenchmarkGhw
BenchmarkGhw-32 34 33286659 ns/op 15745188 B/op 201189 allocs/op
PASS
ok github.com/hertg/gopci/pkg/pci 2.802s