wrench::Service

class wrench::Service : public S4U_Daemon, public std::enable_shared_from_this<Service>

A service that can be added to the simulation and that can be used by a WMS when executing a workflow.

Subclassed by wrench::BandwidthMeterService, wrench::ComputeService, wrench::DataMovementManager, wrench::EnergyMeterService, wrench::ExecutionController, wrench::FileRegistryService, wrench::JobManager, wrench::NetworkProximityService, wrench::StorageService

Public Functions

void assertServiceIsUp()

Throws an exception if the service is not up.

Throws

ExecutionException

std::string getHostname()

Get the name of the host on which the service is / will be running.

Returns

the hostname

double getNetworkTimeoutValue()

Returns the service’s network timeout value.

Returns

a duration in seconds

std::string getPhysicalHostname()

Get the physical name of the host on which the service is / will be running.

Returns

the physical hostname

bool getPropertyValueAsBoolean(WRENCH_PROPERTY_TYPE)

Get a property of the Service as a boolean.

Parameters

property – the property

Throws

std::invalid_argument

Returns

the property value as a boolean

double getPropertyValueAsDouble(WRENCH_PROPERTY_TYPE)

Get a property of the Service as a double.

Parameters

property – the property

Throws

std::invalid_argument

Returns

the property value as a double

std::string getPropertyValueAsString(WRENCH_PROPERTY_TYPE)

Get a property of the Service as a string.

Parameters

property – the property

Throws

std::invalid_argument

Returns

the property value as a string

unsigned long getPropertyValueAsUnsignedLong(WRENCH_PROPERTY_TYPE)

Get a property of the Service as an unsigned long.

Parameters

property – the property

Throws

std::invalid_argument

Returns

the property value as an unsigned long

bool isUp()

Returns true if the service is UP, false otherwise.

Returns

true or false

void resume()

Resume the service.

Throws

ExecutionException

void setNetworkTimeoutValue(double value)

Sets the service’s network timeout value.

Parameters

value – a duration in seconds (<0 means: never timeout)

void start(std::shared_ptr<Service> this_service, bool daemonize, bool auto_restart)

Start the service.

Parameters
  • this_service – a shared pointer to the service

  • daemonize – true if the daemon is to be daemonized, false otherwise

  • auto_restart – true if the daemon should restart automatically after a reboot or not

Throws
  • std::runtime_error

  • std::shared_ptr<HostError>

virtual void stop()

Synchronously stop the service (does nothing if the service is already stopped)

Throws
void suspend()

Suspend the service.