C Library Functions                                 libggzcore(3)



NAME
     libggzcore - The GZ Gaming Zone core client library

DESCRIPTION
     This library is used by client programs to  connect  to  the
     GZ Gaming Zone server, handle game rooms, control user par-
     ticipation in the games, control chat and player properties.


     The ggzcore library  handles  the  connection  of  a  client
     application  to  the  GZ Gaming Zone server. It starts with
     offering a global configuration object for  storing  connec-
     tion  profiles for each server. The server list can be main-
     tained by hand or updated via the GZ metaserver. After this
     it  goes  on  to  callback  registration for the connection,
     negotiation and authentication methods, which might  include
     guest  logins, first time player or registered player on the
     GZ server.


     After a login it  handles  the  global  server  object,  the
     current  room  object  and,  when playing a game, the active
     game object. Additional objects include the table  the  game
     is  associated  with,  players,  game types and game modules
     which represent client-side game executables.


     Alternatively, a game can integrate ggzcore directly instead
     of  being launched by a ggzcore-using GZ core client, which
     is known as embedded ggzcore.


     Other tasks handled by the library are  querying  the  local
     game  registry  with all properties per game; retrieving the
     server message of the day (MOTD) or player statistics;  han-
     dling public, private and per-table chat as well as adminis-
     trative messages; and managing  the  game  launch  and  join
     events for players and spectators.


FILES
     The following files are used by this library:

     /usr/lib/libggzcore.so          The  GZ  Gaming  Zone  core
                                     client shared library



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:




SunOS 5.11          Last change: 29 May 2008                    1






C Library Functions                                 libggzcore(3)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWgnome-games             
    
     Interface stability          Volatile                    
    


SEE ALSO
     ggzh(3),     ggzcoreh(3),     ggzmodh(3),      libggz(3),
     libggzmod(3),    attributes(5),    ggz.modules(5),    gnome-
     interfaces(5), ggz(6), ggz-config(6), ggz(7)

     GZ Gaming Zone:


         http:/www.ggzgamingzone.org/
         http:/www.ggzgamingzone.org/docs/api/libggz/
         http:/www.ggzgamingzone.org/docs/api/ggzcore/
         http:/www.ggzgamingzone.org/docs/api/ggzmod/




NOTES
     Written by Michal Pryc, Sun Microsystems Inc., 2008.




























SunOS 5.11          Last change: 29 May 2008                    2