Annotation of XNU/osfmk/mach/mig_errors.h, revision 1.1.1.1

1.1       root        1: /*
                      2:  * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
                      3:  *
                      4:  * @APPLE_LICENSE_HEADER_START@
                      5:  * 
                      6:  * The contents of this file constitute Original Code as defined in and
                      7:  * are subject to the Apple Public Source License Version 1.1 (the
                      8:  * "License").  You may not use this file except in compliance with the
                      9:  * License.  Please obtain a copy of the License at
                     10:  * http://www.apple.com/publicsource and read it before using this file.
                     11:  * 
                     12:  * This Original Code and all software distributed under the License are
                     13:  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
                     14:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
                     15:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
                     16:  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
                     17:  * License for the specific language governing rights and limitations
                     18:  * under the License.
                     19:  * 
                     20:  * @APPLE_LICENSE_HEADER_END@
                     21:  */
                     22: /*
                     23:  * @OSF_COPYRIGHT@
                     24:  */
                     25: /* 
                     26:  * Mach Operating System
                     27:  * Copyright (c) 1991,1990,1989,1988,1987 Carnegie Mellon University
                     28:  * All Rights Reserved.
                     29:  * 
                     30:  * Permission to use, copy, modify and distribute this software and its
                     31:  * documentation is hereby granted, provided that both the copyright
                     32:  * notice and this permission notice appear in all copies of the
                     33:  * software, derivative works or modified versions, and any portions
                     34:  * thereof, and that both notices appear in supporting documentation.
                     35:  * 
                     36:  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
                     37:  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
                     38:  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
                     39:  * 
                     40:  * Carnegie Mellon requests users of this software to return to
                     41:  * 
                     42:  *  Software Distribution Coordinator  or  [email protected]
                     43:  *  School of Computer Science
                     44:  *  Carnegie Mellon University
                     45:  *  Pittsburgh PA 15213-3890
                     46:  * 
                     47:  * any improvements or extensions that they make and grant Carnegie Mellon
                     48:  * the rights to redistribute these changes.
                     49:  */
                     50: /*
                     51:  */
                     52: /*
                     53:  * Mach Interface Generator errors
                     54:  *
                     55:  */
                     56: 
                     57: #ifndef        _MACH_MIG_ERRORS_H_
                     58: #define _MACH_MIG_ERRORS_H_
                     59: 
                     60: #include <mach/kern_return.h>
                     61: #include <mach/message.h>
                     62: #include <mach/rpc.h>
                     63: #include <mach/vm_types.h>
                     64: 
                     65: /*
                     66:  *     These error codes should be specified as system 4, subsytem 2.
                     67:  *     But alas backwards compatibility makes that impossible.
                     68:  *     The problem is old clients of new servers (eg, the kernel)
                     69:  *     which get strange large error codes when there is a Mig problem
                     70:  *     in the server.  Unfortunately, the IPC system doesn't have
                     71:  *     the knowledge to convert the codes in this situation.
                     72:  */
                     73: 
                     74: #define MIG_TYPE_ERROR         -300    /* client type check failure */
                     75: #define MIG_REPLY_MISMATCH     -301    /* wrong reply message ID */
                     76: #define MIG_REMOTE_ERROR       -302    /* server detected error */
                     77: #define MIG_BAD_ID             -303    /* bad request message ID */
                     78: #define MIG_BAD_ARGUMENTS      -304    /* server type check failure */
                     79: #define MIG_NO_REPLY           -305    /* no reply should be send */
                     80: #define MIG_EXCEPTION          -306    /* server raised exception */
                     81: #define MIG_ARRAY_TOO_LARGE    -307    /* array not large enough */
                     82: #define MIG_SERVER_DIED                -308    /* server died */
                     83: #define MIG_TRAILER_ERROR       -309    /* trailer has an unknown format */
                     84: 
                     85: #include <mach/ndr.h>
                     86: 
                     87: typedef struct {
                     88:        mach_msg_header_t       Head;
                     89:        NDR_record_t            NDR;
                     90:        kern_return_t           RetCode;
                     91: } mig_reply_error_t;
                     92: 
                     93: typedef struct mig_symtab {
                     94:        char    *ms_routine_name;
                     95:        int     ms_routine_number;
                     96:        void    (*ms_routine)(void);    /* Since the functions in the
                     97:                                         * symbol table have unknown
                     98:                                         * signatures, this is the best
                     99:                                         * we can do...
                    100:                                         */
                    101: } mig_symtab_t;
                    102: 
                    103: /* Client side reply port allocate */
                    104: extern mach_port_t mig_get_reply_port(void);
                    105: 
                    106: /* Client side reply port deallocate */
                    107: extern void mig_dealloc_reply_port(mach_port_t reply_port);
                    108: 
                    109: /* Client side reply port "deallocation" */
                    110: extern void mig_put_reply_port(mach_port_t reply_port);
                    111: 
                    112: /* Allocate memory for out-of-stack mig structures */
                    113: extern char *mig_user_allocate(vm_size_t size);
                    114: 
                    115: /* Deallocate memory used for out-of-stack mig structures */
                    116: extern void mig_user_deallocate(char *data, vm_size_t size);
                    117: 
                    118: /* Bounded string copy */
                    119: extern int mig_strncpy(
                    120:        char    *dest,
                    121:        char    *src,
                    122:        int     len);
                    123: 
                    124: #endif /* _MACH_MIG_ERRORS_H_ */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.