HP UX IPQos Software manual Attaching Objects to Lists, Traversing Lists, Restrictions

Page 27

Using the HP-UX IPQoS API

Using Lists

Attaching Objects to Lists

When an object exists in a list it is said to be attached. When an object is created or copied it is (initially) considered unattached, until it is explicitly attached. To attach a policy or filter to a list, use the following functions: IpqosAttachPolicy(), IpqosAttachFilter().

Restrictions

There are two restrictions for attaching a filter object to a list:

The filter must have its name attribute set. The name must be unique.

If the filter’s destination physical address attribute is set, the length of the address must be compatible with the adapter object to which the associated policy object is attached.

There are two restrictions for attaching a policy object to a list:

The policy must have its name attribute set. The name must be unique.

If the policy’s reservation bandwidth attribute is set, it must be a value such that the aggregate reservation of all policy objects attached to an adapter object does not exceed the line speed of the adapter, less 80 Kbps. The 80 Kbps is set aside for classes of traffic that do not match any specified filters.

In the case of VLANs, the aggregate of the reservations of policies of VLANs that are based on the same physical adapter, and the policies of the base adapter itself, cannot exceed the speed of the physical adapter minus the 80Kbps reserved by the implicit default flow.

There are two functions that remove objects from lists. An object can be detached from the list by calling one of the delete functions. The object becomes detached when the session is committed. The object’s memory and resources can be freed by calling one of the destroy functions.

To delete an object its status must not be IPQOS_STATUS_INACTIVE, otherwise the function will return IPQOS_E_NOT_ATTACHED.

To destroy an object its status must be IPQOS_STATUS_INACTIVE, otherwise the function will return the error code IPQOS_E_ALREADY_ATTACHED.

Traversing Lists

As shown in Figure 2-1, the lists are singly-linked and can only be traversed one way.

To obtain the object at the head of an object list, use the following functions: IpqosGetAdapterListHead(), IpqosGetPolicyListHead(), IpqosGetFilterListHead().

Chapter 2

27

Image 27
Contents Manufacturing Part Number October HP-UX IPQoS A.01.00 Programmer’s GuideTrademark Notices WarrantyGovernment License Copyright NoticeContents Return Codes New and Changed Documentation in This Edition Intended AudienceWhat Is in This Document Publishing HistoryTypographic Conventions Related Documents HP-UX Release Name and Release IdentifierBold HP Product Documentation Related RFCsManpages RFCs Description Relevant RFCsHP Welcomes Your Comments Overview Introduction to HP-UX IPQoS Background Information IntroductionArchitectural Overview HP-UX IPQoS ArchitectureIntroducing the HP-UX IPQoS API Introduction Structural Overview How to Use the HP-UX IPQoS API HP-UX IPQoS API OverviewProgrammatic Requirements HP-UX IPQoS API Overview Manpages Return Codes Sample Program Restoring Configurations to the Kernel after RebootUsing the HP-UX IPQoS API Using Sessions Starting a SessionSession Types Object Status Terminating a SessionUsing Sessions Using Objects Creating, Copying and Destroying ObjectsObject Attributes Lists Using ListsAttaching Objects to Lists Traversing ListsRestrictions Do something with the policy list here Code Example Traversing An Adapter ListDeleting Policies and Filters Detaching From a List Object Type Attributes Filter ObjectsFilter Overlap Attributes Associated with Filter ObjectsFilter Objects Attributes Associated with Policy Objects Policy ObjectsAttributes Associated with Adapter Objects Adapter ObjectsStatistics Counters Kept for StatisticsObject Type Counters Troubleshooting General Tips Reporting Problems to HP Reporting Problems to HP Chapter Function Calls Table A-1 Session-Related Functions Description Session-Related Function CallsTable A-2 Adapter-Related Functions Description Adapter-Related Function CallsTable A-3 Policy-Related Functions Description Policy-Related Function CallsSet Vlan priority Table A-4 Filter-Related Functions Description Filter-Related Function CallsGet priority of filter Table A-5 Filter Overlap-Related Functions Description Filter Overlap-Related Function CallsFilter2 Filter1 overlaps thatTable A-6 Statistics-Related Functions Description Statistics-Related Function CallsReturn Codes Table B-1 Return Codes with Mnemonics and Message Strings Return Codes, Mnemonics and Message StringsObject name is not set Return Codes, Mnemonics and Message Strings Appendix B Code Example Exit Else Return Main Configuration Code ExampleIpqosvaluemoderelative 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.