Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
pal.h
Go to the documentation of this file.
1 #ifndef _ASM_IA64_PAL_H
2 #define _ASM_IA64_PAL_H
3 
4 /*
5  * Processor Abstraction Layer definitions.
6  *
7  * This is based on Intel IA-64 Architecture Software Developer's Manual rev 1.0
8  * chapter 11 IA-64 Processor Abstraction Layer
9  *
10  * Copyright (C) 1998-2001 Hewlett-Packard Co
11  * David Mosberger-Tang <[email protected]>
12  * Stephane Eranian <[email protected]>
13  * Copyright (C) 1999 VA Linux Systems
14  * Copyright (C) 1999 Walt Drummond <[email protected]>
15  * Copyright (C) 1999 Srinivasa Prasad Thirumalachar <[email protected]>
16  * Copyright (C) 2008 Silicon Graphics, Inc. (SGI)
17  *
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)
26  */
27 
28 /*
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.
32  */
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 */
67 
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 */
79 
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 */
89 
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
94 
95 #define PAL_MC_ERROR_INJECT 276 /* Injects processor error or returns injection capabilities */
96 
97 #ifndef __ASSEMBLY__
98 
99 #include <linux/types.h>
100 #include <asm/fpu.h>
101 
102 /*
103  * Data types needed to pass information into PAL procedures and
104  * interpret information returned by them.
105  */
106 
107 /* Return status from the PAL procedure */
109 
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
118  */
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 */
134 
135 
136 #define PAL_CACHE_FLUSH_INVALIDATE 1 /* Invalidate clean lines */
137 #define PAL_CACHE_FLUSH_CHK_INTRS 2 /* check for interrupts/mc while flushing */
138 
139 /* Processor cache line size in bytes */
142 /* Processor cache line state */
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 */
148 
149 typedef struct pal_freq_ratio {
150  u32 den, num; /* numerator & denominator */
152 
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 */
166  u64 pcci1_data;
168 
169 typedef union pal_cache_config_info_2_s {
170  struct {
171  u32 cache_size; /*cache size in bytes*/
172 
173 
174  u32 alias_boundary : 8, /* 39-32 aliased addr
175  * separation for max
176  * performance.
177  */
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;
186 typedef struct pal_cache_config_info_s {
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
206 
209 /* Possible values for cache attributes */
210 
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
216  */
217 
218 
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 */
224 
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
231  */
232 
233  tagprot_lsb : 6, /* Least -do- */
234  tagprot_msb : 6, /* Most Sig. tag address
235  * bit that this
236  * protection covers.
237  */
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.
244  */
247 
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
254 
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 )
260  */
261 #define PAL_CACHE_PROT_PART_DATA_TAG 3 /* Data+tag protection (data is
262  * more significant )
263  */
264 #define PAL_CACHE_PROT_PART_MAX 6
267 typedef struct pal_cache_protection_info_s {
272 
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 */
278 
279 
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.
288  */
289  way : 8, /* 23-16 way in the set
290  */
291  part : 8, /* 31-24 part of the
292  * cache
293  */
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.
301  */
302  way : 8, /* 23-16 way in the set
303  */
304  part : 8, /* 31-24 part of the
305  * cache
306  */
307  mesi : 8, /* 39-32 cache line
308  * state
309  */
310  start : 8, /* 47-40 lsb of data to
311  * invert
312  */
313  length : 8, /* 55-48 #bits to
314  * invert
315  */
316  trigger : 8; /* 63-56 Trigger error
317  * by doing a load
318  * after the write
319  */
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
345  */
346 typedef struct pal_cache_line_info_s {
347  pal_status_t pcli_status; /* Return status of the read cache line
348  * info call.
349  */
350  u64 pcli_data; /* 64-bit data, tag, protection bits .. */
351  u64 pcli_data_len; /* data length in bits */
357 /* Machine Check related crap */
359 /* Pending event status bits */
362 #define PAL_MC_PENDING_MCA (1 << 0)
363 #define PAL_MC_PENDING_INIT (1 << 1)
365 /* Error information type */
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
377  */
378 
379 #define PAL_TLB_CHECK_OP_PURGE 8
380 
381 typedef struct pal_process_state_info_s {
382  u64 reserved1 : 2,
383  rz : 1, /* PAL_CHECK processor
384  * rendezvous
385  * successful.
386  */
387 
388  ra : 1, /* PAL_CHECK attempted
389  * a rendezvous.
390  */
391  me : 1, /* Distinct multiple
392  * errors occurred
393  */
394 
395  mn : 1, /* Min. state save
396  * area has been
397  * registered with PAL
398  */
399 
400  sy : 1, /* Storage integrity
401  * synched
402  */
403 
404 
405  co : 1, /* Continuable */
406  ci : 1, /* MC isolated */
407  us : 1, /* Uncontained storage
408  * damage.
409  */
410 
411 
412  hd : 1, /* Non-essential hw
413  * lost (no loss of
414  * functionality)
415  * causing the
416  * processor to run in
417  * degraded mode.
418  */
419 
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 )
428  */
429  mi : 1, /* More information available
430  * call PAL_MC_ERROR_INFO
431  */
432  pi : 1, /* Precise instruction pointer */
433  pm : 1, /* Precise min-state save area */
434 
435  dy : 1, /* Processor dynamic
436  * state valid
437  */
438 
439 
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
449  */
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
455  */
456 
457  fp : 1, /* fp registers valid*/
458  b1 : 1, /* Preserved bank one
459  * general registers
460  * are valid
461  */
462  b0 : 1, /* Preserved bank zero
463  * general registers
464  * are valid
465  */
466  gr : 1, /* General registers
467  * are valid
468  * (excl. banked regs)
469  */
470  dsize : 16, /* size of dynamic
471  * state returned
472  * by the processor
473  */
474 
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 */
483 
485 
486 typedef struct pal_cache_check_info_s {
487  u64 op : 4, /* Type of cache
488  * operation that
489  * caused the machine
490  * check.
491  */
492  level : 2, /* Cache level */
493  reserved1 : 2,
494  dl : 1, /* Failure in data part
495  * of cache line
496  */
497  tl : 1, /* Failure in tag part
498  * of cache line
499  */
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
506  */
507  wiv : 1, /* Way field valid */
508  reserved2 : 1,
509  dp : 1, /* Data poisoned on MBE */
510  reserved3 : 6,
511  hlth : 2, /* Health indicator */
512 
513  index : 20, /* Cache line index */
514  reserved4 : 2,
515 
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
523  */
524  rq : 1, /* Requester identifier
525  * structure is valid
526  */
527  rp : 1, /* Responder identifier
528  * structure is valid
529  */
530  pi : 1; /* Precise instruction pointer
531  * structure is valid
532  */
534 
535 typedef struct pal_tlb_check_info_s {
536 
537  u64 tr_slot : 8, /* Slot# of TR where
538  * error occurred
539  */
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,
552 
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
560  */
561  rq : 1, /* Requester identifier
562  * structure is valid
563  */
564  rp : 1, /* Responder identifier
565  * structure is valid
566  */
567  pi : 1; /* Precise instruction pointer
568  * structure is valid
569  */
571 
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.
579  */
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
586  */
587  reserved2 : 22,
588 
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
596  */
597  rq : 1, /* Requester identifier
598  * structure is valid
599  */
600  rp : 1, /* Responder identifier
601  * structure is valid
602  */
603  pi : 1; /* Precise instruction pointer
604  * structure is valid
605  */
607 
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.
614  */
615  reg_num : 7, /* Register number */
616  rnv : 1, /* reg_num valid */
617  reserved2 : 38,
618 
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
627  */
629 
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.
638  */
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.
646  */
647  reserved2 : 24,
648 
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
656  */
657  rq : 1, /* Requester identifier
658  * structure is valid
659  */
660  rp : 1, /* Responder identifier
661  * structure is valid
662  */
663  pi : 1; /* Precise instruction pointer
664  * structure is valid
665  */
668 typedef union pal_mc_error_info_u {
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
711 
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
733 
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
746 /*
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.
750  */
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 */
769 
770 
771 struct ia64_pal_retval {
772  /*
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").
778  */
779  s64 status;
780  u64 v0;
781  u64 v1;
782  u64 v2;
783 };
784 
785 /*
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.
790  */
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)
818 
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)
825 
826 typedef int (*ia64_pal_handler) (u64, ...);
828 extern void ia64_pal_handler_init (void *);
829 
831 
836 
841 
849 extern void pal_error(int);
852 /* Useful wrappers for the current list of pal procedures */
854 typedef union pal_bus_features_u {
856  struct {
861  u64 pbf_reserved2 : 20;
876 
877 extern void pal_bus_features_print (u64);
878 
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)
884 {
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;
894 }
895 
896 /* Enables/disables specific processor bus features */
897 static inline s64
898 ia64_pal_bus_set_features (pal_bus_features_u_t feature_select)
899 {
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;
903 }
904 
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)
908 {
909  struct ia64_pal_retval iprv;
910 
911  PAL_CALL(iprv, PAL_CACHE_INFO, cache_level, cache_type, 0);
912 
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;
918  }
919  return iprv.status;
920 
921 }
922 
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)
926 {
927  struct ia64_pal_retval iprv;
928 
929  PAL_CALL(iprv, PAL_CACHE_PROT_INFO, cache_level, cache_type, 0);
930 
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;
939  }
940  return iprv.status;
941 }
942 
943 /*
944  * Flush the processor instruction or data caches. *PROGRESS must be
945  * initialized to zero before calling this for the first time..
946  */
947 static inline s64
948 ia64_pal_cache_flush (u64 cache_type, u64 invalidate, u64 *progress, u64 *vector)
949 {
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;
956 }
957 
958 
959 /* Initialize the processor controlled caches */
960 static inline s64
961 ia64_pal_cache_init (u64 level, u64 cache_type, u64 rest)
962 {
963  struct ia64_pal_retval iprv;
964  PAL_CALL(iprv, PAL_CACHE_INIT, level, cache_type, rest);
965  return iprv.status;
966 }
967 
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.
971  */
972 static inline s64
973 ia64_pal_cache_line_init (u64 physical_addr, u64 data_value)
974 {
975  struct ia64_pal_retval iprv;
976  PAL_CALL(iprv, PAL_CACHE_LINE_INIT, physical_addr, data_value, 0);
977  return iprv.status;
978 }
979 
980 
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)
984 {
985  struct ia64_pal_retval iprv;
987  physical_addr, 0);
988  return iprv.status;
989 }
990 
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)
994 {
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;
1002 }
1003 
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)
1007 {
1008  struct ia64_pal_retval iprv;
1010  physical_addr, data);
1011  return iprv.status;
1012 }
1013 
1014 
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)
1019 {
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;
1027 }
1028 
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)
1032 {
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;
1038 }
1039 
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)
1043 {
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;
1050 
1051  return iprv.status;
1052 }
1053 
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)
1058 {
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;
1062 }
1063 #endif
1064 
1065 /* Get unique geographical address of this processor on its bus */
1066 static inline s64
1067 ia64_pal_fixed_addr (u64 *global_unique_addr)
1068 {
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;
1074 }
1075 
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)
1078 {
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;
1084 }
1085 
1086 /*
1087  * Get the ratios for processor frequency, bus frequency and interval timer to
1088  * to base frequency of the platform
1089  */
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)
1093 {
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;
1103 }
1104 
1105 /*
1106  * Get the current hardware resource sharing policy of the processor
1107  */
1108 static inline s64
1109 ia64_pal_get_hw_policy (u64 proc_num, u64 *cur_policy, u64 *num_impacted,
1110  u64 *la)
1111 {
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;
1122 
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.
1126  */
1127 static inline s64
1128 ia64_pal_halt (u64 halt_state)
1129 {
1130  struct ia64_pal_retval iprv;
1131  PAL_CALL(iprv, PAL_HALT, halt_state, 0, 0);
1132  return iprv.status;
1133 }
1134 
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;
1146 
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)
1150 {
1151  struct ia64_pal_retval iprv;
1152  PAL_CALL_STK(iprv, PAL_HALT_INFO, (unsigned long) power_buf, 0, 0);
1153  return iprv.status;
1154 }
1155 
1156 /* Get the current P-state information */
1157 static inline s64
1158 ia64_pal_get_pstate (u64 *pstate_index, unsigned long type)
1159 {
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;
1164 }
1165 
1166 /* Set the P-state */
1167 static inline s64
1168 ia64_pal_set_pstate (u64 pstate_index)
1169 {
1170  struct ia64_pal_retval iprv;
1171  PAL_CALL_STK(iprv, PAL_SET_PSTATE, pstate_index, 0, 0);
1172  return iprv.status;
1173 }
1174 
1175 /* Processor branding information*/
1176 static inline s64
1177 ia64_pal_get_brand_info (char *brand_info)
1178 {
1179  struct ia64_pal_retval iprv;
1180  PAL_CALL_STK(iprv, PAL_BRAND_INFO, 0, (u64)brand_info, 0);
1181  return iprv.status;
1182 }
1183 
1184 /* Cause the processor to enter LIGHT HALT state, where prefetching and execution are
1185  * suspended, but cache and TLB coherency is maintained.
1186  */
1187 static inline s64
1188 ia64_pal_halt_light (void)
1189 {
1190  struct ia64_pal_retval iprv;
1191  PAL_CALL(iprv, PAL_HALT_LIGHT, 0, 0, 0);
1192  return iprv.status;
1193 }
1194 
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.
1198  */
1199 static inline s64
1200 ia64_pal_mc_clear_log (u64 *pending_vector)
1201 {
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;
1207 }
1208 
1209 /* Ensure that all outstanding transactions in a processor are completed or that any
1210  * MCA due to thes outstanding transaction is taken.
1211  */
1212 static inline s64
1213 ia64_pal_mc_drain (void)
1214 {
1215  struct ia64_pal_retval iprv;
1216  PAL_CALL(iprv, PAL_MC_DRAIN, 0, 0, 0);
1217  return iprv.status;
1218 }
1219 
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)
1223 {
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;
1229 }
1230 
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)
1234 {
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;
1242 }
1243 
1244 /* Injects the requested processor error or returns info on
1245  * supported injection capabilities for current processor implementation
1246  */
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)
1250 {
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;
1259 }
1260 
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)
1264 {
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.
1277  */
1278 static inline s64
1279 ia64_pal_mc_expected (u64 expected, u64 *previous)
1280 {
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;
1286 }
1287 
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;
1298 
1299 /*
1300  * Hardware tracking status.
1301  */
1302 static inline s64
1303 ia64_pal_mc_hw_tracking (u64 *status)
1304 {
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;
1310 }
1311 
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.
1315  */
1316 static inline s64
1317 ia64_pal_mc_register_mem (u64 physical_addr, u64 size, u64 *req_size)
1318 {
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;
1324 }
1325 
1326 /* Restore minimal architectural processor state, set CMC interrupt if necessary
1327  * and resume execution
1328  */
1329 static inline s64
1330 ia64_pal_mc_resume (u64 set_cmci, u64 save_ptr)
1331 {
1332  struct ia64_pal_retval iprv;
1333  PAL_CALL(iprv, PAL_MC_RESUME, set_cmci, save_ptr, 0);
1334  return iprv.status;
1335 }
1336 
1337 /* Return the memory attributes implemented by the processor */
1338 static inline s64
1339 ia64_pal_mem_attrib (u64 *mem_attrib)
1340 {
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;
1346 }
1347 
1348 /* Return the amount of memory needed for second phase of processor
1349  * self-test and the required alignment of memory.
1350  */
1351 static inline s64
1352 ia64_pal_mem_for_test (u64 *bytes_needed, u64 *alignment)
1353 {
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;
1361 }
1362 
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;
1373 
1374 /* Return the performance monitor information about what can be counted
1375  * and how to configure the monitors to count the desired events.
1376  */
1377 static inline s64
1378 ia64_pal_perf_mon_info (u64 *pm_buffer, pal_perf_mon_info_u_t *pm_info)
1379 {
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;
1385 }
1386 
1387 /* Specifies the physical address of the processor interrupt block
1388  * and I/O port space.
1389  */
1390 static inline s64
1391 ia64_pal_platform_addr (u64 type, u64 physical_addr)
1392 {
1393  struct ia64_pal_retval iprv;
1394  PAL_CALL(iprv, PAL_PLATFORM_ADDR, type, physical_addr, 0);
1395  return iprv.status;
1396 }
1397 
1398 /* Set the SAL PMI entrypoint in memory */
1399 static inline s64
1400 ia64_pal_pmi_entrypoint (u64 sal_pmi_entry_addr)
1401 {
1402  struct ia64_pal_retval iprv;
1403  PAL_CALL(iprv, PAL_PMI_ENTRYPOINT, sal_pmi_entry_addr, 0, 0);
1404  return iprv.status;
1405 }
1406 
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)
1414 {
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;
1421  }
1422  return iprv.status;
1425 /* Enable/disable processor dependent features */
1426 static inline s64
1427 ia64_pal_proc_set_features (u64 feature_select)
1428 {
1429  struct ia64_pal_retval iprv;
1430  PAL_CALL_PHYS(iprv, PAL_PROC_SET_FEATURES, feature_select, 0, 0);
1431  return iprv.status;
1432 }
1433 
1434 /*
1435  * Put everything in a struct so we avoid the global offset table whenever
1436  * possible.
1437  */
1438 typedef struct ia64_ptce_info_s {
1439  unsigned long base;
1440  u32 count[2];
1441  u32 stride[2];
1443 
1444 /* Return the information required for the architected loop used to purge
1445  * (initialize) the entire TC
1446  */
1447 static inline s64
1448 ia64_get_ptce (ia64_ptce_info_t *ptce)
1449 {
1450  struct ia64_pal_retval iprv;
1451 
1452  if (!ptce)
1453  return -1;
1454 
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;
1462  }
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)
1469 {
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;
1477 }
1478 
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;
1487 
1488 /* Return information about the register stack and RSE for this processor
1489  * implementation.
1490  */
1491 static inline long ia64_pal_rse_info(unsigned long *num_phys_stacked,
1492  pal_hints_u_t *hints)
1493 {
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;
1501 }
1502 
1503 /*
1504  * Set the current hardware resource sharing policy of the processor
1505  */
1506 static inline s64
1507 ia64_pal_set_hw_policy (u64 policy)
1508 {
1509  struct ia64_pal_retval iprv;
1510  PAL_CALL(iprv, PAL_SET_HW_POLICY, policy, 0, 0);
1511  return iprv.status;
1512 }
1513 
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.
1517  */
1518 static inline s64
1519 ia64_pal_shutdown (void)
1520 {
1521  struct ia64_pal_retval iprv;
1522  PAL_CALL(iprv, PAL_SHUTDOWN, 0, 0, 0);
1523  return iprv.status;
1524 }
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;
1535 }
1536 
1537 typedef union pal_version_u {
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;
1549 
1550 
1551 /*
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.
1556  */
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;
1564 
1565  if (pal_cur_version)
1566  pal_cur_version->pal_version_val = iprv.v1;
1567 
1568  return iprv.status;
1571 typedef union pal_tc_info_u {
1573  struct {
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;
1583 
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
1590 
1591 
1592 /* Return information about the virtual memory characteristics of the processor
1593  * implementation.
1594  */
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)
1597 {
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;
1605 }
1607 /* Get page size information about the virtual memory characteristics of the processor
1608  * implementation.
1609  */
1610 static inline s64 ia64_pal_vm_page_size(u64 *tr_pages, u64 *vw_pages)
1611 {
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;
1619 }
1620 
1621 typedef union pal_vm_info_1_u {
1622  u64 pvi1_val;
1623  struct {
1624  u64 vw : 1,
1625  phys_add_size : 7,
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;
1635 
1636 #define PAL_MAX_PURGES 0xFFFF /* all ones is means unlimited */
1637 
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;
1647 
1648 /* Get summary information about the virtual memory characteristics of the processor
1649  * implementation.
1650  */
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)
1653 {
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;
1661 }
1662 
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;
1670 
1671 /*
1672  * Returns information about virtual processor features
1673  */
1674 static inline s64
1675 ia64_pal_vp_info (u64 feature_set, u64 vp_buffer, u64 *vp_info, u64 *vmm_id)
1676 {
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;
1684 }
1685 
1686 typedef union pal_itr_valid_u {
1687  u64 piv_val;
1688  struct {
1690  priv_level_valid : 1,
1691  dirty_bit_valid : 1,
1692  mem_attr_valid : 1,
1693  reserved : 60;
1694  } pal_tr_valid_s;
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)
1700 {
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;
1706 }
1707 
1708 /*
1709  * PAL_PREFETCH_VISIBILITY transaction types
1710  */
1711 #define PAL_VISIBILITY_VIRTUAL 0
1712 #define PAL_VISIBILITY_PHYSICAL 1
1713 
1714 /*
1715  * PAL_PREFETCH_VISIBILITY return codes
1716  */
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
1721 
1722 static inline s64
1723 ia64_pal_prefetch_visibility (s64 trans_type)
1724 {
1725  struct ia64_pal_retval iprv;
1726  PAL_CALL(iprv, PAL_PREFETCH_VISIBILITY, trans_type, 0, 0);
1727  return iprv.status;
1729 
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
1735  */
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;
1745 
1747  struct {
1748  u64 tid :16, /* Thread id */
1749  reserved2 :16, /* Reserved */
1750  cid :16, /* Core id */
1751  reserved1 :16; /* Reserved */
1755 
1756 typedef union pal_proc_n_log_info2_u {
1757  struct {
1758  u64 la :16, /* Logical address */
1759  reserved :48; /* Reserved */
1763 
1764 typedef struct pal_logical_to_physical_s
1765 {
1770 
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
1778 
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)
1788  {
1789  mapping->overview.overview_data = iprv.v0;
1790  mapping->ppli1.ppli1_data = iprv.v1;
1791  mapping->ppli2.ppli2_data = iprv.v2;
1792  }
1793 
1794  return iprv.status;
1795 }
1796 
1797 typedef struct pal_cache_shared_info_s
1798 {
1799  u64 num_shared;
1803 
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,
1810 {
1811  struct ia64_pal_retval iprv;
1812 
1813  PAL_CALL(iprv, PAL_CACHE_SHARED_INFO, level, type, proc_number);
1814 
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;
1819  }
1820 
1821  return iprv.status;
1822 }
1823 #endif /* __ASSEMBLY__ */
1824 
1825 #endif /* _ASM_IA64_PAL_H */