ext.c File Reference

Extension request parameter interface. More...

#include <stdlib.h>
#include <stdarg.h>
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <hamlib/rig.h>
#include "token.h"

Functions
int	rig_ext_level_foreach (RIG *rig, int(*cfunc)(RIG *, const struct confparams *, char *), char *data)
	Executes cfunc on all the elements stored in the extlevels table The callback cfunc is called until it returns a value which is not strictly positive. A zero value means a normal end of iteration, and a negative value an abnormal end, which will be the return value of rig_ext_level_foreach.
int	rig_ext_parm_foreach (RIG *rig, int(*cfunc)(RIG *, const struct confparams *, char *), char *data)
	Executes cfunc on all the elements stored in the extparms table The callback cfunc is called until it returns a value which is not strictly positive. A zero value means a normal end of iteration, and a negative value an abnormal end, which will be the return value of rig_ext_parm_foreach.
struct confparams *	rig_ext_lookup (RIG *rig, const char *name)
	lookup ext token by its name, return pointer to confparams struct.
struct confparams *	rig_ext_lookup_tok (RIG *rig, token_t token)
	lookup ext token, return pointer to confparams struct.
token_t	rig_ext_token_lookup (RIG *rig, const char *name)
	Simple lookup returning token id assicated with name.

---

Detailed Description

Extension request parameter interface.

An open-ended set of extension parameters and levels are available for each rig, as provided in the rigcaps extparms and extlevels lists. These provide a way to work with rig-specific functions that don't fit into the basic "virtual rig" of Hamlib. See icom/ic746.c for an example.