]> Cypherpunks.ru repositories - govpn.git/blobdiff - src/cypherpunks.ru/govpn/client/client.go
Various stylistic and grammar fixes
[govpn.git] / src / cypherpunks.ru / govpn / client / client.go
index 5a745c1d99c06fbe130916e032c47c40d6e6b696..a4c49079157da40428bc5d534f7989afd0dad1e5 100644 (file)
@@ -1,6 +1,6 @@
 /*
 GoVPN -- simple secure free software virtual private network daemon
-Copyright (C) 2014-2016 Sergey Matveev <stargrave@stargrave.org>
+Copyright (C) 2014-2017 Sergey Matveev <stargrave@stargrave.org>
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -30,13 +30,17 @@ import (
        "cypherpunks.ru/govpn"
 )
 
+// Protocol is a GoVPN supported protocol: either UDP, TCP or both
 type Protocol int
 
 const (
+       // ProtocolUDP is UDP transport protocol
        ProtocolUDP Protocol = iota
+       // ProtocolTCP is TCP transport protocol
        ProtocolTCP
 )
 
+// Configuration holds GoVPN client configuration
 type Configuration struct {
        PrivateKey          *[ed25519.PrivateKeySize]byte
        Peer                *govpn.PeerConf
@@ -52,6 +56,7 @@ type Configuration struct {
        MTU                 int
 }
 
+// Validate returns an error if a configuration is invalid
 func (c *Configuration) Validate() error {
        if c.MTU > govpn.MTUMax {
                return fmt.Errorf("Invalid MTU %d, maximum allowable is %d", c.MTU, govpn.MTUMax)
@@ -69,6 +74,7 @@ func (c *Configuration) isProxy() bool {
        return len(c.ProxyAddress) > 0
 }
 
+// Client is a GoVPN client
 type Client struct {
        idsCache      *govpn.MACCache
        tap           *govpn.TAP
@@ -85,6 +91,7 @@ type Client struct {
        Error chan error
 }
 
+// MainCycle main loop of a connecting/connected client
 func (c *Client) MainCycle() {
        var err error
        c.tap, err = govpn.TAPListen(c.config.InterfaceName, c.config.MTU)
@@ -146,6 +153,8 @@ MainCycle:
        }
 }
 
+// NewClient returns a configured GoVPN client, to trigger connection
+// MainCycle must be executed.
 func NewClient(conf Configuration, verifier *govpn.Verifier, termSignal chan os.Signal) *Client {
        client := Client{
                idsCache:    govpn.NewMACCache(),
@@ -154,7 +163,7 @@ func NewClient(conf Configuration, verifier *govpn.Verifier, termSignal chan os.
                termSignal:  termSignal,
                Error:       make(chan error, 1),
        }
-       confs := map[govpn.PeerId]*govpn.PeerConf{*verifier.Id: conf.Peer}
+       confs := map[govpn.PeerID]*govpn.PeerConf{*verifier.ID: conf.Peer}
        client.idsCache.Update(&confs)
        return &client
 }