[BACK]Return to times.3 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / lib / libc / gen

Annotation of src/lib/libc/gen/times.3, Revision 1.5

1.5     ! kleink      1: .\"    $NetBSD: times.3,v 1.4 1995/02/27 05:54:02 cgd Exp $
1.4       cgd         2: .\"
                      3: .\" Copyright (c) 1990, 1991, 1993
                      4: .\"    The Regents of the University of California.  All rights reserved.
1.1       cgd         5: .\"
                      6: .\" Redistribution and use in source and binary forms, with or without
                      7: .\" modification, are permitted provided that the following conditions
                      8: .\" are met:
                      9: .\" 1. Redistributions of source code must retain the above copyright
                     10: .\"    notice, this list of conditions and the following disclaimer.
                     11: .\" 2. Redistributions in binary form must reproduce the above copyright
                     12: .\"    notice, this list of conditions and the following disclaimer in the
                     13: .\"    documentation and/or other materials provided with the distribution.
                     14: .\" 3. All advertising materials mentioning features or use of this software
                     15: .\"    must display the following acknowledgement:
                     16: .\"    This product includes software developed by the University of
                     17: .\"    California, Berkeley and its contributors.
                     18: .\" 4. Neither the name of the University nor the names of its contributors
                     19: .\"    may be used to endorse or promote products derived from this software
                     20: .\"    without specific prior written permission.
                     21: .\"
                     22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
                     23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
                     24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
                     25: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
                     26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
                     27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
                     28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
                     29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
                     30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
                     31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
                     32: .\" SUCH DAMAGE.
                     33: .\"
1.4       cgd        34: .\"     @(#)times.3    8.1 (Berkeley) 6/4/93
1.1       cgd        35: .\"
1.4       cgd        36: .Dd June 4, 1993
1.1       cgd        37: .Dt TIMES 3
                     38: .Os BSD 4
                     39: .Sh NAME
                     40: .Nm times
                     41: .Nd process times
                     42: .Sh SYNOPSIS
                     43: .Fd #include <sys/times.h>
                     44: .Ft clock_t
                     45: .Fn times "struct tms *tp"
                     46: .Sh DESCRIPTION
                     47: .Bf -symbolic
                     48: This interface is obsoleted by getrusage(2)
                     49: and gettimeofday(3).
                     50: .Ef
                     51: .Pp
                     52: The
                     53: .Fn times
                     54: function returns the value of time in
                     55: .Dv CLK_TCK Ns 's
                     56: of a second since
                     57: 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated Universal
                     58: Time.
                     59: .Pp
                     60: It also fills in the structure pointed to by
                     61: .Fa tp
                     62: with time-accounting information.
                     63: .Pp
                     64: The
                     65: .Fa tms
                     66: structure is defined as follows:
                     67: .Bd -literal -offset indent
                     68: typedef struct {
                     69:        clock_t tms_utime;
                     70:        clock_t tms_stime;
                     71:        clock_t tms_cutime;
                     72:        clock_t tms_cstime;
                     73: }
                     74: .Ed
                     75: .Pp
                     76: The elements of this structure are defined as follows:
                     77: .Bl -tag -width tms_cutime
                     78: .It Fa tms_utime
                     79: The
                     80: .Tn CPU
                     81: time charged for the execution of user instructions.
                     82: .It Fa tms_stime
                     83: The
                     84: .Tn CPU
                     85: time charged for execution by the system on behalf of
                     86: the process.
                     87: .It Fa tms_cutime
                     88: The sum of the
                     89: .Fa tms_utime  s
                     90: and
                     91: .Fa tms_cutime  s
                     92: of the child processes.
                     93: .It Fa tms_cstime
                     94: The sum of the
                     95: .Fa tms_stime Ns s
                     96: and
                     97: .Fa tms_cstime Ns s
                     98: of the child processes.
                     99: .El
                    100: .Pp
                    101: All times are in
                    102: .Dv CLK_TCK Ns 's
                    103: of a second.
                    104: .Pp
                    105: The times of a terminated child process are included in the
                    106: .Fa tms_cutime
                    107: and
                    108: .Fa tms_cstime
                    109: elements of the parent when one of the
                    110: .Xr wait 2
                    111: functions returns the process ID of the terminated child to the parent.
                    112: If an error occurs,
                    113: .Fn times
                    114: returns the value
                    115: .Pq (clock_t)\-1 ,
1.3       jtc       116: and sets
                    117: .Va errno
                    118: to indicate the error.
1.1       cgd       119: .Sh ERRORS
                    120: The
                    121: .Fn times
                    122: function
                    123: may fail and set the global variable
                    124: .Va errno
                    125: for any of the errors specified for the library
                    126: routines
                    127: .Xr getrusage 2
                    128: and
                    129: .Xr gettimeofday 2 .
                    130: .Sh SEE ALSO
                    131: .Xr time 1 ,
                    132: .Xr getrusage 2 ,
                    133: .Xr gettimeofday 2 ,
                    134: .Xr wait 2
                    135: .Sh STANDARDS
                    136: The
                    137: .Fn times
1.5     ! kleink    138: function conforms to
        !           139: .St -p1003.1-90 .

CVSweb <webmaster@jp.NetBSD.org>