iocInit.h File Reference

#include "shareLib.h"

Include dependency graph for iocInit.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Enumerations
enum	iocStateEnum {   iocVoid, iocBuilding, iocBuilt, iocRunning,   iocPaused }

Functions
epicsShareFunc enum iocStateEnum	getIocState (void)
epicsShareFunc int	iocInit (void)
epicsShareFunc int	iocBuild (void)
epicsShareFunc int	iocBuildIsolated (void)
epicsShareFunc int	iocRun (void)
epicsShareFunc int	iocPause (void)
epicsShareFunc int	iocShutdown (void)

Enumeration Type Documentation

enum iocStateEnum

Enumerator
iocVoid
iocBuilding
iocBuilt
iocRunning
iocPaused

Definition at line 16 of file iocInit.h.

                  {
    iocVoid, iocBuilding, iocBuilt, iocRunning, iocPaused
};

Function Documentation

epicsShareFunc enum iocStateEnum getIocState

(

void

)

Definition at line 100 of file iocInit.c.

{
    return iocState;
}

epicsShareFunc int iocBuild

(

void

)

Definition at line 196 of file iocInit.c.

{
    int status;

    status = iocBuild_1();
    if (status) return status;

    dbCaLinkInit();

    status = iocBuild_2();
    if (status) return status;

    dbInitServers();

    status = iocBuild_3();

    if (dbThreadRealtimeLock)
        epicsThreadRealtimeLock();

    if (!status) iocBuildMode = buildServers;
    return status;
}

epicsShareFunc int iocBuildIsolated

(

void

)

Definition at line 219 of file iocInit.c.

{
    int status;

    status = iocBuild_1();
    if (status) return status;

    dbCaLinkInitIsolated();

    status = iocBuild_2();
    if (status) return status;

    status = iocBuild_3();
    if (!status) iocBuildMode = buildIsolated;
    return status;
}

epicsShareFunc int iocInit

(

void

)

Definition at line 108 of file iocInit.c.

{
    return iocBuild() || iocRun();
}

epicsShareFunc int iocPause

(

void

)

Definition at line 267 of file iocInit.c.

{
    if (iocState != iocRunning) {
        errlogPrintf("iocPause: IOC not running\n");
        return -1;
    }
    initHookAnnounce(initHookAtIocPause);

    if (iocBuildMode == buildServers) {
        dbPauseServers();
        initHookAnnounce(initHookAfterCaServerPaused);
    }

    dbCaPause();
    scanPause();
    initHookAnnounce(initHookAfterDatabasePaused);

    iocState = iocPaused;
    errlogPrintf("iocPause: IOC suspended\n");
    initHookAnnounce(initHookAfterIocPaused);
    return 0;
}

epicsShareFunc int iocRun

(

void

)

Definition at line 236 of file iocInit.c.

{
    if (iocState != iocPaused && iocState != iocBuilt) {
        errlogPrintf("iocRun: IOC not paused\n");
        return -1;
    }
    initHookAnnounce(initHookAtIocRun);

   /* Enable scan tasks and some driver support functions.  */
    scanRun();
    dbCaRun();
    initHookAnnounce(initHookAfterDatabaseRunning);
    if (iocState == iocBuilt)
        initHookAnnounce(initHookAfterInterruptAccept);

    if (iocBuildMode == buildServers) {
        dbRunServers();
        initHookAnnounce(initHookAfterCaServerRunning);
    }

    if (iocState == iocBuilt)
        initHookAnnounce(initHookAtEnd);

    errlogPrintf("iocRun: %s\n", iocState == iocBuilt ?
        "All initialization complete" :
        "IOC restarted");
    iocState = iocRunning;
    initHookAnnounce(initHookAfterIocRunning);
    return 0;
}

epicsShareFunc int iocShutdown

(

void

)

Definition at line 709 of file iocInit.c.

{
    if (iocState == iocVoid) return 0;

    initHookAnnounce(initHookAtShutdown);

    iterateRecords(doCloseLinks, NULL);
    initHookAnnounce(initHookAfterCloseLinks);

    if (iocBuildMode == buildIsolated) {
        /* stop and "join" threads */
        scanStop();
        initHookAnnounce(initHookAfterStopScan);
        callbackStop();
        initHookAnnounce(initHookAfterStopCallback);
    } else {
        dbStopServers();
    }

    dbCaShutdown(); /* must be before dbFreeRecord and dbChannelExit */
    initHookAnnounce(initHookAfterStopLinks);

    if (iocBuildMode == buildIsolated) {
        /* free resources */
        initHookAnnounce(initHookBeforeFree);
        scanCleanup();
        callbackCleanup();

        iterateRecords(doFreeRecord, NULL);
        dbLockCleanupRecords(pdbbase);

        asShutdown();
        dbChannelExit();
        dbProcessNotifyExit();
        iocshFree();
    }

    iocState = iocVoid;
    iocBuildMode = buildServers;

    initHookAnnounce(initHookAfterShutdown);
    return 0;
}