abc71a46ad
This commit represents a complete redesign of the stat interface. Gone are the confusing 8 separate accessors along with their 2 additional read functions. In their place we have just 3 accessors, with no read required. That old interface also suffered an inflexibility with respect to structures. Now we deal with an unchanging standard 'result' struct enabling future changes where the binary interface will no longer need to be broken. And gone is that former unnecessary typedef, used when dealing with jiffies. Now the standard C type is used. Our new API also adds some brand new functionality. If a caller plans to employ successive 'select' or 'reap' invocations, then delta values are available (which is actually only what that top program is interested in). At some future point a 'sort' function could be easily introduced to complement the 'reap' function. However, I saw no need for it at present and so it was omitted. There were several design decisions which everyone may not agree with. In support I'll offer these rationals: . The 'get' function returns a signed long long result which means a potential loss of some significance. But I felt the ability to distinguish actual errors (minus values) from true zero results were worth such a risk. . The DELTA item enumerators were also made signed and smaller than their parents. And they are intentionally grouped as last so as to emphasize those distinctions. . The SYS type items were excluded from the new 'reap' function. It would not make sense to duplicate them in each results stack. They're limited to 'get'/'select'. . By the same token, some items (DELTA, etc.) will not be allowed under that 'get' routine. That function was already open to significant internal overhead (through subsequent calls like in vmstat.c). That is why it has been limited via 1 second between reads of /proc/stat. Lastly, when we finally get around to documenting this interface there's a real potential toe stubber when it comes to the numa node portion. The libnuma.so doesn't really provide any means to retrieve the active nodes. Thus, any total reported by <stat> is just the highest node number plus one, as reported by the numa library. Any unused/inactive nodes are identified through these . PROCPS_STAT_TIC_ID shows as PROCPS_STAT_NODE_INVALID By the same token after the STAT_REAP_CPUS_ONLY 'reap' . PROCPS_STAT_TIC_NUMA_NODE = PROCPS_STAT_NODE_INVALID Reference(s): http://www.freelists.org/post/procps/newlib-stat-interface Signed-off-by: Jim Warner <james.warner@comcast.net>
73 lines
1.5 KiB
Plaintext
73 lines
1.5 KiB
Plaintext
LIBPROCPS_0 {
|
|
global:
|
|
escape_str;
|
|
fatal_proc_unmounted;
|
|
procps_cpu_count;
|
|
procps_diskstat_dev_count;
|
|
procps_diskstat_dev_get;
|
|
procps_diskstat_dev_getbyname;
|
|
procps_diskstat_dev_getname;
|
|
procps_diskstat_dev_isdisk;
|
|
procps_diskstat_new;
|
|
procps_diskstat_read;
|
|
procps_diskstat_ref;
|
|
procps_diskstat_unref;
|
|
procps_hertz_get;
|
|
procps_linux_version;
|
|
procps_loadavg;
|
|
procps_meminfo_new;
|
|
procps_meminfo_read;
|
|
procps_meminfo_ref;
|
|
procps_meminfo_unref;
|
|
procps_meminfo_get;
|
|
procps_meminfo_getstack;
|
|
procps_meminfo_stack_fill;
|
|
procps_meminfo_stack_alloc;
|
|
procps_ns_get_name;
|
|
procps_ns_get_id;
|
|
procps_ns_read_pid;
|
|
procps_pid_length;
|
|
procps_pids_new;
|
|
procps_pids_read_next;
|
|
procps_pids_read_open;
|
|
procps_pids_read_shut;
|
|
procps_pids_reap;
|
|
procps_pids_ref;
|
|
procps_pids_reset;
|
|
procps_pids_select;
|
|
procps_pids_sort;
|
|
procps_pids_unref;
|
|
procps_slabinfo_new;
|
|
procps_slabinfo_read;
|
|
procps_slabinfo_ref;
|
|
procps_slabinfo_unref;
|
|
procps_slabs_get;
|
|
procps_slabs_getstack;
|
|
procps_slabnode_count;
|
|
procps_slabnode_getname;
|
|
procps_slabnode_get;
|
|
procps_slabnode_getstack;
|
|
procps_slabnode_stack_fill;
|
|
procps_slabnode_stack_alloc;
|
|
procps_slabnode_stacks_fill;
|
|
procps_slabnode_stacks_sort;
|
|
procps_slabnode_stacks_alloc;
|
|
procps_stat_new;
|
|
procps_stat_ref;
|
|
procps_stat_unref;
|
|
procps_stat_get;
|
|
procps_stat_reap;
|
|
procps_stat_select;
|
|
procps_uptime;
|
|
procps_uptime_sprint;
|
|
procps_uptime_sprint_short;
|
|
procps_vmstat_new;
|
|
procps_vmstat_read;
|
|
procps_vmstat_ref;
|
|
procps_vmstat_unref;
|
|
procps_vmstat_get;
|
|
procps_vmstat_getstack;
|
|
local:
|
|
*;
|
|
};
|