Dec-27 Release

LEGAL_TERMS

@@ -12,5 +12,8 @@ This software is governed by the Broadcom Advanced Switch APIs license.
 This license is set out in the
 https://github.com/Broadcom-Switch/OpenNSL/Legal/LICENSE-Adv file. 
 
+All third party licenses are listed in
+https://github.com/Broadcom-Switch/OpenNSL/LEGAL/README.txt
+
 Copyright 2015-2017 Broadcom Limited. All rights reserved.
 

Legal/README.TXT

@@ -1,6 +1,6 @@
 This project uses the following open source components:
 
-cJSON: vendor/cjson - Files in this folder uses the following license.
+1. cJSON: vendor/cjson - Files in this folder uses the following license.
 
 /*
    Copyright (c) 2009 Dave Gamble
@@ -24,3 +24,6 @@ cJSON: vendor/cjson - Files in this folder uses the following license.
    THE SOFTWARE.
  */
 
+2. The sFlow(R) feature of the software is an implementation of the
+   specifications published at�http://www.sflow.org�and governed by the sFlow
+   License Agreement: http://www.inmon.com/technology/sflowlicense.txt

README.md

@@ -1,6 +1,6 @@
 OpenNSL
 ======
-OpenNSL 3.4.0.x Switch Specification and Software
+OpenNSL 3.5.0.x Switch Specification and Software
 
 Overview
 ========

RELEASE

@@ -1 +1 @@
-opennsl-3.4.1.6
+opennsl-3.5.0.1

bin/LICENSE

@@ -228,6 +228,7 @@ bin/x86-xgs5-deb80       - Dell s6000 Switch System
   linux-kernel-bde.ko                -> Covered by GPLv2
   linux-user-bde.ko                  -> Covered by GPLv2
   linux-bcm-knet.ko                  -> Covered by GPLv2
+  linux-knet-cb.ko                   -> Covered by GPLv2
 
 bin/xlr-xgs5-ub14        - Broadcom XGS Switch Verification Kits with XLR CPU
 
@@ -252,3 +253,9 @@ bin/ar-x86-xgs5-deb80         - Arista 7260CX3 Switch System
   linux-kernel-bde.ko                -> Covered by GPLv2
   linux-user-bde.ko                  -> Covered by GPLv2
   linux-bcm-knet.ko                  -> Covered by GPLv2
+
+bin/ag-x86-dnx-deb80          - Agema AGC7648A Switch System
+
+  linux-kernel-bde.ko                -> Covered by GPLv2
+  linux-user-bde.ko                  -> Covered by GPLv2
+  linux-bcm-knet.ko                  -> Covered by GPLv2

bin/ag-x86-dnx-deb80/INSTALL

@@ -0,0 +1,69 @@
+This document describes how to install OpenNSL binary provided
+in this package on the supported Agema DNX platforms with x86 CPU card.
+
+Building OpenNSL
+================
+Source code for OpenNSL sample applications may be built on the switch. Use the
+following steps to compile OpenNSL including sample applications.
+
+1) Extract the code tarball into the destination directory say opennsl_root.
+
+2) Go to output directory: opennsl_root/opennsl/output/ag-x86-dnx-deb80
+
+3) Issue "make" to create an OpenNSL shared library object, linux kernel modules.
+
+4) The deliverables folder : opennsl_root/opennsl/output/ag-x86-dnx-deb80/build
+   shall have the following files.
+   a) Linux kernel module                     : linux-kernel-bde.ko
+   b) Linux user module                       : linux-user-bde.ko
+   c) KNET driver module                      : linux-bcm-knet.ko
+   d) OpenNSL shared object library           : libopennsl.so
+
+Building example Applications
+=============================
+NOTE: This section is applicable only if the package includes example applications.
+
+Source code for OpenNSL sample applications may be built on the switch. The
+example applications are dynamically linked with the OpenNSL shared library.
+Use the following steps to compile example applications.
+
+1) Go to output directory: opennsl_root/opennsl/output/ag-x86-dnx-deb80
+
+2) Issue "make examples" to compile all the sample applications
+
+
+Downloading and running OpenNSL sample applications
+===================================================
+
+1) cd to target deliverables directory:
+   opennsl_root/opennsl/output/ag-x86-dnx-deb80
+
+2) Use the following commands to update the linux kernel modules
+   i  ) Execute "lsmod" to list the installed linux kernel modules.
+   ii ) Remove the linux kernel and user modules by using "rmmod" command.
+   iii) Install linux kernel modules built for OpenNSL platform by using
+        the following commands. Please ensure that the modules are removed
+        before inserting it using 'rmmod' command.
+        # mknod /dev/linux-kernel-bde c 127 0
+        # mknod /dev/linux-user-bde c 126 0
+        # mknod /dev/linux-bcm-knet c 122 0
+        # insmod linux-kernel-bde.ko
+        # insmod linux-user-bde.ko
+        # insmod linux-bcm-knet.ko ftmh_lb_key_ext=1
+          Note: The following additional parameters needs to be passed to "insmod linux-bcm-knet.ko" if required. Use "modinfo" command to list the valid parameters.
+          a) Pass "ftmh_lb_key_ext=1", if "system_ftmh_load_balancing_ext_mode" is enabled in config file.
+          b) Pass "ftmh_stacking_ext=1", if "stacking_enable" is set to "1" in config file.
+
+3) Install OpenNSL shared library. The destination directory to install the
+   shared library depends on the host environment configuration.  Install the
+   library files in a location included in the system's library search path.
+   # mv libopennsl.so.1 /usr/lib
+   # cd /usr/lib
+   # ln -sf libopennsl.so.1 libopennsl.so
+
+4) Download the platform specific configuration files to switch. Set the OPENNSL_CONFIG_FILE path to point to configuration files. Refer to OpenNSL documentation, section "Customizing OpenNSL platform" for more details.
+
+5) cd to the target deliverables directory and run the sample application.
+    # chmod +x sample_application
+    #./sample_application
+

bin/ag-x86-dnx-deb80/README.1st

@@ -0,0 +1,2 @@
+Before you can use the libopennsl.so.1 in this directory you must first issue
+the command `gunzip libopennsl.so.1.gz; ln -s libopennsl.so.1 libopennsl.so`.