Skip to content

Docs: Add Ubuntu, consistent steps for BPF LSM and note on already open GPU file descriptors#62

Open
MaEtUgR wants to merge 2 commits into
OpenGamingCollective:mainfrom
MaEtUgR:maetugr/docs-ubuntu
Open

Docs: Add Ubuntu, consistent steps for BPF LSM and note on already open GPU file descriptors#62
MaEtUgR wants to merge 2 commits into
OpenGamingCollective:mainfrom
MaEtUgR:maetugr/docs-ubuntu

Conversation

@MaEtUgR

@MaEtUgR MaEtUgR commented Jun 22, 2026

Copy link
Copy Markdown

First of all thank you for all the effor on this successor to supergfxctl which I was using before. The direction of this tool seems much better 👏 I think we just have to get it more accessible which I'm trying to achieve by contributing to the docs. It's the points I stumbeled and spent time on so I try to make it easier for the next user. I tried to get a good coverage for all distros but I could only test on Ubuntu 26.04 (Kernel 7, BPF compiled but disabled by default).

MaEtUgR added 2 commits June 22, 2026 15:17
…evoke existing GPU file descriptors

It can be further refined but this note at least helps dcument the reality that if gnome already holds the GPU it will not be freed immediately.
@luytan

luytan commented Jun 23, 2026

Copy link
Copy Markdown
Collaborator

Hi, first and foremost thanks for your help !
Cardwire is my first project and i think i didn't work enough on accessibility, your help is really appreciated.
Regarding Ubuntu since it's a popular distro, i will try to release a .deb for Cardwire in the next update

};
```

The NixOS module configures BPF LSM automatically — no manual kernel parameter changes needed.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bpf is enabled by default on nixos, the module doesnt enable it


Check your kernel's default LSM list:

On Ubuntu/Fedora:

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bpf is also enabled by default on fedora, i tested on a Fedora 44 KDE edition VM, maybe we should add a warning to not touch the grub config if bpf is already enabled? or remove Fedora?

```

> [!NOTE]
> The block only applies to new file opens. Processes that already have the GPU open (e.g. the compositor) will keep their access until they restart. A session logout/login is required for the GPU to fully power down. Check `cardwire gpu --lsof 1` to verify thre's no process keeping e.g. the dedicated GPU awake.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo on "thre's no process keeping e.g. the dedicated GPU awake", a session logout/login shouldn't be required, even if the compositor has the dGPU's render/card node open, the dGPU can still enter D3Cold as long as the fd is not actively keeping the GPU awake (e.g. the GPU is idle, and the driver/compositor allow runtime suspend)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants