.\" -*- coding: UTF-8 -*-
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH listmount 2 "6. September 2025" "Linux man\-pages 6.18" 
.SH BEZEICHNUNG
listmount \- Eine Liste der Einhängungskennungen erhalten
.SH BIBLIOTHEK
Standard\-C\-Bibliothek (\fIlibc\fP,\ \fI\-lc\fP)
.SH ÜBERSICHT
.nf
\fB#include <linux/mount.h>\fP  /* Definition der »struct mnt_id_req«\-Konstanten */
\fB#include <unistd.h>\fP
.P
\fBint syscall(\fPsize_t n;
\fB            SYS_listmount, struct mnt_id_req *\fP\fIreq\fP\fB,\fP
\fB            uint64_t \fP\fIeinhängkenn\fP\fB[\fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP
\fB            unsigned long \fP\fISchalter\fP\fB);\fP
.P
\fB#include <linux/mount.h>\fP
.P
\fBstruct mnt_id_req {\fP
\fB    __u32  size;\fP    /* sizeof(struct mnt_id_req) */
\fB    __u64  mnt_id;\fP  /* Die übergeordnete, durchsuchte mnt_id */
\fB    __u64  param;\fP   /* Der nächste mnt_id der gefunden werden soll */
\fB};\fP
.fi
.P
\fIHinweis\fP: Glibc stellt keinen Wrapper für \fBlistmount\fP() bereit, daher
muss \fBsyscall\fP(2) verwandt werden.
.SH BESCHREIBUNG
Um auf die Einhängungen in Ihrem Namensraum zuzugreifen, müssen Sie über
CAP_SYS_ADMIN in Ihrem Namensraum verfügen.
.P
Diese Funktion liefert eine Liste von Einhängekennungen unter \fBreq.mnt_id\fP
zurück. Dies ist für die Verwendung im Zusammenspiel mit \fBstatmount\fP(2)
gedacht, um eine Möglichkeit bereitzustellen, eingehängte Dateisysteme
aufzuzählen und zu erkennen.
.SS "Die Struktur mnt_id_req"
\fIreq.size\fP wird vom Kernel verwandt, um die hereingereichte Struktur
\fImnt_id_req\fP zu bestimmen. Es sollte immer auf \fI\%sizeof(struct\ mnt_id_req)\fP gesetzt werden.
.P
\fIreq.mnt_id\fP ist die übergeordnete mnt_id, aus der aufgelistet wird. Sie
kann entweder \fBLSMT_ROOT\fP sein, was die Wurzeleinhängung des aktuellen
Einhängenamensraums bedeutet, oder eine Einhängekennung, die von entweder
\fBstatx\fP(2) mittels \fBSTATX_MNT_ID_UNIQUE\fP erlangt wurde oder aus
\fBlistmount\fP(2).
.P
\fIreq.param\fP wird dazu verwandt, dem Kernel die Einhängekennung mitzuteilen,
bei der die Liste angefangen werden soll. Dies ist nützlich, falls mehrere
Aufrufe von \fBlistmount\fP(2) benötigt werden. Dies kann auf die letzte
zurückgelieferte Einhängekennung gesetzt werden, um vom vorherigen Punkt in
der Liste fortzufahren.
.SH RÜCKGABEWERT
Im Erfolgsfall wird die Anzahl der in \fImnt_ids\fP eingefüllten Einträge
zurückgeliefert; 0, falls es keine verbliebenen Einhängungen gibt. Im
Fehlerfall wird \-1 zurückgeliefert und \fIerrno\fP gesetzt, um den Fehler
anzuzeigen.
.SH FEHLER
.TP 
\fBEPERM\fP
Der Aufrufende muss über \fBCAP_SYS_ADMIN\fP im Benutzernamensraum verfügen.
.TP 
\fBEFAULT\fP
\fIreq\fP oder \fIeinhängkenn\fP zeigen auf einen Ort außerhalb des für den
Prozess zugreifbaren Adressraums.
.TP 
\fBEINVAL\fP
Unzulässiger Schalter in \fISchalter\fP angegeben.
.TP 
\fBEINVAL\fP
\fIreq\fP hat eine für die Benutzung unzureichende Größe.
.TP 
\fBE2BIG\fP
\fIreq\fP ist zu groß, die Begrenzung ist die Seitengröße der Architektur.
.TP 
\fBENOENT\fP
Der angegebene \fIreq.mnt_id\fP existiert nicht.
.TP 
\fBENOMEM\fP
Kein Speicher mehr (das bedeutet Speicher im Kernel).
.SH STANDARDS
Linux.
.SH "SIEHE AUCH"
\fBstatmount\fP(2), \fBstatx\fP(2)
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .