home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib / misc / sosp.man < prev    next >
Encoding:
Text File  |  1991-11-18  |  1.7 KB  |  54 lines
  1. '\" Copyright 1991 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/lib/forms/RCS/lib.man,v 1.3 91/01/07 17:55:52 mottsmth Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS sosp lib
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. initRead, getHeader, getNextRecord, getNextRecordMerge, migrateChildren \- Routines to extract trace events from the sosp file system traces.
  17. .SH SYNOPSIS
  18. It's probably not worth it to use the library routines directly.  Instead, make use of the example template that calls them correctly.
  19. .nf
  20. \fB#include <sosp.h>\fR
  21. .sp
  22. int
  23. \fBinitRead\fR(\fIname\fR, \fIargc\fR, \fIargv\fR)
  24. .sp
  25. int
  26. \fBgetHeader\fR(\fIfile\fR, \fIhdr\fR)
  27. .sp
  28. int
  29. \fBgetNextRecord\fR(\fIfile\fR, \fIbuf\fR)
  30. .sp
  31. Boolean
  32. \fBmigrateChildren\fR(\fIflags\fR)
  33. .sp
  34. int
  35. \fBgetNextRecordMerge\fR(\fIbuf\fR)
  36. .SH ARGUMENTS
  37. .AS char *name
  38. .AP char *name in
  39. Like argv[0] - the name of the process.
  40. .AP int argc in
  41. Number of elements in \fIargv\fR.
  42. .AP char **argv in/out
  43. The arguments to the tracer - including startTime and endTime, files to
  44. ignore events for in the traces and the list of trace file names.
  45. .BE
  46.  
  47. .SH DESCRIPTION
  48. .PP
  49. The interface to this library is arcane.  Look instead at the template
  50. program that calls it.  This program includes comments for where you
  51. need to fill in your code.
  52. .SH KEYWORDS
  53. traces, sosp, postprocessor
  54.