Console version of Effectus
Installation
Program and its dependencies are archived in ZIP format. Before using the program, you must download the version of your choice, which is in ZIP format. When you download this file, unzip it and create a directory to place the main files and all subdirectories as is. Executable file is called effectus.exe, which is accompanied with config.ini setup file, which has predeclared default settings for the program. Configuration file is not necessarily needed for proper functioning of the program, but in that case, proper parameter values must be set unless default settings satisfy you. Typically, to start using Effectus, just type effectus and the fully qualified pathname of the source file to be compiled.
Program usage
Common syntax:
- i386-win32 platform
effectus filename [parameters]
- i386-Linux platform
./effectus filename [parameters]
Program parameters:
-md: MADS cross-assembler directory
-sa: Program starting address
-ms: Output source directory
-mb: Output binary directory
-se: Output source extension
-be: Output binary extension
-rl: Effectus/MADS runtime library directory
-lo: Log pathname (including filename)
-sm: Machine language starting address
If config.ini file is in the same directory as Effectus is run, then those settings are read and used in the program.
The options available in configuration file are:
PARAMETER | SWITCH | DESCRIPTION |
ORG | -sa |
Starting address of generated program (in hexadecimal notation, preceding with $ sign) |
MADS_DIR | -md |
MADS cross-compiler directory |
MADS_SRC_EXT | -se |
Output assembly source code extension |
MADS_BIN_EXT | -be |
Output executable code extension |
MADS_RTL_DIR | -rl |
Runtime library directory |
ML_ORG | -sm |
Machine language starting address |
MADS_OUTPUT_DIR | -lo |
Log fully qualified pathname (including filename) |
If MADS cross-assembler pathname is included in your system path configuration file (autoexec.bat or registry key), then MADS_DIR option is deprecated unless the MADS program is placed in root directory, where Effectus is run. If config.ini is not used, MADS cross-compiler will be searched first in root directory, where Effectus is run. In this case, MADS cross-compiler set on system path will not be used.
As mentioned in Installaction section, config.ini file is not mandatory for proper functioning of the program. In this case, some caution must be taken. By default, all forementioned parameters have default values. Also, the runtime library directory is declared from root where Effectus is run (/lib) and log filename is set here as well. Otherwise, if you decide to set your own values, parameters must be set manually.
To start using Effectus, typically, just type effectus and the fully qualified pathname of the source file to be compiled. Your program is compiled in directory you are currently on, but that can be changed with -ms: and -mb: parameters. The fully qualified pathname with space characters must be put in double quotation marks.
Every parameter must end with colon, for example: -sa: