summaryrefslogtreecommitdiff
path: root/netio.h
diff options
context:
space:
mode:
Diffstat (limited to 'netio.h')
-rw-r--r--netio.h13
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_ */