Scroll to navigation

OPENPROC(3) Linux-Programmierhandbuch OPENPROC(3)

BEZEICHNUNG

openproc, closeproc - Prozessinformationen aus /proc/ initialisieren

ÜBERSICHT

#include <proc/readproc.h>

PROCTAB* openproc (int Schalter, … );
void closeproc (PROCTAB* PT);

ÜBERSICHT

Die Funktion openproc initialisiert eine PROCTAB-Struktur, die von iterierenden Readproc-Aufrufen zum Holen von Informationen zu aktuellen Prozessen verwendet werden kann. Abhängig von den verwendeten Schaltern kann openproc ein zweites oder auch ein zweites und drittes Argument benötigen (siehe unten).

closeproc schließt alle von openproc geöffneten Dateien und gibt den von openproc zugewiesenen Speicher frei.

Die PROCTAB-Struktur ist in <proc/readproc.h> definiert.

RÜCKGABEWERT

openproc gibt einen Zeiger auf eine PROCTAB-Struktur zurück. Wenn ein Fehler auftritt, wird NULL zurückgegeben, was üblicherweise bedeutet, dass /proc vom Prozess nicht gelesen werden kann.

SCHALTER

Das Verhalten von openproc wird von den folgenden Schaltern gesteuert, die mittels logischem ODER miteinander verknüpft werden können. Es gibt drei verschiedene Arten von Schaltern. Die erste Schaltergruppe bestimmt, welche Informationen für jeden Prozess aus /proc/#pid gelesen werden sollen. Die zweite Schaltergruppe (von denen nur einer für einen opendir-Aufruf verordnet werden kann) schränkt durch Bereitstellung einer Kriterienliste ein, welche Prozessinformationen gelesen werden. Die dritte Schaltergruppe schränkt dies ebenfalls ein, erfordert aber keine Argumente. Diese können wiederum zusammen verwendet werden.

PROC_FILLMEM
liest Informationen aus /proc/#pid/statm
PROC_FILLCOM
weist den Befehlszeilen-Teil von proc_t zu und liest Informationen aus /proc/#pid/cmdline
PROC_FILLENV
weist den Umgebung-Teil von proc_t zu und liest Informationen aus /proc/#pid/environ
PROC_FILLUSR
löst mittels /etc/passwd Benutzerkennungen in Namen auf
PROC_FILLGRP
löst mittels /etc/group Gruppenkennungen in Namen auf
PROC_FILLSTATUS
liest Informationen aus /proc/#pid/status
PROC_FILLSTAT
liest Informationen aus /proc/#pid/stat
PROC_FILLARG
ist gleichbedeutend mit PROC_FILLCOM
PROC_FILLCGROUP
reserviert eine Cgroup und befüllt sie
PROC_FILLSUPGRP
löst die zusätzlichen Gruppenkennungen in Gruppenamen auf
PROC_FILLOOM
befüllt proc_t, oom_score und oom_adj
PROC_FILLNS
befüllt die Namensraum-Informationen in proc_t
PROC_FILLSYSTEMD
befüllt die Systemd-Informationen in proc_t
PROC_LOOSE_TASKS
behandelt Threads so, als wären sie Prozesse
PROC_PID (2. Argument pid_t* PID-Liste)
schaut nur nach Prozessen, deren PID in der PID-Liste enthalten ist (die Liste ist mit 0 terminiert)
PROC_UID (Argumente uid_t* UID-Liste, int n)
schaut nur nach Prozessen, deren UID in der UID-Liste enthalten ist (wobei n die Anzahl der in der Liste enthaltenen UIDs ist)
PROC_EDITCGRPCVT
bearbeitet Cgroup als Einzelvektor
PROC_EDITCMDLCVT
bearbeitet die Befehlszeile als Einzelvektor
PROC_EDITENVRCVT
bearbeitet die Umgebung als Einzelvektor

ANMERKUNGEN

Schalter, die zusätzliche Argumente benötigen (PROC_{PID,UID}), können nicht gleichzeitig mit anderen solchen Schaltern verwendet werden.

SIEHE AUCH

readproc(3), readproctab(3), /proc/, /usr/include/proc/readproc.h,

FEHLER MELDEN

Bitte schicken Sie Fehlerberichte (auf Englisch) an procps@freelists.org

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer.

14. Juli 2014 Linux-Handbuchseite