/*
 * Copyright 2000, International Business Machines Corporation and others.
 * All Rights Reserved.
 * 
 * This software has been released under the terms of the IBM Public
 * License.  For details, see the LICENSE file in the top-level source
 * directory or online at http://www.openafs.org/dl/license10.html
 */

#define	BOP_TIMEOUT(bnode)	((*(bnode)->ops->timeout)((bnode)))
#define	BOP_GETSTAT(bnode, a)	((*(bnode)->ops->getstat)((bnode),(a)))
#define	BOP_SETSTAT(bnode, a)	((*(bnode)->ops->setstat)((bnode),(a)))
#define	BOP_DELETE(bnode)	((*(bnode)->ops->delete)((bnode)))
#define	BOP_PROCEXIT(bnode, a)	((*(bnode)->ops->procexit)((bnode),(a)))
#define	BOP_GETSTRING(bnode, a, b)	((*(bnode)->ops->getstring)((bnode),(a), (b)))
#define	BOP_GETPARM(bnode, n, b, l)	((*(bnode)->ops->getparm)((bnode),(n),(b),(l)))
#define	BOP_RESTARTP(bnode)	((*(bnode)->ops->restartp)((bnode)))
#define BOP_HASCORE(bnode)	((*(bnode)->ops->hascore)((bnode)))

struct bnode_ops {
    struct bnode *(*create)(/* variable args */);
    int (*timeout) (/* bnode */);
    int (*getstat) (/* bnode, status */);
    int (*setstat) (/* bnode, status */);
    int (*delete) (/* bnode */);
    int (*procexit) (/* bnode, proc */);
    int (*getstring) (/* bnode, buffer, bufLen */);
    int (*getparm) (/* bnode, parmIndex, buffer, bufLen */);
    int	(*restartp) (/*	bnode */);
    int (*hascore) (/* bnode */);
};

struct bnode_type {
    struct bnode_type *next;
    char *name;
    struct bnode_ops *ops;
};

struct bnode_token {
    struct bnode_token *next;
    char *key;
};

struct bnode {
    struct bnode *next;		    /* next pointer in top-level's list */
    char *name;			    /* instance name */
    afs_int32 nextTimeout;		    /* next time this guy should be woken */
    afs_int32 period;		    /* period between calls */
    afs_int32 rsTime;		    /* time we started counting restarts */
    afs_int32 rsCount;		    /* count of restarts since rsTime */
    struct bnode_type *type;	    /* type object */
    struct bnode_ops *ops;	    /* functions implementing bnode class */
    afs_int32 procStartTime;		    /* last time a process was started */
    afs_int32 procStarts;		    /* number of process starts */
    afs_int32 lastAnyExit;		    /* last time a process exited, for any reason */
    afs_int32 lastErrorExit;		    /* last time a process exited unexpectedly */
    afs_int32 errorCode;		    /* last exit return code */
    afs_int32 errorSignal;		    /* last proc terminating signal */
    char *lastErrorName;	    /* name of proc that failed last */
    char *notifier;		    /* notifier program to be executed on exits */
    short refCount;		    /* reference count */
    short flags;		    /* random flags */
    char goal;			    /* 1=running or 0=not running */
    char fileGoal;		    /* same, but to be stored in file */
};

struct bnode_proc {
    struct bnode_proc *next;	    /* next guy in top-level's list */
    struct bnode *bnode;	    /* bnode creating this process */
    char *comLine;		    /* command line used to start this process */
    char *coreName;		    /* optional core file component name */
    afs_int32 pid;			    /* pid if created */
    afs_int32 lastExit;		    /* last termination code */
    afs_int32 lastSignal;		    /* last signal that killed this guy */
    afs_int32 flags;			    /* flags giving process state */
};
    
struct ezbnode {
    struct bnode b;
    afs_int32 zapTime;		/* time we sent a sigterm */
    char *command;
    struct bnode_proc *proc;
    afs_int32 lastStart;		/* time last started process */
    char waitingForShutdown;	/* have we started any shutdown procedure? */
    char running;   /* is process running? */
    char killSent;  /* have we tried sigkill signal? */
};

/* this struct is used to construct a list of dirpaths, along with 
 * their recommended permissions 
 */
struct bozo_bosEntryStats {
    const char *path;			/* pathname to check */
    int dir;				/* 1=>dir or 0=>file */
    int rootOwner;			/* 1=>root must own */
    int reqPerm;			/* required permissions */
    int proPerm;			/* prohibited permissions */
};
/* bnode flags */
#define	BNODE_NEEDTIMEOUT	    1	    /* timeouts are active */
#define	BNODE_ACTIVE		    2	    /* in generic lists */
#define	BNODE_WAIT		    4	    /* someone waiting for status change */
#define	BNODE_DELETE		    8	    /* delete this bnode asap */
#define	BNODE_ERRORSTOP		    0x10    /* stopped due to errors */

/* flags for bnode_proc */
#define	BPROC_STARTED		    1	    /* ever started */
#define	BPROC_EXITED		    2	    /* exited */

#define	NONOTIFIER		    "__NONOTIFIER__"

/* status values for bnodes, and goals */
#define	BSTAT_SHUTDOWN		    0	    /* shutdown normally */
#define	BSTAT_NORMAL		    1	    /* running normally */
#define	BSTAT_SHUTTINGDOWN	    2	    /* normal --> shutdown */
#define	BSTAT_STARTINGUP	    3	    /* shutdown --> normal */

/* exit values indicating that NT SCM integrator should restart bosserver */
#ifdef AFS_NT40_ENV
#define BOSEXIT_RESTART        0xA0
#define BOSEXIT_DORESTART(code)  (((code) & ~(0xF)) == BOSEXIT_RESTART)
#define BOSEXIT_NOAUTH_FLAG    0x01
#define BOSEXIT_LOGGING_FLAG   0x02
#endif

/* max time to wait for fileserver shutdown */
#define	FSSDTIME	(30 * 60) /* seconds */


/* calls back up to the generic bnode layer */
extern int bnode_SetTimeout(/* bnode, timeout */);
extern int bnode_Init(/* bnode, bnodeops */);
extern int bnode_Activate(/* bnode */);
extern int bnode_NewProc(/* bnode, execstring, corename, procaddr */);
extern int bnode_Init(/* no parms */);
extern afs_int32 bnode_Create();
extern struct bnode *bnode_FindInstance();
