1: /* Standard header for all Mach programs.
    2:    Copyright (C) 1993,94,96,97,2002 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
    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.
    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
   13:    Lesser General Public License for more details.
   14: 
   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.  */
   19: 
   20: #ifndef _MACH_H
   21: 
   22: #define _MACH_H 1
   23: 
   24: /* We must include this before using __need_FILE with <stdio.h> below.  */
   25: #include <features.h>
   26: 
   27: 
   28: /* Get the basic types used by Mach.  */
   29: #include <mach/mach_types.h>
   30: 
   31: /* This declares the basic variables and macros everything needs.  */
   32: #include <mach_init.h>
   33: 
   34: /* This declares all the real system call functions.  */
   35: #include <mach/mach_traps.h>
   36: 
   37: /* These are MiG-generated headers for the kernel interfaces commonly used.  */
   38: #include <mach/mach_interface.h> /* From <mach/mach.defs>.  */
   39: #include <mach/mach_port.h>
   40: #include <mach/mach_host.h>
   41: 
   42: /* For the kernel RPCs which have system call shortcut versions,
   43:    the MiG-generated header in fact declares `CALL_rpc' rather than `CALL'.
   44:    This file declares the simple `CALL' functions.  */
   45: #include <mach-shortcuts.h>
   46: 
   47: 
   48: /* Receive RPC request messages on RCV_NAME and pass them to DEMUX, which
   49:    decodes them and produces reply messages.  MAX_SIZE is the maximum size
   50:    (in bytes) of the request and reply buffers.  */
   51: extern mach_msg_return_t
   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: mach_msg_server (boolean_t (*__demux) (mach_msg_header_t *__request,
   57:                                        mach_msg_header_t *__reply),
   58:                  mach_msg_size_t __max_size,
   59:                  mach_port_t __rcv_name);
   60: 
   61: /* Just like `mach_msg_server', but the OPTION and TIMEOUT parameters are
   62:    passed on to `mach_msg'.  */
   63: extern mach_msg_return_t
   64: __mach_msg_server_timeout (boolean_t (*__demux) (mach_msg_header_t *__request,
   65:                                                  mach_msg_header_t *__reply),
   66:                            mach_msg_size_t __max_size,
   67:                            mach_port_t __rcv_name,
   68:                            mach_msg_option_t __option,
   69:                            mach_msg_timeout_t __timeout),
   70: mach_msg_server_timeout (boolean_t (*__demux) (mach_msg_header_t *__request,
   71:                                                mach_msg_header_t *__reply),
   72:                          mach_msg_size_t __max_size,
   73:                          mach_port_t __rcv_name,
   74:                          mach_msg_option_t __option,
   75:                          mach_msg_timeout_t __timeout);
   76: 
   77: 
   78: /* Deallocate all port rights and out-of-line memory in MSG. */
   79: extern void
   80: __mach_msg_destroy (mach_msg_header_t *msg),
   81: mach_msg_destroy (mach_msg_header_t *msg);
   82: 
   83: 
   84: #define __need_FILE
   85: #include <stdio.h>
   86: 
   87: /* Open a stream on a Mach device.  */
   88: extern FILE *mach_open_devstream (mach_port_t device_port, const char *mode);
   89: 
   90: /* Give THREAD a stack and set it to run at PC when resumed.
   91:    If *STACK_SIZE is nonzero, that size of stack is allocated.
   92:    If *STACK_BASE is nonzero, that stack location is used.
   93:    If STACK_BASE is not null it is filled in with the chosen stack base.
   94:    If STACK_SIZE is not null it is filled in with the chosen stack size.
   95:    Regardless, an extra page of red zone is allocated off the end; this
   96:    is not included in *STACK_SIZE.  */
   97: kern_return_t __mach_setup_thread (task_t task, thread_t thread, void *pc,
   98:                                    vm_address_t *stack_base,
   99:                                    vm_size_t *stack_size);
  100: kern_return_t mach_setup_thread (task_t task, thread_t thread, void *pc,
  101:                                  vm_address_t *stack_base,
  102:                                  vm_size_t *stack_size);
  103: 
  104: 
  105: #endif  /* mach.h */