aboutsummaryrefslogtreecommitdiffstats
path: root/src/vcl/FEATURE.yaml
blob: 06236bc62045e17fc63a3d3655441ddd878f07be (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
---
name: VPP Comms Library
maintainer: Florin Coras <fcoras@cisco.com>
features:
  - Abstracts vpp host stack sessions to integer session handles
  - Exposes its own async communication functions, i.e., epoll, select, poll
  - Supports multi-worker applications
  - Sessions cannot be shared between multiple threads/processes
  - VCL Locked Sessions (VLS):
      - Ensure through locking that only one thread accesses a session at a
        time
      - Detects and registers forked processes as new VCL workers. It does not
        register threads as new workers.
  - LD_PRELOAD shim (LDP):
      - Intercepts syscalls and injects them into VLS.
      - Applications that are supported work with VCL and implicitly with VPP's
        host stack without any code change
      - It does not support all syscalls and syscall options
description: "VPP Comms Library (VCL) simplifies app interaction with session layer
              by exposing APIs that are similar to but not POSIX-compliant."
state: production
properties: [API, CLI, MULTITHREAD]