From 29c47c03a64f9c6b0f44d34be5449396654849b5 Mon Sep 17 00:00:00 2001
From: Kelly Brazil <kellyjonbrazil@gmail.com>
Date: Wed, 23 Oct 2019 17:37:25 -0700
Subject: [PATCH] documentation update

---
 README.md          | 68 ++++++++++++++++++++++++++++++++++++++++++++++
 changelog.txt      |  3 +-
 jc/parsers/lsof.py | 65 +++++++++++++++++++++++++++++++++++++++++++-
 3 files changed, 134 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index df9a2fd4..8914fe92 100755
--- a/README.md
+++ b/README.md
@@ -68,6 +68,7 @@ jc [parser] [options]
 - `--jobs` enables the `jobs` parser
 - `--ls` enables the `ls` parser
 - `--lsblk` enables the `lsblk` parser
+- `--lsof` enables the `lsof` parser
 - `--mount` enables the `mount` parser
 - `--netstat` enables the `netstat` parser
 - `--ps` enables the `ps` parser
@@ -670,6 +671,73 @@ $ lsblk | jc --lsblk -p
   }
 ]
 ```
+### lsof
+```
+$ sudo lsof | jc --lsof -p
+[
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "cwd",
+    "TYPE": "DIR",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "224",
+    "NODE": "64",
+    "NAME": "/"
+  },
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "rtd",
+    "TYPE": "DIR",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "224",
+    "NODE": "64",
+    "NAME": "/"
+  },
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "txt",
+    "TYPE": "REG",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "1624520",
+    "NODE": "50360451",
+    "NAME": "/usr/lib/systemd/systemd"
+  },
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "mem",
+    "TYPE": "REG",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "20064",
+    "NODE": "8146",
+    "NAME": "/usr/lib64/libuuid.so.1.3.0"
+  },
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "mem",
+    "TYPE": "REG",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "265600",
+    "NODE": "8147",
+    "NAME": "/usr/lib64/libblkid.so.1.1.0"
+  },
+  ...
+]
+```
 ### mount
 ```
 $ mount | jc --mount -p
diff --git a/changelog.txt b/changelog.txt
index 89a2ca63..19881397 100644
--- a/changelog.txt
+++ b/changelog.txt
@@ -1,9 +1,10 @@
 jc changelog
 
 2019xxxx v0.9.0
+- Add jobs parser
+- Add lsof parser
 - No blocking if no piped data
 - Better help text
-- Add jobs parser
 - Clean up iptables parser code
 
 20191022 v0.8.1
diff --git a/jc/parsers/lsof.py b/jc/parsers/lsof.py
index 04dccb78..ea26d757 100644
--- a/jc/parsers/lsof.py
+++ b/jc/parsers/lsof.py
@@ -8,7 +8,70 @@ Usage:
 
 Example:
 
-
+$ sudo lsof | jc --lsof -p
+[
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "cwd",
+    "TYPE": "DIR",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "224",
+    "NODE": "64",
+    "NAME": "/"
+  },
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "rtd",
+    "TYPE": "DIR",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "224",
+    "NODE": "64",
+    "NAME": "/"
+  },
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "txt",
+    "TYPE": "REG",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "1624520",
+    "NODE": "50360451",
+    "NAME": "/usr/lib/systemd/systemd"
+  },
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "mem",
+    "TYPE": "REG",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "20064",
+    "NODE": "8146",
+    "NAME": "/usr/lib64/libuuid.so.1.3.0"
+  },
+  {
+    "COMMAND": "systemd",
+    "PID": "1",
+    "TID": null,
+    "USER": "root",
+    "FD": "mem",
+    "TYPE": "REG",
+    "DEVICE": "253,0",
+    "SIZE/OFF": "265600",
+    "NODE": "8147",
+    "NAME": "/usr/lib64/libblkid.so.1.1.0"
+  },
+  ...
+]
 """