/* module       vms_drivers.h   "X-3"
*
*    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 ACP$ and ACP_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-3     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-2	JCH703	John C. Hallyburton, Jr.	25-Apr-1995
*		Add ACP_STD$FASTIO_BLOCK
*
* 	X-1	LSS0279		Leonard S. Szubowicz	 7-Jun-1993
* 		Initial version containing only those routines commonly used
*		by device drivers.
* 		
*--
*/
#ifndef __ACP_ROUTINES_LOADED
#define __ACP_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 <ccbdef.h>
#include <irpdef.h>
#include <pcbdef.h>
#include <ucbdef.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 acp_std$access			ACP_STD$ACCESS
#define acp_std$accessnet		ACP_STD$ACCESSNET
#define acp_std$deaccess		ACP_STD$DEACCESS
#define acp_std$fastio_block		ACP_STD$FASTIO_BLOCK
#define acp_std$modify			ACP_STD$MODIFY
#define acp_std$mount			ACP_STD$MOUNT
#define acp_std$readblk			ACP_STD$READBLK
#define acp_std$writeblk		ACP_STD$WRITEBLK


/*
    Function prototypes for system routines with the ACP$ and ACP_STD$ prefix.
*/

int   acp_std$access (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb);
int   acp_std$accessnet (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb);
int   acp_std$deaccess (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb);
int   acp_std$fastio_block (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb);
int   acp_std$modify (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb);
int   acp_std$mount (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb);
int   acp_std$readblk (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb);
int   acp_std$writeblk (IRP *irp, PCB *pcb, UCB *ucb, CCB *ccb);

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

#endif /* __ACP_ROUTINES_LOADED */