HFS: Command line parameters

From rejetto wiki
Revision as of 18:03, 7 October 2006 by Rejetto (talk | contribs) (clearify -a paramter)
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, don't worry if you don't even know what a command line is.

-a <FILENAME>
Load an additional ini file, that will eventually overwrite settings in the main ini file.
This file has not to be a full ini, it can also be a single line.
Using this feature you can change almost anything on HFS configuration at startup, because almost anything is saved in the ini file.
Notice you may not have a main ini file just because it is saved in the registry: it's the same.
If the only one instance option is enabled, you can use -a to change options run-time.
Since version 2.1 an additional command exists:
  • load-tpl-from=FULLPATH
    loads a template from the specified path
Here goes an example of how to use the -a paramter. HFS is already running, the only one instance is enabled and your goal is to switch the server off. What 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 version of the exe 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 versions ini commands.
-d <X>
Waits at start for <X> tenth of second.
-q
Just quit. It is useful with "only 1 instance", because if HFS is already running, a call to hfs -q will cause the running HFS to quit.
-i <PATH>
load/save hfs.ini in folder <PATH>