update service_fd comment and api docs

Signed-off-by: Andy Green <andy.green@linaro.org>