TIME.2
上传用户:datang2001
上传日期:2007-02-01
资源大小:53269k
文件大小:1k
源码类别:

操作系统开发

开发平台:

C/C++

  1. ." Copyright (c) 1980 Regents of the University of California.
  2. ." All rights reserved.  The Berkeley software License Agreement
  3. ." specifies the terms and conditions for redistribution.
  4. ."
  5. ." @(#)gettimeofday.2 6.7 (Berkeley) 5/14/86
  6. ."
  7. .TH TIME 2 "May 14, 1986"
  8. .UC 4
  9. .SH NAME
  10. time, stime - get/set date and time
  11. .SH SYNOPSIS
  12. .nf
  13. .ft B
  14. #include <sys/types.h>
  15. #include <time.h>
  16. time_t time(time_t *fItpfP)
  17. int stime(time_t *fItpfP)
  18. .fi
  19. .SH DESCRIPTION
  20. The system's notion of the current Greenwich time
  21. is obtained with the
  22. .B time
  23. call, and set with the
  24. .B stime
  25. call.
  26. The time is expressed
  27. in seconds since midnight (0 hour), January 1, 1970.
  28. The time is both returned by
  29. .B time
  30. and stored in the variable pointed to by
  31. .I tp
  32. unless
  33. .I tp
  34. is the null pointer.
  35. .PP
  36. .B Stime
  37. obtains the time to set from the variable pointed to by
  38. .IR tp .
  39. .PP
  40. Only the super-user may set the time of day.
  41. .SH RETURN
  42. A 0 return value from
  43. .B stime
  44. indicates that the call succeeded.
  45. .B Time
  46. returns the current time on success.
  47. A -1 return value indicates an error occurred, and in this
  48. case an error code is stored into the global variable fBerrnofP.
  49. .SH "ERRORS
  50. The following error codes may be set in fBerrnofP:
  51. .TP 15
  52. [EFAULT]
  53. The
  54. .I tp
  55. address referenced invalid memory.
  56. .TP 15
  57. [EPERM]
  58. A user other than the super-user attempted to set the time.
  59. .SH "SEE ALSO"
  60. .BR date (1),
  61. .BR ctime (3).