pp.1 1.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
  1. .\"Created with GNOME Manpages Editor Wizard
  2. .\"http://sourceforge.net/projects/gmanedit2
  3. .TH pp 1 "February 18, 2019" "" "/usr/bin/pp"
  4. .SH NAME
  5. /usr/bin/pp \- program for parsing go stack traces
  6. .SH SYNOPSIS
  7. .B pp
  8. .RI [ options ]
  9. .br
  10. .SH DESCRIPTION
  11. .B pp
  12. Parses panic stack traces, densifies and deduplicates goroutines with similar stack traces. It helps debugging crashes and deadlocks in heavily parallelized process. panicparse helps make sense of Go crash dumps. Merely pipe in a crash stack trace from a go program. If you need one to get an idea, use panic(1) to create one.
  13. .SH OPTIONS
  14. .B pp
  15. .IP -aggressive
  16. Aggressive deduplication including non pointers
  17. .IP -f
  18. -f string
  19. string Regexp to filter out headers that match, ex: -f 'IO wait|syscall'
  20. .IP -force-color
  21. Forcibly enable coloring when with stdout is redirected
  22. .IP -full-path
  23. Print full sources path
  24. .IP -html
  25. -html string
  26. Output an HTML file
  27. .IP -m
  28. -m string
  29. Regexp to filter by only headers that match, ex: -m 'semacquire'
  30. .IP -no-color
  31. Disable coloring
  32. .IP -parse
  33. Parses source files to deduct types; use -parse=false to work around bugs in source parser (default true)
  34. .IP -rebase
  35. Guess GOROOT and GOPATH (default true)
  36. .IP -v
  37. Enables verbose logging output
  38. .SH EXAMPLES
  39. .B template
  40. (panicing_program) |& pp
  41. .B test
  42. panic int |& pp
  43. .SH BUGS
  44. For any bugs checkout upstream bug reports at https://notabug.org/themusicgod1/panicparse/issues
  45. .SH "SEE ALSO"
  46. pp(1) panic(1)