- Prev
- AppStream
- Next

## ⁠2.12. Driver

### ⁠2.12.1. Introduction

The `driver` component type describes drivers for hardware devices as well as other Linux kernel drivers for e.g. virtualization support. It usually `provides` one or multiple modaliases.
Drivers can ship one or more files in `/usr/share/metainfo/%{id}.metainfo.xml`.

### ⁠2.12.2. Example file

A driver metainfo file can look like this:

    ​
    ​<?xml version="1.0" encoding="UTF-8"?>
    ​<component type="driver">
    ​  <id>com.nvidia.GeForce</id>
    ​  <name>NVIDIA GeForce</name>
    ​  <summary>NVIDIA Graphics Driver</summary>
    ​  <description>
    ​    <p>
    ​      The NVIDIA Accelerated Linux Graphics Driver brings accelerated 2D
    ​      functionality and high-performance OpenGL support to Linux x86 with the
    ​      use of NVIDIA graphics processing units.
    ​    </p>
    ​    ...
    ​  </description>
    ​  <url type="homepage">http://www.nvidia.com/Download/index.aspx</url>
    ​  <metadata_license>CC0-1.0</metadata_license>
    ​  <project_license>LicenseRef-proprietary:NVIDIA</project_license>
    ​  <developer_name>NVIDIA Corporation</developer_name>
    ​
    ​  <provides>
    ​    <modalias>pci:v000010DEd*sv*sd*bc03sc00i00*</modalias>
    ​    ...
    ​  </provides>
    ​</component>

### ⁠2.12.3. File specification

Note that the XML root must have the `type` property set to `driver`. This clearly identifies this metainfo document as describing a driver.

⁠<id/>
  For drivers, the value of the `<id/>` tag must follow the reverse-DNS scheme as described for generic components. It is sometimes useful to suffix the ID with `.driver` to make it more unique.
⁠<provides/> ↪ <modalias/>
  The `provides/modalias` tags contain all the modaliases the described driver supports and allow to automatically offer installation of the described driver on systems where hardware matching the modalias has been detected.
  Using wildcards for modaliases is permitted.
  Example:

      ​<provides>
      ​  <modalias>pci:v000010DEd00001194sv*sd*bc03sc*i*</modalias>
      ​  <modalias>pci:v000010DEd00001199sv*sd*bc03sc*i*</modalias>
      ​</provides>

For a component of type `driver`, the following tags are required and must be present for a valid document: <id/>, <name/>, <summary/>, <metadata_license/>, <provides/> ↪ <modalias/>.

- Prev2.11. Firmware
- Up
- Home
- Next2.13. Localization