名前

       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/ に書かれている。