openproc (3)
Leading comments
This file describes the readproc interface to the /proc filesystem Copyright 1996 Helmut Geyer <Helmut.Geyer@iwr.uni-heidelberg.de> Copyright 2014 Jaromir Capik <jcapik@redhat.com> Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies. Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resul...
NAME
openproc, closeproc - initialize process information from /proc/SYNOPSIS
#include <proc/readproc.h>
PROCTAB* openproc (int flags, ... );
void closeproc (PROCTAB* PT);
SYNOPSIS
The openproc function initializes a PROCTAB structure which can be used by iterated readproc calls to get information on current processes. Depending on flags, openproc may need a second argument or a second and third argument (see below).
closeproc closes all files opened by openproc and deallocates the memory allocated by openproc.
The PROCTAB structure is defined in <proc/readproc.h>
RETURN VALUE
openproc returns a pointer to a PROCTAB structure, or NULL if an error occurs. This usually means that /proc cannot be read by the process.FLAGS
The behaviour of openproc is controlled by the following set of flags, which may be ORed together. There are three different kinds of flags. The first group of flags determins which information gets read from /proc/#pid for each process. The second group of flags (of which only one can be enacted for a opendir call) restricts which processes information is read for by providing a list of criteria. The third group of flags restricts this as well, but doesn't need arguments. These may be used together again.
- PROC_FILLMEM
- read information from /proc/#pid/statm
- PROC_FILLCOM
- allocate cmdline part of proc_t and read information from /proc/#pid/cmdline
- PROC_FILLENV
- allocate environ part of proc_t and read information from /proc/#pid/environ
- PROC_FILLUSR
- resolve user ids to names via /etc/passwd
- PROC_FILLGRP
- resolve group ids to names via /etc/group
- PROC_FILLSTATUS
- read information from /proc/#pid/status
- PROC_FILLSTAT
- read information from /proc/#pid/stat
- PROC_FILLWCHAN
- do WCHAN lookup
- PROC_FILLARG
- equivalent to PROC_FILLCOM
- PROC_FILLCGROUP
- alloc and fill in cgroup
- PROC_FILLSUPGRP
- resolve supplementary group id -> group name
- PROC_FILLOOM
- fill in proc_t oom_score and oom_adj
- PROC_FILLNS
- fill in proc_t namespace information
- PROC_FILLSYSTEMD
- fill in proc_t systemd information
- PROC_LOOSE_TASKS
- threat threads as if they were processes
- PROC_PID (2nd argument pid_t* pidlist)
- lookup only processes whose pid is contained in pidlist (the list is terminated with 0)
- PROC_UID (arguments uid_t* uidlist, int n)
- lookup only processes whose user id is contained in uidlist (where n is the number of uids contained in the list)
- PROC_EDITCGRPCVT
- edit cgroup as single vector
- PROC_EDITCMDLCVT
- edit cmdline as single vector
- PROC_EDITENVRCVT
-
edit environ as single vector