-
Notifications
You must be signed in to change notification settings - Fork 2
/
README
189 lines (141 loc) · 8.25 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
Tiny Applications Collection
Tiny Applications Collection is a set of small programs, shell scripts
and other things which may be useful in everyday life of system
administrators, users and programmers. They can be also used as a
base for a more specialised application as they are all Open Source.
If you have written utility which may be useful for others and want to
share it please email me at mina86/AT/mina86.com, I'll be glad to add
your utility to the collection.
At the moment the collection includes:
* add - adds specified text to each line from stdin;
* arpping - tool which pings device with given IP using ARP protocol.
It may be used without IP address assigned to our machine,
ie. priori to calling DHCP client or such.
* changelog.pl - application providing global change log for
administrators to fill and users to read. For instance, can be
used in /etc/profile to show all news;
* cdiff (C and sed versions) - adds ANSI codes to the output of diff
making it a bit more readable.
* check.sh - performs a defined checking (whether www.googl.com
responds to pings by default) and runs specified command if failed.
May be used to automatically shut down PC when connection is lost,
try to reconnect, monitor a server machine and send message to it's
admin if it's down, keep given application running and many more;
* checkmail - checks whether mboxes given as arguments contain any
urnead mail;
* cpuload.sh - tiny script showing the CPU load. May be useful for
people interested in how it is calculated (see also load and
traf.sh);
* cutcom - removes C++ comments from stdin and outputs the result to
stdout;
* drun - it's really 'null' with aditional ability to daemonize
(hence the name). Helpful when running X applications from
a terminal.
* errno - a tool for converting between errno error numbers and
symbolic names which also prints error message.
* extractlinks.pl - extracts links from a HTML page. Useful, for
example, when downloading an Internet gallery;
* foreach - a tool for running given command for each of the values
specified on command line. In that, it is almost identical to
plain for loop, but it's strength comes from the possibility to run
many commands at once.
* FvwmTransFocus - an FVWM module which changes windows' opacity
depending on focus. When window looses focus it becomes more
transparent which looks "neet";
* genpass - generates a random strong password. Shell and Perl
versions present;
* getlyrics.pl - downloads lyrics of a given song from the Internet
(http://www.lyrc.com.ar/ actually);
* gz2bz - a shell script which allows converting between compression
formats. It started as gzip -> bzip2 converter but now supports
conversion between compress, gzip, bzip2, xz, lzma and anything
else you specify.
* inplace - a shell script which runs given commmand for all given
files and replace their content with whatever the command returns;
* installkernel - pretty complex script for installing the Linux
kernel. It makes a lot of aspects of upgrading the kernel
automatic. The first versions required bash to run but the now, it
is believed to run on any POSIX compatible platform so it can be
run even on small embeded systems;
* lesspipe - an input processor for less pager which automatically
decompresses compressed files, list contents of archives, list
contents of a directory, download file from the Internet and many
more.
* load - shows CPU load, memory and net traffic statistics. It's
mostly ment for people who are curious how to callculate such
statistics and use some code from the file in their programs (see
also cpuload.sh and traf.sh);
* malloc - a small program which allocates memory. Sounds stupid?
Mayby, but in theory it can help freeing RAM and therefore speeding
up the machine;
* mountiso - a simple mount/umount wrapper for mounting/unmounting
ISO images or any other files using loop option. You have to be
root to use '-o loop' so if you want to mount an ISO image you have
to login as root. This utility should be SUIDed and then anyoune
can use it to mount ISO images. By default it is not included when
installing tinyapps using 'make install' or creating package - you
need to install it by yourself.
* moz2elinks.pl - converts bookmarks from Mozilla's to ELinks'
(http://elinks.or.cz) format;
* mp3rip - a command line utility for ripping tracks from CD Audio.
It uses cdparanoia to rip the tracks and lame to encode them to
MP3s.
* mpd-show - tool meant to display song currently played in MPD. It
displays it in a terminal in one line with background indicating
the progress. It requires libmpdclient.h and libmpdclient.c files
to compile;
* mpd-state - a program based on Avuton Olrich's state-utils for
saving and restoring MPD (Music Player Daemon) state. It requires
libmpdclient.h and libmpdclient.c files to compile;
* mpd-state-wrapper.sh - a small shell script making mpd-state
behaving like Avuton Olrich's state-utils.
* null - a C program (null.c) and a shell script (null.sh) which
discard standard input. It is meant for people who thnik that
'>/dev/null' is too long to type every time. :) It may also be run
with arguments and the given program will be run and both stdout
and stderr will be redirected to /dev/null;
* pingrange.pl - pings a range of addresses;
* pkg - a wrapper for apt-get, yum and Slackware's package management
scripts which "does what you mean" on all of those systems and also
makes the command shorter by automatically running it through
sudo/surun if necessary.
* rand-files.pl - chooses a random set of files, where each file may
have its own rank or probability, read from standard input such
that their size is no greater then given limit. Useful for
choosing random set of songs to copy to our portable player.
* rot13 - performs an ROT13 'encryption' on stdin;
* settitle - sets the title of xterm, rxvt, Eterm, aterm and other
xterm-compatible terminals;
* show - shows colourised (if ccza is available) log file with
possible option of searching for a pattern. Small but handy - you
don't have to write `less /var/log/syslog` anymore and get ugly
black and white log;
* SlackBuild.gen - generates a SlackBuild template. It was not
really debugged yet but I believe that it'll work quit good;
* surun - a wrapper for sudo/su tool (whichever is available) for
running given command as root or launching root shell. It hides
differences between the two command semantics as well as between
running the tool as root or non-root (in the former case, sudo/su
won't be invoked at all).
* timer - a text-mode timer counting with accuracy to 0.01 s;
* tpwd - truncates PWD to specified number of characters. May be
used in PS1 to display only the end of the PWD instead of a full
60-character long PWD which doesn't really look nice;
* traf.sh - tiny script showing traffic statistics. Many things are
hardcoded in the source but it may be useful for future
modifications or to learn how traffic is calculated (see also
cpuload.sh and load);
* tuptime - my personal favourite :) Displays total (sum of all
uptimes) and biggest uptime. Might be used as replacement to
standard uptime utility;
* virtman.sh - adds virtual hosts to Apache configuration for given
user. May be added to some kind of adduser script for automagical
addition of virtual hosts.
* xcolor2rgb - reads from argument list (or from stdin, if no
arguments are given) and prints appropriate RGB value to stdout.
* xgetclass - prints window's application name and class as returned
by XGetClassHint. May be used in some kind of shell scripts but
honestly I just wrote it to test XGetClassHint function and since
I did it I decided to include it in tinyapps. :)
More documentation about each utility is usually provided in the
source code.