summaryrefslogtreecommitdiff
path: root/docs/src/gettingstarted/debugging/fsm.md
diff options
context:
space:
mode:
authorjwijenbergh <jeroenwijenbergh@protonmail.com>2022-04-26 16:49:15 +0200
committerjwijenbergh <jeroenwijenbergh@protonmail.com>2022-04-26 16:49:15 +0200
commit6c7a1c7a9245cf457a86fd15bdc14bc93b55d508 (patch)
tree8caf84c6497938922af0b89e309d8c8dd6bbf3e4 /docs/src/gettingstarted/debugging/fsm.md
parent94192739a4d8487d666c69be2d5e6be9ea6dd1a7 (diff)
Docs: Use an SVG for the FSM
Diffstat (limited to 'docs/src/gettingstarted/debugging/fsm.md')
-rw-r--r--docs/src/gettingstarted/debugging/fsm.md6
1 files changed, 4 insertions, 2 deletions
diff --git a/docs/src/gettingstarted/debugging/fsm.md b/docs/src/gettingstarted/debugging/fsm.md
index 65ff031..08022cb 100644
--- a/docs/src/gettingstarted/debugging/fsm.md
+++ b/docs/src/gettingstarted/debugging/fsm.md
@@ -1,16 +1,18 @@
# Finite State Machine
-The eduvpn-common library uses a Finite State Machine internally to keep track of which state the client is in and to communicate data callbacks(e.g. to communicate the Authorization URL in the OAuth process to the client).
+The eduvpn-common library uses a Finite State Machine internally to keep track of which state the client is in and to communicate data callbacks (e.g. to communicate the Authorization URL in the OAuth process to the client).
## Viewing the FSM
To view the FSM in an image, set the debug variable to `True`. This outputs the graph with a `.graph` extension in the client-specified config directory (See [API](../../api/index.html)). The format of this graph is from [Mermaid](https://mermaid-js.github.io/mermaid/#/).
If you have the [Mermaid command line client](https://github.com/mermaid-js/mermaid-cli) installed, the Go library will automatically provide a PNG file in the same directory of the `.graph` file. We recommend to use an image viewer that has auto-reload capabilities, such as [feh](https://feh.finalrewind.org/)[^1] for Linux.
+If you do not want to install additional tools to view the graph, you can submit the contents of the `.graph` file to the [Mermaid Live Editor](https://mermaid.live/) to see the image.
+
## FSM Example
The following is an example of the FSM when the client has obtained a Wireguard/OpenVPN configuration from an eduVPN server
-![](./fsm_example.png)
+![](./fsm_example.svg)
The current state is highlighted in the <span style="color:cyan">cyan</span> color.