1. Manuals
  2. Tumbleweed
  3. man-pages-de
  4. listmount(2)

Scroll to navigation

listmount(2) System Calls Manual listmount(2)

BEZEICHNUNG

listmount - Eine Liste der Einhängungskennungen erhalten

BIBLIOTHEK

Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

#include <linux/mount.h>  /* Definition der »struct mnt_id_req«-Konstanten */
#include <unistd.h>
int syscall(size_t n;
            SYS_listmount, struct mnt_id_req *req,
            uint64_t einhängkenn[n], size_t n,
            unsigned long Schalter);
#include <linux/mount.h>
struct mnt_id_req {
    __u32  size;    /* sizeof(struct mnt_id_req) */
    __u64  mnt_id;  /* Die übergeordnete, durchsuchte mnt_id */
    __u64  param;   /* Der nächste mnt_id der gefunden werden soll */
};

Hinweis: Glibc stellt keinen Wrapper für listmount() bereit, daher muss syscall(2) verwandt werden.

BESCHREIBUNG

Um auf die Einhängungen in Ihrem Namensraum zuzugreifen, müssen Sie über CAP_SYS_ADMIN in Ihrem Namensraum verfügen.

Diese Funktion liefert eine Liste von Einhängekennungen unter req.mnt_id zurück. Dies ist für die Verwendung im Zusammenspiel mit statmount(2) gedacht, um eine Möglichkeit bereitzustellen, eingehängte Dateisysteme aufzuzählen und zu erkennen.

Die Struktur mnt_id_req

req.size wird vom Kernel verwandt, um die hereingereichte Struktur mnt_id_req zu bestimmen. Es sollte immer auf sizeof(struct mnt_id_req) gesetzt werden.

req.mnt_id ist die übergeordnete mnt_id, aus der aufgelistet wird. Sie kann entweder LSMT_ROOT sein, was die Wurzeleinhängung des aktuellen Einhängenamensraums bedeutet, oder eine Einhängekennung, die von entweder statx(2) mittels STATX_MNT_ID_UNIQUE erlangt wurde oder aus listmount(2).

req.param wird dazu verwandt, dem Kernel die Einhängekennung mitzuteilen, bei der die Liste angefangen werden soll. Dies ist nützlich, falls mehrere Aufrufe von listmount(2) benötigt werden. Dies kann auf die letzte zurückgelieferte Einhängekennung gesetzt werden, um vom vorherigen Punkt in der Liste fortzufahren.

RÜCKGABEWERT

Im Erfolgsfall wird die Anzahl der in mnt_ids eingefüllten Einträge zurückgeliefert; 0, falls es keine verbliebenen Einhängungen gibt. Im Fehlerfall wird -1 zurückgeliefert und errno gesetzt, um den Fehler anzuzeigen.

FEHLER

Für den Zugriff auf diese Einhängung wurden die Rechte verweigert.
req oder einhängkenn zeigen auf einen Ort außerhalb des für den Prozess zugreifbaren Adressraums.
Unzulässiger Schalter in Schalter angegeben.
req hat eine für die Benutzung unzureichende Größe.
req ist zu groß, die Begrenzung ist die Seitengröße der Architektur.
Der angegebene req.mnt_id existiert nicht.
Kein Speicher mehr (das bedeutet Speicher im Kernel).

STANDARDS

Linux.

SIEHE AUCH

statmount(2), statx(2)

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> 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: debian-l10n-german@lists.debian.org.

28. Juni 2025 Linux man-pages (unveröffentlicht)