eurephia_init(7)

💖 eurephia_init — the manual page, but make it make sense 💖

okay bestie, so this is eurephia_init(7), and honestly? she's a one-job girlie. Let me tell you everything ✨

🌸 NAME 🌸

eurephia_init — the initialisation utility for the eurephia OpenVPN plug-in. That's it, that's the whole vibe 🫶

✨ SYNOPSIS ✨

eurephia_init [-V|--version] [-h|--help] [-l|--log <filename>]
[-L|--log-level <log level>] [-N|--hash-threshold-min <ms>]
[-M|--hash-threshold-max <ms>] [-D|--database-driver <path>]
[-d|--database-args <args>]

🎀 DESCRIPTION 🎀

ngl, this utility is only supposed to be used when you're installing eurephia. Like, that is her moment, that is her era, she does not show up otherwise 💅

The whole point? To initialise the database eurephia is gonna use. She does that by setting up some standard configuration values, and — the main character move — she creates an administrator account 👑

🔥 OPTIONS 🔥

These are the arguments eurephia_init takes, and yes, we're going through every single one, no skips 💖

• -V, --version — shows you the version information ⭐
• -h, --help — this help screen, right here, hi 🎀
• -l, --log <filename> — the log file for debugging 🦋
• -L, --log-level <log level> — sets the log level, you know the drill 🌸
• -N, --hash-threshold-min <ms> — benchmarking parameter, more on that below 👇 Default is 95ms
• -M, --hash-threshold-max <ms> — benchmarking parameter too, also below 👇 Default is 200ms
• -D, --database-driver <full path> — full path to the database driver. Required. Like, actually required bestie, don't skip her 😭
• -d, --database-args <arguments> — the required database arguments for the driver. Also Required. Both of them. Every time. 🙈

🌈 BENCHMARKING 🌈

okay so this part is lowkey the coolest bit, listen up 🧚

During the initialisation, this utility benchmarks your CPU power by doing a bunch of SHA512 hash calculations. Why? To determine the optimal number of rounds the password hashes should use on this specific computer. It's giving personalised, it's giving tailored, we love that for us 💜

And here's the slay part: to make it harder to brute force passwords, eurephia implements dynamic password hash rounds, based on a random number inside a given range. This benchmark is what suggests that optimal range 🌟

To pull that off, two limits get defined:

• the shortest time to be used for calculating a hash
• the longest time</longest> to be used for calculating a hash

The default values are 95ms and 200ms. Periodt 💅

Now, if you wanna modify those thresholds, you totally can — that's what --hash-threshold-min and --hash-threshold-max are for 🎯 And heads up: by increasing these numbers, you allow the number of rounds to be increased. That's the whole trade-off, no cap 🔥

👑 AUTHOR 👑

Copyright (C) 2009-2012 David Sommerseth <dazo@users.sourceforge.net>

and that's the whole page, bestie 💖 this little manual came from David Sommerseth, dated June 2010, and it ships as part of eurephia_init(7). go init that database, you absolute icon ✨🦋🌸