[thirdparty/glibc.git] / mach / mach.h

/* Standard header for all Mach programs.
   Copyright (C) 1993, 1994, 1996, 1997 Free Software Foundation, Inc.
   This file is part of the GNU C Library.

   The GNU C Library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   The GNU C Library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with the GNU C Library; if not, write to the Free
   Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
   02111-1307 USA.  */

#ifndef	_MACH_H

#define	_MACH_H	1

/* Get the basic types used by Mach.  */
#include <mach/mach_types.h>

/* This declares the basic variables and macros everything needs.  */
#include <mach_init.h>

/* This declares all the real system call functions.  */
#include <mach/mach_traps.h>

/* These are MiG-generated headers for the kernel interfaces commonly used.  */
#include <mach/mach_interface.h> /* From <mach/mach.defs>.  */
#include <mach/mach_port.h>
#include <mach/mach_host.h>

/* For the kernel RPCs which have system call shortcut versions,
   the MiG-generated header in fact declares `CALL_rpc' rather than `CALL'.
   This file declares the simple `CALL' functions.  */
#include <mach-shortcuts.h>


/* Receive RPC request messages on RCV_NAME and pass them to DEMUX, which
   decodes them and produces reply messages.  MAX_SIZE is the maximum size
   (in bytes) of the request and reply buffers.  */
extern mach_msg_return_t
__mach_msg_server (boolean_t (*__demux) (mach_msg_header_t *__request,
					 mach_msg_header_t *__reply),
		   mach_msg_size_t __max_size,
		   mach_port_t __rcv_name),
mach_msg_server (boolean_t (*__demux) (mach_msg_header_t *__request,
				       mach_msg_header_t *__reply),
		 mach_msg_size_t __max_size,
		 mach_port_t __rcv_name);

/* Just like `mach_msg_server', but the OPTION and TIMEOUT parameters are
   passed on to `mach_msg'.  */
extern mach_msg_return_t
__mach_msg_server_timeout (boolean_t (*__demux) (mach_msg_header_t *__request,
						 mach_msg_header_t *__reply),
			   mach_msg_size_t __max_size,
			   mach_port_t __rcv_name,
			   mach_msg_option_t __option,
			   mach_msg_timeout_t __timeout),
mach_msg_server_timeout (boolean_t (*__demux) (mach_msg_header_t *__request,
					       mach_msg_header_t *__reply),
			 mach_msg_size_t __max_size,
			 mach_port_t __rcv_name,
			 mach_msg_option_t __option,
			 mach_msg_timeout_t __timeout);


/* Deallocate all port rights and out-of-line memory in MSG. */
extern void
__mach_msg_destroy (mach_msg_header_t *msg),
mach_msg_destroy (mach_msg_header_t *msg);


#define __need_FILE
#include <stdio.h>

/* Open a stream on a Mach device.  */
extern FILE *mach_open_devstream (mach_port_t device_port, const char *mode);

/* Give THREAD a stack and set it to run at PC when resumed.
   If *STACK_SIZE is nonzero, that size of stack is allocated.
   If *STACK_BASE is nonzero, that stack location is used.
   If STACK_BASE is not null it is filled in with the chosen stack base.
   If STACK_SIZE is not null it is filled in with the chosen stack size.
   Regardless, an extra page of red zone is allocated off the end; this
   is not included in *STACK_SIZE.  */
kern_return_t __mach_setup_thread (task_t task, thread_t thread, void *pc,
				   vm_address_t *stack_base,
				   vm_size_t *stack_size);
kern_return_t mach_setup_thread (task_t task, thread_t thread, void *pc,
				 vm_address_t *stack_base,
				 vm_size_t *stack_size);


#endif	/* mach.h */
Commit	Line	Data
28f540f4	1	/* Standard header for all Mach programs.
c84142e8 UD	2	Copyright (C) 1993, 1994, 1996, 1997 Free Software Foundation, Inc.
	3	This file is part of the GNU C Library.
	4
	5	The GNU C Library is free software; you can redistribute it and/or
41bdb6e2 AJ	6	modify it under the terms of the GNU Lesser General Public
	7	License as published by the Free Software Foundation; either
	8	version 2.1 of the License, or (at your option) any later version.
c84142e8 UD	9
	10	The GNU C Library is distributed in the hope that it will be useful,
	11	but WITHOUT ANY WARRANTY; without even the implied warranty of
	12	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
41bdb6e2	13	Lesser General Public License for more details.
c84142e8	14
41bdb6e2 AJ	15	You should have received a copy of the GNU Lesser General Public
	16	License along with the GNU C Library; if not, write to the Free
	17	Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
	18	02111-1307 USA. */
28f540f4 RM	19
	20	#ifndef _MACH_H
	21
	22	#define _MACH_H 1
	23
	24	/* Get the basic types used by Mach. */
	25	#include <mach/mach_types.h>
	26
	27	/* This declares the basic variables and macros everything needs. */
	28	#include <mach_init.h>
	29
	30	/* This declares all the real system call functions. */
	31	#include <mach/mach_traps.h>
	32
	33	/* These are MiG-generated headers for the kernel interfaces commonly used. */
	34	#include <mach/mach_interface.h> /* From <mach/mach.defs>. */
	35	#include <mach/mach_port.h>
	36	#include <mach/mach_host.h>
	37
	38	/* For the kernel RPCs which have system call shortcut versions,
	39	the MiG-generated header in fact declares `CALL_rpc' rather than `CALL'.
	40	This file declares the simple `CALL' functions. */
	41	#include <mach-shortcuts.h>
	42
	43
	44	/* Receive RPC request messages on RCV_NAME and pass them to DEMUX, which
	45	decodes them and produces reply messages. MAX_SIZE is the maximum size
	46	(in bytes) of the request and reply buffers. */
	47	extern mach_msg_return_t
	48	__mach_msg_server (boolean_t (__demux) (mach_msg_header_t __request,
	49	mach_msg_header_t *__reply),
	50	mach_msg_size_t __max_size,
	51	mach_port_t __rcv_name),
	52	mach_msg_server (boolean_t (__demux) (mach_msg_header_t __request,
	53	mach_msg_header_t *__reply),
	54	mach_msg_size_t __max_size,
	55	mach_port_t __rcv_name);
	56
	57	/* Just like `mach_msg_server', but the OPTION and TIMEOUT parameters are
	58	passed on to `mach_msg'. */
	59	extern mach_msg_return_t
	60	__mach_msg_server_timeout (boolean_t (__demux) (mach_msg_header_t __request,
	61	mach_msg_header_t *__reply),
	62	mach_msg_size_t __max_size,
	63	mach_port_t __rcv_name,
	64	mach_msg_option_t __option,
	65	mach_msg_timeout_t __timeout),
	66	mach_msg_server_timeout (boolean_t (__demux) (mach_msg_header_t __request,
	67	mach_msg_header_t *__reply),
	68	mach_msg_size_t __max_size,
	69	mach_port_t __rcv_name,
	70	mach_msg_option_t __option,
	71	mach_msg_timeout_t __timeout);
	72
	73
ebe3b3eb TBB	74	/* Deallocate all port rights and out-of-line memory in MSG. */
	75	extern void
	76	__mach_msg_destroy (mach_msg_header_t *msg),
	77	mach_msg_destroy (mach_msg_header_t *msg);
	78
ebe3b3eb	79
28f540f4 RM	80	#define __need_FILE
	81	#include <stdio.h>
	82
	83	/* Open a stream on a Mach device. */
	84	extern FILE mach_open_devstream (mach_port_t device_port, const char mode);
	85
	86	/* Give THREAD a stack and set it to run at PC when resumed.
	87	If *STACK_SIZE is nonzero, that size of stack is allocated.
	88	If *STACK_BASE is nonzero, that stack location is used.
	89	If STACK_BASE is not null it is filled in with the chosen stack base.
	90	If STACK_SIZE is not null it is filled in with the chosen stack size.
	91	Regardless, an extra page of red zone is allocated off the end; this
	92	is not included in STACK_SIZE. /
	93	kern_return_t __mach_setup_thread (task_t task, thread_t thread, void *pc,
	94	vm_address_t *stack_base,
	95	vm_size_t *stack_size);
	96	kern_return_t mach_setup_thread (task_t task, thread_t thread, void *pc,
	97	vm_address_t *stack_base,
	98	vm_size_t *stack_size);
	99
	100
	101	#endif /* mach.h */