CLI

Common Language Infrastructure

Management →
Introduced in R99 Also in: Services, User Equipment, Management

CLI is the Common Language Infrastructure, a standardized framework for managing multi-vendor telecommunications network elements and services using a common syntax and semantics for configuration, fault, and performance management.

Category
Management
Introduced
R99
Where
Radio Access Network › NG-RAN (5G)
Also touches
3 segments
Specifications
19 specs
CLI Description Purpose Related Classification Detected Changes Specifications

Description

The Common Language Infrastructure (CLI) is a comprehensive management framework defined by 3GPP to standardize the interface between Operation and Maintenance (O&M) systems and network elements (NEs) from different vendors. It establishes a common command-line syntax, command structure, and semantic meaning for management operations, allowing network operators to use consistent procedures across heterogeneous network equipment. This infrastructure is crucial for automating network management tasks, performing bulk configurations, and ensuring that operational scripts and tools work uniformly regardless of the underlying hardware or software implementation.

Architecturally, CLI operates as a management interface typically accessed via secure shell (SSH) or telnet sessions to network elements like base stations (gNBs, eNBs), core network functions (AMF, SMF, UPF), and user equipment. The framework defines a hierarchical command structure with modes (like global configuration mode, interface configuration mode), context-sensitive help, command completion, and standardized output formats. Key components include the command parser, which interprets user input according to the defined syntax; the authorization and authentication module, which controls access based on user privileges; and the command executor, which translates valid commands into specific actions on the network element's management plane.

CLI's role in the network extends beyond basic configuration to encompass fault management (show commands for alarms and logs), performance monitoring (counters and statistics retrieval), security management (access control lists, certificate management), and software management (image upgrades, patch management). The infrastructure supports both interactive sessions for manual operations and scripted sessions for automation, with output formats designed for both human readability and machine parsing (e.g., XML, JSON in later releases). This dual capability makes CLI essential for day-to-day network operations as well as large-scale orchestration systems.

Implementation-wise, CLI commands are mapped to underlying management protocols and data models, such as NETCONF/YANG or proprietary interfaces. While CLI presents a unified text-based interface to the operator, it acts as a facade that translates commands into protocol-specific operations on the managed entity. The framework also defines conventions for command grouping (e.g., all radio-related commands under a 'radio' hierarchy), standardized parameter names (e.g., cellId, plmnId), and consistent error messages, which significantly reduces the learning curve for engineers working with equipment from multiple vendors.

Purpose & Motivation

CLI was created to address the critical problem of operational complexity in multi-vendor telecommunications networks. Before standardization, each equipment manufacturer implemented proprietary command-line interfaces with different syntaxes, command structures, and behaviors, forcing network operators to maintain separate skill sets, operational procedures, and automation tools for each vendor's equipment. This fragmentation increased operational costs, raised the risk of human error during configuration changes, and hindered large-scale network automation. The Common Language Infrastructure provides a unified management layer that abstracts vendor-specific implementations, enabling consistent network operations.

Historically, as 2G networks evolved into 3G (UMTS) with R99, the need for standardized management became apparent due to the increasing diversity of network elements and the emergence of multi-vendor deployments. CLI was introduced to create a common operational language that would survive technology generations from 3G through 4G to 5G. It solves the fundamental challenge of managing network elements that may have different internal architectures but need to present a consistent management interface to network operators.

The infrastructure addresses limitations of previous approaches by providing not just command standardization but also semantic consistency—ensuring that commands with the same name across different vendors produce equivalent results. This enables operators to write reusable scripts, develop standardized operational procedures, and train personnel on a single interface paradigm. By reducing vendor lock-in at the operational level, CLI promotes healthier competition in the telecommunications equipment market while giving operators greater flexibility in network design and vendor selection.

Classification

Part ofOAM
Specific typesOIP

Release Timeline

Detected Changes Across Releases

from 3GPP Change Requests

Specific changes extracted from the „Change history“ tables of 3GPP specifications (16 CRs across 2 releases). Complements the general historical overview above with the evidence-based evolution of this function.

Rel-16 11 changes

In Release 16, 3GPP introduced the CLI (Cross Link Interference) function to manage interference between uplink and downlink in duplex operations. The release specified UE behavior for SRS measurements for CLI, introduced CLI handling and RIM procedures in the RRC protocol (TS 38.331), and added CLI support on the XnAP interface (TS 38.423). Furthermore, it included detailed CLI configuration and corrections to the SRS-RSRP reception procedure and other related protocols.

  • Introduction of UE behaviour for SRS measurements for CLI TS 38.214CR0043
  • Introduction of CLI handling and RIM in TS38.331 TS 38.331CR1494
  • BL CR to 38.423: CLI support on XnAP TS 38.423CR0089
  • Support for CLI TS 38.473CR0287
  • Correction on SRS-RSRP reception procedure for CLI TS 38.214CR0094
  • CLI Corrections TS 38.300CR0217

+ 5 more changes

Rel-19 5 changes

In Release 19, the enhancements for the CLI function focused on clarifications and corrections to existing procedures. Key updates included providing clarification for UE-to-UE CLI mitigation specifically in Subband Full Duplex (SBFD) operation and making corrections to the signaling for CLI Indication over the Xn and F1 interfaces. Furthermore, the release introduced clarifications and corrections regarding the maximum number of simultaneous L1 measurement resources and resource sets for both CLI-RSSI and SRS-RSRP.

  • Clarification on the number of simultaneous L1 CLI-RSSI and simultaneous L1 SRS-RSRP measurement resources TS 38.214CR0745
  • Correction on the maximum number of SRS-RSRP measurement resource sets and CLI-RSSI measurement resource sets TS 38.214CR0746
  • Clarification to UE-to-UE CLI mitigation in SBFD operation TS 38.300CR1080
  • Correction to XnAP on CLI Indication TS 38.423CR1595
  • Correction to F1AP on CLI Indication TS 38.473CR1636

Explore further

Broader topics and technologies where CLI plays a role.

Defining Specifications

3GPP specifications that define or reference CLI, with the latest known release. Sourced from the 3GPP document catalog — see methodology.

SpecificationTitleRelease
TR 21.905 vj00 3GPP Technical Terms and Definitions Rel-19
TS 23.057 vj00 Mobile Execution Environment (MExE) Specification Rel-19
TS 23.218 vj00 IMS Call Model Specification Rel-19
TS 28.552 vk10 5G Performance Management Measurements Rel-20
TS 31.102 vj40 USIM Application Specification Rel-19
TS 32.101 vj00 Management principles and high-level requirements Rel-19
TS 33.831 vc00 Study on Spoofed Call Detection & Prevention Rel-12
TS 37.340 vj00 Multi-Connectivity Operation Overview Rel-19
TS 38.214 vj10 NR Physical Layer Procedures for Data Rel-19
TS 38.215 vj10 NR Physical Layer Measurements Rel-19
TS 38.300 vj00 NG-RAN Overall Description Rel-19
TS 38.331 vj00 NR Radio Resource Control (RRC) Protocol Specification Rel-19
TS 38.401 vj10 NG-RAN Architecture Specification Rel-19
TS 38.420 vj10 Introduction to Xn interface specifications Rel-19
TS 38.423 vj10 Xn Application Protocol (XnAP) specification Rel-19
TS 38.470 vj10 F1 Interface Introduction Rel-19
TS 38.473 vj10 5G F1 Application Protocol (F1AP) Rel-19
TR 38.828 vg10 CLI and RIM for NR Rel-16
TR 38.858 vi20 Technical Report on Evolution of NR Duplex Operation Rel-18
Patrick Zandl

About the author: Patrick Zandl (b. 1974)

Telecommunications specialist, technology journalist (founder of the Mobil server), and developer who has been running since 2025 — the largest Czech-language resource on AI-assisted programming. Formerly Chief Wizard Architect at Prusa3D and head of development for Turris at CZ.NIC; currently a consultant and instructor on AI implementation in companies.