BioNetDB implements the bionetdb.sh command line with the following syntaxis:
General usage documentation
In this section you will learn how to use the command lines, some examples are provided using bionetdb.sh command line.
Basic command line conventions
BioNetDB follows the most standard conventions when implementing command lines, the most relevant ones are:
- single-character parameters start with only one hyphen symbol and can be either lower-case or upper-case, e.g. -h to print the help or -S to provide session id; while multi-character parameters start with two hyphens and are always lower-case, e.g. --help to print the help or --name to provide a name.
- in the Usage the optional parameters are written always between [ square brackets ], in the following example help, version and option are not mandatory:
./opencga.sh [-h|--help] [--version] <command> [options]
- in the Usage the mandatory parameters are written between symbols < and >, like <command> in the previous example.
Executing the top level command line
You can execute the command line without any argument to get the usage help (you can also provide -h parameter):
Executing a specific command
When one command is executed without any other argument a specific help is shown, this specific help shows a brief description and the different options available with a brief description, as you can see in the following example:
Some of these options are available for most of the commands, these are:
-C, --conf: If not defined, the command line will assume that the configuration folder can be found in the parent folder where the executable is found (../conf). If that is not the case or if the user wants to use other configuration files available in a different path, the path should be provided.
-h, --help: Shows the help with the list of options. Generally this is not necessary because there is almost always a mandatory parameter to be provided, although it is needed in a few cases if user wants to see the options.
--log-file: By default, all the logs generated by the command lines are printed in the screen. However, the user might want to redirect the logs to another file. For those cases, the user will need to provide the file where the logs will be stored.
-L, --log-level: There are 5 different log levels: 'error', 'warn', 'info', 'debug', 'trace'
Table of Contents:
- No labels