X-Git-Url: http://www.git.cypherpunks.ru/?a=blobdiff_plain;f=doc%2Fserver.texi;h=325d317cb4b435f88398e56d51382166919c008f;hb=f9209136cff0331fc2293f25061971f6c77ff213;hp=1784a9bb4858390d276b5354ba083c1dc3f45c24;hpb=4b6010d63d3512094c7cef4a119a8d45cb1a7b18;p=govpn.git diff --git a/doc/server.texi b/doc/server.texi index 1784a9b..325d317 100644 --- a/doc/server.texi +++ b/doc/server.texi @@ -1,8 +1,8 @@ @node Server @section Server part -Except for common @ref{Stats, -stats}, @ref{EGD, -egd} options client -has the following ones: +Except for common @ref{Stats, -stats}, @ref{EGD, -egd}, @ref{Syslog, -syslog} +options server has the following ones: @table @option @@ -24,9 +24,9 @@ Start trivial HTTP @ref{Proxy} server on specified @emph{host:port}. Configuration file is YAML file with following example structure: @verbatim -stargrave: { <-- Peer human readable name +stargrave: <-- Peer human readable name iface: tap10 <-- OPTIONAL TAP interface name - mtu: 1514 <-- OPTIONAL overriden MTU + mtu: 1515 <-- OPTIONAL overriden MTU up: ./stargrave-up.sh <-- OPTIONAL up-script down: ./stargrave-down.sh <-- OPTIONAL down-script timeout: 60 <-- OPTIONAL overriden timeout @@ -34,19 +34,19 @@ stargrave: { <-- Peer human readable name noise: No <-- OPTIONAL noise enabler cpr: 64 <-- OPTIONAL constant packet rate, KiB/sec encless: No <-- OPTIONAL Encryptionless mode - verifier: $argon2d... <-- verifier received from client + verifier: $baloon... <-- verifier received from client [...] @end verbatim At least one of either @code{iface} or @code{up} must be specified. If you specify @code{iface}, then it will be forcefully used to determine -what TAP interface will be used. If it is not specified, then up-script -must output interface's name to stdout (first output line). +what TAP interface will be used. If it is not specified, then +up-@ref{Scripts, script} must output interface's name to stdout +(first output line). For example up-script can be just @code{echo tap10}, or more advanced like the following one: - @verbatim #!/bin/sh $tap=$(ifconfig tap create) @@ -63,25 +63,25 @@ creation: @verbatim % ./utils/newclient.sh Alice [...] -Your client verifier is: $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg +Your client verifier is: $balloon$s=32768,t=16,p=2$bwR5VjeCYIQaa8SeaI3rqg Place the following YAML configuration entry on the server's side: Alice: up: /path/to/up.sh iface: or TAP interface name - verifier: $argon2d$m=4096,t=128,p=1$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10 + verifier: $balloon$s=32768,t=16,p=2$bwR5VjeCYIQaa8SeaI3rqg$KCNIqfS4DGsBTtVytamAzcISgrlEWvNxan1UfBrFu10 @end verbatim Example configuration file: @verbatim stargrave: iface: tap0 - verifier: $argon2d$m=4096,t=128,p=1$VMirzcshcHuG2V4jhUsEjw$X5fC07L8k61h3S1Oro/rC76+m0oGDTA9Bq+aWJ1uOgY + verifier: $balloon$s=32768,t=16,p=2$VMirzcshcHuG2V4jhUsEjw$X5fC07L8k61h3S1Oro/rC76+m0oGDTA9Bq+aWJ1uOgY slow: iface: tap1 encless: Yes mtu: 9000 cpr: 384 - verifier: $argon2d$m=4096,t=128,p=1$YbIA5garDqCOhtI/2EZVNg$gOo5vcEGynmpeepNscwclicfZsWxzgYFRLbgG21EZ1U + verifier: $balloon$s=32768,t=16,p=2$YbIA5garDqCOhtI/2EZVNg$gOo5vcEGynmpeepNscwclicfZsWxzgYFRLbgG21EZ1U @end verbatim