1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * Copyright (C) 1991, 1992 Linus Torvalds 4 * 5 * This file contains the interface functions for the various time related 6 * system calls: time, stime, gettimeofday, settimeofday, adjtime 7 * 8 * Modification history: 9 * 10 * 1993-09-02 Philip Gladstone 11 * Created file with time related functions from sched/core.c and adjtimex() 12 * 1993-10-08 Torsten Duwe 13 * adjtime interface update and CMOS clock write code 14 * 1995-08-13 Torsten Duwe 15 * kernel PLL updated to 1994-12-13 specs (rfc-1589) 16 * 1999-01-16 Ulrich Windl 17 * Introduced error checking for many cases in adjtimex(). 18 * Updated NTP code according to technical memorandum Jan '96 19 * "A Kernel Model for Precision Timekeeping" by Dave Mills 20 * Allow time_constant larger than MAXTC(6) for NTP v4 (MAXTC == 10) 21 * (Even though the technical memorandum forbids it) 22 * 2004-07-14 Christoph Lameter 23 * Added getnstimeofday to allow the posix timer functions to return 24 * with nanosecond accuracy 25 */ 26 27 #include <linux/export.h> 28 #include <linux/kernel.h> 29 #include <linux/timex.h> 30 #include <linux/capability.h> 31 #include <linux/timekeeper_internal.h> 32 #include <linux/errno.h> 33 #include <linux/syscalls.h> 34 #include <linux/security.h> 35 #include <linux/fs.h> 36 #include <linux/math64.h> 37 #include <linux/ptrace.h> 38 39 #include <linux/uaccess.h> 40 #include <linux/compat.h> 41 #include <asm/unistd.h> 42 43 #include <generated/timeconst.h> 44 #include "timekeeping.h" 45 46 /* 47 * The timezone where the local system is located. Used as a default by some 48 * programs who obtain this value by using gettimeofday. 49 */ 50 struct timezone sys_tz; 51 52 EXPORT_SYMBOL(sys_tz); 53 54 #ifdef __ARCH_WANT_SYS_TIME 55 56 /* 57 * sys_time() can be implemented in user-level using 58 * sys_gettimeofday(). Is this for backwards compatibility? If so, 59 * why not move it into the appropriate arch directory (for those 60 * architectures that need it). 61 */ 62 SYSCALL_DEFINE1(time, __kernel_old_time_t __user *, tloc) 63 { 64 __kernel_old_time_t i = (__kernel_old_time_t)ktime_get_real_seconds(); 65 66 if (tloc) { 67 if (put_user(i,tloc)) 68 return -EFAULT; 69 } 70 force_successful_syscall_return(); 71 return i; 72 } 73 74 /* 75 * sys_stime() can be implemented in user-level using 76 * sys_settimeofday(). Is this for backwards compatibility? If so, 77 * why not move it into the appropriate arch directory (for those 78 * architectures that need it). 79 */ 80 81 SYSCALL_DEFINE1(stime, __kernel_old_time_t __user *, tptr) 82 { 83 struct timespec64 tv; 84 int err; 85 86 if (get_user(tv.tv_sec, tptr)) 87 return -EFAULT; 88 89 tv.tv_nsec = 0; 90 91 err = security_settime64(&tv, NULL); 92 if (err) 93 return err; 94 95 do_settimeofday64(&tv); 96 return 0; 97 } 98 99 #endif /* __ARCH_WANT_SYS_TIME */ 100 101 #ifdef CONFIG_COMPAT_32BIT_TIME 102 #ifdef __ARCH_WANT_SYS_TIME32 103 104 /* old_time32_t is a 32 bit "long" and needs to get converted. */ 105 SYSCALL_DEFINE1(time32, old_time32_t __user *, tloc) 106 { 107 old_time32_t i; 108 109 i = (old_time32_t)ktime_get_real_seconds(); 110 111 if (tloc) { 112 if (put_user(i,tloc)) 113 return -EFAULT; 114 } 115 force_successful_syscall_return(); 116 return i; 117 } 118 119 SYSCALL_DEFINE1(stime32, old_time32_t __user *, tptr) 120 { 121 struct timespec64 tv; 122 int err; 123 124 if (get_user(tv.tv_sec, tptr)) 125 return -EFAULT; 126 127 tv.tv_nsec = 0; 128 129 err = security_settime64(&tv, NULL); 130 if (err) 131 return err; 132 133 do_settimeofday64(&tv); 134 return 0; 135 } 136 137 #endif /* __ARCH_WANT_SYS_TIME32 */ 138 #endif 139 140 SYSCALL_DEFINE2(gettimeofday, struct __kernel_old_timeval __user *, tv, 141 struct timezone __user *, tz) 142 { 143 if (likely(tv != NULL)) { 144 struct timespec64 ts; 145 146 ktime_get_real_ts64(&ts); 147 if (put_user(ts.tv_sec, &tv->tv_sec) || 148 put_user(ts.tv_nsec / 1000, &tv->tv_usec)) 149 return -EFAULT; 150 } 151 if (unlikely(tz != NULL)) { 152 if (copy_to_user(tz, &sys_tz, sizeof(sys_tz))) 153 return -EFAULT; 154 } 155 return 0; 156 } 157 158 /* 159 * In case for some reason the CMOS clock has not already been running 160 * in UTC, but in some local time: The first time we set the timezone, 161 * we will warp the clock so that it is ticking UTC time instead of 162 * local time. Presumably, if someone is setting the timezone then we 163 * are running in an environment where the programs understand about 164 * timezones. This should be done at boot time in the /etc/rc script, 165 * as soon as possible, so that the clock can be set right. Otherwise, 166 * various programs will get confused when the clock gets warped. 167 */ 168 169 int do_sys_settimeofday64(const struct timespec64 *tv, const struct timezone *tz) 170 { 171 static int firsttime = 1; 172 int error = 0; 173 174 if (tv && !timespec64_valid_settod(tv)) 175 return -EINVAL; 176 177 error = security_settime64(tv, tz); 178 if (error) 179 return error; 180 181 if (tz) { 182 /* Verify we're within the +-15 hrs range */ 183 if (tz->tz_minuteswest > 15*60 || tz->tz_minuteswest < -15*60) 184 return -EINVAL; 185 186 sys_tz = *tz; 187 update_vsyscall_tz(); 188 if (firsttime) { 189 firsttime = 0; 190 if (!tv) 191 timekeeping_warp_clock(); 192 } 193 } 194 if (tv) 195 return do_settimeofday64(tv); 196 return 0; 197 } 198 199 SYSCALL_DEFINE2(settimeofday, struct __kernel_old_timeval __user *, tv, 200 struct timezone __user *, tz) 201 { 202 struct timespec64 new_ts; 203 struct timezone new_tz; 204 205 if (tv) { 206 if (get_user(new_ts.tv_sec, &tv->tv_sec) || 207 get_user(new_ts.tv_nsec, &tv->tv_usec)) 208 return -EFAULT; 209 210 if (new_ts.tv_nsec > USEC_PER_SEC || new_ts.tv_nsec < 0) 211 return -EINVAL; 212 213 new_ts.tv_nsec *= NSEC_PER_USEC; 214 } 215 if (tz) { 216 if (copy_from_user(&new_tz, tz, sizeof(*tz))) 217 return -EFAULT; 218 } 219 220 return do_sys_settimeofday64(tv ? &new_ts : NULL, tz ? &new_tz : NULL); 221 } 222 223 #ifdef CONFIG_COMPAT 224 COMPAT_SYSCALL_DEFINE2(gettimeofday, struct old_timeval32 __user *, tv, 225 struct timezone __user *, tz) 226 { 227 if (tv) { 228 struct timespec64 ts; 229 230 ktime_get_real_ts64(&ts); 231 if (put_user(ts.tv_sec, &tv->tv_sec) || 232 put_user(ts.tv_nsec / 1000, &tv->tv_usec)) 233 return -EFAULT; 234 } 235 if (tz) { 236 if (copy_to_user(tz, &sys_tz, sizeof(sys_tz))) 237 return -EFAULT; 238 } 239 240 return 0; 241 } 242 243 COMPAT_SYSCALL_DEFINE2(settimeofday, struct old_timeval32 __user *, tv, 244 struct timezone __user *, tz) 245 { 246 struct timespec64 new_ts; 247 struct timezone new_tz; 248 249 if (tv) { 250 if (get_user(new_ts.tv_sec, &tv->tv_sec) || 251 get_user(new_ts.tv_nsec, &tv->tv_usec)) 252 return -EFAULT; 253 254 if (new_ts.tv_nsec > USEC_PER_SEC || new_ts.tv_nsec < 0) 255 return -EINVAL; 256 257 new_ts.tv_nsec *= NSEC_PER_USEC; 258 } 259 if (tz) { 260 if (copy_from_user(&new_tz, tz, sizeof(*tz))) 261 return -EFAULT; 262 } 263 264 return do_sys_settimeofday64(tv ? &new_ts : NULL, tz ? &new_tz : NULL); 265 } 266 #endif 267 268 #ifdef CONFIG_64BIT 269 SYSCALL_DEFINE1(adjtimex, struct __kernel_timex __user *, txc_p) 270 { 271 struct __kernel_timex txc; /* Local copy of parameter */ 272 int ret; 273 274 /* Copy the user data space into the kernel copy 275 * structure. But bear in mind that the structures 276 * may change 277 */ 278 if (copy_from_user(&txc, txc_p, sizeof(struct __kernel_timex))) 279 return -EFAULT; 280 ret = do_adjtimex(&txc); 281 return copy_to_user(txc_p, &txc, sizeof(struct __kernel_timex)) ? -EFAULT : ret; 282 } 283 #endif 284 285 #ifdef CONFIG_COMPAT_32BIT_TIME 286 int get_old_timex32(struct __kernel_timex *txc, const struct old_timex32 __user *utp) 287 { 288 struct old_timex32 tx32; 289 290 memset(txc, 0, sizeof(struct __kernel_timex)); 291 if (copy_from_user(&tx32, utp, sizeof(struct old_timex32))) 292 return -EFAULT; 293 294 txc->modes = tx32.modes; 295 txc->offset = tx32.offset; 296 txc->freq = tx32.freq; 297 txc->maxerror = tx32.maxerror; 298 txc->esterror = tx32.esterror; 299 txc->status = tx32.status; 300 txc->constant = tx32.constant; 301 txc->precision = tx32.precision; 302 txc->tolerance = tx32.tolerance; 303 txc->time.tv_sec = tx32.time.tv_sec; 304 txc->time.tv_usec = tx32.time.tv_usec; 305 txc->tick = tx32.tick; 306 txc->ppsfreq = tx32.ppsfreq; 307 txc->jitter = tx32.jitter; 308 txc->shift = tx32.shift; 309 txc->stabil = tx32.stabil; 310 txc->jitcnt = tx32.jitcnt; 311 txc->calcnt = tx32.calcnt; 312 txc->errcnt = tx32.errcnt; 313 txc->stbcnt = tx32.stbcnt; 314 315 return 0; 316 } 317 318 int put_old_timex32(struct old_timex32 __user *utp, const struct __kernel_timex *txc) 319 { 320 struct old_timex32 tx32; 321 322 memset(&tx32, 0, sizeof(struct old_timex32)); 323 tx32.modes = txc->modes; 324 tx32.offset = txc->offset; 325 tx32.freq = txc->freq; 326 tx32.maxerror = txc->maxerror; 327 tx32.esterror = txc->esterror; 328 tx32.status = txc->status; 329 tx32.constant = txc->constant; 330 tx32.precision = txc->precision; 331 tx32.tolerance = txc->tolerance; 332 tx32.time.tv_sec = txc->time.tv_sec; 333 tx32.time.tv_usec = txc->time.tv_usec; 334 tx32.tick = txc->tick; 335 tx32.ppsfreq = txc->ppsfreq; 336 tx32.jitter = txc->jitter; 337 tx32.shift = txc->shift; 338 tx32.stabil = txc->stabil; 339 tx32.jitcnt = txc->jitcnt; 340 tx32.calcnt = txc->calcnt; 341 tx32.errcnt = txc->errcnt; 342 tx32.stbcnt = txc->stbcnt; 343 tx32.tai = txc->tai; 344 if (copy_to_user(utp, &tx32, sizeof(struct old_timex32))) 345 return -EFAULT; 346 return 0; 347 } 348 349 SYSCALL_DEFINE1(adjtimex_time32, struct old_timex32 __user *, utp) 350 { 351 struct __kernel_timex txc; 352 int err, ret; 353 354 err = get_old_timex32(&txc, utp); 355 if (err) 356 return err; 357 358 ret = do_adjtimex(&txc); 359 360 err = put_old_timex32(utp, &txc); 361 if (err) 362 return err; 363 364 return ret; 365 } 366 #endif 367 368 #if HZ > MSEC_PER_SEC || (MSEC_PER_SEC % HZ) 369 /** 370 * jiffies_to_msecs - Convert jiffies to milliseconds 371 * @j: jiffies value 372 * 373 * Return: milliseconds value 374 */ 375 unsigned int jiffies_to_msecs(const unsigned long j) 376 { 377 #if HZ > MSEC_PER_SEC && !(HZ % MSEC_PER_SEC) 378 return (j + (HZ / MSEC_PER_SEC) - 1)/(HZ / MSEC_PER_SEC); 379 #else 380 # if BITS_PER_LONG == 32 381 return (HZ_TO_MSEC_MUL32 * j + (1ULL << HZ_TO_MSEC_SHR32) - 1) >> 382 HZ_TO_MSEC_SHR32; 383 # else 384 return DIV_ROUND_UP(j * HZ_TO_MSEC_NUM, HZ_TO_MSEC_DEN); 385 # endif 386 #endif 387 } 388 EXPORT_SYMBOL(jiffies_to_msecs); 389 #endif 390 391 #if (USEC_PER_SEC % HZ) 392 /** 393 * jiffies_to_usecs - Convert jiffies to microseconds 394 * @j: jiffies value 395 * 396 * Return: microseconds value 397 */ 398 unsigned int jiffies_to_usecs(const unsigned long j) 399 { 400 /* 401 * Hz usually doesn't go much further MSEC_PER_SEC. 402 * jiffies_to_usecs() and usecs_to_jiffies() depend on that. 403 */ 404 BUILD_BUG_ON(HZ > USEC_PER_SEC); 405 406 #if BITS_PER_LONG == 32 407 return (HZ_TO_USEC_MUL32 * j) >> HZ_TO_USEC_SHR32; 408 #else 409 return (j * HZ_TO_USEC_NUM) / HZ_TO_USEC_DEN; 410 #endif 411 } 412 EXPORT_SYMBOL(jiffies_to_usecs); 413 #endif 414 415 /** 416 * mktime64 - Converts date to seconds. 417 * @year0: year to convert 418 * @mon0: month to convert 419 * @day: day to convert 420 * @hour: hour to convert 421 * @min: minute to convert 422 * @sec: second to convert 423 * 424 * Converts Gregorian date to seconds since 1970-01-01 00:00:00. 425 * Assumes input in normal date format, i.e. 1980-12-31 23:59:59 426 * => year=1980, mon=12, day=31, hour=23, min=59, sec=59. 427 * 428 * [For the Julian calendar (which was used in Russia before 1917, 429 * Britain & colonies before 1752, anywhere else before 1582, 430 * and is still in use by some communities) leave out the 431 * -year/100+year/400 terms, and add 10.] 432 * 433 * This algorithm was first published by Gauss (I think). 434 * 435 * A leap second can be indicated by calling this function with sec as 436 * 60 (allowable under ISO 8601). The leap second is treated the same 437 * as the following second since they don't exist in UNIX time. 438 * 439 * An encoding of midnight at the end of the day as 24:00:00 - ie. midnight 440 * tomorrow - (allowable under ISO 8601) is supported. 441 * 442 * Return: seconds since the epoch time for the given input date 443 */ 444 time64_t mktime64(const unsigned int year0, const unsigned int mon0, 445 const unsigned int day, const unsigned int hour, 446 const unsigned int min, const unsigned int sec) 447 { 448 unsigned int mon = mon0, year = year0; 449 450 /* 1..12 -> 11,12,1..10 */ 451 if (0 >= (int) (mon -= 2)) { 452 mon += 12; /* Puts Feb last since it has leap day */ 453 year -= 1; 454 } 455 456 return ((((time64_t) 457 (year/4 - year/100 + year/400 + 367*mon/12 + day) + 458 year*365 - 719499 459 )*24 + hour /* now have hours - midnight tomorrow handled here */ 460 )*60 + min /* now have minutes */ 461 )*60 + sec; /* finally seconds */ 462 } 463 EXPORT_SYMBOL(mktime64); 464 465 struct __kernel_old_timeval ns_to_kernel_old_timeval(s64 nsec) 466 { 467 struct timespec64 ts = ns_to_timespec64(nsec); 468 struct __kernel_old_timeval tv; 469 470 tv.tv_sec = ts.tv_sec; 471 tv.tv_usec = (suseconds_t)ts.tv_nsec / 1000; 472 473 return tv; 474 } 475 EXPORT_SYMBOL(ns_to_kernel_old_timeval); 476 477 /** 478 * set_normalized_timespec64 - set timespec sec and nsec parts and normalize 479 * 480 * @ts: pointer to timespec variable to be set 481 * @sec: seconds to set 482 * @nsec: nanoseconds to set 483 * 484 * Set seconds and nanoseconds field of a timespec variable and 485 * normalize to the timespec storage format 486 * 487 * Note: The tv_nsec part is always in the range of 0 <= tv_nsec < NSEC_PER_SEC. 488 * For negative values only the tv_sec field is negative ! 489 */ 490 void set_normalized_timespec64(struct timespec64 *ts, time64_t sec, s64 nsec) 491 { 492 while (nsec >= NSEC_PER_SEC) { 493 /* 494 * The following asm() prevents the compiler from 495 * optimising this loop into a modulo operation. See 496 * also __iter_div_u64_rem() in include/linux/time.h 497 */ 498 asm("" : "+rm"(nsec)); 499 nsec -= NSEC_PER_SEC; 500 ++sec; 501 } 502 while (nsec < 0) { 503 asm("" : "+rm"(nsec)); 504 nsec += NSEC_PER_SEC; 505 --sec; 506 } 507 ts->tv_sec = sec; 508 ts->tv_nsec = nsec; 509 } 510 EXPORT_SYMBOL(set_normalized_timespec64); 511 512 /** 513 * ns_to_timespec64 - Convert nanoseconds to timespec64 514 * @nsec: the nanoseconds value to be converted 515 * 516 * Return: the timespec64 representation of the nsec parameter. 517 */ 518 struct timespec64 ns_to_timespec64(s64 nsec) 519 { 520 struct timespec64 ts = { 0, 0 }; 521 s32 rem; 522 523 if (likely(nsec > 0)) { 524 ts.tv_sec = div_u64_rem(nsec, NSEC_PER_SEC, &rem); 525 ts.tv_nsec = rem; 526 } else if (nsec < 0) { 527 /* 528 * With negative times, tv_sec points to the earlier 529 * second, and tv_nsec counts the nanoseconds since 530 * then, so tv_nsec is always a positive number. 531 */ 532 ts.tv_sec = -div_u64_rem(-nsec - 1, NSEC_PER_SEC, &rem) - 1; 533 ts.tv_nsec = NSEC_PER_SEC - rem - 1; 534 } 535 536 return ts; 537 } 538 EXPORT_SYMBOL(ns_to_timespec64); 539 540 /** 541 * __msecs_to_jiffies: - convert milliseconds to jiffies 542 * @m: time in milliseconds 543 * 544 * conversion is done as follows: 545 * 546 * - negative values mean 'infinite timeout' (MAX_JIFFY_OFFSET) 547 * 548 * - 'too large' values [that would result in larger than 549 * MAX_JIFFY_OFFSET values] mean 'infinite timeout' too. 550 * 551 * - all other values are converted to jiffies by either multiplying 552 * the input value by a factor or dividing it with a factor and 553 * handling any 32-bit overflows. 554 * for the details see _msecs_to_jiffies() 555 * 556 * msecs_to_jiffies() checks for the passed in value being a constant 557 * via __builtin_constant_p() allowing gcc to eliminate most of the 558 * code, __msecs_to_jiffies() is called if the value passed does not 559 * allow constant folding and the actual conversion must be done at 560 * runtime. 561 * The _msecs_to_jiffies helpers are the HZ dependent conversion 562 * routines found in include/linux/jiffies.h 563 * 564 * Return: jiffies value 565 */ 566 unsigned long __msecs_to_jiffies(const unsigned int m) 567 { 568 /* 569 * Negative value, means infinite timeout: 570 */ 571 if ((int)m < 0) 572 return MAX_JIFFY_OFFSET; 573 return _msecs_to_jiffies(m); 574 } 575 EXPORT_SYMBOL(__msecs_to_jiffies); 576 577 /** 578 * __usecs_to_jiffies: - convert microseconds to jiffies 579 * @u: time in milliseconds 580 * 581 * Return: jiffies value 582 */ 583 unsigned long __usecs_to_jiffies(const unsigned int u) 584 { 585 if (u > jiffies_to_usecs(MAX_JIFFY_OFFSET)) 586 return MAX_JIFFY_OFFSET; 587 return _usecs_to_jiffies(u); 588 } 589 EXPORT_SYMBOL(__usecs_to_jiffies); 590 591 /** 592 * timespec64_to_jiffies - convert a timespec64 value to jiffies 593 * @value: pointer to &struct timespec64 594 * 595 * The TICK_NSEC - 1 rounds up the value to the next resolution. Note 596 * that a remainder subtract here would not do the right thing as the 597 * resolution values don't fall on second boundaries. I.e. the line: 598 * nsec -= nsec % TICK_NSEC; is NOT a correct resolution rounding. 599 * Note that due to the small error in the multiplier here, this 600 * rounding is incorrect for sufficiently large values of tv_nsec, but 601 * well formed timespecs should have tv_nsec < NSEC_PER_SEC, so we're 602 * OK. 603 * 604 * Rather, we just shift the bits off the right. 605 * 606 * The >> (NSEC_JIFFIE_SC - SEC_JIFFIE_SC) converts the scaled nsec 607 * value to a scaled second value. 608 * 609 * Return: jiffies value 610 */ 611 unsigned long 612 timespec64_to_jiffies(const struct timespec64 *value) 613 { 614 u64 sec = value->tv_sec; 615 long nsec = value->tv_nsec + TICK_NSEC - 1; 616 617 if (sec >= MAX_SEC_IN_JIFFIES){ 618 sec = MAX_SEC_IN_JIFFIES; 619 nsec = 0; 620 } 621 return ((sec * SEC_CONVERSION) + 622 (((u64)nsec * NSEC_CONVERSION) >> 623 (NSEC_JIFFIE_SC - SEC_JIFFIE_SC))) >> SEC_JIFFIE_SC; 624 625 } 626 EXPORT_SYMBOL(timespec64_to_jiffies); 627 628 /** 629 * jiffies_to_timespec64 - convert jiffies value to &struct timespec64 630 * @jiffies: jiffies value 631 * @value: pointer to &struct timespec64 632 */ 633 void 634 jiffies_to_timespec64(const unsigned long jiffies, struct timespec64 *value) 635 { 636 /* 637 * Convert jiffies to nanoseconds and separate with 638 * one divide. 639 */ 640 u32 rem; 641 value->tv_sec = div_u64_rem((u64)jiffies * TICK_NSEC, 642 NSEC_PER_SEC, &rem); 643 value->tv_nsec = rem; 644 } 645 EXPORT_SYMBOL(jiffies_to_timespec64); 646 647 /* 648 * Convert jiffies/jiffies_64 to clock_t and back. 649 */ 650 651 /** 652 * jiffies_to_clock_t - Convert jiffies to clock_t 653 * @x: jiffies value 654 * 655 * Return: jiffies converted to clock_t (CLOCKS_PER_SEC) 656 */ 657 clock_t jiffies_to_clock_t(unsigned long x) 658 { 659 #if (TICK_NSEC % (NSEC_PER_SEC / USER_HZ)) == 0 660 # if HZ < USER_HZ 661 return x * (USER_HZ / HZ); 662 # else 663 return x / (HZ / USER_HZ); 664 # endif 665 #else 666 return div_u64((u64)x * TICK_NSEC, NSEC_PER_SEC / USER_HZ); 667 #endif 668 } 669 EXPORT_SYMBOL(jiffies_to_clock_t); 670 671 /** 672 * clock_t_to_jiffies - Convert clock_t to jiffies 673 * @x: clock_t value 674 * 675 * Return: clock_t value converted to jiffies 676 */ 677 unsigned long clock_t_to_jiffies(unsigned long x) 678 { 679 #if (HZ % USER_HZ)==0 680 if (x >= ~0UL / (HZ / USER_HZ)) 681 return ~0UL; 682 return x * (HZ / USER_HZ); 683 #else 684 /* Don't worry about loss of precision here .. */ 685 if (x >= ~0UL / HZ * USER_HZ) 686 return ~0UL; 687 688 /* .. but do try to contain it here */ 689 return div_u64((u64)x * HZ, USER_HZ); 690 #endif 691 } 692 EXPORT_SYMBOL(clock_t_to_jiffies); 693 694 /** 695 * jiffies_64_to_clock_t - Convert jiffies_64 to clock_t 696 * @x: jiffies_64 value 697 * 698 * Return: jiffies_64 value converted to 64-bit "clock_t" (CLOCKS_PER_SEC) 699 */ 700 u64 jiffies_64_to_clock_t(u64 x) 701 { 702 #if (TICK_NSEC % (NSEC_PER_SEC / USER_HZ)) == 0 703 # if HZ < USER_HZ 704 x = div_u64(x * USER_HZ, HZ); 705 # elif HZ > USER_HZ 706 x = div_u64(x, HZ / USER_HZ); 707 # else 708 /* Nothing to do */ 709 # endif 710 #else 711 /* 712 * There are better ways that don't overflow early, 713 * but even this doesn't overflow in hundreds of years 714 * in 64 bits, so.. 715 */ 716 x = div_u64(x * TICK_NSEC, (NSEC_PER_SEC / USER_HZ)); 717 #endif 718 return x; 719 } 720 EXPORT_SYMBOL(jiffies_64_to_clock_t); 721 722 /** 723 * nsec_to_clock_t - Convert nsec value to clock_t 724 * @x: nsec value 725 * 726 * Return: nsec value converted to 64-bit "clock_t" (CLOCKS_PER_SEC) 727 */ 728 u64 nsec_to_clock_t(u64 x) 729 { 730 #if (NSEC_PER_SEC % USER_HZ) == 0 731 return div_u64(x, NSEC_PER_SEC / USER_HZ); 732 #elif (USER_HZ % 512) == 0 733 return div_u64(x * USER_HZ / 512, NSEC_PER_SEC / 512); 734 #else 735 /* 736 * max relative error 5.7e-8 (1.8s per year) for USER_HZ <= 1024, 737 * overflow after 64.99 years. 738 * exact for HZ=60, 72, 90, 120, 144, 180, 300, 600, 900, ... 739 */ 740 return div_u64(x * 9, (9ull * NSEC_PER_SEC + (USER_HZ / 2)) / USER_HZ); 741 #endif 742 } 743 744 /** 745 * jiffies64_to_nsecs - Convert jiffies64 to nanoseconds 746 * @j: jiffies64 value 747 * 748 * Return: nanoseconds value 749 */ 750 u64 jiffies64_to_nsecs(u64 j) 751 { 752 #if !(NSEC_PER_SEC % HZ) 753 return (NSEC_PER_SEC / HZ) * j; 754 # else 755 return div_u64(j * HZ_TO_NSEC_NUM, HZ_TO_NSEC_DEN); 756 #endif 757 } 758 EXPORT_SYMBOL(jiffies64_to_nsecs); 759 760 /** 761 * jiffies64_to_msecs - Convert jiffies64 to milliseconds 762 * @j: jiffies64 value 763 * 764 * Return: milliseconds value 765 */ 766 u64 jiffies64_to_msecs(const u64 j) 767 { 768 #if HZ <= MSEC_PER_SEC && !(MSEC_PER_SEC % HZ) 769 return (MSEC_PER_SEC / HZ) * j; 770 #else 771 return div_u64(j * HZ_TO_MSEC_NUM, HZ_TO_MSEC_DEN); 772 #endif 773 } 774 EXPORT_SYMBOL(jiffies64_to_msecs); 775 776 /** 777 * nsecs_to_jiffies64 - Convert nsecs in u64 to jiffies64 778 * 779 * @n: nsecs in u64 780 * 781 * Unlike {m,u}secs_to_jiffies, type of input is not unsigned int but u64. 782 * And this doesn't return MAX_JIFFY_OFFSET since this function is designed 783 * for scheduler, not for use in device drivers to calculate timeout value. 784 * 785 * note: 786 * NSEC_PER_SEC = 10^9 = (5^9 * 2^9) = (1953125 * 512) 787 * ULLONG_MAX ns = 18446744073.709551615 secs = about 584 years 788 * 789 * Return: nsecs converted to jiffies64 value 790 */ 791 u64 nsecs_to_jiffies64(u64 n) 792 { 793 #if (NSEC_PER_SEC % HZ) == 0 794 /* Common case, HZ = 100, 128, 200, 250, 256, 500, 512, 1000 etc. */ 795 return div_u64(n, NSEC_PER_SEC / HZ); 796 #elif (HZ % 512) == 0 797 /* overflow after 292 years if HZ = 1024 */ 798 return div_u64(n * HZ / 512, NSEC_PER_SEC / 512); 799 #else 800 /* 801 * Generic case - optimized for cases where HZ is a multiple of 3. 802 * overflow after 64.99 years, exact for HZ = 60, 72, 90, 120 etc. 803 */ 804 return div_u64(n * 9, (9ull * NSEC_PER_SEC + HZ / 2) / HZ); 805 #endif 806 } 807 EXPORT_SYMBOL(nsecs_to_jiffies64); 808 809 /** 810 * nsecs_to_jiffies - Convert nsecs in u64 to jiffies 811 * 812 * @n: nsecs in u64 813 * 814 * Unlike {m,u}secs_to_jiffies, type of input is not unsigned int but u64. 815 * And this doesn't return MAX_JIFFY_OFFSET since this function is designed 816 * for scheduler, not for use in device drivers to calculate timeout value. 817 * 818 * note: 819 * NSEC_PER_SEC = 10^9 = (5^9 * 2^9) = (1953125 * 512) 820 * ULLONG_MAX ns = 18446744073.709551615 secs = about 584 years 821 * 822 * Return: nsecs converted to jiffies value 823 */ 824 unsigned long nsecs_to_jiffies(u64 n) 825 { 826 return (unsigned long)nsecs_to_jiffies64(n); 827 } 828 EXPORT_SYMBOL_GPL(nsecs_to_jiffies); 829 830 /** 831 * timespec64_add_safe - Add two timespec64 values and do a safety check 832 * for overflow. 833 * @lhs: first (left) timespec64 to add 834 * @rhs: second (right) timespec64 to add 835 * 836 * It's assumed that both values are valid (>= 0). 837 * And, each timespec64 is in normalized form. 838 * 839 * Return: sum of @lhs + @rhs 840 */ 841 struct timespec64 timespec64_add_safe(const struct timespec64 lhs, 842 const struct timespec64 rhs) 843 { 844 struct timespec64 res; 845 846 set_normalized_timespec64(&res, (timeu64_t) lhs.tv_sec + rhs.tv_sec, 847 lhs.tv_nsec + rhs.tv_nsec); 848 849 if (unlikely(res.tv_sec < lhs.tv_sec || res.tv_sec < rhs.tv_sec)) { 850 res.tv_sec = TIME64_MAX; 851 res.tv_nsec = 0; 852 } 853 854 return res; 855 } 856 EXPORT_SYMBOL_GPL(timespec64_add_safe); 857 858 /** 859 * get_timespec64 - get user's time value into kernel space 860 * @ts: destination &struct timespec64 861 * @uts: user's time value as &struct __kernel_timespec 862 * 863 * Handles compat or 32-bit modes. 864 * 865 * Return: 0 on success or negative errno on error 866 */ 867 int get_timespec64(struct timespec64 *ts, 868 const struct __kernel_timespec __user *uts) 869 { 870 struct __kernel_timespec kts; 871 int ret; 872 873 ret = copy_from_user(&kts, uts, sizeof(kts)); 874 if (ret) 875 return -EFAULT; 876 877 ts->tv_sec = kts.tv_sec; 878 879 /* Zero out the padding in compat mode */ 880 if (in_compat_syscall()) 881 kts.tv_nsec &= 0xFFFFFFFFUL; 882 883 /* In 32-bit mode, this drops the padding */ 884 ts->tv_nsec = kts.tv_nsec; 885 886 return 0; 887 } 888 EXPORT_SYMBOL_GPL(get_timespec64); 889 890 /** 891 * put_timespec64 - convert timespec64 value to __kernel_timespec format and 892 * copy the latter to userspace 893 * @ts: input &struct timespec64 894 * @uts: user's &struct __kernel_timespec 895 * 896 * Return: 0 on success or negative errno on error 897 */ 898 int put_timespec64(const struct timespec64 *ts, 899 struct __kernel_timespec __user *uts) 900 { 901 struct __kernel_timespec kts = { 902 .tv_sec = ts->tv_sec, 903 .tv_nsec = ts->tv_nsec 904 }; 905 906 return copy_to_user(uts, &kts, sizeof(kts)) ? -EFAULT : 0; 907 } 908 EXPORT_SYMBOL_GPL(put_timespec64); 909 910 static int __get_old_timespec32(struct timespec64 *ts64, 911 const struct old_timespec32 __user *cts) 912 { 913 struct old_timespec32 ts; 914 int ret; 915 916 ret = copy_from_user(&ts, cts, sizeof(ts)); 917 if (ret) 918 return -EFAULT; 919 920 ts64->tv_sec = ts.tv_sec; 921 ts64->tv_nsec = ts.tv_nsec; 922 923 return 0; 924 } 925 926 static int __put_old_timespec32(const struct timespec64 *ts64, 927 struct old_timespec32 __user *cts) 928 { 929 struct old_timespec32 ts = { 930 .tv_sec = ts64->tv_sec, 931 .tv_nsec = ts64->tv_nsec 932 }; 933 return copy_to_user(cts, &ts, sizeof(ts)) ? -EFAULT : 0; 934 } 935 936 /** 937 * get_old_timespec32 - get user's old-format time value into kernel space 938 * @ts: destination &struct timespec64 939 * @uts: user's old-format time value (&struct old_timespec32) 940 * 941 * Handles X86_X32_ABI compatibility conversion. 942 * 943 * Return: 0 on success or negative errno on error 944 */ 945 int get_old_timespec32(struct timespec64 *ts, const void __user *uts) 946 { 947 if (COMPAT_USE_64BIT_TIME) 948 return copy_from_user(ts, uts, sizeof(*ts)) ? -EFAULT : 0; 949 else 950 return __get_old_timespec32(ts, uts); 951 } 952 EXPORT_SYMBOL_GPL(get_old_timespec32); 953 954 /** 955 * put_old_timespec32 - convert timespec64 value to &struct old_timespec32 and 956 * copy the latter to userspace 957 * @ts: input &struct timespec64 958 * @uts: user's &struct old_timespec32 959 * 960 * Handles X86_X32_ABI compatibility conversion. 961 * 962 * Return: 0 on success or negative errno on error 963 */ 964 int put_old_timespec32(const struct timespec64 *ts, void __user *uts) 965 { 966 if (COMPAT_USE_64BIT_TIME) 967 return copy_to_user(uts, ts, sizeof(*ts)) ? -EFAULT : 0; 968 else 969 return __put_old_timespec32(ts, uts); 970 } 971 EXPORT_SYMBOL_GPL(put_old_timespec32); 972 973 /** 974 * get_itimerspec64 - get user's &struct __kernel_itimerspec into kernel space 975 * @it: destination &struct itimerspec64 976 * @uit: user's &struct __kernel_itimerspec 977 * 978 * Return: 0 on success or negative errno on error 979 */ 980 int get_itimerspec64(struct itimerspec64 *it, 981 const struct __kernel_itimerspec __user *uit) 982 { 983 int ret; 984 985 ret = get_timespec64(&it->it_interval, &uit->it_interval); 986 if (ret) 987 return ret; 988 989 ret = get_timespec64(&it->it_value, &uit->it_value); 990 991 return ret; 992 } 993 EXPORT_SYMBOL_GPL(get_itimerspec64); 994 995 /** 996 * put_itimerspec64 - convert &struct itimerspec64 to __kernel_itimerspec format 997 * and copy the latter to userspace 998 * @it: input &struct itimerspec64 999 * @uit: user's &struct __kernel_itimerspec 1000 * 1001 * Return: 0 on success or negative errno on error 1002 */ 1003 int put_itimerspec64(const struct itimerspec64 *it, 1004 struct __kernel_itimerspec __user *uit) 1005 { 1006 int ret; 1007 1008 ret = put_timespec64(&it->it_interval, &uit->it_interval); 1009 if (ret) 1010 return ret; 1011 1012 ret = put_timespec64(&it->it_value, &uit->it_value); 1013 1014 return ret; 1015 } 1016 EXPORT_SYMBOL_GPL(put_itimerspec64); 1017 1018 /** 1019 * get_old_itimerspec32 - get user's &struct old_itimerspec32 into kernel space 1020 * @its: destination &struct itimerspec64 1021 * @uits: user's &struct old_itimerspec32 1022 * 1023 * Return: 0 on success or negative errno on error 1024 */ 1025 int get_old_itimerspec32(struct itimerspec64 *its, 1026 const struct old_itimerspec32 __user *uits) 1027 { 1028 1029 if (__get_old_timespec32(&its->it_interval, &uits->it_interval) || 1030 __get_old_timespec32(&its->it_value, &uits->it_value)) 1031 return -EFAULT; 1032 return 0; 1033 } 1034 EXPORT_SYMBOL_GPL(get_old_itimerspec32); 1035 1036 /** 1037 * put_old_itimerspec32 - convert &struct itimerspec64 to &struct 1038 * old_itimerspec32 and copy the latter to userspace 1039 * @its: input &struct itimerspec64 1040 * @uits: user's &struct old_itimerspec32 1041 * 1042 * Return: 0 on success or negative errno on error 1043 */ 1044 int put_old_itimerspec32(const struct itimerspec64 *its, 1045 struct old_itimerspec32 __user *uits) 1046 { 1047 if (__put_old_timespec32(&its->it_interval, &uits->it_interval) || 1048 __put_old_timespec32(&its->it_value, &uits->it_value)) 1049 return -EFAULT; 1050 return 0; 1051 } 1052 EXPORT_SYMBOL_GPL(put_old_itimerspec32); 1053