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

                               Copyright (c) 2011
                            Lantiq Deutschland GmbH
                     Am Campeon 3; 85579 Neubiberg, Germany

  For licensing information, see the file 'LICENSE' in the root folder of
  this software module.

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


1. CONTENT OF DELIVERY

1.1 SOURCE CODE CONTENT

The DSL CPE API is designed to fulfill a wide spectrum of applications.
Support for both low footprint as well as premium applications results in a
comprehensive source code content/structure. However please note that depending
on the used configuration
a) there are files available that you might not need at all
   (for example OS specific files)
b) even the needed files includes various configuration specific parts that
   might be not used for the selected configuration
As a result the lines of code (LOC) that are finally compiled/used are usually
much smaller than the available LOC.
For more details please also refer to chapter "3. Getting Started" within
"User's Manual Programmers Reference" (UMPR) of the DSL CPE API


1.2 SOURCE TREE STRUCTURE

Source tree structure for the DSL CPE Control application.

Please note that
a) the following tree does not include ALL files, it is just to get an easier
   overview about which parts might be important for the needed configuration
b) the usage of "<device>" indicates that a device specific file will be
   available according to the used source code delivery type.
   Currently there are deliveries as follows
   - "danube": Danube Family (includes Danube, Amazon-SE and ARX100)
   - "vrx": VRX200 Family
c) there is a dsl_mgmt_if subrepo included - please remember that in order to
   have up-to-date implementation in place, these following operations need to
   be executed in addition:
   - "git submodule update --init" (this step has to be executed especially in
     a clean clone of drv_dsl_cpe_api when the dsl_mgmt_if directory is empty)
   - commit of dsl_mgmt_if directory (diff will only show new commit hash if
     it was changed in a meantime - this step should be executed after each
     update in the dsl_mgmt_if repo in order to have most recent dsl_mgmt_if
     commit always linked to the drv_dsl_cpe_api repo)

dsl_cpe_control\
M:.
<0A>   AUTHORS
<0A>   ChangeLog
<0A>   Makefile.am
<0A>   NEWS
<0A>   TODO
<0A>   configure.in
<0A>   dsl_cpe_control.pjt
<0A>   LICENSE
<0A>   README
<0A>
+---src                                     // ALL sources including header files
<0A>   <20>   Makefile.am
<0A>   <20>   dsl_cpe_control.c
<0A>   <20>   dsl_cpe_control.h
<0A>   <20>   dsl_cpe_init_cfg.c
<0A>   <20>   dsl_cpe_init_cfg.h
<0A>   <20>   dsl_cpe_cli_<device>.c
<0A>   <20>   dsl_cpe_os.h                        \
<0A>   <20>   dsl_cpe_linux.c                     |
<0A>   <20>   dsl_cpe_linux.h                     |
<0A>   <20>   dsl_cpe_win32.c                     |  API internal OS abstraction for
<0A>   <20>   dsl_cpe_win32.h                     +  different OS in case of not using
<0A>   <20>   dsl_cpe_rtems.c                     |  ifx_os
<0A>   <20>   dsl_cpe_rtems.h                     |
<0A>   <20>   dsl_cpe_vxworks.c                   |
<0A>   <20>   dsl_cpe_vxworks.h                   /

<0A>   <20>   dsl_cpe_simulator.c
<0A>   <20>   dsl_cpe_simulator.h
<0A>   <20>   dsl_cpe_cli.c
<0A>   <20>   dsl_cpe_cli.h
<0A>   <20>   dsl_cpe_cli_access.c
<0A>   <20>   dsl_cpe_cli_console.c
<0A>   <20>   dsl_cpe_cli_console.h
<0A>   <20>   dsl_cpe_debug.c
<0A>   <20>   dsl_cpe_debug.h
<0A>   <20>   dsl_cpe_cli_pipe.c
<0A>   <20>   dsl_cpe_debug_<device>.c
<0A>   <20>   dsl_cpe_debug_<device>.h
<0A>   <20>   dsl_cpe_os_lint_map.h
<0A>   <20>   dsl_cpe_cli_mib.c
<0A>   <20>   LLCfg.txt
<0A>   <20>   Makefile.in
<0A>
+---dsl_mgmt_if                             // Shared repo
<0A>   <20>   readme.txt
<0A>   <20>
<0A>   +---include
<0A>   <20>   dsl_mgmt_interface.h
<0A>   <20>   dsl_mgmt_interface_fullpaths.h
<0A>   <20>   dsl_mgmt_interface_json_trees.h
<0A>   <20>
<0A>   +---status
<0A>   <20>   dsl_mgmt_status_parser.c
<0A>   <20>   dsl_mgmt_status_parser.h
<0A>
+---build_win32
<0A>   <20>   dsl_cpe_control_version.h
<0A>   <20>   drv_danube_api_intern.h
<0A>   <20>   dsl_cpe_simulator_config.h
<0A>   <20>
<0A>   +---vc7
<0A>   <20>
<0A>   +---vc6
<0A>
+---scripts
<0A>       dsl_cpe_pipe.sh
<0A>       alias_dsl_cpe.sh
<0A>
+---build_vxworks
        control_dsl_cpe_api.wpj