Stop the event loop
- end of stream is reached (meaningful for file only)
- return not-0 from process_event.
The last one is a powerful debugging tool (borrowed from PSTUFF as some may recall). Normally, return 0. Come across an “interesting” event (QGP, corrupt, some glitch, whatever), preserve it for further investigation and return 1.