USERCONF(4)

πŸ“¦ version 11.0, in nixpkgs unstable

πŸ’… USERCONF(4) β€” like, the kernel interfaces manual, bestie πŸŽ€

okay so picture this: it's USERCONF(4), from the Kernel Interfaces Manual, and she's literally the moment. strap in ✨


🌸 NAME 🌸

userconf β€” the in-kernel device configuration manager. yes, in-kernel. she lives inside the kernel. main character energy fr πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

options USERCONF

that's it. that's the whole synopsis. iconic.


✨ DESCRIPTION ✨

okay so userconf is the in-kernel device configuration manager. what does that even mean? it means she's the one who's allowed to go in and alter the kernel autoconfiguration framework at runtime. like, while everything's running. no reboot, no nothing. she just does it 😌

and how do you get her to show up? you activate her from the boot loader by passing the -c option to the kernel. that's the summoning ritual. that's it. that's the whole vibe check 🫢


πŸ’– COMMAND SYNTAX πŸ’–

the general command syntax is literally just:

command [option]

so, command, and then maybe an option. sometimes. if she feels like it. ngl that's the whole grammar πŸŽ€

now here's the cute part: userconf has a more(1)-like functionality. meaning if a number of lines in a command's output exceeds the number defined in the lines variable, she hits you with the β€œ-- more --” and then waits for a response. and your response can be one of these:

  • <return> β€” one more line. just one. a little sip πŸ“
  • <space> β€” one more page. go off, load the whole thing πŸ“„
  • q β€” abort the current command, and return to the command input mode. we're done here, bye πŸ’€

πŸ‘‘ COMMANDS πŸ‘‘

userconf supports the following commands, and yes i'm listing every single one because they all matter:

  • lines count β€” specify the number of lines before more. this is the number that the more-like behaviour up there is checking against, iykyk.
  • base 8 | 10 | 16 β€” base for displaying large numbers. pick your fave: octal, decimal, or hex. choose your fighter πŸ”₯
  • change devno | dev β€” change devices.
  • disable devno | dev β€” disable devices. they're on timeout now πŸ™ˆ
  • enable devno | dev β€” enable devices. welcome back bestie 🌈
  • exit β€” a synonym for quit. same energy, different spelling.
  • find devno | dev β€” find devices. where'd they go πŸ”
  • help β€” display online help. she's helping you help yourself πŸ’œ
  • list β€” list current configuration. the whole roster, laid out ⭐
  • quit β€” leave userconf. sad moment but okay 😭
  • ? β€” a synonym for help. shorter, cuter, same thing.

🧚 HISTORY 🧚

the userconf framework first appeared in OpenBSD 2.0, and was then integrated into NetBSD 1.6. a whole journey. we love a cross-project glow-up ✨


🌺 AUTHORS 🌺

the userconf framework was written by Mats O Jansson ⟨moj@stacken.kth.se⟩. thank you king, we see you πŸ‘‘


okay that's the whole page, no cap. every flag, every command, every devno | dev, all of it. you're welcome bestie 🫢

so yeah, that's userconf β€” shipped in the Debian world on July 1, 2001 πŸŽ€ catch you at the boot loader, mwah πŸ’‹

πŸ“¦ where this page comes from