source()

return source. The source is object/socket

on_packet($packet, $parser)

subclasses should override this

on_error($msg, $parser)

subclasses should override this

reset()

parse_data($data)

don't override: FUTURE OPTIMIZATION: let caller say "you can own this scalarref", and then we can keep it on the initial setting of $self->{data} and avoid copying into our own. overkill for now.

eof()

don't override

parse_sock($sock)

don't override

$sock is readable, we should sysread it and feed it to parse_data($data)