.. highlight:: rst .. _toast: ##### toast ##### **Software for tsunami simulation and verification.** Module Configuration ==================== | :file:`etc/defaults/global.cfg` | :file:`etc/defaults/toast.cfg` | :file:`etc/global.cfg` | :file:`etc/toast.cfg` | :file:`~/.seiscomp/global.cfg` | :file:`~/.seiscomp/toast.cfg` toast inherits :ref:`global options`. .. note:: Modules/plugins may require a license file. The default path to license files is :file:`@DATADIR@/licenses/` which can be overridden by global configuration of the parameter :confval:`gempa.licensePath`. Example: :: gempa.licensePath = @CONFIGDIR@/licenses .. confval:: forecastZones Type: *list:string* Registration of forecast zones. .. confval:: impactReports Type: *list:string* Registration of impact reports. The first element of the list defines the initial sort order. .. confval:: incidentMinimumMagnitude Default: ``0.0`` Type: *float* Minimum magnitude to create an incident for events received by messaging. If the magnitude of an event is smaller, no incident is created by TOAST. .. confval:: incidentMaximumDepth Default: ``100.0`` Unit: *km* Type: *double* Maximum depth to create an incident for events received by messaging. If the depth of an event is deeper, no incident is created by TOAST. .. confval:: isoInterval Default: ``30`` Unit: *min* Type: *int* Interval for arrival lines \(has to be provided by simulation backend\). TOAST displays the arrival lines as follows: full hour: solid line, half hour: dashed line, otherwise: dotted line. .. confval:: liveTabs Type: *list:string* Registration of live tabs. .. confval:: runupPercentiles Default: ``median`` Type: *list:string* Registration of runup percentiles. The first element of the list defines the initial sort order. .. confval:: processAutoMT Default: ``false`` Type: *boolean* Enables\/disables the usage of automatically generated moment tensors for event processing. By default only manual confirmed moment tensors will be taken into account. .. confval:: sourceRegions Type: *list:string* Usually more than one grid file is avaibable for the same earthquake location and the automatic system does not know which one to choose. Use this option to define which bathymetry grid should used for automatic processing\(Strg + N\). Registration of source regions. Each entry maps one or more regions to a bathymetry file. The entries are evaluated in FIFO order. If none of the entries matches the algorithm tries to select a fallback grid. .. confval:: alwaysShowAdditionalOptions Default: ``false`` Type: *boolean* Always show \"Execute with additional options\" dialog before running templates. If \"false\", then only after long click and selection. .. confval:: confirmationRequired Default: ``true`` Type: *boolean* Show \"Additional confirmation required\" dialog before running templates, or more precisely: before executing ClearSilver functions \"save\" and \"addScript\" in the templates. .. confval:: startRegion Type: *list:double* Shows the rectangular region on the central map at the start of TOAST. Define the rectangle with a list of 4 values: latmin, lonmin, latmax, lonmax. .. note:: **displacementVectors.\*** *Configure visualization settings for the coseismic* *displacement arrows (GNSS) in Map view.* *Note that if they are set using the dialog in TOAST,* *they are saved to the user configuration file at* *@CONFIGDIR@/toast.cfg and not to system configuration file at* *@SYSTEMCONFIGDIR@/toast.cfg.* .. confval:: displacementVectors.arrowHeadLength Default: ``12`` Unit: *px* Type: *int* Length of the arrow head. .. confval:: displacementVectors.arrowHeadWidth Default: ``8`` Unit: *px* Type: *int* Width of the arrow head. .. confval:: displacementVectors.arrowLineWidth Default: ``2`` Unit: *px* Type: *int* Width of the arrow line. .. confval:: displacementVectors.maxVisibleLength Default: ``300`` Unit: *px* Type: *int* Length of the largest visible displacement arrow if screenDependingScaling is 'true'. .. confval:: displacementVectors.maxVisibleLengthVertical Default: ``200`` Unit: *px* Type: *int* Length of the largest visible vertical displacement arrow if screenDependingScaling is 'true'. .. confval:: displacementVectors.minThreshold Default: ``0`` Unit: *mm* Type: *int* Only arrows with a length larger than minThreshold are visible. .. confval:: displacementVectors.scale Default: ``20`` Type: *int* Scaling factor for the arrows if screenDependingScaling is 'false'. .. confval:: displacementVectors.scaleVertical Default: ``20`` Type: *int* Vertical scaling factor for the arrows if screenDependingScaling is 'false'. .. confval:: displacementVectors.screenDependingScaling Default: ``true`` Type: *boolean* If 'true', then the largest visible arrow is scaled to maxVisibleLength. If 'false', then the length of the arrows is fix with respect to the map and changes with zoom level. .. confval:: displacementVectors.verticalScalingEnabled Default: ``false`` Type: *boolean* If 'true', then the scaling of the vertical displacement arrows is independent of the scaling of the horizontal arrows. .. note:: **filter.\*** *Define incident and simulation filters for the drop-down menu* *in the Database panel.* *These profiles are used automatically and need not be registered.* .. note:: **filter.incidents.$name.\*** $name is a placeholder for the name to be used. .. confval:: filter.incidents.$name.magnitude Default: ``0.0`` Type: *float* Minimum magnitude. .. confval:: filter.incidents.$name.depth Default: ``6500`` Unit: *km* Type: *float* Maxmimum depth. .. confval:: filter.incidents.$name.timeSpan Default: ``-1`` Unit: *s* Type: *int* Show incidents not older than \"timeSpan\" seconds. .. confval:: filter.incidents.$name.simulationCount Default: ``false`` Type: *boolean* If set to true only incidents with simulations will be shown, if set to false vice versa. .. confval:: filter.incidents.$name.observationCount Default: ``false`` Type: *boolean* If set to true only incidents with picks will be shown, if set to false vice versa. .. note:: **filter.simulations.$name.\*** $name is a placeholder for the name to be used. .. confval:: filter.simulations.$name.simulation Type: *list:string* Show only simulations of these simulation backends. .. confval:: filter.simulations.$name.sortColumn Default: ``Residual`` Type: *string* Sort table by this column. .. confval:: filter.simulations.$name.descendingOrder Default: ``true`` Type: *boolean* Sort table descending \(true\) or ascending \(false\). .. confval:: filter.simulations.$name.maxNumberOfSims Default: ``-1`` Type: *int* Limit the number of shown simulations. .. confval:: filter.simulations.$name.calculationDuration Default: ``-1`` Unit: *min* Type: *int* Show simulations with a calculation duration of at least that time. .. confval:: filter.simulations.$name.trigger Default: ``all`` Type: *string* Show simulations with that trigger type. Three possible options: show only manually triggered simulations \(manual\), only automatically triggered simulations \(automatic\) or simulations of both types \(all\). .. note:: **forecastZones.\*** *Define forecast zone profiles.* *Register the profiles at 'forecastZones'.* *Note that forecast points have to be defined and registered* *at simulation backends like easywave2.* .. note:: **forecastZones.$name.\*** $name is a placeholder for the name to be used and needs to be added to :confval:`forecastZones` to become active. .. code-block:: sh forecastZones = a,b forecastZones.a.value1 = ... forecastZones.b.value1 = ... # c is not active because it has not been added # to the list of forecastZones forecastZones.c.value1 = ... .. confval:: forecastZones.$name.filename Type: *string* Absolute filename without file extension .. confval:: forecastZones.$name.whitelist.country Type: *list:string* List of countries to include when loading forecast zones. .. confval:: forecastZones.$name.whitelist.exBoxID Type: *list:int* List of ExBoxIDs to include when loading forecast zones. .. confval:: forecastZones.$name.blacklist.country Type: *list:string* List of countries to exclude when loading forecast zones. .. confval:: forecastZones.$name.blacklist.exBoxID Type: *list:int* List of ExBoxIDs to exclude when loading forecast zones. .. note:: **impactReports.\*** *Define impact report types for the Impact Reports tab.* *These profiles are used automatically and need not be registered.* .. note:: **impactReports.$name.\*** $name is a placeholder for the name to be used and needs to be added to :confval:`impactReports` to become active. .. code-block:: sh impactReports = a,b impactReports.a.value1 = ... impactReports.b.value1 = ... # c is not active because it has not been added # to the list of impactReports impactReports.c.value1 = ... .. confval:: impactReports.$name.text Type: *string* Type selection box text .. confval:: impactReports.$name.toolTip Type: *string* Tool tip shown when the mouse is over the selected type item .. note:: **liveTab.\*** *Define Live tabs containing bulletin templates.* *Register the profiles at 'liveTabs'.* .. note:: **liveTab.$name.\*** $name is a placeholder for the name to be used and needs to be added to :confval:`liveTabs` to become active. .. code-block:: sh liveTabs = a,b liveTab.a.value1 = ... liveTab.b.value1 = ... # c is not active because it has not been added # to the list of liveTabs liveTab.c.value1 = ... .. confval:: liveTab.$name.title Type: *string* Title of the tab .. confval:: liveTab.$name.templ Type: *list:string* List of registered templates associated with this live tab. The sort order in the view follows the order here. .. confval:: liveTab.$name.buttonText Default: ``Disseminate`` Type: *string* Text of the disseminate button .. note:: **matching.\*** *Configure matching criteria which decide whether a similar* *simulation already exists or if a new simulation should be created.* *This is useful to reduce the number of simulations which are* *created in order to save disk space and computing time and* *to make the selection of the best simulation easier.* .. confval:: matching.magnitude.variance Default: ``0.1`` Type: *double* Maximum magnitude variance. The matching options control whether a new simulation \(scenario\) is actually generated. It is not generated if a simulation already exists for which magnitude, depth, location and fault plane all are within the configured variance with respect to the new simulation. .. confval:: matching.depth.variance Default: ``30.0`` Unit: *km* Type: *double* Maximum depth variance. For more information see the config option matching.magnitude.variance. .. confval:: matching.location.variance Default: ``0.1`` Unit: *degree* Type: *double* Maximum location variance. For more information see the config option matching.magnitude.variance. .. confval:: matching.faultPlane.variance Default: ``0.15`` Unit: *0, 1* Type: *double* Maximum fault plane orientation residual in the range [0, 1]. If set to 0, only identical fault planes are considered to match, if set to 1, fault planes are always considered to match. The residual is computed by mapping the rotation angle between fault planes from [0°, 90°] to [0, 1] using a sigmoid \(angles larger than 90° are mapped to 1\). For more information see the config option matching.magnitude.variance. .. note:: **patches.\*** *Configure settings for the automatic patches (rupture plane)* *generation.* .. confval:: patches.width Default: ``50`` Unit: *km* Type: *int* The patch width option is not used at this time. .. confval:: patches.depthMode Default: ``1`` Type: *int* Mode of the automatic depth correction. The following modes are available: 0 \= Off, 1 \= Adjust the depth to avoid negative z\-top, 2 \= Abort the patch generation in case of negative z\-top .. confval:: patches.maxFaultDist Default: ``1`` Unit: *degree* Type: *double* Maximum horizontal distance between epicenter and closest fault point allowed for automatic patch generation. .. confval:: patches.maxFootWallDist Default: ``-1`` Unit: *degree* Type: *double* Deprecated: Maximum distance between epicenter and closest fault point if epicenter is on foot wall. Note that this parameter is deprecated, use 'maxFaultDist' instead. .. confval:: patches.maxHangingWallDist Default: ``-1`` Unit: *degree* Type: *double* Deprecated: Maximum distance between epicenter and closest fault point if epicenter is on hanging wall. Note that this parameter is deprecated, use 'maxFaultDist' instead. .. confval:: patches.maxDip Default: ``80.0`` Unit: *degree* Type: *double* Maximum dip in degree. .. confval:: patches.maxRakeVariance Default: ``20.0`` Unit: *degree* Type: *double* Maximum variance of the rake from 90 degree. .. confval:: patches.extrapolateFault Default: ``false`` Type: *boolean* Selection of this option will extrapolate fault lines beyond their endpoints, so that they can provide patch generation information for epicenters otherwise not covered. .. note:: **picker.\*** *Configure settings for the tide gauge waveform picker.* .. confval:: picker.amplitudes Default: ``OTM`` Type: *list:string* Predefined amplitudes. .. confval:: picker.bufferSize Default: ``86400`` Unit: *s* Type: *int* Total sea level buffer .. confval:: picker.detecPhase Default: ``OTA`` Type: *string* Phase for automatic picking. .. confval:: picker.filters Default: ``@Tsunami;CUTOFF(1)>>ITAPER(15000)>>BW(4,0.0002,0.002);`` Type: *list:string* Predefined sea level filters. .. confval:: picker.leadTime Default: ``48200`` Unit: *s* Type: *int* Time of sea level data before the current time. .. confval:: picker.phases Default: ``OTA`` Type: *list:string* Predefined phases. .. confval:: picker.slots Type: *list:string* Registration of slots .. confval:: picker.stream.codes Default: ``*.*.*.*`` Type: *list:string* White list of stream code patterns. Use to filter the available streams. .. note:: **picker.slot.$name.\*** $name is a placeholder for the name to be used and needs to be added to :confval:`picker.slots` to become active. .. code-block:: sh picker.slots = a,b picker.slot.a.value1 = ... picker.slot.b.value1 = ... # c is not active because it has not been added # to the list of picker.slots picker.slot.c.value1 = ... .. confval:: picker.slot.$name.alias Type: *string* Alternative text. .. confval:: picker.slot.$name.filter Type: *string* User\-defined filter. .. confval:: picker.slot.$name.pen Type: *string* User\-defined pen. A pen is defined by a color, a width and a style. Pen styles are: 1 \- A plain line, 2 \- Dashes separated by a few pixels, 3 \- Dots separated by a few, 4 \- Alternate dots and dashes and 5 \- One dash, two dots, one dash, two dots. .. confval:: picker.slot.$name.predefined Default: ``false`` Type: *boolean* Received data from acquisition are not taken into account. .. confval:: picker.slot.$name.visible Default: ``true`` Type: *boolean* Show\/hide slot initially. .. confval:: picker.spectrogram.fixedMaximum Type: *double* The corresponding maximum value mapped to value 1 of spectrogram.gradient. .. confval:: picker.spectrogram.fixedMinimum Type: *double* If spectrograms are painted with a fixed gradient this value defines the minimum value which is mapped to gradient value 0 of spectrogram.gradient. .. confval:: picker.spectrogram.gradient Type: *list:string* Default spectrogram gradient. Value 0 is always mapped to a minimum value and 1 is mapped to a maximum \(either a fixed range or the extrema of each single trace\). .. note:: **residuals.\*** *Configure the weights of the residual contributions.* .. confval:: residuals.source.weight Default: ``1.0`` Type: *double* Weight of source residual for overall residual calculation. .. confval:: residuals.source.gradient Type: *list:string* Gradient of source residual. .. confval:: residuals.source.weights.magnitude Default: ``1.0`` Type: *double* Weight of magnitude for source residual calculation. .. confval:: residuals.source.weights.depth Default: ``1.0`` Type: *double* Weight of depth for source residual calculation. .. confval:: residuals.source.weights.distance Default: ``1.0`` Type: *double* Weight of distance to origin for source residual calculation. .. confval:: residuals.momentTensor.weight Default: ``1.0`` Type: *double* Weight of moment tensor residual for overall residual calculation. .. confval:: residuals.momentTensor.gradient Type: *list:string* Gradient of moment tensor residual. .. confval:: residuals.expectedPlane.weight Default: ``1.0`` Type: *double* Weight of expected plane residual for overall residual calculation. .. confval:: residuals.expectedPlane.gradient Type: *list:string* Gradient of expected plane residual. .. confval:: residuals.tideGauge.weight Default: ``1.0`` Type: *double* Weight of tide gauge residual for overall residual calculation. .. confval:: residuals.tideGauge.gradient Type: *list:string* Gradient of tide gauge residual. .. confval:: residuals.displacement.weight Default: ``1.0`` Type: *double* Weight of coseismic displacement \(GNSS\) residual for overall residual calculation. .. confval:: residuals.displacement.gradient Type: *list:string* Gradient of coseismic displacement \(GNSS\) residual. .. confval:: residuals.radar.weight Default: ``1.0`` Type: *double* Weight of radar residual for overall residual calculation. .. confval:: residuals.radar.gradient Type: *list:string* Gradient of radar residual. .. note:: **rttv.\*** *Configure settings for the Traces tab (Real-Time-Trace-Viewer).* .. confval:: rttv.acquireStreams Default: ``false`` Type: *boolean* Enables\/Disables real time acquisition .. confval:: rttv.bufferSize Default: ``86400`` Unit: *s* Type: *int* Total sea level buffer .. confval:: rttv.leadTime Default: ``48200`` Unit: *s* Type: *int* Time of sea level data before the current time. .. confval:: rttv.seaLevel.filters Default: ``@Tsunami;CUTOFF(1)>>ITAPER(15000)>>BW(4,0.0002,0.002);`` Type: *list:string* Predefined sea level filters in the traces perspective. .. confval:: rttv.stream.codes Default: ``*.*.*.*`` Type: *list:string* White list of stream code patterns. Use to filter the available streams. .. confval:: rttv.stream.filter Type: *string* Set rttv stream filter. .. confval:: rttv.spectrogram.fixedMaximum Type: *double* The corresponding maximum value mapped to value 1 of spectrogram.gradient. .. confval:: rttv.spectrogram.fixedMinimum Type: *double* If spectrograms are painted with a fixed gradient this value defines the minimum value which is mapped to gradient value 0 of spectrogram.gradient. .. confval:: rttv.spectrogram.gradient Type: *list:string* Default spectrogram gradient. Value 0 is always mapped to a minimum value and 1 is mapped to a maximum \(either a fixed range or the extrema of each single trace\). .. note:: **runupPercentiles.\*** *Define percentiles for the drop-down menu in the Forecast* *Zones tab.* *Register the profiles at 'runupPercentiles'.* .. note:: **runupPercentiles.$name.\*** $name is a placeholder for the name to be used and needs to be added to :confval:`runupPercentiles` to become active. .. code-block:: sh runupPercentiles = a,b runupPercentiles.a.value1 = ... runupPercentiles.b.value1 = ... # c is not active because it has not been added # to the list of runupPercentiles runupPercentiles.c.value1 = ... .. confval:: runupPercentiles.$name.text Default: ``Median`` Type: *string* Menu item text .. confval:: runupPercentiles.$name.value Default: ``50`` Type: *int* Value of the runup percentile. .. note:: **scheme.\*** *Configure visualization settings for TOAST.* *Colors can be defined in HTML convention, e.g. as rgb(a) values,* *hexadecimal numbers or color keyword names as defined by W3C.* *If rgb or rgba is used, it must be quoted because the comma* *is handled as list separator.* *Examples: "rgb(255,0,0)", "rgba(0,255,0,100)", FF00FF40, green.* .. confval:: scheme.precision.traceValues Default: ``2`` Type: *int* Decimal places of the trace values .. confval:: scheme.colors.records.eta Default: ``FF0000`` Type: *color* Color of the ETA \(T1 Time\) marker .. confval:: scheme.colors.records.etm Default: ``0000FF`` Type: *color* Color of the ETM \(T3 Time\) marker .. confval:: scheme.colors.records.ot Default: ``FF0000`` Type: *color* Color of the incident origin time bar .. note:: **sourceRegion.\*** *Define source regions within which simulations should be* *created and the bathymetry file to be used.* *Register the profiles at 'sourceRegions'.* *Keep in mind that a bathymetry file or directory has also* *to be configured at some simulation backends (e.g. easywave2).* .. note:: **sourceRegion.$name.\*** $name is a placeholder for the name to be used and needs to be added to :confval:`sourceRegions` to become active. .. code-block:: sh sourceRegions = a,b sourceRegion.a.value1 = ... sourceRegion.b.value1 = ... # c is not active because it has not been added # to the list of sourceRegions sourceRegion.c.value1 = ... .. confval:: sourceRegion.$name.aoi Type: *string* Path to BNA file. .. confval:: sourceRegion.$name.name Type: *string* Name of the bathymetry file without the extension .. note:: **symbol.\*** *Define POI symbols.* *These profiles are used automatically and need not be registered.* .. confval:: symbol.shape Default: ``ignore`` Type: *list:string* Default symbol for unknown POI types. .. confval:: symbol.types Type: *list:string* Registration of POI types, no default configuration here. The names must match with the POI types in the acquisition and processing configuration. For instance symbol.types \= buoy, tg .. note:: **symbol.$name.\*** $name is a placeholder for the name to be used and needs to be added to :confval:`symbol.types` to become active. .. code-block:: sh symbol.types = a,b symbol.a.value1 = ... symbol.b.value1 = ... # c is not active because it has not been added # to the list of symbol.types symbol.c.value1 = ... .. confval:: symbol.$name.shape Type: *list:string* Shape configuration for a symbol type. A shape is defined by a type, a size, a color and a border color separated by commas. Available shape types are circle, triangle, square and image. In case of an image the second parameter specifies the path including the filename. Parameters can be omitted from right to left. A sample configuration may look like: symbol.tg.shape \= image, \@DATADIR\@\/toast\/icons\/tg.png, ffffff .. note:: **templates.\*** *Register the requested bulletin templates defined at 'template' here.* .. confval:: templates.types Type: *list:string* Registration of bulletin templates .. note:: **templates.logging.\*** *Template logging options* .. confval:: templates.logging.stdout Default: ``false`` Type: *boolean* Capture standard out process output .. note:: **template.\*** *Define bulletin template profiles which can be used in a Live tab.* *Register the profiles at 'templates' and configure them in* *the 'liveTab' profiles.* .. note:: **template.$name.\*** $name is a placeholder for the name to be used and needs to be added to :confval:`templates.types` to become active. .. code-block:: sh templates.types = a,b template.a.value1 = ... template.b.value1 = ... # c is not active because it has not been added # to the list of templates.types template.c.value1 = ... .. confval:: template.$name.aoi Type: *string* Path to a BNA file which defines one or more regions. If more than one region matches, the first one is used. .. confval:: template.$name.maxMagnitude Type: *double* Upper bound of the magnitude range. .. confval:: template.$name.minMagnitude Type: *double* Lower bound of the magnitude range. .. confval:: template.$name.name Type: *string* Name of the template used in the GUI e.g. for the menu item .. confval:: template.$name.fileName Type: *string* Path to the template including the file name. .. confval:: template.$name.prerequisites.scenario Default: ``false`` Type: *boolean* Show hint if no scenario is selected .. note:: **trigger.\*** *Configure trigger criteria which control whether a simulation* *is created.* .. confval:: trigger.maximumAge Default: ``1800`` Unit: *s* Type: *int* Maximum age of events in seconds to start a simulation automatically. If the value is negative the age of an event is ignored. .. confval:: trigger.minimumMagnitude Default: ``6.0`` Type: *double* Minimum magnitude to start a similation automatically. .. confval:: trigger.origin.mode Type: *string* Evalution mode of origins to trigger simulations for. Supported modes are manual and automatic. If no mode is specified no filter will be applied. .. note:: **tsunami.\*** *Configure the TOAST database.* .. confval:: tsunami.database Default: ``mysql://sysop:sysop@localhost/toast`` Type: *string* Define the TOAST database connection. The format is: service:\/\/user:pwd\@host\/database. \"service\" is the name of the database driver which can be queried with \"\-\-db\-driver\-list\". IMPORTANT: This parameter replaces former \"tsunami.database.type\" and \"tsunami.database.parameters\" which have been deprecated. .. confval:: tsunami.database.type Type: *string* Deprecated: Defines the tsunami database backend to be used. The name corresponds to the defined name in the database plugin. Examples are: mysql, postgresql or sqlite3. Note that this parameter is deprecated, use 'tsunami.database' instead. .. confval:: tsunami.database.parameters Type: *string* Deprecated: The tsunami database connection parameters. This value depends on the used database backend. E.g. sqlite3 expects the path to the database file whereas MYSQL or PostgreSQL expect an URI in the format user:pwd\@host\/database?param1\=val1\¶m2\=val2. Note that this parameter is deprecated, use 'tsunami.database' instead. .. confval:: tsunami.database.loadLastDays Default: ``1`` Unit: *days* Type: *int* Load incidents of the last n days from database. Bindings Parameters =================== .. confval:: maxGapTolerance Default: ``3600.0`` Type: *double* Maximum gap in seconds between two records to apply linear interpolation .. confval:: spectrogram Type: *string* Min, max, periods and ranges of the spectrogramview e.g. periods_log\(1000,10000,5,10\) Command-Line Options ==================== Generic ------- .. option:: -h, --help Show help message. .. option:: -V, --version Show version information. .. option:: --plugins arg Load given plugins. Database -------- .. option:: --db-driver-list List all supported database drivers. .. option:: -d, --database arg The database connection string, format: service:\/\/user:pwd\@host\/database. \"service\" is the name of the database driver which can be queried with \"\-\-db\-driver\-list\". .. option:: --config-module arg The config module to use. .. option:: --inventory-db arg Load the inventory from the given database or file, format: [service:\/\/]location . .. option:: --config-db arg Load the configuration from the given database or file, format: [service:\/\/]location . Messaging --------- .. option:: -u, --user arg Overrides configuration parameter :confval:`connection.username`. .. option:: -H, --host arg Overrides configuration parameter :confval:`connection.server`. .. option:: -g, --primary-group arg Overrides configuration parameter :confval:`connection.primaryGroup`. .. option:: -S, --subscribe-group arg A group to subscribe to. This option can be given more than once. .. option:: --start-stop-msg arg Default: ``0`` Set sending of a start and a stop message. Verbosity --------- .. option:: --verbosity arg Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug. .. option:: -v, --v Increase verbosity level \(may be repeated, eg. \-vv\). .. option:: -q, --quiet Quiet mode: no logging output. .. option:: --component arg Limit the logging to a certain component. This option can be given more than once. .. option:: -s, --syslog Use syslog logging backend. The output usually goes to \/var\/lib\/messages. .. option:: -l, --lockfile arg Path to lock file. .. option:: --console arg Send log output to stdout. .. option:: --debug Execute in debug mode. Equivalent to \-\-verbosity\=4 \-\-console\=1 . .. option:: --log-file arg Use alternative log file.