xenial (7) eurephia_init.7.gz

Provided by: eurephia_1.1.0-5_amd64 bug

NAME

       eurephia_init - Initialisation utility for the eurephia OpenVPN plug-in.

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

       This  utility  is  only  supposed  to be used when installing eurephia.  The purpose is to initialise the
       database eurephia will use, by setting up some standard configuration values and create an  administrator
       account

OPTIONS

       Arguments used by eurephia_init:

       -V | --version
              Show version information

       -h | --help
              This help screen

       -l | --log <filename>
              Log file for debugging

       -L | --log-level <log level>
              Sets the log level

       -N | --hash-threshold-min <ms> : Benchmarking parameter, see below. Default 95ms

       -M | --hash-threshold-max <ms> : Benchmarking parameter, see below. Default 200ms

       -D | --database-driver <full path>
              Full path to the database driver (Required)

       -d | --database-args <arguments>
              Required database arguments for the driver (Required)

BENCHMARKING

       During  the  initialisation  this  utility  will  benchmark  the  CPU power by doing multiple SHA512 hash
       calculations.  This is to determinate the optimal rounds the password hashes should use  on  the  current
       computer.   To make it more difficult to brute force passwords, eurephia implements dynamic password hash
       rounds, based on a random number within in a given range.  This benchmark will suggest an optimal  range.
       To  do  this, two limits are defined, the shortest time and the longest time to be used for calculating a
       hash.  The default values are 95ms and 200ms.

       If  you  want  to  modify  those  thresholds,  you  can  do  so   with   the   --hash-threshold-min   and
       --hash-threshold-max  options.   By  increasing  these numbers, you will allow the number of rounds to be
       increased.

AUTHOR

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