Entering content frame

 Options for Calling VMAKE 

Option

Description

D<digit>

Information on internal data and program runs is output. The larger <digit> is, the more information is output.

i

interactive
VMAKE is executed interactively (default setting for Microsoft Windows).
In UNIX systems, VMAKE creates a new process that assumes all of the tasks. The parent process shows all of the messages from the child process, and waits for termination signals. If you use the i option, a new process is not started, and the standard signal handlers are used.

w

This option corresponds to the default setting for UNIX systems, with the exception that the parent process is terminated by a termination signal without a query. Normally, this signal leads to a query asking you to confirm whether you want to terminate or continue.

b

background
This option terminates the parent process once the child process has been successfully generated.

Note: the child process is generated once all of the descriptions have been collected. Normally, the first child process message is <date> start of <target>. VMAKE is executed interactively before this message, that is, the standard signal handlers are used.

c

print collection only
Once all of the description files have been collected, all of the description information is displayed, and VMAKE is terminated.
This can be used to check the description files (or the VMAKE tool).

m

print module list only
Once all of the description information has been collected, all of the required module files are output.

x

print commands before execution
All of the file system commands executed by VMAKE are first displayed.

n

no execution
VMAKE functions as normal, but no file system or OS commands are executed.
VMAKE assumes that all of these operations have been successfully carried out.

r

unpack module frames only ('retrieve')
Normally, module files are 'freed' from their frame and then translated.
This option suppresses translation and linking. The unpacked module files remain in the working directory. No further operations are executed.

L

lint
This option analyzes C module files using
Lint. No further operations are executed.

S

sizeof
Size information for types and variables is extracted from PASCAL module files.
No further operations are executed.

d

do not make dependencies
Only the targets listed in the command line are created (if they are not up to date).
Dependent module files are assumed to be up to date. For test purposes, therefore, you can avoid having to update all of the dependent module files.

u

unconditionally make named targets
All named module files are explicitly retranslated and linked.
All dependent module files are translated and linked as standard, depending on whether they are up to date. All named description files are explicitly relinked.

U

unconditionally make ALL targets (except includes)
All named module files, and files that are dependent on them, are translated and linked (exception: include files).

I

unconditionally make includes too (with -U)
When this option is used with the -
U option, include files are regenerated.

k

keep temporary files
Temporary files created by VMAKE are not deleted.
These are unpacked module files, object files, and others.

K

keep temporary files
Temporary files created by VMAKE are not deleted.
In addition, all scripts are assigned the –k option, with the result that they also do not delete their temporary files.

p

include profiling calls into all targets
You use this option to specify profiling for all module files.

M

more information (print manual entry)
You use this option to display the
vmakman file.

l

local make
This option prevents object files from smaller path hierarchies from being used.
VMAKE only translates module files that originate from the lowest path hierarchy. This option overrides the $VMAKE_OPTION parameter g.

g

global make
Use of the complete path hierarchy $VMAKE_PATH for finding object files is initiated.
This option overrides the $VMAKE_OPTION parameter I.

R

require
To speed up the creation process, the
? require : <source> option in the description files is not evaluated (default setting in VMAKE). If you use the R option, the ? require : <source> option is taken into account.

F

file list for release
You use this option to create a distribution list; any obsolete targets, however, are not updated.
All files from the called target that have been assigned the distrib or distribute option for description files are entered in a list. This list is saved in a file in the $INSTROOT/etc directory. The name of the file is the same as the name of the called target. The file is given the extension .lst.

The all.lst file is created when you enter imf -F all .

+e

If you have specified software creation in debug mode using the $VMAKE_OPTION parameter, you can deactivate debug mode with the +e option.

Integration

Grammar for the VMAKE Call

 

Leaving content frame