make really loud unable to communicate with peerinfo messages go away
[oweals/gnunet.git] / src / nat / upnp-commands.h
index 8e7510dbf0ff0fe992583a0110fd69a2e5314bea..ea7b48162b9759f67a24baf874da1d3d559999de 100644 (file)
@@ -94,16 +94,16 @@ typedef void (*UPNP_command_cb_) (char *response, size_t received, void *cls);
 /**
  * Send UPnP command to the device identified by url and service.
  * 
- * @param sched scheduler to use for network tasks
  * @param url control URL of the device
  * @param service type of the service corresponding to the command
  * @param action action to send
  * @param args arguments for action
+ * @param buffer buffer
+ * @param buf_size buffer size
  * @param caller_cb user callback to trigger when done
  * @param caller_cls closure to pass to caller_cb
  */
-void UPNP_command_ (struct GNUNET_SCHEDULER_Handle *sched,
-                    const char *url, const char *service,
+void UPNP_command_ (const char *url, const char *service,
                     const char *action, struct UPNP_Arg_ *args,
                     char *buffer, size_t buf_size,
                     UPNP_command_cb_ caller_cb, void *caller_cls);
@@ -127,15 +127,13 @@ typedef void (*UPNP_get_external_ip_address_cb_) (int error,
  * Get the IP address associated with the WAN connection of the device.
  * See UPNP_get_external_ip_address_cb_.
  *
- * @param sched the scheduler to use for networking
  * @param control_url the control URL corresponding to service_type on the device
  * @param service_type service type to call the command on
  * @param caller_cb function to call when done
- * @param cls closure passed to caller_cb
+ * @param caller_cls closure passed to caller_cb
  */
 void
-UPNP_get_external_ip_address_ (struct GNUNET_SCHEDULER_Handle *sched,
-                               const char *control_url,
+UPNP_get_external_ip_address_ (const char *control_url,
                                const char *service_type,
                                UPNP_get_external_ip_address_cb_ caller_cb,
                                void *caller_cls);
@@ -167,8 +165,8 @@ UPNP_get_external_ip_address_ (struct GNUNET_SCHEDULER_Handle *sched,
  * @param error GNUNET_OK on success, another value on error (see above)
  * @param control_url the control URL the command was called on
  * @param service_type service the command was called on
- * @param in_port port on the gateway on the LAN side which was requested
- * @param in_client address in the LAN which was requested
+ * @param ext_port external port
+ * @param inPort port on the gateway on the LAN side which was requested
  * @param proto protocol for which port mapping was requested
  * @param remote_host remote host for which port mapping was requested
  * @param cls the closure passed to the command function
@@ -185,20 +183,19 @@ typedef void (*UPNP_port_mapping_cb_) (int error,
  * Request opening a port on the IGD device.
  * (remote_host is usually NULL because IGDs don't support it.)
  *
- * @param sched the scheduler to use for networking
  * @param control_url the control URL corresponding to service_type on the device
  * @param service_type service type to call the command on
  * @param ext_port port that should be opened on the WAN side
  * @param in_port port on the gateway on the LAN side which should map ext_port
  * @param in_client address in the LAN to which packets should be redirected
+ * @param desc description
  * @param proto protocol for which to request port mapping
  * @param remote_host remote host for which to request port mapping
  * @param caller_cb function to call when done
- * @param cls closure passed to caller_cb
+ * @param caller_cls closure passed to caller_cb
  */
 void
-UPNP_add_port_mapping_ (struct GNUNET_SCHEDULER_Handle *sched,
-                        const char *control_url, const char *service_type,
+UPNP_add_port_mapping_ (const char *control_url, const char *service_type,
                         const char *ext_port,
                         const char *in_port,
                         const char *in_client,
@@ -212,19 +209,16 @@ UPNP_add_port_mapping_ (struct GNUNET_SCHEDULER_Handle *sched,
  * used when opening the port.
  * (remote_host is usually NULL because IGDs don't support it.)
  *
- * @param sched the scheduler to use for networking
  * @param control_url the control URL the command was called on
  * @param service_type service the command was called on
- * @param in_port port on the gateway on the LAN side which was requested
- * @param in_client address in the LAN which was requested
+ * @param ext_port external port
  * @param proto protocol for which port mapping was requested
  * @param remote_host remote host for which port mapping was requested
  * @param caller_cb function to call when done
- * @param cls closure passed to caller_cb
+ * @param caller_cls closure passed to caller_cb
  */
 void
-UPNP_delete_port_mapping_ (struct GNUNET_SCHEDULER_Handle *sched,
-                           const char *control_url, const char *service_type,
+UPNP_delete_port_mapping_ (const char *control_url, const char *service_type,
                            const char *ext_port, const char *proto,
                            const char *remote_host,
                            UPNP_port_mapping_cb_ caller_cb, void *caller_cls);
@@ -236,10 +230,10 @@ UPNP_delete_port_mapping_ (struct GNUNET_SCHEDULER_Handle *sched,
  * @param error GNUNET_OK if port is currently mapped, another value on error
  * @param control_url the control URL the command was called on
  * @param service_type service the command was called on
+ * @param ext_port external port
+ * @param proto protocol for which port mapping was requested
  * @param in_port port on the gateway on the LAN side which was requested
  * @param in_client address in the LAN which was requested
- * @param proto protocol for which port mapping was requested
- * @param remote_host remote host for which port mapping was requested
  * @param cls the closure passed to the command function
  */
 typedef void (*UPNP_get_specific_port_mapping_entry_cb_) (int error,
@@ -259,19 +253,15 @@ typedef void (*UPNP_get_specific_port_mapping_entry_cb_) (int error,
  * Check that a port mapping set up with UPNP_add_port_mapping_()
  * is alive.
  *
- * @param sched the scheduler to use for networking
  * @param control_url the control URL the command was called on
  * @param service_type service the command was called on
- * @param in_port port on the gateway on the LAN side which was requested
- * @param in_client address in the LAN which was requested
+ * @param ext_port external port
  * @param proto protocol for which port mapping was requested
- * @param remote_host remote host for which port mapping was requested
  * @param caller_cb function to call when done
- * @param cls closure passed to caller_cb
+ * @param caller_cls closure passed to caller_cb
  */
 void
-UPNP_get_specific_port_mapping_entry_ (struct GNUNET_SCHEDULER_Handle *sched,
-                                       const char *control_url,
+UPNP_get_specific_port_mapping_entry_ (const char *control_url,
                                        const char *service_type,
                                        const char *ext_port,
                                        const char *proto,