Steven M. Schweda updated VMS readme file

This commit is contained in:
Yang Tse 2010-02-11 07:29:38 +00:00
parent b41d3be7fa
commit 547931366d
1 changed files with 36 additions and 32 deletions

View File

@ -11,7 +11,7 @@ History:
9-MAR-2004, Created this readme. file. Marty Kuhrt (MSK).
15-MAR-2004, MSK, Updated to reflect the new files in this directory.
14-FEB-2005, MSK, removed config-vms.h_with* file comments
10-FEB-2010, SMS. General update.
Prerequisites:
@ -23,45 +23,49 @@ What is Here:
This directory contains the following files:
AXP.DIR - Target directory for Alpha builds.
BATCH_COMPILE.COM - Quick and dirty batch build procedure.
BUILD_VMS.COM - The brute force build procedure that sets
up the config files, and builds all the C
and MSG files in the lib and src
subdirectories.
CONFIG-VMS.H - The config file used for all builds.
CURLMSG.H - Created with SDL/ALPHA/LANGUAGE=CC CURLMSG.SDL
(Needs freeware SDL tool)
CURLMSG.MSG - Source for .SDL and .H as well as the
.OBJ used to link against for error messages.
CURLMSG.SDL - Created with MESSAGE/SDL CURLMSG.MSG.
CURLMSG_VMS.H - Maps curl error codes to VMS error numbers.
DEFINES.COM - Some handy logicals needed for the build.
You may need to update this for your setup.
HPSSL_ALPHA.OPT - Option file for hp SSL link on Alpha.
HPSSL_IA64.OPT - Option file for hp SSL link on IA64.
HPSSL_VAX.OPT - Option file for hp SSL link on VAX.
IA64.DIR - Target directory for IA64 builds.
README. - This file.
VAX.DIR - Target directory for VAX builds.
build_vms.com Build procedure.
config-vms.h VMS-specific config.h.
curlmsg.h C header defining cURL status code macros.
curlmsg.msg Error message source for curlmsg.h and curlmsg.sdl.
curlmsg.sdl SDL source defining cURL status code constants.
curlmsg_vms.h Mapping of cURL status codes to VMS-form codes.
hpssl_alpha.opt LINK options file for HP SSL on Alpha.
hpssl_ia64.opt LINK options file for HP SSL on IA64.
hpssl_vax.opt LINK options file for HP SSL on VAX.
ldap.opt LINK options file for LDAP.
Makefile.am cURL kit file list for this directory.
Makefile.in cURL kit makefile source for this directory.
openssl_alpha.opt LINK options file for OpenSSL on Alpha.
openssl_ia64.opt LINK options file for OpenSSL on IA64.
openssl_ssl_alpha.opt LINK options file for OpenSSL (SSL_ prefix) on Alpha.
openssl_ssl_ia64.opt LINK options file for OpenSSL (SSL_ prefix) on IA64.
openssl_ssl_vax.opt LINK options file for OpenSSL (SSL_ prefix) on VAX.
openssl_vax.opt LINK options file for OpenSSL on VAX.
readme. This file.
How to Build:
In theory you should be able to do an @defines followed by an
@build_vms from this directory and it will create brand new .olbs and
an .exe. I say in theory because every release of cURL tosses in a
new twist that has to be addressed by updating the config-vms.h*
files, or other files. I'm working on keeping all the OpenVMS
dependent stuff in this config file to keep from having to wade
through gobs of #ifdefs and such.
The (brute-force) builder is [.packages.vms]build_vms.com. Comments in
this procedure describe various optional parameters which enable or
disable optional program features, or which control the build in other
ways. Product files (.EXE, .H, .LIS, .MAP, .OBJ, .OLB, ...) should be
produced in an architecture-specific subdirectory under this directory
([.ALPHA], [.IA64], [.VAX]).
Example build commands:
@ [.packages.vms]build_vms.com CLEAN
@ [.packages.vms]build_vms.com LARGE LDAP
submit /noprint [.packages.vms]build_vms.com /param = (LARGE, LDAP)
Other Notes:
The test suites are not supported as of 7.11.0.
The CURLMSG.SDL and CURLMSG.H files are generated from CURLMSG.MSG.
The curlmsg.sdl and curlmsg.h files are generated from curlmsg.msg.
This is not done automatically, since the .MSG file is a hand edit
of the relevant stuff from the CURL.H file. If you want to do this
yourself you'll need the SDL package from the freeware CD.
of the relevant stuff from the curl.h file. If you want to do this
yourself you'll need the SDL package from the freeware collection.