[Previous] [Contents] [Index] [Next]

PtReattach()

Send an application through the jump gate

Synopsis:

int PtReattach( char *device );

Description:

This function provides Photon's "jump gate" mechanism - it unrealizes all top-level widgets in an application, disconnects them from the current Photon server, connects to the Photon server indicated by device (e.g. //88/dev/photon), and realizes the top-level widgets at the new location.

As a result, the PHOTON environment variable is set and the user interface is rehosted to the new Photon server.

Returns:

0
Success.
-1
Unable to connect to device due to insufficient memory.

Examples:

int transport_edit_activate( PtWidget_t *widget, 
      void *data, PtCallbackInfo_t cbinfo );
{
     PtTextCallback_t *tcb=cbinfo->cbdata;
     PtReattach( tcb->text );
}

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

[Previous] [Contents] [Index] [Next]