30997b967a
Shoot, here's yet another bow to ps needs. But it's ok because it makes a lot of sense. Rather than force all users into their own calculations do but it once here. As an aside this need arose during ps testing when the sorts were using TIME_START or TICS_ALL. That was just fine for almost every need except 'etime' plus 'time'. That 'etime' was sorting the opposite of what's wanted when using TIME_START (of course) while 'time' yielded some weird ordering because TICS_ALL was too granular. Signed-off-by: Jim Warner <james.warner@comcast.net>
259 lines
8.8 KiB
C
259 lines
8.8 KiB
C
/*
|
|
* pids.h - task/thread/process related declarations for libproc
|
|
*
|
|
* Copyright (C) 1998-2005 Albert Cahalan
|
|
* Copyright (C) 2015 Craig Small <csmall@enc.com.au>
|
|
* Copyright (C) 2015 Jim Warner <james.warner@comcast.net>
|
|
*
|
|
* 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 Street, Fifth Floor, Boston, MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef _PROC_PIDS_H
|
|
#define _PROC_PIDS_H
|
|
|
|
__BEGIN_DECLS
|
|
|
|
enum pids_item {
|
|
PROCPS_PIDS_ADDR_END_CODE, // ul_int
|
|
PROCPS_PIDS_ADDR_KSTK_EIP, // ul_int
|
|
PROCPS_PIDS_ADDR_KSTK_ESP, // ul_int
|
|
PROCPS_PIDS_ADDR_START_CODE, // ul_int
|
|
PROCPS_PIDS_ADDR_START_STACK, // ul_int
|
|
PROCPS_PIDS_ALARM, // sl_int
|
|
PROCPS_PIDS_CGROUP, // str
|
|
PROCPS_PIDS_CGROUP_V, // strv
|
|
PROCPS_PIDS_CMD, // str
|
|
PROCPS_PIDS_CMDLINE, // str
|
|
PROCPS_PIDS_CMDLINE_V, // strv
|
|
PROCPS_PIDS_ENVIRON, // str
|
|
PROCPS_PIDS_ENVIRON_V, // strv
|
|
PROCPS_PIDS_EXIT_SIGNAL, // s_int
|
|
PROCPS_PIDS_FLAGS, // ul_int
|
|
PROCPS_PIDS_FLT_MAJ, // ul_int
|
|
PROCPS_PIDS_FLT_MAJ_C, // ul_int
|
|
PROCPS_PIDS_FLT_MAJ_DELTA, // ul_int
|
|
PROCPS_PIDS_FLT_MIN, // ul_int
|
|
PROCPS_PIDS_FLT_MIN_C, // ul_int
|
|
PROCPS_PIDS_FLT_MIN_DELTA, // ul_int
|
|
PROCPS_PIDS_ID_EGID, // u_int
|
|
PROCPS_PIDS_ID_EGROUP, // str
|
|
PROCPS_PIDS_ID_EUID, // u_int
|
|
PROCPS_PIDS_ID_EUSER, // str
|
|
PROCPS_PIDS_ID_FGID, // u_int
|
|
PROCPS_PIDS_ID_FGROUP, // str
|
|
PROCPS_PIDS_ID_FUID, // u_int
|
|
PROCPS_PIDS_ID_FUSER, // str
|
|
PROCPS_PIDS_ID_PGRP, // s_int
|
|
PROCPS_PIDS_ID_PID, // s_int
|
|
PROCPS_PIDS_ID_PPID, // s_int
|
|
PROCPS_PIDS_ID_RGID, // u_int
|
|
PROCPS_PIDS_ID_RGROUP, // str
|
|
PROCPS_PIDS_ID_RUID, // u_int
|
|
PROCPS_PIDS_ID_RUSER, // str
|
|
PROCPS_PIDS_ID_SESSION, // s_int
|
|
PROCPS_PIDS_ID_SGID, // u_int
|
|
PROCPS_PIDS_ID_SGROUP, // str
|
|
PROCPS_PIDS_ID_SUID, // u_int
|
|
PROCPS_PIDS_ID_SUSER, // str
|
|
PROCPS_PIDS_ID_TGID, // s_int
|
|
PROCPS_PIDS_ID_TPGID, // s_int
|
|
PROCPS_PIDS_LXCNAME, // str
|
|
PROCPS_PIDS_MEM_CODE, // sl_int
|
|
PROCPS_PIDS_MEM_CODE_KIB, // ul_int
|
|
PROCPS_PIDS_MEM_DATA, // sl_int
|
|
PROCPS_PIDS_MEM_DATA_KIB, // ul_int
|
|
PROCPS_PIDS_MEM_DT, // sl_int
|
|
PROCPS_PIDS_MEM_LRS, // sl_int
|
|
PROCPS_PIDS_MEM_RES, // sl_int
|
|
PROCPS_PIDS_MEM_RES_KIB, // ul_int
|
|
PROCPS_PIDS_MEM_SHR, // sl_int
|
|
PROCPS_PIDS_MEM_SHR_KIB, // ul_int
|
|
PROCPS_PIDS_MEM_VIRT, // sl_int
|
|
PROCPS_PIDS_MEM_VIRT_KIB, // ul_int
|
|
PROCPS_PIDS_NICE, // sl_int
|
|
PROCPS_PIDS_NLWP, // s_int
|
|
PROCPS_PIDS_NS_IPC, // ul_int
|
|
PROCPS_PIDS_NS_MNT, // ul_int
|
|
PROCPS_PIDS_NS_NET, // ul_int
|
|
PROCPS_PIDS_NS_PID, // ul_int
|
|
PROCPS_PIDS_NS_USER, // ul_int
|
|
PROCPS_PIDS_NS_UTS, // ul_int
|
|
PROCPS_PIDS_OOM_ADJ, // s_int
|
|
PROCPS_PIDS_OOM_SCORE, // s_int
|
|
PROCPS_PIDS_PRIORITY, // s_int
|
|
PROCPS_PIDS_PROCESSOR, // u_int
|
|
PROCPS_PIDS_RSS, // sl_int
|
|
PROCPS_PIDS_RSS_RLIM, // ul_int
|
|
PROCPS_PIDS_RTPRIO, // ul_int
|
|
PROCPS_PIDS_SCHED_CLASS, // ul_int
|
|
PROCPS_PIDS_SD_MACH, // str
|
|
PROCPS_PIDS_SD_OUID, // str
|
|
PROCPS_PIDS_SD_SEAT, // str
|
|
PROCPS_PIDS_SD_SESS, // str
|
|
PROCPS_PIDS_SD_SLICE, // str
|
|
PROCPS_PIDS_SD_UNIT, // str
|
|
PROCPS_PIDS_SD_UUNIT, // str
|
|
PROCPS_PIDS_SIGBLOCKED, // str
|
|
PROCPS_PIDS_SIGCATCH, // str
|
|
PROCPS_PIDS_SIGIGNORE, // str
|
|
PROCPS_PIDS_SIGNALS, // str
|
|
PROCPS_PIDS_SIGPENDING, // str
|
|
PROCPS_PIDS_STATE, // s_ch
|
|
PROCPS_PIDS_SUPGIDS, // str
|
|
PROCPS_PIDS_SUPGROUPS, // str
|
|
PROCPS_PIDS_TICS_ALL, // ull_int
|
|
PROCPS_PIDS_TICS_ALL_C, // ull_int
|
|
PROCPS_PIDS_TICS_DELTA, // u_int
|
|
PROCPS_PIDS_TICS_SYSTEM, // ull_int
|
|
PROCPS_PIDS_TICS_SYSTEM_C, // ull_int
|
|
PROCPS_PIDS_TICS_USER, // ull_int
|
|
PROCPS_PIDS_TICS_USER_C, // ull_int
|
|
PROCPS_PIDS_TIME_ALL, // ull_int
|
|
PROCPS_PIDS_TIME_ELAPSED, // ull_int
|
|
PROCPS_PIDS_TIME_START, // ull_int
|
|
PROCPS_PIDS_TTY, // s_int
|
|
PROCPS_PIDS_TTY_NAME, // str
|
|
PROCPS_PIDS_TTY_NUMBER, // str
|
|
PROCPS_PIDS_VM_DATA, // ul_int
|
|
PROCPS_PIDS_VM_EXE, // ul_int
|
|
PROCPS_PIDS_VM_LIB, // ul_int
|
|
PROCPS_PIDS_VM_LOCK, // ul_int
|
|
PROCPS_PIDS_VM_RSS, // ul_int
|
|
PROCPS_PIDS_VM_SIZE, // ul_int
|
|
PROCPS_PIDS_VM_STACK, // ul_int
|
|
PROCPS_PIDS_VM_SWAP, // ul_int
|
|
PROCPS_PIDS_VM_USED, // ul_int
|
|
PROCPS_PIDS_VSIZE_PGS, // ul_int
|
|
PROCPS_PIDS_WCHAN_ADDR, // ul_int
|
|
PROCPS_PIDS_WCHAN_NAME, // str
|
|
PROCPS_PIDS_extra, // ( reset to zero )
|
|
PROCPS_PIDS_noop // ( never altered )
|
|
};
|
|
|
|
enum pids_fill_type {
|
|
PROCPS_FILL_PID = 0x1000,
|
|
PROCPS_FILL_UID = 0x4000
|
|
};
|
|
|
|
enum pids_reap_type {
|
|
PROCPS_REAP_TASKS_ONLY = 0,
|
|
PROCPS_REAP_THREADS_TOO = 1
|
|
};
|
|
|
|
enum pids_sort_order {
|
|
PROCPS_SORT_ASCEND = +1,
|
|
PROCPS_SORT_DESCEND = -1
|
|
};
|
|
|
|
|
|
struct procps_pidsinfo;
|
|
|
|
struct pids_result {
|
|
enum pids_item item;
|
|
union {
|
|
char s_ch;
|
|
int s_int;
|
|
unsigned int u_int;
|
|
long sl_int;
|
|
unsigned long ul_int;
|
|
unsigned long long ull_int;
|
|
char * str;
|
|
char ** strv;
|
|
} result;
|
|
};
|
|
|
|
struct pids_stack {
|
|
struct pids_result *head;
|
|
unsigned fill_id;
|
|
};
|
|
|
|
struct pids_stacks {
|
|
struct pids_stack **stacks;
|
|
};
|
|
|
|
struct pids_counts {
|
|
int total;
|
|
int running, sleeping, stopped, zombied;
|
|
};
|
|
|
|
struct pids_reap {
|
|
struct pids_stack **stacks;
|
|
struct pids_counts counts;
|
|
};
|
|
|
|
|
|
#define PROCPS_PIDS_VAL(rel_enum,type,stack) \
|
|
stack -> head [ rel_enum ] . result . type
|
|
|
|
|
|
struct pids_stack *fatal_proc_unmounted (
|
|
struct procps_pidsinfo *info,
|
|
int return_self);
|
|
|
|
int procps_pids_new (
|
|
struct procps_pidsinfo **info,
|
|
int maxitems,
|
|
enum pids_item *items);
|
|
|
|
struct pids_stack *procps_pids_read_next (
|
|
struct procps_pidsinfo *info);
|
|
|
|
int procps_pids_read_open (
|
|
struct procps_pidsinfo *info,
|
|
enum pids_reap_type which);
|
|
|
|
int procps_pids_read_shut (
|
|
struct procps_pidsinfo *info);
|
|
|
|
struct pids_reap *procps_pids_reap (
|
|
struct procps_pidsinfo *info,
|
|
enum pids_reap_type which);
|
|
|
|
int procps_pids_ref (
|
|
struct procps_pidsinfo *info);
|
|
|
|
int procps_pids_reset (
|
|
struct procps_pidsinfo *info,
|
|
int newmaxitems,
|
|
enum pids_item *newitems);
|
|
|
|
struct pids_stacks *procps_pids_stacks_alloc (
|
|
struct procps_pidsinfo *info,
|
|
int maxstacks);
|
|
|
|
int procps_pids_stacks_dealloc (
|
|
struct procps_pidsinfo *info,
|
|
struct pids_stacks **these);
|
|
|
|
struct pids_counts *procps_pids_stacks_fill (
|
|
struct procps_pidsinfo *info,
|
|
struct pids_stacks *these,
|
|
int maxstacks,
|
|
enum pids_fill_type which);
|
|
|
|
struct pids_stack **procps_pids_stacks_sort (
|
|
struct procps_pidsinfo *info,
|
|
struct pids_stack *stacks[],
|
|
int numstacked,
|
|
enum pids_item sort,
|
|
enum pids_sort_order order);
|
|
|
|
int procps_pids_unref (
|
|
struct procps_pidsinfo **info);
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* _PROC_PIDS_H */
|