安全网关项目产品代码仓库

简介

  安全网关项目产品侧仓库，主要存放应用与安全网关设备上的应用、内核等相关功能的代码。

目录结构

.                               安全网关产品源代码主目录
├── Common                      产品侧和平台侧公共头文件
├── docs                        Readme 文档相关资源存放目录
├── Platform                    平台侧工程目录
│   ├── build                   平台侧系统构建 Makefile 目录
|   ├── common                  平台侧公共代码目录
│   ├── modules                 平台侧内核态工程源代码目录
│   │   ├── cfgrcv
│   │   ├── conntrack_api
│   │   │   ├── api
│   │   │   ├── demoA
│   │   │   └── test
│   │   ├── netlink_api
│   │   └── pdelivery
│   └── user                    平台侧用户态工程源代码目录
│       ├── cfg2kernel
│       ├── netlink_uapi
│       └── pdeliv_u
├── Product                     产品侧工程目录
│   ├── build                   产品侧系统构建 Makefile 目录
│   ├── common                  产品侧公共代码目录
│   ├── modules                 产品侧内核态工程源代码目录
│   │   └── demo                内核态态应用程序 demo 目录
│   └── user                    产品侧用户态工程源代码目录
│       └── demo                用户态应用程序 demo 目录
└── kernel                      内核源码存放目录

注意事项：

1. 内核态功能相关代码存放于 modules 目录下
2. 用户态功能相关代码存放与 user 目录下
3. 每个独立的功能以子目录方式存放到适当的目录下
4. user 与 modules 目录中共有的源代码和头文件以及配置文件必须存放到 common 目录中
5. 不得把相同功能、相同定义、相同配置的内容独立放到各自的 user 和 modules 目录中

编译方法

1. 从仓库获取最新代码

git clone --recursive git@git.komect.net:ISG/secogateway.git git submodule update --init --recursive
或
git submodule update --init --recursive git pull

2. 安装必要软件(UBuntu)

sudo ./fsl-qoriq-glibc-x86_64-fsl-toolchain-aarch64-toolchain-2.4.1.sh sudo apt-get -y install git u-boot-tools device-tree-compiler autoconf curl flex sudo apt-get -y install automake dh-autoreconf libssl-dev openssl libpcap-dev bc sudo apt-get -y install python-pip qemu-utils libncurses5-dev python-crypto bison

3. 安装 linux 内核源代码

sudo mkdir -p /opt/fsl-kernel /opt/fsl-kernel/arm64 /opt/fsl-kernel/x86 sudo chmod 644 /opt/fsl-kernel -R cp ./kernel/linux-4.14.83 /opt/fsl-kernel/x86 -rf cp ./kernel/linux-4.14.83 /opt/fsl-kernel/arm64 -rf

4. 设置环境变量

在 ~/.bashrc 文件末尾加上以下几行配置
export HUACHENG_LINUX_KERNEL=/opt/fsl-kernel/x86/linux-4.9.140 export HUACHENG_ARM64_KERNEL=/opt/fsl-kernel/arm64/linux-4.9.140 export SDKTARGETSYSROOT=/opt/fsl-qoriq/2.4.1/sysroots/aarch64-fsl-linux export PATH=/opt/fsl-qoriq/2.4.1/sysroots/x86_64-fslsdk-linux/usr/bin:/opt/fsl-qoriq/2.4.1/sysroots/x86_64-fslsdk-linux/usr/sbin:/opt/fsl-qoriq/2.4.1/sysroots/x86_64-fslsdk-linux/bin:/opt/fsl-qoriq/2.4.1/sysroots/x86_64-fslsdk-linux/sbin:/opt/fsl-qoriq/2.4.1/sysroots/x86_64-fslsdk-linux/usr/bin/../x86_64-fslsdk-linux/bin:/opt/fsl-qoriq/2.4.1/sysroots/x86_64-fslsdk-linux/usr/bin/aarch64-fsl-linux:/opt/fsl-qoriq/2.4.1/sysroots/x86_64-fslsdk-linux/usr/bin/aarch64-fsl-linux-musl:$PATH source ~/.bashrc

5. 编译内核

• x64_86
  cd /opt/fsl-kernel/x86/secogateway/kernel/linux-4.9.140 && make -j
• arm64
  cd /opt/fsl-kernel/arm64/secogateway/kernel/linux-4.9.140 && unset LDFLAS 修改 Makefile 文件第 257、258 两行
  ARCH ?= $(SUBARCH) CROSS_COMPILE ?= $(CONFIG_CROSS_COMPILE:"%"=%)
  为
  ARCH ?= arm64 CROSS_COMPILE ?= aarch64-fsl-linux-
  然后运行 make 命令进行编译
  或者设置 make 参数进行编译
  make CROSS_COMPILE=aarch64-fsl-linux- ARCH=arm64

6. 构建系统

• 构建
  cd secogateway
make OPT=clean && make
• 清理
  make OPT=clean
• 安装
  make OPT=install [DIR=../_install]
  DIR 环境变量指定了最终安装默认，默认为 ../_install。支持绝对路径以及相对路径。
• 安装目录结构

_install
└── debug               系统构建类型 debug/release
    ├── targets         构建可执行程序、驱动安装目录
    │   ├── ARM64       ARM64 平台的可执行程序、驱动
    │   └── LINUX       Linux 平台的可执行程序、驱动
    └── targets.debug   构建可执行程序、驱动的对应调试符号信息安装目录
        ├── ARM64       ARM64 平台的可执行程序、驱动调试符号信息
        └── LINUX       ARM64 平台的可执行程序、驱动调试符号信息

• 编译信息
  执行 make 命令进行编译结束后，./Common/compile.h 文件中保存了当前系统编译信息，可以在代码中直接引用。
  #define sGATE_COMPILE_DATE "2019-05-22" #define sGATE_COMPILE_TIME "11:19:58" #define sGATE_COMPILE_MAJOR "20190522" #define sGATE_COMPILE_SUB "111958" #define sGATE_COMPILE_BY "hx" #define sGATE_COMPILE_HOST "hx-ubuntu" #define sGATE_GIT_TAGS "sGATE1.0-20181213-stable-159-g1b4c69da2-dev" #define sGATE_GIT_VERS "1b4c69da2d9cd6d133075f2fd96fbe0ac220fb72"
  sGATE_GIT_TAGS 记录了当前源码在 gitlab 服务器上面的分支信息
  sGATE_GIT_VERS 记录了当前源码在 gitlab 服务器上面的版本信息

7. git忽略kernel目录

由于大多数人在开发时用不到kernel目录下面的内核源代码内容，并且内核源代码占用了大量磁盘空间，可以通过命令让git忽略kernel目录，并且在本地删除kernel目录下面的所有内容。

• 1. 编辑 .git/info/exclude 文件，在文件中加入 kernel/ 表示忽略 kernel 目录下的内容
• 2. 执行git命令对kernel目录下面的所有文件停止追踪
     cd secogateway/kernel git ls-files -v | awk '{print $2}' | xargs git update-index --assume-unchanged rm kernel/* -r

8. Windows 开发环境搭建

• 方法一:下载克隆（或屏蔽）部分文件代码（适用于不在windows下查看、编辑linux内核代码的开发人员）

1. 说明 windows操作系统git下载克隆（或屏蔽）部分文件代码的方法 使用以下代码的重点是，不能使用POWERSHELL/CMD，只能使用git bash，如果在POWERSHELL/CMD中操作，在最后一步命令的时候会报以下错误： error: Sparse checkout leaves no entry on working directory

2. 准备工作：启用git的sparse checkout功能（要求Cit 1.7+版本）

    mkdir secogateway
    cd secogateway
    git init
    git remote add -f origin http://git.komect.net/ISG/secogateway.git
    git config core.sparsecheckout true
   

3. 设置检出的过滤规则：示例屏蔽kernel文件夹

    echo '/*' >> .git/info/sparse-checkout #这一步不可省略
    echo '!/kernel/' >> .git/info/sparse-checkout
   

4. 命令行 执行检出：（或使用TortoiseGit等图形化工具，执行检出）

    git checkout master
   

---

• 方法二:windows下模拟linux文件系统

1. 下载并安装 cygwin
2. 运行安装程序
3. 在源选择界面中按图添加163源 http://mirrors.163.com/cygwin/
4. 安装包选择界面中选择中 git 等必要命令(如果没有选择上，以后可以运行安装工具继续选择)
5. 点击 下一步 等待安装完成
6. 运行 cygwin，执行以下代码（假设 Windows 目录为 E:\my_projects）拉取服务器代码
   cd /cygdrive/e/my_projects git clone git@git.komect.net:ISG/secogateway.git
7. 如果 git clone 报错，请设置 ssh key
8. git clone 完成后，可以从 E:\my_projects\secogateway 访问文件。警告文件为内核源码，可以忽略
9. 可以将 kernel/linux-4.14.83/ 添加到本地 .gitignore 文件中，但不要将 .gitignore 文件提交到服务器

---

• 方法三:将服务器目录映射到 Windows 驱动器（网络IO非常慢，建议在服务器上编译）

1. 安装 sshfs
2. 安装 WinFsp
3. 参照 WinFsp文档 进行配置