Chapter 11. LibGnorba Documentation

Table of Contents
GOAD (Gnome Object Activation Directory)
ORBit-Gtk
gnome-plugins

GOAD (Gnome Object Activation Directory)

Author(s)

Elliot Lee <sopwith@redhat.com>

Description

A set of routines for getting a listing of available CORBA object servers, and connecting to new or existing servers using specified parameters.

goad_server_list_get - get a listing of objects which we know how to bootstrap

GoadServer *goad_server_list_get(void);

Description

This function returns an array of GoadServer structures that list the objects that a program can use.

Usage

GoadServer *servlist = goad_server_list_get();
/* use servlist */
goad_server_list_free(servlist);

goad_server_activate - get a specified server

CORBA_Object goad_server_activate(GoadServer *sinfo, GoadActivationFlags flags);

Description

When passed the address of a GoadServer structure (one retrieved from goad_server_list_get), this function will try to either connect to an existing server for the object, or start a new one up.

Usage

GoadServer *servlist, *chosen = NULL;
CORBA_Object dothings;
int i;
servlist = goad_server_list_get();
for(i = 0; servlist[i].repo_id; i++) {
    if(!strcmp(servlist[i].id, "gnumeric")) {
	    chosen = &servlist[i];
	    break;
    }
}
dothings = goad_server_activate(chosen, GOAD_ACTIVATE_SHLIB|GOAD_NO_NS_REGISTER);

Parameters

goad_server_activate_with_repo_id - get a server that offers a specified interface.

CORBA_Object goad_server_activate_with_repo_id(GoadServer *server_list, const char *repo_id, GoadActivationFlags flags);

Description

When passed the repository ID of an object, this function will try to either connect to an existing server for an object offering that interface, or start a new one up.

Usage

CORBA_Object dothings;
dothings = goad_server_activate_with_repo_id(NULL, "IDL:GNOME/HelpBrowser", 0);

Parameters