lat_syscall.8 1.4 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. .\" $Id$
  2. .TH LAT_SYSCALL 8 "$Date$" "(c)1994 Larry McVoy" "LMBENCH"
  3. .SH NAME
  4. lat_syscall - time simple entry into the operating system
  5. .SH SYNOPSIS
  6. .B lat_syscall
  7. .I "null|read|write|stat|fstat|open"
  8. .SH DESCRIPTION
  9. .B lat_syscall
  10. measures how long it takes to do various simple system call
  11. operations.
  12. .TP
  13. .B null
  14. measures how long it takes to do
  15. .BR getppid .
  16. This is useful as a lower bound cost on anything that has to interact
  17. with the operating system.
  18. .TP
  19. .B write
  20. measures how long it takes to write one byte to \f(CB/dev/null\fP.
  21. .TP
  22. .B read
  23. measures how long it takes to read one byte from \f(CB/dev/zero\fP.
  24. .TP
  25. .B stat
  26. measures how long it takes to
  27. .B stat
  28. a file.
  29. .TP
  30. .B fstat
  31. measures how long it takes to
  32. .B fstat
  33. a file.
  34. .TP
  35. open
  36. measures how long it takes to
  37. .B open
  38. and then
  39. .B close
  40. a file.
  41. Note that this does not include the time to read the directories or
  42. inodes from disk, since everything should be in the buffer cache.
  43. .SH OUTPUT
  44. Output formats are:
  45. .ft CB
  46. .br
  47. Simple syscall: 67 microseconds
  48. .br
  49. Simple write: 67 microseconds
  50. .br
  51. Simple read: 67 microseconds
  52. .br
  53. Simple stat: 67 microseconds
  54. .br
  55. Simple fstat: 67 microseconds
  56. .br
  57. Simple open/close: 67 microseconds
  58. .ft
  59. .SH ACKNOWLEDGEMENT
  60. Funding for the development of
  61. this tool was provided by Sun Microsystems Computer Corporation.
  62. .SH "SEE ALSO"
  63. lmbench(8), getppid(2), read(2), write(2), stat(2), fstat(2), open(2),
  64. close(2).