GT 3.9.5 C WS Core : User's Guide

Introduction

The C WS Core is an implementation of Web Services, WSRF, and WSN specifications in the C programming language. This means that a user can write their own Web Services and clients in C, and use the APIs and tools included in in the C WS Core to manage WS-Resources.

The C WS Core includes:

  • A small container for services
  • An embeddable service container API
  • API for managing resources
  • API for managing notification consumers
  • A WSDL to C binding generator
  • Security Support

It does not include support at this time for WSDL generation from C header files, or embedding services into 3rd party containers.

Command-line tools

globus-wsc-container

Tool description

This command starts the C WS container, allowing WS and WSRF-enabled services to be invoked. globus-wsc-container must be running to invoke services written using the C WS core.

Features

  • The container can be run in the background with the -bg option, and -pidfile allows the pid of the process to written to a specified file. This is useful for scripting the command, especially when running tests, or when the container process is expected to have a short lifetime.
  • Supports HTTPS by default. In order to turn off HTTPS, use the -nosec argument

Limitations

  • The C container does not have a shutdown command (the Java container has globus-stop-container). To shutdown the C container, you can either CRTL-C the process, or kill the process with the process ID (use -pidfile)

Command syntax

Run: globus-wsc-container -help

globus-wsrf-cgen

Tool description

This tool generates C bindings from a set of WSDL schema files. The tool is able to generate client bindings, service bindings, just types, or all three. The WSDL to C mapping document gives more information on how WSDL is mapped to the C programming language.

Command syntax

Run: globus-wsrf-cgen -help

Limitations

  • Only generates bindings from document/literal style WSDL schemas. For more information on WSDL schema styles, go here.
  • Only generates ANSI-C bindings. C++ bindings are not supported.

Graphical user interfaces

There is no support for this type of interface for C WS Core.

Troubleshooting

[user-friendly help on common problems they may encounter]

Usage statistics collection by the Globus Alliance

The following usage statistics are sent by C WS Core by default in a UDP packet :

  • Component identifier
  • Usage data format identifier
  • Time stamp
  • Source IP address
  • Source hostname (to differentiate between hosts with identical private IP addresses)

It sends it at container startup and receipt of that packet tells us that the container started.

If you wish to disable this feature, please see the Java WS Core System Administrator's Guide section on Usage Statistics Configuration for instructions.

Also, please see our policy statement on the collection of usage statistics.