From 05b54a6141e870aeaa428cf77b9412834f40f123 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20Ekl=C3=B6f?= <daniel@ekloef.se>
Date: Mon, 22 Apr 2019 12:07:44 +0200
Subject: [PATCH] doc: network

---
 doc/f00bar-modules.5.scd | 58 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)

diff --git a/doc/f00bar-modules.5.scd b/doc/f00bar-modules.5.scd
index bc3e1fd..f87a6e5 100644
--- a/doc/f00bar-modules.5.scd
+++ b/doc/f00bar-modules.5.scd
@@ -406,6 +406,64 @@ bar:
           string: {text: "{artist} - {album} - {title} ({end})"}
 ```
 
+# NETWORK
+
+This module monitors network connection state; disconnected/connected
+state and MAC/IP addresses.
+
+Note: while the module internally tracks all assigned IPv4/IPv6
+addresses, it currently exposes only a single IPv4 and a single IPv6
+address.
+
+## TAGS
+
+[[ *Name*
+:[ *Type*
+:[ *Description*
+|  name
+:  string
+:  Network interface name
+|  index
+:  int
+:  Network interface index
+|  carrier
+:  bool
+:  True if the interface has CARRIER. That is, if it is physically connected.
+|  state
+:  string
+:  One of *unknown*, *not present*, *down*, *lower layers down*,
+   *testing*, *dormant* or *up*. You are probably interrested in *down* and *up*.
+|  mac
+:  string
+:  MAC address
+|  ipv4
+:  string
+:  IPv4 address assigned to the interface, or *""* if none
+|  ipv6
+:  string
+:  IPv6 address assigned to the interface, or *""* if none
+
+## CONFIGURATION
+
+[[ *Name*
+:[ *Type*
+:[ *Req*
+:[ *Description*
+|  name
+:  string
+:  Name of network interface to monitor
+
+## EXAMPLES
+
+```
+bar:
+  left:
+    - network:
+        name: wlp3s0
+        content:
+          string: {text: "{name}: {state} ({ipv4})"}
+```
+
 # SEE ALSO
 
 *f00bar-particles*(5), *f00bar-tags*(5), *f00bar-decorations*(5)