pciids

README

PCIIDs

Lookup vendor and device names using PCI IDs!

CLI

The CLI expects either two or four PCI IDs to look up a device:

$ pciids 1d0f efa1
1d0f:efa1           - Amazon.com, Inc. Elastic Fabric Adapter (EFA)
$ pciids 10de 2206 10de 1467
10de:2206 10de:1467 - NVIDIA Corporation GA102 [GeForce RTX 3080]

If there are multiple matches all will matches will be listed.

JSON output

The command can take the --json flag to produce JSON output:

$ pciids 121a 0009 121a 0009 --json
[
    {
        "vendorID": "121a",
        "deviceID": "0009",
        "vendorName": "3Dfx Interactive, Inc.",
        "deviceName": "Voodoo 4 / Voodoo 5",
        "subVendorID": "121a",
        "subDeviceID": "0009",
        "subVendorName": "3Dfx Interactive, Inc.",
        "subDeviceName": "Voodoo5 AGP 5500/6000"
    }
]

Debug output

The --debug flag to produce additional output while running:

$ pciids --json 121a 0009 121a 0009
DEBU Looking up 121a:0009 121a:0009
DEBU Downloading https://raw.githubusercontent.com/pciutils/pciids/master/pci.ids
DEBU 200 OK
DEBU Parsing vendor IDs
DEBU Parsing PCI IDs
DEBU Found 1 results
121a:0009 121a:0009 - 3Dfx Interactive, Inc. Voodoo5 AGP 5500/6000

Install

Below outlines the various ways to obtain and install pciids.

From binary

Download the latest release of pciids for your platform and extract the tarball:

wget pciids<version>_<os>_<arch>.tar.gz
tar zxvf pciids<version>_<os>_<arch>.tar.gz

The tarball will extract the readme, license, and the pre-compiled binary.

From source

To build and install directly from source run:

git clone https://github.com/powersj/pciids
cd pciids
make

The default make command will run go build and produce a binary in the root directory.

From go

To download using the go get command run:

go get github.com/powersj/pciids

The executable object file location will exist at ${GOPATH}/bin/pciids

API usage

Users can take advantage of the query functions in their own code:

package main

import (
  "fmt"

  "github.com/powersj/pciids"
)

func main() {
  ids, err := pciids.Query.Device("10de", "1467")
  if err != nil {
    fmt.Printf("Error getting device info: %v", err)
  }

  for _, id := range ids {
      fmt.Printf(id.String())
  }
}

Documentation

Index

• Variables
• type PCIID

Variables

var All = query.All

All returns all PCI IDs.

var LatestFile = file.Latest

LatestFile returns the latest PCI IDs database file.

var Parse = ids.Parse

Parse will parse a PCI IDs file.

var QueryDevice = query.Device

QueryDevice will query using a specific PCI ID device pair.

var QuerySubDevice = query.SubDevice

QuerySubDevice will query using a specific PCI ID device and subdevice pair.

Types

type PCIID

type PCIID = ids.PCIID

PCIID type.