# yum-packaging-libnvidia-nscq

**Repository Path**: mirrors_NVIDIA/yum-packaging-libnvidia-nscq

## Basic Information

- **Project Name**: yum-packaging-libnvidia-nscq
- **Description**: NSCQ packaging for RHEL
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-03-13
- **Last Updated**: 2026-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# yum packaging libnvidia nscq

[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://opensource.org/licenses/MIT-license)
[![Contributing](https://img.shields.io/badge/Contributing-Developer%20Certificate%20of%20Origin-violet)](https://developercertificate.org)

## Overview

Packaging templates for `yum`, `dnf`, and `zypper` based Linux distros to build libnvidia-nscq packages.

NVIDIA NVSwitch Configuration and Query (NSCQ) library provides a stable driver API used by [DCGM](https://github.com/NVIDIA/DCGM) for monitoring NVSwitch devices.

> _note:_ the version of libnvidia-nscq must match the NVIDIA driver installed.

## Table of Contents

- [Overview](#Overview)
- [Deliverables](#Deliverables)
- [Installation](#Installation)
- [Prerequisites](#Prerequisites)
  * [Clone this git repository](#Clone-this-git-repository)
  * [Install build dependencies](#Install-build-dependencies)
- [Building Manually](#Building-Manually)
- [Related](#Related)
  * [Fabric Manager](#Fabric-Manager)
  * [NVIDIA driver](#NVIDIA-driver)
- [See also](#See-also)
  * [Debian](#Debian)
- [Contributing](#Contributing)


## Deliverables

This repo contains the `.spec` file used to build the following **RPM** packages:


> _note:_ `XXX` is the first `.` delimited field in the driver version, ex: `525` in `525.85.12`

```shell
- libnvidia-nscq-XXX
> ex: libnvidia-nscq-525-525.85.12-1.x86_64.rpm
```


## Installation

* **RHEL8**, **RHEL9**, or **Fedora** streams: `XXX`, `XXX-dkms`, `latest`, and `latest-dkms`

  The NvSwitch modularity profile (`fm`) installs all of the NVIDIA driver packages, as well as Fabric Manager and NCSQ

  ```shell
  dnf module install nvidia-driver:${stream}/fm
  ```

* **RHEL7**

  ```shell
  yum install libnvidia-nscq-XXX
  ```

* **openSUSE15** or **SLES15**

  ```shell
  zypper install libnvidia-nscq-XXX
  ```


## Prerequisites

### Clone this git repository:

Supported branches as described in the [NVIDIA Datacenter Drivers](https://docs.nvidia.com/datacenter/tesla/drivers/index.html#cuda-drivers) documentation.

```shell
git clone https://github.com/NVIDIA/yum-packaging-libnvidia-nscq
```

### Download a NSCQ tarball:

* https://developer.download.nvidia.com/compute/nvidia-driver/redist/libnvidia_nscq/

  *ex:* libnvidia_nscq-linux-x86_64-525.85.12-archive.tar.xz

### Install build dependencies
> *note:* these are only needed for building not installation

```shell
# objdump
yum install binutils
# Packaging
yum install rpm-build
```


## Building Manually

### Download tarball via redistrib JSON
```shell
baseURL="https://developer.download.nvidia.com/compute/nvidia-driver/redist"
downloadURL=$(curl -s $baseURL/redistrib_525.85.12.json | \
jq -r '."libnvidia_nscq" | ."linux-x86_64" | ."relative_path"' | \
sed "s|^|$baseURL/|")
curl -O $downloadURL
```

### Prepare build directory
```shell
cd yum-packaging-libnvidia-nscq
mkdir SPECS SOURCES
cp *.spec SPECS/
cp ../libnvidia_nscq*.tar.xz SOURCES/
```

### Check API version
```shell
tar -tvf SOURCES/libnvidia_nscq*.tar.xz | \
    grep ^l | awk '{print $(NF-2)}' | grep ".so." | \
    sort -uVr | awk -F ".so." '{print $2}' | awk NR==1
> 2.0
```

### Check SONAME
```shell
tar -C SOURCES/ -xf SOURCES/libnvidia_nscq*.tar.xz
objdump -p /dev/stdin < $(find SOURCES -type f -name "libnvidia-nscq.so.*") | \
grep SONAME | awk -F ".so." '{print $2}'
> 2
```

### Generate .rpm packages
```shell
rpmbuild \
    --define "%_topdir $(pwd)" \
    --define "%version 525.85.12" \
    --define "%branch 525" \
    --define "%so_api 2.0" \
    --define "%SONAME 2" \
    --define "%_arch x86_64" \
    --define "%_build_arch x86_64" \
    --define "%_repo_arch x86_64" \
    --target=x86_64 \
    -v -ba SPECS/*.spec

cd RPMS/x86_64
ls *.rpm
```
> _note:_ branch is the first `.` delimited field in the driver version, ex: `525` in `525.85.12`
> _note:_ for arm64/aarch64 set `_build_arch` to `aarch64` and `_repo_arch` to `sbsa`


## Related

### Fabric Manager

- fabricmanager
  * [https://github.com/NVIDIA/yum-packaging-fabric-manager](https://github.com/NVIDIA/yum-packaging-fabric-manager)

### NVIDIA driver

- nvidia-driver
  * [https://github.com/NVIDIA/yum-packaging-nvidia-driver](https://github.com/NVIDIA/yum-packaging-nvidia-driver)


## See also

### Debian

  * [https://github.com/NVIDIA/apt-packaging-libnvidia-nscq](https://github.com/NVIDIA/apt-packaging-libnvidia-nscq)


## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md)