HFS: Command line parameters

From rejetto wiki
Jump to navigation Jump to search

This is a list of command line parameters you can use in HFS.
This is a quite advanced topic, so don't worry if you don't even know what a command line is.

-a <FILENAME>
Load an additional ini file, which will eventually overwrite settings in the main ini file.
This file doesn't have to be a full ini, it can also be a single line.
By using this feature you can change almost anything in HFS configuration at startup, because almost everything is saved in the ini file.
Notice that you may not have a main ini file in the HFS folder. This is because the settings are saved in the registry; it's exactly the same mechanism.
If the only one instance option is enabled, you can use -a to change run-time options.
From version 2.1, there is an additional ini-command to be used combined with the -a parameter:
  • load-tpl-from=FULLPATH
    loads a template from the specified path.
Please notice this is an ini-command, not a command line parameter. The parameter we are discussing is always -a.
Here is an example of how to use the -a parameter. HFS is already running, the only one instance is enabled, and your goal is to switch the server off. All you have to do is to create a C:\foo.ini file with this content:
HFS 2.0 - Build #032
active=no
Then you will execute
hfs -a C:\foo.ini
It should work.
It is not necessary to match the exe version inside the ini. The version string is there to tell HFS how to interpret the commands, since some changes may go through different versions. Usually a newer HFS knows how to interpret old version ini commands.
Since version 2.3 the first line with the version string will not be mandatory.
-c <INI COMMANDS>
Warning: this feature is available only since version 2.3
You can pass ini commands directly from the command line. If only one instance is enabled, this is the easy way to command HFS from the command line.
This is an example to switch off the server:
hfs -c active=no
To specify many commands, separate them by \n. Example:
hfs -c active=yes\nport=8080
-d <X>
Waits at start for <X> tenths of second.
-q
Just quit. This is useful combined with only one instance , because if HFS is already running, a call to hfs -q causes the running HFS to quit.
-i <PATH>
load/save hfs.ini in folder <PATH>