SWI-Prolog 7.4.2 Reference Manual: Section 12.4

## 12.4 Finding Application files

If your application uses files that are not part of the saved program such as database files, configuration files, etc., the runtime version has to be able to locate these files. The file_search_path/2 mechanism in combination with the -palias command line argument is the preferred way to locate runtime files. The first step is to define an alias for the top-level directory of your application. We will call this directory `gnatdir` in our examples.

A good place for storing data associated with SWI-Prolog runtime systems is below the emulator's home directory. `swi` is a predefined alias for this directory. The following is a useful default definition for the search path.

    user:file_search_path(gnatdir, swi(gnat)).

The application should locate all files using absolute_file_name. Suppose `gnatdir` contains a file `config.pl` to define the local configuration. Then use the code below to load this file:

    configure_gnat :-
       (   absolute_file_name(gnatdir('config.pl'), ConfigFile)
       ->  consult(ConfigFile)
       ;   format(user_error, 'gnat: Cannot locate config.pl~n'),
           halt(1)
       ).

### 12.4.1 Specifying a file search path from the command line

Suppose the system administrator has installed the SWI-Prolog runtime environment in `/usr/local/lib/rt-pl-3.2.0`. A user wants to install `gnat`, but `gnat` will look for its configuration in `/usr/local/lib/rt-pl-3.2.0/gnat` where the user cannot write.

The user decides to install the `gnat` runtime files in `/users/bob/lib/gnat`. For one-time usage, the user may decide to start `gnat` using the command:

    % gnat -p gnatdir=/users/bob/lib/gnat