xnu-2782.1.97.tar.gz

[apple/xnu.git] / bsd / man / man2 / statfs.2

diff --git a/bsd/man/man2/statfs.2 b/bsd/man/man2/statfs.2
index 1ababf3f81c12db33abfbabbc62d63eb0ddbe193..7e2b9ad27e672d91faec6143032de11fe8bbf857 100644 (file)
--- a/bsd/man/man2/statfs.2
+++ b/bsd/man/man2/statfs.2
@@ -33,7 +33,7 @@
 .\"
 .\"    @(#)statfs.2    8.3 (Berkeley) 2/11/94
 .\"
 .\"
 .\"    @(#)statfs.2    8.3 (Berkeley) 2/11/94
 .\"

-.Dd February 11, 1994
+.Dd August 14, 2008

 .Dt STATFS 2
 .Os
 .Sh NAME
 .Dt STATFS 2
 .Os
 .Sh NAME


@@ -48,31 +48,41 @@
 .Ft int
 .Fn statfs "const char *path" "struct statfs *buf"
 .Ft int
 .Ft int
 .Fn statfs "const char *path" "struct statfs *buf"
 .Ft int

-.Fn statfs64 "const char *path" "struct statfs64 *buf"
-.Ft int

 .Fn fstatfs "int fd" "struct statfs *buf"
 .Fn fstatfs "int fd" "struct statfs *buf"

+.Sh TRANSITIONAL SYNOPSIS (NOW DEPRECATED)
+.Ft int
+.br
+.Fn statfs64 "const char *path" "struct statfs64 *buf" ;
+.sp

 .Ft int
 .Ft int

-.Fn fstatfs64 "int fd" "struct statfs64 *buf"
+.br
+.Fn fstatfs64 "int fd" "struct statfs64 *buf" ;

 .Sh DESCRIPTION
 .Sh DESCRIPTION

-.Fn Statfs
-returns information about a mounted file system.
-.Fa Path
-is the path name of any file within the mounted file system.
-.Fa Buf
-is a pointer to a 
+The
+.Fn statfs
+routine returns information about a mounted file system.
+The
+.Fa path
+argument is the path name of any file or directory within the mounted file system.
+The
+.Fa buf
+argument is a pointer to a 

 .Fa statfs
 .Fa statfs

-or
-.Fa statfs64
-structure defined as follows:
+structure.
+When the macro
+.Dv _DARWIN_FEATURE_64_BIT_INODE
+is not defined (see
+.Xr stat 2
+for more information on this macro), the
+.Fa statfs
+structure is defined as:

 .Bd -literal
 typedef struct { int32_t val[2]; } fsid_t;
 
 #define MFSNAMELEN      15 /* length of fs type name, not inc. nul */
 #define MNAMELEN        90 /* length of buffer for returned name */
 .Bd -literal
 typedef struct { int32_t val[2]; } fsid_t;
 
 #define MFSNAMELEN      15 /* length of fs type name, not inc. nul */
 #define MNAMELEN        90 /* length of buffer for returned name */

-#define MFSTYPENAMELEN  16 /* length of fs type name including null */
-#define MAXPATHLEN      1024   

 
 

-struct statfs {
+struct statfs { /* when _DARWIN_FEATURE_64_BIT_INODE is NOT defined */

     short   f_otype;   /* type of file system (reserved: zero) */
     short   f_oflags;  /* copy of mount flags (reserved: zero) */
     long    f_bsize;   /* fundamental file system block size */
     short   f_otype;   /* type of file system (reserved: zero) */
     short   f_oflags;  /* copy of mount flags (reserved: zero) */
     long    f_bsize;   /* fundamental file system block size */


@@ -94,33 +104,52 @@ struct statfs {
     char    f_reserved3;       /* reserved for future use */
     long    f_reserved4[4];    /* reserved for future use */
 };
     char    f_reserved3;       /* reserved for future use */
     long    f_reserved4[4];    /* reserved for future use */
 };

+.Ed
+.Pp
+However, when the macro
+.Dv _DARWIN_FEATURE_64_BIT_INODE
+is defined, the
+.Fa statfs
+structure is defined as:
+.Bd -literal
+#define MFSTYPENAMELEN  16 /* length of fs type name including null */
+#define MAXPATHLEN      1024   
+#define MNAMELEN        MAXPATHLEN

 
 

-struct statfs64 {
-    uint32_t        f_bsize;        /* fundamental file system block size */ 
-    int32_t         f_iosize;       /* optimal transfer block size */ 
-    uint64_t        f_blocks;       /* total data blocks in file system */ 
-    uint64_t        f_bfree;        /* free blocks in fs */ 
-    uint64_t        f_bavail;       /* free blocks avail to non-superuser */ 
-    uint64_t        f_files;        /* total file nodes in file system */ 
-    uint64_t        f_ffree;        /* free file nodes in fs */ 
-    fsid_t          f_fsid;         /* file system id */ 
-    uid_t           f_owner;        /* user that mounted the filesystem */ 
-    uint32_t        f_type;         /* type of filesystem */ 
-    uint32_t        f_flags;        /* copy of mount exported flags */ 
-    uint32_t        f_fssubtype;    /* fs sub-type (flavor) */ 
-    char            f_fstypename[MFSTYPENAMELEN];   /* fs type name */ 
-    char            f_mntonname[MAXPATHLEN];        /* directory on which mounted */ 
-    char            f_mntfromname[MAXPATHLEN];      /* mounted filesystem */ 
-    uint32_t        f_reserved[8];  /* For future use */ 
+struct statfs { /* when _DARWIN_FEATURE_64_BIT_INODE is defined */
+    uint32_t    f_bsize;        /* fundamental file system block size */ 
+    int32_t     f_iosize;       /* optimal transfer block size */ 
+    uint64_t    f_blocks;       /* total data blocks in file system */ 
+    uint64_t    f_bfree;        /* free blocks in fs */ 
+    uint64_t    f_bavail;       /* free blocks avail to non-superuser */ 
+    uint64_t    f_files;        /* total file nodes in file system */ 
+    uint64_t    f_ffree;        /* free file nodes in fs */ 
+    fsid_t      f_fsid;         /* file system id */ 
+    uid_t       f_owner;        /* user that mounted the filesystem */ 
+    uint32_t    f_type;         /* type of filesystem */ 
+    uint32_t    f_flags;        /* copy of mount exported flags */ 
+    uint32_t    f_fssubtype;    /* fs sub-type (flavor) */ 
+    char        f_fstypename[MFSTYPENAMELEN];   /* fs type name */ 
+    char        f_mntonname[MAXPATHLEN];        /* directory on which mounted */ 
+    char        f_mntfromname[MAXPATHLEN];      /* mounted filesystem */ 
+    uint32_t    f_reserved[8];  /* For future use */ 

 };
 .Ed
 .Pp
 };
 .Ed
 .Pp

+Note that the
+.Fa f_fstypename ,
+.Fa f_mntonname ,
+and
+.Fa f_mntfromname
+fields are also wider in this variant.
+.Pp

 Fields that are undefined for a particular file system are set to -1.
 Fields that are undefined for a particular file system are set to -1.

-.Fn Fstatfs
-returns the same information about an open file referenced by descriptor
+The
+.Fn fstatfs
+routine returns the same information about an open file referenced by descriptor

 .Fa fd .
 .Sh FLAGS
 .Fa fd .
 .Sh FLAGS

-.Bl -tag -width MNT_UNKOWNPERMISSIONS
+.Bl -tag -width MNT_UNKNOWNPERMISSIONS

 These are some of the flags that may be present in the f_flags field. 
 .It Dv MNT_RDONLY
 A read-only filesystem
 These are some of the flags that may be present in the f_flags field. 
 .It Dv MNT_RDONLY
 A read-only filesystem


@@ -138,7 +167,7 @@ Union with underlying filesysten
 File system written to asynchronously
 .It Dv MNT_EXPORTED
 File system is exported
 File system written to asynchronously
 .It Dv MNT_EXPORTED
 File system is exported

-.it Dv MNT_LOCAL
+.It Dv MNT_LOCAL

 File system is stored locally
 .It Dv MNT_QUOTA
 Quotas are enabled on this file system
 File system is stored locally
 .It Dv MNT_QUOTA
 Quotas are enabled on this file system


@@ -158,6 +187,8 @@ File system is journaled
 File system should defer writes
 .It Dv MNT_MULTILABEL
 MAC support for individual labels
 File system should defer writes
 .It Dv MNT_MULTILABEL
 MAC support for individual labels

+.It Dv MNT_CPROTECT
+File system supports per-file encrypted data protection

 .El
 .Sh CAVEATS
 In Mac OS X versions before 10.4, f_iosize is 4096. On these older
 .El
 .Sh CAVEATS
 In Mac OS X versions before 10.4, f_iosize is 4096. On these older


@@ -168,8 +199,9 @@ Otherwise, -1 is returned and the global variable
 .Va errno
 is set to indicate the error.
 .Sh ERRORS
 .Va errno
 is set to indicate the error.
 .Sh ERRORS

-.Fn Statfs
-fails if one or more of the following are true:
+The
+.Fn statfs
+routine fails if one or more of the following are true:

 .Bl -tag -width Er
 .It Bq Er ENOTDIR
 A component of the path prefix of
 .Bl -tag -width Er
 .It Bq Er ENOTDIR
 A component of the path prefix of


@@ -186,7 +218,7 @@ exceeds
 .Dv {PATH_MAX}
 characters.
 .It Bq Er ENOENT
 .Dv {PATH_MAX}
 characters.
 .It Bq Er ENOENT

-The file referred to by
+The file or directory referred to by

 .Fa path
 does not exist.
 .It Bq Er EACCES
 .Fa path
 does not exist.
 .It Bq Er EACCES


@@ -206,8 +238,9 @@ An
 error occurred while reading from or writing to the file system.
 .El
 .Pp
 error occurred while reading from or writing to the file system.
 .El
 .Pp

-.Fn Fstatfs
-fails if one or more of the following are true:
+The
+.Fn fstatfs
+routine fails if one or more of the following are true:

 .Bl -tag -width Er
 .It Bq Er EBADF
 .Fa fd
 .Bl -tag -width Er
 .It Bq Er EBADF
 .Fa fd


@@ -220,6 +253,24 @@ An
 .Tn I/O
 error occurred while reading from or writing to the file system.
 .El
 .Tn I/O
 error occurred while reading from or writing to the file system.
 .El

+.Sh TRANSITIONAL DESCRIPTION (NOW DEPRECATED)
+The
+.Fa statfs64
+and
+.Fa fstatfs64
+routines are equivalent to their corresponding non-64-suffixed routine,
+when 64-bit inodes are in effect.
+They were added before there was support for the symbol variants, and so are
+now deprecated.
+Instead of using these, set the
+.Dv _DARWIN_USE_64_BIT_INODE
+macro before including header files to force 64-bit inode support.
+.Pp
+The
+.Fa statfs64
+structure used by these deprecated routines is the same as the
+.Fa statfs
+structure when 64-bit inodes are in effect (see above).

 .Sh HISTORY
 The
 .Fn statfs
 .Sh HISTORY
 The
 .Fn statfs


@@ -227,4 +278,5 @@ function first appeared in 4.4BSD. The
 .Fn statfs64
 and 
 .Fn fstatfs64
 .Fn statfs64
 and 
 .Fn fstatfs64

-first appeared in Max OS X 10.5 (Leopard).
+first appeared in Max OS X 10.5 (Leopard) and are now deprecated
+in favor of the corresponding symbol variants.