USERS(1)

📦
version 9.12 · 26 versions
, in arch rolling

💖 USERS — like, the who's-online list for your terminal 💖

the users command from GNU coreutils, manual page 1 (User Commands) ✨

🌸 NAME 🌸

users — prints the user names of everyone who is currently logged in to the current host. that's it. that's the whole vibe. bestie it's the <rainbow>who's online</rainbow> list but make it names only 🫶

✨ SYNOPSIS ✨

users [OPTION]... [FILE]

like… options if you want them, a file if you're feeling spicy. both optional, no pressure 💅

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — users outputs who is currently logged in, and it figures that out according to FILE. so whatever file you hand it is the source of truth for the whole "who's here" situation.

if you don't specify a FILE at all? it defaults to /var/run/utmp. that's the standard spot where your system keeps track of who's logged in right now. iconic of it honestly 🎀

and just so you know — passing /var/log/wtmp as your FILE is common. like, extremely common. it's the move people make. it's giving "history of logins instead of just right-now logins" iykyk 🌈

🧚 the options (yes there are only two, we love a low-maintenance icon)

  • --help — displays this help and then exits. the classic "wait what does this do again" button 🫶
  • --version — outputs version information and then exits. for when you need to know exactly which era of this tool you're living in 💅
ngl there really are only these two options. short and sweet. a minimalist queen 👑

👑 AUTHOR 👑

Written by Joseph Arceneaux and David MacKenzie. 🫡 absolute legends, no cap. thank you for your service 💖

😭 REPORTING BUGS 😭

found a bug? not me manifesting problems, but if you did, here's where to spill 🍓:

Copyright © 2026 Free Software Foundation, Inc.

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.

⚠️ There is NO WARRANTY, to the extent permitted by law. like fr fr, none. zero. read it and weep (affectionately) 💀

🌈 SEE ALSO 🌈

Full documentation https://www.gnu.org/software/coreutils/users or available locally via: info '(coreutils) users invocation'

and that's the whole page bestie, you ate it up 💅✨ this was GNU coreutils 9.12, dated September 2026, and you were reading the USERS(1) manual page. main character energy from start to finish, no cap 🎀🦋🌸

📦 where this page comes from