3600f652e8
This patch will bring three of our man pages into line
with the recent refactor of the libprocps wchan logic.
[ and also eliminates more damn eol whitespace which ]
[ snuck in our repo with the commit referenced below ]
Reference(s):
http://www.freelists.org/post/procps/WCHAN,11
commit cf4788c28d
Signed-off-by: Jim Warner <james.warner@comcast.net>
161 lines
4.0 KiB
Groff
161 lines
4.0 KiB
Groff
.\" 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 resulting derived work is distributed under the terms of a
|
|
.\" permission notice identical to this one
|
|
.\"
|
|
.\" Formatted or processed versions of this manual, if unaccompanied by
|
|
.\" the source, must acknowledge the copyright and authors of this work.
|
|
.\"
|
|
.TH OPENPROC 3 "14 July 2014" "Linux Manpage" "Linux Programmer's Manual"
|
|
.SH NAME
|
|
openproc, closeproc \- initialize process information from /proc/
|
|
.SH SYNOPSIS
|
|
.B #include <proc/readproc.h>
|
|
.sp
|
|
.BI "PROCTAB* openproc (int " flags ", ... );"
|
|
.br
|
|
.BI "void closeproc (PROCTAB* " PT ");"
|
|
|
|
.SH SYNOPSIS
|
|
|
|
The
|
|
.B openproc
|
|
function initializes a PROCTAB structure which can be used by iterated
|
|
readproc calls to get information on current processes. Depending on
|
|
.IR flags ,
|
|
openproc may need a second argument or a second and third argument
|
|
(see below).
|
|
|
|
.B closeproc
|
|
closes all files opened by
|
|
.B openproc
|
|
and deallocates the memory allocated by
|
|
.B openproc.
|
|
|
|
The PROCTAB structure is defined in
|
|
.I <proc/readproc.h>
|
|
.RE
|
|
|
|
.SH "RETURN VALUE"
|
|
.B openproc
|
|
returns a pointer to a PROCTAB structure, or NULL if an error
|
|
occurs. This usually means that
|
|
.I /proc
|
|
cannot be read by the process.
|
|
|
|
.SH "FLAGS"
|
|
|
|
The behaviour of
|
|
.B 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.
|
|
|
|
.TP 0.5i
|
|
.B "PROC_FILLMEM"
|
|
read information from
|
|
.IR /proc/#pid/statm
|
|
.TP 0.5i
|
|
.B "PROC_FILLCOM"
|
|
allocate
|
|
.I cmdline
|
|
part of
|
|
.I proc_t
|
|
and read information from
|
|
.IR /proc/#pid/cmdline
|
|
.TP 0.5i
|
|
.B "PROC_FILLENV"
|
|
allocate
|
|
.I environ
|
|
part of
|
|
.I proc_t
|
|
and read information from
|
|
.IR /proc/#pid/environ
|
|
.TP 0.5i
|
|
.B "PROC_FILLUSR"
|
|
resolve user ids to names via
|
|
.IR /etc/passwd
|
|
.TP 0.5i
|
|
.B "PROC_FILLGRP"
|
|
resolve group ids to names via
|
|
.IR /etc/group
|
|
.TP 0.5i
|
|
.B "PROC_FILLSTATUS"
|
|
read information from
|
|
.IR /proc/#pid/status
|
|
.TP 0.5i
|
|
.B "PROC_FILLSTAT"
|
|
read information from
|
|
.IR /proc/#pid/stat
|
|
.TP 0.5i
|
|
.B "PROC_FILLARG"
|
|
equivalent to PROC_FILLCOM
|
|
.TP 0.5i
|
|
.B "PROC_FILLCGROUP"
|
|
alloc and fill in cgroup
|
|
.TP 0.5i
|
|
.B "PROC_FILLSUPGRP"
|
|
resolve supplementary group id -> group name
|
|
.TP 0.5i
|
|
.B "PROC_FILLOOM"
|
|
fill in proc_t oom_score and oom_adj
|
|
.TP 0.5i
|
|
.B "PROC_FILLNS"
|
|
fill in proc_t namespace information
|
|
.TP 0.5i
|
|
.B "PROC_FILLSYSTEMD"
|
|
fill in proc_t systemd information
|
|
.TP 0.5i
|
|
.B "PROC_LOOSE_TASKS"
|
|
threat threads as if they were processes
|
|
.TP 0.5i
|
|
.BR PROC_PID " (2nd argument "pid_t* " \fIpidlist\fR)
|
|
lookup only processes whose pid is contained in
|
|
.IR pidlist
|
|
(the list is terminated with 0)
|
|
.TP 0.5i
|
|
.BR PROC_UID " (arguments "uid_t* " \fIuidlist\fB, int \fIn\fR)
|
|
lookup only processes whose user id is contained in
|
|
.IR uidlist
|
|
(where
|
|
.I n
|
|
is the number of uids contained in the list)
|
|
.TP 0.5i
|
|
.B "PROC_EDITCGRPCVT"
|
|
edit cgroup as single vector
|
|
.TP 0.5i
|
|
.B "PROC_EDITCMDLCVT"
|
|
edit cmdline as single vector
|
|
.TP 0.5i
|
|
.B "PROC_EDITENVRCVT"
|
|
edit environ as single vector
|
|
|
|
.SH NOTE
|
|
Only one of the flags needing additional arguments
|
|
.RB ( "PROC_{PID,UID}" )
|
|
may be used at a time.
|
|
|
|
.SH "SEE ALSO"
|
|
.BR readproc (3),
|
|
.BR readproctab (3),
|
|
.BR /proc/ ,
|
|
.BR /usr/include/proc/readproc.h ,
|
|
.SH "REPORTING BUGS"
|
|
Please send bug reports to
|
|
.UR procps@freelists.org
|
|
.UE
|