1 // Copyright 2012 the V8 project authors. All rights reserved.
2 // Use of this source code is governed by a BSD-style license that can be
3 // found in the LICENSE file.
5 #ifndef V8_IA32_MACRO_ASSEMBLER_IA32_H_
6 #define V8_IA32_MACRO_ASSEMBLER_IA32_H_
8 #include "src/assembler.h"
9 #include "src/bailout-reason.h"
10 #include "src/frames.h"
11 #include "src/globals.h"
16 // Convenience for platform-independent signatures. We do not normally
17 // distinguish memory operands from other operands on ia32.
18 typedef Operand MemOperand;
20 enum RememberedSetAction { EMIT_REMEMBERED_SET, OMIT_REMEMBERED_SET };
21 enum SmiCheck { INLINE_SMI_CHECK, OMIT_SMI_CHECK };
22 enum PointersToHereCheck {
23 kPointersToHereMaybeInteresting,
24 kPointersToHereAreAlwaysInteresting
28 enum RegisterValueType {
29 REGISTER_VALUE_IS_SMI,
30 REGISTER_VALUE_IS_INT32
35 bool AreAliased(Register reg1,
37 Register reg3 = no_reg,
38 Register reg4 = no_reg,
39 Register reg5 = no_reg,
40 Register reg6 = no_reg,
41 Register reg7 = no_reg,
42 Register reg8 = no_reg);
46 // MacroAssembler implements a collection of frequently used macros.
47 class MacroAssembler: public Assembler {
49 // The isolate parameter can be NULL if the macro assembler should
50 // not use isolate-dependent functionality. In this case, it's the
51 // responsibility of the caller to never invoke such function on the
53 MacroAssembler(Isolate* isolate, void* buffer, int size);
55 void Load(Register dst, const Operand& src, Representation r);
56 void Store(Register src, const Operand& dst, Representation r);
58 // Operations on roots in the root-array.
59 void LoadRoot(Register destination, Heap::RootListIndex index);
60 void StoreRoot(Register source, Register scratch, Heap::RootListIndex index);
61 void CompareRoot(Register with, Register scratch, Heap::RootListIndex index);
62 // These methods can only be used with constant roots (i.e. non-writable
63 // and not in new space).
64 void CompareRoot(Register with, Heap::RootListIndex index);
65 void CompareRoot(const Operand& with, Heap::RootListIndex index);
67 // ---------------------------------------------------------------------------
69 enum RememberedSetFinalAction {
74 // Record in the remembered set the fact that we have a pointer to new space
75 // at the address pointed to by the addr register. Only works if addr is not
77 void RememberedSetHelper(Register object, // Used for debug code.
80 SaveFPRegsMode save_fp,
81 RememberedSetFinalAction and_then);
83 void CheckPageFlag(Register object,
88 Label::Distance condition_met_distance = Label::kFar);
90 void CheckPageFlagForMap(
95 Label::Distance condition_met_distance = Label::kFar);
97 void CheckMapDeprecated(Handle<Map> map,
99 Label* if_deprecated);
101 // Check if object is in new space. Jumps if the object is not in new space.
102 // The register scratch can be object itself, but scratch will be clobbered.
103 void JumpIfNotInNewSpace(Register object,
106 Label::Distance distance = Label::kFar) {
107 InNewSpace(object, scratch, zero, branch, distance);
110 // Check if object is in new space. Jumps if the object is in new space.
111 // The register scratch can be object itself, but it will be clobbered.
112 void JumpIfInNewSpace(Register object,
115 Label::Distance distance = Label::kFar) {
116 InNewSpace(object, scratch, not_zero, branch, distance);
119 // Check if an object has a given incremental marking color. Also uses ecx!
120 void HasColor(Register object,
124 Label::Distance has_color_distance,
128 void JumpIfBlack(Register object,
132 Label::Distance on_black_distance = Label::kFar);
134 // Checks the color of an object. If the object is already grey or black
135 // then we just fall through, since it is already live. If it is white and
136 // we can determine that it doesn't need to be scanned, then we just mark it
137 // black and fall through. For the rest we jump to the label so the
138 // incremental marker can fix its assumptions.
139 void EnsureNotWhite(Register object,
142 Label* object_is_white_and_not_data,
143 Label::Distance distance);
145 // Notify the garbage collector that we wrote a pointer into an object.
146 // |object| is the object being stored into, |value| is the object being
147 // stored. value and scratch registers are clobbered by the operation.
148 // The offset is the offset from the start of the object, not the offset from
149 // the tagged HeapObject pointer. For use with FieldOperand(reg, off).
150 void RecordWriteField(
155 SaveFPRegsMode save_fp,
156 RememberedSetAction remembered_set_action = EMIT_REMEMBERED_SET,
157 SmiCheck smi_check = INLINE_SMI_CHECK,
158 PointersToHereCheck pointers_to_here_check_for_value =
159 kPointersToHereMaybeInteresting);
161 // As above, but the offset has the tag presubtracted. For use with
162 // Operand(reg, off).
163 void RecordWriteContextSlot(
168 SaveFPRegsMode save_fp,
169 RememberedSetAction remembered_set_action = EMIT_REMEMBERED_SET,
170 SmiCheck smi_check = INLINE_SMI_CHECK,
171 PointersToHereCheck pointers_to_here_check_for_value =
172 kPointersToHereMaybeInteresting) {
173 RecordWriteField(context,
174 offset + kHeapObjectTag,
178 remembered_set_action,
180 pointers_to_here_check_for_value);
183 // Notify the garbage collector that we wrote a pointer into a fixed array.
184 // |array| is the array being stored into, |value| is the
185 // object being stored. |index| is the array index represented as a
186 // Smi. All registers are clobbered by the operation RecordWriteArray
187 // filters out smis so it does not update the write barrier if the
189 void RecordWriteArray(
193 SaveFPRegsMode save_fp,
194 RememberedSetAction remembered_set_action = EMIT_REMEMBERED_SET,
195 SmiCheck smi_check = INLINE_SMI_CHECK,
196 PointersToHereCheck pointers_to_here_check_for_value =
197 kPointersToHereMaybeInteresting);
199 // For page containing |object| mark region covering |address|
200 // dirty. |object| is the object being stored into, |value| is the
201 // object being stored. The address and value registers are clobbered by the
202 // operation. RecordWrite filters out smis so it does not update the
203 // write barrier if the value is a smi.
208 SaveFPRegsMode save_fp,
209 RememberedSetAction remembered_set_action = EMIT_REMEMBERED_SET,
210 SmiCheck smi_check = INLINE_SMI_CHECK,
211 PointersToHereCheck pointers_to_here_check_for_value =
212 kPointersToHereMaybeInteresting);
214 // For page containing |object| mark the region covering the object's map
215 // dirty. |object| is the object being stored into, |map| is the Map object
217 void RecordWriteForMap(
222 SaveFPRegsMode save_fp);
224 // ---------------------------------------------------------------------------
229 // Generates function and stub prologue code.
231 void Prologue(bool code_pre_aging);
233 // Enter specific kind of exit frame. Expects the number of
234 // arguments in register eax and sets up the number of arguments in
235 // register edi and the pointer to the first argument in register
237 void EnterExitFrame(bool save_doubles);
239 void EnterApiExitFrame(int argc);
241 // Leave the current exit frame. Expects the return value in
242 // register eax:edx (untouched) and the pointer to the first
243 // argument in register esi.
244 void LeaveExitFrame(bool save_doubles);
246 // Leave the current exit frame. Expects the return value in
247 // register eax (untouched).
248 void LeaveApiExitFrame(bool restore_context);
250 // Find the function context up the context chain.
251 void LoadContext(Register dst, int context_chain_length);
253 // Conditionally load the cached Array transitioned map of type
254 // transitioned_kind from the native context if the map in register
255 // map_in_out is the cached Array map in the native context of
257 void LoadTransitionedArrayMapConditional(
258 ElementsKind expected_kind,
259 ElementsKind transitioned_kind,
262 Label* no_map_match);
264 // Load the global function with the given index.
265 void LoadGlobalFunction(int index, Register function);
267 // Load the initial map from the global function. The registers
268 // function and map can be the same.
269 void LoadGlobalFunctionInitialMap(Register function, Register map);
271 // Push and pop the registers that can hold pointers.
272 void PushSafepointRegisters() { pushad(); }
273 void PopSafepointRegisters() { popad(); }
274 // Store the value in register/immediate src in the safepoint
275 // register stack slot for register dst.
276 void StoreToSafepointRegisterSlot(Register dst, Register src);
277 void StoreToSafepointRegisterSlot(Register dst, Immediate src);
278 void LoadFromSafepointRegisterSlot(Register dst, Register src);
280 void LoadHeapObject(Register result, Handle<HeapObject> object);
281 void CmpHeapObject(Register reg, Handle<HeapObject> object);
282 void PushHeapObject(Handle<HeapObject> object);
284 void LoadObject(Register result, Handle<Object> object) {
285 AllowDeferredHandleDereference heap_object_check;
286 if (object->IsHeapObject()) {
287 LoadHeapObject(result, Handle<HeapObject>::cast(object));
289 Move(result, Immediate(object));
293 void CmpObject(Register reg, Handle<Object> object) {
294 AllowDeferredHandleDereference heap_object_check;
295 if (object->IsHeapObject()) {
296 CmpHeapObject(reg, Handle<HeapObject>::cast(object));
298 cmp(reg, Immediate(object));
302 // ---------------------------------------------------------------------------
303 // JavaScript invokes
305 // Invoke the JavaScript function code by either calling or jumping.
306 void InvokeCode(Register code,
307 const ParameterCount& expected,
308 const ParameterCount& actual,
310 const CallWrapper& call_wrapper) {
311 InvokeCode(Operand(code), expected, actual, flag, call_wrapper);
314 void InvokeCode(const Operand& code,
315 const ParameterCount& expected,
316 const ParameterCount& actual,
318 const CallWrapper& call_wrapper);
320 // Invoke the JavaScript function in the given register. Changes the
321 // current context to the context in the function before invoking.
322 void InvokeFunction(Register function,
323 const ParameterCount& actual,
325 const CallWrapper& call_wrapper);
327 void InvokeFunction(Register function,
328 const ParameterCount& expected,
329 const ParameterCount& actual,
331 const CallWrapper& call_wrapper);
333 void InvokeFunction(Handle<JSFunction> function,
334 const ParameterCount& expected,
335 const ParameterCount& actual,
337 const CallWrapper& call_wrapper);
339 // Invoke specified builtin JavaScript function. Adds an entry to
340 // the unresolved list if the name does not resolve.
341 void InvokeBuiltin(Builtins::JavaScript id,
343 const CallWrapper& call_wrapper = NullCallWrapper());
345 // Store the function for the given builtin in the target register.
346 void GetBuiltinFunction(Register target, Builtins::JavaScript id);
348 // Store the code object for the given builtin in the target register.
349 void GetBuiltinEntry(Register target, Builtins::JavaScript id);
351 // Expression support
352 // cvtsi2sd instruction only writes to the low 64-bit of dst register, which
353 // hinders register renaming and makes dependence chains longer. So we use
354 // xorps to clear the dst register before cvtsi2sd to solve this issue.
355 void Cvtsi2sd(XMMRegister dst, Register src) { Cvtsi2sd(dst, Operand(src)); }
356 void Cvtsi2sd(XMMRegister dst, const Operand& src);
358 // Support for constant splitting.
359 bool IsUnsafeImmediate(const Immediate& x);
360 void SafeMove(Register dst, const Immediate& x);
361 void SafePush(const Immediate& x);
363 // Compare object type for heap object.
364 // Incoming register is heap_object and outgoing register is map.
365 void CmpObjectType(Register heap_object, InstanceType type, Register map);
367 // Compare instance type for map.
368 void CmpInstanceType(Register map, InstanceType type);
370 // Check if a map for a JSObject indicates that the object has fast elements.
371 // Jump to the specified label if it does not.
372 void CheckFastElements(Register map,
374 Label::Distance distance = Label::kFar);
376 // Check if a map for a JSObject indicates that the object can have both smi
377 // and HeapObject elements. Jump to the specified label if it does not.
378 void CheckFastObjectElements(Register map,
380 Label::Distance distance = Label::kFar);
382 // Check if a map for a JSObject indicates that the object has fast smi only
383 // elements. Jump to the specified label if it does not.
384 void CheckFastSmiElements(Register map,
386 Label::Distance distance = Label::kFar);
388 // Check to see if maybe_number can be stored as a double in
389 // FastDoubleElements. If it can, store it at the index specified by key in
390 // the FastDoubleElements array elements, otherwise jump to fail.
391 void StoreNumberToDoubleElements(Register maybe_number,
395 XMMRegister scratch2,
399 // Compare an object's map with the specified map.
400 void CompareMap(Register obj, Handle<Map> map);
402 // Check if the map of an object is equal to a specified map and branch to
403 // label if not. Skip the smi check if not required (object is known to be a
404 // heap object). If mode is ALLOW_ELEMENT_TRANSITION_MAPS, then also match
405 // against maps that are ElementsKind transition maps of the specified map.
406 void CheckMap(Register obj,
409 SmiCheckType smi_check_type);
411 // Check if the map of an object is equal to a specified map and branch to a
412 // specified target if equal. Skip the smi check if not required (object is
413 // known to be a heap object)
414 void DispatchMap(Register obj,
417 Handle<Code> success,
418 SmiCheckType smi_check_type);
420 // Check if the object in register heap_object is a string. Afterwards the
421 // register map contains the object map and the register instance_type
422 // contains the instance_type. The registers map and instance_type can be the
423 // same in which case it contains the instance type afterwards. Either of the
424 // registers map and instance_type can be the same as heap_object.
425 Condition IsObjectStringType(Register heap_object,
427 Register instance_type);
429 // Check if the object in register heap_object is a name. Afterwards the
430 // register map contains the object map and the register instance_type
431 // contains the instance_type. The registers map and instance_type can be the
432 // same in which case it contains the instance type afterwards. Either of the
433 // registers map and instance_type can be the same as heap_object.
434 Condition IsObjectNameType(Register heap_object,
436 Register instance_type);
438 // Check if a heap object's type is in the JSObject range, not including
439 // JSFunction. The object's map will be loaded in the map register.
440 // Any or all of the three registers may be the same.
441 // The contents of the scratch register will always be overwritten.
442 void IsObjectJSObjectType(Register heap_object,
447 // The contents of the scratch register will be overwritten.
448 void IsInstanceJSObjectType(Register map, Register scratch, Label* fail);
450 // FCmp is similar to integer cmp, but requires unsigned
451 // jcc instructions (je, ja, jae, jb, jbe, je, and jz).
454 void ClampUint8(Register reg);
456 void ClampDoubleToUint8(XMMRegister input_reg,
457 XMMRegister scratch_reg,
458 Register result_reg);
460 void SlowTruncateToI(Register result_reg, Register input_reg,
461 int offset = HeapNumber::kValueOffset - kHeapObjectTag);
463 void TruncateHeapNumberToI(Register result_reg, Register input_reg);
464 void TruncateDoubleToI(Register result_reg, XMMRegister input_reg);
466 void DoubleToI(Register result_reg, XMMRegister input_reg,
467 XMMRegister scratch, MinusZeroMode minus_zero_mode,
468 Label* lost_precision, Label* is_nan, Label* minus_zero,
469 Label::Distance dst = Label::kFar);
471 // Smi tagging support.
472 void SmiTag(Register reg) {
473 STATIC_ASSERT(kSmiTag == 0);
474 STATIC_ASSERT(kSmiTagSize == 1);
477 void SmiUntag(Register reg) {
478 sar(reg, kSmiTagSize);
481 // Modifies the register even if it does not contain a Smi!
482 void SmiUntag(Register reg, Label* is_smi) {
483 STATIC_ASSERT(kSmiTagSize == 1);
484 sar(reg, kSmiTagSize);
485 STATIC_ASSERT(kSmiTag == 0);
486 j(not_carry, is_smi);
489 void LoadUint32(XMMRegister dst, Register src);
491 // Jump the register contains a smi.
492 inline void JumpIfSmi(Register value,
494 Label::Distance distance = Label::kFar) {
495 test(value, Immediate(kSmiTagMask));
496 j(zero, smi_label, distance);
498 // Jump if the operand is a smi.
499 inline void JumpIfSmi(Operand value,
501 Label::Distance distance = Label::kFar) {
502 test(value, Immediate(kSmiTagMask));
503 j(zero, smi_label, distance);
505 // Jump if register contain a non-smi.
506 inline void JumpIfNotSmi(Register value,
507 Label* not_smi_label,
508 Label::Distance distance = Label::kFar) {
509 test(value, Immediate(kSmiTagMask));
510 j(not_zero, not_smi_label, distance);
513 void LoadInstanceDescriptors(Register map, Register descriptors);
514 void EnumLength(Register dst, Register map);
515 void NumberOfOwnDescriptors(Register dst, Register map);
517 template<typename Field>
518 void DecodeField(Register reg) {
519 static const int shift = Field::kShift;
520 static const int mask = Field::kMask >> Field::kShift;
524 and_(reg, Immediate(mask));
527 template<typename Field>
528 void DecodeFieldToSmi(Register reg) {
529 static const int shift = Field::kShift;
530 static const int mask = (Field::kMask >> Field::kShift) << kSmiTagSize;
531 STATIC_ASSERT((mask & (0x80000000u >> (kSmiTagSize - 1))) == 0);
532 STATIC_ASSERT(kSmiTag == 0);
533 if (shift < kSmiTagSize) {
534 shl(reg, kSmiTagSize - shift);
535 } else if (shift > kSmiTagSize) {
536 sar(reg, shift - kSmiTagSize);
538 and_(reg, Immediate(mask));
541 void LoadPowerOf2(XMMRegister dst, Register scratch, int power);
543 // Abort execution if argument is not a number, enabled via --debug-code.
544 void AssertNumber(Register object);
546 // Abort execution if argument is not a smi, enabled via --debug-code.
547 void AssertSmi(Register object);
549 // Abort execution if argument is a smi, enabled via --debug-code.
550 void AssertNotSmi(Register object);
552 // Abort execution if argument is not a string, enabled via --debug-code.
553 void AssertString(Register object);
555 // Abort execution if argument is not a name, enabled via --debug-code.
556 void AssertName(Register object);
558 // Abort execution if argument is not undefined or an AllocationSite, enabled
560 void AssertUndefinedOrAllocationSite(Register object);
562 // ---------------------------------------------------------------------------
563 // Exception handling
565 // Push a new try handler and link it into try handler chain.
566 void PushTryHandler(StackHandler::Kind kind, int handler_index);
568 // Unlink the stack handler on top of the stack from the try handler chain.
569 void PopTryHandler();
571 // Throw to the top handler in the try hander chain.
572 void Throw(Register value);
574 // Throw past all JS frames to the top JS entry frame.
575 void ThrowUncatchable(Register value);
577 // ---------------------------------------------------------------------------
578 // Inline caching support
580 // Generate code for checking access rights - used for security checks
581 // on access to global objects across environments. The holder register
582 // is left untouched, but the scratch register is clobbered.
583 void CheckAccessGlobalProxy(Register holder_reg,
588 void GetNumberHash(Register r0, Register scratch);
590 void LoadFromNumberDictionary(Label* miss,
599 // ---------------------------------------------------------------------------
600 // Allocation support
602 // Allocate an object in new space or old pointer space. If the given space
603 // is exhausted control continues at the gc_required label. The allocated
604 // object is returned in result and end of the new object is returned in
605 // result_end. The register scratch can be passed as no_reg in which case
606 // an additional object reference will be added to the reloc info. The
607 // returned pointers in result and result_end have not yet been tagged as
608 // heap objects. If result_contains_top_on_entry is true the content of
609 // result is known to be the allocation top on entry (could be result_end
610 // from a previous call). If result_contains_top_on_entry is true scratch
611 // should be no_reg as it is never used.
612 void Allocate(int object_size,
617 AllocationFlags flags);
619 void Allocate(int header_size,
620 ScaleFactor element_size,
621 Register element_count,
622 RegisterValueType element_count_type,
627 AllocationFlags flags);
629 void Allocate(Register object_size,
634 AllocationFlags flags);
636 // Undo allocation in new space. The object passed and objects allocated after
637 // it will no longer be allocated. Make sure that no pointers are left to the
638 // object(s) no longer allocated as they would be invalid when allocation is
640 void UndoAllocationInNewSpace(Register object);
642 // Allocate a heap number in new space with undefined value. The
643 // register scratch2 can be passed as no_reg; the others must be
644 // valid registers. Returns tagged pointer in result register, or
645 // jumps to gc_required if new space is full.
646 void AllocateHeapNumber(Register result,
650 MutableMode mode = IMMUTABLE);
652 // Allocate a float32x4, float64x2 and int32x4 object in new space with
654 // Returns tagged pointer in result register, or jumps to gc_required if new
656 void AllocateFloat32x4(Register result,
661 void AllocateFloat64x2(Register result,
666 void AllocateInt32x4(Register result,
671 // Allocate a sequential string. All the header fields of the string object
673 void AllocateTwoByteString(Register result,
679 void AllocateOneByteString(Register result, Register length,
680 Register scratch1, Register scratch2,
681 Register scratch3, Label* gc_required);
682 void AllocateOneByteString(Register result, int length, Register scratch1,
683 Register scratch2, Label* gc_required);
685 // Allocate a raw cons string object. Only the map field of the result is
687 void AllocateTwoByteConsString(Register result,
691 void AllocateOneByteConsString(Register result, Register scratch1,
692 Register scratch2, Label* gc_required);
694 // Allocate a raw sliced string object. Only the map field of the result is
696 void AllocateTwoByteSlicedString(Register result,
700 void AllocateOneByteSlicedString(Register result, Register scratch1,
701 Register scratch2, Label* gc_required);
703 // Copy memory, byte-by-byte, from source to destination. Not optimized for
704 // long or aligned copies.
705 // The contents of index and scratch are destroyed.
706 void CopyBytes(Register source,
707 Register destination,
711 // Initialize fields with filler values. Fields starting at |start_offset|
712 // not including end_offset are overwritten with the value in |filler|. At
713 // the end the loop, |start_offset| takes the value of |end_offset|.
714 void InitializeFieldsWithFiller(Register start_offset,
718 // ---------------------------------------------------------------------------
719 // Support functions.
721 // Check a boolean-bit of a Smi field.
722 void BooleanBitTest(Register object, int field_offset, int bit_index);
724 // Check if result is zero and op is negative.
725 void NegativeZeroTest(Register result, Register op, Label* then_label);
727 // Check if result is zero and any of op1 and op2 are negative.
728 // Register scratch is destroyed, and it must be different from op2.
729 void NegativeZeroTest(Register result, Register op1, Register op2,
730 Register scratch, Label* then_label);
732 // Try to get function prototype of a function and puts the value in
733 // the result register. Checks that the function really is a
734 // function and jumps to the miss label if the fast checks fail. The
735 // function register will be untouched; the other registers may be
737 void TryGetFunctionPrototype(Register function,
741 bool miss_on_bound_function = false);
743 // Picks out an array index from the hash field.
745 // hash - holds the index's hash. Clobbered.
746 // index - holds the overwritten index on exit.
747 void IndexFromHash(Register hash, Register index);
749 // ---------------------------------------------------------------------------
752 // Call a code stub. Generate the code if necessary.
753 void CallStub(CodeStub* stub, TypeFeedbackId ast_id = TypeFeedbackId::None());
755 // Tail call a code stub (jump). Generate the code if necessary.
756 void TailCallStub(CodeStub* stub);
758 // Return from a code stub after popping its arguments.
759 void StubReturn(int argc);
761 // Call a runtime routine.
762 void CallRuntime(const Runtime::Function* f,
764 SaveFPRegsMode save_doubles = kDontSaveFPRegs);
765 void CallRuntimeSaveDoubles(Runtime::FunctionId id) {
766 const Runtime::Function* function = Runtime::FunctionForId(id);
767 CallRuntime(function, function->nargs, kSaveFPRegs);
770 // Convenience function: Same as above, but takes the fid instead.
771 void CallRuntime(Runtime::FunctionId id,
773 SaveFPRegsMode save_doubles = kDontSaveFPRegs) {
774 CallRuntime(Runtime::FunctionForId(id), num_arguments, save_doubles);
777 // Convenience function: call an external reference.
778 void CallExternalReference(ExternalReference ref, int num_arguments);
780 // Tail call of a runtime routine (jump).
781 // Like JumpToExternalReference, but also takes care of passing the number
783 void TailCallExternalReference(const ExternalReference& ext,
787 // Convenience function: tail call a runtime routine (jump).
788 void TailCallRuntime(Runtime::FunctionId fid,
792 // Before calling a C-function from generated code, align arguments on stack.
793 // After aligning the frame, arguments must be stored in esp[0], esp[4],
794 // etc., not pushed. The argument count assumes all arguments are word sized.
795 // Some compilers/platforms require the stack to be aligned when calling
797 // Needs a scratch register to do some arithmetic. This register will be
799 void PrepareCallCFunction(int num_arguments, Register scratch);
801 // Calls a C function and cleans up the space for arguments allocated
802 // by PrepareCallCFunction. The called function is not allowed to trigger a
803 // garbage collection, since that might move the code and invalidate the
804 // return address (unless this is somehow accounted for by the called
806 void CallCFunction(ExternalReference function, int num_arguments);
807 void CallCFunction(Register function, int num_arguments);
809 // Prepares stack to put arguments (aligns and so on). Reserves
810 // space for return value if needed (assumes the return value is a handle).
811 // Arguments must be stored in ApiParameterOperand(0), ApiParameterOperand(1)
812 // etc. Saves context (esi). If space was reserved for return value then
813 // stores the pointer to the reserved slot into esi.
814 void PrepareCallApiFunction(int argc);
816 // Calls an API function. Allocates HandleScope, extracts returned value
817 // from handle and propagates exceptions. Clobbers ebx, edi and
818 // caller-save registers. Restores context. On return removes
819 // stack_space * kPointerSize (GCed).
820 void CallApiFunctionAndReturn(Register function_address,
821 ExternalReference thunk_ref,
822 Operand thunk_last_arg,
824 Operand return_value_operand,
825 Operand* context_restore_operand);
827 // Jump to a runtime routine.
828 void JumpToExternalReference(const ExternalReference& ext);
830 // ---------------------------------------------------------------------------
835 // Return and drop arguments from stack, where the number of arguments
836 // may be bigger than 2^16 - 1. Requires a scratch register.
837 void Ret(int bytes_dropped, Register scratch);
839 // Emit code to discard a non-negative number of pointer-sized elements
840 // from the stack, clobbering only the esp register.
841 void Drop(int element_count);
843 void Call(Label* target) { call(target); }
844 void Push(Register src) { push(src); }
845 void Pop(Register dst) { pop(dst); }
847 // Emit call to the code we are currently generating.
849 Handle<Code> self(reinterpret_cast<Code**>(CodeObject().location()));
850 call(self, RelocInfo::CODE_TARGET);
853 // Move if the registers are not identical.
854 void Move(Register target, Register source);
856 // Move a constant into a destination using the most efficient encoding.
857 void Move(Register dst, const Immediate& x);
858 void Move(const Operand& dst, const Immediate& x);
860 // Move an immediate into an XMM register.
861 void Move(XMMRegister dst, double val);
863 // Push a handle value.
864 void Push(Handle<Object> handle) { push(Immediate(handle)); }
865 void Push(Smi* smi) { Push(Handle<Smi>(smi, isolate())); }
867 Handle<Object> CodeObject() {
868 DCHECK(!code_object_.is_null());
872 // Emit code for a truncating division by a constant. The dividend register is
873 // unchanged, the result is in edx, and eax gets clobbered.
874 void TruncatingDiv(Register dividend, int32_t divisor);
876 // ---------------------------------------------------------------------------
877 // StatsCounter support
879 void SetCounter(StatsCounter* counter, int value);
880 void IncrementCounter(StatsCounter* counter, int value);
881 void DecrementCounter(StatsCounter* counter, int value);
882 void IncrementCounter(Condition cc, StatsCounter* counter, int value);
883 void DecrementCounter(Condition cc, StatsCounter* counter, int value);
886 // ---------------------------------------------------------------------------
889 // Calls Abort(msg) if the condition cc is not satisfied.
890 // Use --debug_code to enable.
891 void Assert(Condition cc, BailoutReason reason);
893 void AssertFastElements(Register elements);
895 // Like Assert(), but always enabled.
896 void Check(Condition cc, BailoutReason reason);
898 // Print a message to stdout and abort execution.
899 void Abort(BailoutReason reason);
901 // Check that the stack is aligned.
902 void CheckStackAlignment();
904 // Verify restrictions about code generated in stubs.
905 void set_generating_stub(bool value) { generating_stub_ = value; }
906 bool generating_stub() { return generating_stub_; }
907 void set_has_frame(bool value) { has_frame_ = value; }
908 bool has_frame() { return has_frame_; }
909 inline bool AllowThisStubCall(CodeStub* stub);
911 // ---------------------------------------------------------------------------
913 void absps(XMMRegister dst);
914 void abspd(XMMRegister dst);
915 void negateps(XMMRegister dst);
916 void negatepd(XMMRegister dst);
917 void notps(XMMRegister dst);
918 void pnegd(XMMRegister dst);
920 // ---------------------------------------------------------------------------
923 // Generate code to do a lookup in the number string cache. If the number in
924 // the register object is found in the cache the generated code falls through
925 // with the result in the result register. The object and the result register
926 // can be the same. If the number is not found in the cache the code jumps to
927 // the label not_found with only the content of register object unchanged.
928 void LookupNumberStringCache(Register object,
934 // Check whether the instance type represents a flat one-byte string. Jump to
935 // the label if not. If the instance type can be scratched specify same
936 // register for both instance type and scratch.
937 void JumpIfInstanceTypeIsNotSequentialOneByte(
938 Register instance_type, Register scratch,
939 Label* on_not_flat_one_byte_string);
941 // Checks if both objects are sequential one-byte strings, and jumps to label
943 void JumpIfNotBothSequentialOneByteStrings(
944 Register object1, Register object2, Register scratch1, Register scratch2,
945 Label* on_not_flat_one_byte_strings);
947 // Checks if the given register or operand is a unique name
948 void JumpIfNotUniqueNameInstanceType(Register reg, Label* not_unique_name,
949 Label::Distance distance = Label::kFar) {
950 JumpIfNotUniqueNameInstanceType(Operand(reg), not_unique_name, distance);
953 void JumpIfNotUniqueNameInstanceType(Operand operand, Label* not_unique_name,
954 Label::Distance distance = Label::kFar);
956 void EmitSeqStringSetCharCheck(Register string,
959 uint32_t encoding_mask);
961 static int SafepointRegisterStackIndex(Register reg) {
962 return SafepointRegisterStackIndex(reg.code());
965 // Activation support.
966 void EnterFrame(StackFrame::Type type);
967 void LeaveFrame(StackFrame::Type type);
969 // Expects object in eax and returns map with validated enum cache
970 // in eax. Assumes that any other register can be used as a scratch.
971 void CheckEnumCache(Label* call_runtime);
973 // AllocationMemento support. Arrays may have an associated
974 // AllocationMemento object that can be checked for in order to pretransition
976 // On entry, receiver_reg should point to the array object.
977 // scratch_reg gets clobbered.
978 // If allocation info is present, conditional code is set to equal.
979 void TestJSArrayForAllocationMemento(Register receiver_reg,
980 Register scratch_reg,
981 Label* no_memento_found);
983 void JumpIfJSArrayHasAllocationMemento(Register receiver_reg,
984 Register scratch_reg,
985 Label* memento_found) {
986 Label no_memento_found;
987 TestJSArrayForAllocationMemento(receiver_reg, scratch_reg,
989 j(equal, memento_found);
990 bind(&no_memento_found);
993 // Jumps to found label if a prototype map has dictionary elements.
994 void JumpIfDictionaryInPrototypeChain(Register object, Register scratch0,
995 Register scratch1, Label* found);
998 bool generating_stub_;
1000 // This handle will be patched with the code object on installation.
1001 Handle<Object> code_object_;
1003 // Helper functions for generating invokes.
1004 void InvokePrologue(const ParameterCount& expected,
1005 const ParameterCount& actual,
1006 Handle<Code> code_constant,
1007 const Operand& code_operand,
1009 bool* definitely_mismatches,
1011 Label::Distance done_distance,
1012 const CallWrapper& call_wrapper = NullCallWrapper());
1014 void EnterExitFramePrologue();
1015 void EnterExitFrameEpilogue(int argc, bool save_doubles);
1017 void LeaveExitFrameEpilogue(bool restore_context);
1019 // Allocation support helpers.
1020 void LoadAllocationTopHelper(Register result,
1022 AllocationFlags flags);
1024 void UpdateAllocationTopHelper(Register result_end,
1026 AllocationFlags flags);
1028 // Helper for implementing JumpIfNotInNewSpace and JumpIfInNewSpace.
1029 void InNewSpace(Register object,
1032 Label* condition_met,
1033 Label::Distance condition_met_distance = Label::kFar);
1035 // Helper for finding the mark bits for an address. Afterwards, the
1036 // bitmap register points at the word with the mark bits and the mask
1037 // the position of the first bit. Uses ecx as scratch and leaves addr_reg
1039 inline void GetMarkBits(Register addr_reg,
1040 Register bitmap_reg,
1043 // Helper for throwing exceptions. Compute a handler address and jump to
1044 // it. See the implementation for register usage.
1045 void JumpToHandlerEntry();
1047 // Compute memory operands for safepoint stack slots.
1048 Operand SafepointRegisterSlot(Register reg);
1049 static int SafepointRegisterStackIndex(int reg_code);
1051 // Needs access to SafepointRegisterStackIndex for compiled frame
1053 friend class StandardFrame;
1057 // The code patcher is used to patch (typically) small parts of code e.g. for
1058 // debugging and other types of instrumentation. When using the code patcher
1059 // the exact number of bytes specified must be emitted. Is not legal to emit
1060 // relocation information. If any of these constraints are violated it causes
1064 CodePatcher(byte* address, int size);
1065 virtual ~CodePatcher();
1067 // Macro assembler to emit code.
1068 MacroAssembler* masm() { return &masm_; }
1071 byte* address_; // The address of the code being patched.
1072 int size_; // Number of bytes of the expected patch size.
1073 MacroAssembler masm_; // Macro assembler used to generate the code.
1077 // -----------------------------------------------------------------------------
1078 // Static helper functions.
1080 // Generate an Operand for loading a field from an object.
1081 inline Operand FieldOperand(Register object, int offset) {
1082 return Operand(object, offset - kHeapObjectTag);
1086 // Generate an Operand for loading an indexed field from an object.
1087 inline Operand FieldOperand(Register object,
1091 return Operand(object, index, scale, offset - kHeapObjectTag);
1095 inline Operand FixedArrayElementOperand(Register array,
1096 Register index_as_smi,
1097 int additional_offset = 0) {
1098 int offset = FixedArray::kHeaderSize + additional_offset * kPointerSize;
1099 return FieldOperand(array, index_as_smi, times_half_pointer_size, offset);
1103 inline Operand ContextOperand(Register context, int index) {
1104 return Operand(context, Context::SlotOffset(index));
1108 inline Operand GlobalObjectOperand() {
1109 return ContextOperand(esi, Context::GLOBAL_OBJECT_INDEX);
1113 // Generates an Operand for saving parameters after PrepareCallApiFunction.
1114 Operand ApiParameterOperand(int index);
1117 #ifdef GENERATED_CODE_COVERAGE
1118 extern void LogGeneratedCodeCoverage(const char* file_line);
1119 #define CODE_COVERAGE_STRINGIFY(x) #x
1120 #define CODE_COVERAGE_TOSTRING(x) CODE_COVERAGE_STRINGIFY(x)
1121 #define __FILE_LINE__ __FILE__ ":" CODE_COVERAGE_TOSTRING(__LINE__)
1122 #define ACCESS_MASM(masm) { \
1123 byte* ia32_coverage_function = \
1124 reinterpret_cast<byte*>(FUNCTION_ADDR(LogGeneratedCodeCoverage)); \
1127 masm->push(Immediate(reinterpret_cast<int>(&__FILE_LINE__))); \
1128 masm->call(ia32_coverage_function, RelocInfo::RUNTIME_ENTRY); \
1135 #define ACCESS_MASM(masm) masm->
1139 } } // namespace v8::internal
1141 #endif // V8_IA32_MACRO_ASSEMBLER_IA32_H_