1 1.16 pooka /* $NetBSD: pcb.h,v 1.16 2009/10/13 22:41:57 pooka Exp $ */ 2 1.1 eeh 3 1.1 eeh /* 4 1.1 eeh * Copyright (c) 1992, 1993 5 1.1 eeh * The Regents of the University of California. All rights reserved. 6 1.10 agc * 7 1.10 agc * This software was developed by the Computer Systems Engineering group 8 1.10 agc * at Lawrence Berkeley Laboratory under DARPA contract BG 91-66 and 9 1.10 agc * contributed to Berkeley. 10 1.10 agc * 11 1.10 agc * All advertising materials mentioning features or use of this software 12 1.10 agc * must display the following acknowledgement: 13 1.10 agc * This product includes software developed by the University of 14 1.10 agc * California, Lawrence Berkeley Laboratory. 15 1.10 agc * 16 1.10 agc * Redistribution and use in source and binary forms, with or without 17 1.10 agc * modification, are permitted provided that the following conditions 18 1.10 agc * are met: 19 1.10 agc * 1. Redistributions of source code must retain the above copyright 20 1.10 agc * notice, this list of conditions and the following disclaimer. 21 1.10 agc * 2. Redistributions in binary form must reproduce the above copyright 22 1.10 agc * notice, this list of conditions and the following disclaimer in the 23 1.10 agc * documentation and/or other materials provided with the distribution. 24 1.10 agc * 3. Neither the name of the University nor the names of its contributors 25 1.10 agc * may be used to endorse or promote products derived from this software 26 1.10 agc * without specific prior written permission. 27 1.10 agc * 28 1.10 agc * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 29 1.10 agc * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 30 1.10 agc * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 31 1.10 agc * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 32 1.10 agc * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 33 1.10 agc * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 34 1.10 agc * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 35 1.10 agc * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 36 1.10 agc * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 37 1.10 agc * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 38 1.10 agc * SUCH DAMAGE. 39 1.10 agc * 40 1.10 agc * @(#)pcb.h 8.1 (Berkeley) 6/11/93 41 1.10 agc */ 42 1.10 agc 43 1.10 agc /* 44 1.10 agc * Copyright (c) 1996-2002 Eduardo Horvath. All rights reserved. 45 1.1 eeh * 46 1.1 eeh * Redistribution and use in source and binary forms, with or without 47 1.1 eeh * modification, are permitted provided that the following conditions 48 1.1 eeh * are met: 49 1.1 eeh * 1. Redistributions of source code must retain the above copyright 50 1.1 eeh * notice, this list of conditions and the following disclaimer. 51 1.1 eeh * 2. Redistributions in binary form must reproduce the above copyright 52 1.1 eeh * notice, this list of conditions and the following disclaimer in the 53 1.1 eeh * documentation and/or other materials provided with the distribution. 54 1.12 eeh * 3. Neither the name of the author nor the names of its contributors 55 1.1 eeh * may be used to endorse or promote products derived from this software 56 1.1 eeh * without specific prior written permission. 57 1.1 eeh * 58 1.12 eeh * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 59 1.1 eeh * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 60 1.1 eeh * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 61 1.1 eeh * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 62 1.1 eeh * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 63 1.1 eeh * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 64 1.1 eeh * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 65 1.1 eeh * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 66 1.1 eeh * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 67 1.1 eeh * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 68 1.1 eeh * SUCH DAMAGE. 69 1.1 eeh * 70 1.1 eeh * @(#)pcb.h 8.1 (Berkeley) 6/11/93 71 1.1 eeh */ 72 1.1 eeh 73 1.16 pooka #ifndef _SPARC64_PCB_H_ 74 1.16 pooka #define _SPARC64_PCB_H_ 75 1.16 pooka 76 1.1 eeh #include <machine/reg.h> 77 1.1 eeh 78 1.1 eeh #ifdef notyet 79 1.1 eeh #define PCB_MAXWIN 32 /* architectural limit */ 80 1.1 eeh #else 81 1.1 eeh #define PCB_MAXWIN 8 /* worried about u area sizes ... */ 82 1.1 eeh #endif 83 1.1 eeh 84 1.1 eeh /* 85 1.1 eeh * SPARC Process Control Block. 86 1.1 eeh * 87 1.1 eeh * pcb_uw is positive if there are any user windows that are 88 1.1 eeh * are currently in the CPU windows rather than on the user 89 1.1 eeh * stack. Whenever we are running in the kernel with traps 90 1.1 eeh * enabled, we decrement pcb_uw for each ``push'' of a CPU 91 1.1 eeh * register window into the stack, and we increment it for 92 1.1 eeh * each ``pull'' from the stack into the CPU. (If traps are 93 1.1 eeh * disabled, or if we are in user mode, pcb_uw is junk.) 94 1.1 eeh * 95 1.1 eeh * To ease computing pcb_uw on traps from user mode, we keep track 96 1.1 eeh * of the log base 2 of the single bit that is set in %wim. 97 1.1 eeh * 98 1.1 eeh * If an overflow occurs while the associated user stack pages 99 1.1 eeh * are invalid (paged out), we have to store the registers 100 1.1 eeh * in a page that is locked in core while the process runs, 101 1.1 eeh * i.e., right here in the pcb. We also need the stack pointer 102 1.1 eeh * for the last such window (but only the last, as the others 103 1.1 eeh * are in each window) and the count of windows saved. We 104 1.1 eeh * cheat by having a whole window structure for that one %sp. 105 1.1 eeh * Thus, to save window pcb_rw[i] to memory, we write it at 106 1.1 eeh * pcb_rw[i + 1].rw_in[6]. 107 1.1 eeh * 108 1.1 eeh * pcb_nsaved has three `kinds' of values. If 0, it means no 109 1.1 eeh * registers are in the PCB (though if pcb_uw is positive, 110 1.1 eeh * there may be the next time you look). If positive, it means 111 1.1 eeh * there are no user registers in the CPU, but there are some 112 1.1 eeh * saved in pcb_rw[]. As a special case, traps that needed 113 1.1 eeh * assistance to pull user registers from the stack also store 114 1.1 eeh * the registers in pcb_rw[], and set pcb_nsaved to -1. This 115 1.1 eeh * special state is normally short-term: it can only last until the 116 1.1 eeh * trap returns, and it can never persist across entry to user code. 117 1.1 eeh */ 118 1.1 eeh /* 119 1.1 eeh * v9 addendum: 120 1.1 eeh * 121 1.1 eeh * Window handling between v8 and v9 has changed somewhat. There 122 1.1 eeh * is no %wim. Instead, we have a %cwp, %cansave, %canrestore, 123 1.1 eeh * %cleanwin, and %otherwin. By definition: 124 1.1 eeh * 125 1.1 eeh * %cansave + %canrestore + %otherwin = NWINDOWS - 2 126 1.1 eeh * 127 1.1 eeh * In addition, %cleanwin >= %canrestore since restorable windows 128 1.1 eeh * are considered clean. This means that by storing %canrestore 129 1.1 eeh * and %otherwin, we should be able to compute the values of all 130 1.1 eeh * the other registers. 131 1.1 eeh * 132 1.1 eeh * The only other register we need to save is %cwp because it cannot 133 1.1 eeh * be trivially computed from the other registers. The %cwp is 134 1.1 eeh * stored in the %tstate register, but if the machine was in a register 135 1.1 eeh * window spill/fill handler, the value of that %cwp may be off by 136 1.1 eeh * as much as 2 register windows. We will also store %cwp. [We will 137 1.1 eeh * try to steal pcb_uw or pcb_nsaved for this purpose eventually.] 138 1.1 eeh * 139 1.1 eeh * To calculate what registers are in the pcb, start with pcb_cwp 140 1.1 eeh * and proceed to (pcb_cwp - pcb_canrestore) % NWINDOWS. These should 141 1.1 eeh * be saved to their appropriate register windows. The client routine 142 1.1 eeh * (trap handler) is responsible for saving pcb_cwp + 1 [%o1-%o7] in 143 1.1 eeh * the trap frame or on the stack. 144 1.1 eeh * 145 1.1 eeh * 146 1.1 eeh * Even more addendum: 147 1.1 eeh * 148 1.1 eeh * With the new system for keeping track of register windows we don't 149 1.1 eeh * care about anything other than pcb_uw which keeps track of how many 150 1.1 eeh * full windows we have. As soon as a flush traps, we dump all user 151 1.1 eeh * windows to the pcb, handle the fault, then restore all user windows. 152 1.1 eeh * 153 1.1 eeh * XXX we are using pcb_nsaved as the counter. pcb_uw is still a mask. 154 1.1 eeh * change this as soon as the new scheme is debugged. 155 1.1 eeh */ 156 1.1 eeh struct pcb { 157 1.14 cdi uint64_t pcb_sp; /* sp (%o6) when switch() was called */ 158 1.14 cdi uint64_t pcb_pc; /* pc (%o7) when switch() was called */ 159 1.15 christos void * pcb_onfault; /* for copyin/out */ 160 1.1 eeh short pcb_pstate; /* %pstate when switch() was called -- may be useful if we support multiple memory models */ 161 1.1 eeh char pcb_nsaved; /* number of windows saved in pcb */ 162 1.1 eeh 163 1.1 eeh /* The rest is probably not needed except for pcb_rw */ 164 1.1 eeh char pcb_cwp; /* %cwp when switch() was called */ 165 1.1 eeh char pcb_pil; /* %pil when switch() was called -- prolly not needed */ 166 1.1 eeh 167 1.6 mrg const char *lastcall; /* DEBUG -- name of last system call */ 168 1.1 eeh /* the following MUST be aligned on a 64-bit boundary */ 169 1.1 eeh struct rwindow64 pcb_rw[PCB_MAXWIN]; /* saved windows */ 170 1.1 eeh }; 171 1.1 eeh 172 1.1 eeh /* 173 1.1 eeh * The pcb is augmented with machine-dependent additional data for 174 1.1 eeh * core dumps. Note that the trapframe here is a copy of the one 175 1.1 eeh * from the top of the kernel stack (included here so that the kernel 176 1.1 eeh * stack itself need not be dumped). 177 1.1 eeh */ 178 1.3 eeh struct md_coredump32 { 179 1.3 eeh struct trapframe32 md_tf; 180 1.3 eeh struct fpstate32 md_fpstate; 181 1.3 eeh }; 182 1.3 eeh 183 1.1 eeh struct md_coredump { 184 1.9 eeh struct trapframe64 md_tf; 185 1.3 eeh struct fpstate64 md_fpstate; 186 1.1 eeh }; 187 1.1 eeh 188 1.11 cdi #ifndef _KERNEL 189 1.2 eeh /* Let gdb compile. We need fancier macros to make these make sense. */ 190 1.2 eeh #define pcb_psr pcb_pstate 191 1.2 eeh #define pcb_wim pcb_cwp 192 1.1 eeh #endif /* _KERNEL */ 193 1.16 pooka 194 1.16 pooka #endif /* _SPARC64_PCB_H_ */ 195