umount(3)

DESCRIPTION

Removes the native filesystem mount at target. Only root may request teardown; the root mount, mounts with open descriptors, and mounts containing child mounts cannot be removed.

SYNOPSIS

#include <unistd.h>

int umount(const char *target);

RETURN VALUE

  • Returns zero, or -1 and sets errno.

ERRORS

  • -EFAULT
    • Target is not readable.
  • -EPERM
    • The effective UID is not zero.
  • -ENOENT
    • Target is not a mount point.
  • -EBUSY
    • Target is the root mount, has open handles, or contains another mount.

NOTES

Unmounting only changes the in-memory native VFS namespace. It does not flush or persist data and never accesses a host filesystem. The filesystem type remains registered and may be mounted again by kernel bootstrap code.