* 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
* the created socket or -1 on error.
*
***/
-int silc_net_create_server(int port, char *ip_addr);
+int silc_net_create_server(int port, const char *ip_addr);
/****f* silcutil/SilcNetAPI/silc_net_close_server
*
*
* 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
*
* binary form.
*
***/
-bool silc_net_addr2bin(const char *addr, unsigned char *bin,
- uint32 bin_len);
+bool silc_net_addr2bin(const char *addr, void *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
*
- * char *silc_net_localhost();
+ * char *silc_net_localhost(void);
*
* DESCRIPTION
*
* the first found hostname is returned.
*
***/
-char *silc_net_localhost();
+char *silc_net_localhost(void);
+
+/****f* silcutil/SilcNetAPI/silc_net_localip
+ *
+ * SYNOPSIS
+ *
+ * char *silc_net_localip(void)
+ *
+ * DESCRIPTION
+ *
+ * Return IP of localhost.
+ *
+ ***/
+char *silc_net_localip(void);
#ifdef WIN32