time 739 B

123456789101112131415161718192021222324252627282930313233343536373839404142434445
  1. .TH TIME 2
  2. .SH NAME
  3. time, nsec \- time in seconds and nanoseconds since epoch
  4. .SH SYNOPSIS
  5. .B #include <u.h>
  6. .br
  7. .B #include <libc.h>
  8. .PP
  9. .nf
  10. .B
  11. long time(long *tp)
  12. .PP
  13. .B
  14. vlong nsec(void)
  15. .SH DESCRIPTION
  16. Both
  17. .I time
  18. and
  19. .I nsec
  20. return the time since the epoch 00:00:00 GMT, Jan. 1, 1970.
  21. The return value of the former is in seconds and the latter in nanoseconds.
  22. For
  23. .IR time ,
  24. if
  25. .I tp
  26. is not zero then
  27. .BI * tp
  28. is also set to the answer.
  29. .PP
  30. These functions work by reading
  31. .BR /dev/bintime ,
  32. opening that file when
  33. .I they
  34. are first called.
  35. .SH SOURCE
  36. .B /sys/src/libc/9sys/time.c
  37. .br
  38. .B /sys/src/libc/9sys/nsec.c
  39. .SH SEE ALSO
  40. .IR cons (3)
  41. .SH DIAGNOSTICS
  42. Sets
  43. .IR errstr .
  44. .SH BUGS
  45. These routines maintain a static file descriptor.