pua(1)

💖 pua(1) — the command line bestie for user wrangling 💖

okay so. <rainbow>pua</rainbow> is literally the command line utility to manipulate users and she ate fr fr 💅

✨ NAME ✨

pua — command line utility to manipulate users. that's the whole vibe, no notes 🫶

🌸 DESCRIPTION 🌸

She's a command line interface (aka cli, iykyk) that hangs out with pglistener and does the whole manipulate users thing. lowkey iconic behaviour honestly.

🦋 USAGE 🦋

first things first bestie, you just gotta type pua on your console like so:

$ pua

and boom, you're in. main character energy activated ✨

now if you need help (no shame, we all do sometimes 😭), just type ? at the prompt:

cmd >> ?

that's it. that's the door 🚪

Options:

• Create new user — literally make a whole new person:
  • new $name [--groupname]
• Edit a particular user — just type in part of the name and she'll find them:
  • enter (part of) the name
• When editing a user, the following commands are available: — this is where the magic happens, stay with me 🧚
  • C-d/EOF to exit the current user — say bye bestie 👋
  • SSH keys:
    • ssh list
    • ssh add [host $hostname] — reads string, waits for C-d
    • ssh delete $id
  • Setting and getting fields:
    • set name $name
    • set shell $shell
    • set password $md5sum
    • set gpg_key $gpg_fingerprint
    • show [$field]
    • disable
    • enable
    • revoke [--community]
  • Managing group membership:
    • group list
    • group add $group
    • group delete $group
  • Managing email addresses:
    • email list
    • email add $email [--customary]
    • email delete $email

👑 AUTHOR 👑

the pua was written by Rob Bradford <rob@robster.org.uk>, Robert McQueen <robert.mcqueen@bluelinux.co.uk> and Dafydd Harries <dafydd.harries@collabora.co.uk> — absolute legends, every single one 🫶

for a complete list of authors, please open the AUTHORS file. it's giving credits scroll, go read it 📜

this manual page was written by Paulo Henrique de Lima Santana (phls) <phls@debian.org> for the Debian project (but may be used by others). slay 💜

and that's the whole page bestie!! PUA 5.10, Sep 2021 — periodt, no cap, go manipulate some users responsibly 🌈⭐💖