typed_dset Struct Reference

#include "devSup.h"

Public Attributes
long	number
long(*	report )(int lvl)
long(*	init )(int after)
long(*	init_record )(struct dbCommon *prec)
long(*	get_ioint_info )(int detach, struct dbCommon *prec, IOSCANPVT *pscan)

Detailed Description

Type safe version of 'struct dset'

Recommended usage:

In Makefile:

USR_CPPFLAGS += -DUSE_TYPED_RSET -DUSE_TYPED_DSET

In C source file:

#include <devSup.h>
#include <dbScan.h>      // For IOCSCANPVT
...
#include <epicsExport.h> // defines epicsExportSharedSymbols
...
static long init_record(dbCommon *prec);
static long get_iointr_info(int detach, dbCommon *prec, IOCSCANPVT* pscan);
static long longin_read(longinRecord *prec);

longindset devLiDevName = {
    {
     5, // 4 from dset + 1 from longinRecord
        NULL,
        NULL,
        &init_record,
        &get_iointr_info
    },
    &longin_read
};
epicsExportAddress(dset, devLiDevName);

Definition at line 64 of file devSup.h.

Member Data Documentation

long(* typed_dset::get_ioint_info) (int detach, struct dbCommon *prec, IOSCANPVT *pscan)

Called when SCAN="I/O Intr" on startup, or after SCAN is changed.

Caller must assign the third arguement (IOCSCANPVT*). eg.

struct mpvt {
   IOSCANPVT drvlist;
};
...
   // init_record() routine calls
   scanIoInit(&pvt->drvlist);
...
static long get_ioint_info(int detach, struct dbCommon *prec, IOCSCANPVT* pscan) {
   if(prec->dpvt)
       *pscan = &((mypvt*)prec->dpvt)->drvlist;

When a particular record instance can/will only used a single scan list, the detach argument can be ignored.

If this is not the case, then the following should be noted.

• get_ioint_info() is called with detach = 0 to fetch the scan list to which this record will be added.
• get_ioint_info() is called later with detach = 1 to fetch the scan list from which this record should be removed.
• Calls will be balanced, so a call with detach = 0 will be followed by one with detach = 1.

Note

get_ioint_info() will be called during IOC shutdown if the dsxt::del_record() extended callback is defined. (from 3.15.0.1)

Definition at line 107 of file devSup.h.

long(* typed_dset::init) (int after)

Called twice during iocInit(). First with after = 0 before init_record() or array field allocation. Again with after = 1 after init_record() has finished.

Definition at line 74 of file devSup.h.

long(* typed_dset::init_record) (struct dbCommon *prec)

Called once per record instance

Definition at line 76 of file devSup.h.

long typed_dset::number

Number of function pointers which follow. The value depends on the recordtype, but must be >=4

Definition at line 67 of file devSup.h.

long(* typed_dset::report) (int lvl)

Called from dbior()

Definition at line 69 of file devSup.h.

---

The documentation for this struct was generated from the following file:

• modules/database/src/ioc/dbStatic/devSup.h