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 17:36:13 2008
52 * @brief Implementation of port manipulation functions.
60 #include <forb/config.h>
64 extern UL_LOG_CUST(ulogd_forb_port);
67 * Registers a new port in FORB and run receiver thread on it to
68 * receive FORB messages through this prot.
70 * @param forb Where to register the new port.
72 * @param port Port to register. The memory for @a port should be
73 * forb_malloced, since forb_free() is called on the port on destroy
76 * @return Zero on success, FOSA error code on error.
78 int forb_register_port(forb_t *forb, forb_port_t *port)
85 forb_port_peer_init_head(port);
87 fosa_mutex_lock(&forb->port_mutex);
88 forb_port_insert(forb, port);
89 fosa_mutex_unlock(&forb->port_mutex);
91 forb_syncobj_init(&port->hello, 0);
92 forb_syncobj_init(&port->reply_processed, 0);
94 CDR_codec_init_static(&port->codec);
95 if (!CDR_buffer_init(&port->codec, CONFIG_FORB_RECV_BUF_SIZE, 0)) {
99 ret = fosa_thread_create(&port->receiver_thread, NULL,
100 forb_iop_receiver_thread, port);
103 ret = fosa_thread_create(&port->discovery_thread, NULL,
104 forb_iop_discovery_thread, port);
110 /* FIXME: This is Aquosa specific - cancelation should be
112 pthread_cancel(port->receiver_thread.pthread_id);
113 pthread_cancel(port->discovery_thread.pthread_id);
115 pthread_join(port->receiver_thread.pthread_id, NULL);
116 pthread_join(port->discovery_thread.pthread_id, NULL);
118 CDR_codec_release_buffer(&port->codec);
120 fosa_mutex_lock(&forb->port_mutex);
121 forb_port_delete(forb, port);
122 fosa_mutex_unlock(&forb->port_mutex);
128 * Destroys the port and all resources associated with it.
132 void forb_destroy_port(forb_port_t *port)
134 forb_t *forb = port->forb;
137 port->finish = true; /* Exit all the threads */
139 /* FIXME: There is no FOSA API for thread cancelation. */
140 pthread_cancel(port->receiver_thread.pthread_id);
142 /* FIXME: Canceling discovery thread sometimes didn't
143 * work. The discovery thread stayed forever in the
144 * pthread_cond_timedwait(). */
145 //pthread_cancel(port->discovery_thread.pthread_id);
147 /* Sometimes, cancelation doesn't work and the
148 * discovery_thread hangs in pthread_cond_timedwait
150 forb_syncobj_signal(&port->hello);
152 pthread_join(port->receiver_thread.pthread_id, &thread_return);
153 pthread_join(port->discovery_thread.pthread_id, &thread_return);
155 if (port->proto->port_destroy) {
156 port->proto->port_destroy(port);
159 /* Because of no locking of port->peers, this must be called
160 * after receiver thread is stopped. */
161 forb_peer_delete_by_port(forb, port);
163 CDR_codec_release_buffer(&port->codec);
165 fosa_mutex_lock(&forb->port_mutex);
166 forb_port_delete(forb, port);
167 fosa_mutex_unlock(&forb->port_mutex);
169 /* TODO: reference counting */