updates.

[silc.git] / lib / silcutil / silcnet.h

diff --git a/lib/silcutil/silcnet.h b/lib/silcutil/silcnet.h
index 9bdee55403d99e2c0437c18301442dedef75dd2d..40e138f8991e99d5d388c2da475992bb7d7c83ed 100644 (file)
--- a/lib/silcutil/silcnet.h
+++ b/lib/silcutil/silcnet.h
@@ -31,7 +31,7 @@
  * calling the silc_net_win32_uninit function. The initializing must be
  * done in order to assure that the SILC Net API works correctly.
  *
- */
+ ***/
 
 #ifndef SILCNET_H
 #define SILCNET_H
@@ -72,32 +72,41 @@ void silc_net_close_server(int sock);
  *
  * SYNOPSIS
  *
- *    int silc_net_create_connection(int port, char *host);
+ *    int silc_net_create_connection(const char *local_ip, int port, 
+ *                                   const char *host);
  *
  * DESCRIPTION
  *
  *    Creates a connection (TCP/IP) to a remote host. Returns the connection
  *    socket or -1 on error. This blocks the process while trying to create
- *    the connection.
+ *    the connection. If the `local_ip' is not NULL then this will bind
+ *    the `local_ip' address to a port before creating the connection.  If
+ *    it is NULL then this will directly create the connection.
  *
  ***/
-int silc_net_create_connection(int port, char *host);
+int silc_net_create_connection(const char *localhost, int port, 
+                              const char *host);
 
 /****f* silcutil/SilcNetAPI/silc_net_create_connection_async
  *
  * SYNOPSIS
  *
- *    int silc_net_create_connection_async(int port, char *host);
+ *    int silc_net_create_connection_async(const char *local_ip, int port, 
+ *                                         const char *host);
  *
  * DESCRIPTION
  *
  *    Creates a connection (TCP/IP) to a remote host. Returns the connection
  *    socket or -1 on error. This creates non-blocking socket hence the
  *    connection returns directly. To get the result of the connect() one
- *    must select() the socket and read the result after it's ready.
+ *    must select() the socket and read the result after it's ready. If the
+ *    `local_ip' is not NULL then this will bind the `local_ip' address to
+ *    a port before creating the connection.  If it is NULL then this will
+ *    directly create the connection.
  *
  ***/
-int silc_net_create_connection_async(int port, char *host);
+int silc_net_create_connection_async(const char *local_ip, int port, 
+                                    const char *host);
 
 /****f* silcutil/SilcNetAPI/silc_net_close_connection
  *
@@ -197,6 +206,22 @@ bool silc_net_is_ip(const char *addr);
 bool silc_net_addr2bin(const char *addr, unsigned char *bin,
                       uint32 bin_len);
 
+/****f* silcutil/SilcNetAPI/silc_net_addr2bin_ne
+ *
+ * SYNOPSIS
+ *
+ *    bool silc_net_addr2bin_ne(const char *addr, unsigned char *bin,
+ *                             uint32 bin_len);
+ *
+ * DESCRIPTION
+ *
+ *    Converts the IP number string from numbers-and-dots notation to
+ *    binary form in network byte order.
+ *
+ ***/
+bool silc_net_addr2bin_ne(const char *addr, unsigned char *bin,
+                         uint32 bin_len);
+
 /****f* silcutil/SilcNetAPI/silc_net_check_host_by_sock
  *
  * SYNOPSIS
@@ -255,7 +280,7 @@ uint16 silc_net_get_local_port(int sock);
  *
  * SYNOPSIS
  *
- *    char *silc_net_localhost();
+ *    char *silc_net_localhost(void);
  *
  * DESCRIPTION
  *
@@ -264,7 +289,7 @@ uint16 silc_net_get_local_port(int sock);
  *    the first found hostname is returned.
  *
  ***/
-char *silc_net_localhost();
+char *silc_net_localhost(void);
 
 #ifdef WIN32