UMOUNT

名前

書式

#include <sys/mount.h>

int umount(const char *target);

int umount2(const char *target, int flags);

説明

ファイルシステムのアンマウントを行うには、 適切な権限 (Linux では CAP_SYS_ADMIN ケーパビリティ) が必要である。

Linux 2.1.116 から、 umount2() システムコールが追加された。これは umount() と同様に target をアンマウントするが、 flags が追加されており、操作時の振る舞いを制御できる。

MNT_FORCE (2.1.116 以降)

Ask the filesystem to abort pending requests before attempting the unmount. This may allow the unmount to complete without waiting for an inaccessible server, but could cause data loss. If, after aborting requests, some processes still have active references to the filesystem, the unmount will still fail. As at Linux 4.12, MNT_FORCE is supported only on the following filesystems: 9p (since Linux 2.6.16), ceph (since Linux 2.6.34), cifs (since Linux 2.6.12), fuse (since Linux 2.6.16), lustre (since Linux 3.11), and NFS (since Linux 2.1.116).

MNT_DETACH (2.4.11 以降)

Perform a lazy unmount: make the mount point unavailable for new accesses, immediately disconnect the filesystem and all filesystems mounted below it from each other and from the mount table, and actually perform the unmount when the mount point ceases to be busy.

MNT_EXPIRE (Linux 2.6.8 以降)

マウントポイントに期限切れの印をつける。 マウントポイントが現在使用中でない場合、このフラグをつけて umount2() を初めて呼び出すと EAGAIN エラーで失敗するが、マウントポイントには期限切れ (expire) の印がつけられる。 そのマウントポイントはいずれかのプロセスがアクセスしない限り 期限切れの印がついたままとなる。 もう一度 MNT_EXPIRE をつけて umount2() を呼び出すと、期限切れの印のついたマウントポイントが アンマウントされる。 このフラグを MNT_FORCE もしくは MNT_DETACH と同時に指定することはできない。

UMOUNT_NOFOLLOW (Linux 2.6.34 以降)

target がシンボリックリンクの場合に、シンボリックリンクの展開を行わない。 このフラグを使うと、 root に set-user-ID されたプログラムにおいて、 非特権ユーザーがファイルシステムのアンマウントをできてしまうという セキュリティ問題を回避することができる。

返り値

エラー

EAGAIN

MNT_EXPIRE を指定した umount2() の呼び出しで、正常に未使用のファイルシステムに期限切れの印を つけることができた。

EBUSY

使用中 (busy) のため、 target をアンマウントできなかった。

EFAULT

target がユーザーアドレス空間の外を指している。

EINVAL

target がマウントポイントではない。

EINVAL

MNT_EXPIRE が指定された umount2() で、 MNT_DETACH か MNT_FORCE が同時に指定された。

EINVAL (Linux 2.6.34 以降)

flags に無効なフラグが指定されて umount2() が呼び出された。

ENAMETOOLONG

パス名の長さが MAXPATHLEN より長かった。

ENOENT

パス名が空である。もしくは指定されたパスが存在しない。

ENOMEM

カーネルがファイル名やデータをコピーするための空きページを確保できなかった。

EPERM

呼び出し元が必要な権限を持っていない。

バージョン

準拠

注意

umount() and shared mount points

This propagation of unmount activity can be particularly surprising on systems where every mount point is shared by default. On such systems, recursively bind mounting the root directory of the filesystem onto a subdirectory and then later unmounting that subdirectory with MNT_DETACH will cause every mount in the mount namespace to be lazily unmounted.

To ensure umount() does not propagate in this fashion, the mount point may be remounted using a mount(2) call with a mount_flags argument that includes both MS_REC and MS_PRIVATE prior to umount() being called.  

Historical details

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

[man1] [man2] [man3] [man4] [man5] [man6] [man7] [man8]
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] [k] [l] [m] [n] [o] [p] [q] [r] [s] [t] [u] [v] [w] [x] [y] [z]

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

umount() and shared mount points

Historical details

関連項目

この文書について