listmount(2) System Calls Manual listmount(2) BEZEICHNUNG listmount - Eine Liste der Einhangungskennungen erhalten BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include /* Definition der >>struct mnt_id_req<<-Konstanten */ #include int syscall(size_t n; SYS_listmount, struct mnt_id_req *req, uint64_t einhangkenn[n], size_t n, unsigned long Schalter); #include struct mnt_id_req { __u32 size; /* sizeof(struct mnt_id_req) */ __u64 mnt_id; /* Die ubergeordnete, durchsuchte mnt_id */ __u64 param; /* Der nachste mnt_id der gefunden werden soll */ }; Hinweis: Glibc stellt keinen Wrapper fur listmount() bereit, daher muss syscall(2) verwandt werden. BESCHREIBUNG Um auf die Einhangungen in Ihrem Namensraum zuzugreifen, mussen Sie uber CAP_SYS_ADMIN in Ihrem Namensraum verfugen. Diese Funktion liefert eine Liste von Einhangekennungen unter req.mnt_id zuruck. Dies ist fur die Verwendung im Zusammenspiel mit statmount(2) gedacht, um eine Moglichkeit bereitzustellen, eingehangte Dateisysteme aufzuzahlen 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 ubergeordnete mnt_id, aus der aufgelistet wird. Sie kann entweder LSMT_ROOT sein, was die Wurzeleinhangung des aktuellen Einhangenamensraums bedeutet, oder eine Einhangekennung, die von entweder statx(2) mittels STATX_MNT_ID_UNIQUE erlangt wurde oder aus listmount(2). req.param wird dazu verwandt, dem Kernel die Einhangekennung mitzuteilen, bei der die Liste angefangen werden soll. Dies ist nutzlich, falls mehrere Aufrufe von listmount(2) benotigt werden. Dies kann auf die letzte zuruckgelieferte Einhangekennung gesetzt werden, um vom vorherigen Punkt in der Liste fortzufahren. RUCKGABEWERT Im Erfolgsfall wird die Anzahl der in mnt_ids eingefullten Eintrage zuruckgeliefert; 0, falls es keine verbliebenen Einhangungen gibt. Im Fehlerfall wird -1 zuruckgeliefert und errno gesetzt, um den Fehler anzuzeigen. FEHLER EPERM Der Aufrufende muss uber CAP_SYS_ADMIN im Benutzernamensraum verfugen. EFAULT req oder einhangkenn zeigen auf einen Ort ausserhalb des fur den Prozess zugreifbaren Adressraums. EINVAL Unzulassiger Schalter in Schalter angegeben. EINVAL req hat eine fur die Benutzung unzureichende Grosse. E2BIG req ist zu gross, die Begrenzung ist die Seitengrosse der Architektur. ENOENT Der angegebene req.mnt_id existiert nicht. ENOMEM Kein Speicher mehr (das bedeutet Speicher im Kernel). STANDARDS Linux. SIEHE AUCH statmount(2), statx(2) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.18 6. September 2025 listmount(2)