Skip to content

TSDC-TEAM/nginx-kos

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8,155 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nginx web server for KasperskyOS

This version of nginx is adapted for KasperskyOS.

What is an nginx web server for KasperskyOS?

The nginx web server for KasperskyOS is based on the nginx 1.25.1. Please refer to the http://nginx.org/en/docs/ for more information that is not related to this project.

For the nginx web server for KasperskyOS the number of worker processes can only be 1. The worker_processes directive in the nginx configuration file is ignored.

For additional details on KasperskyOS, including its limitations and known issues, please refer to the KasperskyOS Community Edition Online Help.

Table of contents

Getting started

Prerequisites

  1. Confirm that your host system meets all the System requirements listed in the KasperskyOS Community Edition Developer's Guide.
  2. Install the KasperskyOS Community Edition SDK version 1.4. You can download it for free from os.kaspersky.com.
  3. Copy project source files to your home directory. All files that are required to build the nginx web server for KasperskyOS and examples of KasperskyOS-based solutions are located in the following directory:
    ./kos
    
  4. Source the SDK setup script to configure the build environment. This exports the KOSCEDIR environment variable, which points to the SDK installation directory:
    source /opt/KasperskyOS-Community-Edition-<platform>-<version>/common/set_env.sh

Building the nginx web server for KasperskyOS

Go to the ./kos/nginx directory and run the following commands to build the nginx web server for KasperskyOS:

$ cmake -B build -D CMAKE_TOOLCHAIN_FILE="$KOSCEDIR/toolchain/share/toolchain-aarch64-kos.cmake" -D CMAKE_INSTALL_PREFIX="$KOSCEDIR/sysroot-aarch64-kos"
$ cmake --build build

The nginx web server for KasperskyOS is built using the CMake build system, which is provided in the KasperskyOS Community Edition SDK.

Installing and removing the nginx web server for KasperskyOS

To install the nginx web server for KasperskyOS to the KasperskyOS Community Edition SDK, go to the ./kos/nginx directory and run the following command:

$ cmake --install build

To remove the nginx web server for KasperskyOS from the KasperskyOS Community Edition SDK, go to the ./kos/nginx directory and run the following command:

$ cmake --build build --target uninstall

⬆ Back to Top

Usage

When you develop a KasperskyOS-based solution, use the recommended structure of project directories to simplify the use of CMake scripts.

To include the nginx web server in your KasperskyOS-based solution, follow these steps:

  1. Add the find_package() command to the ./CMakeLists.txt root file to find and load the nginx package.
    find_package (nginx REQUIRED)
    
    For more information about the ./CMakeLists.txt root file, see KasperskyOS Community Edition Online Help.
  2. Add the Nginx program to a list of program executable files defined in the ./einit/CMakeLists.txt file as follows:
    set (ENTITIES
         nginx::Nginx
         ...)
    
    For more information about the ./einit/CMakeLists.txt file for building the Einit initializing program, see the KasperskyOS Community Edition Online Help.
  3. Specify a list of IPC channels that connect the Nginx program to VfsNet and VfsSdCardFs programs in the ./einit/src/init.yaml.in template file or using target properties. For more information about the init.yaml.in template file, see the KasperskyOS Community Edition Online Help.
  4. Create a solution security policy description in the ./einit/src/security.psl file. For more information about the security.psl file, see KasperskyOS Community Edition Online Help.
  5. Add nginx configuration files to the directory ./resources.

Example

You can review the example of developing a solution using nginx web server in KasperskyOS in the ./kos/example directory.

⬆ Back to Top

Trademarks

Registered trademarks and endpoint marks are the property of their respective owners.

Adobe is either a registered trademark or a trademark of Adobe in the United States and/or other countries.

AI X, GRPC, PowerPC, RDN, and Solid are trademarks of International Business Machines Corporation, registered in many jurisdictions worldwide.

AMD, Opteron are trademarks or registered trademark of Advanced Micro Devices, Inc.

Apache is either a registered trademark or a trademark of the Apache Software Foundation in the United States and/or other countries.

Apple, Mac, Macintosh, macOS, Mac OS, Newton, OS X, and Safari are trademarks of Apple Inc.

Arm is a registered trademark of Arm Limited (or its subsidiaries) in the US and/or elsewhere.

Avira and other Avira product names referenced herein are trademarks of Avira or its Affiliates.

Chrome, Google, and SPDY are trademarks of Google LLC.

CentOS, Fedora are trademarks or registered trademark of Red Hat, Inc. or its subsidiaries in the United States and other countries.

Borland is a trademark or registered trademark of Borland Software Corporation.

Catalyst is a registered trademark or trademark of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.

Intel, Pentium are trademarks of Intel Corporation or its subsidiaries.

Internet Explorer, Microsoft, Outlook, Tahoma, Verdana, Visual C++, Visual Studio, Win32, Windows, and Windows Vista are trademarks of the Microsoft group of companies.

Comodo is a trademark owned by Comodo and/or its affiliates.

Debian is a registered trademark of Software in the Public Interest, Inc.

Dell Technologies, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.

Dropbox is a trademark of Dropbox, Inc.

Firefox, Mozilla are trademarks of the Mozilla Foundation in the U.S. and other countries.

FreeBSD is a registered trademark of The FreeBSD Foundation.

JavaScript, Oracle, and Solaris are registered trademarks of Oracle and/or its affiliates.

Linux is the registered trademark of Linus Torvalds in the U.S. and other countries.

OpenSSL is a trademark owned by the OpenSSL Software Foundation.

PGP is a trademark or registered trademark of Symantec Corporation or its affiliates in the U.S. and other countries.

Raspberry Pi is a trademark of the Raspberry Pi Foundation.

Symbian trademark is owned by the Symbian Foundation Ltd

SPL is a trademark and registered trademark of Splunk Inc. in the United States and other countries.

Ubuntu is a registered trademark of Canonical Ltd.

UNIX is a registered trademark in the United States and other countries, licensed exclusively through X/Open Company Limited.

Contributing

Only KasperskyOS-specific changes can be approved. See CONTRIBUTING.md for detailed instructions on code contribution.

License

This project is licensed under the terms of the nginx license. See LICENSE for more information.

⬆ Back to Top

About

An official read-only mirror of http://hg.nginx.org/nginx/ which is updated hourly. Pull requests on GitHub cannot be accepted and will be automatically closed. The proper way to submit changes to nginx is via the nginx development mailing list, see http://nginx.org/en/docs/contributing_changes.html

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • C 97.2%
  • Vim Script 1.9%
  • XS 0.4%
  • CMake 0.3%
  • Perl 0.1%
  • Makefile 0.1%