$Id: config_help.txt,v 3d5390b6cc08 2009/09/09 08:11:15 misfire $

Artemis uses libconfig to read and store its configuration:
http://www.hyperrealm.com/libconfig/libconfig_manual.html

The config file is named artemis.conf and must be in Artemis' root folder.

Here is a list of the available settings:


Section "loader"
----------------

* iop_reset [bool, true by default]

  Set 'iop_reset' to true to reset the IOP on startup.

* sbv_patches [bool, true by default]

  Set it to true to apply all SBV patches on startup:
   - sbv_patch_enable_lmb
   - sbv_patch_disable_prefix_check
   - sbv_patch_user_mem_clear

* boot2 [string array, not set by default]

  'boot2' holds a list of ELF pathnames (including arguments). You can later
  select one of those ELFs in order to boot it instead of the disc's default
  ELF. This is handy if you want to directly boot/hack demos, for instance.

  Example:

  boot2 = [
    "cdrom0:\\MGS2\\MGS2.ELF;1 foo bar",
    "cdrom0:\\KESSEN2\\KESSEN2.ELF;1",
    "cdrom0:\\REZ.ELF;1"
  ];


Section "engine"
----------------

* install [bool, true by default]

  Set it to true if you want to install the cheat engine on startup.

* addr [32-bit offset, 0x00080000 by default]

  Specifies the load address of the cheat engine. This address must belong
  to user space memory (0x00080000-0x01ffffff).


Section "debugger"
------------------

* install [bool, true by default]

  Set it to true if you want to install the debugger on startup.

* addr [32-bit offset, 0x00090000 by default]

  Specifies the load address of the debugger.

* auto_hook [bool, false by default]

  Enable automatic hooking to hack games without the need for hook codes.

* rpc_mode [integer, 1 by default]

  Set SIF RPC mode to blocking (0) or non-blocking (1).

* load_modules [bool, true by default]

  Set to true if you want the debugger to reload our IOP modules on every IOP
  reboot. This is required to hack games, and should only be turned off for
  compatibility tests.

* ipaddr [IPv4 address in dotted decimal format, "192.168.0.10" by default]

  Configure the IP address for the PS2-side debugger. The PC client will connect
  to this address for remote debugging. You can figure out if network is "up" by
  pinging the IP address.

* netmask [IPv4 address in dotted decimal format, "255.255.255.0" by default]

  Configure the subnet mask for the PS2-side debugger.

* gateway [IPv4 address in dotted decimal format, "192.168.0.1" by default]

  Configure the gateway address for the PS2-side debugger.


Section "sdklibs"
-----------------

* install [bool, true by default]

  Set to true to install the SDK libraries like libkernel.erl.
  NOTE: Must be true for debugger and ELF loader to work.

* addr [32-bit offset, 0x000c0000 by default]

  Specifies the load address of the SDK libraries.


Section "elfldr"
----------------

* install [bool, true by default]

  Install the ELF loader to replace the original (evil) LoadExecPS2() syscall.
  NOTE: Must be true for the debugger to work.

* addr [32-bit offset, 0x000ff000 by default]

  Specifies the load address of the ELF loader.


Section "cheats"
----------------

* file [path, cheats.txt by default]

  Set 'file' to the name of the cheats file to use.


EOF
