Merge tag '1.2' into since

Version 1.2

1 files changed, 133 insertions, 0 deletions

diff --git a/man3/libsimple_gmtime.3 b/man3/libsimple_gmtime.3
new file mode 100644
index 0000000..be050f2
--- /dev/null
+++ b/man3/libsimple_gmtime.3
@@ -0,0 +1,133 @@
+.TH LIBSIMPLE_GMTIME 3 libsimple
+.SH NAME
+libsimple_gmtime \- get the current UTC time with leap second adjustment
+
+.SH SYNOPSIS
+.nf
+#include <libsimple.h>
+
+int libsimple_gmtime(struct tm *\fItm\fP, struct timespec *\fIts\fP);
+static inline void libsimple_engmtime(int \fIstatus\fPstruct tm *\fItm\fP, struct timespec *\fIts\fP);
+static inline void libsimple_egmtime(struct tm *\fItm\fP, struct timespec *\fIts\fP);
+.fi
+.PP
+Link with
+.IR \-lsimple .
+
+.SH DESCRIPTION
+The
+.BR libsimple_gmtime (),
+.BR libsimple_engmtime (),
+and
+.BR libsimple_egmtime ()
+functions get the current UTC time, with adjustments
+for leap seconds insertions and deletions.
+.PP
+The
+.BR libsimple_engmtime ()
+and
+.BR libsimple_egmtime ()
+functions will terminate the process on failure.
+On failure, the process's exit value will be
+.I status
+if the
+.BR libsimple_engmtime ()
+function is used or
+.IR libsimple_default_failure_exit (3)
+if the
+.BR libsimple_egmtime ()
+fucntion is used.
+.PP
+The local time is stored in
+.IR *tm ,
+and the POSIX time (not timezone adjusted),
+with leap second adjustments, is stored in
+.I *ts
+unless
+.I ts
+is
+.IR NULL .
+.I tm
+may
+.I not
+be
+.RI NULL .
+
+.SH RETURN VALUE
+The
+.BR libsimple_gmtime ()
+function return a 0 upon successful completion;
+otherwise the they return -1 and set
+.I errno
+to indicate the error. The
+.BR libsimple_engmtime ()
+and
+.BR libsimple_egmtime ()
+functions terminate the processes on failure.
+
+.SH ERRORS
+The
+.BR libsimple_gmtime ()
+function will fail for the reasons specified for the
+.BR gmtime_r (3)
+function.
+.PP
+The
+.BR libsimple_engmtime ()
+and
+.BR libsimple_egmtime ()
+functions will terminate the process on failure.
+
+.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_gmtime (),
+.br
+.BR libsimple_engmtime (),
+.br
+.BR libsimple_egmtime ()
+T}	Thread safety	MT-Safe
+T{
+.BR libsimple_gmtime (),
+.br
+.BR libsimple_engmtime (),
+.br
+.BR libsimple_egmtime ()
+T}	Async-signal safety	AS-Safe
+T{
+.BR libsimple_gmtime (),
+.br
+.BR libsimple_engmtime (),
+.br
+.BR libsimple_egmtime ()
+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_gmtime (3),
+.BR ntp_adjtime (2),
+.BR gmtime_r (3)