X-Git-Url: https://git.cworth.org/git?p=ttt;a=blobdiff_plain;f=src%2Fttt-socket.h;h=e3cd9bca8a515bf328121f03aeee5f213044e177;hp=6b35ef23649111dca03457b95925b4640b075ab6;hb=8fbec78bf02e67469ffaea254d49c291f9987105;hpb=15672ac8305a1c5ba0d9bf6edabb0a194c30628e

diff --git a/src/ttt-socket.h b/src/ttt-socket.h
index 6b35ef2..e3cd9bc 100644
--- a/src/ttt-socket.h
+++ b/src/ttt-socket.h
@@ -55,12 +55,30 @@ ttt_socket_accept (int				 listen_socket,
 		   ttt_socket_accept_func_t	 accept,
 		   void				*closure);
 
-/* Performa a blocking read, until all count bytes are read from the
+/* Create a socket, and connect it to the given host and port,
+ * returing it in socket_ret.
+ *
+ * Lookup for host (e.g. /etc/hosts and DNS) and port (e.g /etc/services)
+ * will be performed if necessary.
+ *
+ * Return value: TTT_STATUS_SUCCESS if successful.
+ *		 TTT_STATUS_CONNECTION_REFUSED: no server listening.
+ *		 TTT_STATUS_NETWORK_UNREACHABLE: <obvious meaning>
+ *
+ * Errors: If any error other than those listed above occurs, this
+ * function will not return.
+ */
+ttt_status_t
+ttt_socket_create_client (const char	*host,
+			  const char	*port,
+			  int		*socket_ret);
+
+/* Perform a blocking read, until all count bytes are read from the
  * socket to buf, which must be of size count or larger.
  *
  * Errors: If any errors occur, this function does not return.
  */
-void
+ssize_t
 ttt_socket_read (int	 socket,
 		 void	*buf,
 		 size_t	 count);