NetBSD/sys/netisdn/i4b_ioctl.h
2005-02-26 22:31:44 +00:00

629 lines
24 KiB
C

/*
* Copyright (c) 1997, 2000 Hellmuth Michaelis. All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* 1. Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* 2. Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*
*---------------------------------------------------------------------------
*
* i4b_ioctl.h - messages kernel <--> userland
* -------------------------------------------
*
* $Id: i4b_ioctl.h,v 1.10 2005/02/26 22:39:49 perry Exp $
*
* $FreeBSD$
*
* last edit-date: [Tue Oct 10 15:30:55 2000]
*
*---------------------------------------------------------------------------*/
#ifndef _I4B_IOCTL_H_
#define _I4B_IOCTL_H_
#if defined(__FreeBSD__) && __FreeBSD__ >= 3
#ifndef _MACHINE_TYPES_H_
#include <machine/types.h>
#endif /* _MACHINE_TYPES_H_ */
#endif /* __FreeBSD__ */
/*---------------------------------------------------------------------------*
* version and release number for isdn4bsd package
*---------------------------------------------------------------------------*/
#define VERSION 0 /* version number */
#define REL 96 /* release number */
#define STEP 00 /* release step */
/*---------------------------------------------------------------------------*
* date/time format in i4b log messages
* ------------------------------------
* Being year 2000 clean is not easy with the current state of the
* ANSI C library standard and it's implementation for some locales.
* You might like to use the "%c" format of "strftime" sometimes,
* but this breaks Y2K in some locales. Also the old standard logfile
* format "%d.%m.%y %H:%M:%S" is non compliant.
* NetBSD's current toolset warns about this problems, and we compile
* with -Werror, so this problems need to be resolved.
*---------------------------------------------------------------------------*/
#define I4B_TIME_FORMAT "%d.%m.%Y %H:%M:%S"
/*---------------------------------------------------------------------------*
* ISDN D-channel protocols
*---------------------------------------------------------------------------*/
#define PROTOCOL_DSS1 0 /* default, Euro-ISDN/DSS1 */
#define PROTOCOL_D64S 1 /* 64k leased line, no protocol */
/*---------------------------------------------------------------------------*
* max length of some strings
*---------------------------------------------------------------------------*/
#define TELNO_MAX 41 /* max length of a telephone number (+ '\0') */
#define SUBADDR_MAX 22 /* max length of subaddres IE */
#define DISPLAY_MAX 91 /* max length of display information (+ '\0') */
#define DATETIME_MAX 21 /* max length of datetime information (+ '\0')*/
/*---------------------------------------------------------------------------*
* in case the src or dst telephone number is empty
*---------------------------------------------------------------------------*/
#define TELNO_EMPTY "NotAvailable"
/*---------------------------------------------------------------------------*
* B channel parameters
*---------------------------------------------------------------------------*/
#define BCH_MAX_DATALEN 2048 /* max length of a B channel frame */
/*---------------------------------------------------------------------------*
* B channel protocol
*---------------------------------------------------------------------------*/
#define BPROT_NONE 0 /* no protocol at all, raw data */
#define BPROT_RHDLC 1 /* raw HDLC: flag, data, crc, flag */
/*---------------------------------------------------------------------------*
* causes data type
*---------------------------------------------------------------------------*/
typedef unsigned int cause_t; /* 32 bit unsigned int */
/*---------------------------------------------------------------------------*
* call descriptor id (cdid) definitions
*---------------------------------------------------------------------------*/
#define CDID_UNUSED 0 /* cdid is invalid and unused */
#define CDID_MAX 99999 /* highest valid cdid, wraparound to 1 */
/*---------------------------------------------------------------------------*
* The shorthold algorithm to use
*---------------------------------------------------------------------------*/
#define SHA_FIXU 0 /* timeout algorithm for fix unit charging */
#define SHA_VARU 1 /* timeout algorithm for variable unit charging */
/*---------------------------------------------------------------------------*
* The shorthold data struct
*---------------------------------------------------------------------------*/
typedef struct {
int shorthold_algorithm; /* shorthold algorithm to use */
int unitlen_time; /* length of a charging unit */
int idle_time; /* time without activity on b ch*/
int earlyhup_time; /* safety area at end of unit */
} msg_shorthold_t;
/****************************************************************************
outgoing call:
--------------
userland kernel
-------- ------
CDID_REQ ----------------->
<------------------ cdid
CONNECT_REQ -------------->
<------------------ PROCEEDING_IND (if connect req ok)
<------------------ CONNECT_ACTIVE_IND (if connection ok)
or
<------------------ DISCONNECT_IND (if connection failed)
incoming call:
--------------
userland kernel
-------- ------
<------------------ CONNECT_IND
CONNECT_RESP ------------->
<------------------ CONNECT_ACTIVE_IND (if accepted)
active disconnect:
------------------
userland kernel
-------- ------
DISCONNECT_REQ ------------>
<------------------ DISCONNECT_IND
passive disconnect:
-------------------
userland kernel
-------- ------
<------------------ DISCONNECT_IND
****************************************************************************/
/*===========================================================================*
*===========================================================================*
* "read" messages from kernel -> userland
*===========================================================================*
*===========================================================================*/
/*---------------------------------------------------------------------------*
* message header, included in every message
*---------------------------------------------------------------------------*/
typedef struct {
char type; /* message identifier */
#define MSG_CONNECT_IND 'a'
#define MSG_CONNECT_ACTIVE_IND 'b'
#define MSG_DISCONNECT_IND 'c'
#define MSG_DIALOUT_IND 'd'
#define MSG_IDLE_TIMEOUT_IND 'e'
#define MSG_ACCT_IND 'f'
#define MSG_CHARGING_IND 'g'
#define MSG_PROCEEDING_IND 'h'
#define MSG_ALERT_IND 'i'
#define MSG_DRVRDISC_REQ 'j'
#define MSG_L12STAT_IND 'k'
#define MSG_TEIASG_IND 'l'
#define MSG_PDEACT_IND 'm'
#define MSG_NEGCOMP_IND 'n'
#define MSG_IFSTATE_CHANGED_IND 'o'
#define MSG_DIALOUTNUMBER_IND 'p'
#define MSG_PACKET_IND 'q'
#define MSG_CONTR_EV_IND 'r'
int cdid; /* call descriptor id */
} msg_hdr_t;
/*---------------------------------------------------------------------------*
* connect indication
* indicates incoming connection
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int controller; /* controller number */
int channel; /* channel number */
#define CHAN_B1 0 /* this _must_ be 0, HSCX B1 is also 0 */
#define CHAN_B2 1 /* this _must_ be 1, HSCX B2 is also 1 */
#define CHAN_ANY (-1) /* outgoing, not possible for incoming */
#define CHAN_NO (-2) /* call waiting (CW) for incoming */
int bprot; /* b channel protocot, see BPROT_XXX */
char dst_telno[TELNO_MAX]; /* destination telno */
char src_telno[TELNO_MAX]; /* source telno */
int scr_ind;/* screening indicator */
#define SCR_NONE 0 /* no screening indicator transmitted */
#define SCR_USR_NOSC 1 /* screening user provided, not screened*/
#define SCR_USR_PASS 2 /* screening user provided, verified & passed */
#define SCR_USR_FAIL 3 /* screening user provided, verified & failed */
#define SCR_NET 4 /* screening network provided */
int prs_ind;/* presentation indicator */
#define PRS_NONE 0 /* no presentation indicator transmitted*/
#define PRS_ALLOWED 1 /* presentation allowed */
#define PRS_RESTRICT 2 /* presentation restricted */
#define PRS_NNINTERW 3 /* number not available due to interworking */
#define PRS_RESERVED 4 /* reserved */
char display[DISPLAY_MAX]; /* content of display IE*/
u_int8_t src_subaddr[SUBADDR_MAX];
u_int8_t dest_subaddr[SUBADDR_MAX];
u_int8_t type_plan;
} msg_connect_ind_t;
/*---------------------------------------------------------------------------*
* connect active indication
* indicates active connection
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int controller; /* controller number actually used */
int channel; /* channel number actually used */
char datetime[DATETIME_MAX]; /* content of date/time IE */
} msg_connect_active_ind_t;
/*---------------------------------------------------------------------------*
* disconnect indication
* indicates a disconnect
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
cause_t cause; /* cause code */
} msg_disconnect_ind_t;
/*---------------------------------------------------------------------------*
* negotiation complete
* indicates an interface is completely up & running
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
} msg_negcomplete_ind_t;
/*---------------------------------------------------------------------------*
* interface changes internal state
* indicates an interface has somehow switched its FSM
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int state; /* new interface state */
} msg_ifstatechg_ind_t;
/*---------------------------------------------------------------------------*
* initiate a call to a remote site
* i.e. the IP driver got a packet and wants a connection
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int driver; /* driver type */
int driver_unit; /* driver unit number */
} msg_dialout_ind_t;
/*---------------------------------------------------------------------------*
* dial a number
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int driver; /* driver type */
int driver_unit; /* driver unit number */
int cmdlen; /* length of string */
char cmd[TELNO_MAX]; /* the number to dial */
} msg_dialoutnumber_ind_t;
/*---------------------------------------------------------------------------*
* idle timeout disconnect sent indication
* kernel has sent disconnect request because of b-ch idle
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
} msg_idle_timeout_ind_t;
/*---------------------------------------------------------------------------*
* accounting information from userland interface driver to daemon
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int accttype; /* accounting type */
#define ACCT_DURING 0
#define ACCT_FINAL 1
int ioutbytes; /* ISDN # of bytes sent */
int iinbytes; /* ISDN # of bytes received */
int outbps; /* bytes per sec out */
int inbps; /* bytes per sec in */
int outbytes; /* driver # of bytes sent */
int inbytes; /* driver # of bytes received */
} msg_accounting_ind_t;
/*---------------------------------------------------------------------------*
* charging information from isdn driver to daemon
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int units; /* number of units */
int units_type; /* type of units info */
#define CHARGE_INVALID 0 /* invalid, unknown */
#define CHARGE_AOCD 1 /* advice of charge during call */
#define CHARGE_AOCE 2 /* advice of charge at end of call */
#define CHARGE_CALC 3 /* locally calculated from rates information */
} msg_charging_ind_t;
/*---------------------------------------------------------------------------*
* call proceeding indication
* indicates outgoing SETUP has been acknowleged
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int controller; /* controller number actually used */
int channel; /* channel number actually used */
} msg_proceeding_ind_t;
/*---------------------------------------------------------------------------*
* alert indication
* indicates remote user side "rings"
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
} msg_alert_ind_t;
/*---------------------------------------------------------------------------*
* driver requests to disconnect line
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
} msg_drvrdisc_req_t;
/*---------------------------------------------------------------------------*
* connect packet logging
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int driver; /* driver type */
int driver_unit; /* driver unit number */
int direction; /* 0=in 1=out */
#define DIRECTION_IN 0 /* sending packet to remote */
#define DIRECTION_OUT 1 /* received packet from remote */
#define MAX_PACKET_LOG 40 /* space for IP and TCP header */
u_int8_t pktdata[MAX_PACKET_LOG];
} msg_packet_ind_t;
/*---------------------------------------------------------------------------*
* state of layer 1/2
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int controller; /* controller unit */
int layer; /* layer number (1/2) */
#define LAYER_ONE 1
#define LAYER_TWO 2
int state; /* state info */
#define LAYER_IDLE 0
#define LAYER_ACTIVE 1
} msg_l12stat_ind_t;
/*---------------------------------------------------------------------------*
* TEI assignment messages
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int controller; /* controller unit */
int tei; /* TEI or -1 if invalid */
} msg_teiasg_ind_t;
/*---------------------------------------------------------------------------*
* persistent deactivation state of stack
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int controller; /* controller unit */
int numactive; /* number of active connections */
} msg_pdeact_ind_t;
/*---------------------------------------------------------------------------*
* connect indication
* indicates incoming connection
*---------------------------------------------------------------------------*/
typedef struct {
msg_hdr_t header; /* common header */
int controller; /* controller number */
int event;
#define CTRL_EV_IND_DETACH 0
#define CTRL_EV_IND_ATTACH 1
} msg_ctrl_ev_ind_t;
/*===========================================================================*
*===========================================================================*
* "ioctl" messages from userland -> kernel
*===========================================================================*
*===========================================================================*/
/*---------------------------------------------------------------------------*
* request a unique cdid (to setup an outgoing call)
*---------------------------------------------------------------------------*/
typedef struct {
int cdid; /* call descriptor id */
} msg_cdid_req_t;
#define I4B_CDID_REQ _IOWR('4', 0, int)
/*---------------------------------------------------------------------------*
* connect request
* requests an outgoing connection
*---------------------------------------------------------------------------*/
typedef struct {
int cdid; /* call descriptor id */
int controller; /* controller to use */
int channel; /* channel to use */
int txdelay; /* tx delay after connect */
int bprot; /* b channel protocol */
int driver; /* driver to route b channel data to */
int driver_unit; /* unit number for above driver */
msg_shorthold_t shorthold_data; /* the shorthold data */
int unitlen_method; /* how to calculate the unitlength */
#define ULEN_METHOD_STATIC 0 /* use unitlen_time value (see above) */
#define ULEN_METHOD_DYNAMIC 1 /* use AOCD */
char dst_telno[TELNO_MAX]; /* destination telephone no */
char src_telno[TELNO_MAX]; /* source telephone number */
} msg_connect_req_t;
#define I4B_CONNECT_REQ _IOW('4', 1, msg_connect_req_t)
/*---------------------------------------------------------------------------*
* connect response
* this is the answer to an incoming connect indication
*---------------------------------------------------------------------------*/
typedef struct {
int cdid; /* call descriptor id */
int response; /* what to do with incoming call */
#define SETUP_RESP_DNTCRE 0 /* dont care, call is not for me */
#define SETUP_RESP_REJECT 1 /* reject call */
#define SETUP_RESP_ACCEPT 2 /* accept call */
cause_t cause; /* cause for case SETUP_RESP_REJECT */
/* the following are only used for SETUP_RESP_ACCEPT !! */
int txdelay; /* tx delay after connect */
int bprot; /* B chan protocol */
int driver; /* driver to route b channel data to */
int driver_unit; /* unit number for above driver */
int max_idle_time; /* max time without activity on b ch */
} msg_connect_resp_t;
#define I4B_CONNECT_RESP _IOW('4', 2, msg_connect_resp_t)
/*---------------------------------------------------------------------------*
* disconnect request
* active disconnect request
*---------------------------------------------------------------------------*/
typedef struct {
int cdid; /* call descriptor id */
cause_t cause; /* protocol independent cause */
} msg_discon_req_t;
#define I4B_DISCONNECT_REQ _IOW('4', 3, msg_discon_req_t)
/*---------------------------------------------------------------------------*
* controller info request
*---------------------------------------------------------------------------*/
typedef struct {
int controller; /* controller number */
int ncontroller; /* number of controllers in system */
int max_isdnif; /* highest available ISDN interface num */
int tei; /* tei controller probably has */
char devname[64]; /* autoconfig device name, i.e. "isic0" */
char cardname[80]; /* human readable brand / version */
int nbch; /* number of b channels provided */
} msg_ctrl_info_req_t;
#define I4B_CTRL_INFO_REQ _IOWR('4', 4, msg_ctrl_info_req_t)
/*---------------------------------------------------------------------------*
* dialout response
* status report to driver who requested a dialout
*---------------------------------------------------------------------------*/
typedef struct {
int driver; /* driver to route b channel data to */
int driver_unit; /* unit number for above driver */
int stat; /* state of dialout request */
#define DSTAT_NONE 0
#define DSTAT_TFAIL 1 /* transient failure */
#define DSTAT_PFAIL 2 /* permanent failure */
#define DSTAT_INONLY 3 /* no outgoing dials allowed */
cause_t cause; /* exact i4b cause */
} msg_dialout_resp_t;
#define I4B_DIALOUT_RESP _IOW('4', 5, msg_dialout_resp_t)
/*---------------------------------------------------------------------------*
* timeout value update
*---------------------------------------------------------------------------*/
typedef struct {
int cdid; /* call descriptor id */
msg_shorthold_t shorthold_data;
} msg_timeout_upd_t;
#define I4B_TIMEOUT_UPD _IOW('4', 6, msg_timeout_upd_t)
/*---------------------------------------------------------------------------*
* soft enable/disable
*---------------------------------------------------------------------------*/
typedef struct {
int driver; /* driver to route b channel data to */
int driver_unit; /* unit number for above driver */
int updown; /* what to do */
#define SOFT_ENA 0 /* enable interface */
#define SOFT_DIS 1 /* disable interface */
} msg_updown_ind_t;
#define I4B_UPDOWN_IND _IOW('4', 7, msg_updown_ind_t)
/*---------------------------------------------------------------------------*
* send alert request
*---------------------------------------------------------------------------*/
typedef struct {
int cdid; /* call descriptor id */
} msg_alert_req_t;
#define I4B_ALERT_REQ _IOW('4', 8, msg_alert_req_t)
/*---------------------------------------------------------------------------*
* request version and release info from kernel part
* (msg_vr_req_t is also used by tel & rbch drivers)
*---------------------------------------------------------------------------*/
typedef struct {
int version; /* version number */
int release; /* release number */
int step; /* release step number */
} msg_vr_req_t;
#define I4B_VR_REQ _IOR('4', 9, msg_vr_req_t)
/*---------------------------------------------------------------------------*
* set ISDN protocol used by a controller
*---------------------------------------------------------------------------*/
typedef struct {
int controller; /* controller number */
int protocol; /* ISDN D-channel protocol type */
} msg_prot_ind_t;
#define I4B_PROT_IND _IOW('4', 10, msg_prot_ind_t)
/*---------------------------------------------------------------------------*
* Query the identifier for a B channel driver
*---------------------------------------------------------------------------*/
#define L4DRIVER_NAME_SIZ 16
typedef struct {
char name[L4DRIVER_NAME_SIZ]; /* lookup this driver */
int driver_id; /* returned driver id */
} msg_l4driver_lookup_t;
#define I4B_L4DRIVER_LOOKUP _IOWR('4', 11, msg_l4driver_lookup_t)
/*---------------------------------------------------------------------------*
* Protocol download to active cards
*---------------------------------------------------------------------------*/
struct isdn_dr_prot {
size_t bytecount; /* length of code */
u_int8_t *microcode; /* pointer to microcode */
};
struct isdn_download_request {
int controller; /* controller number */
int numprotos; /* number of protocols in 'protocols' */
struct isdn_dr_prot *protocols;
};
#define I4B_CTRL_DOWNLOAD _IOW('4', 100, struct isdn_download_request)
/*---------------------------------------------------------------------------*
* Generic diagnostic interface for active cards
*---------------------------------------------------------------------------*/
struct isdn_diagnostic_request {
int controller; /* controller number */
u_int32_t cmd; /* diagnostic command to execute */
size_t in_param_len; /* length of additional input parameter */
#define I4B_ACTIVE_DIAGNOSTIC_MAXPARAMLEN 65536
void *in_param; /* optional input parameter */
size_t out_param_len; /* available output space */
void *out_param; /* output data goes here */
};
#define I4B_ACTIVE_DIAGNOSTIC _IOW('4', 102, struct isdn_diagnostic_request)
#endif /* _I4B_IOCTL_H_ */