From 9fc2b129167e1f2a16d942369f057f618a00d81c Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 7 Nov 2018 22:18:04 +0100 Subject: Move section 3 man pages to man3/ and add libsimple.h.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- man3/libsimple_sumtimespec.3 | 115 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 115 insertions(+) create mode 100644 man3/libsimple_sumtimespec.3 (limited to 'man3/libsimple_sumtimespec.3') diff --git a/man3/libsimple_sumtimespec.3 b/man3/libsimple_sumtimespec.3 new file mode 100644 index 0000000..81632b8 --- /dev/null +++ b/man3/libsimple_sumtimespec.3 @@ -0,0 +1,115 @@ +.TH LIBSIMPLE_SUMTIMESPEC 3 2018-10-29 libsimple +.SH NAME +libsimple_sumtimespec, libsimple_sumtimeval \- calculate the sum of two durations +.SH SYNOPSIS +.nf +#include + +int libsimple_sumtimespec(struct timespec *\fIsum\fP, const struct timespec *\fIaugend\fP, const struct timespec *\fIaddend\fP); +int libsimple_sumtimeval(struct timeval *\fIsum\fP, const struct timeval *\fIaugend\fP, const struct timeval *\fIaddend\fP); + +#ifndef sumtimespec +# define sumtimespec libsimple_sumtimespec +#endif +#ifndef sumtimeval +# define sumtimeval libsimple_sumtimeval +#endif +.fi +.PP +Link with +.IR \-lsimple . +.SH DESCRIPTION +The +.BR libsimple_sumtimespec () +and +.BR libsimple_sumtimeval () +functions calculates the sum of +.I augend +and +.I addend +and stores the result in +.IR sum . +.SH RETURN VALUE +The +.BR libsimple_sumtimespec () +and +.BR libsimple_sumtimeval () +functions return 0 on successful completion; +otherwise, \-1 is returned and +.I errno +is set to indicate the error. +.SH ERRORS +The +.BR libsimple_sumtimespec () +and +.BR libsimple_sumtimeval () +functions fail if: +.TP +.B ERANGE +The result is too large or too small to be stored; if the +result is too large +.I *sum +will be set to +.I {.tv_sec=TIME_MAX,.tv_nsec=999999999L} +for the +.BR libsimple_sumtimespec () +function and to +.I {.tv_sec=TIME_MAX,.tv_usec=999999L} +for the +.BR libsimple_sumtimeval () +function, if the result is too small +.I *sum +will be set to +.I {.tv_sec=TIME_MIN,.tv_nsec=0} +for the +.BR libsimple_sumtimespec () +function and to +.I {.tv_sec=TIME_MIN,.tv_usec=0} +for the +.BR libsimple_sumtimeval () +function. +.SH ATTRIBUTES +For an explanation of the terms used in this section, see +.BR attributes (7). +.TS +allbox; +lb lb lb +l l l. +Interface Attribute Value +T{ +.BR libsimple_sumtimespec () +.br +.BR libsimple_sumtimeval () +T} Thread safety MT-Safe +T{ +.BR libsimple_sumtimespec () +.br +.BR libsimple_sumtimeval () +T} Async-signal safety AS-Safe +T{ +.BR libsimple_sumtimespec () +.br +.BR libsimple_sumtimeval () +T} Async-cancel safety AC-Safe +.TE +.SH EXAMPLES +None. +.SH APPLICATION USAGE +None. +.SH RATIONALE +None. +.SH FUTURE DIRECTIONS +None. +.SH NOTES +None. +.SH BUGS +None. +.SH SEE ALSO +.BR libsimple_difftimespec (3), +.BR libsimple_multimespec (3), +.BR libsimple_cmptimespec (3), +.BR libsimple_timespectostr (3), +.BR libsimple_strtotimespec (3), +.BR libsimple_timespectodouble (3), +.BR libsimple_doubletotimespec (3), +.BR libsimple_timeval2timespec (3) -- cgit v1.2.3-70-g09d2