Subversion Repositories openrisc_2011-10-31

/*

 * gmtime.c

 * Original Author:     G. Haley

 *

 * Converts the calendar time pointed to by tim_p into a broken-down time

 * expressed as Greenwich Mean Time (GMT). Returns a pointer to a structure

 * containing the broken-down time, or a null pointer if GMT is not

 * available.

 */

/*

FUNCTION

<<gmtime>>---convert time to UTC traditional form

INDEX

        gmtime

INDEX

        gmtime_r

ANSI_SYNOPSIS

        #include <time.h>

        struct tm *gmtime(const time_t *<[clock]>);

        struct tm *gmtime_r(const time_t *<[clock]>, struct tm *<[res]>);

TRAD_SYNOPSIS

        #include <time.h>

        struct tm *gmtime(<[clock]>)

        const time_t *<[clock]>;

        struct tm *gmtime_r(<[clock]>, <[res]>)

        const time_t *<[clock]>;

        struct tm *<[res]>;

DESCRIPTION

<<gmtime>> takes the time at <[clock]> representing the number

of elapsed seconds since 00:00:00 on January 1, 1970, Universal

Coordinated Time (UTC, also known in some countries as GMT,

Greenwich Mean time) and converts it to a <<struct tm>>

representation.

<<gmtime>> constructs the traditional time representation in static

storage; each call to <<gmtime>> or <<localtime>> will overwrite the

information generated by previous calls to either function.

RETURNS

A pointer to the traditional time representation (<<struct tm>>).

PORTABILITY

ANSI C requires <<gmtime>>.

<<gmtime>> requires no supporting OS subroutines.

*/

#include <stdlib.h>

#include <time.h>

#define _GMT_OFFSET 0

#ifndef _REENT_ONLY

struct tm *

_DEFUN (gmtime, (tim_p),

        _CONST time_t * tim_p)

{

  _REENT_CHECK_TM(_REENT);

  return gmtime_r (tim_p, (struct tm *)_REENT_TM(_REENT));

}

#endif