summary refs log tree commit diff
path: root/manual/resource.texi
diff options
context:
space:
mode:
authorAdhemerval Zanella <adhemerval.zanella@linaro.org>2020-10-16 14:51:40 -0300
committerAdhemerval Zanella <adhemerval.zanella@linaro.org>2020-10-19 16:44:20 -0300
commitab5ee31e14b2d8cae07710901ed8121941fa4f90 (patch)
tree67f72d47978619249250771e58fca14d21a2a551 /manual/resource.texi
parent75c4044b9a49faaeec245cc3a79a390dde7c804e (diff)
downloadglibc-ab5ee31e14b2d8cae07710901ed8121941fa4f90.tar.gz
glibc-ab5ee31e14b2d8cae07710901ed8121941fa4f90.tar.xz
glibc-ab5ee31e14b2d8cae07710901ed8121941fa4f90.zip
Move vtimes to a compatibility symbol
I couldn't pinpoint which standard has added it, but no other POSIX
system supports it and/or no longer provide it.  The 'struct vtimes'
also has a lot of drawbacks due its limited internal type size.

I couldn't also see find any project that actually uses this symbol,
either in some dignostic way (such as sanitizer).  So I think it should
be safer to just move to compat symbol, instead of deprecated.  The
idea it to avoid new ports to export such broken interface (riscv32
for instance).

Checked on x86_64-linux-gnu and i686-linux-gnu.
Diffstat (limited to 'manual/resource.texi')
-rw-r--r--manual/resource.texi61
1 files changed, 0 insertions, 61 deletions
diff --git a/manual/resource.texi b/manual/resource.texi
index 60e6d61611..37462abc9e 100644
--- a/manual/resource.texi
+++ b/manual/resource.texi
@@ -121,67 +121,6 @@ scheduled).
 @end table
 @end deftp
 
-@code{vtimes} is a historical function that does some of what
-@code{getrusage} does.  @code{getrusage} is a better choice.
-
-@code{vtimes} and its @code{vtimes} data structure are declared in
-@file{sys/vtimes.h}.
-@pindex sys/vtimes.h
-
-@deftypefun int vtimes (struct vtimes *@var{current}, struct vtimes *@var{child})
-@standards{???, sys/vtimes.h}
-@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
-@c Calls getrusage twice.
-
-@code{vtimes} reports resource usage totals for a process.
-
-If @var{current} is non-null, @code{vtimes} stores resource usage totals for
-the invoking process alone in the structure to which it points.  If
-@var{child} is non-null, @code{vtimes} stores resource usage totals for all
-past children (which have terminated) of the invoking process in the structure
-to which it points.
-
-@deftp {Data Type} {struct vtimes}
-This data type contains information about the resource usage of a process.
-Each member corresponds to a member of the @code{struct rusage} data type
-described above.
-
-@table @code
-@item vm_utime
-User CPU time.  Analogous to @code{ru_utime} in @code{struct rusage}
-@item vm_stime
-System CPU time.  Analogous to @code{ru_stime} in @code{struct rusage}
-@item vm_idsrss
-Data and stack memory.  The sum of the values that would be reported as
-@code{ru_idrss} and @code{ru_isrss} in @code{struct rusage}
-@item vm_ixrss
-Shared memory.  Analogous to @code{ru_ixrss} in @code{struct rusage}
-@item vm_maxrss
-Maximent resident set size.  Analogous to @code{ru_maxrss} in
-@code{struct rusage}
-@item vm_majflt
-Major page faults.  Analogous to @code{ru_majflt} in @code{struct rusage}
-@item vm_minflt
-Minor page faults.  Analogous to @code{ru_minflt} in @code{struct rusage}
-@item vm_nswap
-Swap count.  Analogous to @code{ru_nswap} in @code{struct rusage}
-@item vm_inblk
-Disk reads.  Analogous to @code{ru_inblk} in @code{struct rusage}
-@item vm_oublk
-Disk writes.  Analogous to @code{ru_oublk} in @code{struct rusage}
-@end table
-@end deftp
-
-
-The return value is zero if the function succeeds; @code{-1} otherwise.
-
-
-
-@end deftypefun
-An additional historical function for examining resource usage,
-@code{vtimes}, is supported but not documented here.  It is declared in
-@file{sys/vtimes.h}.
-
 @node Limits on Resources
 @section Limiting Resource Usage
 @cindex resource limits