channels.h

Go to the documentation of this file.

/*
**++
**  IDENT X-5
**
**  FACILITY:  DRIVER
**
**  Copyright (C) 1998 by
**  Digital Equipment Corporation, Maynard, Massachusetts.
**  All rights reserved.
**
**  This software is furnished under a license and may be used and copied
**  only  in  accordance  of  the  terms  of  such  license  and with the
**  inclusion of the above copyright notice. This software or  any  other
**  copies thereof may not be provided or otherwise made available to any
**  other person.  No title to and  ownership of the  software is  hereby
**  transferred.
**
**  The information in this software is  subject to change without notice
**  and  should  not  be  construed  as a commitment by Digital Equipment
**  Corporation.
**
**  Digital assumes no responsibility for the use  or  reliability of its
**  software on equipment which is not supplied by Digital.
**
**  MODULE DESCRIPTION:
**
**      This module contains definitions and macros used by pbdriver.c
**      and channels.c, the shared memory interconnect driver.
**      {@tbs@}
**
**  AUTHORS:
**
**              Phil Norwich
**              Juan F. Astorga
**              Gregory H. Jordan
**
**  CREATION DATE:  March 5, 1998
**
**  DESIGN ISSUES:
**
**      None
**
**  SUBSYSTEM:
**   
**      SMCI - Shared Memory Cluster Interconnect driver
**   
**  MODIFICATION HISTORY:
**
**      X-5     JFA         Juan F. Astorga             24-Jul-1998
**              Change macro REMQTI to use pal remque non-resident 
**              version. This simplifies a lot the problem of
**              mapping added channel section pages.
**
**      X-4     JFA         Juan F. Astorga             4-May-1998
**              Delete head argument from channel allocation routines.
**              Not needed since a head pointer is in the handle.
**
**      X-3     JFA         Juan F. Astorga             5-Mar-1998
**              Change argument of pb$send_channel_buffer to reflect
**              change in channel module.
**
**      X-2     GHJ         Gregory H. Jordan           12-Mar-1998
**              Add updates to support shutdown.
**
**      X-1     JFA         Juan F. Astorga             5-Mar-1998
**              Initial entry.
**      
**--
*/

/*        
**  prototypes
**  {@tbs@}
*/        

int pb$return_to_free(SMWE *e, SMH *smh);
int pb$get_from_free (SMWE **e, SMH *smh);
int pb$allocate_channel_buffer (SMH *smh, void **buffer);
int pb$deallocate_channel_buffer (SMH *smh, void *buffer);
int pb$send_channel_buffer (SMH *smh, void *buff,int len,int prio);
int pb$create_channel_block (SMH *smh, PB_UCB *ucb);
int pb$start_shutdown( UCB *ucb );
void pb$validate_harter_list(SMH *smh);

#define RPAGE mmg$gl_bwp_mask
#define R64BT 63
#define RQUAD 7
#define ROUND(s,R) ((s + R) & ~R)

#define BYTE2PAGE(s) (s >> mmg$gl_bwp_width)

#define min(x,y) (x<y?x:y)
#define max(x,y) (x>y?x:y)

/*        
**  INSQUE MACRO
**  This macro attempts to insqueti an entry by calling PAL INSQUETILR
**  routine. On failure, it re-try until the giveup counter expires.
**  We use the resident versions as the entries are already mapped and
**  carved.
*/        
#define NQUE    32000                           // giveup counter for queues
#define INSQTI(s,head,ent)                                      \
        {                                                       \
        register int loop=NQUE;                                 \
                                                                \
        while (loop--)                                          \
            {                                                   \
            s = __PAL_INSQTILR((void *)head,ent);               \
            if (s != -1)                                        \
                break;                                          \
            }                                                   \
         }                                                      \

/*        
**  REMQUE MACRO
**  This macro attempts to remqueti an entry by calling PAL REMQUETIL
**  routine. On failure, it re-try until the giveup counter expires.
**  We use here the non-resident version as the entries may not be
**  mapped in the local instance.
*/        
#define REMQHI(s,head,ent)                                      \
        {                                                       \
        register int loop=NQUE;                                 \
                                                                \
        while (loop--)                                          \
            {                                                   \
            s = __PAL_REMQHIL((void *)head,(void **)ent);       \
            if (s != -1)                                        \
                break;                                          \
            }                                                   \
         }                                                      \


#define WQ_q(i)         smnd$r_wq_cls[i].smnd$q_work_queue
#define WQ_l(i)         smnd$r_wq_cls[i].smnd$l_work_queue

#define BASE    smh->smh$pl_channel                     // channel base
// channel offset to VA 
#define CHO2VA(offset) (void *) ((uint32)offset + (uint32)BASE)

// Virtual address to channel offset
#define VA2CHO(va)     (uint32) ((uint32)va     - (uint32)BASE)

int bug_check_pb();

Project space on SourceForge.net