blob: 9bbfc85a061e1c55c06b06ff1ee507c432afdb73 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
## OpenVMS
This directory contains mainly a build script for OpenVMS.
## Requirements
* OpenVMS 8.4 or later (Alpha or IA64), VAX is not supported
* DEC CC 6.5 or later
* DEC CXX 7.1 or later (for tests only)
## Building
Library can be built with 32-bit or 64-bit pointers. By default 64-bit
pointers are used. Use `32` parameter to switch behaviour.
Test suit is optional and is not built by default. Use `TESTS` parameter to
enable tests.
There are other build parametes available, plese look inside the
`build_vms.com` (a DCL-based script) to see the detailed description for
all of them.
Object library (.OLB) and shareable image (.EXE) are built. An object
library acts like a widely-known static library, and a shareable image
acts like a shared library. All libraries and tests are placed inside the
`[.ALPHA]` or `[.IA64]` directory depending on a host architecture.
Do not forget to define a logical name for a shareable image of the library
before running programs which use it:
`DEFINE PLIBSYS SYS$SYSROOT:[BUILD_DIR]PLIBSYS.EXE`
You can also place an image into the `SYS$SHARE` directory instead of
defining a logical name.
Here are some examples of the build commands:
* `@build_vms.com` builds only the libraries (64-bit pointers).
* `@build_vms.com 32 TESTS` builds libraries (32-bit pointers) and all
the tests.
* `@build_vms.com NOLIB RUN_TESTS` only runs already built tests.
* `@build_vms.com CLEAN` cleans all the files produced during a build.
## More
OpenVMS can mangle long (> 31 characters) symbol names in a compiled object
to fit the limit. Sometimes it is useful to know the mangled name of a
symbol. Use the `vms_shorten_symbol.c` program to get a mangled name. See
details inside.
|
