Annotation of XNU/osfmk/ppc/db_machdep.h, revision 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 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: #ifndef        _PPC_DB_MACHDEP_H_
        !            54: #define        _PPC_DB_MACHDEP_H_
        !            55: 
        !            56: /*
        !            57:  * Machine-dependent defines for new kernel debugger.
        !            58:  */
        !            59: 
        !            60: #include <kern/kern_types.h>
        !            61: #include <mach/ppc/vm_types.h>
        !            62: #include <mach/ppc/vm_param.h>
        !            63: #include <ppc/thread.h>                /* for thread_status */
        !            64: #include <ppc/trap.h>
        !            65: #include <ppc/proc_reg.h>
        !            66: 
        !            67: typedef        vm_offset_t     db_addr_t;      /* address - unsigned */
        !            68: typedef        int             db_expr_t;      /* expression - signed */
        !            69: 
        !            70: typedef struct ppc_saved_state db_regs_t;
        !            71: db_regs_t      ddb_regs;       /* register state */
        !            72: #define        DDB_REGS        (&ddb_regs)
        !            73: extern int     db_active;      /* ddb is active */
        !            74: 
        !            75: #define        PC_REGS(regs)   ((db_addr_t)(regs)->srr0)
        !            76: 
        !            77: #define        BKPT_INST       0x7c810808      /* breakpoint instruction */
        !            78: #define        BKPT_SIZE       (4)             /* size of breakpoint inst */
        !            79: #define        BKPT_SET(inst)  (BKPT_INST)
        !            80: 
        !            81: #define db_clear_single_step(regs)     ((regs)->srr1 &= ~MASK(MSR_SE))
        !            82: #define db_set_single_step(regs)       ((regs)->srr1 |= MASK(MSR_SE))
        !            83: 
        !            84: #define        IS_BREAKPOINT_TRAP(type, code)  (FALSE)
        !            85: #define IS_WATCHPOINT_TRAP(type, code) (FALSE)
        !            86: 
        !            87: #define        inst_trap_return(ins)   (FALSE)
        !            88: #define        inst_return(ins)        (FALSE)
        !            89: #define        inst_call(ins)          (FALSE)
        !            90: 
        !            91: int db_inst_load(unsigned long);
        !            92: int db_inst_store(unsigned long);
        !            93: 
        !            94: /* access capability and access macros */
        !            95: 
        !            96: #define DB_ACCESS_LEVEL        DB_ACCESS_ANY   /* any space */
        !            97: #define DB_CHECK_ACCESS(addr,size,task)                                \
        !            98:        db_check_access(addr,size,task)
        !            99: #define DB_PHYS_EQ(task1,addr1,task2,addr2)                    \
        !           100:        db_phys_eq(task1,addr1,task2,addr2)
        !           101: #define DB_VALID_KERN_ADDR(addr)                               \
        !           102:        ((addr) >= VM_MIN_KERNEL_ADDRESS &&                     \
        !           103:         (addr) < VM_MAX_KERNEL_ADDRESS)
        !           104: #define DB_VALID_ADDRESS(addr,user)                            \
        !           105:        ((!(user) && DB_VALID_KERN_ADDR(addr)) ||               \
        !           106:         ((user) && (addr) < VM_MAX_ADDRESS))
        !           107: 
        !           108: /*
        !           109:  * Given pointer to ppc_saved_state, determine if it represents
        !           110:  * a thread executing a) in user space, b) in the kernel, or c)
        !           111:  * in a kernel-loaded task.  Return true for cases a) and c).
        !           112:  */
        !           113: #define IS_USER_TRAP(regs)     \
        !           114:      (USER_MODE(regs->srr1))
        !           115: 
        !           116: extern boolean_t       db_check_access(
        !           117:                                vm_offset_t     addr,
        !           118:                                int             size,
        !           119:                                task_t          task);
        !           120: extern boolean_t       db_phys_eq(
        !           121:                                task_t          task1,
        !           122:                                vm_offset_t     addr1,
        !           123:                                task_t          task2,
        !           124:                                vm_offset_t     addr2);
        !           125: extern db_addr_t       db_disasm(
        !           126:                                db_addr_t       loc,
        !           127:                                boolean_t       altfmt,
        !           128:                                task_t          task);
        !           129: extern vm_offset_t     db_kvtophys( 
        !           130:                                space_t space,
        !           131:                                vm_offset_t va);
        !           132: 
        !           133: extern void            db_read_bytes(
        !           134:                                vm_offset_t     addr,
        !           135:                                int             size,
        !           136:                                char            *data,
        !           137:                                task_t          task);
        !           138: extern void            db_write_bytes(
        !           139:                                vm_offset_t     addr,
        !           140:                                int             size,
        !           141:                                char            *data,
        !           142:                                task_t          task);
        !           143: extern void            db_stack_trace_cmd(
        !           144:                                db_expr_t       addr,
        !           145:                                boolean_t       have_addr,
        !           146:                                db_expr_t       count,
        !           147:                                char            *modif);
        !           148: extern void            db_reboot(
        !           149:                                db_expr_t       addr,
        !           150:                                boolean_t       have_addr,
        !           151:                                db_expr_t       count,
        !           152:                                char            *modif);
        !           153: extern void            db_low_trace(
        !           154:                                db_expr_t       addr,
        !           155:                                int             have_addr,
        !           156:                                db_expr_t       count,
        !           157:                                char            *modif);
        !           158: extern void            db_to_gdb(
        !           159:                                void);
        !           160: 
        !           161: 
        !           162: /* macros for printing OS server dependent task name */
        !           163: 
        !           164: #define DB_TASK_NAME(task)     db_task_name(task)
        !           165: #define DB_TASK_NAME_TITLE     "COMMAND                                "
        !           166: #define DB_TASK_NAME_LEN       39
        !           167: #define DB_NULL_TASK_NAME      "?                      "
        !           168: 
        !           169: extern void            db_task_name(
        !           170:                                task_t                  task);
        !           171: 
        !           172: /* macro for checking if a thread has used floating-point */
        !           173: 
        !           174: #define db_act_fp_used(act)    (FALSE)
        !           175: 
        !           176: extern void            kdb_trap(
        !           177:                                int                     type,
        !           178:                                struct ppc_saved_state  *regs);
        !           179: extern boolean_t       db_trap_from_asm(
        !           180:                                struct ppc_saved_state *regs);
        !           181: extern void            kdb_on(
        !           182:                                int                     cpu);
        !           183: extern void            cnpollc(
        !           184:                                boolean_t               on);
        !           185:                                
        !           186: extern void            kdb_kintr(void);
        !           187: 
        !           188: extern void            db_phys_copy(
        !           189:                                vm_offset_t, 
        !           190:                                vm_offset_t, 
        !           191:                                vm_size_t);
        !           192: 
        !           193: extern boolean_t       db_phys_cmp(
        !           194:                                vm_offset_t, 
        !           195:                                vm_offset_t, 
        !           196:                                vm_size_t);
        !           197: 
        !           198: #endif /* _PPC_DB_MACHDEP_H_ */

unix.superglobalmegacorp.com

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