GSS(1)

📦
version 1.0.4 · 3 versions
, in alpine 3.24, debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 gss(1) — the manual, but make it cute 💖

okay so bestie, this is gss, the Generic Security Service command line interface. it lives in the User Commands section of the manual, so you already know it's giving "i'm a whole binary, not a config file." 🫶

✨ NAME ✨

gss — Generic Security Service command line interface 💅

✨ SYNOPSIS ✨

gss OPTIONS...

literally just you, the command, and a pile of options. iconic. 👑

✨ DESCRIPTION ✨

so like, this is the command line interface to GSS, and its whole main character job is explaining error codes for you. no cap. 🔥

also a lil heads up bestie: mandatory arguments to long options are mandatory for short options too. so if a long option needs a value, the short one does too. the rules apply to everyone, periodt. 💀

here's every single flag, no skipping, i promise 🎀:

  • -h, --help — prints the help and then dips out. exit stage left. 👋
  • -V, --version — prints the version and exits. flex the number, then bounce. ⭐
  • -l, --list-mechanisms — lists info about the supported mechanisms, in a human readable format. like, readable by humans specifically, which is us. 🦋
  • -m, --major=LONG — describes a `major status' error code value. it takes a LONG, so hand it the number and it'll tell you what it means. 🔍
  • -a, --accept-sec-context[=MECH] — accept a security context as server. and here's the tea: if MECH isn't specified, no credentials will be acquired. use "*" to use the library default mechanism. 👑
  • -i, --init-sec-context=MECH — initialize a security context as client. MECH is the SASL name of the mechanism, and if you don't know which ones exist, use -l to list the supported mechanisms. 🧚
  • -n, --server-name=SERVICE@HOSTNAME — for -i and -a, this sets the name of the remote host. for example, "imap@mail.example.com". 📬
  • -q, --quiet — silent operation, and the default is off, so by default it is very much not silent. 🙈

✨ AUTHOR ✨

written by Simon Josefsson. 💜

✨ REPORTING BUGS ✨

found a bug? tell the people, bestie:

Copyright © 2022 Simon Josefsson. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.

this is free software: you are free to change and redistribute it. ✨

and there is NO WARRANTY, to the extent permitted by law. like, none. zero. not even a little one. 🫣

✨ SEE ALSO ✨

the full documentation for gss is maintained as a Texinfo manual. so if the info and gss programs are properly installed at your site, this command

info gss

should give you access to the complete manual. go read it, it's giving very thorough. 📖💖

and that's the whole page, bestie!! 🌈 this was GNU Generic Security Service, version 1…, from August 2022 — mwah, ily, now go explain some error codes. 💅🎀🦋🌸💜

📦 where this page comes from