update readme

This commit is contained in:
Dominic Breuker
2018-02-13 22:54:25 +01:00
parent 5892969b03
commit f4adb1324d
2 changed files with 69 additions and 1 deletions

View File

@@ -1,4 +1,6 @@
# pspy - monitor Linux processes without root permissions
<img src="images/logo.svg" align="left" />
# pspy - process monitoring without root
pspy is a command line tool allowing you to snoop on Linux processes without being root.
It can help you to find and analyse cron jobs or other background processes that would otherwise be hidden from you (e.g., a cron job in `/var/spool/cron/root`).
@@ -9,6 +11,11 @@ Inotify events are used as a trigger for `/proc` scanning to not miss short-live
Get the tool onto the machine you want to inspect.
You can choose between the 32 and 64 bit version.
Files are in the `/bin` folder of this repository.
- 32 bit version: [download](bin/pspy32)
- 64 bit version: [download](bin/pspy64)
All files are statically compiled and should run without any libraries.
It will only work on Linux.
No other OS is supported as the project relies on Linux kernel features.
@@ -61,3 +68,7 @@ In general, the longer the processes run, the bigger the chance of catching them
Besides using the events, pspy will also scan `/proc` every 100ms, just to be sure.
My initial experiments suggest the CPU usage is quite low for this value.
Making the interval configurable is on the roadmap.
# Misc
Logo: "By Creative Tail [CC BY 4.0 (http://creativecommons.org/licenses/by/4.0)], via Wikimedia Commons"

57
images/logo.svg Normal file
View File

@@ -0,0 +1,57 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- Generator: Adobe Illustrator 15.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0) -->
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
width="128px" height="128px" viewBox="0 0 128 128" style="enable-background:new 0 0 128 128;" xml:space="preserve">
<g>
<ellipse style="fill:#C2D5D8;" cx="64" cy="68" rx="64" ry="60"/>
<g>
<g>
<defs>
<path id="SVGID_1_" d="M88,12.378V0H38v13.177C15.615,22.521,0,43.545,0,68c0,33.137,28.654,60,64,60s64-26.863,64-60
C128,42.822,111.45,21.281,88,12.378z"/>
</defs>
<clipPath id="SVGID_2_">
<use xlink:href="#SVGID_1_" style="overflow:visible;"/>
</clipPath>
<g style="clip-path:url(#SVGID_2_);">
<rect x="50.938" y="101.563" style="fill:#CCCCCC;" width="27.438" height="22.625"/>
<polygon style="fill:#F5F5F5;" points="76.01,94.424 63.953,93 51.896,94.424 46.438,97.875 56.344,111.875 64,104
71.563,111.875 81.469,97.875 "/>
<path style="fill:#E6CBC3;" d="M76.371,95.563h0.005l-3.423-10.646l-9-0.666l-9,0.666L51.53,95.563h0.005
c-0.051,0.146-0.082,0.295-0.082,0.443c0,2.206,5.597,3.993,12.5,3.993s12.5-1.787,12.5-3.993
C76.453,95.857,76.422,95.709,76.371,95.563z"/>
<path style="fill:#D9BFB8;" d="M76.371,95.563h0.005l-3.423-10.646l-9-0.666l-1.75,0.129l7.25,0.537l3.423,10.646h-0.005
c0.051,0.146,0.082,0.295,0.082,0.443c0,2.016-4.678,3.677-10.75,3.95c0.573,0.025,1.154,0.043,1.75,0.043
c6.903,0,12.5-1.787,12.5-3.993C76.453,95.857,76.422,95.709,76.371,95.563z"/>
<path style="fill:#FFE1D9;" d="M89.953,42L90,34c0-8.113-10-17-26.047-17C48,17,38,25.887,38,34l-0.047,8c0,0-4,0.295-4,3
v11.068c0,2.705,1,4.932,4,4.932c0,13.522,12.022,29,26,29c13.977,0,26-15.478,26-29c3,0,4-2.227,4-4.932V45
C93.953,42.295,89.953,42,89.953,42z"/>
<path style="fill:#F2D6CE;" d="M63.953,17c-0.512,0-1.007,0.007-1.5,0.016c19.012,0.316,24.5,6.674,24.5,14.582V42v19
c0,13.035-11.175,27.883-24.5,28.936C62.951,89.975,63.45,90,63.953,90c13.977,0,26-15.478,26-29V42v-5
C89.953,28.887,84.183,17,63.953,17z"/>
<g>
<polygon style="fill:#1A1A1A;" points="46.438,97.875 64,123 64,136 15.25,136.125 21.25,105.375 "/>
<polygon style="fill:#242424;" points="51.943,94.674 39.297,101.813 48.797,104.25 44.213,113.125 64,133 64,123 "/>
</g>
<g>
<polygon style="fill:#1A1A1A;" points="81.469,97.875 64,123 64,136 112.656,136.125 106.656,105.375 "/>
<polygon style="fill:#242424;" points="76.01,94.424 88.656,101.563 79.156,104 83.74,112.875 64,133 64,123 "/>
</g>
<path style="fill:#242424;" d="M90.627,40.162L89,39l-3.589,8.023c-0.757-0.892-2.163-1.596-3.723-1.741
c-4.471-0.421-6.833-0.564-11.305-0.699c-2.305-0.069-4.385,1.427-4.385,3.259c0,0.66,0,1.217,0,1.739h-4
c0-0.522,0-1.079,0-1.739c0-1.832-2.127-3.328-4.432-3.259c-4.472,0.135-6.812,0.278-11.28,0.699
c-1.628,0.153-3.079,0.913-3.801,1.86L38.813,39l-1.627,1.162l4.813,9.738c0,0.938,0,1.738,0,2.94
c0,1.47,1.859,2.894,4.165,3.11c4.47,0.42,6.944,0.564,11.415,0.699c2.305,0.068,4.42-1.428,4.42-3.26c0-0.689,0-1.269,0-1.812
h4c0,0.543,0,1.121,0,1.812c0,1.832,2.092,3.328,4.396,3.26c4.472-0.135,6.923-0.279,11.393-0.699
c2.307-0.217,4.212-1.643,4.212-3.11c0-1.313,0-2.143,0-3.202L90.627,40.162z"/>
<path style="fill:#242424;" d="M90,34c0-8.813-5.438-34-12-34S66.442,6,64,6s-7.438-6-14-6S38,25.188,38,34
c-1.109,0-3.583,2.583-6,5c4.917,4.917,27.131,5,32,5s27.083-0.083,32-5C93.583,36.583,91.109,34,90,34z"/>
<path style="fill:#F5F5F5;" d="M64,28c-3.579,0-16.525-0.048-25.09-2.023c-0.563,2.935-0.883,5.66-0.905,7.778
C46.531,35.949,60.292,36,64,36s17.469-0.051,25.995-2.245c-0.022-2.118-0.343-4.845-0.905-7.778C80.525,27.952,67.579,28,64,28
z"/>
</g>
</g>
</g>
</g>
</svg>

After

Width:  |  Height:  |  Size: 3.9 KiB