/*
*
*    Copyright © Digital Equipment Corporation, 1993 All Rights Reserved.
*    Unpublished rights reserved under the copyright laws of the United States.
* 
*    The software contained on this media is proprietary to and embodies the
*    confidential technology of Digital Equipment Corporation.  Possession, use,
*    duplication or dissemination of the software and media is authorized only
*    pursuant to a valid written license from Digital Equipment Corporation.
* 
*    RESTRICTED RIGHTS LEGEND   Use, duplication, or disclosure by the U.S.
*    Government is subject to restrictions as set forth in Subparagraph
*    (c)(1)(ii) of DFARS 252.227-7013, or in FAR 52.227-19, as applicable.
* 
*++
* 
*   FACILITY:
*
*	VMS Executive (LIB_H)
* 
*   ABSTRACT:
* 
*	This module contains the C function prototypes for the VMS system
*	routines that begin with the COM$ and COM_STD$ prefixes and have
*	a standard call interface.
* 
*   NOTE:
*
*       The conventions used in these function prototypes are:
*
*    1. Case
*       This header file supports invoking the routines by either using all
*       lowercase or all uppercase names for the system routines.  Either
*       naming convention works even in the presence of the /NAME=AS_IS
*       compiler switch.
*
*    2. Integer size
*       The generic "int" type is used where it doesn't matter whether the
*       integer is 32 or 64 bits wide.  Thus "int" is the returned value of
*       most functions and is the type for most integers passed by value. 
*       However, an unambiguous integer type, e.g. int32, is used for any
*       integer that is passed by reference.  Also, int64 is used for any
*       integer that is expected to be 64 bits wide even if it is passed by
*       value.
*
*    3. Types
*       The function prototypes use the types defined in [SYSLIB]SYS$LIB_C.TLB. 
*       The definitions of all types used are included below.
*
*    4. Parameter names
*       Parameter names are used in the prototypes.  Although they are ignored
*       by the compiler they do provide useful documentation.  For example:
*
*         void  ioc_std$reqcom (int iost1, int iost2, UCB *ucb);
*
*       is used instead of the functionally equivalent:
*
*         void  ioc_std$reqcom (int, int, UCB *);
*
*    5. Parameters passed by reference
*       The parameter name includes the "_p" suffix if the parameter is passed
*       by reference unless the parameter type implies that it is always passed
*       by reference.  For example, there is no "_p" suffix in:
*
*         UCB *ucb;
*         int32 iosb[2];
*
*       since structures and arrays are always passed by reference.  However:
*
*         int32 *outlen_p;
*         UCB **new_ucb_p;
*
*       include the suffix to denote that outlen_p is a pointer to a 32 bit
*       integer, and to denote that new_ucb_p is a pointer to a pointer to a
*       UCB structure.
*   
*
*   AUTHOR:
* 
*       Leonard S. Szubowicz
* 
*   CREATION DATE:   7-Jun-1993
* 
*   MODIFICATION HISTORY:
* 
*	X-2     KLN2082		Karen L. Noel		04-Jun-1998
*		Surround this file with short pointer pragmas in case someone
*		wants to compile with long pointers from the command line.
*
* 	X-1	LSS0279		Leonard S. Szubowicz	 7-Jun-1993
* 		Initial version containing only those routines commonly used
*		by device drivers.
* 		
*--
*/

#ifndef __COM_ROUTINES_LOADED
#define __COM_ROUTINES_LOADED 1

#ifdef __INITIAL_POINTER_SIZE			 /* Defined whenever ptr size pragmas supported */
#pragma __required_pointer_size __save		 /* Save the previously-defined required ptr size */
#pragma __required_pointer_size __short		 /* And set ptr size default to 32-bit pointers */
#endif

/*
*  Define all types that are used in the following function prototypes.
*/

#include <ints.h>
#include <acbdef.h>
#include <ccbdef.h>
#include <irpdef.h>
#include <pcbdef.h>
#include <ucbdef.h>
#include <tastdef.h>

/*
   VMS system routine entry points are defined externally using uppercase names.
   The following macros allow the usage of the lowercase versions of these
   names even in the presence of the /NAME=AS_IS compiler switch.
*/

#define com_std$delattnast		COM_STD$DELATTNAST
#define com_std$delattnastp		COM_STD$DELATTNASTP
#define com_std$delctrlast		COM_STD$DELCTRLAST
#define com_std$delctrlastp		COM_STD$DELCTRLASTP
#define com_std$drvdealmem		COM_STD$DRVDEALMEM
#define com_std$flushattns		COM_STD$FLUSHATTNS
#define com_std$flushctrls		COM_STD$FLUSHCTRLS
#define com_std$post			COM_STD$POST
#define com_std$post_nocnt		COM_STD$POST_NOCNT
#define com_std$setattnast		COM_STD$SETATTNAST
#define com_std$setctrlast		COM_STD$SETCTRLAST


/*
    Function prototypes for system routines with the COM$ and COM_STD$ prefix.
*/

void  com_std$delattnast (ACB **acb_lh, UCB *ucb);
void  com_std$delattnastp (ACB **acb_lh, UCB *ucb, int ipid);
void  com_std$delctrlast (ACB **acb_lh, UCB *ucb, int matchchar, 
                          int32 *inclchar_p);
void  com_std$delctrlastp (ACB **acb_lh, UCB *ucb, int ipid, int matchchar, 
                           int32 *inclchar_p);
void  com_std$drvdealmem (void *ptr);
int   com_std$flushattns (PCB *pcb, UCB *ucb, int chan, ACB **acb_lh);
int   com_std$flushctrls (PCB *pcb, UCB *ucb, int chan, ACB **acb_lh,
                          int32 *mask_p);
void  com_std$post (IRP *irp, UCB *ucb);
void  com_std$post_nocnt (IRP *irp);
int   com_std$setattnast (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb, ACB **acb_lh);
int   com_std$setctrlast (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb, ACB **acb_lh,
                          int mask, TAST **tast_p);

#ifdef __INITIAL_POINTER_SIZE			 /* Defined whenever ptr size pragmas supported */
#pragma __required_pointer_size __restore		 /* Restore the previously-defined required ptr size */
#endif

#endif /* __COM_ROUTINES_LOADED */