# AMD ROCm / Pro ports for Venom Linux

Ports for **numactl**, **ROCm** (HIP, runtimes, udev), and **amdgpu-pro** (optional). Use with Venom’s pkgbuild/scratch tooling.

---

## What’s in this repo

| Port        | Purpose |
|------------|--------|
| **numactl** | NUMA libs/tools; required by ROCm. |
| **rocm**    | ROCm platform to `/opt/rocm` + udev rules + render group (replaces a separate rocm-udev port). |
| **amdgpu-pro** | Optional. Pro installer to `/opt/amdgpu-pro`. |

---

## Prerequisites

- Venom Linux (or compatible system with **pkgbuild** and **scratch**).
- Build deps will be pulled by the ports: **autoconf**, **automake**, **libtool** (numactl); **eudev** (rocm); **bash**, **zstd** (amdgpu-pro). Install any missing system packages first if needed.

---

## Install steps

### 1. Get the ports

```bash
git clone https://git.fraggle.lol/fraggle/ports
cd ROCm
```

### 2. Build and install in this order

Use **`-i`** for initial installation of each port.

**Step 1 – numactl**

```bash
cd numactl
sudo pkgbuild -i
cd ..
```

**Step 2 – rocm**

```bash
cd rocm
sudo pkgbuild -i
cd ..
```

- The runfile is large; extraction can take several minutes. Packaging (xz) after “Build success” can take 5–15+ minutes. Let it finish.

**Step 3 (optional) – amdgpu-pro**

```bash
cd amdgpu-pro
sudo pkgbuild -i
cd ..
```

**Rebuilding a port (already installed):** use **`-rcf`** when you are rebuilding a port that is already installed (e.g. after updating the spkgbuild or sources).

### 3. Use ROCm

- Ensure your user is in the **render** group (and **video** if you use it):

  ```bash
  sudo usermod -a -G render,video $USER
  ```

- Log out and back in (or reboot).
- New shells get the ROCm environment from `/etc/profile.d/rocm.sh`. To use in the current shell:

  ```bash
  source /etc/profile.d/rocm.sh
  ```

- Check the GPU:

  ```bash
  rocminfo
  ```

---

## Summary

1. Clone this repo.
2. Build and install **numactl**, then **rocm**, then optionally **amdgpu-pro** (each: `sudo pkgbuild -i` from inside the port directory).
3. Add your user to **render** (and **video**), re-login, and source `rocm.sh` or open a new shell.