ECONFTOOL(8)

💖 ECONFTOOL — the manual page, but make it cute 💖

okay bestie, welcome to econftool (that's section 8 of the manual, the admin-commands girlies section 🫶) — also known as the Configuration File Manager. she's giving system-admin main character energy and she's here to help you manage your config file snippets without losing your mind. periodt. ✨

---

🌸 NAME 🌸

econftool — Configuration File Manager. that's it, that's the name, she's iconic and she knows it 💅

---

✨ SYNOPSIS ✨

econftool COMMAND [OPTIONS] </path/to/configfile>.conf

so the shape of it is: a COMMAND, then some OPTIONS, then the path to your .conf file. the path goes in angle brackets, so like, swap it for your actual file, bestie, don't literally type </path/to/configfile>.conf 🙈

---

🦋 DESCRIPTION 🦋

she's a tool that lets you easily manage the configuration file snippets. that's the whole vibe. no cap. lowkey that's all you need to know before we get into the commands, and the commands are where the fun is 🔥

---

👑 COMMANDS 👑

🌈 show

Reads all snippets for <filename>.conf (in /usr/etc and /etc), and prints all groups, keys and their values. so basically she goes and collects everything and shows you the whole picture — groups, keys, values, the works 🎀

the root directories is /. it can be set by the environment variable $ECONFTOOL_ROOT.

ngl the root dir defaults to / but if you wanna live somewhere else, $ECONFTOOL_ROOT is your girl 💜

🧚 cat

Prints the content of the files and the name of the file in the order as it has been read. she keeps the order fr fr, no shuffling, no surprises, just the files in the order she read them 💀✨

💅 edit

Starts the editor $EDITOR (environment variable) where the groups, keys and values can be modified and saved afterwards. so yes, bestie, you get to actually touch the config, edit it, and save it. slay 💖

🍓 edit OPTIONS 🍓

• -f, --full — Copy the original configuration file to /etc instead of creating drop-in files.
• --use-home — Only has an effect if the user is root. Chooses the root home directory instead of /etc.

heads up: --use-home literally does nothing unless you're root. it's giving "only for the root girlies" 💀

🌟 revert

Reverts all changes to the vendor versions. Basically deletes the config file and snippet directory in /etc. that's right, she takes it back to factory settings — vendor versions only, everything you added in /etc gets yeeted 🌈

⭐ revert OPTIONS ⭐

• -y, --yes — Assumes yes for all prompts and runs non-interactively.

-y/--yes means she stops asking and just does the thing. very "yes queen, go off" energy, but like, make sure that's what you want before you say yes to everything 🙈

---

🎀 general OPTIONS 🎀

these are the general ones that apply broadly, and they're lowkey important so don't skip them, bestie:

• --comment <character> — Character which starts a comment. (# default).
• --delimiters <string> — Characters which separates key/value entries. ("=" default).
  • e.g. --delimiters="= "
  • e.g. --delimiters=spaces — regarding all spaces

so the default comment char is #, and the default delimiter is =. but you can change the delimiter to a whole string of characters, like --delimiters="= ", or literally say --delimiters=spaces if you want all spaces to count as separators. iykyk 💅

---

🫶 SEE ALSO 🫶

• libeconf

go read about her sister, she's cool too 💜

---

📜 COPYRIGHT 📜

Copyright (c) 2021 SUSE LLC

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

fr fr that's the whole license, don't skim it, it matters 💖

---

and that's the page, bestie!! this one comes from libeconf and she's dated 2 Apr 2021 — shoutout to the day she was born 🎂✨ go forth, manage those snippets, and remember: no cap, she really does make config files easier 💅💜🦋