release/man2/statfs.2

   1 .\" Copyright (C) 2003 Andries Brouwer (aeb@cwi.nl)
   2 .\"
   3 .\" Permission is granted to make and distribute verbatim copies of this
   4 .\" manual provided the copyright notice and this permission notice are
   5 .\" preserved on all copies.
   6 .\"
   7 .\" Permission is granted to copy and distribute modified versions of this
   8 .\" manual under the conditions for verbatim copying, provided that the
   9 .\" entire resulting derived work is distributed under the terms of a
  10 .\" permission notice identical to this one.
  11 .\"
  12 .\" Since the Linux kernel and libraries are constantly changing, this
  13 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  14 .\" responsibility for errors or omissions, or for damages resulting from
  15 .\" the use of the information contained herein.  The author(s) may not
  16 .\" have taken the same level of care in the production of this manual,
  17 .\" which is licensed free of charge, as they might when working
  18 .\" professionally.
  19 .\"
  20 .\" Formatted or processed versions of this manual, if unaccompanied by
  21 .\" the source, must acknowledge the copyright and authors of this work.
  22 .\"
  23 .\" Modified 2003-08-17 by Walter Harms
  24 .\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
  25 .\"
  26 .\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
  27 .\"         all rights reserved.
  28 .\" Translated Fri Dec 12 00:25:54 JST 1997
  29 .\"         by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
  30 .\" Updated & Modified Sat Jun  2 20:25:46 JST 2001
  31 .\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
  32 .\" Updated & Modified Sat Jan 18 16:48:08 JST 2003
  33 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  34 .\" Updated & Modified Sun Sep  7 00:52:44 JST 2003 by Yuichi SATO
  35 .\" Updated & Modified Sun Jan  9 22:35:28 JST 2005 by Yuichi SATO
  36 .\" Updated 2006-07-21, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.36
  37 .\"
  38 .\"WORD:        file system             ¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à
  39 .\"WORD:        mount                   ¥Þ¥¦¥ó¥È
  40 .\"WORD:        pointer                 ¥Ý¥¤¥ó¥¿¡¼
  41 .\"WORD:        descriptor              ¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼
  42 .\"WORD:        open                    ¥ª¡¼¥×¥ó
  43 .\"WORD:        symbolic link           ¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯
  44 .\"WORD:        open                    ¥ª¡¼¥×¥ó
  45 .\"
  46 .TH STATFS 2 2004-06-23 "Linux" "Linux Programmer's Manual"
  47 .SH Ì¾Á°
  48 statfs, fstatfs \- ¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤ÎÅý·×¤òÆÀ¤ë
  49 .SH ½ñ¼°
  50 .BR "#include <sys/vfs.h>    " "/* ¤Þ¤¿¤Ï <sys/statfs.h> */"
  51 .sp
  52 .BI "int statfs(const char *" path ", struct statfs *" buf );
  53 .br
  54 .BI "int fstatfs(int " fd ", struct statfs *" buf );
  55 .SH ½ñ¼°
  56 ´Ø¿ô
  57 .BR statfs ()
  58 ¤Ï¥Þ¥¦¥ó¥È¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤òÊÖ¤¹¡£
  59 .I path
  60 ¤Ï¥Þ¥¦¥ó¥È¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Ë¤¢¤ë¥Õ¥¡¥¤¥ë¤Î¥Ñ¥¹Ì¾¤Ç¤¢¤ë¡£
  61 .I buf
  62 ¤Ï
  63 .I statfs
  64 ¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¡¼¤Ç¡¢¤ª¤è¤½°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤ë:
  65
  66 .in +4n
  67 .nf
  68 struct statfs {
  69    long    f_type;     /* ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Î·¿ (²¼µ»²¾È) */
  70    long    f_bsize;    /* ºÇÅ¬¤Ê¥Ö¥í¥Ã¥¯¥µ¥¤¥º */
  71    long    f_blocks;   /* ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤ÎÁí¥Ç¡¼¥¿¥Ö¥í¥Ã¥¯¿ô */
  72    long    f_bfree;    /* ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Î¶õ¤¥Ö¥í¥Ã¥¯¿ô */
  73    long    f_bavail;   /* ÈóÆÃ¸¢¥æ¡¼¥¶¤¬»ÈÍÑ²ÄÇ½¤Ê¶õ¤¥Ö¥í¥Ã¥¯¿ô */
  74    long    f_files;    /* ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤ÎÁí¥Õ¥¡¥¤¥ë¥Î¡¼¥É¿ô */
  75    long    f_ffree;    /* ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Î¶õ¤¥Õ¥¡¥¤¥ë¥Î¡¼¥É¿ô */
  76    fsid_t  f_fsid;     /* ¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Î ID */
  77    long    f_namelen;  /* ¥Õ¥¡¥¤¥ëÌ¾¤ÎºÇÂçÄ¹ */
  78 };
  79
  80 ¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Î·¿:
  81
  82    ADFS_SUPER_MAGIC      0xadf5
  83    AFFS_SUPER_MAGIC      0xADFF
  84    BEFS_SUPER_MAGIC      0x42465331
  85    BFS_MAGIC             0x1BADFACE
  86    CIFS_MAGIC_NUMBER     0xFF534D42
  87    CODA_SUPER_MAGIC      0x73757245
  88    COH_SUPER_MAGIC       0x012FF7B7
  89    CRAMFS_MAGIC          0x28cd3d45
  90    DEVFS_SUPER_MAGIC     0x1373
  91    EFS_SUPER_MAGIC       0x00414A53
  92    EXT_SUPER_MAGIC       0x137D
  93    EXT2_OLD_SUPER_MAGIC  0xEF51
  94    EXT2_SUPER_MAGIC      0xEF53
  95    EXT3_SUPER_MAGIC      0xEF53
  96    HFS_SUPER_MAGIC       0x4244
  97    HPFS_SUPER_MAGIC      0xF995E849
  98    HUGETLBFS_MAGIC       0x958458f6
  99    ISOFS_SUPER_MAGIC     0x9660
 100    JFFS2_SUPER_MAGIC     0x72b6
 101    JFS_SUPER_MAGIC       0x3153464a
 102    MINIX_SUPER_MAGIC     0x137F /* ¥ª¥ê¥¸¥Ê¥ë¤Î minix */
 103    MINIX_SUPER_MAGIC2    0x138F /* 30 Ê¸»ú¥Õ¥¡¥¤¥ëÌ¾¤Î minix */
 104    MINIX2_SUPER_MAGIC    0x2468 /* minix V2 */
 105    MINIX2_SUPER_MAGIC2   0x2478 /* minix V2, 30 Ê¸»ú¥Õ¥¡¥¤¥ëÌ¾ */
 106    MSDOS_SUPER_MAGIC     0x4d44
 107    NCP_SUPER_MAGIC       0x564c
 108    NFS_SUPER_MAGIC       0x6969
 109    NTFS_SB_MAGIC         0x5346544e
 110    OPENPROM_SUPER_MAGIC  0x9fa1
 111    PROC_SUPER_MAGIC      0x9fa0
 112    QNX4_SUPER_MAGIC      0x002f
 113    REISERFS_SUPER_MAGIC  0x52654973
 114    ROMFS_MAGIC           0x7275
 115    SMB_SUPER_MAGIC       0x517B
 116    SYSV2_SUPER_MAGIC     0x012FF7B6
 117    SYSV4_SUPER_MAGIC     0x012FF7B5
 118    TMPFS_MAGIC           0x01021994
 119    UDF_SUPER_MAGIC       0x15013346
 120    UFS_MAGIC             0x00011954
 121    USBDEVICE_SUPER_MAGIC 0x9fa2
 122    VXFS_SUPER_MAGIC      0xa501FCF5
 123    XENIX_SUPER_MAGIC     0x012FF7B4
 124    XFS_SUPER_MAGIC       0x58465342
 125    _XIAFS_SUPER_MAGIC    0x012FD16D
 126 .fi
 127 .in
 128 .PP
 129 .I f_fsid
 130 ¤Ë¤É¤ó¤ÊÃÍ¤¬Æþ¤ë¤Ù¤¤Ê¤Î¤«¤ÏÃ¯¤âÃÎ¤é¤Ê¤¤ (Ã¢¤·¡¢²¼µ¤ò»²¾È)¡£
 131 .PP
 132 ¤½¤ì¤¾¤ì¤Î¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Ë¤ª¤¤¤ÆÌ¤ÄêµÁ¤Î¥Õ¥£¡¼¥ë¥É¤Ë¤Ï 0 ¤¬
 133 ÀßÄê¤µ¤ì¤ë¡£
 134 .BR fstatfs ()
 135 ¤Ï¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼
 136 .I fd
 137 ¤Ë¤è¤Ã¤Æ»²¾È¤µ¤ì¤ë¥ª¡¼¥×¥ó¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¤Ë¤Ä¤¤¤Æ¡¢Æ±¤¸¾ðÊó¤òÊÖ¤¹¡£
 138 .SH ÊÖ¤êÃÍ
 139 À®¸ù¤¹¤ì¤Ð 0 ¤¬ÊÖ¤µ¤ì¤ë¡£¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤¬ÊÖ¤µ¤ì¡¢
 140 .I errno
 141 ¤¬Å¬ÀÚ¤ËÀßÄê¤µ¤ì¤ë¡£
 142 .SH ¥¨¥é¡¼
 143 .TP
 144 .B EACCES
 145 .RB ( statfs ()
 146 ¤Î¾ì¹ç)
 147 .I path
 148 ¤Î¥Ç¥£¥ì¥¯¥È¥êÉôÊ¬¤Ë¸¡º÷µö²Ä¤¬Í¿¤¨¤é¤ì¤Æ¤¤¤Ê¤¤
 149 .RB ( path_resolution (7)
 150 ¤â»²¾È¤¹¤ë¤³¤È)¡£
 151 .TP
 152 .B EBADF
 153 .RB ( fstatfs ()
 154 ¤Î¾ì¹ç)
 155 .I fd
 156 ¤ÏÍ¸ú¤Ê¥ª¡¼¥×¥ó¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¡¦¥Ç¥£¥¹¥¯¥ê¥×¥¿¡¼¤Ç¤Ï¤Ê¤¤¡£
 157 .TP
 158 .B EFAULT
 159 .I buf
 160 ¤Þ¤¿¤Ï
 161 .I path
 162 ¤¬ÉÔÀµ¤Ê¥¢¥É¥ì¥¹¤ò»Ø¤·¤Æ¤¤¤ë¡£
 163 .TP
 164 .B EINTR
 165 ¤³¤Î¸Æ¤Ó½Ð¤·¤¬¥·¥°¥Ê¥ë¤ÇÃæÃÇ¤µ¤ì¤¿¡£
 166 .TP
 167 .B EIO
 168 ¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤ÎÆÉ¤ß¹þ¤ß¤Î´Ö¤Ë I/O ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¡£
 169 .TP
 170 .B ELOOP
 171 .RB ( statfs ()
 172 ¤Î¾ì¹ç)
 173 .I path
 174 ¤ò²ò·è¤¹¤ë¤Î¤ËÃ©¤ë¤Ù¤¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤¬Â¿¤¹¤®¤ë¡£
 175 .TP
 176 .B ENAMETOOLONG
 177 .RB ( statfs ()
 178 ¤Î¾ì¹ç)
 179 .I path
 180 ¤¬Ä¹²á¤®¤ë¡£
 181 .TP
 182 .B ENOENT
 183 .RB ( statfs ()
 184 ¤Î¾ì¹ç)
 185 .I path
 186 ¤Ë¤è¤Ã¤Æ»²¾È¤µ¤ì¤ë¥Õ¥¡¥¤¥ë¤¬Â¸ºß¤·¤Ê¤¤¡£
 187 .TP
 188 .B ENOMEM
 189 ¥«¡¼¥Í¥ë¤Ë½½Ê¬¤Ê¥á¥â¥ê¤¬¤Ê¤¤¡£
 190 .TP
 191 .B ENOSYS
 192 ¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤¬¤³¤Î¸Æ¤Ó½Ð¤·¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¡£
 193 .TP
 194 .B ENOTDIR
 195 .RB ( statfs ()
 196 ¤Î¾ì¹ç)
 197 .I path
 198 ¤Î¥Ç¥£¥ì¥¯¥È¥êÉôÊ¬¤¬¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ê¤¤¡£
 199 .TP
 200 .B EOVERFLOW
 201 ÃÍ¤¬Âç¤²á¤®¤ë¤¿¤á¡¢ÊÖ¤êÃÍ¤Î¹½Â¤ÂÎ¤ÇÉ½¸½¤Ç¤¤Ê¤¤¡£
 202 .SH ½àµò
 203 Linux ¸ÇÍ¤Ç¤¢¤ë¡£
 204 Linux ¤Î
 205 .BR statfs ()
 206 ¤Ï 4.4BSD ¤Î¤â¤Î¤Ë±Æ¶Á¤ò¼õ¤±¤Æ¤¤¤ë¡£
 207 (¤·¤«¤·Æ±¤¸¹½Â¤ÂÎ¤ò»ÈÍÑ¤·¤Æ¤¤¤ë¤ï¤±¤Ç¤Ï¤Ê¤¤)
 208 .SH Ãí°Õ
 209 ¤³¤Î¥é¥¤¥Ö¥é¥ê¥³¡¼¥ë¤ò¥µ¥Ý¡¼¥È¤¹¤ë¤¿¤á¡¢
 210 ¥«¡¼¥Í¥ë¤Ë¤Ï¥·¥¹¥Æ¥à¥³¡¼¥ë
 211 .BR statfs (),
 212 .BR fstatfs (),
 213 .BR statfs64 (),
 214 .BR fstatfs64 ()
 215 ¤¬¤¢¤ë¡£
 216
 217 \fI<sys/vfs.h>\fP ¤·¤«»ý¤¿¤Ê¤¤¥·¥¹¥Æ¥à¤â¤¢¤ê¡¢
 218 \fI<sys/statfs.h>\fP ¤â»ý¤Ã¤Æ¤¤¤ë¥·¥¹¥Æ¥à¤â¤¢¤ë¡£
 219 Á°¼Ô¤Ï¸å¼Ô¤ò¥¤¥ó¥¯¥ë¡¼¥É¤¹¤ë¤Î¤Ç¡¢
 220 Á°¼Ô¤ò¥¤¥ó¥¯¥ë¡¼¥É¤¹¤ë¤Î¤¬ÎÉ¤¤¤È¹Í¤¨¤é¤ì¤ë¡£
 221
 222 LSB ¤Ç¤Ï¥é¥¤¥Ö¥é¥ê¥³¡¼¥ë
 223 .BR statfs (),
 224 .BR fstatfs ()
 225 ¤òÈó¿ä¾©¤È¤·¤Æ¡¢Âå¤ï¤ê¤Ë
 226 .BR statvfs (2),
 227 .BR fstatvfs (2)
 228 ¤ò»È¤¦¤è¤¦¤Ë»Ø¼¨¤·¤Æ¤¤¤ë¡£
 229 .SS f_fsid ¥Õ¥£¡¼¥ë¥É
 230 Solaris, Irix, POSIX ¤Ë¤Ï¥·¥¹¥Æ¥à¥³¡¼¥ë
 231 .BR statvfs (2)
 232 ¤¬¤¢¤ê¡¢
 233 .I "struct statvfs"
 234 ¤òÊÖ¤¹
 235 .RI ( <sys/statvfs.h>
 236 ¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë)¡£
 237 ¤³¤Î¹½Â¤ÂÎ¤Ë¤Ï¡¢
 238 .I "unsigned long"
 239 .I f_fsid
 240 ¤¬´Þ¤Þ¤ì¤Æ¤¤¤ë¡£
 241 Linux, SunOS, HP-UX, 4.4BSD ¤Ë¤Ï¥·¥¹¥Æ¥à¥³¡¼¥ë
 242 .BR statfs ()
 243 ¤¬¤¢¤ê¡¢
 244 .I "struct statfs"
 245 ¤òÊÖ¤¹
 246 .RI ( <sys/vfs.h>
 247 ¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë)¡£
 248 ¤³¤Î¹½Â¤ÂÎ¤Ë¤Ï
 249 .I fsid_t
 250 .IR f_fsid ,
 251 ¤¬´Þ¤Þ¤ì¤Æ¤ª¤ê¡¢
 252 .I fsid_t
 253 ¤Ï
 254 .I "struct { int val[2]; }"
 255 ¤ÈÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
 256 FreeBSD ¤Ç¤âÆ±¤¸¤Ç¤¢¤ë¤¬¡¢¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë
 257 .I <sys/mount.h>
 258 ¤ò»È¤¦¡£
 259
 260 .I f_fsid
 261 ¤Ï¤¢¤ë¥é¥ó¥À¥à¤ÊÃÍ¤ò»ý¤Á¡¢
 262 .RI ( f_fsid , ino )
 263 ¤È¤¤¤¦ 1 ÁÈ¤ÎÃÍ¤Ç¥Õ¥¡¥¤¥ë¤ò°ì°Õ¤Ë·èÄê¤Ç¤¤ë¤è¤¦¤Ë¤¹¤ë¡¢
 264 ¤È¤¤¤¦¤Î¤¬´ðËÜÅª¤Ê¹Í¤¨Êý¤Ç¤¢¤ë¡£
 265 ¤¤¤¯¤Ä¤«¤Î OS ¤Ç¤Ï¡¢¥Ç¥Ð¥¤¥¹ÈÖ¹æ (¤ÎÊÑ¼ï) ¤ò»È¤Ã¤¿¤ê¡¢
 266 ¥Ç¥Ð¥¤¥¹ÈÖ¹æ¤È¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¥¿¥¤¥×¤òÁÈ¤ß¹ç¤ï¤»¤Æ»È¤Ã¤¿¤ê¤·¤Æ¤¤¤ë¡£
 267 OS ¤ÎÃæ¤Ë¤Ï
 268 .I f_fsid
 269 ¥Õ¥£¡¼¥ë¥É¤Î¼èÆÀ¤ò¥¹¡¼¥Ñ¡¼¥æ¡¼¥¶¤Ë¸ÂÄê¤·¤Æ¤¤¤ë¤â¤Î¤â¤¢¤ë
 270 (ÈóÆÃ¸¢¥æ¡¼¥¶¤¬¼èÆÀ¤¹¤ë¤È 0 ¤È¤Ê¤ë)¡£
 271 NFS ¤Ç¥¨¥¯¥¹¥Ý¡¼¥È¤µ¤ì¤ë¾ì¹ç¡¢
 272 ¤³¤Î¥Õ¥£¡¼¥ë¥É¤¬¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Î¥Õ¥¡¥¤¥ë¥Ï¥ó¥É¥ë¤Ç»È¤ï¤ì¤Æ¤ª¤ê¡¢
 273 ¤³¤ÎÃÍ¤òÄó¶¡¤¹¤ë¤È¥»¥¥å¥ê¥Æ¥£¾å¤ÎÌäÂê¤¬¤¢¤ë¡£
 274 .LP
 275 ¤¤¤¯¤Ä¤«¤Î OS ¤Ç¤Ï¡¢
 276 .I fsid
 277 ¤ò
 278 .BR sysfs ()
 279 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÎÂè 2 °ú¤¿ô¤È¤·¤Æ»ÈÍÑ¤Ç¤¤ë¡£
 280 .SH ´ØÏ¢¹àÌÜ
 281 .BR stat (2),
 282 .BR statvfs (2),
 283 .BR path_resolution (7)