neard.conf(5)

📦 version 0.20, in fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu stonking

💖 neard.conf(5) — bestie's guide to the neard config file 💖

okay so like, this is the manpage for neard.conf(5), which lives in the File Formats Manual section (that's the "5" bestie, it's a file format thing, not a command). sit down, grab a strawberry, we're doing config files today 🍓

🌸 NAME 🌸

main.conf — the neard configuration file. that's it, that's the name, short and iconic 👑

✨ SYNOPSIS ✨

/etc/neard/main.conf

or

<SYSCONFDIR>/neard/main.conf

where <SYSCONFDIR> depends on your distribution or build. so like, it's not always /etc, it depends on how your distro / build set things up. check your vibes (and your distro) 🦋

💅 DESCRIPTION 💅

main.conf is the configuration file for neard(8). and here's the tea: this file is optional! you don't have to have it. but if you do, you can use it to set up various aspects of neard's behavior. it's giving "you don't need me but you want me" energy 💁♀️

🎀 FILE FORMAT 🎀

the configuration file format is key file format ✨ it's made up of sections (groups) of key-value pairs. let's break it down:

  • lines beginning with a # are comments. blank lines are comments too. live your life, write notes, nobody's judging 🫶
  • sections are started by a header line that contains the section name wrapped in [ and ]. iconic brackets, love that for them.
  • a section ends implicitly — meaning the moment the next section starts, or the file just... ends. no closing tag, no goodbye, it's giving ghosting 💀
  • every single key-value pair must live inside a section. no free-floating keys, bestie. they need a home. 🏠

description of sections and available keys follows:

🌈 [General] 🌈

this section is the only mandatory section of the configuration file. if you're gonna show up, you show up here. main character energy only 👑

  • ConstantPoll=true|false — enable constant polling. default is false. what does it do tho? constant polling will force neard into starting a new polling cycle whenever a target or a device are lost. so it just... keeps going, no breaks, obsessed with the grind 🔥
  • DefaultPowered=true|false — automatically turn an adapter on when being discovered. default value is false. it's like auto-wake for your adapter, cute 🌸
  • ResetOnError=true|false — power cycle the adapter when getting a driver error from the kernel. default value is true. note that one's already on by default, unlike the other two — she's proactive 💅
heads up bestie: those true|false values are literal. you write true or false, not vibes, not yes, not maybe. lowercase, no cap. 🙈

👀 SEE ALSO 👀

  • neard(8)

that's the whole page, you ate it, you understood it, periodt 💜

this page came from the File Formats Manual, dated 7 March 2013, and it's neard.conf(5) — so if you're citing her, that's the whole glow-up. mwah 🎀✨

📦 where this page comes from