x2gobroker-testauth(1)

📦 version 0.0.4.3, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ x2gobroker-testauth ✨

okay bestie, gather round 💖 this is the X2Go Session Broker manual page for x2gobroker-testauth, the Authentication Test Utility. Yes, that's the manual name — it lives in section 1 of the man pages, iykyk. 🎀

🌸 NAME 🌸

x2gobroker-testauth — Session Broker for X2Go (Authentication Test Utility)

she's a little utility whose whole personality is testing whether your auth actually works 🦋

🫶 SYNOPSIS 🫶

x2gobroker-testauth [ options ]

💅 DESCRIPTION 💅

So x2gobroker-testauth is, like, an authentication test utility for X2Go Session Broker. That's the whole job. She tests your broker auth so you don't have to find out the hard way. 👑

⚠️ WARNING: please know that the credentials you use for testing the broker authentication will get revealed in your shell's history file (e.g. ~/.bash_history). Like, literally written down forever, bestie. Not a vibe. 😭 Be so careful.

⭐ COMMON OPTIONS ⭐

x2gobroker-testauth displays some help on command line options:

  • -h, --help — Display a help with all available command line options and exit. She's helpful like that ✨

🔥 REQUIRED OPTIONS 🔥

At least the username is required. The password option can be omitted — you will be queried interactively, if no password is specified on the command line. So if you're shy about the history file thing, just leave -p off and she'll ask you nicely 🎀

  • -u, --user, --username — Username part of the credentials you want to test. Three whole spellings, she's flexible 💖
  • -p, --password — Password part of the credentials (be sure you want to reveal those on the command line before doing it!!!). Three exclamation marks. The manpage is yelling. Listen to her. 🙈

🦋 MISC OPTIONS 🦋

x2gobroker-testauth also accepts the following miscellaneous options:

  • -d, --debug — Enable debugging code. Turn it on when things are giving mystery ✨
  • -C, --config FILENAME — Specify an alternative configuration file name, default is: /etc/x2go/x2gobroker.conf.
  • -b, --backend BACKEND — Specify another configured/enabled backend configuration to test authentication against, default is: the inifile backend. Inifile is the main character by default 👑

🎀 FILES 🎀

  • /etc/x2go/x2gobroker.conf, /etc/x2go/broker/* (configuration files)
  • /etc/default/x2gobroker-daemon (environment for X2Go Session Broker when run as standalone daemon)
  • /var/log/x2gobroker/* (log files of X2Go Session Broker)

Yes bestie, that's the whole file list, she keeps it tight 🫶

🌈 SEE ALSO 🌈

  • /usr/share/doc/x2gobroker

💜 AUTHOR 💜

This manual has been written for the X2Go project by Mike Gabriel <mike.gabriel@das-netzwerkteam.de>.

and that's the whole page, no cap ✨ This was Version 0.0.4.x, dated Apr 2020 — written up as x2gobroker-testauth(1), and she ate, periodt. 💅💖

📦 where this page comes from