diff options
author | Adhemerval Zanella <adhemerval.zanella@linaro.org> | 2020-10-16 14:51:40 -0300 |
---|---|---|
committer | Adhemerval Zanella <adhemerval.zanella@linaro.org> | 2020-10-19 16:44:20 -0300 |
commit | ab5ee31e14b2d8cae07710901ed8121941fa4f90 (patch) | |
tree | 67f72d47978619249250771e58fca14d21a2a551 /manual/resource.texi | |
parent | 75c4044b9a49faaeec245cc3a79a390dde7c804e (diff) | |
download | glibc-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.texi | 61 |
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 |