.. _doc_use_claunch:


claunch
========


Cyber Launch的可执行文件名为claunch, 可将cluanch拷贝到/usr/bin文件夹下方便调用.


日志设置
--------

cluanch使用如下 claunch.properties 格式的配置进行日志格式设置:

.. literalinclude:: ../res/claunch.properties
   :language: properties

默认情况下, claunch只将日志输出到控制台, 如果需要将日志同时输出到指定位置的日志文件,
则需要通过 claunch.properties 文件进行配置. 指定 claunch.properties 文件有如下两种方式:

- claunch在启动时, 会优先读取系统环境变量 "CLAUNCH_CFG" 所指定的配置文件.

  .. code-block:: bash

    export CLAUNCH_CFG=/path/to/claunch.properties

- 如果没有设定系统环境变量 "CLAUNCH_CFG" , claunch会加载 "/etc/claunch.properties" 位置的配置文件.
  如果上述两个位置都没有找到配置文件, claunch会使用默认配置, 只将日志使用默认格式输出到控制台.


参数说明
--------

cluanch的使用方式如下:

::

    usage: claunch [<option> ...] -- <command>

cluanch支持如下参数:

- -h , --help

  显示帮助信息.

- -llfile , --launch-file=lfile

  从lfile位置所在位置加载启动文件. 支持多条-llfile参数, 用于加载多个启动文件.

- -ccfile , --create=cfile

  在cfile位置创建启动文件模板. 支持多条-ccfile参数, 用于创建多个启动文件模板.