capi4yaps/pager.h

222 lines
8.2 KiB
C

/* -*- mode: c; mode: fold -*- */
# ifndef __PAGER_H
# define __PAGER_H 1
# include <stdio.h>
/*{{{ definitions, macros */
# ifndef NDEBUG
# define V(lvl,msg) ((void) (((lvl) <= verbose) && verbout ? (*verbout) msg, fflush (stdout) : 0))
# define MCHK(xxx) ((void) ((xxx) && ((xxx) -> magic != MAGIC) ? fprintf (stderr, "Invalid magic: expect %ld got %ld in %s:%d\n", MAGIC, (xxx) -> magic, __FILE__, __LINE__) : 0))
# define MKMAGIC(ch1,ch2,ch3,ch4) \
((long) ((((unsigned char) (ch1)) << 24) | \
(((unsigned char) (ch2)) << 16) | \
(((unsigned char) (ch3)) << 8) | \
((unsigned char) (ch4))))
# else /* NDEBUG */
# define V(lvl,msg)
# define MCHK(xxx)
# endif /* NDEBUG */
# define NO_ERR 0
# define ERR_FAIL (-1)
# define ERR_FATAL (-2)
# define ERR_ABORT (-3)
# define ECONT(xxx) (((xxx) == NO_ERR) || ((xxx) == ERR_FAIL))
# define ESTOP(xxx) (((xxx) == ERR_FATAL) || ((xxx) == ERR_ABORT))
# define LGS_SENT '+'
# define LGF_SENT '-'
# define LGS_INF '*'
# define LGF_INF '/'
# define LG_INF 'i'
# define LG_COST 'c'
# define LG_SSESSION 's'
# define LG_ESESSION 'e'
# define LG_PROTO 'p'
/*}}}*/
/*{{{ typedefs */
typedef enum {
False = 0,
True = ! False
} Bool;
typedef enum {
Unknown,
Ascii,
Script,
Tap,
Ucp
} Protocol;
typedef unsigned char char_t;
typedef struct {
char_t *str; /* the string itself */
int len; /* the current length */
int size; /* the allocated size */
} string_t;
typedef struct {
int day, mon, year;
int hour, min, sec;
} date_t;
/*}}}*/
/*{{{ prototypes */
/*{{{ utility */
extern char *skip (char *str);
extern char *skipch (char *str, char ch);
extern char *getline (FILE *fp, Bool cont);
extern int verbose_out (char *, ...);
/*}}}*/
/*{{{ string handling */
extern string_t *snewc (char *str);
extern string_t *snew (char_t *str, int len);
extern Bool sexpand (string_t *s, int nsize);
extern Bool scopy (string_t *dst, string_t *src);
extern Bool scat (string_t *dst, string_t *src);
extern Bool scopyc (string_t *dst, char *src);
extern Bool scatc (string_t *dst, char *src);
extern string_t *scut (string_t *str, int start, int len);
extern void sdel (string_t *str, int start, int len);
extern Bool sput (string_t *str, string_t *ins, int pos, int len);
extern Bool sputc (string_t *str, char *ins, int pos, int len);
extern char *sextract (string_t *s);
extern char *schar (string_t *s);
extern void *sfree (string_t *s);
extern void srelease (string_t *s);
extern Bool siscntrl (string_t *s, int pos);
extern Bool sisspace (string_t *s, int pos);
extern Bool sisdigit (string_t *s, int pos);
extern int stoi (string_t *s);
/*}}}*/
/*{{{ date handling */
extern date_t *dat_free (date_t *d);
extern date_t *dat_parse (char *str);
extern int dat_diff (date_t *d1, date_t *d2);
extern void dat_clear (date_t *d);
extern void dat_localtime (date_t *d);
/*}}}*/
/*{{{ tty handling */
extern void *tty_open (char *dev, char *lckprefix, char *lckmethod);
extern void *tty_close (void *sp);
extern Bool tty_reopen (void *s, int msec);
extern void tty_hangup (void *sp, int msec);
extern int tty_fd (void *sp);
extern int tty_setup (void *sp, Bool raw, Bool modem, int speed, int bpb, int sb, char parity);
extern void tty_set_line_callback (void *sp, void (*func) (void *, string_t *, char_t, void *), char *sep, void *data);
extern void tty_suspend_callback (void *sp, Bool susp);
extern int tty_send (void *sp, char *str, int len);
extern int tty_send_string (void *sp, char *str);
extern int tty_expect (void *sp, int tout, ...);
extern int tty_expect_list (void *sp, int tout, char **strs, int *lens);
extern int tty_expect_string (void *sp, int tout, char *str);
extern int tty_send_expect (void *sp, int deftout, char *str, char **opts);
extern void tty_mdrain (void *sp, int msecs);
extern void tty_drain (void *sp, int secs);
/*}}}*/
/*{{{ configuration */
extern void *cfg_new (char *sep);
extern void *cfg_read (char *fname, void *bp, char *sep);
extern void *cfg_end (void *bp);
extern void cfg_modify (void *bp, char *bname, char *var, char *val);
extern char *cfg_get (void *bp, char *bname, char *var, char *dflt);
extern int cfg_iget (void *bp, char *bname, char *var, int dflt);
extern Bool cfg_bget (void *bp, char *bname, char *var, Bool dflt);
extern char *cfg_block_get (void *bp, char *bname, char *var, char *dflt);
extern int cfg_block_iget (void *bp, char *bname, char *var, int dflt);
extern Bool cfg_block_bget (void *bp, char *bname, char *var, Bool dflt);
/*}}}*/
/*{{{ converting */
extern void *cv_new (void);
extern void *cv_free (void *cv);
extern void *cv_reverse (void *src);
extern void cv_define (void *cv, char_t src, char_t dst);
extern void cv_sdefine (void *cv, char *src, char *dst);
extern void cv_undefine (void *cv, char_t ch);
extern void cv_sundefine (void *cv, char *ch);
extern void cv_invalid (void *cv, char_t ch);
extern void cv_sinvalid (void *cv, char *ch);
extern int cv_read_table (void *cv, char *fname);
extern int cv_write_table (void *cv, char *fname);
extern void cv_merge (void *cv, void *in, Bool second);
extern int cv_conv (void *cv, char_t ch);
/*}}}*/
/*{{{ ASCII protocol */
extern int asc_login (void *ap, string_t *callid);
extern int asc_logout (void *ap);
extern int asc_transmit (void *ap, char *pid, char *msg);
extern int asc_next (void *ap);
extern int asc_sync (void *ap);
extern void asc_config (void *ap, void (*logger) (char, char *, ...),
int deftout, char *alogin, char *alogout, char *apid, char *amsg, char *anext, char *async,
date_t *delay, date_t *expire, Bool rds);
extern void asc_set_convtable (void *ap, void *ctab);
extern void asc_add_convtable (void *ap, void *ctab);
extern void *asc_new (void *sp);
extern void *asc_free (void *ap);
extern int asc_preinit (void);
extern void asc_postdeinit (void);
/*}}}*/
/*{{{ scripting protocol */
extern int scr_execute (void *sp, char *label, char *parm);
extern int scr_load_string (void *sp, char *scr);
extern int scr_load_file (void *sp, char *fname);
extern void scr_config (void *sp, void (*logger) (char, char *, ...), date_t *delay, date_t *expire, Bool rds);
extern void scr_set_convtable (void *sp, void *ctab);
extern void scr_add_convtable (void *sp, void *ctab);
extern void *scr_new (void *sp, char *typ, char *libdir);
extern void *scr_free (void *sp);
extern int scr_preinit (char *libdir);
extern void scr_postdeinit (void);
/*}}}*/
/*{{{ Telocator Alphanumeric Protocol */
extern int tap_login (void *tp, char *stype, char ttype, char *passwd, string_t *callid);
extern int tap_logout (void *tp);
extern int tap_transmit (void *tp, string_t **field, Bool last);
extern void tap_config (void *tp, void (*logger) (char, char *, ...), Bool pre16);
extern void tap_timeouts (void *tp, int t1, int t2, int t3, int t4, int t5);
extern void tap_retries (void *tp, int n1, int n2, int n3, int licnt, int locnt);
extern void tap_set_convtable (void *tp, void *ctab);
extern void tap_add_convtable (void *tp, void *ctab);
extern void *tap_new (void *sp);
extern void *tap_free (void *tp);
extern int tap_preinit (void);
extern void tap_postdeinit (void);
/*}}}*/
/*{{{ Universal Computer Protocol */
extern int ucp_login (void *up, string_t *callid);
extern int ucp_logout (void *up);
extern int ucp_transmit (void *up, string_t *pagerid, string_t *msg, Bool last);
extern void ucp_config (void *up, void (*logger) (char, char *, ...),
Bool xtend, int stout, int retry, int rtout,
date_t *delay, date_t *expire, Bool rds);
extern void ucp_set_convtable (void *up, void *ctab);
extern void ucp_add_convtable (void *up, void *ctab);
extern void *ucp_new (void *sp);
extern void *ucp_free (void *up);
extern int ucp_preinit (void);
extern void ucp_postdeinit (void);
/*}}}*/
/*}}}*/
/*{{{ global variables */
extern int verbose;
extern int (*verbout) (char *, ...);
/*}}}*/
/*{{{ CAPI */
extern int device_is_capi(char *dev);
extern int hyla_is_capi(void *sp);
extern void *hyla_capi_init(char *dev);
extern void hyla_capi_disconnect(void *sp);
extern void *hyla_capi_close(void *sp);
extern int hyla_capi_connect(void *sp, char *dial, char *number);
extern int hyla_capi_send(void *sp, char *str, int len);
extern size_t hyla_capi_read(void *sp, void *buf, size_t count);
extern void hyla_capi_iflush(void *sp);
extern void hyla_capi_oflush(void *sp);
extern void hyla_capi_drain(void *sp);
extern void hyla_capi_sendbreak(void *sp, int duration);
/*}}}*/
# endif /* __PAGER_H */