名前

       umount, umount2 - ファイルシステムをアンマウントする

書式

       #include <sys/mount.h>

       int umount(const char *target);

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

説明

       umount()  と umount2()  は target にマウントされている (最上位の) ファイルシステムを外す。

       ファイルシステムのアンマウントを行うには、  適切な権限 (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 されたプログラムにおいて、  非特権ユーザーがファイルシステムのアンマウントをで
              きてしまうという セキュリティ問題を回避することができる。

返り値

       成功した場合、0 が返される。 失敗した場合、 -1 が返され、 errno に適切な値がセットされる。

エラー

       以下に示すエラーは、ファイルシステムに依存しないものである。 それぞれのファイルシステムタイプには固有のエ
       ラーが存在する場合があり、 独自の動作をすることもある。詳しくは Linux カーネルのソースを見て欲しい。

       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  呼び出し元が必要な権限を持っていない。

バージョン

       MNT_DETACH と MNT_EXPIRE はバージョン 2.11 以降の glibc で利用できる。

準拠

       この関数は Linux 固有の関数であり、移植を考慮したプログラムでは 使用すべきでない。

注意

   umount() and shared mount points
       Shared  mount  points  cause  any  mount activity on a mount point, including umount()  operations, to be
       forwarded to every shared mount point in the peer group and every slave mount of that peer  group.   This
       means  that  umount()   of any peer in a set of shared mounts will cause all of its peers to be unmounted
       and all of their slaves to be unmounted as well.

       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
       元々の   umount()    関数は  umount(device)  の形で呼び出され、  ブロックデバイス以外を指定して呼び出すと
       ENOTBLK を返した。 Linux 0.98p4 で、無名デバイス (anonymous device) に対応するために umount(dir) の形での
       呼び出しが加えられた。 Linux 2.3.99-pre7 で、umount(device) は削除され、 umount(dir) だけが残された (一つ
       のデバイスを複数の位置にマウント出来るようになったため、 デバイスを指定しただけでは不十分だからである)。

関連項目

       mount(2), mount_namespaces(7), path_resolution(7), mount(8), umount(8)

この文書について

       この man ページは Linux man-pages プロジェクトのリリース 5.10  の一部である。プロジェクトの説明とバグ報告
       に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。