1eurephia_init(7)                                              eurephia_init(7)
2
3
4

NAME

6       eurephia_init   -  Initialisation  utility  for  the  eurephia  OpenVPN
7       plug-in.
8

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

21       Arguments used by eurephia_init:
22
23       -V | --version
24              Show version information
25
26       -h | --help
27              This help screen
28
29       -l | --log <filename>
30              Log file for debugging
31
32       -L | --log-level <log level>
33              Sets the log level
34
35       -N  |  --hash-threshold-min  <ms>  : Benchmarking parameter, see below.
36              Default 95ms
37
38       -M | --hash-threshold-max <ms> :  Benchmarking  parameter,  see  below.
39              Default 200ms
40
41       -D | --database-driver <full path>
42              Full path to the database driver (Required)
43
44       -d | --database-args <arguments>
45              Required database arguments for the driver (Required)
46

BENCHMARKING

48       During  the initialisation this utility will benchmark the CPU power by
49       doing multiple SHA512 hash calculations.  This is  to  determinate  the
50       optimal  rounds the password hashes should use on the current computer.
51       To make it more difficult to brute force passwords, eurephia implements
52       dynamic  password  hash  rounds,  based  on a random number within in a
53       given range.  This benchmark will suggest  an  optimal  range.   To  do
54       this, two limits are defined, the shortest time and the longest time to
55       be used for calculating a hash.  The default values are 95ms and 200ms.
56
57       If you want to  modify  those  thresholds,  you  can  do  so  with  the
58       --hash-threshold-min  and  --hash-threshold-max options.  By increasing
59       these numbers, you will allow the number of rounds to be increased.
60

AUTHOR

62       Copyright (C) 2009-2010  David Sommerseth <dazo@users.sourceforge.net>
63
64
65
66David Sommerseth                   June 2010                  eurephia_init(7)
Impressum