gen/FreeBSD/getmntinfo.3.patch

   1 --- getmntinfo.3.orig   2007-01-21 11:53:36.000000000 -0800
   2 +++ getmntinfo.3        2007-01-21 17:19:17.000000000 -0800
   3 @@ -46,14 +46,22 @@
   4  .In sys/mount.h
   5  .Ft int
   6  .Fn getmntinfo "struct statfs **mntbufp" "int flags"
   7 +.Ft int
   8 +.Fn getmntinfo64 "struct statfs64 **mntbufp" "int flags"
   9  .Sh DESCRIPTION
  10  The
  11  .Fn getmntinfo
  12  function
  13  returns an array of
  14 -.Fn statfs
  15 +.Ft statfs
  16  structures describing each currently mounted file system (see
  17  .Xr statfs 2 ) .
  18 +Likewise, the
  19 +.Fn getmntinfo64
  20 +function
  21 +returns an array of
  22 +.Ft statfs64
  23 +structures describing each currently mounted file system.
  24  .Pp
  25  The
  26  .Fn getmntinfo
  27 @@ -61,11 +69,20 @@
  28  passes its
  29  .Fa flags
  30  argument transparently to
  31 -.Xr getfsstat 2 .
  32 +.Xr getfsstat 2 ,
  33 +while the
  34 +.Fn getmntinfo64
  35 +function
  36 +passes its
  37 +.Fa flags
  38 +argument transparently to
  39 +.Fn getfsstat64 .
  40  .Sh RETURN VALUES
  41  On successful completion,
  42  .Fn getmntinfo
  43 -returns a count of the number of elements in the array.
  44 +and
  45 +.Fn getmntinfo64
  46 +return a count of the number of elements in the array.
  47  The pointer to the array is stored into
  48  .Fa mntbufp .
  49  .Pp
  50 @@ -76,11 +93,15 @@
  51  .Fa mntbufp
  52  will be unmodified, any information previously returned by
  53  .Fn getmntinfo
  54 +or
  55 +.Fn getmntinfo64
  56  will be lost.
  57  .Sh ERRORS
  58  The
  59  .Fn getmntinfo
  60 -function
  61 +and
  62 +.Fn getmntinfo64
  63 +functions
  64  may fail and set errno for any of the errors specified for the library
  65  routines
  66  .Xr getfsstat 2
  67 @@ -99,15 +120,21 @@
  68  .Sh BUGS
  69  The
  70  .Fn getmntinfo
  71 -function writes the array of structures to an internal static object
  72 +and
  73 +.Fn getmntinfo64
  74 +functions write the array of structures to an internal static object
  75  and returns
  76  a pointer to that object.
  77  Subsequent calls to
  78  .Fn getmntinfo
  79 +and
  80 +.Fn getmntinfo64
  81  will modify the same object.
  82  .Pp
  83  The memory allocated by
  84  .Fn getmntinfo
  85 +and
  86 +.Fn getmntinfo64
  87  cannot be
  88  .Xr free 3 Ns 'd
  89  by the application.