Home | History | Annotate | Download | only in linux
      1 /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
      2 /* atm.h - general ATM declarations */
      3 
      4 /* Written 1995-2000 by Werner Almesberger, EPFL LRC/ICA */
      5 
      6 
      7 /*
      8  * WARNING: User-space programs should not #include <linux/atm.h> directly.
      9  *          Instead, #include <atm.h>
     10  */
     11 
     12 #ifndef _LINUX_ATM_H
     13 #define _LINUX_ATM_H
     14 
     15 /*
     16  * BEGIN_xx and END_xx markers are used for automatic generation of
     17  * documentation. Do not change them.
     18  */
     19 
     20 
     21 #include <linux/atmapi.h>
     22 #include <linux/atmsap.h>
     23 #include <linux/atmioc.h>
     24 #include <linux/types.h>
     25 
     26 
     27 /* general ATM constants */
     28 #define ATM_CELL_SIZE		    53	/* ATM cell size incl. header */
     29 #define ATM_CELL_PAYLOAD	    48	/* ATM payload size */
     30 #define ATM_AAL0_SDU		    52	/* AAL0 SDU size */
     31 #define ATM_MAX_AAL34_PDU	 65535	/* maximum AAL3/4 PDU payload */
     32 #define ATM_AAL5_TRAILER	     8	/* AAL5 trailer size */
     33 #define ATM_MAX_AAL5_PDU	 65535	/* maximum AAL5 PDU payload */
     34 #define ATM_MAX_CDV		  9999	/* maximum (default) CDV */
     35 #define ATM_NOT_RSV_VCI		    32	/* first non-reserved VCI value */
     36 
     37 #define ATM_MAX_VPI		   255	/* maximum VPI at the UNI */
     38 #define ATM_MAX_VPI_NNI		  4096	/* maximum VPI at the NNI */
     39 #define ATM_MAX_VCI		 65535	/* maximum VCI */
     40 
     41 
     42 /* "protcol" values for the socket system call */
     43 #define ATM_NO_AAL	0		/* AAL not specified */
     44 #define ATM_AAL0	13		/* "raw" ATM cells */
     45 #define ATM_AAL1	1		/* AAL1 (CBR) */
     46 #define ATM_AAL2	2		/* AAL2 (VBR) */
     47 #define ATM_AAL34	3		/* AAL3/4 (data) */
     48 #define ATM_AAL5	5		/* AAL5 (data) */
     49 
     50 /*
     51  * socket option name coding functions
     52  *
     53  * Note that __SO_ENCODE and __SO_LEVEL are somewhat a hack since the
     54  * << 22 only reserves 9 bits for the level.  On some architectures
     55  * SOL_SOCKET is 0xFFFF, so that's a bit of a problem
     56  */
     57 
     58 #define __SO_ENCODE(l,n,t)	((((l) & 0x1FF) << 22) | ((n) << 16) | \
     59 				sizeof(t))
     60 #define __SO_LEVEL_MATCH(c,m)	(((c) >> 22) == ((m) & 0x1FF))
     61 #define __SO_NUMBER(c)		(((c) >> 16) & 0x3f)
     62 #define __SO_SIZE(c)		((c) & 0x3fff)
     63 
     64 /*
     65  * ATM layer
     66  */
     67 
     68 #define SO_SETCLP	__SO_ENCODE(SOL_ATM,0,int)
     69 			    /* set CLP bit value - TODO */
     70 #define SO_CIRANGE	__SO_ENCODE(SOL_ATM,1,struct atm_cirange)
     71 			    /* connection identifier range; socket must be
     72 			       bound or connected */
     73 #define SO_ATMQOS	__SO_ENCODE(SOL_ATM,2,struct atm_qos)
     74 			    /* Quality of Service setting */
     75 #define SO_ATMSAP	__SO_ENCODE(SOL_ATM,3,struct atm_sap)
     76 			    /* Service Access Point */
     77 #define SO_ATMPVC	__SO_ENCODE(SOL_ATM,4,struct sockaddr_atmpvc)
     78 			    /* "PVC" address (also for SVCs); get only */
     79 #define SO_MULTIPOINT	__SO_ENCODE(SOL_ATM, 5, int)
     80 			    /* make this vc a p2mp */
     81 
     82 
     83 /*
     84  * Note @@@: since the socket layers don't really distinguish the control and
     85  * the data plane but generally seems to be data plane-centric, any layer is
     86  * about equally wrong for the SAP. If you have a better idea about this,
     87  * please speak up ...
     88  */
     89 
     90 
     91 /* ATM cell header (for AAL0) */
     92 
     93 /* BEGIN_CH */
     94 #define ATM_HDR_GFC_MASK	0xf0000000
     95 #define ATM_HDR_GFC_SHIFT	28
     96 #define ATM_HDR_VPI_MASK	0x0ff00000
     97 #define ATM_HDR_VPI_SHIFT	20
     98 #define ATM_HDR_VCI_MASK	0x000ffff0
     99 #define ATM_HDR_VCI_SHIFT	4
    100 #define ATM_HDR_PTI_MASK	0x0000000e
    101 #define ATM_HDR_PTI_SHIFT	1
    102 #define ATM_HDR_CLP		0x00000001
    103 /* END_CH */
    104 
    105 
    106 /* PTI codings */
    107 
    108 /* BEGIN_PTI */
    109 #define ATM_PTI_US0	0  /* user data cell, congestion not exp, SDU-type 0 */
    110 #define ATM_PTI_US1	1  /* user data cell, congestion not exp, SDU-type 1 */
    111 #define ATM_PTI_UCES0	2  /* user data cell, cong. experienced, SDU-type 0 */
    112 #define ATM_PTI_UCES1	3  /* user data cell, cong. experienced, SDU-type 1 */
    113 #define ATM_PTI_SEGF5	4  /* segment OAM F5 flow related cell */
    114 #define ATM_PTI_E2EF5	5  /* end-to-end OAM F5 flow related cell */
    115 #define ATM_PTI_RSV_RM	6  /* reserved for traffic control/resource mgmt */
    116 #define ATM_PTI_RSV	7  /* reserved */
    117 /* END_PTI */
    118 
    119 
    120 /*
    121  * The following items should stay in linux/atm.h, which should be linked to
    122  * netatm/atm.h
    123  */
    124 
    125 /* Traffic description */
    126 
    127 #define ATM_NONE	0		/* no traffic */
    128 #define ATM_UBR		1
    129 #define ATM_CBR		2
    130 #define ATM_VBR		3
    131 #define ATM_ABR		4
    132 #define ATM_ANYCLASS	5		/* compatible with everything */
    133 
    134 #define ATM_MAX_PCR	-1		/* maximum available PCR */
    135 
    136 struct atm_trafprm {
    137 	unsigned char	traffic_class;	/* traffic class (ATM_UBR, ...) */
    138 	int		max_pcr;	/* maximum PCR in cells per second */
    139 	int		pcr;		/* desired PCR in cells per second */
    140 	int		min_pcr;	/* minimum PCR in cells per second */
    141 	int		max_cdv;	/* maximum CDV in microseconds */
    142 	int		max_sdu;	/* maximum SDU in bytes */
    143         /* extra params for ABR */
    144         unsigned int 	icr;         	/* Initial Cell Rate (24-bit) */
    145         unsigned int	tbe;		/* Transient Buffer Exposure (24-bit) */
    146         unsigned int 	frtt : 24;	/* Fixed Round Trip Time (24-bit) */
    147         unsigned int 	rif  : 4;       /* Rate Increment Factor (4-bit) */
    148         unsigned int 	rdf  : 4;       /* Rate Decrease Factor (4-bit) */
    149         unsigned int nrm_pres  :1;      /* nrm present bit */
    150         unsigned int trm_pres  :1;     	/* rm present bit */
    151         unsigned int adtf_pres :1;     	/* adtf present bit */
    152         unsigned int cdf_pres  :1;    	/* cdf present bit*/
    153         unsigned int nrm       :3;     	/* Max # of Cells for each forward RM cell (3-bit) */
    154         unsigned int trm       :3;    	/* Time between forward RM cells (3-bit) */
    155 	unsigned int adtf      :10;     /* ACR Decrease Time Factor (10-bit) */
    156 	unsigned int cdf       :3;      /* Cutoff Decrease Factor (3-bit) */
    157         unsigned int spare     :9;      /* spare bits */
    158 };
    159 
    160 struct atm_qos {
    161 	struct atm_trafprm txtp;	/* parameters in TX direction */
    162 	struct atm_trafprm rxtp __ATM_API_ALIGN;
    163 					/* parameters in RX direction */
    164 	unsigned char aal __ATM_API_ALIGN;
    165 };
    166 
    167 /* PVC addressing */
    168 
    169 #define ATM_ITF_ANY	-1		/* "magic" PVC address values */
    170 #define ATM_VPI_ANY	-1
    171 #define ATM_VCI_ANY	-1
    172 #define ATM_VPI_UNSPEC	-2
    173 #define ATM_VCI_UNSPEC	-2
    174 
    175 
    176 struct sockaddr_atmpvc {
    177 	unsigned short 	sap_family;	/* address family, AF_ATMPVC  */
    178 	struct {			/* PVC address */
    179 		short	itf;		/* ATM interface */
    180 		short	vpi;		/* VPI (only 8 bits at UNI) */
    181 		int	vci;		/* VCI (only 16 bits at UNI) */
    182 	} sap_addr __ATM_API_ALIGN;	/* PVC address */
    183 };
    184 
    185 /* SVC addressing */
    186 
    187 #define	ATM_ESA_LEN	20		/* ATM End System Address length */
    188 #define ATM_E164_LEN	12		/* maximum E.164 number length */
    189 
    190 #define ATM_AFI_DCC	0x39		/* DCC ATM Format */
    191 #define ATM_AFI_ICD	0x47		/* ICD ATM Format */
    192 #define ATM_AFI_E164	0x45		/* E.164 ATM Format */
    193 #define ATM_AFI_LOCAL	0x49		/* Local ATM Format */
    194 
    195 #define ATM_AFI_DCC_GROUP	0xBD	/* DCC ATM Group Format */
    196 #define ATM_AFI_ICD_GROUP	0xC5	/* ICD ATM Group Format */
    197 #define ATM_AFI_E164_GROUP	0xC3	/* E.164 ATM Group Format */
    198 #define ATM_AFI_LOCAL_GROUP	0xC7	/* Local ATM Group Format */
    199 
    200 #define ATM_LIJ_NONE	0		/* no leaf-initiated join */
    201 #define ATM_LIJ		1		/* request joining */
    202 #define ATM_LIJ_RPJ	2		/* set to root-prompted join */
    203 #define ATM_LIJ_NJ	3		/* set to network join */
    204 
    205 
    206 struct sockaddr_atmsvc {
    207     unsigned short 	sas_family;	/* address family, AF_ATMSVC */
    208     struct {				/* SVC address */
    209         unsigned char	prv[ATM_ESA_LEN];/* private ATM address */
    210         char		pub[ATM_E164_LEN+1]; /* public address (E.164) */
    211     					/* unused addresses must be bzero'ed */
    212 	char		lij_type;	/* role in LIJ call; one of ATM_LIJ* */
    213 	__u32	lij_id;		/* LIJ call identifier */
    214     } sas_addr __ATM_API_ALIGN;		/* SVC address */
    215 };
    216 
    217 
    218 static __inline__ int atmsvc_addr_in_use(struct sockaddr_atmsvc addr)
    219 {
    220 	return *addr.sas_addr.prv || *addr.sas_addr.pub;
    221 }
    222 
    223 
    224 static __inline__ int atmpvc_addr_in_use(struct sockaddr_atmpvc addr)
    225 {
    226 	return addr.sap_addr.itf || addr.sap_addr.vpi || addr.sap_addr.vci;
    227 }
    228 
    229 
    230 /*
    231  * Some stuff for linux/sockios.h
    232  */
    233 
    234 struct atmif_sioc {
    235 	int number;
    236 	int length;
    237 	void *arg;
    238 };
    239 
    240 
    241 typedef unsigned short atm_backend_t;
    242 #endif /* _LINUX_ATM_H */
    243