glibc/include/sys
Zack Weinberg c3f9aef063 Use clock_settime to implement settimeofday.
Unconditionally, on all ports, use clock_settime to implement
settimeofday.  Remove sysdeps/unix/clock_settime.c, which implemented
clock_settime by calling settimeofday; new OS ports must henceforth
provide a real implementation of clock_settime.

Hurd had a real implementation of settimeofday but not of
clock_settime; this patch converts it into an implementation of
clock_settime.  It only supports CLOCK_REALTIME and microsecond
resolution; Hurd/Mach does not appear to have any support for
finer-resolution clocks.

The vestigial "set time zone" feature of settimeofday complicates the
generic settimeofday implementation a little.  The only remaining uses
of this feature that aren't just bugs, are using it to inform the
Linux kernel of the offset between the hardware clock and UTC, on
systems where the hardware clock doesn't run in UTC (usually because
of dual-booting with Windows).  There currently isn't any other way to
do this.  However, the callers that do this call settimeofday with
_only_ the timezone argument non-NULL.  Therefore, glibc's new
behavior is: callers of settimeofday must supply one and only one of
the two arguments.  If both arguments are non-NULL, or both arguments
are NULL, the call fails and sets errno to EINVAL.

When only the timeval argument is supplied, settimeofday calls
__clock_settime(CLOCK_REALTIME), same as stime.

When only the timezone argument is supplied, settimeofday calls a new
internal function called __settimezone.  On Linux, only, this function
will pass the timezone structure to the settimeofday system call.  On
all other operating systems, and on Linux architectures that don't
define __NR_settimeofday, __settimezone is a stub that always sets
errno to ENOSYS and returns -1.

The settimeoday syscall is enabled on Linux by the flag
COMPAT_32BIT_TIME, which is an option to either 32-bits ABIs or COMPAT
builds (defined usually by 64-bit kernels that want to support 32-bit
 ABIs, such as x86).  The idea to future 64-bit time_t only ABIs
is to not provide settimeofday syscall.

The same semantics are implemented for Linux/Alpha's GLIBC_2.0 compat
symbol for settimeofday.

There are no longer any internal callers of __settimeofday, so the
internal prototype is removed.

Checked on x86_64-linux-gnu, i686-linux-gnu, powerpc64le-linux-gnu,
powerpc64-linux-gnu, powerpc-linux-gnu, and aarch64-linux-gnu.

Reviewed-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>
Reviewed-by: Lukasz Majewski <lukma@denx.de>
2019-10-30 17:05:14 -03:00
..
auxv.h
bitypes.h
cdefs.h
dir.h
epoll.h
errno.h
fcntl.h
file.h
gmon_out.h
gmon.h
ioctl.h
ipc.h
mman.h
msg.h
param.h
poll.h
prctl.h
profil.h
queue.h
random.h
resource.h
select.h
sem.h sysvipc: Implement semop based on semtimedop 2019-10-17 11:05:40 -03:00
sendfile.h
shm.h
signal.h
socket.h
stat.h
statfs.h
statvfs.h
sysctl.h Linux: Deprecate <sys/sysctl.h> and sysctl 2019-06-12 14:32:08 +02:00
sysinfo.h
syslog.h
sysmacros.h Prefer https to http for gnu.org and fsf.org URLs 2019-09-07 02:43:31 -07:00
termios.h
time.h Use clock_settime to implement settimeofday. 2019-10-30 17:05:14 -03:00
timeb.h
times.h
ttychars.h
types.h
uio.h
un.h
unistd.h
utsname.h
vfs.h
vlimit.h
vtimes.h
wait.h
xattr.h