OPENPROC
Section: Linux Programmer's Manual (3)
Updated: 14 July 2014
Page Index
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_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
NOTE
Only one of the flags needing additional arguments
(
PROC_{PID,UID})
may be used at a time.
SEE ALSO
readproc(3),
readproctab(3),
/proc/,
/usr/include/proc/readproc.h,
REPORTING BUGS
Please send bug reports to