wip config, 9p

1 files changed, 9 insertions, 4 deletions

diff --git a/netio.h b/netio.h
index 8d9fa50..8497330 100644
--- a/netio.h
+++ b/netio.h
@@ -1,13 +1,18 @@
 #ifndef _NETIO_H_
 #define _NETIO_H_
 
-#include <stdint.h>
-#include <stdbool.h>
+#include <stdbool.h> /* for bool */
+#include <stdint.h>  /* for size_t, ssize_t, uint16_t */
 
+/** Return socket-fd on success, -errno on error.  */
 int netio_listen(uint16_t port);
+/** Return connection-fd on success, -errno on error.  */
 int netio_accept(int sock);
-size_t netio_read(int conn, void *buf, size_t count);
-size_t netio_write(int conn, void *buf, size_t count);
+/** Return bytes-read on success, 0 on EOF, -errno on error; a short read is *not* an error.  */
+ssize_t netio_read(int conn, void *buf, size_t count);
+/** Return `count` on success, -errno on error; a short write *is* an error.  */
+ssize_t netio_write(int conn, void *buf, size_t count);
+/** Return 0 on success, -errno on error.  */
 int netio_close(int conn, bool rd, bool wr);
 
 #endif /* _NETIO_H_ */