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

EPERM
    Der Aufrufende muss über CAP_SYS_ADMIN im Benutzernamensraum verfügen.

EFAULT
    req oder einhängkenn zeigen auf einen Ort außerhalb des für den Prozess zugreifbaren Adressraums.

EINVAL
    Unzulässiger Schalter in Schalter angegeben.

EINVAL
    req hat eine für die Benutzung unzureichende Größe.

E2BIG
    req ist zu groß, die Begrenzung ist die Seitengröße 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)

Ü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 (https://www.gnu.org/licenses/gpl-3.0.html) 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).