gen/FreeBSD/getmntinfo.3.patch

   1 --- getmntinfo.3.orig   2010-06-17 09:25:28.000000000 -0700
   2 +++ getmntinfo.3        2010-06-17 09:26:43.000000000 -0700
   3 @@ -28,28 +28,37 @@
   4  .\"     @(#)getmntinfo.3       8.1 (Berkeley) 6/9/93
   5  .\" $FreeBSD: src/lib/libc/gen/getmntinfo.3,v 1.13 2007/01/09 00:27:54 imp Exp $
   6  .\"
   7 -.Dd June 9, 1993
   8 +.Dd May 4, 2010
   9  .Dt GETMNTINFO 3
  10  .Os
  11  .Sh NAME
  12  .Nm getmntinfo
  13 +.Nm getmntinfo64
  14  .Nd get information about mounted file systems
  15 -.Sh LIBRARY
  16 -.Lb libc
  17  .Sh SYNOPSIS
  18  .In sys/param.h
  19  .In sys/ucred.h
  20  .In sys/mount.h
  21  .Ft int
  22  .Fn getmntinfo "struct statfs **mntbufp" "int flags"
  23 +.Sh TRANSITIIONAL SYNOPSIS (NOW DEPRECATED)
  24 +.Ft int
  25 +.br
  26 +.Fn getmntinfo64 "struct statfs64 **mntbufp" "int flags" ;
  27  .Sh DESCRIPTION
  28  The
  29  .Fn getmntinfo
  30  function
  31  returns an array of
  32 -.Fn statfs
  33 +.Ft statfs
  34  structures describing each currently mounted file system (see
  35  .Xr statfs 2 ) .
  36 +As
  37 +.Xr statfs 2
  38 +indicates, the structure is defined differently depending on
  39 +whether the macro _DARWIN_FEATURE_64_BIT_INODE is defined (see
  40 +.Xr stat 2
  41 +for more information on this macro).
  42  .Pp
  43  The
  44  .Fn getmntinfo
  45 @@ -82,9 +91,26 @@ routines
  46  .Xr getfsstat 2
  47  or
  48  .Xr malloc 3 .
  49 +.Sh TRANSITIONAL DESCRIPTION (NOW DEPRECATED)
  50 +The
  51 +.Fn getmntinfo64
  52 +routine is equivalent to its corresponding non-64-suffixed routine,
  53 +when 64-bit inodes are in effect.
  54 +It was added before there was support for the symbol variants, and so is
  55 +now deprecated.
  56 +Instead of using it, set the
  57 +.Dv _DARWIN_USE_64_BIT_INODE
  58 +macro before including header files to force 64-bit inode support.
  59 +.Pp
  60 +The
  61 +.Ft statfs64
  62 +structure used by this deprecated routine is the same as the
  63 +.Ft statfs
  64 +structure when 64-bit inodes are in effect.
  65  .Sh SEE ALSO
  66  .Xr getfsstat 2 ,
  67  .Xr mount 2 ,
  68 +.Xr stat 2 ,
  69  .Xr statfs 2 ,
  70  .Xr mount 8
  71  .Sh HISTORY