PROGRAM: Embedded C logging demo
VERSION: 1.1 (May 1, 2017)
STATUS: Evalution version

SOFTWARE FEATURES:

Embedded Logging is a solution targeted to limited embedded 
platform even system log is not available. The logging information(
warning, error and debug) messages can be logged in one or mulitple locations. 
All log configurations are intialially loaded from configuration files ,and 
can be overriden later by enviroment variable at running time. 

If you want to log messages via the system syslog, you not only need set 
syslog_enable =1, you also should ensure that your syslogd daemon is running.
If you want to redirect redirectsyslog message to a specific file,you need to 
locate and edit the syslog.conf file on your system.

To the syslog daemon is not available or you don't want to use syslog,setting
different destinations can rediret message to different locations , such as 
writing local files or send to remote serer syslog server etc. The Embedded 
logging supports remote trace with UDP packages. The messages are also displayed
with different colors locally or remotely.

The new log settings can be run-time changed without doing reinitialization.
by adding or updating same enviroment variables followed with "USR1" or "USR2"
signals, the user can enable/disale logging, change debug level or destintions 
etc. 

In addition, Embeddd logging provides simple logging rotations by cheching 
logging files and number of files, which is especially suitable for flash based 
embedded system. 

A log configuration file that defines all logging behavior has to be created 
and loaded when logging moudle is initialized. See the following template.

For detail information on how to use API in log_api.h,please refer to 
Embedded logging user menual.

SYSTEM REQUIREMENTS:
1. Linux Operating Systems: i686 i686 i386 GNU/Linux
   Linux kernel 2.6.x later

How to compile the demo code:

1. Extract the tar file e.g. Embedded_log_free_vxxx.tar.gz
        tar -xvf Embedded_log_free_vxxx.tar.gz
2. go to embedded_log_free folder
3. run make 

How to run the program

1. make the program executable by changing its file permission such as
    chmod 755 myproc

2. Open and edit the configuration file: config_log.conf, please refer to 
   the user manual. 

2 run "./myproc" 
 

CONTACTS:
E-mail: peitao@lrvs.net
http://www.lrvs.com/

/******************************************************************************

  Copyright (C), 2011-2017 PeitaoShi @LRVS, All Rights Reserved.

  THIS SOFTWARE IS PROTECTED UNDER SOURCE CODE AGREEMENT OR NON-DISCLOSURE AGREEMENT. 

  PERMISSION IS GRANTED TO LICENSE TO USE THIS SOFTWARE FOR ANY PURPOSE, INCLUDING
  COMMERICLA APPLICATION AND TO ALTER IT BUT NOT REDISTRIBUTE IT UNDER SORCE CODE 
  AGREEMENT/NON-DISCLOSUE AGREEMENT. YOU CAN NOT CLAIM THAT YOU WROTE THE SOFTWARE
  AFTER ALTERING SOURCE CODE.

  THIS SOFTWARE IS PROVIDED 'AS-IS', WITHOUT ANY EXPRESS OR IMPLIED WARRANTY.
  IN NO EVENT WILL THE AUTHOR(S) BE HELD LIABLE FOR NAY DAMGES ARISING FROM THE
  THE USER OF THIS SOFTWARE.

  ABOVE NOTICE SHOULD BE KEPT IN THE SOURCE CODE.

 ******************************************************************************/

