/usr/include/clplumbing/cpulimits.h is in libplumb2-dev 1.0.11+hg2754-1.1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | /*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
/*
* Functions to put limits on CPU consumption.
* This allows us to better catch runaway realtime processes that
* might otherwise hang the whole system.
*
* The process is basically this:
* - Set the CPU percentage limit with cl_cpu_limit_setpercent()
* according to what you expect the CPU percentage to top out at
* measured over an interval at >= 10 seconds
* - Call cl_cpu_limit_ms_interval() to figure out how often to update
* the CPU limit (it returns milliseconds)
* - At least as often as indicated above, call cl_cpu_limit_update()
* to update our current CPU limit.
*
* These limits are approximate, so be a little conservative.
* If you've gone into an infinite loop, it'll likely get caught ;-)
*
* Note that exceeding the soft CPU limits we set here will cause a
* SIGXCPU signal to be sent.
*
* The default action for this signal is to cause a core dump.
* This is a good choice ;-)
*
* As of this writing, this code will never set the soft CPU limit less
* than two seconds, or greater than 10 seconds.
*
* It will currrently return a limit update interval between 10000 and
* 400000 milliseconds.
*
*/
/*
* Set expected CPU percentage upper bound
*/
int cl_cpu_limit_setpercent(int ipercent);
/*
* Update the current CPU limit
*/
int cl_cpu_limit_update(void);
/*
* How often should we call cl_cpu_limit_update()?
*
* Note: return result is in milliseconds
*/
int cl_cpu_limit_ms_interval(void);
/* Disable further CPU limits... */
int cl_cpu_limit_disable(void);
|