[svn-upgrade] Integrating new upstream version, cpulimit (1.12~svn10)
[debian/cpulimit.git] / README
1 Cpulimit 1.2
2
3 =======
4 About:
5 =======
6
7 Cpulimit is a program that attempts to limit the cpu usage of a process (expressed in percentage, not in cpu time). This is useful to control batch jobs, when you don't want they eat too much cpu. It does not act on the nice value or other scheduling priority stuff, but on the real cpu usage. Also, it is able to adapt itself to the overall system load, dynamically and quickly.
8 The control of the used cpu amount is done sending continue and stop POSIX signals to processes.
9 All the children processes and threads of the specified process will share the same percent of cpu.
10
11 Developed by Angelo Marletta.
12 Please send your feedback, bug reports, feature requests to marlonx80 at hotmail dot com.
13
14 ===========
15 Changelog:
16 ===========
17
18 - reorganization of the code, splitted in more source files
19 - control function process_monitor() optimized by eliminating an unnecessary loop
20 - experimental support for multiple control of children processes and threads
21   children detection algorithm seems heavy because of the amount of code,
22   but it's designed to be scalable when there are a lot of children processes
23 - cpu count detection, i.e. if you have 4 cpu, it is possible to limit up to 400%
24 - in order to avoid deadlock, cpulimit prevents to limit itself
25 - option --path eliminated, use --exe instead both for absolute path and file name
26 - deleted every setpriority(), (todo: set it just once)
27 - minor enhancements and bugfixes
28
29
30 ============================
31 Get the latest source code:
32 ============================
33
34 You can checkout the latest code from sourceforge Subversion repository, running:
35
36 svn checkout https://cpulimit.svn.sourceforge.net/svnroot/cpulimit cpulimit
37
38 Of course this is the development version, so you may experience bugs (please signal them!)
39
40
41 ==============
42 Installation:
43 ==============
44
45 Run 'make' and place the executable file 'cpulimit' wherever you want.
46 Type 'cpulimit --help' to get documentation on available options.
47