4. NLM Header file

The NLM header file contains information for nlmconv(1). Each line contains one option or directive; everything after "#" is comment. This chapter describes all options and directives.

This chapter is not yet finished, sorry.

4.1 AUTOUNLOAD

Syntax:

AUTOUNLOAD

4.2 CHECK

Syntax:

CHECK <check procedure name>

This directive specifies the function to be executed when the NLM is unloaded using the UNLOAD Server console command. If this function returns zero, the NLM can be unloaded, else the NLM is not ready to be unloaded.

Example:

CHECK CheckUnload

4.3 CODESTART

Syntax:

CODESTART <map file code start offset>

Map file start offset may be decimal or Xhex.

4.4 COPYRIGHT

Syntax:

COPYRIGHT ["Copyright string"]

The copyright string is displayed on the server console screen when the NLM is loaded. If this option is not used, no copyright information is displayed.

Example:

COPYRIGHT "Copyright (c) 1998 ABC Inc."

4.5 CUSTOM

Syntax:

CUSTOM <custom data file path>

4.6 DATASTART

Syntax:

DATASTART <map file data start offset>

Map file data start offset may be decimal or Xhex.

4.7 DATE

Syntax:

DATE <month, day, year>

4.8 DEBUG

Syntax:

DEBUG

This directive tells the nlmconv(1) to include debugging information in the NLM file.

Example:

DEBUG

4.9 DESCRIPTION

Syntax:

DESCRIPTION "NLM Description String"

4.10 EXIT

Syntax:

EXIT <exit procedure name>

4.11 EXPORT

Syntax:

EXPORT <symbol list>

EXPORT @<symbol list file>

4.12 FLAG_OFF

Syntax:

FLAG_OFF <decimal number>

4.13 FLAG_ON

Syntax:

FLAG_ON <decimal number>

4.14 HELP

Syntax:

HELP <help file path>

4.15 IMPORT

Syntax:

IMPORT <symbol list>

IMPORT @<symbol list file>

4.16 INPUT

Syntax:

INPUT <object file> [, <object file> [, ...] ]

INPUT @<object list file>

This directive lists the input ELF (.o) object files that are to be linked. You can also list the object files in the list file, each object file on one line.

Example:

INPUT @objectfiles.txt
INPUT main.o
INPUT /usr/nwsdk/lib/prelude.o

4.17 MAP

Syntax:

MAP [map file name]

4.18 MESSAGES

Syntax:

MESSAGES <message file path>

4.19 MODULE

Syntax:

MODULE <autoload NLM list>

4.20 MULTIPLE

Syntax:

MULTIPLE

4.21 NAMELEN

Syntax:

NAMELEN <decimal number>

Default is 31. Zero is no limit.

4.22 OS_DOMAIN

Syntax:

OS_DOMAIN

4.23 OUTPUT

Syntax:

OUTPUT <target file name>

4.24 PATH

Syntax:

PATH [search path;...]

for following CUSTOM, HELP, INPUT, MESSAGES, SHARELIB, STAMPEDDATA and XDCDATA.

4.25 PSEUDOPREEMPTION

Syntax:

PSEUDOPREEMPTION

4.26 REENTRANT

Syntax:

REENTRANT

4.27 SCREENNAME

Syntax:

SCREENNAME "Initial Screen Name (CLIB)"

4.28 SHARELIB

Syntax:

SHARELIB <shared library path>

4.29 STACK

Syntax:

STACK <stack size>

4.30 STACKSIZE

Syntax:

STACKSIZE <stack size>

4.31 STAMPEDDATA

Syntax:

STAMPEDDATA "Stamp" <data file path>

Stamp is 8 char max.

4.32 START

Syntax:

START <start procedure name>

Default is _Prelude.

4.33 SYNCHRONIZE

Syntax:

SYNCHRONIZE

4.34 THREADNAME

Syntax:

THREADNAME "Initial Process Name (CLIB)"

4.35 TYPE

Syntax:

TYPE <version>

This directive specifies the format (NLM, LAN, DSK, NAM) of the NLM file to be generated. Valid values are:

• 0 - NLM
• 1 - LAN
• 2 - DSK
• 3 - NAM

Example:

TYPE 0

4.36 VERSION

Syntax:

VERSION <major version>, <minor version> [, <revision>]

The version information is displayed on the server system console when the NLM loads. The major and minor version numbers can be 0 - 99. The revision can be 0 - 26 ("a" - "z") and is optional. The version directive is required.

Example:

VERSION 1,5

4.37 XDCDATA

Syntax:

XDCDATA <XDC data file path>