DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5 and SCO OpenServer 5

Intro(D4dlpi)


Intro -- introduction to Data Link Provider Interface Quality of Service measurements

Synopsis

#include <sys/types.h>
#include <sys/dlpi.h>

Description

This manual page defines structures that are used for Quality of Service measurements in DLPI. QOS cannot be used in MDI drivers for the Ethernet, token ring, FDDI, or ISDN media types.

dl_qos_cl_range1_t

typedef struct {
	ulong               dl_qos_type;
	dl_transdelay_t     dl_trans_delay;
	dl_priority_t       dl_priority;
	dl_protect_t        dl_protection;
	long                dl_residual_error;
} dl_qos_cl_range1_t;
Structure type DL_QOS_CL_RANGE1 enables a DLS user and DLS provider to pass between them a range of QOS parameter values in the connectionless-mode service.

The members of the structure are:


dl_qos_type
The value of this member is DL_QOS_CL_RANGE1.

dl_trans_delay
Specifies the desired and acceptable transit delay on a data link connection.

dl_priority
Specifies the minimum and maximum priority values.

dl_protection
Specifies the minimum and maximum protection values.

dl_residual_error
Specifies the residual error.

This structure type is referenced by the dl_qos_range_length and dl_qos_range_offset members of the DL_INFO_ACK, and specifies the range of connectionless-mode QOS parameter values supported by the DLS provider on the stream. The DLS user may select specific values from this range using the DL_UDQOS_REQ primitive.

dl_qos_cl_sel1_t

typedef struct {
	ulong               dl_qos_type;
	long                dl_trans_delay;
	long                dl_priority;
	long                dl_protection;
	long                dl_residual_error;
} dl_qos_cl_sel1_t;
Structure type DL_QOS_CL_SEL1 conveys selected QOS parameter values for connectionless-mode service between the DLS user and DLS provider.

The members of the structure are:


dl_qos_type
The value of this member is DL_QOS_CL_SEL1.

dl_trans_delay
Specifies the transit delay on a data link connection.

dl_priority
Specifies the priority value.

dl_protection
Specifies the protection value.

dl_residual_error
Specifies the residual error.

This structure type is referenced by the dl_qos_length and dl_qos_offset members of the DL_INFO_ACK, and specifies the current or default QOS parameter values associated with a stream. Default values are returned until the DLS user issues a DL_UDQOS_REQ to change the values, after which the currently selected values will be returned. The structure type is also used in the DL_UDQOS_REQ primitive to enable a DLS user to select particular QOS parameter values from the supported range.

dl_qos_co_range1_t

typedef struct {
	ulong               dl_qos_type;
	dl_through_t        dl_rcv_throughput;
	dl_transdelay_t     dl_rcv_trans_delay;
	dl_through_t        dl_xmt_throughput;
	dl_transdelay_t     dl_xmt_trans_delay;
	dl_priority_tT      dl_priority;
	dl_protect_t        dl_protection;
	long                dl_residual_error;
	dl_resilience_t     dl_resilience;
} dl_qos_co_range1_t;
Structure type DL_QOS_RANGE1 enables a DLS user and DLS provider to pass between them a range of QOS parameter values in the connection-mode service.

The members of the structure are:


dl_qos_type
The value of this member is DL_QOS_RANGE1.

dl_rcv_throughput
Specifies the desired and acceptable throughput for receiving on a data link connection.

dl_rcv_trans_delay
Specifies the desired and acceptable transit delay for receiving on a data link connection.

dl_xmt_throughput
Specifies the throughput for transmitting on a data link connection.

dl_xmt_trans_delay
Specifies the transit delay for transmitting on a data link connection.

dl_priority
Specifies the minimum and maximum priority values.

dl_protection
Specifies the minimum and maximum protection values.

dl_residual_error
Specifies the residual error.

dl_resilience
Specifies the resilience.

This structure type is referenced by the dl_qos_range_length and dl_qos_range_offset members of the DL_INFO_ACK, and specifies the supported ranges of service quality supported by the DLS provider. In other words, it specifies the available range of QOS parameter values that may be specified on a DL_CONNECT_REQ.

For the DL_CONNECT_REQ and DL_CONNECT_IND primitives, this structure specifies the negotiable range of connection-mode QOS parameter values.

dl_qos_co_sel1_t

typedef struct {
	ulong              dl_qos_type;
	long               dl_rcv_throughput;
	long               dl_rcv_trans_delay;
	long               dl_xmt_throughput;
	long               dl_xmt_trans_delay;
	long               dl_priority;
	long               dl_protection;
	long               dl_residual_error;
	dl_resilience_t    dl_resilience;
} dl_qos_co_sel1_t;
Structure type DL_QOS_CO_SEL1 conveys selected QOS parameter values for connection-mode service between the DLS user and DLS provider.

The members of the structure are:


dl_qos_type
The value of this member is DL_QOS_CO_SEL1.

dl_rcv_throughput
Specifies the throughput for receiving on a data link connection.

dl_rcv_trans_delay
Specifies the transit delay for receiving on a data link connection.

dl_xmt_throughput
Specifies the throughput for transmitting on a data link connection.

dl_xmt_trans_delay
Specifies the transit delay for transmitting on a data link connection.

dl_priority
Specifies the priority value.

dl_protection
Specifies the protection value.

dl_residual_error
Specifies the residual error.

dl_resilience
Specifies the resilience.

The throughput and transit delay parameters are specified for each direction of transmission on a data link connection.

This structure type is referenced by the dl_qos_length and dl_qos_offset members of the DL_INFO_ACK, and specifies the current or default QOS parameter values associated with a stream. Default values are returned before connection establishment, and currently negotiated values are returned when a connection is active on the stream.

The structure type is used with DL_CONNECT_RES to enable the responding DLS user to select particular QOS parameter values from the available range. The DL_CONNECT_CON primitive returns the selected values to the calling DLS user in this structure.

References

Intro(D7dlpi)

Notices

Hardware constraints

None.

Applicability

Not applicable.

Backward compatibility

UnixWare-specific DLPI QOS measurements. QOS cannot be used in MDI drivers for the Ethernet, token ring, FDDI, or ISDN media types.

Forward compatibility

Not applicable.
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005