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>.