CH_ATTACH_REQ

Section: Channel Interface (CHI) (7)
Updated: 2008-10-31
Index Return to Main Contents

NAME

CH_ATTACH_REQ, CH_attach_req, CH_attach_req_t - attach channel request

SYNOPSIS

This primitive is one M_PROTO message block structured as follows:

typedef struct CH_attach_req {
    ch_ulong ch_primitive;      /* always CH_ATTACH_REQ */
    ch_ulong ch_addr_length;    /* length of channel address */
    ch_ulong ch_addr_offset;    /* offset of channel address */
    ch_ulong ch_flags;          /* options flags */
} CH_attach_req_t;

DESCRIPTION

Requests that the channel specified by the provided address be attached to the requesting stream.

PARAMETERS

This primitive has the following parameters:

ch_primitive: specifies the primitive type. Always CH_ATTACH_REQ.
ch_addr_length: specifies the length of the circuit address.
ch_addr_offset: specifies the offset, from the beginning of the M_PROTO message block, of the circuit address.
ch_flags: specifies the attach options flags. No options flags are currently specified.

ORIGINATOR

Channel Service User.

STATES

This primitive is valid in state CHS_DETACHED. The resulting state is CHS_WACK_AREQ.

RULES

The following rules apply to the attaching of the specified channel address to the stream:

---: If the ch_addr_length field in the CH_ATTACH_REQ primitive is zero (0), then the channel service provider is to assign a channel address to the user.
---: If the channel service provider is unable to assign a channel address to the user, the channel service provider will return [CHNOADDR].
---: When the ch_addr_length field in the CH_ATTACH_REQ primitive is non-zero, the channel service provider is to attach the channel address as specified in the CH_ATTACH_REQ primitive.
---: If the channel service provider cannot attach the specified address, the channel service provider will return [CHADDRBUSY].

These primitives require the Channel Service Provider to generate one of the following acknowledgments on receipt of the primitive, and the Channel Service User must wait for the acknowledgment before issuing any other primitives:

Successful: Correct acknowledgment of the primitive is indicated with the CH_OK_ACK(7) primitive. In this case, the resulting state is CHS_ATTACHED.
Non-fatal errors: These errors will be indicates with the CH_ERROR_ACK(7) primitive. In this case, the resulting state is unchanged and remains the same as the state in which the primitive was issued.

ERRORS

The allowable errors are as follows:

[CHSYSERR]: UNIX system error. A system error occured and the UNIX errno(3) is specified in the ch_unix_error field of the CH_ERROR_ACK(7) primitive.
[CHBADADDR]: Bad address format or content. The address specified by ch_addr_length and ch_addr_offset is invalid or of an incorrect format.
[CHOUTSTATE]: Interface out of state. The primitive would place the interface out of state. The CH_ATTACH_REQ primitive is only valid in state CHS_DETACHED.
[CHBADFLAG]: Bad flag. The flags specified in ch_flags are invalid.
[CHBADPRIM]: Bad primitive. The primitive is not recognized or incorrectly formatted.
[CHNOTSUPP]: Primitive not supported. The requesting stream is a CH_STYLE1 stream that does not support the CH_ATTACH_REQ.
[CHBOADDR]: Address could not be assigned. No address was specified (ch_addr_length is zero) and a channel address could not be assigned.
[CHADDRBUSY]: Address is busy. An address was specified (ch_addr_length is non-zero), but the channel address is already attached to another stream.

VERSIONS

This manpage was written for CHI Version 1.

REFERENCES

[1]: CHI, Channel Interface (CHI) Specification, Revision 0.9.2, Draft 2, July 15, 2007, (Edmonton, Canada), B. Bidulock, OpenSS7 Corporation. <http://www.openss7.org/specs/chi.pdf>

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

OpenSS7 STREAMS Channels: Package strchan version 0.9.2.4 released 2008-10-31.

This document was created by man2html, using the manual pages.
Time: 02:54:32 GMT, May 23, 2013

Description: Manual Page

Keywords: ss7 ss7/ip ss7 over ip ss7 mtp ss7 sccp ss7 tcap sigtran mtp sccp tcap openss7 acb56 linux telephony pstn linux telephony linux nebs linux compactpci