//////////////////////////////////////////////////////////////////////////
//// This content is shared by all Elastic Beats. Make sure you keep the
//// descriptions here generic enough to work for all Beats that include
//// this file. When using cross references, make sure that the cross
//// references resolve correctly for any files that include this one.
//// Use the appropriate variables defined in the index.asciidoc file to
//// resolve Beat names: beatname_uc and beatname_lc
//// Use the following include to pull this content into a doc file:
//// include::../../libbeat/docs/shared-command-line.asciidoc[]
//////////////////////////////////////////////////////////////////////////

*`-E <setting>=<value>`*::
Override a specific configuration setting. For example:
+
["source","sh",subs="attributes"]
----------------------------------------------------------------------
sudo ./{beatname_lc} -c {beatname_lc}.yml -E name=mybeat
----------------------------------------------------------------------
+
This setting is applied to the currently running {beatname_uc} process.
The {beatname_uc} configuration file is not changed. 

*`-N`*::
Disable the publishing of events to the defined output. This option is useful only
for testing the Beat.

*`-c <file>`*::
Pass the location of a configuration file for the Beat.

*`-configtest`*::
Test the configuration file and then exit. This option is useful for
troubleshooting the configuration of a Beat.

*`-cpuprofile <output file>`*::
Write CPU profile data to the specified file. This option is useful for
troubleshooting the Beat.

*`-d <selectors>`*::
Enable debugging for the specified selectors. For the selectors, you can specify a comma-separated
list of components, or you can use `-d "*"` to enable debugging for all components. For example,
`-d "publish"` displays all the "publish" related messages.

*`-e`*::
Log to stderr and disable syslog/file output.

*`-httpprof [<host>]:<port>`*::
Start http server for profiling. This option is useful for troubleshooting and profiling the Beat.

*`-memprofile <output file>`*::
Write memory profile data to the specified output file. This option is useful for
troubleshooting the Beat.

*`-path.config`*::
Set the default location for configuration (e.g. the Elasticsearch template). See the <<directory-layout>> section for
details.

*`-path.data`*::
Set the default location for data files. See the <<directory-layout>> section for details.

*`-path.home`*::
Set the default location for miscellaneous files. See the <<directory-layout>> section for details.

*`-path.logs`*::
Set the default location for log files. See the <<directory-layout>> section for details.

*`-setup`*::
Load the sample Kibana dashboards. By default, this downloads an archive file containing the Beats dashboards
from the elastic.co website. See the <<configuration-dashboards>> section for more details and more options.

*`-v`*::
Enable verbose output to show INFO-level messages.

*`-version`*::
Display the Beat version and exit.
