OpenSOAP Logo

OpenSOAP Project
The Middleware as Platform for IT Application Services


-About OpenSOAP

-Known Bugs


Japanese version
Chinese version


Frequently Asked Questions about OpenSOAP.


  • What is OpenSOAP ?
  • Refer to this page.

  • Support for UDDI ?
  • There are no plans to release it to the public as an open source from the OpenSOAP project. However, a collaborating project is starting between Hokkaido University Computing Center and Softbank Commerce Corp. to develop a directory service based on OpenSOAP (OpenSOAP Directory).

  • Permission to link to this Web site
  • Feel free to link to any of the contents on this Web site. No special permission is required.


  • Compilation with gcc-3
  • As of opensoap-1.0-20020930, compilation of the API Server with gcc-3 and operation of the samples has been verified.

  • Compilation with Cygwin
  • Currently the OpenSOAP Server will not compile with Cygwin. Only the API can be used. Also, as of opensoap-1.0-20020930, the option "--enable-buildin-mbfuncs" is not required for ./configure.

  • How to install only the API ?
  • Do "make" in src/replace/, src/api/ and src/security/ of the package, then do "make install" in src/api/ and src/security/

  • Where are the pre-compiled binary packages, eg RPM for Linux, etc ?
  • Sorry, there are no pre-compiled binaries available at present. In order to reduce the installation time and effort we would like to make the binary packages available as soon as possible, and this issue will be addressed after the installation directory customization featues of the opensoap-1.0-20030110 release.

    Installation images for Linux can be found in the respective directories compressed as tar+gz files, and at present, RPM source and i386 binary packages are available for download.

    Currently under the Windows environment, installation from the source package is a rather involved process, and it is hoped to make binaries and installers available for both users and developers in the near future.

    As for other platforms, the availability of packages will be considered based on feedback from users. Of course, any assistance in the creation of the various packages is always welcome.


  • What styles of encoding are supported ?
  • Only SOAP encoding is supported. Only Simple types can be used on Ver.1.0.Beta1, but on versions later than 1.0., Compound types (Array and Structure) are planned to be available.

  • Handling C Language String types ?
  • Use the OpenSOAPStringPtr type. OpenSOAPStringXXX functions can be applied for multiple uses.

    The following table illustrates the SOAP encoding/C Language types compatibility as used by OpenSOAP.

    SOAP TypeC Lang Type
    booleanint(Non 0:true,0:false)
    byteunsigned char
    shortshort int
    intlong int
    dateTimestruct tm



  • How to execute from a debugger ?
  • Execute from libtool.
    $ libtool gdb HelloClient

  • I don't want the sample programs to be dynamically linked with libOpenSOAP.

    Use Hello.mak
    $ cd samples/Hello
    $ make -f Hello.mak
    (HelloClient created) -> static-linked
    If you get a link error for the iconv object, you should uncomment the ICONV_LIBS in the .mak file.


  • CGI programs (soapInterface.cgi, sampleService.cgi, etc.) don't work.

    Start a Web Server such as Apache.

    On RedHat, TurboLinux, etc., the default CGI directory is different. (The default CGI directory of the OpenSOAP package is "/home/httpd/cgi-bin/")
    When installing the OpenSOAP package, set the proper directory with the configure option.
    $ ./configure --with-cgi-bin=DIR
    Other configure options can be seen with "--help".


Copyright (C) 2001-2004 Webmasters of All Rights Reserved.