USERLIST(8)

💖 USERLIST(8) — Finger-type Userlisting 💖

okay bestie, so userlist is the little icon that tells you who's on your system rn. that's the whole vibe. it's from the cfingerd family (v 1.4.2, dated 29 August 1999, so she's vintage and she's still serving) 💅

---

✨ NAME ✨

userlist — userlisting of who's on your system.

---

🌸 SYNOPSIS 🌸

userlist

---

🦋 DESCRIPTION 🦋

so literally, this program just gives you a listing of who is connected to your system. that's it. that's the job. 🫶

it's used primarily in the sorted listing of cfingerd, which uses the same method of display so everything looks uniform between systems. (and honestly? it made more sense to do it this way instead of having jumbled-up display listings in sorted finger displays. besides, it made more sense to do this than use finger. :))

this program functions with the same types of things in mind that cfingerd does. so if a user has a .nofinger file, their username will not be displayed in the userlisting. respect the .nofinger, fr fr. 🙈

example output is shown as:

 Username Real Name      Idletime TTY Remote console
 username I'm real ...   9d 23:59   0 (remote.site.com)

so where it would display the user's login name, the user's real name, their idle time given in the format "dd hh:mm", their TTY, and their remote location (or where they're telnetting from). the whole glow-up, all in one line. ✨

and here's a little thing to know: if the username is over 8 characters, the program will not search for their information in the passwd file, since it may be too long. besides, it checks getpwnam, anyway. :) no cap.

---

💅 OPTIONS 💅

• -c — give standard CFINGERD (custom) output.
• -n — list only people idle less than one day.

---

👑 ADDITIONAL 👑

so, although userlist is not required to run as suid root, it is a good idea. the reason is it checks each users' directory for a .nofinger file. if indeed that user has a .nofinger file in his/her directory, that user will not be shown in the userlisting. that's the whole point, bestie.

if you change the program to run as nobody.nobody, you are free to do so. but you will also show the users if they are online, regardless of whether or not they have a ".nofinger" file (as long as their directory is NOT world-readable). so like. tradeoffs. choose wisely. 😭

⚠️ heads up: running as nobody.nobody means .nofinger gets ignored for anyone whose directory isn't world-readable — the privacy setting just won't hold. that's the actual documented behavior, not me being dramatic.

---

🎀 CONTACTING 🎀

if you like this program, have any suggestions on how it could be modified, or have bug reports, please write to: khollis@bitgate.com.

your continued Public Domain support is appreciated! thanks. 🫶

---

🌈 SEE ALSO 🌈

cfingerd.conf(5), cfingerd(8), finger(1).

---

and that's the whole page, bestie — cfingerd version 1.4.2, dated 29 August 1999, signing off. icon behavior only. periodt. 💖✨🎀🦋