# ircg_set_on_die

(PHP 4 >= 4.2.0, PHP 5 <= 5.0.5)

ircg_set_on_die — Set action to be executed when connection dies

### Description

bool ircg_set_on_die ( resource `$connection` , string `$host` , int `$port` , string `$data` )

In case of the termination of the `connection` , IRCG will connect to the specified `host` , send `data` to the new host connection and will wait until the remote part closes connection. This can be used to trigger a PHP script for example.

### Parameters

`connection`

  A connection resource handle returned by ircg_pconnect().

`host`

  This must be an IPv4 address as IRCG does not resolve host-names due to blocking issues.

`port`

  The port number.

`data`

  The data to be sent before closing the connection.

### Return Values

Returns `TRUE` on success or `FALSE` on failure.

### Notes

> Note: This feature requires IRCG 3.