getmntinfo.3.patch [plain text]
--- getmntinfo.3.orig 2010-06-17 09:25:28.000000000 -0700
+++ getmntinfo.3 2010-06-17 09:26:43.000000000 -0700
@@ -28,28 +28,37 @@
.\" @(#)getmntinfo.3 8.1 (Berkeley) 6/9/93
.\" $FreeBSD: src/lib/libc/gen/getmntinfo.3,v 1.13 2007/01/09 00:27:54 imp Exp $
.\"
-.Dd June 9, 1993
+.Dd May 4, 2010
.Dt GETMNTINFO 3
.Os
.Sh NAME
.Nm getmntinfo
+.Nm getmntinfo64
.Nd get information about mounted file systems
-.Sh LIBRARY
-.Lb libc
.Sh SYNOPSIS
.In sys/param.h
.In sys/ucred.h
.In sys/mount.h
.Ft int
.Fn getmntinfo "struct statfs **mntbufp" "int flags"
+.Sh TRANSITIIONAL SYNOPSIS (NOW DEPRECATED)
+.Ft int
+.br
+.Fn getmntinfo64 "struct statfs64 **mntbufp" "int flags" ;
.Sh DESCRIPTION
The
.Fn getmntinfo
function
returns an array of
-.Fn statfs
+.Ft statfs
structures describing each currently mounted file system (see
.Xr statfs 2 ) .
+As
+.Xr statfs 2
+indicates, the structure is defined differently depending on
+whether the macro _DARWIN_FEATURE_64_BIT_INODE is defined (see
+.Xr stat 2
+for more information on this macro).
.Pp
The
.Fn getmntinfo
@@ -82,9 +91,26 @@ routines
.Xr getfsstat 2
or
.Xr malloc 3 .
+.Sh TRANSITIONAL DESCRIPTION (NOW DEPRECATED)
+The
+.Fn getmntinfo64
+routine is equivalent to its corresponding non-64-suffixed routine,
+when 64-bit inodes are in effect.
+It was added before there was support for the symbol variants, and so is
+now deprecated.
+Instead of using it, set the
+.Dv _DARWIN_USE_64_BIT_INODE
+macro before including header files to force 64-bit inode support.
+.Pp
+The
+.Ft statfs64
+structure used by this deprecated routine is the same as the
+.Ft statfs
+structure when 64-bit inodes are in effect.
.Sh SEE ALSO
.Xr getfsstat 2 ,
.Xr mount 2 ,
+.Xr stat 2 ,
.Xr statfs 2 ,
.Xr mount 8
.Sh HISTORY