document the interface for transport

Signed-off-by: Sébastien Boisvert <boisvert@anl.gov>
add return values for transport interface

Signed-off-by: Sébastien Boisvert <boisvert@anl.gov>