lb_register man page on Ultrix

Man page or keyword search:  
man Server   3690 pages
apropos Keyword Search (all sections)
Output format
Ultrix logo
[printable version]

lb_register(3ncs)					     lb_register(3ncs)

Name
       lb_register  -  register	 an  object and an interface with the Location
       Broker

Syntax
       #include <idl/c/lb.h>

       void lb_$register(object, obj_type, obj_interface,  flags,  annotation,
			  location, location_length, entry, status)
       uuid_$t *object;
       uuid_$t *obj_type;
       uuid_$t *obj_interface;
       lb_$server_flag_t flags;
       unsigned char annotation[64];
       socket_$addr_t *location;
       unsigned long location_length;
       lb_$entry_t *entry;
       status_$t *status;

Arguments
       object		   The UUID of the object being registered.

       obj_type		   The	UUID  of  the  type of the object being regis‐
			   tered.

       obj_interface	   The UUID of the interface being registered.

       flags		   Must be  either  lb_$server_flag_local  (specifying
			   registration	 with  only the LLB at the local host)
			   or 0 (specifying registration with both the LLB and
			   the GLB).

       annotation	   A  character array used only for informational pur‐
			   poses.  This field can contain a  textual  descrip‐
			   tion	 of  the object and the interface.  For proper
			   display by the tool, the annotation should be  ter‐
			   minated by a null character.

       location		   The	socket	address of the server that exports the
			   interface to the object.

       location_length	   The length, in bytes, of the socket address	speci‐
			   fied by the location field.

       entry		   A  copy  of the entry that was entered in the Loca‐
			   tion Broker database.

       status		   The completion status.  If  the  completion	status
			   returned  in is equal to status_$ok , then the rou‐
			   tine that supplied it was successful.

Description
       The routine registers with the  Location	 Broker	 an  interface	to  an
       object  and the location of a server that exports that interface.  This
       routine replaces any existing entry in  the  Location  Broker  database
       that matches object, obj_type, obj_interface, and both the address fam‐
       ily and host in location; if no such entry exists, the routine  adds  a
       new entry to the database.

       If the flags parameter is the entry is registered only in the LLB data‐
       base at the host where the call is issued.  Otherwise, the flag	should
       be 0 to register with both the LLB and the GLB databases.

Examples
       The  following  statement registers the interface to the object identi‐
       fied by :
       lb_$register (&bank_id, &bank_$uuid, &bank_$if_spec.id, 0,
			  BankName, &saddr, slen, &entry, &status);

Diagnostics
       This section lists status codes for errors returned by this routine in

       lb_$database_invalid
			   The format of the Location Broker database  is  out
			   of  date.  The database may have been created by an
			   old version of the Location Broker; in  this	 case,
			   delete  the out-of-date database and reregister any
			   entries that it contained.  The LLB or GLB that was
			   accessed  may  be  running out-of-date software; in
			   this case, update all Location Brokers to the  cur‐
			   rent software version.

       lb_$database_busy   The Location Broker database is currently in use in
			   an incompatible manner.

       lb_$update_failed   The Location Broker	was  unable  to	 register  the
			   entry.

       lb_$cant_access	   The	Location  Broker  cannot  access the database.
			   Among the possible reasons:

			   1. The database does not exist,  and	 the  Location
			   Broker cannot create it.

			   2.  The  database  exists,  but the Location Broker
			   cannot access it.

			   3. The GLB entry table is full.

       lb_$server_unavailable
			   The Location Broker Client Agent cannot  reach  the
			   requested  GLB  or  LLB.   A communications failure
			   occurred or the broker was not running.

Files
See Also
       intro(3ncs), lb_unregister(3ncs)

							     lb_register(3ncs)
[top]

List of man pages available for Ultrix

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net