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.

liest Informationen aus /proc/#pid/statm
weist den Befehlszeilen-Teil von proc_t zu und liest Informationen aus /proc/#pid/cmdline
weist den Umgebung-Teil von proc_t zu und liest Informationen aus /proc/#pid/environ
löst mittels /etc/passwd Benutzerkennungen in Namen auf
löst mittels /etc/group Gruppenkennungen in Namen auf
liest Informationen aus /proc/#pid/status
liest Informationen aus /proc/#pid/stat
ist gleichbedeutend mit PROC_FILLCOM
reserviert eine Cgroup und befüllt sie
löst die zusätzlichen Gruppenkennungen in Gruppenamen auf
befüllt proc_t, oom_score und oom_adj
befüllt die Namensraum-Informationen in proc_t
befüllt die Systemd-Informationen in proc_t
behandelt Threads so, als wären sie Prozesse
schaut nur nach Prozessen, deren PID in der PID-Liste enthalten ist (die Liste ist mit 0 terminiert)
schaut nur nach Prozessen, deren UID in der UID-Liste enthalten ist (wobei n die Anzahl der in der Liste enthaltenen UIDs ist)
bearbeitet Cgroup als Einzelvektor
bearbeitet die Befehlszeile als Einzelvektor
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 <debian-l10n-german@lists.debian.org>.

14. Juli 2014 Linux-Handbuchseite