![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to kxalpha.h CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [WindowsNT SDKs] / mstools / h / alpha|
Return to kxalpha.h CVS log | Up to [WindowsNT SDKs] / mstools / h / alpha |
1.1 ! root 1: /*++ ! 2: ! 3: Copyright (c) 1992, 1993 Digital Equipment Corporation ! 4: ! 5: ! 6: Module: ! 7: kxalpha.h ! 8: ! 9: Abstract: ! 10: Contains alpha architecture constants and assembly macros. ! 11: ! 12: Author: ! 13: Joe Notarangelo 31-March-1992 (based on Dave Cutler's kxmips.h) ! 14: ! 15: ! 16: Revision History ! 17: ! 18: 16-July-1992 John DeRosa ! 19: ! 20: Removed fwcalpal.h hook. ! 21: ! 22: ! 23: 8-July-1992 John DeRosa ! 24: ! 25: Added fwcalpal.h hooks, defined HALT call_pal. ! 26: ! 27: ! 28: --*/ ! 29: ! 30: // ! 31: // Define Sfw Interrupt Levels and masks ! 32: // ! 33: ! 34: #define APC_INTERRUPT 0x1 ! 35: #define DISPATCH_INTERRUPT 0x2 ! 36: ! 37: // ! 38: // Define standard integer registers. ! 39: // ! 40: // N.B. `at' is `AT' so it doesn't conflict with the `.set at' pseudo-op. ! 41: // ! 42: ! 43: #define v0 $0 // return value register ! 44: #define t0 $1 // caller saved (temporary) registers ! 45: #define t1 $2 // ! 46: #define t2 $3 // ! 47: #define t3 $4 // ! 48: #define t4 $5 // ! 49: #define t5 $6 // ! 50: #define t6 $7 // ! 51: #define t7 $8 // ! 52: #define s0 $9 // callee saved (nonvolatile) registers ! 53: #define s1 $10 // ! 54: #define s2 $11 // ! 55: #define s3 $12 // ! 56: #define s4 $13 // ! 57: #define s5 $14 // ! 58: #define fp $15 // frame pointer register, or s6 ! 59: #define a0 $16 // argument registers ! 60: #define a1 $17 // ! 61: #define a2 $18 // ! 62: #define a3 $19 // ! 63: #define a4 $20 // ! 64: #define a5 $21 // ! 65: #define t8 $22 // caller saved (temporary) registers ! 66: #define t9 $23 // ! 67: #define t10 $24 // ! 68: #define t11 $25 // ! 69: #define ra $26 // return address register ! 70: #define t12 $27 // caller saved (temporary) registers ! 71: #define AT $28 // assembler temporary register ! 72: #define gp $29 // global pointer register ! 73: #define sp $30 // stack pointer register ! 74: #define zero $31 // zero register ! 75: ! 76: #ifndef PALCODE ! 77: ! 78: // ! 79: // Define standard floating point registers. ! 80: // ! 81: ! 82: #define f0 $f0 // return value register ! 83: #define f1 $f1 // return value register ! 84: #define f2 $f2 // callee saved (nonvolatile) registers ! 85: #define f3 $f3 // ! 86: #define f4 $f4 // ! 87: #define f5 $f5 // ! 88: #define f6 $f6 // ! 89: #define f7 $f7 // ! 90: #define f8 $f8 // ! 91: #define f9 $f9 // ! 92: #define f10 $f10 // caller saved (temporary) registers ! 93: #define f11 $f11 // ! 94: #define f12 $f12 // ! 95: #define f13 $f13 // ! 96: #define f14 $f14 // ! 97: #define f15 $f15 // ! 98: #define f16 $f16 // argument registers ! 99: #define f17 $f17 // ! 100: #define f18 $f18 // ! 101: #define f19 $f19 // ! 102: #define f20 $f20 // ! 103: #define f21 $f21 // ! 104: #define f22 $f22 // caller saved (temporary) registers ! 105: #define f23 $f23 // ! 106: #define f24 $f24 // ! 107: #define f25 $f25 // ! 108: #define f26 $f26 // ! 109: #define f27 $f27 // ! 110: #define f28 $f28 // ! 111: #define f29 $f29 // ! 112: #define f30 $f30 // ! 113: #define f31 $f31 // floating zero register ! 114: #define fzero $f31 // floating zero register (alias) ! 115: ! 116: #endif //!PALCODE ! 117: ! 118: ! 119: // ! 120: // Define procedure entry macros ! 121: // ! 122: ! 123: #define ALTERNATE_ENTRY(Name) \ ! 124: .globl Name; \ ! 125: Name:; ! 126: ! 127: #define LEAF_ENTRY(Name) \ ! 128: .text; \ ! 129: .align 4; \ ! 130: .globl Name; \ ! 131: .ent Name, 0; \ ! 132: Name:; \ ! 133: .frame sp, 0, ra; \ ! 134: .prologue 0; ! 135: ! 136: #define NESTED_ENTRY(Name, fsize, retrg) \ ! 137: .text; \ ! 138: .align 4; \ ! 139: .globl Name; \ ! 140: .ent Name, 0; \ ! 141: Name:; \ ! 142: .frame sp, fsize, retrg; ! 143: ! 144: // ! 145: // Define global definition macros. ! 146: // ! 147: ! 148: #define END_REGION(Name) \ ! 149: .globl Name; \ ! 150: Name:; ! 151: ! 152: #define START_REGION(Name) \ ! 153: .globl Name; \ ! 154: Name:; ! 155: ! 156: // ! 157: // Define exception handling macros. ! 158: // ! 159: ! 160: #define EXCEPTION_HANDLER(Handler) \ ! 161: .edata 1, Handler; ! 162: ! 163: ! 164: #define PROLOGUE_END .prologue 1; ! 165: ! 166: // ! 167: // Define save and restore floating state macros. ! 168: // ! 169: ! 170: #define SAVE_NONVOLATILE_FLOAT_STATE \ ! 171: bsr ra, KiSaveNonVolatileFloatState ! 172: ! 173: // ! 174: // Define interfaces to pcr and palcode ! 175: // ! 176: // The interfaces defined in the following macros will be PALcode ! 177: // calls for some implemenations, but may be in-line code in others ! 178: // (eg. uniprocessor vs multiprocessor). At the current time all of ! 179: // the interfaces are PALcode calls. ! 180: // ! 181: ! 182: // ! 183: // Define interfaces for cache coherency ! 184: // ! 185: ! 186: //++ ! 187: // ! 188: // IMB ! 189: // ! 190: // Macro Description: ! 191: // ! 192: // Issue the architecture-defined Instruction Memory Barrier. This ! 193: // instruction will make the processor instruction stream coherent with ! 194: // the system memory. ! 195: // ! 196: // Mode: ! 197: // ! 198: // Kernel and User. ! 199: // ! 200: // Arguments: ! 201: // ! 202: // None. ! 203: // ! 204: // Return Value: ! 205: // ! 206: // None. ! 207: // ! 208: // Registers Used: ! 209: // ! 210: // None. ! 211: // ! 212: //-- ! 213: ! 214: #define IMB call_pal imb ! 215: ! 216: // ! 217: // Define PALcode Environment Transition Interfaces ! 218: // ! 219: ! 220: //++ ! 221: // ! 222: // HALT ! 223: // ! 224: // Macro Description: ! 225: // ! 226: // Halt the processor and return to firmware. ! 227: // ! 228: // Mode: ! 229: // ! 230: // Kernel only. ! 231: // ! 232: // Arguments: ! 233: // ! 234: // None. ! 235: // ! 236: // Return Value: ! 237: // ! 238: // Does not return. ! 239: // ! 240: // Registers Used: ! 241: // ! 242: // None. ! 243: // ! 244: //-- ! 245: ! 246: #define HALT call_pal halt ! 247: ! 248: //++ ! 249: // ! 250: // RESTART ! 251: // ! 252: // Macro Description: ! 253: // ! 254: // Restart the processor with the processor state found in a ! 255: // restart block. ! 256: // ! 257: // Mode: ! 258: // ! 259: // Kernel only. ! 260: // ! 261: // Arguments: ! 262: // ! 263: // a0 - Supplies a pointer to an ARC restart block with an Alpha AXP ! 264: // saved state area. ! 265: // ! 266: // Return Value: ! 267: // ! 268: // If successful the call does not return. Otherwise, any return ! 269: // is considered a failure. ! 270: // ! 271: // Registers Used: ! 272: // ! 273: // None. ! 274: // ! 275: //-- ! 276: ! 277: #define RESTART call_pal restart ! 278: ! 279: //++ ! 280: // ! 281: // SWPPAL ! 282: // ! 283: // Macro Description: ! 284: // ! 285: // Swap the execution environment to a new PALcode image. ! 286: // ! 287: // Mode: ! 288: // ! 289: // Kernel only. ! 290: // ! 291: // Arguments: ! 292: // ! 293: // a0 - Supplies the physical address of the base of the new PALcode ! 294: // image. ! 295: // ! 296: // a1 - a5 - Supply arguments to the new PALcode environment. ! 297: // ! 298: // Return Value: ! 299: // ! 300: // Does not return. ! 301: // ! 302: // Registers Used: ! 303: // ! 304: // None. ! 305: // ! 306: //-- ! 307: ! 308: #define SWPPAL call_pal swppal ! 309: ! 310: // ! 311: // Define IRQL and interrupt interfaces ! 312: // ! 313: ! 314: //++ ! 315: // ! 316: // DISABLE_INTERRUPTS ! 317: // ! 318: // Macro Description: ! 319: // ! 320: // Disable all interrupts for the current processor and return the ! 321: // previous PSR. ! 322: // ! 323: // Mode: ! 324: // ! 325: // Kernel only. ! 326: // ! 327: // Arguments: ! 328: // ! 329: // None. ! 330: // ! 331: // Return Value: ! 332: // ! 333: // None. ! 334: // ! 335: // Registers Used: ! 336: // ! 337: // None. ! 338: // ! 339: //-- ! 340: ! 341: #define DISABLE_INTERRUPTS call_pal di ! 342: ! 343: //++ ! 344: // ! 345: // ENABLE_INTERRUPTS ! 346: // ! 347: // Macro Description: ! 348: // ! 349: // Enable interrupts according to the current PSR for the current ! 350: // processor. ! 351: // ! 352: // Mode: ! 353: // ! 354: // Kernel only. ! 355: // ! 356: // Arguments: ! 357: // ! 358: // None. ! 359: // ! 360: // Return Value: ! 361: // ! 362: // None. ! 363: // ! 364: // Registers Used: ! 365: // ! 366: // None. ! 367: // ! 368: //-- ! 369: ! 370: #define ENABLE_INTERRUPTS call_pal ei ! 371: ! 372: //++ ! 373: // ! 374: // SWAP_IRQL ! 375: // ! 376: // Macro Description: ! 377: // ! 378: // Swap the IRQL level for the current processor. ! 379: // ! 380: // Mode: ! 381: // ! 382: // Kernel only. ! 383: // ! 384: // Arguments: ! 385: // ! 386: // a0 - Supplies the new IRQL level. ! 387: // ! 388: // Return Value: ! 389: // ! 390: // v0 = previous IRQL level. ! 391: // ! 392: // Registers Used: ! 393: // ! 394: // AT, a1 - a3. ! 395: // ! 396: //-- ! 397: ! 398: #define SWAP_IRQL call_pal swpirql ! 399: ! 400: //++ ! 401: // ! 402: // GET_CURRENT_IRQL ! 403: // ! 404: // Macro Description: ! 405: // ! 406: // Return the current processor Interrupt Request Level (IRQL). ! 407: // ! 408: // Mode: ! 409: // ! 410: // Kernel only. ! 411: // ! 412: // Arguments: ! 413: // ! 414: // None. ! 415: // ! 416: // Return Value: ! 417: // ! 418: // v0 = current IRQL. ! 419: // ! 420: // Registers Used: ! 421: // ! 422: // AT. ! 423: // ! 424: //-- ! 425: ! 426: #define GET_CURRENT_IRQL call_pal rdirql ! 427: ! 428: ! 429: // ! 430: // Define interfaces for software interrupts ! 431: // ! 432: ! 433: //++ ! 434: // ! 435: // DEASSERT_SOFTWARE_INTERRUPT ! 436: // ! 437: // Macro Description: ! 438: // ! 439: // Deassert the software interrupts indicated in a0 for the current ! 440: // processor. ! 441: // ! 442: // Mode: ! 443: // ! 444: // Kernel only. ! 445: // ! 446: // Arguments: ! 447: // ! 448: // a0 - Supplies the mask for the software interrupt to be de-asserted. ! 449: // a0<1> - Deassert DISPATCH software interrupt. ! 450: // a0<0> - Deassert APC software interrupt. ! 451: // ! 452: // Return Value: ! 453: // ! 454: // None. ! 455: // ! 456: // Registers Used: ! 457: // ! 458: // AT, a1 - a3. ! 459: // ! 460: //-- ! 461: ! 462: #define DEASSERT_SOFTWARE_INTERRUPT call_pal csir ! 463: ! 464: //++ ! 465: // ! 466: // REQUEST_SOFTWARE_INTERRUPT ! 467: // ! 468: // Macro Description: ! 469: // ! 470: // Request software interrupts on the current processor according to ! 471: // the mask supplied in a0. ! 472: // ! 473: // Mode: ! 474: // ! 475: // Kernel only. ! 476: // ! 477: // Arguments: ! 478: // ! 479: // a0 - Supplies the mask of software interrupts to be requested. ! 480: // a0<1> - Request DISPATCH software interrupt. ! 481: // a0<0> - Request APC software interrupt. ! 482: // ! 483: // Return Value: ! 484: // ! 485: // None. ! 486: // ! 487: // Registers Used: ! 488: // ! 489: // AT, a1 - a3. ! 490: // ! 491: //-- ! 492: ! 493: #define REQUEST_SOFTWARE_INTERRUPT call_pal ssir ! 494: ! 495: // ! 496: // Define interfaces to Processor Status Register ! 497: // ! 498: ! 499: //++ ! 500: // ! 501: // GET_CURRENT_PROCESSOR_STATUS_REGISTER ! 502: // ! 503: // Macro Description: ! 504: // ! 505: // Return the current Processor Status Register (PSR) for the current ! 506: // processor. ! 507: // ! 508: // Mode: ! 509: // ! 510: // Kernel only. ! 511: // ! 512: // Arguments: ! 513: // ! 514: // None. ! 515: // ! 516: // Return Value: ! 517: // ! 518: // v0 = current PSR. ! 519: // ! 520: // Registers Used: ! 521: // ! 522: // AT. ! 523: // ! 524: //-- ! 525: ! 526: #define GET_CURRENT_PROCESSOR_STATUS_REGISTER call_pal rdpsr ! 527: ! 528: ! 529: // ! 530: // Define current thread interface ! 531: // ! 532: ! 533: //++ ! 534: // ! 535: // GET_THREAD_ENVIRONMENT_BLOCK ! 536: // ! 537: // Macro Description: ! 538: // ! 539: // Return the base address of the current Thread Environment Block (TEB), ! 540: // for the currently executing thread on the current processor. ! 541: // ! 542: // Mode; ! 543: // ! 544: // Kernel and User. ! 545: // ! 546: // Arguments: ! 547: // ! 548: // None. ! 549: // ! 550: // Return Value: ! 551: // ! 552: // v0 = TEB base address. ! 553: // ! 554: // Registers Used: ! 555: // ! 556: // None. ! 557: // ! 558: //-- ! 559: ! 560: #define GET_THREAD_ENVIRONMENT_BLOCK call_pal rdteb ! 561: ! 562: //++ ! 563: // ! 564: // GET_CURRENT_THREAD ! 565: // ! 566: // Macro Description: ! 567: // ! 568: // Return the thread object address for the currently executing thread ! 569: // on the current processor. ! 570: // ! 571: // Mode: ! 572: // ! 573: // Kernel only. ! 574: // ! 575: // Arguments: ! 576: // ! 577: // None. ! 578: // ! 579: // Return Value: ! 580: // ! 581: // v0 = PCR base address. ! 582: // ! 583: // Registers Used: ! 584: // ! 585: // AT. ! 586: // ! 587: //-- ! 588: ! 589: #ifdef NT_UP ! 590: ! 591: // ! 592: // If uni-processor, retrieve current thread address from the global ! 593: // variable KiCurrentThread. ! 594: // ! 595: ! 596: #define GET_CURRENT_THREAD \ ! 597: lda v0, KiCurrentThread; \ ! 598: ldl v0, 0(v0) ! 599: ! 600: #else ! 601: ! 602: // ! 603: // If multi-processor, retrive per-processor current thread via a call pal. ! 604: // ! 605: ! 606: #define GET_CURRENT_THREAD call_pal rdthread ! 607: ! 608: #endif //NT_UP ! 609: ! 610: // ! 611: // Define per-processor data area routine interfaces ! 612: // ! 613: ! 614: //++ ! 615: // ! 616: // GET_PROCESSOR_CONTROL_REGION_BASE ! 617: // ! 618: // Macro Description: ! 619: // ! 620: // Return the base address of the Process Control Region (PCR) ! 621: // for the current processor. ! 622: // ! 623: // Mode: ! 624: // ! 625: // Kernel only. ! 626: // ! 627: // Arguments: ! 628: // ! 629: // None. ! 630: // ! 631: // Return Value: ! 632: // ! 633: // v0 = PCR base address. ! 634: // ! 635: // Registers Used: ! 636: // ! 637: // AT. ! 638: // ! 639: //-- ! 640: ! 641: #ifdef NT_UP ! 642: ! 643: // ! 644: // Uni-processor, address of PCR is in global variable. ! 645: // ! 646: ! 647: #define GET_PROCESSOR_CONTROL_REGION_BASE \ ! 648: lda v0, KiPcrBaseAddress; \ ! 649: ldl v0, 0(v0) ! 650: ! 651: #else ! 652: ! 653: // ! 654: // Multi-processor, get per-processor value via call pal. ! 655: // ! 656: ! 657: #define GET_PROCESSOR_CONTROL_REGION_BASE call_pal rdpcr ! 658: ! 659: #endif //NT_UP ! 660: ! 661: //++ ! 662: // ! 663: // GET_PROCESSOR_CONTROL_BLOCK_BASE ! 664: // ! 665: // Macro Description: ! 666: // ! 667: // Return the Processor Control Block base address. ! 668: // ! 669: // Mode: ! 670: // ! 671: // Kernel only. ! 672: // ! 673: // Arguments: ! 674: // ! 675: // None. ! 676: // ! 677: // Return Value: ! 678: // ! 679: // v0 = PRCB base address. ! 680: // ! 681: // Registers Used: ! 682: // ! 683: // AT. ! 684: // ! 685: //-- ! 686: ! 687: #define GET_PROCESSOR_CONTROL_BLOCK_BASE \ ! 688: GET_PROCESSOR_CONTROL_REGION_BASE; \ ! 689: ldl v0, PcPrcb(v0) ! 690: ! 691: ! 692: // ! 693: // Define kernel stack interfaces ! 694: // ! 695: ! 696: //++ ! 697: // ! 698: // GET_INITIAL_KERNEL_STACK ! 699: // ! 700: // Macro Description: ! 701: // ! 702: // Return the initial kernel stack address for the current thread. ! 703: // ! 704: // Mode: ! 705: // ! 706: // Kernel only. ! 707: // ! 708: // Arguments: ! 709: // ! 710: // None. ! 711: // ! 712: // Return Value: ! 713: // ! 714: // v0 = initial kernel stack address. ! 715: // ! 716: // Registers Used: ! 717: // ! 718: // AT. ! 719: // ! 720: //-- ! 721: ! 722: #define GET_INITIAL_KERNEL_STACK call_pal rdksp ! 723: ! 724: //++ ! 725: // ! 726: // SET_INITIAL_KERNEL_STACK ! 727: // ! 728: // Macro Description: ! 729: // ! 730: // Set the initial kernel stack address for the current thread. ! 731: // ! 732: // Mode: ! 733: // ! 734: // Kernel only. ! 735: // ! 736: // Arguments: ! 737: // ! 738: // a0 - Supplies the new initial kernel stack address. ! 739: // ! 740: // Return Value: ! 741: // ! 742: // v0 - Previous initial kernel stack address. ! 743: // ! 744: // Registers Used: ! 745: // ! 746: // AT. ! 747: // ! 748: //-- ! 749: ! 750: #define SET_INITIAL_KERNEL_STACK call_pal swpksp ! 751: ! 752: // ! 753: // Define initialization routine interfaces ! 754: // ! 755: ! 756: //++ ! 757: // ! 758: // INITIALIZE_PAL ! 759: // ! 760: // Macro Description: ! 761: // ! 762: // Supply values to initialize the PALcode. ! 763: // ! 764: // Mode: ! 765: // ! 766: // Kernel only. ! 767: // ! 768: // Arguments: ! 769: // ! 770: // a0 - Supplies initial PageDirectoryBase (32-bit superpage address). ! 771: // a1 - Supplies PRCB Base Address (32-bit superpage address). ! 772: // a2 - Supplies address of initial kernel thread object. ! 773: // a3 - Supplies address of TEB for initial kernel thread object. ! 774: // gp - Supplies kernel image global pointer. ! 775: // sp - Supplies initial thread kernel stack pointer. ! 776: // ! 777: // Return Value: ! 778: // ! 779: // v0 = PAL base address in 32-bit super-page format (KSEG0). ! 780: // ! 781: // Registers Used: ! 782: // ! 783: // AT, a3. ! 784: // ! 785: //-- ! 786: ! 787: #define INITIALIZE_PAL call_pal initpal ! 788: ! 789: //++ ! 790: // ! 791: // WRITE_KERNEL_ENTRY_POINT ! 792: // ! 793: // Macro Description: ! 794: // ! 795: // Register the kernel entry point to receive control for a ! 796: // class of exceptions. ! 797: // ! 798: // Mode: ! 799: // ! 800: // Kernel only. ! 801: // ! 802: // Arguments: ! 803: // ! 804: // a0 - Supplies the address of the kernel entry point. ! 805: // a1 - Supplies the class of exception dispatched to this entry point. ! 806: // 0 = bug check conditions ! 807: // 1 = memory management faults ! 808: // 2 = interrupts ! 809: // 3 = system service calls ! 810: // 4 = general exception traps ! 811: // ! 812: // Return Value: ! 813: // ! 814: // None. ! 815: // ! 816: // Registers Used: ! 817: // ! 818: // AT, a2-a3. ! 819: // ! 820: //-- ! 821: ! 822: #define WRITE_KERNEL_ENTRY_POINT call_pal wrentry ! 823: ! 824: // ! 825: // Define entry point values for the wrentry callpal function ! 826: // ! 827: ! 828: #define entryBugCheck 0 ! 829: #define entryMM 1 ! 830: #define entryInterrupt 2 ! 831: #define entrySyscall 3 ! 832: #define entryGeneral 4 ! 833: ! 834: //++ ! 835: // ! 836: // CACHE_PCR_VALUES ! 837: // ! 838: // Macro Description: ! 839: // ! 840: // Notify the PALcode that the PCR has been initialized by the ! 841: // kernel and the HAL and that the PALcode may now read values ! 842: // from the PCR and cache them inside the processor. ! 843: // ! 844: // N.B. - the PCR pointer must have already been established in ! 845: // initpal ! 846: // ! 847: // N.B. - This interface is a processor-specific implementation ! 848: // and cannot be assumed to be present on all processors. ! 849: // Currently implemented for the following processors: ! 850: // ! 851: // DECchip 21064 ! 852: // ! 853: // Mode: ! 854: // ! 855: // Kernel only. ! 856: // ! 857: // Arguments: ! 858: // ! 859: // None. ! 860: // ! 861: // Return Value: ! 862: // ! 863: // None. ! 864: // ! 865: // Registers Used: ! 866: // ! 867: // AT, a0 - a3. ! 868: // ! 869: //-- ! 870: ! 871: #define CACHE_PCR_VALUES call_pal initpcr ! 872: ! 873: // ! 874: // Define transition interfaces ! 875: // ! 876: ! 877: //++ ! 878: // ! 879: // RETURN_FROM_TRAP_OR_INTERRUPT ! 880: // ! 881: // Macro Description: ! 882: // ! 883: // Return to execution thread after processing a trap or ! 884: // interrupt. Traps can be general exceptions (breakpoint, ! 885: // arithmetic traps, etc.) or memory management faults. ! 886: // This macro is also used to startup a thread of execution ! 887: // for the first time. ! 888: // ! 889: // Mode: ! 890: // ! 891: // Kernel only. ! 892: // ! 893: // Arguments: ! 894: // ! 895: // a0 - Supplies the previous processor status register. ! 896: // a1 - Supplies new software interrupt requests. ! 897: // a1<1> - Request a DISPATCH Interrupt. ! 898: // a1<0> - Request an APC Interrupt. ! 899: // ! 900: // Return Value: ! 901: // ! 902: // Does not return. ! 903: // ! 904: // Registers Used: ! 905: // ! 906: // None. ! 907: // ! 908: //-- ! 909: ! 910: #define RETURN_FROM_TRAP_OR_INTERRUPT call_pal rfe ! 911: ! 912: //++ ! 913: // ! 914: // RETURN_FROM_SYSTEM_CALL ! 915: // ! 916: // Macro Description: ! 917: // ! 918: // Return from a system service call. ! 919: // ! 920: // Mode: ! 921: // ! 922: // Kernel only. ! 923: // ! 924: // Arguments: ! 925: // ! 926: // a0 - Supplies the previous processor status register. ! 927: // a1 - Supplies new software interrupt requests. ! 928: // a1<1> - Request a DISPATCH Interrupt. ! 929: // a1<0> - Request an APC Interrupt. ! 930: // ! 931: // Return Value: ! 932: // ! 933: // Does not return. ! 934: // ! 935: // Registers Used: ! 936: // ! 937: // All volatile registers. ! 938: // ! 939: //-- ! 940: ! 941: #define RETURN_FROM_SYSTEM_CALL call_pal retsys ! 942: ! 943: //++ ! 944: // ! 945: // SYSCALL ! 946: // ! 947: // Macro Description: ! 948: // ! 949: // Call a system service. ! 950: // ! 951: // Mode: ! 952: // ! 953: // Kernel and User. ! 954: // ! 955: // Arguments: ! 956: // ! 957: // v0 - Supplies the system service number. ! 958: // [other arguments as per calling standard] ! 959: // ! 960: // Return Value: ! 961: // ! 962: // Will not return directly, returns via retsys, no return value. ! 963: // ! 964: // Registers Used: ! 965: // ! 966: // All volatile registers. ! 967: // ! 968: //-- ! 969: ! 970: #define SYSCALL call_pal callsys ! 971: ! 972: // ! 973: // Define breakpoint interfaces ! 974: // ! 975: ! 976: //++ ! 977: // ! 978: // BREAK ! 979: // ! 980: // Macro Description: ! 981: // ! 982: // Issue a user breakpoint which may be handled by a user-mode ! 983: // debugger. ! 984: // ! 985: // Mode: ! 986: // ! 987: // Kernel and User. ! 988: // ! 989: // Arguments: ! 990: // ! 991: // None. ! 992: // ! 993: // Return Value: ! 994: // ! 995: // Will not return directly, returns via rti, no return value. ! 996: // ! 997: // Registers Used: ! 998: // ! 999: // None. ! 1000: // ! 1001: //-- ! 1002: ! 1003: #define BREAK call_pal bpt ! 1004: ! 1005: //++ ! 1006: // ! 1007: // BREAK_DEBUG_STOP ! 1008: // ! 1009: // Macro Description: ! 1010: // ! 1011: // Issue a stop breakpoint to the kernel debugger. ! 1012: // ! 1013: // Mode: ! 1014: // ! 1015: // Kernel and User. ! 1016: // ! 1017: // Arguments: ! 1018: // ! 1019: // None. ! 1020: // ! 1021: // Return Value: ! 1022: // ! 1023: // Will not return directly, returns via rti, no return value. ! 1024: // ! 1025: // Registers Used: ! 1026: // ! 1027: // AT, v0. ! 1028: // ! 1029: //-- ! 1030: ! 1031: #define BREAK_DEBUG_STOP \ ! 1032: ldil v0, DEBUG_STOP_BREAKPOINT; \ ! 1033: call_pal callkd ! 1034: ! 1035: //++ ! 1036: //++ ! 1037: // ! 1038: // BREAK_BREAKIN ! 1039: // ! 1040: // Macro Description: ! 1041: // ! 1042: // Issue a breakin breakpoint to the kernel debugger. ! 1043: // ! 1044: // Mode: ! 1045: // ! 1046: // Kernel and User. ! 1047: // ! 1048: // Arguments: ! 1049: // ! 1050: // None. ! 1051: // ! 1052: // Return Value: ! 1053: // ! 1054: // Will not return directly, returns via rti, no return value. ! 1055: // ! 1056: // Registers Used: ! 1057: // ! 1058: // AT, v0. ! 1059: // ! 1060: //-- ! 1061: ! 1062: #define BREAK_BREAKIN \ ! 1063: ldil v0, BREAKIN_BREAKPOINT; \ ! 1064: call_pal callkd ! 1065: ! 1066: //++ ! 1067: // ! 1068: // BREAK_DEBUG_LOAD_SYMBOLS ! 1069: // ! 1070: // Macro Description: ! 1071: // ! 1072: // Issue a load symbols breakpoint to the kernel debugger. ! 1073: // ! 1074: // Mode: ! 1075: // ! 1076: // Kernel and User. ! 1077: // ! 1078: // Arguments: ! 1079: // ! 1080: // None. ! 1081: // ! 1082: // Return Value: ! 1083: // ! 1084: // Will not return directly, returns via rti, no return value. ! 1085: // ! 1086: // Registers Used: ! 1087: // ! 1088: // AT, v0. ! 1089: // ! 1090: //-- ! 1091: ! 1092: #define BREAK_DEBUG_LOAD_SYMBOLS \ ! 1093: ldil v0, DEBUG_LOAD_SYMBOLS_BREAKPOINT; \ ! 1094: call_pal callkd ! 1095: ! 1096: //++ ! 1097: // ! 1098: // BREAK_DEBUG_UNLOAD_SYMBOLS ! 1099: // ! 1100: // Macro Description: ! 1101: // ! 1102: // Issue a unload symbols breakpoint to the kernel debugger. ! 1103: // ! 1104: // Mode: ! 1105: // ! 1106: // Kernel and User. ! 1107: // ! 1108: // Arguments: ! 1109: // ! 1110: // None. ! 1111: // ! 1112: // Return Value: ! 1113: // ! 1114: // Will not return directly, returns via rti, no return value. ! 1115: // ! 1116: // Registers Used: ! 1117: // ! 1118: // AT, v0. ! 1119: // ! 1120: //-- ! 1121: ! 1122: #define BREAK_DEBUG_UNLOAD_SYMBOLS \ ! 1123: ldil v0, DEBUG_UNLOAD_SYMBOLS_BREAKPOINT; \ ! 1124: call_pal callkd ! 1125: ! 1126: //++ ! 1127: // ! 1128: // BREAK_DEBUG_PRINT ! 1129: // ! 1130: // Macro Description: ! 1131: // ! 1132: // Cause a debug print breakpoint which will be interpreted by ! 1133: // the kernel debugger and will print a string to the kernel debugger ! 1134: // port. ! 1135: // ! 1136: // Mode: ! 1137: // ! 1138: // Kernel and User. ! 1139: // ! 1140: // Arguments: ! 1141: // ! 1142: // a0 - Supplies the address of ASCII string to print. ! 1143: // a1 - Supplies the length of the string to print. ! 1144: // ! 1145: // Return Value: ! 1146: // ! 1147: // Does not return directly, returns via rti, no return value. ! 1148: // ! 1149: // Registers Used: ! 1150: // ! 1151: // AT, v0. ! 1152: // ! 1153: //-- ! 1154: ! 1155: ! 1156: #define BREAK_DEBUG_PRINT \ ! 1157: ldil v0, DEBUG_PRINT_BREAKPOINT; \ ! 1158: call_pal callkd ! 1159: ! 1160: //++ ! 1161: // ! 1162: // BREAK_DEBUG_PROMPT ! 1163: // ! 1164: // Macro Description: ! 1165: // ! 1166: // Cause a debug print breakpoint which will be interpreted by ! 1167: // the kernel debugger and will receive a string from the kernel debugger ! 1168: // port after prompting for input. ! 1169: // ! 1170: // Mode: ! 1171: // ! 1172: // Kernel and User. ! 1173: // ! 1174: // Arguments: ! 1175: // ! 1176: // a0 - Supplies the address of ASCII string to print. ! 1177: // a1 - Supplies the length of the string to print. ! 1178: // a2 - Supplies the address of the buffer to receive the input string. ! 1179: // a3 - Supplies the maximum length of the input string. ! 1180: // ! 1181: // Return Value: ! 1182: // ! 1183: // Does not return directly, returns via rti, no return value. ! 1184: // ! 1185: // Registers Used: ! 1186: // ! 1187: // AT, v0. ! 1188: // ! 1189: //-- ! 1190: ! 1191: ! 1192: #define BREAK_DEBUG_PROMPT \ ! 1193: ldil v0, DEBUG_PROMPT_BREAKPOINT; \ ! 1194: call_pal callkd ! 1195: ! 1196: // ! 1197: // Define tb manipulation interfaces ! 1198: // ! 1199: ! 1200: //++ ! 1201: // ! 1202: // TB_INVALIDATE_ALL ! 1203: // ! 1204: // Macro Description: ! 1205: // ! 1206: // Invalidate all cached virtual address translations for the current ! 1207: // processor that are not fixed. ! 1208: // Some translations may be fixed in hardware and/or software and ! 1209: // these are not invalidated (eg. super-pages). ! 1210: // ! 1211: // Mode: ! 1212: // ! 1213: // Kernel only. ! 1214: // ! 1215: // Arguments: ! 1216: // ! 1217: // None. ! 1218: // ! 1219: // Return Value: ! 1220: // ! 1221: // None. ! 1222: // ! 1223: // Registers Used: ! 1224: // ! 1225: // a0 - a3. ! 1226: // ! 1227: //-- ! 1228: ! 1229: ! 1230: #define TB_INVALIDATE_ALL call_pal tbia ! 1231: ! 1232: //++ ! 1233: // ! 1234: // TB_INVALIDATE_SINGLE ! 1235: // ! 1236: // Macro Description: ! 1237: // ! 1238: // Invalidate any cached virtual address translations for a single ! 1239: // virtual address. ! 1240: // ! 1241: // Note - it is legal for an implementation to invalidate more ! 1242: // translations that the single one specified. ! 1243: // ! 1244: // Mode: ! 1245: // ! 1246: // Kernel only. ! 1247: // ! 1248: // Arguments: ! 1249: // ! 1250: // a0 - Supplies the Virtual Address of the translation to invalidate. ! 1251: // ! 1252: // Return Value: ! 1253: // ! 1254: // None. ! 1255: // ! 1256: // Registers Used: ! 1257: // ! 1258: // a1 - a3. ! 1259: // ! 1260: //-- ! 1261: ! 1262: #define TB_INVALIDATE_SINGLE call_pal tbis ! 1263: ! 1264: //++ ! 1265: // ! 1266: // DATA_TB_INVALIDATE_SINGLE ! 1267: // ! 1268: // Macro Description: ! 1269: // ! 1270: // Invalidate data stream translations for a single virtual address. ! 1271: // ! 1272: // Note - it is legal for an implementation to invalidate more ! 1273: // translations that the single one specified. ! 1274: // ! 1275: // Mode: ! 1276: // ! 1277: // Kernel only. ! 1278: // ! 1279: // Arguments: ! 1280: // ! 1281: // a0 - Supplies the Virtual Address of the translation to invalidate. ! 1282: // ! 1283: // Return Value: ! 1284: // ! 1285: // None. ! 1286: // ! 1287: // Registers Used: ! 1288: // ! 1289: // a1 - a3. ! 1290: // ! 1291: //-- ! 1292: ! 1293: #define DATA_TB_INVALIDATE_SINGLE call_pal dtbis ! 1294: ! 1295: // ! 1296: // Define context switch interfaces ! 1297: // ! 1298: ! 1299: //++ ! 1300: // ! 1301: // SWAP_THREAD_CONTEXT ! 1302: // ! 1303: // Macro Description: ! 1304: // ! 1305: // ! 1306: // Change to a new thread context. This will mean a new kernel stack, ! 1307: // new current thread address and a new thread environment block. ! 1308: // ! 1309: // Mode: ! 1310: // ! 1311: // Kernel only. ! 1312: // ! 1313: // Arguments: ! 1314: // ! 1315: // a0 - Supplies the Virtual Address of new initial kernel stack. ! 1316: // a1 - Supplies the address of new thread object. ! 1317: // a2 - Supplies the address of new thread environment block. ! 1318: // a3 - Supplies the PFN of the new page directory if the process ! 1319: // is to be swapped, -1 otherwise. ! 1320: // a4 - Supplies the ASN of the new processor if the process is to ! 1321: // be swapped, undefined otherwise. ! 1322: // a5 - Supplies the ASN wrap indicator if the process is to be swapped, ! 1323: // undefined otherwise. ! 1324: // ! 1325: // Return Value: ! 1326: // ! 1327: // None. ! 1328: // ! 1329: // Registers Used: ! 1330: // ! 1331: // AT. ! 1332: // ! 1333: //-- ! 1334: ! 1335: #define SWAP_THREAD_CONTEXT call_pal swpctx ! 1336: ! 1337: //++ ! 1338: // ! 1339: // SWAP_PROCESS_CONTEXT ! 1340: // ! 1341: // Macro Description: ! 1342: // ! 1343: // Change from one process address space to another. ! 1344: // ! 1345: // Mode: ! 1346: // ! 1347: // Kernel only. ! 1348: // ! 1349: // Arguments: ! 1350: // ! 1351: // a0 - Supplies the Pfn of Page Directory for new address space. ! 1352: // a1 - Supplies the Address Space Number for new address space. ! 1353: // a2 - Supplies the ASN wrap indicator (0 = no wrap, non-zero = wrap). ! 1354: // ! 1355: // Return Value: ! 1356: // ! 1357: // None. ! 1358: // ! 1359: // Registers Used: ! 1360: // ! 1361: // AT, a3. ! 1362: // ! 1363: //-- ! 1364: ! 1365: #define SWAP_PROCESS_CONTEXT call_pal swpprocess ! 1366: ! 1367: // ! 1368: // Define access to DPC Active flag ! 1369: // ! 1370: ! 1371: //++ ! 1372: // ! 1373: // GET_DPC_ACTIVE_FLAG ! 1374: // ! 1375: // Macro Description: ! 1376: // ! 1377: // Return the DPC Active Flag for the current processor. ! 1378: // ! 1379: // Mode: ! 1380: // ! 1381: // Kernel only. ! 1382: // ! 1383: // Arguments: ! 1384: // ! 1385: // None. ! 1386: // ! 1387: // Return Value: ! 1388: // ! 1389: // v0 = DPC Active Flag ! 1390: // ! 1391: // Registers Used: ! 1392: // ! 1393: // AT. ! 1394: // ! 1395: //-- ! 1396: ! 1397: #define GET_DPC_ACTIVE_FLAG \ ! 1398: GET_PROCESSOR_CONTROL_REGION_BASE; \ ! 1399: ldl v0, PcDpcRoutineActive(v0) ! 1400: ! 1401: //++ ! 1402: // ! 1403: // SET_DPC_ACTIVE_FLAG ! 1404: // ! 1405: // Macro Description: ! 1406: // ! 1407: // Set the DPC Active Flag for the current processor. ! 1408: // ! 1409: // Mode: ! 1410: // ! 1411: // Kernel only. ! 1412: // ! 1413: // Arguments: ! 1414: // ! 1415: // a0 = Supplies the DPC Active Flag Value to set. ! 1416: // ! 1417: // Return Value: ! 1418: // ! 1419: // None. ! 1420: // ! 1421: // Registers Used: ! 1422: // ! 1423: // AT. ! 1424: // ! 1425: //-- ! 1426: ! 1427: #define SET_DPC_ACTIVE_FLAG \ ! 1428: .set noat; \ ! 1429: GET_PROCESSOR_CONTROL_REGION_BASE; \ ! 1430: stl a0, PcDpcRoutineActive(v0); \ ! 1431: .set at ! 1432: ! 1433: ! 1434: // ! 1435: // Define interfaces for generate trap ! 1436: // ! 1437: ! 1438: //++ ! 1439: // ! 1440: // GENERATE_TRAP ! 1441: // ! 1442: // Macro Description: ! 1443: // ! 1444: // Generate a trap. Code has discovered an exception condition ! 1445: // and wants to raise a trap to indicate the condition. Anticipated ! 1446: // for use by compilers for divide by zero, etc.. ! 1447: // ! 1448: // Mode: ! 1449: // ! 1450: // Kernel and User. ! 1451: // ! 1452: // Arguments: ! 1453: // ! 1454: // a0 = Supplies the trap number which identifies the exception. ! 1455: // ! 1456: // Return Value: ! 1457: // ! 1458: // Does not return, generates a trap to kernel mode, no return value. ! 1459: // ! 1460: // Registers Used: ! 1461: // ! 1462: // None. ! 1463: // ! 1464: //-- ! 1465: ! 1466: #define GENERATE_TRAP call_pal gentrap ! 1467: ! 1468: // ! 1469: // Define performance and debug interfaces. ! 1470: // ! 1471: ! 1472: //++ ! 1473: // ! 1474: // GET_INTERNAL_COUNTERS ! 1475: // ! 1476: // Macro Description: ! 1477: // ! 1478: // Read the internal processor event counters. The counter formats ! 1479: // and the events counted are processor implementation-dependent. ! 1480: // ! 1481: // N.B. - the counters will only be implemented for checked builds. ! 1482: // ! 1483: // Mode: ! 1484: // ! 1485: // Kernel. ! 1486: // ! 1487: // Arguments: ! 1488: // ! 1489: // a0 - Supplies the superpage 32 address of the buffer to receive ! 1490: // the counter data. The address must be quadword aligned. ! 1491: // ! 1492: // a1 - Supplies the length of the buffer allocated for the counters. ! 1493: // ! 1494: // Return Value: ! 1495: // ! 1496: // v0 - 0 is returned if the interface is not implemented. ! 1497: // If v0 <= a1 then v0 is the length of the data returned. ! 1498: // If v0 > a1 then v0 is the length of the processor implementation ! 1499: // counter record. ! 1500: // ! 1501: // Registers Used: ! 1502: // ! 1503: // AT, a2 - a3. ! 1504: // ! 1505: //-- ! 1506: ! 1507: #define GET_INTERNAL_COUNTERS call_pal rdcounters ! 1508: ! 1509: //++ ! 1510: // ! 1511: // GET_INTERNAL_PROCESSOR_STATE ! 1512: // ! 1513: // Macro Description: ! 1514: // ! 1515: // Read the internal processor state. The data values returned and ! 1516: // their format are processor implementation-dependent. ! 1517: // ! 1518: // Mode: ! 1519: // ! 1520: // Kernel. ! 1521: // ! 1522: // Arguments: ! 1523: // ! 1524: // a0 - Supplies the superpage 32 address of the buffer to receive ! 1525: // the processor state data. The address must be quadword aligned. ! 1526: // ! 1527: // a1 - Supplies the length of the buffer allocated for the state. ! 1528: // ! 1529: // Return Value: ! 1530: // ! 1531: // v0 - If v0 <= a1 then v0 is the length of the data returned. ! 1532: // If v0 > a1 then v0 is the length of the processor implementation ! 1533: // state record. ! 1534: // ! 1535: // Registers Used: ! 1536: // ! 1537: // AT, a2 - a3. ! 1538: // ! 1539: //-- ! 1540: ! 1541: #define GET_INTERNAL_PROCESSOR_STATE call_pal rdstate ! 1542: ! 1543: //++ ! 1544: // ! 1545: // WRITE_PERFORMANCE_COUNTERS ! 1546: // ! 1547: // Macro Description: ! 1548: // ! 1549: // Write the state of the internal processor performance counters. ! 1550: // The number of performance counters, the events they count, and their ! 1551: // usage is processor implementation-depedent. ! 1552: // ! 1553: // Mode: ! 1554: // ! 1555: // Kernel. ! 1556: // ! 1557: // Arguments: ! 1558: // ! 1559: // a0 - Supplies the number of the performance counter. ! 1560: // ! 1561: // a1 - Supplies a flag that indicates if the performance counter is ! 1562: // to be enabled or disabled (0 = disabled, non-zero = enabled). ! 1563: // ! 1564: // a2 - a5 - Supply processor implementation-dependent parameters. ! 1565: // ! 1566: // Return Value: ! 1567: // ! 1568: // v0 - 0 is returned if the operation is unsuccessful or the performance ! 1569: // counter does not exist. Otherwise, a non-zero value is returned. ! 1570: // ! 1571: // Registers Used: ! 1572: // ! 1573: // AT, a2 - a5. ! 1574: // ! 1575: //-- ! 1576: ! 1577: #define WRITE_PERFORMANCE_COUNTERS call_pal wrperfmon ! 1578: ! 1579: ! 1580: // ! 1581: // Define interfaces for controlling the state of machine checks. ! 1582: // ! 1583: ! 1584: //++ ! 1585: // ! 1586: // DRAIN_ABORTS ! 1587: // ! 1588: // Macro Description: ! 1589: // ! 1590: // Stall processor execution until all previous instructions have ! 1591: // executed to the point that any exceptions they may raise have been ! 1592: // signalled. ! 1593: // ! 1594: // Mode: ! 1595: // ! 1596: // Kernel. ! 1597: // ! 1598: // Arguments: ! 1599: // ! 1600: // None. ! 1601: // ! 1602: // Return Value: ! 1603: // ! 1604: // None. ! 1605: // ! 1606: // Registers Used: ! 1607: // ! 1608: // None. ! 1609: // ! 1610: //-- ! 1611: ! 1612: #define DRAIN_ABORTS call_pal draina ! 1613: ! 1614: ! 1615: //++ ! 1616: // ! 1617: // GET_MACHINE_CHECK_ERROR_SUMMARY ! 1618: // ! 1619: // Macro Description: ! 1620: // ! 1621: // Read the processor machine check error summary register. ! 1622: // ! 1623: // Mode: ! 1624: // ! 1625: // Kernel. ! 1626: // ! 1627: // Arguments: ! 1628: // ! 1629: // None. ! 1630: // ! 1631: // Return Value: ! 1632: // ! 1633: // v0 - The value of the MCES register. ! 1634: // ! 1635: // Registers Used: ! 1636: // ! 1637: // AT. ! 1638: // ! 1639: //-- ! 1640: ! 1641: #define GET_MACHINE_CHECK_ERROR_SUMMARY call_pal rdmces ! 1642: ! 1643: ! 1644: //++ ! 1645: // ! 1646: // WRITE_MACHINE_CHECK_ERROR_SUMMARY ! 1647: // ! 1648: // Macro Description: ! 1649: // ! 1650: // Write new values to the machine check error summary register. ! 1651: // ! 1652: // Mode: ! 1653: // ! 1654: // Kernel. ! 1655: // ! 1656: // Arguments: ! 1657: // ! 1658: // a0 - Supplies the values to write to the MCES register. ! 1659: // ! 1660: // Return Value: ! 1661: // ! 1662: // v0 - Previous value of the MCES register. ! 1663: // ! 1664: // Registers Used: ! 1665: // ! 1666: // AT, a1 - a3. ! 1667: // ! 1668: //-- ! 1669: ! 1670: #define WRITE_MACHINE_CHECK_ERROR_SUMMARY call_pal wrmces ! 1671: ! 1672: ! 1673: ! 1674: // ! 1675: // Define subtitle macro ! 1676: // ! 1677: ! 1678: #define SBTTL(x) ! 1679: ! 1680: // ! 1681: // Define mnemonic for writing callpal in assembly language that will ! 1682: // fit in the opcode field. ! 1683: // ! 1684: ! 1685: #define callpal call_pal ! 1686: ! 1687: // ! 1688: // Define exception data section and align. ! 1689: // ! 1690: // Nearly all source files that include this header file need the following ! 1691: // few pseudo-ops and so, by default, they are placed once here rather than ! 1692: // repeated in every source file. If these pseudo-ops are not needed, then ! 1693: // define HEADER_FILE prior to including this file. ! 1694: // ! 1695: // Also the PALCODE environment uses this include file but cannot use ! 1696: // these definitions. ! 1697: // ! 1698: ! 1699: #if !defined(HEADER_FILE) && !defined(PALCODE) ! 1700: ! 1701: .edata 0 ! 1702: .align 2 ! 1703: .text ! 1704: ! 1705: #endif
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.