Topic : TOS - The Operating System Author : Version : tos.hyp (December 19, 2008) Subject : Programmieren/Atari Nodes : 3010 Index Size : 93790 HCP-Version : 5 Compiled on : Atari @charset : atarist @lang : @default : Title @help : @options : +g -i -s +x +zz -t4 @width : 70 View Ref-File5.11.9 Tsettimeofday TOS Name: »Tsettimeofday« - Sets the state of the internal, high resolution system clock. Opcode: 342 (0x0156) Syntax: int32_t Tsettimeofday ( timeval *tv, timezone *tzp ); Description: The function Tsettimeofday sets the state of the internal, high resolution system clock. The argument tv is a pointer to the timeval structure. The argument tzp is a pointer to the timezone structure. You may safely pass NULL for either argument. This isn't considered an error. Implementors of library bindings should be aware that the definition of struct timezone is non-standard. The members are actually int and not long int (this applies only to struct timezone; the members of struct timeval are always long). 16-bit libraries will have to copy the contents of the structure that tzp points to. The tz_dsttime member of timezone is stored, but not evaluated within the kernel. Beware not to misunderstand its meaning: if non-zero it simply signifies that daylight savings time applies during some part of the year, not necessarily now. In other words: if it is non-zero someday, it should be non-zero during the entire year. The Ssystem call has a command S_CLOCKMODE. This command allows retrieval or setting of the kernel clock mode, i.e. to specify whether the hardware clock is meant to run in UTC or in local time.(!nl) It is planned to make MiNT compliant with the kernel timekeeping model described in RFC1305. This model is already successfully implemented in operating systems such as SunOS, Ultrix, OSF/1, HP-UX and Linux. Please expect the internal realization to change in the future. Return value: The following error conditions are defined: EPERM - an attempt was made by a user without super- user privileges to change the system time or system time zone information. EBADARG - one of the arguments is out of range. Note that the kernel time cannot be set to dates before Jan 1 1980 00:00:00 and after some day in 2038 (yep, MAX_LONG seconds since the epoch). Timezone offsets must be in the range of +/- 720 minutes. Availability: Available when a MiNT kernel of a version at least 1.15.0 release is detected. Group: Date and Time See Also: Binding Ssystem Tgettimeofday