NAME

exdehl.conf - exdehl configuration files

DESCRIPTION

exdehl loads configuration files from these places in this order:

1. the global configuration file
2. the project-local configuration file

A configuration file is a sequence of configuration entries, one per line. The basic configuration entry has the form

name = value

value may be:

• a number in the range 0-65535, either decimal or hexadecimal when preceded by -I 0x. The number may optionally be followed by a K, M or G suffix, meaning Kibi-, Mebi- or Gibibytes (or a shift left by 10, 20 or 30 bits).
• a boolean, possible values are true, yes, false, no
• a quoted string, such as "this one"

The initial configuration of a module usually takes this form:

module {
	name = value
	...
}

The individual entries may then in the project local config file be
referenced as
module.name = value

Also, configuration files can use these directives:
include "file"
include one or more files. Includes happen relative to the
current configuration file. The "file" argument may also
contain wildcards.
usemod "module"
load the module "module.so". A module is only active if it has
been enabled using usemod.

The # character starts a comment, that continues to the end of the
line.

Use the -C command line option to exdehl to see what
configuration options are available. Note that in your local
configuration file, you should always use the module.name
notation. 

Important global and common options

module_path

a colon delimited list of directories to search for modules.

helper_path

a colon delimited list of directories to search for helper scripts

init_batch

the name of a file to be read on debugger startup. This file can be used to set up a debugging session using debugger commands. All debugger commands, that do not cause the execution of code, can be used in this file.

io_address_width

the width in bits of the i/o address bus, can be 8 or 16

symbol_file

the symbol file that was generated by the assembler, if any

symbol_file_helper

a helper skript to convert the assemblers symbol file into the format expected by exdehl

*.io_base_addr

the base i/o address of a device. The size of the i/o space is determined by the device itself, but this must be used to set where the i/o space begins.

for more check the output of exdehl -C

FILES

/usr/local/etc/exdehl.conf

global configuration file for exdehl

/usr/local/etc/exdehl/*.conf

per-module configuration files

./exdehl.conf

project local configuration file

EXAMPLES

See the example projects in the samples folder for examples.

SEE ALSO

exdehl(1)

(This manual page has been converted using pandoc, with only minor cosmetic work afterwards)