How to use ActivePerl and GCC

How to use ActivePerl

Perl is a command-line based application. This means you'll have to run it from a DOS box/command prompt. Here's a crash-course command prompt in case you don't know how to use it.

Let's say you've written this Perl script, and saved it to the file C:\Documents and Settings\hello.pl:

print "Hello World!\n";

Now you must launch a command prompt. Click Start->Programs->DOS Prompt (Win9x), or Start->Programs->Acessories->Command Prompt (Win2k/XP). You will now see a big black window with white text, similar to Kore's console.

You also see that the line the cursor is at begins with "C:\>". This is the command prompt's working directory. You can compare it with the Location bar in a Windows Explorer window.

hello.pl is stored in C:\Documents and Settings. To change the working directory, use the cd "(FOLDER NAME)" command. This is similar to browsing to another folder in Windows Explorer. The following example shows how to change the working directory to C:\Documents and Settings:

C:\> cd "C:\Documents and Settings"
C:\Documents and Settings> _

You can now tell Perl to run hello.pl with the command "perl (YOUR SCRIPT'S FILENAME)". For example:

C:\Documents and Settings> perl hello.pl
Hello World!
C:\Documents and Settings> _

So, if you want to run openkore.pl, you first have to tell the command prompt to change the working directory to whatever folder that contains your openkore.pl. Then you type perl openkore.pl [arguments to pass to openkore], like this:

C:\> cd "C:\My Downloads\openkore"
C:\My Downloads\openkore> perl openkore.pl

Another example:

C:\My Downloads\openkore> perl openkore.pl --config=control/another-config.txt

How to use GCC

Like Perl, GCC is also a commandline program.

To compile XSTools.dll and NetRedirect.dll, you must use the Cygwin Bash shell. Grossly oversimplified, Bash is like DOS, except the directory seperated is a / instead of \.

First, cd into your OpenKore folder:

cd "C:/My Downloads/openkore"

Now type:

make

Yes, that's it.

If you see no error messages, then the compilation succeeded. You will find the DLLs in src\auto\XSTools.