From 46774daf9d3e0612df8f79d4b6b724e612ceb725 Mon Sep 17 00:00:00 2001
From: Kelly Brazil <kellyjonbrazil@gmail.com>
Date: Tue, 12 Nov 2019 18:51:21 -0800
Subject: [PATCH] doc update

---
 README.md        |  68 +++++++++++++++++++++++++
 jc/parsers/ss.py | 130 +++++++++++++++++++++++++++++++++++++++++++++--
 2 files changed, 194 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 6a5abba2..dbbb2aa3 100755
--- a/README.md
+++ b/README.md
@@ -82,6 +82,7 @@ jc PARSER [OPTIONS]
 - `--netstat` enables the `netstat` parser
 - `--ps` enables the `ps` parser
 - `--route` enables the `route` parser
+- `--ss` enables the `ss` parser
 - `--uname` enables the `uname -a` parser
 - `--uptime` enables the `uptime` parser
 - `--w` enables the `w` parser
@@ -1022,6 +1023,73 @@ $ route -ee | jc --route -p
   }
 ]
 ```
+### ss
+```
+$ sudo ss -a | jc --ss -p
+[
+  {
+    "netid": "nl",
+    "state": "UNCONN",
+    "recv_q": 0,
+    "send_q": 0,
+    "local_address": "rtnl",
+    "local_port": "kernel",
+    "peer_address": "*"
+  },
+  {
+    "netid": "nl",
+    "state": "UNCONN",
+    "recv_q": 0,
+    "send_q": 0,
+    "local_address": "rtnl",
+    "local_port": "systemd-resolve/893",
+    "peer_address": "*"
+  },
+  {
+    "netid": "nl",
+    "state": "UNCONN",
+    "recv_q": 0,
+    "send_q": 0,
+    "local_address": "rtnl",
+    "local_port": "systemd/1",
+    "peer_address": "*"
+  },
+  ...
+  {
+    "netid": "tcp",
+    "state": "LISTEN",
+    "recv_q": 0,
+    "send_q": 128,
+    "local_address": "127.0.0.1",
+    "local_port": "35485",
+    "peer_address": "0.0.0.0",
+    "peer_port": "*",
+    "interface": "lo"
+  },
+  {
+    "netid": "tcp",
+    "state": "LISTEN",
+    "recv_q": 0,
+    "send_q": 128,
+    "local_address": "[::]",
+    "local_port": "ssh",
+    "peer_address": "[::]",
+    "peer_port": "*"
+  },
+  {
+    "netid": "v_str",
+    "state": "ESTAB",
+    "recv_q": 0,
+    "send_q": 0,
+    "local_address": "999900439",
+    "local_port": "1023",
+    "peer_address": "0",
+    "peer_port": "976",
+    "local_port_num": 1023,
+    "peer_port_num": 976
+  }
+]
+```
 ### uname -a
 ```
 $ uname -a | jc --uname -p
diff --git a/jc/parsers/ss.py b/jc/parsers/ss.py
index 123c88d1..534b0f3a 100644
--- a/jc/parsers/ss.py
+++ b/jc/parsers/ss.py
@@ -5,11 +5,133 @@ Usage:
 
 Examples:
 
-    $ ss | jc --ss -p
-    []
+      $ sudo ss -a | jc --ss -p
+      [
+        {
+          "netid": "nl",
+          "state": "UNCONN",
+          "recv_q": 0,
+          "send_q": 0,
+          "local_address": "rtnl",
+          "local_port": "kernel",
+          "peer_address": "*"
+        },
+        {
+          "netid": "nl",
+          "state": "UNCONN",
+          "recv_q": 0,
+          "send_q": 0,
+          "local_address": "rtnl",
+          "local_port": "systemd-resolve/893",
+          "peer_address": "*"
+        },
+        {
+          "netid": "nl",
+          "state": "UNCONN",
+          "recv_q": 0,
+          "send_q": 0,
+          "local_address": "rtnl",
+          "local_port": "systemd/1",
+          "peer_address": "*"
+        },
+        ...
+        {
+          "netid": "tcp",
+          "state": "LISTEN",
+          "recv_q": 0,
+          "send_q": 128,
+          "local_address": "127.0.0.1",
+          "local_port": "35485",
+          "peer_address": "0.0.0.0",
+          "peer_port": "*",
+          "interface": "lo"
+        },
+        {
+          "netid": "tcp",
+          "state": "LISTEN",
+          "recv_q": 0,
+          "send_q": 128,
+          "local_address": "[::]",
+          "local_port": "ssh",
+          "peer_address": "[::]",
+          "peer_port": "*"
+        },
+        {
+          "netid": "v_str",
+          "state": "ESTAB",
+          "recv_q": 0,
+          "send_q": 0,
+          "local_address": "999900439",
+          "local_port": "1023",
+          "peer_address": "0",
+          "peer_port": "976",
+          "local_port_num": 1023,
+          "peer_port_num": 976
+        }
+      ]
 
-    $ ss | jc --ss -p -r
-    []
+      $ sudo ss -a | jc --ss -p -r
+      [
+        {
+          "netid": "nl",
+          "state": "UNCONN",
+          "recv_q": "0",
+          "send_q": "0",
+          "local_address": "rtnl",
+          "local_port": "kernel",
+          "peer_address": "*"
+        },
+        {
+          "netid": "nl",
+          "state": "UNCONN",
+          "recv_q": "0",
+          "send_q": "0",
+          "local_address": "rtnl",
+          "local_port": "systemd-resolve/893",
+          "peer_address": "*"
+        },
+        {
+          "netid": "nl",
+          "state": "UNCONN",
+          "recv_q": "0",
+          "send_q": "0",
+          "local_address": "rtnl",
+          "local_port": "systemd/1",
+          "peer_address": "*"
+        },
+        ...
+        {
+          "netid": "tcp",
+          "state": "LISTEN",
+          "recv_q": "0",
+          "send_q": "128",
+          "local_address": "127.0.0.1",
+          "local_port": "35485",
+          "peer_address": "0.0.0.0",
+          "peer_port": "*",
+          "interface": "lo"
+        },
+        {
+          "netid": "tcp",
+          "state": "LISTEN",
+          "recv_q": "0",
+          "send_q": "128",
+          "local_address": "[::]",
+          "local_port": "ssh",
+          "peer_address": "[::]",
+          "peer_port": "*"
+        },
+        {
+          "netid": "v_str",
+          "state": "ESTAB",
+          "recv_q": "0",
+          "send_q": "0",
+          "local_address": "999900439",
+          "local_port": "1023",
+          "peer_address": "0",
+          "peer_port": "976"
+        }
+      ]
 """
 import string
 import jc.utils