draft/man2/umount.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (C) 1993 Rickard E. Faith <faith@cs.unc.edu>
   4 .\" and Copyright (C) 1994 Andries E. Brouwer <aeb@cwi.nl>
   5 .\" and Copyright (C) 2002, 2005 Michael Kerrisk <mtk.manpages@gmail.com>
   6 .\"
   7 .\" Permission is granted to make and distribute verbatim copies of this
   8 .\" manual provided the copyright notice and this permission notice are
   9 .\" preserved on all copies.
  10 .\"
  11 .\" Permission is granted to copy and distribute modified versions of this
  12 .\" manual under the conditions for verbatim copying, provided that the
  13 .\" entire resulting derived work is distributed under the terms of a
  14 .\" permission notice identical to this one.
  15 .\"
  16 .\" Since the Linux kernel and libraries are constantly changing, this
  17 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  18 .\" responsibility for errors or omissions, or for damages resulting from
  19 .\" the use of the information contained herein.  The author(s) may not
  20 .\" have taken the same level of care in the production of this manual,
  21 .\" which is licensed free of charge, as they might when working
  22 .\" professionally.
  23 .\"
  24 .\" Formatted or processed versions of this manual, if unaccompanied by
  25 .\" the source, must acknowledge the copyright and authors of this work.
  26 .\"
  27 .\" 2008-10-06, mtk: Created this as a new page by splitting
  28 .\"     umount/umount2 material out of mount.2
  29 .\"
  30 .\" Japanese Version Copyright (c) 2008  Akihiro MOTOKI
  31 .\"         all rights reserved.
  32 .\" Translated 2008-11-20, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.13
  33 .\"
  34 .TH UMOUNT 2 2009-09-03 "Linux" "Linux Programmer's Manual"
  35 .\"O .SH NAME
  36 .SH 名前
  37 .\"O umount, umount2 \- unmount file system
  38 umount, umount2 \- ファイルシステムをアンマウントする
  39 .\"O .SH SYNOPSIS
  40 .SH 書式
  41 .nf
  42 .B "#include <sys/mount.h>"
  43 .sp
  44 .BI "int umount(const char *" target );
  45 .sp
  46 .BI "int umount2(const char *" target ", int " flags );
  47 .fi
  48 .\"O .SH DESCRIPTION
  49 .SH 説明
  50 .\"O .BR umount ()
  51 .\"O and
  52 .\"O .BR umount2 ()
  53 .\"O remove the attachment of the (topmost) file system mounted on
  54 .\"O .IR target .
  55 .BR umount ()
  56 と
  57 .BR umount2 ()
  58 は
  59 .I target
  60 にマウントされている (最上位の) ファイルシステムを外す。
  61 .\" Note: the kernel naming differs from the glibc naming
  62 .\" umount2 is the glibc name for what the kernel now calls umount
  63 .\" and umount is the glibc name for oldumount
  64
  65 .\"O Appropriate privilege (Linux: the
  66 .\"O .B CAP_SYS_ADMIN
  67 .\"O capability) is required to unmount file systems.
  68 ファイルシステムのアンマウントを行うには、
  69 適切な権限 (Linux では
  70 .B CAP_SYS_ADMIN
  71 ケーパビリティ) が必要である。
  72
  73 .\"O Linux 2.1.116 added the
  74 .\"O .BR umount2 ()
  75 .\"O system call, which, like
  76 .\"O .BR umount (),
  77 .\"O unmounts a target, but allows additional
  78 .\"O .I flags
  79 .\"O controlling the behavior of the operation:
  80 Linux 2.1.116 から、
  81 .BR umount2 ()
  82 システムコールが追加された。これは
  83 .BR umount ()
  84 と同様に
  85 .I target
  86 をアンマウントするが、
  87 .I flags
  88 が追加されており、操作時の振る舞いを制御できる。
  89 .TP
  90 .\"O .BR MNT_FORCE " (since Linux 2.1.116)"
  91 .BR MNT_FORCE " (2.1.116 以降)"
  92 .\"O Force unmount even if busy.
  93 .\"O This can cause data loss.
  94 .\"O (Only for NFS mounts.)
  95 使用中 (busy) でも強制的にアンマウントを実行する。
  96 これを行うとデータを失う可能性がある。
  97 (NFS マウント専用)
  98 .TP
  99 .\"O .BR MNT_DETACH " (since Linux 2.4.11)"
 100 .BR MNT_DETACH " (2.4.11 以降)"
 101 .\"O Perform a lazy unmount: make the mount point unavailable for
 102 .\"O new accesses, and actually perform the unmount when the mount point
 103 .\"O ceases to be busy.
 104 遅延アンマウントを行う。マウントポイントに対する新規のアクセスは
 105 不可能となり、実際のアンマウントはマウントポイントがビジーで
 106 なくなった時点で行う。
 107 .TP
 108 .\"O .BR MNT_EXPIRE " (since Linux 2.6.8)"
 109 .BR MNT_EXPIRE " (Linux 2.6.8 以降)"
 110 .\"O Mark the mount point as expired.
 111 マウントポイントに期限切れの印をつける。
 112 .\"O If a mount point is not currently in use, then an initial call to
 113 .\"O .BR umount2 ()
 114 .\"O with this flag fails with the error
 115 .\"O .BR EAGAIN ,
 116 .\"O but marks the mount point as expired.
 117 マウントポイントが現在使用中でない場合、このフラグをつけて
 118 .BR umount2 ()
 119 を初めて呼び出すと
 120 .B EAGAIN
 121 エラーで失敗するが、マウントポイントには期限切れ (expire)
 122 の印がつけられる。
 123 .\"O The mount point remains expired as long as it isn't accessed
 124 .\"O by any process.
 125 そのマウントポイントはいずれかのプロセスがアクセスしない限り
 126 期限切れの印がついたままとなる。
 127 .\"O A second
 128 .\"O .BR umount2 ()
 129 .\"O call specifying
 130 .\"O .B MNT_EXPIRE
 131 .\"O unmounts an expired mount point.
 132 もう一度
 133 .B MNT_EXPIRE
 134 をつけて
 135 .BR umount2 ()
 136 を呼び出すと、期限切れの印のついたマウントポイントが
 137 アンマウントされる。
 138 .\"O This flag cannot be specified with either
 139 .\"O .B MNT_FORCE
 140 .\"O or
 141 .\"O .BR MNT_DETACH .
 142 このフラグを
 143 .B MNT_FORCE
 144 もしくは
 145 .B MNT_DETACH
 146 と同時に指定することはできない。
 147 .\"O .SH "RETURN VALUE"
 148 .SH 返り値
 149 .\"O On success, zero is returned.
 150 .\"O On error, \-1 is returned, and
 151 .\"O .I errno
 152 .\"O is set appropriately.
 153 成功した場合 0 が返る。
 154 エラーの場合、\-1 が返り、
 155 .I errno
 156 がエラーの内容にしたがって設定される。
 157 .\"O .SH ERRORS
 158 .SH エラー
 159 .\"O The error values given below result from filesystem type independent
 160 .\"O errors.
 161 .\"O Each filesystem type may have its own special errors and its
 162 .\"O own special behavior.
 163 .\"O See the kernel source code for details.
 164 以下に示すエラーは、ファイルシステムに依存しないものである。
 165 それぞれのファイルシステムタイプには固有のエラーが存在する場合があり、
 166 独自の動作をすることもある。詳しくはカーネルのソースを見て欲しい。
 167 .TP
 168 .B EAGAIN
 169 .\"O A call to
 170 .\"O .BR umount2 ()
 171 .\"O specifying
 172 .\"O .B MNT_EXPIRE
 173 .\"O successfully marked an unbusy file system as expired.
 174 .B MNT_EXPIRE
 175 を指定した
 176 .BR umount2 ()
 177 の呼び出しで、正常に未使用のファイルシステムに期限切れの印を
 178 つけることができた。
 179 .TP
 180 .B EBUSY
 181 .\"O .I target
 182 .\"O could not be unmounted because it is busy.
 183 使用中 (busy) のため、
 184 .I target
 185 をアンマウントできなかった。
 186 .TP
 187 .B EFAULT
 188 .\"O .I target
 189 .\"O points outside the user address space.
 190 .I target
 191 がユーザアドレス空間の外を指している。
 192 .TP
 193 .B EINVAL
 194 .\"O .I target
 195 .\"O is not a mount point.
 196 .\"O Or,
 197 .\"O .BR umount2 ()
 198 .\"O was called with
 199 .\"O .B MNT_EXPIRE
 200 .\"O and either
 201 .\"O .B MNT_DETACH
 202 .\"O or
 203 .\"O .BR MNT_FORCE .
 204 .I target
 205 がマウントポイントではない。
 206 または、
 207 .BR umount2 ()
 208 で、
 209 .B MNT_EXPIRE
 210 が指定された
 211 .BR umount2 ()
 212 で、
 213 .B MNT_DETACH
 214 か
 215 .B MNT_FORCE
 216 が同時に指定された。
 217 .TP
 218 .B ENAMETOOLONG
 219 .\"O A pathname was longer than
 220 .\"O .BR MAXPATHLEN .
 221 パス名の長さが
 222 .B MAXPATHLEN
 223 より長かった。
 224 .TP
 225 .B ENOENT
 226 .\"O A pathname was empty or had a nonexistent component.
 227 パス名が空である。もしくは指定されたパスが存在しない。
 228 .TP
 229 .B ENOMEM
 230 .\"O The kernel could not allocate a free page to copy filenames or data into.
 231 カーネルがファイル名やデータをコピーするための空きページを確保できなかった。
 232 .TP
 233 .B EPERM
 234 .\"O The caller does not have the required privileges.
 235 呼び出し元が必要な権限を持っていない。
 236 .\"O .SH VERSIONS
 237 .SH バージョン
 238 .\"O .BR MNT_DETACH
 239 .\"O and
 240 .\"O .BR MNT_EXPIRE
 241 .\" http://sourceware.org/bugzilla/show_bug.cgi?id=10092
 242 .\"O are only available in glibc since version 2.11.
 243 .BR MNT_DETACH
 244 と
 245 .BR MNT_EXPIRE
 246 はバージョン 2.11 以降の glibc でのみ利用できる。
 247 .\"O .SH "CONFORMING TO"
 248 .SH 準拠
 249 .\"O These functions are Linux-specific and should not be used in
 250 .\"O programs intended to be portable.
 251 この関数は Linux 固有の関数であり、移植を考慮したプログラムでは
 252 使用すべきでない。
 253 .\"O .SH NOTES
 254 .SH 注意
 255 .\"O The original
 256 .\"O .BR umount ()
 257 .\"O function was called as \fIumount(device)\fP and would return
 258 .\"O .B ENOTBLK
 259 .\"O when called with something other than a block device.
 260 元々の
 261 .BR umount ()
 262 関数は \fIumount(device)\fP の形で呼び出され、
 263 ブロックデバイス以外を指定して呼び出すと
 264 .B ENOTBLK
 265 を返した。
 266 .\"O In Linux 0.98p4 a call \fIumount(dir)\fP was added, in order to
 267 .\"O support anonymous devices.
 268 Linux 0.98p4 で、無名デバイス (anonymous device) に対応するために
 269 \fIumount(dir)\fP の形での呼び出しが加えられた。
 270 .\"O In Linux 2.3.99-pre7 the call \fIumount(device)\fP was removed,
 271 .\"O leaving only \fIumount(dir)\fP (since now devices can be mounted
 272 .\"O in more than one place, so specifying the device does not suffice).
 273 Linux 2.3.99-pre7 で、\fIumount(device)\fP は削除され、
 274 \fIumount(dir)\fP だけが残された
 275 (一つのデバイスを複数の位置にマウント出来るようになったため、
 276 デバイスを指定しただけでは不十分だからである)。
 277 .\"O .SH "SEE ALSO"
 278 .SH 関連項目
 279 .BR mount (2),
 280 .BR path_resolution (7),
 281 .BR mount (8),
 282 .BR umount (8)