kc3-lang/gnulib/lib/timespec.h

• Show log

  Commit

• Hash : 88811b7d
  Author :
  Date : 2023-05-14T23:27:51
  

  timespec: fill in other members
  
  This problem was found when compiling GNU Emacs with
  --enable-gcc-warnings on a platform where tv_sec is 64 bits and
  tv_nsec is 32 bits, and struct timespec has padding.  GCC
  -Wuse-of-uninitialized-value complained when a struct timespec
  initialized only via assigning to tv_sec and tv_nsec was copied
  via assignment (this was in lib/timespec.h’s make_timespec).
  Although behavior is well-defined on this platform, the warning is
  annoying and the behavior might not be well-defined on theoretical
  platforms where struct timespec has other members.  To work around
  this, initialize all the struct’s members.
  * lib/getsockopt.c (rpl_getsockopt):
  * lib/gettime.c (gettime):
  * lib/gettimeofday.c (gettimeofday):
  * lib/glthread/thread.c (gl_thread_self):
  * lib/nanosleep.c (nanosleep):
  * lib/parse-datetime.y (digits_to_date_time, set_hhmmss)
  (signed_seconds, unsigned_seconds, yylex, parse_datetime_body):
  * lib/poll.c (poll):
  * lib/pselect.c (pselect):
  * lib/pthread-cond.c (endlessly, pthread_cond_timedwait):
  * lib/pthread-rwlock.c (pthread_rwlock_timedrdlock)
  (pthread_rwlock_timedwrlock):
  * lib/pthread_mutex_timedlock.c (pthread_mutex_timedlock):
  * lib/select.c (rpl_select):
  * lib/settime.c (settime):
  * lib/stat-time.h (get_stat_atime, get_stat_ctime)
  (get_stat_mtime, get_stat_birthtime):
  * lib/thrd.c (rpl_thrd_current):
  * lib/timespec.h (make_timespec):
  * lib/timespec_getres.c (timespec_getres):
  * lib/utimecmp.c (utimecmpat):
  * lib/utimens.c (fdutimens):
  When filling in a struct timespec or similar time-related structure
  that might be copied elsewhere, also assign to any storage other
  than tv_sec and tv_nsec, to avoid undefined behavior on (likely
  theoretical) platforms where struct timespec has other members,
  and also to avoid warnings from GCC and/or valgrind.
  

Download

• lib/timespec.h

• /* timespec -- System time interface
  
     Copyright (C) 2000, 2002, 2004-2005, 2007, 2009-2023 Free Software
     Foundation, Inc.
  
     This file is free software: you can redistribute it and/or modify
     it under the terms of the GNU Lesser General Public License as
     published by the Free Software Foundation, either version 3 of the
     License, or (at your option) any later version.
  
     This file is distributed in the hope that it will be useful,
     but WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     GNU Lesser General Public License for more details.
  
     You should have received a copy of the GNU Lesser General Public License
     along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
  
  #if ! defined TIMESPEC_H
  #define TIMESPEC_H
  
  /* This file uses _GL_INLINE_HEADER_BEGIN, _GL_INLINE, _GL_ATTRIBUTE_CONST,
     _GL_ATTRIBUTE_PURE, _GL_CMP.  */
  #if !_GL_CONFIG_H_INCLUDED
   #error "Please include config.h first."
  #endif
  
  #include <time.h>
  
  _GL_INLINE_HEADER_BEGIN
  #ifndef _GL_TIMESPEC_INLINE
  # define _GL_TIMESPEC_INLINE _GL_INLINE
  #endif
  
  #ifdef __cplusplus
  extern "C" {
  #endif
  
  #include "arg-nonnull.h"
  
  /* Inverse resolution of timespec timestamps (in units per second),
     and log base 10 of the inverse resolution.  */
  
  enum { TIMESPEC_HZ = 1000000000 };
  enum { LOG10_TIMESPEC_HZ = 9 };
  
  /* Obsolescent names for backward compatibility.
     They are misnomers, because TIMESPEC_RESOLUTION is not a resolution.  */
  
  enum { TIMESPEC_RESOLUTION = TIMESPEC_HZ };
  enum { LOG10_TIMESPEC_RESOLUTION = LOG10_TIMESPEC_HZ };
  
  /* Return a timespec with seconds S and nanoseconds NS.  */
  
  _GL_TIMESPEC_INLINE struct timespec
  make_timespec (time_t s, long int ns)
  {
    return (struct timespec) { .tv_sec = s, .tv_nsec = ns };
  }
  
  /* Return negative, zero, positive if A < B, A == B, A > B, respectively.  */
  
  _GL_TIMESPEC_INLINE int _GL_ATTRIBUTE_PURE
  timespec_cmp (struct timespec a, struct timespec b)
  {
    return 2 * _GL_CMP (a.tv_sec, b.tv_sec) + _GL_CMP (a.tv_nsec, b.tv_nsec);
  }
  
  /* Return -1, 0, 1, depending on the sign of A.  A.tv_nsec must be
     nonnegative.  */
  _GL_TIMESPEC_INLINE int _GL_ATTRIBUTE_PURE
  timespec_sign (struct timespec a)
  {
    return _GL_CMP (a.tv_sec, 0) + (!a.tv_sec & !!a.tv_nsec);
  }
  
  struct timespec timespec_add (struct timespec, struct timespec)
    _GL_ATTRIBUTE_CONST;
  struct timespec timespec_sub (struct timespec, struct timespec)
    _GL_ATTRIBUTE_CONST;
  struct timespec dtotimespec (double)
    _GL_ATTRIBUTE_CONST;
  
  /* Return an approximation to A, of type 'double'.  */
  _GL_TIMESPEC_INLINE double
  timespectod (struct timespec a)
  {
    return a.tv_sec + a.tv_nsec / 1e9;
  }
  
  long int gettime_res (void);
  struct timespec current_timespec (void);
  void gettime (struct timespec *) _GL_ARG_NONNULL ((1));
  int settime (struct timespec const *) _GL_ARG_NONNULL ((1));
  
  #ifdef __cplusplus
  }
  #endif
  
  _GL_INLINE_HEADER_END
  
  #endif
  

Download