UCL-ARC / UCL-ARC/mkdocs-rc-docs

`glxgears` doesn't work for me as X-Fowarding test

Open
#38 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

clarification
Dominant language
Rich Text Format
Stars
41
Forks
22
Avg merge
1m
Merged PRs (30d)
14

Description

On https://www.rc.ucl.ac.uk/docs/Wiki_Export/X-Forwarding/#checking-your-setup there's a suggestion to use glxgears to check that X-forwarding is working. glxgears doesn't work for me on a macOS host:

$ glxgears
libGL error: No matching fbConfigs or visuals found
libGL error: failed to load driver: swrast
X Error of failed request:  BadValue (integer parameter out of range for operation)
  Major opcode of failed request:  149 (GLX)
  Minor opcode of failed request:  3 (X_GLXCreateContext)
  Value in failed request:  0x0
  Serial number of failed request:  36
  Current serial number in output stream:  38

and it took me a little while to work out that X-forwarding was working fine, but it was glxgears that wasn't. Checking by launching xterm worked fine though, so maybe worth removing the suggstion to check using glxgears?

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the X-Forwarding documentation page linked in the issue and locate the section suggesting glxgears for checking the setup. Update the guidance so it does not present glxgears as the check, and consider the reported xterm check; done means the documentation no longer misleads macOS users about whether X-forwarding works.

Written by the indexing model from the issue text.

Assessment

Tech stack
macos
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.