
.. _news_cli:

news
****







.. rubric:: Output of :code:`--help=news`



The following help text is generated by :code:`ecflow_client --help=news`

::

   
   news
   ----
   
   Returns true if state of server definition changed.
   *Important* for use with c++/python interface only.
   Requires Given a client handle, change and modify number determine if server changed since last call
   This relies on user calling sync after news to update the locally stored modify and change numbers.
   These numbers are then used in the next call to news.
   
   The client considers, for both user and child commands, the following environment variables:
   
     ECF_HOST <string> [mandatory*]
       The main server hostname; default value is 'localhost'
     ECF_PORT <int> [mandatory*]
       The main server port; default value is '3141'
     ECF_SSL <any> [optional*]
       Enable secure communication between client and server.
     ECF_HOSTFILE <string> [optional]
       File that lists alternate hosts to try, if connection to main host fails
     ECF_HOSTFILE_POLICY <string> [optional]
       The policy ('task' or 'all') to define which commands consider using alternate hosts.
   
   The options marked with (*) must be specified in order for the client to communicate
   with the server, either by setting the environment variables or by specifying the
   command line options.
   

