.\" -*- coding: UTF-8 -*- .\" This file describes the readproc interface to the /proc filesystem .\" .\" Copyright 1996 Helmut Geyer .\" Copyright 2014 Jaromir Capik .\" .\" 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. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH OPENPROC 3 "14. Juli 2014" Linux\-Handbuchseite Linux\-Programmierhandbuch .SH BEZEICHNUNG openproc, closeproc \- Prozessinformationen aus /proc/ initialisieren .SH ÜBERSICHT \fB#include \fP .sp \fBPROCTAB* openproc (int \fP\fISchalter\fP\fB, … );\fP .br \fBvoid closeproc (PROCTAB* \fP\fIPT\fP\fB);\fP .SH ÜBERSICHT Die Funktion \fBopenproc\fP initialisiert eine PROCTAB\-Struktur, die von iterierenden Readproc\-Aufrufen zum Holen von Informationen zu aktuellen Prozessen verwendet werden kann. Abhängig von den verwendeten \fISchaltern\fP kann \fBopenproc\fP ein zweites oder auch ein zweites und drittes Argument benötigen (siehe unten). \fBcloseproc\fP schließt alle von \fBopenproc\fP geöffneten Dateien und gibt den von \fBopenproc\fP zugewiesenen Speicher frei. Die PROCTAB\-Struktur ist in \fI\fP definiert. .RE .SH RÜCKGABEWERT \fBopenproc\fP gibt einen Zeiger auf eine PROCTAB\-Struktur zurück. Wenn ein Fehler auftritt, wird NULL zurückgegeben, was üblicherweise bedeutet, dass \fI/proc\fP vom Prozess nicht gelesen werden kann. .SH SCHALTER Das Verhalten von \fBopenproc\fP 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 \fBopendir\fP\-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. .TP 0.5i \fBPROC_FILLMEM\fP liest Informationen aus \fI/proc/#pid/statm\fP .TP 0.5i \fBPROC_FILLCOM\fP weist den \fIBefehlszeilen\fP\-Teil von \fIproc_t\fP zu und liest Informationen aus \fI/proc/#pid/cmdline\fP .TP 0.5i \fBPROC_FILLENV\fP weist den \fIUmgebung\fP\-Teil von \fIproc_t\fP zu und liest Informationen aus \fI/proc/#pid/environ\fP .TP 0.5i \fBPROC_FILLUSR\fP löst mittels \fI/etc/passwd\fP Benutzerkennungen in Namen auf .TP 0.5i \fBPROC_FILLGRP\fP löst mittels \fI/etc/group\fP Gruppenkennungen in Namen auf .TP 0.5i \fBPROC_FILLSTATUS\fP liest Informationen aus \fI/proc/#pid/status\fP .TP 0.5i \fBPROC_FILLSTAT\fP liest Informationen aus \fI/proc/#pid/stat\fP .TP 0.5i \fBPROC_FILLARG\fP ist gleichbedeutend mit PROC_FILLCOM .TP 0.5i \fBPROC_FILLCGROUP\fP reserviert eine Cgroup und befüllt sie .TP 0.5i \fBPROC_FILLSUPGRP\fP löst die zusätzlichen Gruppenkennungen in Gruppenamen auf .TP 0.5i \fBPROC_FILLOOM\fP befüllt proc_t, oom_score und oom_adj .TP 0.5i \fBPROC_FILLNS\fP befüllt die Namensraum\-Informationen in proc_t .TP 0.5i \fBPROC_FILLSYSTEMD\fP befüllt die Systemd\-Informationen in proc_t .TP 0.5i \fBPROC_LOOSE_TASKS\fP behandelt Threads so, als wären sie Prozesse .TP 0.5i \fBPROC_PID\fP (2. Argument \fBpid_t*\fP \fIPID\-Liste\fP) schaut nur nach Prozessen, deren PID in der \fIPID\-Liste\fP enthalten ist (die Liste ist mit 0 terminiert) .TP 0.5i \fBPROC_UID\fP (Argumente \fBuid_t*\fP \fIUID\-Liste\fP\fB, int \fP\fIn\fP) schaut nur nach Prozessen, deren UID in der \fIUID\-Liste\fP enthalten ist (wobei \fIn\fP die Anzahl der in der Liste enthaltenen UIDs ist) .TP 0.5i \fBPROC_EDITCGRPCVT\fP bearbeitet Cgroup als Einzelvektor .TP 0.5i \fBPROC_EDITCMDLCVT\fP bearbeitet die Befehlszeile als Einzelvektor .TP 0.5i \fBPROC_EDITENVRCVT\fP bearbeitet die Umgebung als Einzelvektor .SH ANMERKUNGEN Schalter, die zusätzliche Argumente benötigen (\fBPROC_{PID,UID}\fP), können nicht gleichzeitig mit anderen solchen Schaltern verwendet werden. .SH "SIEHE AUCH" \fBreadproc\fP(3), \fBreadproctab\fP(3), \fB/proc/\fP, \fB/usr/include/proc/readproc.h\fP, .SH "FEHLER MELDEN" Bitte schicken Sie Fehlerberichte (auf Englisch) an .UR procps@freelists.org .UE .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Mario Blättermann 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 .