VSI-I64VMS-CURL-V07049-0C-1.PDF

This document provides information on installing and using cURL and libcURL on OpenVMS I64, based on the 7.49.0 Open Source distribution.

Key points:

• Compatibility Note: There are two kits: one from VMSPORTS for GNV users (recommended for GNV) and a standalone VSI kit for non-GNV users. These kits are mutually exclusive and cannot both be installed.
• Purpose: cURL is a command-line tool for file transfer using URL syntax, while libcURL is an API for developers to integrate cURL functionality. Both support various web protocols like HTTP, HTTPS, FTP, and FTPS.
• Requirements: OpenVMS 8.4-1H1 I64 and HP TCP/IP Services V5.7. Knowledge of OpenVMS software development is assumed for libcURL users.

• Installation:

  • The software is provided as an OpenVMS PCSI kit (VSI-I64VMS-CURL-V0749-0c-1.PCSI).
  • Install using the command: $ PRODUCT INSTALL CURL.

• Post-Installation:

  • To define necessary logical names system-wide at boot, add commands to include CURL$STARTUP.COM and CURL$SHUTDOWN.COM in SYS$MANAGER:SYSTARTUP_VMS.COM and SYS$MANAGER:SYSHUTDWN.COM, respectively.
  • Users can define CURL as a foreign command: $ CURL :== $CURL$ROOT:[BIN]CURL.EXE.

• Developer Information (libcURL):

  • The CURL$ROOT and LIBCURL$SHR logical names are defined during startup.
  • Developers link with the LIBCURL$SHR shareable image (recommended, as OpenSSL and ZLIB are statically linked) or the LIBCURL.OLB object library (which requires explicit linking of additional libraries).
  • For mixed-case symbols, use the C compiler option /NAMES=(AS_IS,SHORTENED) or appropriate #pragma directives.

• Alternative Installation Location: Installation to a different directory using the /DESTINATION qualifier requires manually copying the CURL$STARTUP.COM and CURL$SHUTDOWN.COM files to your system's SYS$STARTUP directory.

• Privileges/Quotas: Generally, no special quotas or privileges are required, though some applications might need a high BYTLM quota.
• Documentation: Refer to the cURL web site (https://curl.haxx.se/) for further documentation and code examples.