Skip to content
This repository was archived by the owner on Jul 25, 2019. It is now read-only.

Commit c50e572

Browse files
author
slang
committed
doc updates
1 parent bc7204d commit c50e572

File tree

36 files changed

+558
-210
lines changed

36 files changed

+558
-210
lines changed

toolkit/docs/4.0/common/cwscore/C_WS_Core_Compatibility_Summary_Frag.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
<ul>
1111
<li>The 3.2 cbindings API is obsolete, with no overlap to the new API. Bindings
1212
APIs are now generated directly from WSDL.</li>
13-
<li>The underlying XML/SOAP messaging framework is also new, based on the libxml2 open source package.</li>
13+
<li>The underlying XML/SOAP messaging framework is also new, based on the libxml2 pull parser API.</li>
1414
</ul>
1515

1616
<p>Schema changes since GT version 3.2</p>
Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<p>C WS Core depends on the following GT components:</p>
22
<ul>
33
<li>C Common Libraries</li>
4-
<li>Pre-WS Authentication and Authorization</li>
4+
<li>Pre-WS Authentication and Authorization (GSI)</li>
55
<li><a href="http://www-unix.globus.org/developer/xio/">Globus XIO</a> (used
66
by C WS core for efficient HTTP and TCP transport)</li>
77
</ul>
@@ -10,8 +10,6 @@
1010
<li><a href="http://www.xmlsoft.org/">Libxml2</a> (used by C WS Core for SOAP
1111
XML parsing and WSDL parsing)</li>
1212
<li><a href="http://www.openssl.org">OpenSSL</a> (used by C WS Core for Security)</li>
13-
<li><a href="http://www.aleksey.com/xmlsec/">XMLSec</a> (used by C WS Core
14-
for Security)</li>
1513
<li><a href="http://www.mozilla.org">JavaScript</a> (used by C WS Core as a
1614
template language to generate the C bindings from WSDL schemas)</li>
1715
</ul>
Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,21 @@
1-
<p>New Features in the GT 3.9.3 release</p>
21
<ul>
3-
<li>Implementation of the OASIS WSRF and WSN working drafts specifications
4-
(with minor fixes to the 1.2-draft-01 published schemas and with the March
5-
2004 version of the WS-Addressing specification)</li>
6-
<li>HTTP/1.1 client & server support</li>
7-
<li>Generation of pure C stubs (including blocking and asynchronous versions) directly from WSDL schemas</li>
8-
<li>Dynamically loadable Operation Providers and Service Modules based on the new Extension API included in the Globus C Common libraries</li>
9-
<li>API for embedding services in a C application</li>
10-
<li>Standalone service container</li>
11-
<li>Resource API for managing resources from within a service</li>
12-
<li>Use of the Libxml2 Pull Parser for efficient messaging parsing</li>
13-
<li>Use of XIO HTTP driver</li>
14-
<li>Full UUID support</li>
2+
<li>Binding Generation:
3+
<ul>
4+
<li>Binding Generation directly from WSDL schemas
5+
<ul>
6+
<li>ANSI-C stubs and skeletons
7+
<li>Non-blocking client stubs for writing event-driven code
8+
<li>EPR (EndpointReference) encapsulation
9+
<li>WSRF enabled client stubs and services
10+
</ul>
11+
<li>HTTP/1.1 Support</li>
12+
<li>Embeddable Service API</li>
13+
<li>Standalone service container</li>
14+
<li>WSRF-enabled services</li>
1515
</ul>
1616
<p>Deprecated Features</p>
1717
<ul>
1818
<li>Dynamic Deployment (WSDD) using AxisC++ was
1919
included in an early pre-release
20-
but is no longer supported
21-
for the C WS Core implementation.</li>
20+
but is no longer supported.</li>
2221
</ul>
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
<h3>Programming Model Overview</h3>
2-
<p><font color="purple">[Description of the programming model here]</font></p>
2+
<p>
3+
The C WS Core
34
<h3>Component API</h3>
45
<p><font color="purple">[link to auto-genned API docs here]</font></p>
Lines changed: 73 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,73 @@
1-
<p><font color="gray">Click <a href="http://www-unix.globus.org/toolkit/docs/development/3.9.2/gram/rsl-converter.html">here</a> to see a nice example of content describing a command-line tool<br>
2-
If there is more than one command-line tool, put bullets up top and copy these
3-
topics for each tool</font></p>
4-
<h3><font color="purple">[tool name]</font> for <font color="purple">[component
5-
name]</font></h3>
6-
<h4>Tool description</h4>
7-
<p><font color="purple">[Description of the command-line tool here. ]</font></p>
8-
<h4>Command syntax</h4>
9-
<p><font color="purple">[list and describe command-line args here]</font></p>
10-
<h4>Limitations</h4>
11-
<p><font color="purple">[describe limitations of the tool here]</font></p>
1+
<ul>
2+
<li>
3+
<h3>globus-wsc-container for C WS Core</h3>
4+
<h4>Tool description</h4>
5+
<p>
6+
This command starts the C WS container, allowing WS and WSRF-enabled services
7+
to be invoked. <i>globus-wsc-container</i> must be running to invoke services
8+
written using the WS C core.
9+
</p>
10+
11+
<h4>Features</h4>
12+
<ul>
13+
<li>
14+
The container can be run in the background with the <i>-bg</i> option,
15+
and <i>-pidfile</i> allows the pid of the process to written to a specified
16+
file. This is useful for scripting the command, especially when running tests,
17+
or when the container process is expected to have a short lifetime.
18+
</li>
19+
<li>Supports HTTPS with the <i>-secure</i> option</li>
20+
</ul>
21+
22+
<h4>Limitations</h4>
23+
<p>
24+
<ul>
25+
<li>
26+
The C container does not have a shutdown command (the Java container
27+
has a <i>globus-stop-container</i>. To shutdown the C container, you
28+
can either CRTL-C the process, or kill the process with the
29+
process ID (use <i>-pidfile</i>) is named <i>globus-wsc-container</i>
30+
</li>
31+
<li>
32+
The option for running over secure transport (https) is <i>-secure</i>.
33+
In future releases, secure transport will be enabled by default, and will be
34+
turned off with <i>-nosec</i>
35+
</li>
36+
</ul>
37+
</p>
38+
39+
<h4>Command syntax</h4>
40+
<p>
41+
Run: <i>globus-wsc-container -help</i>
42+
</p>
43+
</li>
44+
<li>
45+
<h3>globus-wsrf-cgen for C WS Core</h3>
46+
<h4>Tool description</h4>
47+
<p>
48+
This tool generates C bindings from a set of WSDL schema files.
49+
The tool is able to generate client bindings, service bindings, just types,
50+
or all three. The <a href="">WSDL to C mapping document</a> gives more
51+
information on how WSDL is mapped to the C programming language.
52+
</p>
53+
54+
<h4>Command syntax</h4>
55+
<p>
56+
Run: <i>globus-wsrf-cgen -help</i>
57+
</p>
58+
59+
<h4>Limitations</h4>
60+
<p>
61+
<ul>
62+
<li>
63+
Only generates bindings from document/literal style WSDL schemas.
64+
For more information on WSDL schema styles, go
65+
<a href="http://www-106.ibm.com/developerworks/webservices/library/ws-whichwsdl/">here</a>.
66+
</li>
67+
<li>
68+
Only generates ANSI-C bindings. C++ bindings are not supported.
69+
</li>
70+
</ul>
71+
</li>
72+
</ul>
73+
</p>
Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,4 @@
1-
<p>Tested Platforms for <font color="purple">[component name]</font></p>
1+
<p>Tested Platforms for C WS Core</font></p>
22
<ul>
3-
<li><font color="purple">platform #1</font></li>
4-
<li><font color="purple">...</font></li>
5-
<li><font color="purple">platform #n</font></li>
3+
<li>Linux i386</li>
64
</ul>

toolkit/docs/4.2/4.2.0/common/cwscore/C_WS_Core_Compatibility_Summary_Frag.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
<ul>
1111
<li>The 3.2 cbindings API is obsolete, with no overlap to the new API. Bindings
1212
APIs are now generated directly from WSDL.</li>
13-
<li>The underlying XML/SOAP messaging framework is also new, based on the libxml2 open source package.</li>
13+
<li>The underlying XML/SOAP messaging framework is also new, based on the libxml2 pull parser API.</li>
1414
</ul>
1515

1616
<p>Schema changes since GT version 3.2</p>
Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<p>C WS Core depends on the following GT components:</p>
22
<ul>
33
<li>C Common Libraries</li>
4-
<li>Pre-WS Authentication and Authorization</li>
4+
<li>Pre-WS Authentication and Authorization (GSI)</li>
55
<li><a href="http://www-unix.globus.org/developer/xio/">Globus XIO</a> (used
66
by C WS core for efficient HTTP and TCP transport)</li>
77
</ul>
@@ -10,8 +10,6 @@
1010
<li><a href="http://www.xmlsoft.org/">Libxml2</a> (used by C WS Core for SOAP
1111
XML parsing and WSDL parsing)</li>
1212
<li><a href="http://www.openssl.org">OpenSSL</a> (used by C WS Core for Security)</li>
13-
<li><a href="http://www.aleksey.com/xmlsec/">XMLSec</a> (used by C WS Core
14-
for Security)</li>
1513
<li><a href="http://www.mozilla.org">JavaScript</a> (used by C WS Core as a
1614
template language to generate the C bindings from WSDL schemas)</li>
1715
</ul>
Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,21 @@
1-
<p>New Features in the GT 3.9.3 release</p>
21
<ul>
3-
<li>Implementation of the OASIS WSRF and WSN working drafts specifications
4-
(with minor fixes to the 1.2-draft-01 published schemas and with the March
5-
2004 version of the WS-Addressing specification)</li>
6-
<li>HTTP/1.1 client & server support</li>
7-
<li>Generation of pure C stubs (including blocking and asynchronous versions) directly from WSDL schemas</li>
8-
<li>Dynamically loadable Operation Providers and Service Modules based on the new Extension API included in the Globus C Common libraries</li>
9-
<li>API for embedding services in a C application</li>
10-
<li>Standalone service container</li>
11-
<li>Resource API for managing resources from within a service</li>
12-
<li>Use of the Libxml2 Pull Parser for efficient messaging parsing</li>
13-
<li>Use of XIO HTTP driver</li>
14-
<li>Full UUID support</li>
2+
<li>Binding Generation:
3+
<ul>
4+
<li>Binding Generation directly from WSDL schemas
5+
<ul>
6+
<li>ANSI-C stubs and skeletons
7+
<li>Non-blocking client stubs for writing event-driven code
8+
<li>EPR (EndpointReference) encapsulation
9+
<li>WSRF enabled client stubs and services
10+
</ul>
11+
<li>HTTP/1.1 Support</li>
12+
<li>Embeddable Service API</li>
13+
<li>Standalone service container</li>
14+
<li>WSRF-enabled services</li>
1515
</ul>
1616
<p>Deprecated Features</p>
1717
<ul>
1818
<li>Dynamic Deployment (WSDD) using AxisC++ was
1919
included in an early pre-release
20-
but is no longer supported
21-
for the C WS Core implementation.</li>
20+
but is no longer supported.</li>
2221
</ul>
Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
<h3>Programming Model Overview</h3>
2-
<p><font color="purple">[Description of the programming model here]</font></p>
2+
<p>
3+
The C WS Core
34
<h3>Component API</h3>
45
<p><font color="purple">[link to auto-genned API docs here]</font></p>
Lines changed: 73 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,73 @@
1-
<p><font color="gray">Click <a href="http://www-unix.globus.org/toolkit/docs/development/3.9.2/gram/rsl-converter.html">here</a> to see a nice example of content describing a command-line tool<br>
2-
If there is more than one command-line tool, put bullets up top and copy these
3-
topics for each tool</font></p>
4-
<h3><font color="purple">[tool name]</font> for <font color="purple">[component
5-
name]</font></h3>
6-
<h4>Tool description</h4>
7-
<p><font color="purple">[Description of the command-line tool here. ]</font></p>
8-
<h4>Command syntax</h4>
9-
<p><font color="purple">[list and describe command-line args here]</font></p>
10-
<h4>Limitations</h4>
11-
<p><font color="purple">[describe limitations of the tool here]</font></p>
1+
<ul>
2+
<li>
3+
<h3>globus-wsc-container for C WS Core</h3>
4+
<h4>Tool description</h4>
5+
<p>
6+
This command starts the C WS container, allowing WS and WSRF-enabled services
7+
to be invoked. <i>globus-wsc-container</i> must be running to invoke services
8+
written using the WS C core.
9+
</p>
10+
11+
<h4>Features</h4>
12+
<ul>
13+
<li>
14+
The container can be run in the background with the <i>-bg</i> option,
15+
and <i>-pidfile</i> allows the pid of the process to written to a specified
16+
file. This is useful for scripting the command, especially when running tests,
17+
or when the container process is expected to have a short lifetime.
18+
</li>
19+
<li>Supports HTTPS with the <i>-secure</i> option</li>
20+
</ul>
21+
22+
<h4>Limitations</h4>
23+
<p>
24+
<ul>
25+
<li>
26+
The C container does not have a shutdown command (the Java container
27+
has a <i>globus-stop-container</i>. To shutdown the C container, you
28+
can either CRTL-C the process, or kill the process with the
29+
process ID (use <i>-pidfile</i>) is named <i>globus-wsc-container</i>
30+
</li>
31+
<li>
32+
The option for running over secure transport (https) is <i>-secure</i>.
33+
In future releases, secure transport will be enabled by default, and will be
34+
turned off with <i>-nosec</i>
35+
</li>
36+
</ul>
37+
</p>
38+
39+
<h4>Command syntax</h4>
40+
<p>
41+
Run: <i>globus-wsc-container -help</i>
42+
</p>
43+
</li>
44+
<li>
45+
<h3>globus-wsrf-cgen for C WS Core</h3>
46+
<h4>Tool description</h4>
47+
<p>
48+
This tool generates C bindings from a set of WSDL schema files.
49+
The tool is able to generate client bindings, service bindings, just types,
50+
or all three. The <a href="">WSDL to C mapping document</a> gives more
51+
information on how WSDL is mapped to the C programming language.
52+
</p>
53+
54+
<h4>Command syntax</h4>
55+
<p>
56+
Run: <i>globus-wsrf-cgen -help</i>
57+
</p>
58+
59+
<h4>Limitations</h4>
60+
<p>
61+
<ul>
62+
<li>
63+
Only generates bindings from document/literal style WSDL schemas.
64+
For more information on WSDL schema styles, go
65+
<a href="http://www-106.ibm.com/developerworks/webservices/library/ws-whichwsdl/">here</a>.
66+
</li>
67+
<li>
68+
Only generates ANSI-C bindings. C++ bindings are not supported.
69+
</li>
70+
</ul>
71+
</li>
72+
</ul>
73+
</p>
Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,4 @@
1-
<p>Tested Platforms for <font color="purple">[component name]</font></p>
1+
<p>Tested Platforms for C WS Core</font></p>
22
<ul>
3-
<li><font color="purple">platform #1</font></li>
4-
<li><font color="purple">...</font></li>
5-
<li><font color="purple">platform #n</font></li>
3+
<li>Linux i386</li>
64
</ul>

toolkit/docs/4.2/4.2.1/common/cwscore/C_WS_Core_Compatibility_Summary_Frag.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
<ul>
1111
<li>The 3.2 cbindings API is obsolete, with no overlap to the new API. Bindings
1212
APIs are now generated directly from WSDL.</li>
13-
<li>The underlying XML/SOAP messaging framework is also new, based on the libxml2 open source package.</li>
13+
<li>The underlying XML/SOAP messaging framework is also new, based on the libxml2 pull parser API.</li>
1414
</ul>
1515

1616
<p>Schema changes since GT version 3.2</p>
Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<p>C WS Core depends on the following GT components:</p>
22
<ul>
33
<li>C Common Libraries</li>
4-
<li>Pre-WS Authentication and Authorization</li>
4+
<li>Pre-WS Authentication and Authorization (GSI)</li>
55
<li><a href="http://www-unix.globus.org/developer/xio/">Globus XIO</a> (used
66
by C WS core for efficient HTTP and TCP transport)</li>
77
</ul>
@@ -10,8 +10,6 @@
1010
<li><a href="http://www.xmlsoft.org/">Libxml2</a> (used by C WS Core for SOAP
1111
XML parsing and WSDL parsing)</li>
1212
<li><a href="http://www.openssl.org">OpenSSL</a> (used by C WS Core for Security)</li>
13-
<li><a href="http://www.aleksey.com/xmlsec/">XMLSec</a> (used by C WS Core
14-
for Security)</li>
1513
<li><a href="http://www.mozilla.org">JavaScript</a> (used by C WS Core as a
1614
template language to generate the C bindings from WSDL schemas)</li>
1715
</ul>
Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,21 @@
1-
<p>New Features in the GT 3.9.3 release</p>
21
<ul>
3-
<li>Implementation of the OASIS WSRF and WSN working drafts specifications
4-
(with minor fixes to the 1.2-draft-01 published schemas and with the March
5-
2004 version of the WS-Addressing specification)</li>
6-
<li>HTTP/1.1 client & server support</li>
7-
<li>Generation of pure C stubs (including blocking and asynchronous versions) directly from WSDL schemas</li>
8-
<li>Dynamically loadable Operation Providers and Service Modules based on the new Extension API included in the Globus C Common libraries</li>
9-
<li>API for embedding services in a C application</li>
10-
<li>Standalone service container</li>
11-
<li>Resource API for managing resources from within a service</li>
12-
<li>Use of the Libxml2 Pull Parser for efficient messaging parsing</li>
13-
<li>Use of XIO HTTP driver</li>
14-
<li>Full UUID support</li>
2+
<li>Binding Generation:
3+
<ul>
4+
<li>Binding Generation directly from WSDL schemas
5+
<ul>
6+
<li>ANSI-C stubs and skeletons
7+
<li>Non-blocking client stubs for writing event-driven code
8+
<li>EPR (EndpointReference) encapsulation
9+
<li>WSRF enabled client stubs and services
10+
</ul>
11+
<li>HTTP/1.1 Support</li>
12+
<li>Embeddable Service API</li>
13+
<li>Standalone service container</li>
14+
<li>WSRF-enabled services</li>
1515
</ul>
1616
<p>Deprecated Features</p>
1717
<ul>
1818
<li>Dynamic Deployment (WSDD) using AxisC++ was
1919
included in an early pre-release
20-
but is no longer supported
21-
for the C WS Core implementation.</li>
20+
but is no longer supported.</li>
2221
</ul>

0 commit comments

Comments
 (0)