HFS: Command line parameters

From rejetto wiki
Revision as of 13:02, 10 October 2006 by Peterh (talk | contribs)
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 you may not have a main ini file in root or the HFS folder. This is because it is 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 command:
  • load-tpl-from=FULLPATH
    loads a template from the specified path.
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.
-d <X>
Waits at start for <X> tenths of second.
-q
Just quit. This is useful combined with "only 1 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>