VSI-AXPVMS-CURL-V0765-0A-1-RELNOTES.PDF

This document provides information about the cURL and libcURL port for OpenVMS I64 and Alpha, last updated in May 2019.

Key Information:

• Purpose: Provides a command-line tool (cURL) and an API (libcURL) for transferring files using URL syntax and supporting various web protocols like HTTP, HTTPS, FTP, and FTPS on OpenVMS.
• Version: Based on the 7.65.0 Open Source distribution, built with OpenSSL 1.1.1b.
• Compatibility: Requires OpenVMS 8.4-1H1 or later, and HP TCP/IP Services V5.7 or VSI TCP/IP. MultiNet TCP/IP is likely compatible but unverified.
• Installation Note: Users of GNV should install the VMSPORTS kit, while others should use the VSI kit. It is crucial not to install both kits.

Installation & Configuration:

• The software is provided as an OpenVMS PCSI kit and is installed using the PRODUCT INSTALL CURL command.

• Essential Post-Installation Steps:

  • Add specific lines to SYS$MANAGER:SYSTARTUP_VMS.COM and SYSHUTDWN.COM to ensure cURL services start/stop correctly and required logical names are defined.
  • Define CURL as a foreign command: $ CURL :== $CURL$ROOT:[BIN]CURL.EXE.

• For Developers:

  • Include the CURL.H header file in application projects.
  • Link with the LIBCURL$SHR shareable image (which statically includes dependencies like OpenSSL and ZLIB) or CURL$ROOT:[LIB]LIBCURL.OLB (which requires manual linking of OpenSSL and ZLIB).
  • Use the C compiler option /NAMES=(AS_IS,SHORTENED) for proper resolution of mixed-case symbols.

• Alternative Installation Location: If installing to a different directory using the /DESTINATION qualifier, a manual step is required to copy the CURL$STARTUP.COM and CURL$SHUTDOWN.COM scripts from the destination subdirectory to your system's standard SYS$STARTUP directory.

General Notes:

• No special quotas or privileges are typically required, though a high BYTLM quota may benefit some applications.
• Users and developers are advised to consult the official cURL website (curl.haxx.se) for comprehensive documentation and code examples.