include: replace linux/module.h with "struct module" wherever possible
[linux-2.6/next.git] / arch / ia64 / include / asm / pal.h
blob2e69284df8e77b8bbf7701b8a5e260aa6dee746d
1 #ifndef _ASM_IA64_PAL_H
2 #define _ASM_IA64_PAL_H
4 /*
5 * Processor Abstraction Layer definitions.
7 * This is based on Intel IA-64 Architecture Software Developer's Manual rev 1.0
8 * chapter 11 IA-64 Processor Abstraction Layer
10 * Copyright (C) 1998-2001 Hewlett-Packard Co
11 * David Mosberger-Tang <davidm@hpl.hp.com>
12 * Stephane Eranian <eranian@hpl.hp.com>
13 * Copyright (C) 1999 VA Linux Systems
14 * Copyright (C) 1999 Walt Drummond <drummond@valinux.com>
15 * Copyright (C) 1999 Srinivasa Prasad Thirumalachar <sprasad@sprasad.engr.sgi.com>
16 * Copyright (C) 2008 Silicon Graphics, Inc. (SGI)
18 * 99/10/01 davidm Make sure we pass zero for reserved parameters.
19 * 00/03/07 davidm Updated pal_cache_flush() to be in sync with PAL v2.6.
20 * 00/03/23 cfleck Modified processor min-state save area to match updated PAL & SAL info
21 * 00/05/24 eranian Updated to latest PAL spec, fix structures bugs, added
22 * 00/05/25 eranian Support for stack calls, and static physical calls
23 * 00/06/18 eranian Support for stacked physical calls
24 * 06/10/26 rja Support for Intel Itanium Architecture Software Developer's
25 * Manual Rev 2.2 (Jan 2006)
29 * Note that some of these calls use a static-register only calling
30 * convention which has nothing to do with the regular calling
31 * convention.
33 #define PAL_CACHE_FLUSH 1 /* flush i/d cache */
34 #define PAL_CACHE_INFO 2 /* get detailed i/d cache info */
35 #define PAL_CACHE_INIT 3 /* initialize i/d cache */
36 #define PAL_CACHE_SUMMARY 4 /* get summary of cache hierarchy */
37 #define PAL_MEM_ATTRIB 5 /* list supported memory attributes */
38 #define PAL_PTCE_INFO 6 /* purge TLB info */
39 #define PAL_VM_INFO 7 /* return supported virtual memory features */
40 #define PAL_VM_SUMMARY 8 /* return summary on supported vm features */
41 #define PAL_BUS_GET_FEATURES 9 /* return processor bus interface features settings */
42 #define PAL_BUS_SET_FEATURES 10 /* set processor bus features */
43 #define PAL_DEBUG_INFO 11 /* get number of debug registers */
44 #define PAL_FIXED_ADDR 12 /* get fixed component of processors's directed address */
45 #define PAL_FREQ_BASE 13 /* base frequency of the platform */
46 #define PAL_FREQ_RATIOS 14 /* ratio of processor, bus and ITC frequency */
47 #define PAL_PERF_MON_INFO 15 /* return performance monitor info */
48 #define PAL_PLATFORM_ADDR 16 /* set processor interrupt block and IO port space addr */
49 #define PAL_PROC_GET_FEATURES 17 /* get configurable processor features & settings */
50 #define PAL_PROC_SET_FEATURES 18 /* enable/disable configurable processor features */
51 #define PAL_RSE_INFO 19 /* return rse information */
52 #define PAL_VERSION 20 /* return version of PAL code */
53 #define PAL_MC_CLEAR_LOG 21 /* clear all processor log info */
54 #define PAL_MC_DRAIN 22 /* drain operations which could result in an MCA */
55 #define PAL_MC_EXPECTED 23 /* set/reset expected MCA indicator */
56 #define PAL_MC_DYNAMIC_STATE 24 /* get processor dynamic state */
57 #define PAL_MC_ERROR_INFO 25 /* get processor MCA info and static state */
58 #define PAL_MC_RESUME 26 /* Return to interrupted process */
59 #define PAL_MC_REGISTER_MEM 27 /* Register memory for PAL to use during MCAs and inits */
60 #define PAL_HALT 28 /* enter the low power HALT state */
61 #define PAL_HALT_LIGHT 29 /* enter the low power light halt state*/
62 #define PAL_COPY_INFO 30 /* returns info needed to relocate PAL */
63 #define PAL_CACHE_LINE_INIT 31 /* init tags & data of cache line */
64 #define PAL_PMI_ENTRYPOINT 32 /* register PMI memory entry points with the processor */
65 #define PAL_ENTER_IA_32_ENV 33 /* enter IA-32 system environment */
66 #define PAL_VM_PAGE_SIZE 34 /* return vm TC and page walker page sizes */
68 #define PAL_MEM_FOR_TEST 37 /* get amount of memory needed for late processor test */
69 #define PAL_CACHE_PROT_INFO 38 /* get i/d cache protection info */
70 #define PAL_REGISTER_INFO 39 /* return AR and CR register information*/
71 #define PAL_SHUTDOWN 40 /* enter processor shutdown state */
72 #define PAL_PREFETCH_VISIBILITY 41 /* Make Processor Prefetches Visible */
73 #define PAL_LOGICAL_TO_PHYSICAL 42 /* returns information on logical to physical processor mapping */
74 #define PAL_CACHE_SHARED_INFO 43 /* returns information on caches shared by logical processor */
75 #define PAL_GET_HW_POLICY 48 /* Get current hardware resource sharing policy */
76 #define PAL_SET_HW_POLICY 49 /* Set current hardware resource sharing policy */
77 #define PAL_VP_INFO 50 /* Information about virtual processor features */
78 #define PAL_MC_HW_TRACKING 51 /* Hardware tracking status */
80 #define PAL_COPY_PAL 256 /* relocate PAL procedures and PAL PMI */
81 #define PAL_HALT_INFO 257 /* return the low power capabilities of processor */
82 #define PAL_TEST_PROC 258 /* perform late processor self-test */
83 #define PAL_CACHE_READ 259 /* read tag & data of cacheline for diagnostic testing */
84 #define PAL_CACHE_WRITE 260 /* write tag & data of cacheline for diagnostic testing */
85 #define PAL_VM_TR_READ 261 /* read contents of translation register */
86 #define PAL_GET_PSTATE 262 /* get the current P-state */
87 #define PAL_SET_PSTATE 263 /* set the P-state */
88 #define PAL_BRAND_INFO 274 /* Processor branding information */
90 #define PAL_GET_PSTATE_TYPE_LASTSET 0
91 #define PAL_GET_PSTATE_TYPE_AVGANDRESET 1
92 #define PAL_GET_PSTATE_TYPE_AVGNORESET 2
93 #define PAL_GET_PSTATE_TYPE_INSTANT 3
95 #define PAL_MC_ERROR_INJECT 276 /* Injects processor error or returns injection capabilities */
97 #ifndef __ASSEMBLY__
99 #include <linux/types.h>
100 #include <asm/fpu.h>
103 * Data types needed to pass information into PAL procedures and
104 * interpret information returned by them.
107 /* Return status from the PAL procedure */
108 typedef s64 pal_status_t;
110 #define PAL_STATUS_SUCCESS 0 /* No error */
111 #define PAL_STATUS_UNIMPLEMENTED (-1) /* Unimplemented procedure */
112 #define PAL_STATUS_EINVAL (-2) /* Invalid argument */
113 #define PAL_STATUS_ERROR (-3) /* Error */
114 #define PAL_STATUS_CACHE_INIT_FAIL (-4) /* Could not initialize the
115 * specified level and type of
116 * cache without sideeffects
117 * and "restrict" was 1
119 #define PAL_STATUS_REQUIRES_MEMORY (-9) /* Call requires PAL memory buffer */
121 /* Processor cache level in the hierarchy */
122 typedef u64 pal_cache_level_t;
123 #define PAL_CACHE_LEVEL_L0 0 /* L0 */
124 #define PAL_CACHE_LEVEL_L1 1 /* L1 */
125 #define PAL_CACHE_LEVEL_L2 2 /* L2 */
128 /* Processor cache type at a particular level in the hierarchy */
130 typedef u64 pal_cache_type_t;
131 #define PAL_CACHE_TYPE_INSTRUCTION 1 /* Instruction cache */
132 #define PAL_CACHE_TYPE_DATA 2 /* Data or unified cache */
133 #define PAL_CACHE_TYPE_INSTRUCTION_DATA 3 /* Both Data & Instruction */
136 #define PAL_CACHE_FLUSH_INVALIDATE 1 /* Invalidate clean lines */
137 #define PAL_CACHE_FLUSH_CHK_INTRS 2 /* check for interrupts/mc while flushing */
139 /* Processor cache line size in bytes */
140 typedef int pal_cache_line_size_t;
142 /* Processor cache line state */
143 typedef u64 pal_cache_line_state_t;
144 #define PAL_CACHE_LINE_STATE_INVALID 0 /* Invalid */
145 #define PAL_CACHE_LINE_STATE_SHARED 1 /* Shared */
146 #define PAL_CACHE_LINE_STATE_EXCLUSIVE 2 /* Exclusive */
147 #define PAL_CACHE_LINE_STATE_MODIFIED 3 /* Modified */
149 typedef struct pal_freq_ratio {
150 u32 den, num; /* numerator & denominator */
151 } itc_ratio, proc_ratio;
153 typedef union pal_cache_config_info_1_s {
154 struct {
155 u64 u : 1, /* 0 Unified cache ? */
156 at : 2, /* 2-1 Cache mem attr*/
157 reserved : 5, /* 7-3 Reserved */
158 associativity : 8, /* 16-8 Associativity*/
159 line_size : 8, /* 23-17 Line size */
160 stride : 8, /* 31-24 Stride */
161 store_latency : 8, /*39-32 Store latency*/
162 load_latency : 8, /* 47-40 Load latency*/
163 store_hints : 8, /* 55-48 Store hints*/
164 load_hints : 8; /* 63-56 Load hints */
165 } pcci1_bits;
166 u64 pcci1_data;
167 } pal_cache_config_info_1_t;
169 typedef union pal_cache_config_info_2_s {
170 struct {
171 u32 cache_size; /*cache size in bytes*/
174 u32 alias_boundary : 8, /* 39-32 aliased addr
175 * separation for max
176 * performance.
178 tag_ls_bit : 8, /* 47-40 LSb of addr*/
179 tag_ms_bit : 8, /* 55-48 MSb of addr*/
180 reserved : 8; /* 63-56 Reserved */
181 } pcci2_bits;
182 u64 pcci2_data;
183 } pal_cache_config_info_2_t;
186 typedef struct pal_cache_config_info_s {
187 pal_status_t pcci_status;
188 pal_cache_config_info_1_t pcci_info_1;
189 pal_cache_config_info_2_t pcci_info_2;
190 u64 pcci_reserved;
191 } pal_cache_config_info_t;
193 #define pcci_ld_hints pcci_info_1.pcci1_bits.load_hints
194 #define pcci_st_hints pcci_info_1.pcci1_bits.store_hints
195 #define pcci_ld_latency pcci_info_1.pcci1_bits.load_latency
196 #define pcci_st_latency pcci_info_1.pcci1_bits.store_latency
197 #define pcci_stride pcci_info_1.pcci1_bits.stride
198 #define pcci_line_size pcci_info_1.pcci1_bits.line_size
199 #define pcci_assoc pcci_info_1.pcci1_bits.associativity
200 #define pcci_cache_attr pcci_info_1.pcci1_bits.at
201 #define pcci_unified pcci_info_1.pcci1_bits.u
202 #define pcci_tag_msb pcci_info_2.pcci2_bits.tag_ms_bit
203 #define pcci_tag_lsb pcci_info_2.pcci2_bits.tag_ls_bit
204 #define pcci_alias_boundary pcci_info_2.pcci2_bits.alias_boundary
205 #define pcci_cache_size pcci_info_2.pcci2_bits.cache_size
209 /* Possible values for cache attributes */
211 #define PAL_CACHE_ATTR_WT 0 /* Write through cache */
212 #define PAL_CACHE_ATTR_WB 1 /* Write back cache */
213 #define PAL_CACHE_ATTR_WT_OR_WB 2 /* Either write thru or write
214 * back depending on TLB
215 * memory attributes
219 /* Possible values for cache hints */
221 #define PAL_CACHE_HINT_TEMP_1 0 /* Temporal level 1 */
222 #define PAL_CACHE_HINT_NTEMP_1 1 /* Non-temporal level 1 */
223 #define PAL_CACHE_HINT_NTEMP_ALL 3 /* Non-temporal all levels */
225 /* Processor cache protection information */
226 typedef union pal_cache_protection_element_u {
227 u32 pcpi_data;
228 struct {
229 u32 data_bits : 8, /* # data bits covered by
230 * each unit of protection
233 tagprot_lsb : 6, /* Least -do- */
234 tagprot_msb : 6, /* Most Sig. tag address
235 * bit that this
236 * protection covers.
238 prot_bits : 6, /* # of protection bits */
239 method : 4, /* Protection method */
240 t_d : 2; /* Indicates which part
241 * of the cache this
242 * protection encoding
243 * applies.
245 } pcp_info;
246 } pal_cache_protection_element_t;
248 #define pcpi_cache_prot_part pcp_info.t_d
249 #define pcpi_prot_method pcp_info.method
250 #define pcpi_prot_bits pcp_info.prot_bits
251 #define pcpi_tagprot_msb pcp_info.tagprot_msb
252 #define pcpi_tagprot_lsb pcp_info.tagprot_lsb
253 #define pcpi_data_bits pcp_info.data_bits
255 /* Processor cache part encodings */
256 #define PAL_CACHE_PROT_PART_DATA 0 /* Data protection */
257 #define PAL_CACHE_PROT_PART_TAG 1 /* Tag protection */
258 #define PAL_CACHE_PROT_PART_TAG_DATA 2 /* Tag+data protection (tag is
259 * more significant )
261 #define PAL_CACHE_PROT_PART_DATA_TAG 3 /* Data+tag protection (data is
262 * more significant )
264 #define PAL_CACHE_PROT_PART_MAX 6
267 typedef struct pal_cache_protection_info_s {
268 pal_status_t pcpi_status;
269 pal_cache_protection_element_t pcp_info[PAL_CACHE_PROT_PART_MAX];
270 } pal_cache_protection_info_t;
273 /* Processor cache protection method encodings */
274 #define PAL_CACHE_PROT_METHOD_NONE 0 /* No protection */
275 #define PAL_CACHE_PROT_METHOD_ODD_PARITY 1 /* Odd parity */
276 #define PAL_CACHE_PROT_METHOD_EVEN_PARITY 2 /* Even parity */
277 #define PAL_CACHE_PROT_METHOD_ECC 3 /* ECC protection */
280 /* Processor cache line identification in the hierarchy */
281 typedef union pal_cache_line_id_u {
282 u64 pclid_data;
283 struct {
284 u64 cache_type : 8, /* 7-0 cache type */
285 level : 8, /* 15-8 level of the
286 * cache in the
287 * hierarchy.
289 way : 8, /* 23-16 way in the set
291 part : 8, /* 31-24 part of the
292 * cache
294 reserved : 32; /* 63-32 is reserved*/
295 } pclid_info_read;
296 struct {
297 u64 cache_type : 8, /* 7-0 cache type */
298 level : 8, /* 15-8 level of the
299 * cache in the
300 * hierarchy.
302 way : 8, /* 23-16 way in the set
304 part : 8, /* 31-24 part of the
305 * cache
307 mesi : 8, /* 39-32 cache line
308 * state
310 start : 8, /* 47-40 lsb of data to
311 * invert
313 length : 8, /* 55-48 #bits to
314 * invert
316 trigger : 8; /* 63-56 Trigger error
317 * by doing a load
318 * after the write
321 } pclid_info_write;
322 } pal_cache_line_id_u_t;
324 #define pclid_read_part pclid_info_read.part
325 #define pclid_read_way pclid_info_read.way
326 #define pclid_read_level pclid_info_read.level
327 #define pclid_read_cache_type pclid_info_read.cache_type
329 #define pclid_write_trigger pclid_info_write.trigger
330 #define pclid_write_length pclid_info_write.length
331 #define pclid_write_start pclid_info_write.start
332 #define pclid_write_mesi pclid_info_write.mesi
333 #define pclid_write_part pclid_info_write.part
334 #define pclid_write_way pclid_info_write.way
335 #define pclid_write_level pclid_info_write.level
336 #define pclid_write_cache_type pclid_info_write.cache_type
338 /* Processor cache line part encodings */
339 #define PAL_CACHE_LINE_ID_PART_DATA 0 /* Data */
340 #define PAL_CACHE_LINE_ID_PART_TAG 1 /* Tag */
341 #define PAL_CACHE_LINE_ID_PART_DATA_PROT 2 /* Data protection */
342 #define PAL_CACHE_LINE_ID_PART_TAG_PROT 3 /* Tag protection */
343 #define PAL_CACHE_LINE_ID_PART_DATA_TAG_PROT 4 /* Data+tag
344 * protection
346 typedef struct pal_cache_line_info_s {
347 pal_status_t pcli_status; /* Return status of the read cache line
348 * info call.
350 u64 pcli_data; /* 64-bit data, tag, protection bits .. */
351 u64 pcli_data_len; /* data length in bits */
352 pal_cache_line_state_t pcli_cache_line_state; /* mesi state */
354 } pal_cache_line_info_t;
357 /* Machine Check related crap */
359 /* Pending event status bits */
360 typedef u64 pal_mc_pending_events_t;
362 #define PAL_MC_PENDING_MCA (1 << 0)
363 #define PAL_MC_PENDING_INIT (1 << 1)
365 /* Error information type */
366 typedef u64 pal_mc_info_index_t;
368 #define PAL_MC_INFO_PROCESSOR 0 /* Processor */
369 #define PAL_MC_INFO_CACHE_CHECK 1 /* Cache check */
370 #define PAL_MC_INFO_TLB_CHECK 2 /* Tlb check */
371 #define PAL_MC_INFO_BUS_CHECK 3 /* Bus check */
372 #define PAL_MC_INFO_REQ_ADDR 4 /* Requestor address */
373 #define PAL_MC_INFO_RESP_ADDR 5 /* Responder address */
374 #define PAL_MC_INFO_TARGET_ADDR 6 /* Target address */
375 #define PAL_MC_INFO_IMPL_DEP 7 /* Implementation
376 * dependent
379 #define PAL_TLB_CHECK_OP_PURGE 8
381 typedef struct pal_process_state_info_s {
382 u64 reserved1 : 2,
383 rz : 1, /* PAL_CHECK processor
384 * rendezvous
385 * successful.
388 ra : 1, /* PAL_CHECK attempted
389 * a rendezvous.
391 me : 1, /* Distinct multiple
392 * errors occurred
395 mn : 1, /* Min. state save
396 * area has been
397 * registered with PAL
400 sy : 1, /* Storage integrity
401 * synched
405 co : 1, /* Continuable */
406 ci : 1, /* MC isolated */
407 us : 1, /* Uncontained storage
408 * damage.
412 hd : 1, /* Non-essential hw
413 * lost (no loss of
414 * functionality)
415 * causing the
416 * processor to run in
417 * degraded mode.
420 tl : 1, /* 1 => MC occurred
421 * after an instr was
422 * executed but before
423 * the trap that
424 * resulted from instr
425 * execution was
426 * generated.
427 * (Trap Lost )
429 mi : 1, /* More information available
430 * call PAL_MC_ERROR_INFO
432 pi : 1, /* Precise instruction pointer */
433 pm : 1, /* Precise min-state save area */
435 dy : 1, /* Processor dynamic
436 * state valid
440 in : 1, /* 0 = MC, 1 = INIT */
441 rs : 1, /* RSE valid */
442 cm : 1, /* MC corrected */
443 ex : 1, /* MC is expected */
444 cr : 1, /* Control regs valid*/
445 pc : 1, /* Perf cntrs valid */
446 dr : 1, /* Debug regs valid */
447 tr : 1, /* Translation regs
448 * valid
450 rr : 1, /* Region regs valid */
451 ar : 1, /* App regs valid */
452 br : 1, /* Branch regs valid */
453 pr : 1, /* Predicate registers
454 * valid
457 fp : 1, /* fp registers valid*/
458 b1 : 1, /* Preserved bank one
459 * general registers
460 * are valid
462 b0 : 1, /* Preserved bank zero
463 * general registers
464 * are valid
466 gr : 1, /* General registers
467 * are valid
468 * (excl. banked regs)
470 dsize : 16, /* size of dynamic
471 * state returned
472 * by the processor
475 se : 1, /* Shared error. MCA in a
476 shared structure */
477 reserved2 : 10,
478 cc : 1, /* Cache check */
479 tc : 1, /* TLB check */
480 bc : 1, /* Bus check */
481 rc : 1, /* Register file check */
482 uc : 1; /* Uarch check */
484 } pal_processor_state_info_t;
486 typedef struct pal_cache_check_info_s {
487 u64 op : 4, /* Type of cache
488 * operation that
489 * caused the machine
490 * check.
492 level : 2, /* Cache level */
493 reserved1 : 2,
494 dl : 1, /* Failure in data part
495 * of cache line
497 tl : 1, /* Failure in tag part
498 * of cache line
500 dc : 1, /* Failure in dcache */
501 ic : 1, /* Failure in icache */
502 mesi : 3, /* Cache line state */
503 mv : 1, /* mesi valid */
504 way : 5, /* Way in which the
505 * error occurred
507 wiv : 1, /* Way field valid */
508 reserved2 : 1,
509 dp : 1, /* Data poisoned on MBE */
510 reserved3 : 6,
511 hlth : 2, /* Health indicator */
513 index : 20, /* Cache line index */
514 reserved4 : 2,
516 is : 1, /* instruction set (1 == ia32) */
517 iv : 1, /* instruction set field valid */
518 pl : 2, /* privilege level */
519 pv : 1, /* privilege level field valid */
520 mcc : 1, /* Machine check corrected */
521 tv : 1, /* Target address
522 * structure is valid
524 rq : 1, /* Requester identifier
525 * structure is valid
527 rp : 1, /* Responder identifier
528 * structure is valid
530 pi : 1; /* Precise instruction pointer
531 * structure is valid
533 } pal_cache_check_info_t;
535 typedef struct pal_tlb_check_info_s {
537 u64 tr_slot : 8, /* Slot# of TR where
538 * error occurred
540 trv : 1, /* tr_slot field is valid */
541 reserved1 : 1,
542 level : 2, /* TLB level where failure occurred */
543 reserved2 : 4,
544 dtr : 1, /* Fail in data TR */
545 itr : 1, /* Fail in inst TR */
546 dtc : 1, /* Fail in data TC */
547 itc : 1, /* Fail in inst. TC */
548 op : 4, /* Cache operation */
549 reserved3 : 6,
550 hlth : 2, /* Health indicator */
551 reserved4 : 22,
553 is : 1, /* instruction set (1 == ia32) */
554 iv : 1, /* instruction set field valid */
555 pl : 2, /* privilege level */
556 pv : 1, /* privilege level field valid */
557 mcc : 1, /* Machine check corrected */
558 tv : 1, /* Target address
559 * structure is valid
561 rq : 1, /* Requester identifier
562 * structure is valid
564 rp : 1, /* Responder identifier
565 * structure is valid
567 pi : 1; /* Precise instruction pointer
568 * structure is valid
570 } pal_tlb_check_info_t;
572 typedef struct pal_bus_check_info_s {
573 u64 size : 5, /* Xaction size */
574 ib : 1, /* Internal bus error */
575 eb : 1, /* External bus error */
576 cc : 1, /* Error occurred
577 * during cache-cache
578 * transfer.
580 type : 8, /* Bus xaction type*/
581 sev : 5, /* Bus error severity*/
582 hier : 2, /* Bus hierarchy level */
583 dp : 1, /* Data poisoned on MBE */
584 bsi : 8, /* Bus error status
585 * info
587 reserved2 : 22,
589 is : 1, /* instruction set (1 == ia32) */
590 iv : 1, /* instruction set field valid */
591 pl : 2, /* privilege level */
592 pv : 1, /* privilege level field valid */
593 mcc : 1, /* Machine check corrected */
594 tv : 1, /* Target address
595 * structure is valid
597 rq : 1, /* Requester identifier
598 * structure is valid
600 rp : 1, /* Responder identifier
601 * structure is valid
603 pi : 1; /* Precise instruction pointer
604 * structure is valid
606 } pal_bus_check_info_t;
608 typedef struct pal_reg_file_check_info_s {
609 u64 id : 4, /* Register file identifier */
610 op : 4, /* Type of register
611 * operation that
612 * caused the machine
613 * check.
615 reg_num : 7, /* Register number */
616 rnv : 1, /* reg_num valid */
617 reserved2 : 38,
619 is : 1, /* instruction set (1 == ia32) */
620 iv : 1, /* instruction set field valid */
621 pl : 2, /* privilege level */
622 pv : 1, /* privilege level field valid */
623 mcc : 1, /* Machine check corrected */
624 reserved3 : 3,
625 pi : 1; /* Precise instruction pointer
626 * structure is valid
628 } pal_reg_file_check_info_t;
630 typedef struct pal_uarch_check_info_s {
631 u64 sid : 5, /* Structure identification */
632 level : 3, /* Level of failure */
633 array_id : 4, /* Array identification */
634 op : 4, /* Type of
635 * operation that
636 * caused the machine
637 * check.
639 way : 6, /* Way of structure */
640 wv : 1, /* way valid */
641 xv : 1, /* index valid */
642 reserved1 : 6,
643 hlth : 2, /* Health indicator */
644 index : 8, /* Index or set of the uarch
645 * structure that failed.
647 reserved2 : 24,
649 is : 1, /* instruction set (1 == ia32) */
650 iv : 1, /* instruction set field valid */
651 pl : 2, /* privilege level */
652 pv : 1, /* privilege level field valid */
653 mcc : 1, /* Machine check corrected */
654 tv : 1, /* Target address
655 * structure is valid
657 rq : 1, /* Requester identifier
658 * structure is valid
660 rp : 1, /* Responder identifier
661 * structure is valid
663 pi : 1; /* Precise instruction pointer
664 * structure is valid
666 } pal_uarch_check_info_t;
668 typedef union pal_mc_error_info_u {
669 u64 pmei_data;
670 pal_processor_state_info_t pme_processor;
671 pal_cache_check_info_t pme_cache;
672 pal_tlb_check_info_t pme_tlb;
673 pal_bus_check_info_t pme_bus;
674 pal_reg_file_check_info_t pme_reg_file;
675 pal_uarch_check_info_t pme_uarch;
676 } pal_mc_error_info_t;
678 #define pmci_proc_unknown_check pme_processor.uc
679 #define pmci_proc_bus_check pme_processor.bc
680 #define pmci_proc_tlb_check pme_processor.tc
681 #define pmci_proc_cache_check pme_processor.cc
682 #define pmci_proc_dynamic_state_size pme_processor.dsize
683 #define pmci_proc_gpr_valid pme_processor.gr
684 #define pmci_proc_preserved_bank0_gpr_valid pme_processor.b0
685 #define pmci_proc_preserved_bank1_gpr_valid pme_processor.b1
686 #define pmci_proc_fp_valid pme_processor.fp
687 #define pmci_proc_predicate_regs_valid pme_processor.pr
688 #define pmci_proc_branch_regs_valid pme_processor.br
689 #define pmci_proc_app_regs_valid pme_processor.ar
690 #define pmci_proc_region_regs_valid pme_processor.rr
691 #define pmci_proc_translation_regs_valid pme_processor.tr
692 #define pmci_proc_debug_regs_valid pme_processor.dr
693 #define pmci_proc_perf_counters_valid pme_processor.pc
694 #define pmci_proc_control_regs_valid pme_processor.cr
695 #define pmci_proc_machine_check_expected pme_processor.ex
696 #define pmci_proc_machine_check_corrected pme_processor.cm
697 #define pmci_proc_rse_valid pme_processor.rs
698 #define pmci_proc_machine_check_or_init pme_processor.in
699 #define pmci_proc_dynamic_state_valid pme_processor.dy
700 #define pmci_proc_operation pme_processor.op
701 #define pmci_proc_trap_lost pme_processor.tl
702 #define pmci_proc_hardware_damage pme_processor.hd
703 #define pmci_proc_uncontained_storage_damage pme_processor.us
704 #define pmci_proc_machine_check_isolated pme_processor.ci
705 #define pmci_proc_continuable pme_processor.co
706 #define pmci_proc_storage_intergrity_synced pme_processor.sy
707 #define pmci_proc_min_state_save_area_regd pme_processor.mn
708 #define pmci_proc_distinct_multiple_errors pme_processor.me
709 #define pmci_proc_pal_attempted_rendezvous pme_processor.ra
710 #define pmci_proc_pal_rendezvous_complete pme_processor.rz
713 #define pmci_cache_level pme_cache.level
714 #define pmci_cache_line_state pme_cache.mesi
715 #define pmci_cache_line_state_valid pme_cache.mv
716 #define pmci_cache_line_index pme_cache.index
717 #define pmci_cache_instr_cache_fail pme_cache.ic
718 #define pmci_cache_data_cache_fail pme_cache.dc
719 #define pmci_cache_line_tag_fail pme_cache.tl
720 #define pmci_cache_line_data_fail pme_cache.dl
721 #define pmci_cache_operation pme_cache.op
722 #define pmci_cache_way_valid pme_cache.wv
723 #define pmci_cache_target_address_valid pme_cache.tv
724 #define pmci_cache_way pme_cache.way
725 #define pmci_cache_mc pme_cache.mc
727 #define pmci_tlb_instr_translation_cache_fail pme_tlb.itc
728 #define pmci_tlb_data_translation_cache_fail pme_tlb.dtc
729 #define pmci_tlb_instr_translation_reg_fail pme_tlb.itr
730 #define pmci_tlb_data_translation_reg_fail pme_tlb.dtr
731 #define pmci_tlb_translation_reg_slot pme_tlb.tr_slot
732 #define pmci_tlb_mc pme_tlb.mc
734 #define pmci_bus_status_info pme_bus.bsi
735 #define pmci_bus_req_address_valid pme_bus.rq
736 #define pmci_bus_resp_address_valid pme_bus.rp
737 #define pmci_bus_target_address_valid pme_bus.tv
738 #define pmci_bus_error_severity pme_bus.sev
739 #define pmci_bus_transaction_type pme_bus.type
740 #define pmci_bus_cache_cache_transfer pme_bus.cc
741 #define pmci_bus_transaction_size pme_bus.size
742 #define pmci_bus_internal_error pme_bus.ib
743 #define pmci_bus_external_error pme_bus.eb
744 #define pmci_bus_mc pme_bus.mc
747 * NOTE: this min_state_save area struct only includes the 1KB
748 * architectural state save area. The other 3 KB is scratch space
749 * for PAL.
752 typedef struct pal_min_state_area_s {
753 u64 pmsa_nat_bits; /* nat bits for saved GRs */
754 u64 pmsa_gr[15]; /* GR1 - GR15 */
755 u64 pmsa_bank0_gr[16]; /* GR16 - GR31 */
756 u64 pmsa_bank1_gr[16]; /* GR16 - GR31 */
757 u64 pmsa_pr; /* predicate registers */
758 u64 pmsa_br0; /* branch register 0 */
759 u64 pmsa_rsc; /* ar.rsc */
760 u64 pmsa_iip; /* cr.iip */
761 u64 pmsa_ipsr; /* cr.ipsr */
762 u64 pmsa_ifs; /* cr.ifs */
763 u64 pmsa_xip; /* previous iip */
764 u64 pmsa_xpsr; /* previous psr */
765 u64 pmsa_xfs; /* previous ifs */
766 u64 pmsa_br1; /* branch register 1 */
767 u64 pmsa_reserved[70]; /* pal_min_state_area should total to 1KB */
768 } pal_min_state_area_t;
771 struct ia64_pal_retval {
773 * A zero status value indicates call completed without error.
774 * A negative status value indicates reason of call failure.
775 * A positive status value indicates success but an
776 * informational value should be printed (e.g., "reboot for
777 * change to take effect").
779 s64 status;
780 u64 v0;
781 u64 v1;
782 u64 v2;
786 * Note: Currently unused PAL arguments are generally labeled
787 * "reserved" so the value specified in the PAL documentation
788 * (generally 0) MUST be passed. Reserved parameters are not optional
789 * parameters.
791 extern struct ia64_pal_retval ia64_pal_call_static (u64, u64, u64, u64);
792 extern struct ia64_pal_retval ia64_pal_call_stacked (u64, u64, u64, u64);
793 extern struct ia64_pal_retval ia64_pal_call_phys_static (u64, u64, u64, u64);
794 extern struct ia64_pal_retval ia64_pal_call_phys_stacked (u64, u64, u64, u64);
795 extern void ia64_save_scratch_fpregs (struct ia64_fpreg *);
796 extern void ia64_load_scratch_fpregs (struct ia64_fpreg *);
798 #define PAL_CALL(iprv,a0,a1,a2,a3) do { \
799 struct ia64_fpreg fr[6]; \
800 ia64_save_scratch_fpregs(fr); \
801 iprv = ia64_pal_call_static(a0, a1, a2, a3); \
802 ia64_load_scratch_fpregs(fr); \
803 } while (0)
805 #define PAL_CALL_STK(iprv,a0,a1,a2,a3) do { \
806 struct ia64_fpreg fr[6]; \
807 ia64_save_scratch_fpregs(fr); \
808 iprv = ia64_pal_call_stacked(a0, a1, a2, a3); \
809 ia64_load_scratch_fpregs(fr); \
810 } while (0)
812 #define PAL_CALL_PHYS(iprv,a0,a1,a2,a3) do { \
813 struct ia64_fpreg fr[6]; \
814 ia64_save_scratch_fpregs(fr); \
815 iprv = ia64_pal_call_phys_static(a0, a1, a2, a3); \
816 ia64_load_scratch_fpregs(fr); \
817 } while (0)
819 #define PAL_CALL_PHYS_STK(iprv,a0,a1,a2,a3) do { \
820 struct ia64_fpreg fr[6]; \
821 ia64_save_scratch_fpregs(fr); \
822 iprv = ia64_pal_call_phys_stacked(a0, a1, a2, a3); \
823 ia64_load_scratch_fpregs(fr); \
824 } while (0)
826 typedef int (*ia64_pal_handler) (u64, ...);
827 extern ia64_pal_handler ia64_pal;
828 extern void ia64_pal_handler_init (void *);
830 extern ia64_pal_handler ia64_pal;
832 extern pal_cache_config_info_t l0d_cache_config_info;
833 extern pal_cache_config_info_t l0i_cache_config_info;
834 extern pal_cache_config_info_t l1_cache_config_info;
835 extern pal_cache_config_info_t l2_cache_config_info;
837 extern pal_cache_protection_info_t l0d_cache_protection_info;
838 extern pal_cache_protection_info_t l0i_cache_protection_info;
839 extern pal_cache_protection_info_t l1_cache_protection_info;
840 extern pal_cache_protection_info_t l2_cache_protection_info;
842 extern pal_cache_config_info_t pal_cache_config_info_get(pal_cache_level_t,
843 pal_cache_type_t);
845 extern pal_cache_protection_info_t pal_cache_protection_info_get(pal_cache_level_t,
846 pal_cache_type_t);
849 extern void pal_error(int);
852 /* Useful wrappers for the current list of pal procedures */
854 typedef union pal_bus_features_u {
855 u64 pal_bus_features_val;
856 struct {
857 u64 pbf_reserved1 : 29;
858 u64 pbf_req_bus_parking : 1;
859 u64 pbf_bus_lock_mask : 1;
860 u64 pbf_enable_half_xfer_rate : 1;
861 u64 pbf_reserved2 : 20;
862 u64 pbf_enable_shared_line_replace : 1;
863 u64 pbf_enable_exclusive_line_replace : 1;
864 u64 pbf_disable_xaction_queueing : 1;
865 u64 pbf_disable_resp_err_check : 1;
866 u64 pbf_disable_berr_check : 1;
867 u64 pbf_disable_bus_req_internal_err_signal : 1;
868 u64 pbf_disable_bus_req_berr_signal : 1;
869 u64 pbf_disable_bus_init_event_check : 1;
870 u64 pbf_disable_bus_init_event_signal : 1;
871 u64 pbf_disable_bus_addr_err_check : 1;
872 u64 pbf_disable_bus_addr_err_signal : 1;
873 u64 pbf_disable_bus_data_err_check : 1;
874 } pal_bus_features_s;
875 } pal_bus_features_u_t;
877 extern void pal_bus_features_print (u64);
879 /* Provide information about configurable processor bus features */
880 static inline s64
881 ia64_pal_bus_get_features (pal_bus_features_u_t *features_avail,
882 pal_bus_features_u_t *features_status,
883 pal_bus_features_u_t *features_control)
885 struct ia64_pal_retval iprv;
886 PAL_CALL_PHYS(iprv, PAL_BUS_GET_FEATURES, 0, 0, 0);
887 if (features_avail)
888 features_avail->pal_bus_features_val = iprv.v0;
889 if (features_status)
890 features_status->pal_bus_features_val = iprv.v1;
891 if (features_control)
892 features_control->pal_bus_features_val = iprv.v2;
893 return iprv.status;
896 /* Enables/disables specific processor bus features */
897 static inline s64
898 ia64_pal_bus_set_features (pal_bus_features_u_t feature_select)
900 struct ia64_pal_retval iprv;
901 PAL_CALL_PHYS(iprv, PAL_BUS_SET_FEATURES, feature_select.pal_bus_features_val, 0, 0);
902 return iprv.status;
905 /* Get detailed cache information */
906 static inline s64
907 ia64_pal_cache_config_info (u64 cache_level, u64 cache_type, pal_cache_config_info_t *conf)
909 struct ia64_pal_retval iprv;
911 PAL_CALL(iprv, PAL_CACHE_INFO, cache_level, cache_type, 0);
913 if (iprv.status == 0) {
914 conf->pcci_status = iprv.status;
915 conf->pcci_info_1.pcci1_data = iprv.v0;
916 conf->pcci_info_2.pcci2_data = iprv.v1;
917 conf->pcci_reserved = iprv.v2;
919 return iprv.status;
923 /* Get detailed cche protection information */
924 static inline s64
925 ia64_pal_cache_prot_info (u64 cache_level, u64 cache_type, pal_cache_protection_info_t *prot)
927 struct ia64_pal_retval iprv;
929 PAL_CALL(iprv, PAL_CACHE_PROT_INFO, cache_level, cache_type, 0);
931 if (iprv.status == 0) {
932 prot->pcpi_status = iprv.status;
933 prot->pcp_info[0].pcpi_data = iprv.v0 & 0xffffffff;
934 prot->pcp_info[1].pcpi_data = iprv.v0 >> 32;
935 prot->pcp_info[2].pcpi_data = iprv.v1 & 0xffffffff;
936 prot->pcp_info[3].pcpi_data = iprv.v1 >> 32;
937 prot->pcp_info[4].pcpi_data = iprv.v2 & 0xffffffff;
938 prot->pcp_info[5].pcpi_data = iprv.v2 >> 32;
940 return iprv.status;
944 * Flush the processor instruction or data caches. *PROGRESS must be
945 * initialized to zero before calling this for the first time..
947 static inline s64
948 ia64_pal_cache_flush (u64 cache_type, u64 invalidate, u64 *progress, u64 *vector)
950 struct ia64_pal_retval iprv;
951 PAL_CALL(iprv, PAL_CACHE_FLUSH, cache_type, invalidate, *progress);
952 if (vector)
953 *vector = iprv.v0;
954 *progress = iprv.v1;
955 return iprv.status;
959 /* Initialize the processor controlled caches */
960 static inline s64
961 ia64_pal_cache_init (u64 level, u64 cache_type, u64 rest)
963 struct ia64_pal_retval iprv;
964 PAL_CALL(iprv, PAL_CACHE_INIT, level, cache_type, rest);
965 return iprv.status;
968 /* Initialize the tags and data of a data or unified cache line of
969 * processor controlled cache to known values without the availability
970 * of backing memory.
972 static inline s64
973 ia64_pal_cache_line_init (u64 physical_addr, u64 data_value)
975 struct ia64_pal_retval iprv;
976 PAL_CALL(iprv, PAL_CACHE_LINE_INIT, physical_addr, data_value, 0);
977 return iprv.status;
981 /* Read the data and tag of a processor controlled cache line for diags */
982 static inline s64
983 ia64_pal_cache_read (pal_cache_line_id_u_t line_id, u64 physical_addr)
985 struct ia64_pal_retval iprv;
986 PAL_CALL_PHYS_STK(iprv, PAL_CACHE_READ, line_id.pclid_data,
987 physical_addr, 0);
988 return iprv.status;
991 /* Return summary information about the hierarchy of caches controlled by the processor */
992 static inline long ia64_pal_cache_summary(unsigned long *cache_levels,
993 unsigned long *unique_caches)
995 struct ia64_pal_retval iprv;
996 PAL_CALL(iprv, PAL_CACHE_SUMMARY, 0, 0, 0);
997 if (cache_levels)
998 *cache_levels = iprv.v0;
999 if (unique_caches)
1000 *unique_caches = iprv.v1;
1001 return iprv.status;
1004 /* Write the data and tag of a processor-controlled cache line for diags */
1005 static inline s64
1006 ia64_pal_cache_write (pal_cache_line_id_u_t line_id, u64 physical_addr, u64 data)
1008 struct ia64_pal_retval iprv;
1009 PAL_CALL_PHYS_STK(iprv, PAL_CACHE_WRITE, line_id.pclid_data,
1010 physical_addr, data);
1011 return iprv.status;
1015 /* Return the parameters needed to copy relocatable PAL procedures from ROM to memory */
1016 static inline s64
1017 ia64_pal_copy_info (u64 copy_type, u64 num_procs, u64 num_iopics,
1018 u64 *buffer_size, u64 *buffer_align)
1020 struct ia64_pal_retval iprv;
1021 PAL_CALL(iprv, PAL_COPY_INFO, copy_type, num_procs, num_iopics);
1022 if (buffer_size)
1023 *buffer_size = iprv.v0;
1024 if (buffer_align)
1025 *buffer_align = iprv.v1;
1026 return iprv.status;
1029 /* Copy relocatable PAL procedures from ROM to memory */
1030 static inline s64
1031 ia64_pal_copy_pal (u64 target_addr, u64 alloc_size, u64 processor, u64 *pal_proc_offset)
1033 struct ia64_pal_retval iprv;
1034 PAL_CALL(iprv, PAL_COPY_PAL, target_addr, alloc_size, processor);
1035 if (pal_proc_offset)
1036 *pal_proc_offset = iprv.v0;
1037 return iprv.status;
1040 /* Return the number of instruction and data debug register pairs */
1041 static inline long ia64_pal_debug_info(unsigned long *inst_regs,
1042 unsigned long *data_regs)
1044 struct ia64_pal_retval iprv;
1045 PAL_CALL(iprv, PAL_DEBUG_INFO, 0, 0, 0);
1046 if (inst_regs)
1047 *inst_regs = iprv.v0;
1048 if (data_regs)
1049 *data_regs = iprv.v1;
1051 return iprv.status;
1054 #ifdef TBD
1055 /* Switch from IA64-system environment to IA-32 system environment */
1056 static inline s64
1057 ia64_pal_enter_ia32_env (ia32_env1, ia32_env2, ia32_env3)
1059 struct ia64_pal_retval iprv;
1060 PAL_CALL(iprv, PAL_ENTER_IA_32_ENV, ia32_env1, ia32_env2, ia32_env3);
1061 return iprv.status;
1063 #endif
1065 /* Get unique geographical address of this processor on its bus */
1066 static inline s64
1067 ia64_pal_fixed_addr (u64 *global_unique_addr)
1069 struct ia64_pal_retval iprv;
1070 PAL_CALL(iprv, PAL_FIXED_ADDR, 0, 0, 0);
1071 if (global_unique_addr)
1072 *global_unique_addr = iprv.v0;
1073 return iprv.status;
1076 /* Get base frequency of the platform if generated by the processor */
1077 static inline long ia64_pal_freq_base(unsigned long *platform_base_freq)
1079 struct ia64_pal_retval iprv;
1080 PAL_CALL(iprv, PAL_FREQ_BASE, 0, 0, 0);
1081 if (platform_base_freq)
1082 *platform_base_freq = iprv.v0;
1083 return iprv.status;
1087 * Get the ratios for processor frequency, bus frequency and interval timer to
1088 * to base frequency of the platform
1090 static inline s64
1091 ia64_pal_freq_ratios (struct pal_freq_ratio *proc_ratio, struct pal_freq_ratio *bus_ratio,
1092 struct pal_freq_ratio *itc_ratio)
1094 struct ia64_pal_retval iprv;
1095 PAL_CALL(iprv, PAL_FREQ_RATIOS, 0, 0, 0);
1096 if (proc_ratio)
1097 *(u64 *)proc_ratio = iprv.v0;
1098 if (bus_ratio)
1099 *(u64 *)bus_ratio = iprv.v1;
1100 if (itc_ratio)
1101 *(u64 *)itc_ratio = iprv.v2;
1102 return iprv.status;
1106 * Get the current hardware resource sharing policy of the processor
1108 static inline s64
1109 ia64_pal_get_hw_policy (u64 proc_num, u64 *cur_policy, u64 *num_impacted,
1110 u64 *la)
1112 struct ia64_pal_retval iprv;
1113 PAL_CALL(iprv, PAL_GET_HW_POLICY, proc_num, 0, 0);
1114 if (cur_policy)
1115 *cur_policy = iprv.v0;
1116 if (num_impacted)
1117 *num_impacted = iprv.v1;
1118 if (la)
1119 *la = iprv.v2;
1120 return iprv.status;
1123 /* Make the processor enter HALT or one of the implementation dependent low
1124 * power states where prefetching and execution are suspended and cache and
1125 * TLB coherency is not maintained.
1127 static inline s64
1128 ia64_pal_halt (u64 halt_state)
1130 struct ia64_pal_retval iprv;
1131 PAL_CALL(iprv, PAL_HALT, halt_state, 0, 0);
1132 return iprv.status;
1135 typedef union pal_power_mgmt_info_u {
1136 u64 ppmi_data;
1137 struct {
1138 u64 exit_latency : 16,
1139 entry_latency : 16,
1140 power_consumption : 28,
1141 im : 1,
1142 co : 1,
1143 reserved : 2;
1144 } pal_power_mgmt_info_s;
1145 } pal_power_mgmt_info_u_t;
1147 /* Return information about processor's optional power management capabilities. */
1148 static inline s64
1149 ia64_pal_halt_info (pal_power_mgmt_info_u_t *power_buf)
1151 struct ia64_pal_retval iprv;
1152 PAL_CALL_STK(iprv, PAL_HALT_INFO, (unsigned long) power_buf, 0, 0);
1153 return iprv.status;
1156 /* Get the current P-state information */
1157 static inline s64
1158 ia64_pal_get_pstate (u64 *pstate_index, unsigned long type)
1160 struct ia64_pal_retval iprv;
1161 PAL_CALL_STK(iprv, PAL_GET_PSTATE, type, 0, 0);
1162 *pstate_index = iprv.v0;
1163 return iprv.status;
1166 /* Set the P-state */
1167 static inline s64
1168 ia64_pal_set_pstate (u64 pstate_index)
1170 struct ia64_pal_retval iprv;
1171 PAL_CALL_STK(iprv, PAL_SET_PSTATE, pstate_index, 0, 0);
1172 return iprv.status;
1175 /* Processor branding information*/
1176 static inline s64
1177 ia64_pal_get_brand_info (char *brand_info)
1179 struct ia64_pal_retval iprv;
1180 PAL_CALL_STK(iprv, PAL_BRAND_INFO, 0, (u64)brand_info, 0);
1181 return iprv.status;
1184 /* Cause the processor to enter LIGHT HALT state, where prefetching and execution are
1185 * suspended, but cache and TLB coherency is maintained.
1187 static inline s64
1188 ia64_pal_halt_light (void)
1190 struct ia64_pal_retval iprv;
1191 PAL_CALL(iprv, PAL_HALT_LIGHT, 0, 0, 0);
1192 return iprv.status;
1195 /* Clear all the processor error logging registers and reset the indicator that allows
1196 * the error logging registers to be written. This procedure also checks the pending
1197 * machine check bit and pending INIT bit and reports their states.
1199 static inline s64
1200 ia64_pal_mc_clear_log (u64 *pending_vector)
1202 struct ia64_pal_retval iprv;
1203 PAL_CALL(iprv, PAL_MC_CLEAR_LOG, 0, 0, 0);
1204 if (pending_vector)
1205 *pending_vector = iprv.v0;
1206 return iprv.status;
1209 /* Ensure that all outstanding transactions in a processor are completed or that any
1210 * MCA due to thes outstanding transaction is taken.
1212 static inline s64
1213 ia64_pal_mc_drain (void)
1215 struct ia64_pal_retval iprv;
1216 PAL_CALL(iprv, PAL_MC_DRAIN, 0, 0, 0);
1217 return iprv.status;
1220 /* Return the machine check dynamic processor state */
1221 static inline s64
1222 ia64_pal_mc_dynamic_state (u64 info_type, u64 dy_buffer, u64 *size)
1224 struct ia64_pal_retval iprv;
1225 PAL_CALL(iprv, PAL_MC_DYNAMIC_STATE, info_type, dy_buffer, 0);
1226 if (size)
1227 *size = iprv.v0;
1228 return iprv.status;
1231 /* Return processor machine check information */
1232 static inline s64
1233 ia64_pal_mc_error_info (u64 info_index, u64 type_index, u64 *size, u64 *error_info)
1235 struct ia64_pal_retval iprv;
1236 PAL_CALL(iprv, PAL_MC_ERROR_INFO, info_index, type_index, 0);
1237 if (size)
1238 *size = iprv.v0;
1239 if (error_info)
1240 *error_info = iprv.v1;
1241 return iprv.status;
1244 /* Injects the requested processor error or returns info on
1245 * supported injection capabilities for current processor implementation
1247 static inline s64
1248 ia64_pal_mc_error_inject_phys (u64 err_type_info, u64 err_struct_info,
1249 u64 err_data_buffer, u64 *capabilities, u64 *resources)
1251 struct ia64_pal_retval iprv;
1252 PAL_CALL_PHYS_STK(iprv, PAL_MC_ERROR_INJECT, err_type_info,
1253 err_struct_info, err_data_buffer);
1254 if (capabilities)
1255 *capabilities= iprv.v0;
1256 if (resources)
1257 *resources= iprv.v1;
1258 return iprv.status;
1261 static inline s64
1262 ia64_pal_mc_error_inject_virt (u64 err_type_info, u64 err_struct_info,
1263 u64 err_data_buffer, u64 *capabilities, u64 *resources)
1265 struct ia64_pal_retval iprv;
1266 PAL_CALL_STK(iprv, PAL_MC_ERROR_INJECT, err_type_info,
1267 err_struct_info, err_data_buffer);
1268 if (capabilities)
1269 *capabilities= iprv.v0;
1270 if (resources)
1271 *resources= iprv.v1;
1272 return iprv.status;
1275 /* Inform PALE_CHECK whether a machine check is expected so that PALE_CHECK willnot
1276 * attempt to correct any expected machine checks.
1278 static inline s64
1279 ia64_pal_mc_expected (u64 expected, u64 *previous)
1281 struct ia64_pal_retval iprv;
1282 PAL_CALL(iprv, PAL_MC_EXPECTED, expected, 0, 0);
1283 if (previous)
1284 *previous = iprv.v0;
1285 return iprv.status;
1288 typedef union pal_hw_tracking_u {
1289 u64 pht_data;
1290 struct {
1291 u64 itc :4, /* Instruction cache tracking */
1292 dct :4, /* Date cache tracking */
1293 itt :4, /* Instruction TLB tracking */
1294 ddt :4, /* Data TLB tracking */
1295 reserved:48;
1296 } pal_hw_tracking_s;
1297 } pal_hw_tracking_u_t;
1300 * Hardware tracking status.
1302 static inline s64
1303 ia64_pal_mc_hw_tracking (u64 *status)
1305 struct ia64_pal_retval iprv;
1306 PAL_CALL(iprv, PAL_MC_HW_TRACKING, 0, 0, 0);
1307 if (status)
1308 *status = iprv.v0;
1309 return iprv.status;
1312 /* Register a platform dependent location with PAL to which it can save
1313 * minimal processor state in the event of a machine check or initialization
1314 * event.
1316 static inline s64
1317 ia64_pal_mc_register_mem (u64 physical_addr, u64 size, u64 *req_size)
1319 struct ia64_pal_retval iprv;
1320 PAL_CALL(iprv, PAL_MC_REGISTER_MEM, physical_addr, size, 0);
1321 if (req_size)
1322 *req_size = iprv.v0;
1323 return iprv.status;
1326 /* Restore minimal architectural processor state, set CMC interrupt if necessary
1327 * and resume execution
1329 static inline s64
1330 ia64_pal_mc_resume (u64 set_cmci, u64 save_ptr)
1332 struct ia64_pal_retval iprv;
1333 PAL_CALL(iprv, PAL_MC_RESUME, set_cmci, save_ptr, 0);
1334 return iprv.status;
1337 /* Return the memory attributes implemented by the processor */
1338 static inline s64
1339 ia64_pal_mem_attrib (u64 *mem_attrib)
1341 struct ia64_pal_retval iprv;
1342 PAL_CALL(iprv, PAL_MEM_ATTRIB, 0, 0, 0);
1343 if (mem_attrib)
1344 *mem_attrib = iprv.v0 & 0xff;
1345 return iprv.status;
1348 /* Return the amount of memory needed for second phase of processor
1349 * self-test and the required alignment of memory.
1351 static inline s64
1352 ia64_pal_mem_for_test (u64 *bytes_needed, u64 *alignment)
1354 struct ia64_pal_retval iprv;
1355 PAL_CALL(iprv, PAL_MEM_FOR_TEST, 0, 0, 0);
1356 if (bytes_needed)
1357 *bytes_needed = iprv.v0;
1358 if (alignment)
1359 *alignment = iprv.v1;
1360 return iprv.status;
1363 typedef union pal_perf_mon_info_u {
1364 u64 ppmi_data;
1365 struct {
1366 u64 generic : 8,
1367 width : 8,
1368 cycles : 8,
1369 retired : 8,
1370 reserved : 32;
1371 } pal_perf_mon_info_s;
1372 } pal_perf_mon_info_u_t;
1374 /* Return the performance monitor information about what can be counted
1375 * and how to configure the monitors to count the desired events.
1377 static inline s64
1378 ia64_pal_perf_mon_info (u64 *pm_buffer, pal_perf_mon_info_u_t *pm_info)
1380 struct ia64_pal_retval iprv;
1381 PAL_CALL(iprv, PAL_PERF_MON_INFO, (unsigned long) pm_buffer, 0, 0);
1382 if (pm_info)
1383 pm_info->ppmi_data = iprv.v0;
1384 return iprv.status;
1387 /* Specifies the physical address of the processor interrupt block
1388 * and I/O port space.
1390 static inline s64
1391 ia64_pal_platform_addr (u64 type, u64 physical_addr)
1393 struct ia64_pal_retval iprv;
1394 PAL_CALL(iprv, PAL_PLATFORM_ADDR, type, physical_addr, 0);
1395 return iprv.status;
1398 /* Set the SAL PMI entrypoint in memory */
1399 static inline s64
1400 ia64_pal_pmi_entrypoint (u64 sal_pmi_entry_addr)
1402 struct ia64_pal_retval iprv;
1403 PAL_CALL(iprv, PAL_PMI_ENTRYPOINT, sal_pmi_entry_addr, 0, 0);
1404 return iprv.status;
1407 struct pal_features_s;
1408 /* Provide information about configurable processor features */
1409 static inline s64
1410 ia64_pal_proc_get_features (u64 *features_avail,
1411 u64 *features_status,
1412 u64 *features_control,
1413 u64 features_set)
1415 struct ia64_pal_retval iprv;
1416 PAL_CALL_PHYS(iprv, PAL_PROC_GET_FEATURES, 0, features_set, 0);
1417 if (iprv.status == 0) {
1418 *features_avail = iprv.v0;
1419 *features_status = iprv.v1;
1420 *features_control = iprv.v2;
1422 return iprv.status;
1425 /* Enable/disable processor dependent features */
1426 static inline s64
1427 ia64_pal_proc_set_features (u64 feature_select)
1429 struct ia64_pal_retval iprv;
1430 PAL_CALL_PHYS(iprv, PAL_PROC_SET_FEATURES, feature_select, 0, 0);
1431 return iprv.status;
1435 * Put everything in a struct so we avoid the global offset table whenever
1436 * possible.
1438 typedef struct ia64_ptce_info_s {
1439 unsigned long base;
1440 u32 count[2];
1441 u32 stride[2];
1442 } ia64_ptce_info_t;
1444 /* Return the information required for the architected loop used to purge
1445 * (initialize) the entire TC
1447 static inline s64
1448 ia64_get_ptce (ia64_ptce_info_t *ptce)
1450 struct ia64_pal_retval iprv;
1452 if (!ptce)
1453 return -1;
1455 PAL_CALL(iprv, PAL_PTCE_INFO, 0, 0, 0);
1456 if (iprv.status == 0) {
1457 ptce->base = iprv.v0;
1458 ptce->count[0] = iprv.v1 >> 32;
1459 ptce->count[1] = iprv.v1 & 0xffffffff;
1460 ptce->stride[0] = iprv.v2 >> 32;
1461 ptce->stride[1] = iprv.v2 & 0xffffffff;
1463 return iprv.status;
1466 /* Return info about implemented application and control registers. */
1467 static inline s64
1468 ia64_pal_register_info (u64 info_request, u64 *reg_info_1, u64 *reg_info_2)
1470 struct ia64_pal_retval iprv;
1471 PAL_CALL(iprv, PAL_REGISTER_INFO, info_request, 0, 0);
1472 if (reg_info_1)
1473 *reg_info_1 = iprv.v0;
1474 if (reg_info_2)
1475 *reg_info_2 = iprv.v1;
1476 return iprv.status;
1479 typedef union pal_hints_u {
1480 unsigned long ph_data;
1481 struct {
1482 unsigned long si : 1,
1483 li : 1,
1484 reserved : 62;
1485 } pal_hints_s;
1486 } pal_hints_u_t;
1488 /* Return information about the register stack and RSE for this processor
1489 * implementation.
1491 static inline long ia64_pal_rse_info(unsigned long *num_phys_stacked,
1492 pal_hints_u_t *hints)
1494 struct ia64_pal_retval iprv;
1495 PAL_CALL(iprv, PAL_RSE_INFO, 0, 0, 0);
1496 if (num_phys_stacked)
1497 *num_phys_stacked = iprv.v0;
1498 if (hints)
1499 hints->ph_data = iprv.v1;
1500 return iprv.status;
1504 * Set the current hardware resource sharing policy of the processor
1506 static inline s64
1507 ia64_pal_set_hw_policy (u64 policy)
1509 struct ia64_pal_retval iprv;
1510 PAL_CALL(iprv, PAL_SET_HW_POLICY, policy, 0, 0);
1511 return iprv.status;
1514 /* Cause the processor to enter SHUTDOWN state, where prefetching and execution are
1515 * suspended, but cause cache and TLB coherency to be maintained.
1516 * This is usually called in IA-32 mode.
1518 static inline s64
1519 ia64_pal_shutdown (void)
1521 struct ia64_pal_retval iprv;
1522 PAL_CALL(iprv, PAL_SHUTDOWN, 0, 0, 0);
1523 return iprv.status;
1526 /* Perform the second phase of processor self-test. */
1527 static inline s64
1528 ia64_pal_test_proc (u64 test_addr, u64 test_size, u64 attributes, u64 *self_test_state)
1530 struct ia64_pal_retval iprv;
1531 PAL_CALL(iprv, PAL_TEST_PROC, test_addr, test_size, attributes);
1532 if (self_test_state)
1533 *self_test_state = iprv.v0;
1534 return iprv.status;
1537 typedef union pal_version_u {
1538 u64 pal_version_val;
1539 struct {
1540 u64 pv_pal_b_rev : 8;
1541 u64 pv_pal_b_model : 8;
1542 u64 pv_reserved1 : 8;
1543 u64 pv_pal_vendor : 8;
1544 u64 pv_pal_a_rev : 8;
1545 u64 pv_pal_a_model : 8;
1546 u64 pv_reserved2 : 16;
1547 } pal_version_s;
1548 } pal_version_u_t;
1552 * Return PAL version information. While the documentation states that
1553 * PAL_VERSION can be called in either physical or virtual mode, some
1554 * implementations only allow physical calls. We don't call it very often,
1555 * so the overhead isn't worth eliminating.
1557 static inline s64
1558 ia64_pal_version (pal_version_u_t *pal_min_version, pal_version_u_t *pal_cur_version)
1560 struct ia64_pal_retval iprv;
1561 PAL_CALL_PHYS(iprv, PAL_VERSION, 0, 0, 0);
1562 if (pal_min_version)
1563 pal_min_version->pal_version_val = iprv.v0;
1565 if (pal_cur_version)
1566 pal_cur_version->pal_version_val = iprv.v1;
1568 return iprv.status;
1571 typedef union pal_tc_info_u {
1572 u64 pti_val;
1573 struct {
1574 u64 num_sets : 8,
1575 associativity : 8,
1576 num_entries : 16,
1577 pf : 1,
1578 unified : 1,
1579 reduce_tr : 1,
1580 reserved : 29;
1581 } pal_tc_info_s;
1582 } pal_tc_info_u_t;
1584 #define tc_reduce_tr pal_tc_info_s.reduce_tr
1585 #define tc_unified pal_tc_info_s.unified
1586 #define tc_pf pal_tc_info_s.pf
1587 #define tc_num_entries pal_tc_info_s.num_entries
1588 #define tc_associativity pal_tc_info_s.associativity
1589 #define tc_num_sets pal_tc_info_s.num_sets
1592 /* Return information about the virtual memory characteristics of the processor
1593 * implementation.
1595 static inline s64
1596 ia64_pal_vm_info (u64 tc_level, u64 tc_type, pal_tc_info_u_t *tc_info, u64 *tc_pages)
1598 struct ia64_pal_retval iprv;
1599 PAL_CALL(iprv, PAL_VM_INFO, tc_level, tc_type, 0);
1600 if (tc_info)
1601 tc_info->pti_val = iprv.v0;
1602 if (tc_pages)
1603 *tc_pages = iprv.v1;
1604 return iprv.status;
1607 /* Get page size information about the virtual memory characteristics of the processor
1608 * implementation.
1610 static inline s64 ia64_pal_vm_page_size(u64 *tr_pages, u64 *vw_pages)
1612 struct ia64_pal_retval iprv;
1613 PAL_CALL(iprv, PAL_VM_PAGE_SIZE, 0, 0, 0);
1614 if (tr_pages)
1615 *tr_pages = iprv.v0;
1616 if (vw_pages)
1617 *vw_pages = iprv.v1;
1618 return iprv.status;
1621 typedef union pal_vm_info_1_u {
1622 u64 pvi1_val;
1623 struct {
1624 u64 vw : 1,
1625 phys_add_size : 7,
1626 key_size : 8,
1627 max_pkr : 8,
1628 hash_tag_id : 8,
1629 max_dtr_entry : 8,
1630 max_itr_entry : 8,
1631 max_unique_tcs : 8,
1632 num_tc_levels : 8;
1633 } pal_vm_info_1_s;
1634 } pal_vm_info_1_u_t;
1636 #define PAL_MAX_PURGES 0xFFFF /* all ones is means unlimited */
1638 typedef union pal_vm_info_2_u {
1639 u64 pvi2_val;
1640 struct {
1641 u64 impl_va_msb : 8,
1642 rid_size : 8,
1643 max_purges : 16,
1644 reserved : 32;
1645 } pal_vm_info_2_s;
1646 } pal_vm_info_2_u_t;
1648 /* Get summary information about the virtual memory characteristics of the processor
1649 * implementation.
1651 static inline s64
1652 ia64_pal_vm_summary (pal_vm_info_1_u_t *vm_info_1, pal_vm_info_2_u_t *vm_info_2)
1654 struct ia64_pal_retval iprv;
1655 PAL_CALL(iprv, PAL_VM_SUMMARY, 0, 0, 0);
1656 if (vm_info_1)
1657 vm_info_1->pvi1_val = iprv.v0;
1658 if (vm_info_2)
1659 vm_info_2->pvi2_val = iprv.v1;
1660 return iprv.status;
1663 typedef union pal_vp_info_u {
1664 u64 pvi_val;
1665 struct {
1666 u64 index: 48, /* virtual feature set info */
1667 vmm_id: 16; /* feature set id */
1668 } pal_vp_info_s;
1669 } pal_vp_info_u_t;
1672 * Returns information about virtual processor features
1674 static inline s64
1675 ia64_pal_vp_info (u64 feature_set, u64 vp_buffer, u64 *vp_info, u64 *vmm_id)
1677 struct ia64_pal_retval iprv;
1678 PAL_CALL(iprv, PAL_VP_INFO, feature_set, vp_buffer, 0);
1679 if (vp_info)
1680 *vp_info = iprv.v0;
1681 if (vmm_id)
1682 *vmm_id = iprv.v1;
1683 return iprv.status;
1686 typedef union pal_itr_valid_u {
1687 u64 piv_val;
1688 struct {
1689 u64 access_rights_valid : 1,
1690 priv_level_valid : 1,
1691 dirty_bit_valid : 1,
1692 mem_attr_valid : 1,
1693 reserved : 60;
1694 } pal_tr_valid_s;
1695 } pal_tr_valid_u_t;
1697 /* Read a translation register */
1698 static inline s64
1699 ia64_pal_tr_read (u64 reg_num, u64 tr_type, u64 *tr_buffer, pal_tr_valid_u_t *tr_valid)
1701 struct ia64_pal_retval iprv;
1702 PAL_CALL_PHYS_STK(iprv, PAL_VM_TR_READ, reg_num, tr_type,(u64)ia64_tpa(tr_buffer));
1703 if (tr_valid)
1704 tr_valid->piv_val = iprv.v0;
1705 return iprv.status;
1709 * PAL_PREFETCH_VISIBILITY transaction types
1711 #define PAL_VISIBILITY_VIRTUAL 0
1712 #define PAL_VISIBILITY_PHYSICAL 1
1715 * PAL_PREFETCH_VISIBILITY return codes
1717 #define PAL_VISIBILITY_OK 1
1718 #define PAL_VISIBILITY_OK_REMOTE_NEEDED 0
1719 #define PAL_VISIBILITY_INVAL_ARG -2
1720 #define PAL_VISIBILITY_ERROR -3
1722 static inline s64
1723 ia64_pal_prefetch_visibility (s64 trans_type)
1725 struct ia64_pal_retval iprv;
1726 PAL_CALL(iprv, PAL_PREFETCH_VISIBILITY, trans_type, 0, 0);
1727 return iprv.status;
1730 /* data structure for getting information on logical to physical mappings */
1731 typedef union pal_log_overview_u {
1732 struct {
1733 u64 num_log :16, /* Total number of logical
1734 * processors on this die
1736 tpc :8, /* Threads per core */
1737 reserved3 :8, /* Reserved */
1738 cpp :8, /* Cores per processor */
1739 reserved2 :8, /* Reserved */
1740 ppid :8, /* Physical processor ID */
1741 reserved1 :8; /* Reserved */
1742 } overview_bits;
1743 u64 overview_data;
1744 } pal_log_overview_t;
1746 typedef union pal_proc_n_log_info1_u{
1747 struct {
1748 u64 tid :16, /* Thread id */
1749 reserved2 :16, /* Reserved */
1750 cid :16, /* Core id */
1751 reserved1 :16; /* Reserved */
1752 } ppli1_bits;
1753 u64 ppli1_data;
1754 } pal_proc_n_log_info1_t;
1756 typedef union pal_proc_n_log_info2_u {
1757 struct {
1758 u64 la :16, /* Logical address */
1759 reserved :48; /* Reserved */
1760 } ppli2_bits;
1761 u64 ppli2_data;
1762 } pal_proc_n_log_info2_t;
1764 typedef struct pal_logical_to_physical_s
1766 pal_log_overview_t overview;
1767 pal_proc_n_log_info1_t ppli1;
1768 pal_proc_n_log_info2_t ppli2;
1769 } pal_logical_to_physical_t;
1771 #define overview_num_log overview.overview_bits.num_log
1772 #define overview_tpc overview.overview_bits.tpc
1773 #define overview_cpp overview.overview_bits.cpp
1774 #define overview_ppid overview.overview_bits.ppid
1775 #define log1_tid ppli1.ppli1_bits.tid
1776 #define log1_cid ppli1.ppli1_bits.cid
1777 #define log2_la ppli2.ppli2_bits.la
1779 /* Get information on logical to physical processor mappings. */
1780 static inline s64
1781 ia64_pal_logical_to_phys(u64 proc_number, pal_logical_to_physical_t *mapping)
1783 struct ia64_pal_retval iprv;
1785 PAL_CALL(iprv, PAL_LOGICAL_TO_PHYSICAL, proc_number, 0, 0);
1787 if (iprv.status == PAL_STATUS_SUCCESS)
1789 mapping->overview.overview_data = iprv.v0;
1790 mapping->ppli1.ppli1_data = iprv.v1;
1791 mapping->ppli2.ppli2_data = iprv.v2;
1794 return iprv.status;
1797 typedef struct pal_cache_shared_info_s
1799 u64 num_shared;
1800 pal_proc_n_log_info1_t ppli1;
1801 pal_proc_n_log_info2_t ppli2;
1802 } pal_cache_shared_info_t;
1804 /* Get information on logical to physical processor mappings. */
1805 static inline s64
1806 ia64_pal_cache_shared_info(u64 level,
1807 u64 type,
1808 u64 proc_number,
1809 pal_cache_shared_info_t *info)
1811 struct ia64_pal_retval iprv;
1813 PAL_CALL(iprv, PAL_CACHE_SHARED_INFO, level, type, proc_number);
1815 if (iprv.status == PAL_STATUS_SUCCESS) {
1816 info->num_shared = iprv.v0;
1817 info->ppli1.ppli1_data = iprv.v1;
1818 info->ppli2.ppli2_data = iprv.v2;
1821 return iprv.status;
1823 #endif /* __ASSEMBLY__ */
1825 #endif /* _ASM_IA64_PAL_H */