summaryrefslogtreecommitdiffstats
path: root/libcsoap/soap-nudp.h
blob: 2f56a7c138d3bbe1ce2c552a70d925f77dac2007 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
/******************************************************************
*  $Id: soap-nudp.h,v 1.5 2006/12/09 09:27:11 m0gg Exp $
*
* CSOAP Project:  A SOAP client/server library in C
* Copyright (C) 2006 Heiko Ronsdorf
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with this library; if not, write to the
* Free Software Foundation, Inc., 59 Temple Place - Suite 330,
* Boston, MA  02111-1307, USA.
* 
* Email: hero@persua.de
******************************************************************/
#ifndef __csoap_nudp_h
#define __csoap_nudp_h

/** @file
 *
 * \section SOAP-over-UDP server/client module
 *
 * Many Application protocol patterns match the semantics of the User Datagram
 * Protocol (UDP, RFC 768). Some do not require the delivery guarantees of TCP
 * while others make use of multicats transmisson. In order to allow Web Services
 * to support these pattersn, we need a way to map SOAP envelopes to user
 * datagrams. This support is essential for services using WS-Discovery, where
 * the use of multicast and need for low connection overhead makes UDP a natural
 * choice. It is anticipated that other protocols will have similar requirements.
 *
 * @author	H. Ronsdorf
 * @version	$Revision: 1.5 $
 *
 * @see http://specs.xmlsoap.org/ws/2004/09/soap-over-udp/soap-over-udp.pdf
 * @see http://www.ietf.org/rfc/rfc768.txt
 *
 */

/**
 *
 * Commandline argument to set the UDP port.
 *
 */
#define NUDP_ARG_PORT		"-NUDPport"

#define NUDP_DEFAULT_PORT	10001

#ifdef __CSOAP_INTERNAL

#ifdef __cplusplus
extern "C" {
#endif

extern herror_t soap_nudp_server_init_args(int argc, char **argv);
extern void *soap_nudp_server_run(void *unused);
extern herror_t soap_nudp_server_run_threaded(void);
extern void soap_nudp_server_destroy(void);

extern herror_t soap_nudp_register(const void *data);

extern herror_t soap_nudp_client_init_args(int argc, char **argv);
extern void soap_nudp_client_destroy(void);

#ifdef __cplusplus
}
#endif

#endif

#endif