summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar m0gg2006-11-27 11:15:27 +0000
committerGravatar m0gg2006-11-27 11:15:27 +0000
commit504da9682a1e739b41cfdbb25721f518c83ebf83 (patch)
treee8a33e45550d6a4a6ac65871aedb9f2983dc0eae
parent6579b9cebeffc00031f59d2ed5c2476b4dfb87dc (diff)
downloadcsoap-504da9682a1e739b41cfdbb25721f518c83ebf83.tar.gz
csoap-504da9682a1e739b41cfdbb25721f518c83ebf83.tar.bz2
Documentation enhancements
-rw-r--r--libcsoap/soap-addressing.h10
-rw-r--r--libcsoap/soap-nudp.h31
-rw-r--r--libcsoap/soap-wsil.c4
-rw-r--r--libcsoap/soap-xmlsec.h27
4 files changed, 62 insertions, 10 deletions
diff --git a/libcsoap/soap-addressing.h b/libcsoap/soap-addressing.h
index ed2ca86..e6ac288 100644
--- a/libcsoap/soap-addressing.h
+++ b/libcsoap/soap-addressing.h
@@ -1,5 +1,5 @@
/******************************************************************
- * $Id: soap-addressing.h,v 1.5 2006/11/25 16:35:57 m0gg Exp $
+ * $Id: soap-addressing.h,v 1.6 2006/11/27 11:15:27 m0gg Exp $
*
* CSOAP Project: A SOAP client/server library in C
* Copyright (C) 2006 Heiko Ronsdorf
@@ -26,6 +26,8 @@
/** @file
*
+ * WS-Addressing
+ *
* WS-Addressing provides transport-neutral mechanisms to address Web services
* and messages. Specifically, this specification defines XML [XML 1.0, XML
* Namespaces] elements to identify Web service endpoints and to secure
@@ -35,10 +37,10 @@
* in a transport-neutral manner.
*
* @author H. Ronsdorf
- * @version $Revision: 1.5 $
+ * @version $Revision: 1.6 $
*
- * @see http://www.w3.org/TR/ws-addr-core/,
- * http://www.w3.org/TR/REC-xml-names/
+ * @see http://www.w3.org/TR/ws-addr-core/,
+ * http://www.w3.org/TR/REC-xml-names/
*
*/
diff --git a/libcsoap/soap-nudp.h b/libcsoap/soap-nudp.h
index 8978b70..fe76db7 100644
--- a/libcsoap/soap-nudp.h
+++ b/libcsoap/soap-nudp.h
@@ -1,8 +1,8 @@
/******************************************************************
-* $Id: soap-nudp.h,v 1.3 2006/11/26 20:13:05 m0gg Exp $
+* $Id: soap-nudp.h,v 1.4 2006/11/27 11:15:27 m0gg Exp $
*
* CSOAP Project: A SOAP client/server library in C
-* Copyright (C) 2007 Heiko Ronsdorf
+* 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
@@ -24,12 +24,37 @@
#ifndef __csoap_nudp_h
#define __csoap_nudp_h
-#ifdef __CSOAP_INTERNAL
+/** @file
+ *
+ * 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.4 $
+ *
+ * @see http://specs.xmlsoap.org/ws/2004/09/soap-over-udp/soap-over-udp.pdf,
+ * 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
diff --git a/libcsoap/soap-wsil.c b/libcsoap/soap-wsil.c
index 3d03b37..7bbc23a 100644
--- a/libcsoap/soap-wsil.c
+++ b/libcsoap/soap-wsil.c
@@ -1,5 +1,5 @@
/******************************************************************
-* $Id: soap-wsil.c,v 1.5 2006/11/27 10:52:39 m0gg Exp $
+* $Id: soap-wsil.c,v 1.6 2006/11/27 11:15:27 m0gg Exp $
*
* CSOAP Project: A SOAP client/server library in C
* Copyright (C) 2003 Ferhat Ayaz
@@ -37,6 +37,7 @@
#include <nanohttp/nanohttp-error.h>
#include <nanohttp/nanohttp-common.h>
+#include <nanohttp/nanohttp-stream.h>
#include <nanohttp/nanohttp-request.h>
#include <nanohttp/nanohttp-server.h>
@@ -44,6 +45,7 @@
#include "soap-service.h"
#include "soap-router.h"
#include "soap-server.h"
+#include "soap-transport.h"
#include "soap-wsil.h"
static void
diff --git a/libcsoap/soap-xmlsec.h b/libcsoap/soap-xmlsec.h
index 0f9368c..fc24fc5 100644
--- a/libcsoap/soap-xmlsec.h
+++ b/libcsoap/soap-xmlsec.h
@@ -1,5 +1,5 @@
/******************************************************************
- * $Id: soap-xmlsec.h,v 1.1 2006/11/24 11:22:55 m0gg Exp $
+ * $Id: soap-xmlsec.h,v 1.2 2006/11/27 11:15:27 m0gg Exp $
*
* CSOAP Project: A SOAP client/server library in C
* Copyright (C) 2006 Heiko Ronsdorf
@@ -24,6 +24,25 @@
#ifndef __csoap_xmlsec_h
#define __csoap_xmlsec_h
+/** @file
+ *
+ * Web Services Security
+ *
+ * This module is implemented using the xmlsec1 library.
+ *
+ * @author H. Ronsdorf
+ * @version $Revision: 1.2 $
+ *
+ * @see http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=wss
+ * http://www.aleksey.com/xmlsec/,
+ *
+ */
+
+/**
+ *
+ * Commandline argument to enabled WS-Security.
+ *
+ */
#define CSOAP_ENABLE_XMLSEC "-CSOAPxmlsec"
#ifdef __cplusplus
@@ -32,7 +51,7 @@ extern "C" {
/**
*
- * Initializes the XML security subsystem.
+ * Initializes the WS-Security subsystem.
*
* @param argc commandline arg count
* @param argv commandline arg vector
@@ -46,6 +65,8 @@ extern herror_t soap_xmlsec_init_args(int argc, char **argv);
*
* Sign a XML document contained in a SOAP Envelope
*
+ * @param envelope The SOAP envelope to be signed.
+ *
*/
extern herror_t soap_xmlsec_sign(struct SoapEnv *envelope);
@@ -53,6 +74,8 @@ extern herror_t soap_xmlsec_sign(struct SoapEnv *envelope);
*
* Encrypt a XML document contained in a SOAP envelope.
*
+ * @param envelope The SOAP envelope to be encrypted.
+ *
*/
extern herror_t soap_xmlsec_encrypt(struct SoapEnv *envelope);