1 /**************************************************************************/
2 /* ---------------------------------------------------------------------- */
3 /* Copyright (C) 2006 - 2008 FRESCOR consortium partners: */
5 /* Universidad de Cantabria, SPAIN */
6 /* University of York, UK */
7 /* Scuola Superiore Sant'Anna, ITALY */
8 /* Kaiserslautern University, GERMANY */
9 /* Univ. Politécnica Valencia, SPAIN */
10 /* Czech Technical University in Prague, CZECH REPUBLIC */
12 /* Thales Communication S.A. FRANCE */
13 /* Visual Tools S.A. SPAIN */
14 /* Rapita Systems Ltd UK */
17 /* See http://www.frescor.org for a link to partners' websites */
19 /* FRESCOR project (FP6/2005/IST/5-034026) is funded */
20 /* in part by the European Union Sixth Framework Programme */
21 /* The European Union is not liable of any use that may be */
22 /* made of this code. */
25 /* This file is part of FORB (Frescor Object Request Broker) */
27 /* FORB is free software; you can redistribute it and/or modify it */
28 /* under terms of the GNU General Public License as published by the */
29 /* Free Software Foundation; either version 2, or (at your option) any */
30 /* later version. FORB is distributed in the hope that it will be */
31 /* useful, but WITHOUT ANY WARRANTY; without even the implied warranty */
32 /* of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU */
33 /* General Public License for more details. You should have received a */
34 /* copy of the GNU General Public License along with FORB; see file */
35 /* COPYING. If not, write to the Free Software Foundation, 675 Mass Ave, */
36 /* Cambridge, MA 02139, USA. */
38 /* As a special exception, including FORB header files in a file, */
39 /* instantiating FORB generics or templates, or linking other files */
40 /* with FORB objects to produce an executable application, does not */
41 /* by itself cause the resulting executable application to be covered */
42 /* by the GNU General Public License. This exception does not */
43 /* however invalidate any other reasons why the executable file might be */
44 /* covered by the GNU Public License. */
45 /**************************************************************************/
49 * @author Michal Sojka <sojkam1@fel.cvut.cz>
50 * @date Sun Oct 12 16:57:01 2008
52 * @brief Implementation of basic FORB's functions.
58 #define _BSD_SOURCE /* Because of on_exit() */
62 #include <forb/config.h>
63 #include <forb/forb-internal.h>
67 #include <forb/object.h>
68 #include <forb/uuid.h>
72 #include <sys/types.h>
73 #include <ul_gavlcust.h>
75 #include <ul_logreg.h>
77 #include "discovery.h"
78 #ifdef CONFIG_FORB_PROTO_UNIX
79 #include <forb/proto_unix.h>
81 #ifdef CONFIG_FORB_PROTO_INET_DEFAULT
82 #include <forb/proto_inet.h>
86 #include <fcb_contact_info.h>
91 #define UL_LOGL_DEF UL_LOGL_DEB
93 #define UL_LOGL_DEF UL_LOGL_ERR
95 #include "log_domains.inc"
97 extern UL_LOG_CUST(ulogd_forb);
98 static int init_ul_log(void);
100 UL_LOGREG_DOMAINS_INIT_FUNCTION(forb_logreg_domains, forb_logreg_domains_array);
104 destroy_forb_on_exit(int exitcode, void *arg)
112 forb_is_alive(forb_orb _obj, CORBA_Environment *ev)
114 ul_logdeb("%s called\n", __FUNCTION__);
117 static struct forb_forb_orb_impl forb_implementation = {
118 .is_alive = forb_is_alive,
122 * Prepares #FORB_TMP_DIR directory for use by forb
124 * @return Zero on succes, -1 on error and errno is set appropriately.
127 forb_init_tmp_dir(void)
132 ret = stat(FORB_TMP_DIR, &st);
134 if (ret == 0 && !S_ISDIR(st.st_mode)) {
135 ret = unlink(FORB_TMP_DIR);
137 } else if (ret == 0) {
140 return mkdir(FORB_TMP_DIR, 0777);
144 * Thread for execution of remote requests for a FORB object.
151 forb_execution_thread(void *arg)
153 forb_executor_t *executor = arg;
154 forb_executor_run(executor);
159 void hack_register_fcb(forb_orb orb, forb_port_t *port)
161 forb_object fcb = forb_object_new(orb, &FCB_SERVER_ID, 1);
163 ul_logerr("Cannot allocate FCB reference\n");
166 forb_register_reference(fcb, fres_contract_broker_reg_name);
167 forb_object_release(fcb);
170 #define hack_register_fcb(orb)
176 forb_init(int *argc, char **argv[], const struct forb_init_attr *attr)
182 forb = forb_malloc(sizeof(*forb));
184 memset(forb, 0, sizeof(*forb));
186 /* Initialize ULUT logging facility */
188 forb_logreg_domains();
193 memset(&forb->attr, 0, sizeof(forb->attr));
196 sem_init(&forb->server_ready, 0, 0);
198 if (forb_server_id_empty(&forb->attr.fixed_server_id)) {
199 forb_server_id_init(&forb->server_id);
201 forb->server_id = forb->attr.fixed_server_id;
203 forb_server_id_to_string(forb->server_id_str, &forb->server_id,
204 sizeof(forb->server_id_str));
205 ul_logdeb("Initializing forb %s\n", forb->server_id_str);
207 if (fosa_mutex_init(&forb->request_id_mutex, 0) != 0) goto err2;
208 if (fosa_mutex_init(&forb->port_mutex, 0) != 0) goto err2;
209 forb_port_init_head(forb);
211 if (fosa_mutex_init(&forb->request_mutex, 0) != 0) goto err2;
212 forb_request_nolock_init_root_field(forb);
214 if (forb_discovery_init(forb) != 0) goto err2;
216 if (fosa_mutex_init(&forb->regref_mutex, 0) != 0) goto err2;
217 forb_regref_nolock_init_root_field(forb);
219 ret = forb_init_tmp_dir();
221 ul_logerr("Cannot prepare " FORB_TMP_DIR "\n");
225 forb_executor_prepare();
227 orb = forb_forb_orb_new(NULL, &forb_implementation, forb);
229 /* Server ID must be assigned manualy */
230 orb->server = forb->server_id;
234 /* Insert our object reference to objects tree, so that we
235 * can accept remote request to our new ORB. */
236 forb_objects_nolock_insert(forb, orb);
238 ret = forb_executor_init(&forb->default_executor);
240 ret = forb_executor_register_object(&forb->default_executor, orb);
243 ret = fosa_thread_create(&forb->execution_thread, NULL,
244 forb_execution_thread, &forb->default_executor);
248 /* FIXME: I do not know how to deregister the exit handler if
249 * forb_destroy() is called manually. */
250 /* on_exit(destroy_forb_on_exit, orb); */
252 #ifdef CONFIG_FORB_PROTO_UNIX
254 forb_port_t *port = forb_malloc(sizeof(*port));
256 memset(port, 0, sizeof(*port));
257 ret = forb_unix_port_init(&port->desc, &forb->server_id);
258 if (ret) goto err_free_unix;
259 ret = forb_register_port(orb, port);
260 if (ret) goto err_free_unix; /* TODO: forb_unix_port_done() */
269 #ifdef CONFIG_FORB_PROTO_INET_DEFAULT
271 forb_port_t *port = forb_malloc(sizeof(*port));
273 struct in_addr listen_on;
275 memset(port, 0, sizeof(*port));
276 listen_on.s_addr = INADDR_ANY;
277 ret = forb_inet_port_init(&port->desc, listen_on,
278 forb->attr.fixed_tcp_port);
279 if (ret) goto err_free_inet;
280 ret = forb_register_port(orb, port);
281 if (ret) goto err_free_inet; /* TODO: forb_inet_port_done() */
288 hack_register_fcb(orb, port);
293 err3: forb_executor_destroy(&forb->default_executor);
294 err2: forb_free(forb);
298 void forb_destroy(forb_orb orb)
300 forb_t *forb = forb_object_to_forb(orb);
302 forb_regref_t *regref;
305 /* Stop ports to prevent remote requests from coming */
306 ul_list_for_each(forb_port, forb, port) {
307 forb_stop_port(port);
310 /* Wait for executors to finish all requests (and thus drop
311 * all references to peers). This is very inefficient for big
312 * number of objects, but we do not care */
313 gavl_cust_for_each(forb_objects_nolock, forb, obj) {
314 forb_executor_t *executor;
315 executor = forb_object_get_executor(obj);
317 forb_executor_synchronize(executor);
320 /* Destroy ports - this should drop all remaining references
321 * to peers and result in closing of all remote
323 ul_list_for_each_cut(forb_port, forb, port) {
324 forb_destroy_port(port);
327 pthread_cancel(forb->execution_thread.pthread_id);
328 pthread_join(forb->execution_thread.pthread_id, NULL);
330 /* Unregister all registered references */
331 while ((regref = forb_regref_first(forb))) {
332 forb_unregister_reference(orb, regref->name.str);
335 forb_object_release(orb);
340 /* forb_register_interface(const struct forb_interface *interface) */
342 /* gavl_insert(&type_registry, &interface->node); */
346 * Initializes server ID variable.
348 * @param server_id Serer ID to initialize.
351 forb_server_id_init(forb_server_id *server_id)
353 forb_uuid_generate((forb_uuid_t*)server_id->uuid);
357 * Checks whether the @a object is stale. Stale object is an object
358 * reference whose server cannot be contacted to handle requests.
360 * @param object Object reference to check.
362 * @return True if the object is stale, false otherwise.
364 bool forb_object_is_stale(forb_object object)
370 remote_orb = forb_get_orb_of(object);
371 if (!remote_orb) { /* This shohuld never happen */
374 /* TODO: Check not only the ORB, but also whether the object
375 * is still registered with the remote orb. */
376 forb_orb_is_alive(remote_orb, &env);
377 if (env.major == FORB_EX_COMM_FAILURE) {
378 /* Orb is not alive */
381 if (forb_exception_occurred(&env)) {
382 ul_logerr("%s: unexpected exception: %s\n", __FUNCTION__, forb_strerror(&env));
387 forb_object_release(remote_orb);
394 * Returns object reference of forb::orb object associated with the
402 forb_get_orb_of(const forb_object obj)
406 if (forb_server_id_cmp(&obj->server, &obj->orb->server) == 0) {
407 orb = forb_object_duplicate(obj->orb);
409 orb = forb_object_new(obj->orb, &obj->server, 0);
415 * Returns server ID of an object reference.
421 forb_get_server_id(const forb_object obj, forb_server_id *dest)
430 * Return instance data registered when the object was created by
433 * @param obj Object reference
435 * @return Pointer to the registered data.
438 forb_instance_data(const forb_object obj)
440 return forb_object_instance_data(obj);
444 * Returns error message correspondings FORB exception.
446 * @param env Environemnt
448 * @return Non-NULL pointer to a string.
451 forb_strerror(CORBA_Environment *env)
454 return "Invalid environemnt";
456 #define ex(e) case FORB_EX_##e: return #e; break;
457 switch (env->major) {
478 ex(OBJECT_NOT_EXIST);
483 return "Invalid error number";
487 * Return server id of the requesting application.
489 * This function should be only called from within interface
492 * @param[in] obj Object being requested
493 * @param[out] req_source Server ID of the requesting application
496 forb_get_req_source(const forb_object obj, forb_server_id *req_source)
499 if (obj && obj->exec_req) {
500 *req_source = obj->exec_req->source;
502 memset(req_source, 0, sizeof(*req_source));
508 * Internal function for allocation of sequence bufers. Used by
509 * forb_sequence_alloc_buf().
515 * @param num_elements
518 * @return CORBA_TRUE if the allocation was sucessfull, CORBA_FALSE if
522 __forb_sequence_alloc_buf_internal(void *seq, size_t seq_size,
523 void **buf_pptr, CORBA_unsigned_long *maximum_ptr,
524 unsigned num_elements, size_t elem_size)
526 memset(seq, 0, seq_size);
527 /*(seq)._length = 0;*/
528 if (num_elements && elem_size) *buf_pptr = forb_malloc(num_elements * elem_size);
529 else *buf_pptr = NULL;
530 *maximum_ptr = *buf_pptr ? num_elements : 0;
531 return (*buf_pptr != NULL) || (num_elements == 0);
534 static FILE *forb_ul_log_file;
535 static char progname[64] = "";
538 forb_ul_log_fnc(ul_log_domain_t *domain, int level,
539 const char *format, va_list ap)
542 if(!(level&UL_LOGL_CONT)) {
544 clock_gettime(CLOCK_MONOTONIC, &now);
545 fprintf(forb_ul_log_file,"%ld.%6ld: ", now.tv_sec, now.tv_nsec/1000);
547 fprintf(forb_ul_log_file,"%s: ", progname);
548 if(domain && domain->name)
549 fprintf(forb_ul_log_file,"%s: ",domain->name);
551 vfprintf(forb_ul_log_file, format, ap);
552 fflush(forb_ul_log_file);
555 static int init_ul_log(void)
563 /* if(ul_log_output != NULL) */
566 fd = open("/proc/self/cmdline", O_RDONLY);
569 ret = read(fd, path, sizeof(path)-1);
572 s = strrchr(path, '/');
575 strncpy(progname, s, sizeof(progname)-1);
580 if((log_fname=getenv("UL_LOG_FILENAME"))!=NULL){
581 forb_ul_log_file=fopen(log_fname,"a");
583 if(forb_ul_log_file==NULL)
584 forb_ul_log_file=stderr;
586 if((s=getenv("UL_DEBUG_FLG")) != NULL){
590 ul_log_redir(forb_ul_log_fnc, flg);
592 if((s = getenv("UL_LOG_LEVELS")) != NULL)
593 ul_log_domain_arg2levels(s);
599 * Wait for the server to be ready. Internal function intended forb
604 * @return Zero on success; on error -1 is returned, and errno is set
605 * to indicate the error.
607 int forb_wait_for_server_ready(forb_orb orb)
609 forb_t *forb = forb_object_to_forb(orb);
610 return sem_wait(&forb->server_ready);
614 * Signal the the FORB core that the server is ready for accepting
617 * This function should be called at the initialization of server
618 * implementation at the time when all objects are registered with
619 * executors. All other servers in the same address space are
620 * initialized after this function is called which allows the other
621 * servers to use the services provided by the calling server.
623 * @param orb ORB object.
625 * @return Zero on success; on error -1 is returned, and errno is set
626 * to indicate the error.
628 int forb_signal_server_ready(forb_orb orb)
630 forb_t *forb = forb_object_to_forb(orb);
631 return sem_post(&forb->server_ready);