/**
* Create a system handle. There must only be one system
- * handle per operating system.
+ * handle per operating system. Uses a default range for allowed ports.
+ * Ports are still tested for availability.
*
* @param testdir only the directory name without any path. This is used for
* all service homes; the directory will be created in a temporary
const char *controller);
+/**
+ * Create a system handle. There must only be one system
+ * handle per operating system. Use this function directly
+ * if multiple system objects are created for the same host
+ * (only really useful when testing --- or to make the port
+ * range configureable).
+ *
+ * @param testdir only the directory name without any path. This is used for
+ * all service homes; the directory will be created in a temporary
+ * location depending on the underlying OS
+ * @param controller hostname of the controlling host,
+ * service configurations are modified to allow
+ * control connections from this host; can be NULL
+ * @param lowport lowest port number this system is allowed to allocate (inclusive)
+ * @param highport highest port number this system is allowed to allocate (exclusive)
+ * @return handle to this system, NULL on error
+ */
+struct GNUNET_TESTING_System *
+GNUNET_TESTING_system_create_with_portrange (const char *testdir,
+ const char *controller,
+ uint16_t lowport,
+ uint16_t highport);
+
+
/**
* Free system resources.
*