summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorjwijenbergh <jeroenwijenbergh@protonmail.com>2022-10-04 10:11:45 +0200
committerjwijenbergh <jeroenwijenbergh@protonmail.com>2022-10-04 10:11:45 +0200
commit0096d0471fef972e305a61435623d64b7da4f0d9 (patch)
tree17530b91964e40beeb590da8e6bb83fd32cea365 /docs
parent926b5a36f309b397fc4e9c4e8e316c0d3c956c06 (diff)
Refactor: Renmae force TCP to prefer TCP
Diffstat (limited to 'docs')
-rw-r--r--docs/src/api/go/functions.md6
-rw-r--r--docs/src/api/overview/getconfig.md12
-rw-r--r--docs/src/api/python/functions.md6
3 files changed, 12 insertions, 12 deletions
diff --git a/docs/src/api/go/functions.md b/docs/src/api/go/functions.md
index fc4f0a1..2cbab78 100644
--- a/docs/src/api/go/functions.md
+++ b/docs/src/api/go/functions.md
@@ -26,11 +26,11 @@ Returns a string of JSON data with the servers/organizations and an `error`, nil
## OpenVPN/Wireguard config
See [Overview](../overview/getconfig.html)
```go
-func GetConfigInstituteAccess(url string, forceTCP bool) (string, string, error)
-func GetConfigSecureInternet(url string, forceTCP bool) (string, string, error)
+func GetConfigInstituteAccess(url string, preferTCP bool) (string, string, error)
+func GetConfigSecureInternet(url string, preferTCP bool) (string, string, error)
```
- `url`: The URL of the Institute Access or Secure Internet server to get a connect config for
-- `forceTCP`: Whether or not we want to force enable TCP
+- `preferTCP`: Whether or not we want to prefer TCP
Returns:
- A `string` of the OpenVPN/Wireguard config
diff --git a/docs/src/api/overview/getconfig.md b/docs/src/api/overview/getconfig.md
index 65ca948..4e1e9fb 100644
--- a/docs/src/api/overview/getconfig.md
+++ b/docs/src/api/overview/getconfig.md
@@ -2,10 +2,10 @@
## Summary
name: `Get Config Institute Access` and `Get Config Secure Internet`
-| Arguments | Description | type |
-| --------- | -------------------------------------- | -------- |
-| URL | The url of the VPN server to connect to | string |
-| Force TCP | Whether or not to force the use of TCP | string |
+| Arguments | Description | type |
+| --------- | ---------------------------------------- | -------- |
+| URL | The url of the VPN server to connect to | string |
+| Prefer TCP | Whether or not to prefer the use of TCP | string |
Returns: `OpenVPN/Wireguard config (string)` `wireguard/openvpn type (string)`, `Error`
@@ -13,12 +13,12 @@ Used to obtain the OpenVPN/Wireguard config
## Detailed information
-To get a configuration that is used to actually establish a tunnel with the VPN server, we have the Get Config function for Institute Access and Secure Internet (the exact name depends on the language you're using) function in the library. This function has two parameters *URL* and *Force TCP*.
+To get a configuration that is used to actually establish a tunnel with the VPN server, we have the Get Config function for Institute Access and Secure Internet (the exact name depends on the language you're using) function in the library. This function has two parameters *URL* and *Prefer TCP*.
*URL* is the base url of the server to connect to
e.g. `nl.eduvpn.org`. Use the correct function to indicate if it is an Institute Access server or a Secure Internet server. A user configured server is often an Institute Access server. In case of a Secure Internet server and no Secure Internet was configured previously, this URL is set as the home server. This means that this server is set as the authorization server for all secure internet servers.
-The *Force TCP* flag is a boolean that indicates whether or not we want to use TCP to connect over the VPN. This flag is useful if the user has enabled e.g. a setting that forces the use of TCP, which is only supported by OpenVPN. If the Force TCP flag is set to `true` but the server only supports Wireguard then an error is returned and the config will be empty.
+The *Prefer TCP* flag is a boolean that indicates whether or not we want to prefer TCP to connect over the VPN. This flag is useful if the user has enabled e.g. a setting that prefers the use of TCP, which is only supported by OpenVPN. Note that this setting may be ignored by the server.
This function takes care of OAuth which has certain callbacks with data. Additionally, there are also callbacks that need to be registered for selecting the right profile to connect to. These callbacks will be explained now.
diff --git a/docs/src/api/python/functions.md b/docs/src/api/python/functions.md
index ecc4982..2b909a8 100644
--- a/docs/src/api/python/functions.md
+++ b/docs/src/api/python/functions.md
@@ -32,13 +32,13 @@ Returns a `string` of JSON data with the servers/organizations. Raises an except
## OpenVPN/Wireguard config
See [Overview](../overview/getconfig.html)
```python
-def get_config_institute_access(self, url: str, forceTCP: bool = False) -> Tuple[str, str]
+def get_config_institute_access(self, url: str, preferTCP: bool = False) -> Tuple[str, str]
```
```python
-def get_config_secure_internet(self, url: str, forceTCP: bool = False) -> Tuple[str, str]
+def get_config_secure_internet(self, url: str, preferTCP: bool = False) -> Tuple[str, str]
```
- `url`: The url of the Secure Internet or Institute Access server to get a connect config for
-- `forceTCP`: Whether or not we want to force enable TCP, default: `False`
+- `preferTCP`: Whether or not we want to prefer TCP, default: `False`
Returns:
- A `string` of the OpenVPN/Wireguard config