ccb6ae8de1
The includes used to define a lot of things a library include should not. It was also a bit messy what was exposed in the library and what was not. get_pid_digits -> procps_pid_length and exported correctly MALLOC attribute move into relevant .c files NORETURN attribute moved to relevant .c, not used in library PURE attribute removed, it wasn't used KLONG/KLF/STRTOUKL were fixed for long, so now just use long HIDDEN attribute removed. It was for 3 functions. The PROCPS_EXPORT seems to do the same (opposite) thing. likely/unlikely removed from most places, its highly debateable this does anything useful as CPUs have gotten smarter about branches. Re-arranged the includes, ALL external programs should just #include <proc/procps.h> then proc/procps.h includes headers for files that have exported functions. procps.h and the headers it includes should not use items that are not exportable (e.g. hidden functions or macros) they go in procps-private.h
252 lines
8.7 KiB
C
252 lines
8.7 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
|
|
|
|
#include <features.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_CGNAME, // str
|
|
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_RSS_ANON, // ul_int
|
|
PROCPS_PIDS_VM_RSS_FILE, // ul_int
|
|
PROCPS_PIDS_VM_RSS_LOCKED, // ul_int
|
|
PROCPS_PIDS_VM_RSS_SHARED, // 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;
|
|
};
|
|
|
|
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_reap *procps_pids_select (
|
|
struct procps_pidsinfo *info,
|
|
unsigned *these,
|
|
int maxthese,
|
|
enum pids_fill_type which);
|
|
|
|
struct pids_stack **procps_pids_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 */
|