HP UX IPQos Software manual Introducing the HP-UX IPQoS API

Page 14

Overview

Introduction

Introducing the HP-UX IPQoS API

The HP-UX IPQoS API allows programmers to write applications that can perform the following tasks:

manipulate the HP-UX IPQoS configuration

traverse the HP-UX IPQoS configuration

obtain HP-UX IPQoS statistics

The benefits that the HP-UX IPQoS API offers include the following:

Allows applications to be written that dynamically modify the current configuration. For example, you can write applications to add to existing configurations. (The HP-UX IPQoS command-line administration utility, ipqosadmin, does not offer additive loads. Using ipqosadmin, the only way to change a configuration is to perform a -loadoperation, which replaces the configuration.)

Allows applications to be written that provide alternative output formats than to what the command-line administration utility, ipqosadmin, provides. For example. you can write an application that produces configuration information in html output format. Refer to

/opt/ipqos/examples/htmldump for a programmatic example.

If you already have existing IPQoS applications, you can leverage them by modifying them to work with the HP-UX IPQoS API.

As will be discussed in more detail in subsequent sections of this guide, note that:

The tasks accomplished by HP-UX IPQoS API operations are performed in sessions. Every HP-UX IPQoS API session begins with the API collecting information about the current configuration since this is required for all three types of tasks the HP-UX IPQoS API performs. Sessions are initiated and include session types that determine what operations are permitted. Sessions are completed either by committing (saving) or by aborting (not saving) the changes made during the session.

HP-UX IPQoS configurations consist of objects made up of three classes: filter, policy and adapter. The objects exist in a list structure. Objects are attached to lists, and then the lists can be traversed to read and modify the objects in a configuration.

HP-UX IPQoS also maintains statistics, in the HP-UX IPQoS kernel module, that are available to programmers. Statistics are maintained on both filters and policies.

IMPORTANT The manpages associated with the HP-UX IPQoS API complement this guide and are necessary references to successfully use the HP-UX IPQoS API.

14

Chapter 1

Image 14
Contents HP-UX IPQoS A.01.00 Programmer’s Guide Manufacturing Part Number OctoberCopyright Notice WarrantyGovernment License Trademark NoticesContents Return Codes Intended Audience New and Changed Documentation in This EditionTypographic Conventions What Is in This DocumentPublishing History Bold Related DocumentsHP-UX Release Name and Release Identifier Manpages HP Product DocumentationRelated RFCs Relevant RFCs RFCs DescriptionHP Welcomes Your Comments Overview Introduction Introduction to HP-UX IPQoS Background InformationHP-UX IPQoS Architecture Architectural OverviewIntroducing the HP-UX IPQoS API Introduction Programmatic Requirements Structural Overview How to Use the HP-UX IPQoS APIHP-UX IPQoS API Overview HP-UX IPQoS API Overview Manpages Return Codes Restoring Configurations to the Kernel after Reboot Sample ProgramUsing the HP-UX IPQoS API Session Types Using SessionsStarting a Session Terminating a Session Object StatusUsing Sessions Object Attributes Using ObjectsCreating, Copying and Destroying Objects Using Lists ListsRestrictions Attaching Objects to ListsTraversing Lists Code Example Traversing An Adapter List Do something with the policy list hereDeleting Policies and Filters Detaching From a List Attributes Associated with Filter Objects Filter ObjectsFilter Overlap Object Type AttributesFilter Objects Policy Objects Attributes Associated with Policy ObjectsAdapter Objects Attributes Associated with Adapter ObjectsObject Type Counters StatisticsCounters Kept for Statistics Troubleshooting General Tips Reporting Problems to HP Reporting Problems to HP Chapter Function Calls Session-Related Function Calls Table A-1 Session-Related Functions DescriptionAdapter-Related Function Calls Table A-2 Adapter-Related Functions DescriptionPolicy-Related Function Calls Table A-3 Policy-Related Functions DescriptionSet Vlan priority Filter-Related Function Calls Table A-4 Filter-Related Functions DescriptionGet priority of filter Filter Overlap-Related Function Calls Table A-5 Filter Overlap-Related Functions DescriptionFilter1 overlaps that Filter2Statistics-Related Function Calls Table A-6 Statistics-Related Functions DescriptionReturn Codes Return Codes, Mnemonics and Message Strings Table B-1 Return Codes with Mnemonics and Message StringsObject name is not set Return Codes, Mnemonics and Message Strings Appendix B Code Example Configuration Code Example Exit Else Return MainIpqosvaluemoderelative Configuration Code Example Appendix C Index Index Index
Related manuals
Manual 7 pages 919 b Manual 135 pages 55.88 Kb

UX IPQos Software specifications

HP-UX IPQoS is a sophisticated software solution designed to enhance the network performance of HP's Unix-based operating system, HP-UX. This software focuses on Quality of Service (QoS) mechanisms that ensure efficient bandwidth utilization and prioritize network traffic to meet the demands of various applications.

One of the main features of HP-UX IPQoS is its ability to define traffic priorities. Administrators can classify traffic into different priority levels, allowing critical applications to receive the bandwidth they need while less important traffic can be deprioritized. This feature is essential in environments where bandwidth is a limited resource, ensuring that business-critical processes maintain their performance even during peak usage times.

The software employs advanced traffic shaping techniques that allow the management of data flow in the network. By controlling the rate of traffic and smoothing out bursts, IPQoS helps prevent network congestion, leading to a consistently reliable user experience. In addition, it can manage both inbound and outbound traffic, ensuring optimal performance in various network scenarios.

Another significant characteristic of HP-UX IPQoS is its integration with other network management tools. It operates seamlessly with HP’s Network Management Suite, providing a holistic view of network performance. This integration facilitates easier troubleshooting and monitoring, as administrators can correlate data from different sources for comprehensive insights.

Moreover, HP-UX IPQoS supports various protocols, including DiffServ and MPLS. By adhering to these standards, it positions itself as a versatile tool that can operate in diverse network environments, providing flexibility and ease of deployment. Additionally, the software supports policy-based management, enabling organizations to implement specific rules tailored to their network requirements.

Security is also a critical focus of HP-UX IPQoS. The software provides mechanisms to enforce traffic policies while safeguarding against potential threats. By ensuring that only authorized traffic flows through the network, it minimizes the risk of attacks and data breaches, contributing to a more secure IT environment.

The user interface of HP-UX IPQoS is designed for ease of use, allowing network administrators to configure settings, monitor performance, and generate reports without extensive training. This user-friendliness accelerates the deployment process and enhances the overall management of network resources.

In summary, HP-UX IPQoS is a robust and versatile network management solution that brings substantial benefits to organizations looking to optimize their network performance. With its traffic prioritization features, integration capabilities, support for industry standards, and focus on security, it stands out as an essential tool for maintaining effective and secure network operations in a dynamically changing IT landscape.