|
@@ -1,5 +1,5 @@
|
1
|
|
-GMON
|
2
|
|
-====
|
|
1
|
+SARDINE
|
|
2
|
+=======
|
3
|
3
|
|
4
|
4
|
Generic plugin-based monitor, mainly for use with Xfce genmon
|
5
|
5
|
|
|
@@ -9,13 +9,13 @@ Generic plugin-based monitor, mainly for use with Xfce genmon.
|
9
|
9
|
SYNOPSIS
|
10
|
10
|
--------
|
11
|
11
|
|
12
|
|
- gmon [options] command [args...]
|
|
12
|
+ sardine [options] command [args...]
|
13
|
13
|
|
14
|
14
|
|
15
|
15
|
DESCRIPTION
|
16
|
16
|
-----------
|
17
|
17
|
|
18
|
|
-gmon is a plugin-based "pretty-printer" that allows adding own sub-commands
|
|
18
|
+sardine is a plugin-based "pretty-printer" that allows adding own sub-commands
|
19
|
19
|
and use them with common interface.
|
20
|
20
|
|
21
|
21
|
Typical use case is when you have a space where only limited number of characters
|
|
@@ -27,7 +27,7 @@ Apart from that, the plugin can define other modes of output that might suit
|
27
|
27
|
other targets better. For example, genmon Xfce plugin is able to periodically
|
28
|
28
|
display output of a command in desktop panel. Apart from displaying simple
|
29
|
29
|
string, it can parse XML-like content and use it to display tooltip or an icon.
|
30
|
|
-You could implement mode in your plugin for this target, and use gmon both for
|
|
30
|
+You could implement mode in your plugin for this target, and use sardine both for
|
31
|
31
|
your Xfce panel and your terminal in a consistent manner.
|
32
|
32
|
|
33
|
33
|
|
|
@@ -65,22 +65,22 @@ of basic concept or as examples of how to implement your own plugin.
|
65
|
65
|
This one takes first argument as a command name and runs it as a new process,
|
66
|
66
|
passing the rest of arguments to it untouched:
|
67
|
67
|
|
68
|
|
- $ gmon sh uname -a
|
|
68
|
+ $ sardine sh uname -a
|
69
|
69
|
Linux fullmoon.brq.redhat.com 3.13.6-...
|
70
|
|
- $ gmon sh who
|
|
70
|
+ $ sardine sh who
|
71
|
71
|
somebody tty1 2014-03-28 19:...
|
72
|
72
|
|
73
|
73
|
Note that arguments are untouched, so things like wildcards/glubs will not
|
74
|
|
-work (unless the shell where you type the `gmon` command expands them).
|
|
74
|
+work (unless the shell where you type the `sardine` command expands them).
|
75
|
75
|
|
76
|
76
|
|
77
|
77
|
### echo ###
|
78
|
78
|
|
79
|
79
|
Connects the arguments and prints them:
|
80
|
80
|
|
81
|
|
- $ gmon echo hello
|
|
81
|
+ $ sardine echo hello
|
82
|
82
|
hello
|
83
|
|
- $ gmon echo "one two" "three"
|
|
83
|
+ $ sardine echo "one two" "three"
|
84
|
84
|
one twothree
|
85
|
85
|
|
86
|
86
|
|
|
@@ -88,9 +88,9 @@ Connects the arguments and prints them:
|
88
|
88
|
|
89
|
89
|
Dumps the arguments as Python sees them (using repr() builtin)
|
90
|
90
|
|
91
|
|
- $ gmon dump "one two" "three"
|
|
91
|
+ $ sardine dump "one two" "three"
|
92
|
92
|
args = ['one two', 'three']
|
93
|
|
- $ gmon dump uname -a
|
|
93
|
+ $ sardine dump uname -a
|
94
|
94
|
args = ['uname', '-a']
|
95
|
95
|
|
96
|
96
|
|
|
@@ -100,20 +100,20 @@ FILES
|
100
|
100
|
*plugins*
|
101
|
101
|
folder where plugins are stored
|
102
|
102
|
|
103
|
|
-*/etc/gmon/config*
|
|
103
|
+*/etc/sardine/config*
|
104
|
104
|
system-wide configuration file
|
105
|
105
|
|
106
|
|
-*~/.config/gmon/config*
|
|
106
|
+*~/.config/sardine/config*
|
107
|
107
|
user's personal config
|
108
|
108
|
|
109
|
|
-*~/.local/share/gmon/plugins/<plugin_name>*
|
|
109
|
+*~/.local/share/sardine/plugins/<plugin_name>*
|
110
|
110
|
plugin local storage (if needed)
|
111
|
111
|
|
112
|
112
|
|
113
|
113
|
ENVIRONMENT
|
114
|
114
|
-----------
|
115
|
115
|
|
116
|
|
-`GMON_PLUGINS`
|
|
116
|
+`SARDINE_PLUGINS`
|
117
|
117
|
Alternate folder for plugins
|
118
|
118
|
|
119
|
119
|
|