table of contents
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 <debian-l10n-german@lists.debian.org>.
14. Juli 2014 | Linux-Handbuchseite |