Repository navigation
Expand file tree
/
Copy pathAccessor.java
More file actions
534 lines (464 loc) · 17.5 KB
/
Copy pathAccessor.java
File metadata and controls
534 lines (464 loc) · 17.5 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
/*
* Copyright (c) 2007 Sun Microsystems, Inc. All rights reserved.
*
* Sun Microsystems, Inc. has intellectual property rights relating to technology embodied in the product
* that is described in this document. In particular, and without limitation, these intellectual property
* rights may include one or more of the U.S. patents listed at http://www.sun.com/patents and one or
* more additional patents or pending patent applications in the U.S. and in other countries.
*
* U.S. Government Rights - Commercial software. Government users are subject to the Sun
* Microsystems, Inc. standard license agreement and applicable provisions of the FAR and its
* supplements.
*
* Use is subject to license terms. Sun, Sun Microsystems, the Sun logo, Java and Solaris are trademarks or
* registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. All SPARC trademarks
* are used under license and are trademarks or registered trademarks of SPARC International, Inc. in the
* U.S. and other countries.
*
* UNIX is a registered trademark in the U.S. and other countries, exclusively licensed through X/Open
* Company, Ltd.
*/
package com.sun.max.unsafe;
import com.sun.max.vm.reference.*;
/**
* ATTENTION: DO NOT USE THIS INTERFACE UNLESS YOU KNOW EXACTLY WHAT YOU ARE DOING!!!
*
* Common interface for pointers and for object references.
*
* The object layout implementation is written ONCE against this type
* (instead of twice, once against Pointer and once against Reference).
*
* @author Bernd Mathiske
* @author Paul Caprioli
*/
public interface Accessor {
/**
* Tests whether this is zero.
* @return true if all bits are zero.
*/
boolean isZero();
/**
* Reads a byte at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the byte value
*/
byte readByte(Offset offset);
/**
* Reads a byte at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the byte value
*/
byte readByte(int offset);
/**
* Gets a byte at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in bytes
* @return the byte value
*/
byte getByte(int displacement, int index);
/**
* Writes a byte at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeByte(Offset offset, byte value);
/**
* Writes a byte at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeByte(int offset, byte value);
/**
* Writes a byte at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in bytes
* @param value the data to be written
*/
void setByte(int displacement, int index, byte value);
/**
* Reads a boolean at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the boolean value
*/
boolean readBoolean(Offset offset);
/**
* Reads a boolean at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the boolean value
*/
boolean readBoolean(int offset);
/**
* Gets a boolean at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in bytes
* @return the boolean value
*/
boolean getBoolean(int displacement, int index);
/**
* Writes a boolean at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeBoolean(Offset offset, boolean value);
/**
* Writes a boolean at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeBoolean(int offset, boolean value);
/**
* Writes a boolean at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in bytes
* @param value the data to be written
*/
void setBoolean(int displacement, int index, boolean value);
/**
* Reads a short at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the short value
*/
short readShort(Offset offset);
/**
* Reads a short at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the short value
*/
short readShort(int offset);
/**
* Gets a short at the scaled index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in shorts
* @return the short value
*/
short getShort(int displacement, int index);
/**
* Writes a short at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeShort(Offset offset, short value);
/**
* Writes a short at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeShort(int offset, short value);
/**
* Writes a short at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in shorts
* @param value the data to be written
*/
void setShort(int displacement, int index, short value);
/**
* Reads a character at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the character value
*/
char readChar(Offset offset);
/**
* Reads a character at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the character value
*/
char readChar(int offset);
/**
* Gets a character at the scaled index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in chars
* @return the character value
*/
char getChar(int displacement, int index);
/**
* Writes a character at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeChar(Offset offset, char value);
/**
* Writes a character at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeChar(int offset, char value);
/**
* Writes a character at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in characters
* @param value the data to be written
*/
void setChar(int displacement, int index, char value);
/**
* Reads an integer at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the integer value
*/
int readInt(Offset offset);
/**
* Reads an integer at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the integer value
*/
int readInt(int offset);
/**
* Gets an integer at the scaled index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in ints
* @return the integer value
*/
int getInt(int displacement, int index);
/**
* Writes an integer at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeInt(Offset offset, int value);
/**
* Writes an integer at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeInt(int offset, int value);
/**
* Writes an integer at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in ints
* @param value the data to be written
*/
void setInt(int displacement, int index, int value);
/**
* Reads a float at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the float value
*/
float readFloat(Offset offset);
/**
* Reads a float at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the float value
*/
float readFloat(int offset);
/**
* Gets a float at the scaled index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in floats
* @return the float value
*/
float getFloat(int displacement, int index);
/**
* Writes a float at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeFloat(Offset offset, float value);
/**
* Writes a float at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeFloat(int offset, float value);
/**
* Writes a float at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in floats
* @param value the data to be written
*/
void setFloat(int displacement, int index, float value);
/**
* Reads a long at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the long value
*/
long readLong(Offset offset);
/**
* Reads a long at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the long value
*/
long readLong(int offset);
/**
* Gets a long at the scaled index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in longs
* @return the long value
*/
long getLong(int displacement, int index);
/**
* Writes a long at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeLong(Offset offset, long value);
/**
* Writes a long at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeLong(int offset, long value);
/**
* Writes a long at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in longs
* @param value the data to be written
*/
void setLong(int displacement, int index, long value);
/**
* Reads a double at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the double value
*/
double readDouble(Offset offset);
/**
* Reads a double at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the double value
*/
double readDouble(int offset);
/**
* Gets a double at the scaled index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in doubles
* @return the double value
*/
double getDouble(int displacement, int index);
/**
* Writes a double at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeDouble(Offset offset, double value);
/**
* Writes a double at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeDouble(int offset, double value);
/**
* Writes a double at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in doubles
* @param value the data to be written
*/
void setDouble(int displacement, int index, double value);
/**
* Reads a Word at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the Word value
*/
Word readWord(Offset offset);
/**
* Reads a Word at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the Word value
*/
Word readWord(int offset);
/**
* Gets a Word at the scaled index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in Words
* @return the Word value
*/
Word getWord(int displacement, int index);
/**
* Writes a Word at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeWord(Offset offset, Word value);
/**
* Writes a Word at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeWord(int offset, Word value);
/**
* Writes a Word at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in Words
* @param value the data to be written
*/
void setWord(int displacement, int index, Word value);
/**
* Reads a Reference at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the Reference value
*/
Reference readReference(Offset offset);
/**
* Reads a Reference at an offset from this location.
* @param offset the signed offset in bytes from this
* @return the Reference value
*/
Reference readReference(int offset);
/**
* Gets a Reference at the scaled index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in References
* @return the Reference value
*/
Reference getReference(int displacement, int index);
/**
* Writes a Reference at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeReference(Offset offset, Reference value);
/**
* Writes a Reference at an offset from this location.
* @param offset the signed offset in bytes from this
* @param value the data to be written
*/
void writeReference(int offset, Reference value);
/**
* Writes a Reference at index plus displacement from this location.
* @param displacement signed displacement in bytes
* @param index signed index measured in References
* @param value the data to be written
*/
void setReference(int displacement, int index, Reference value);
/**
* Atomic compare and swap.
*
* Compares an expected value with the actual value in a location denoted by this accessor and a given offset.
* Iff they are same, {@code newValue} is placed into the location and the {@code expectedValue} is returned.
* Otherwise, the actual value is returned.
* All of the above is performed in one atomic hardware transaction.
*
* @param offset offset from accessor origin
* @param expectedValue if this value is currently in the accessor location, perform the swap
* @param newValue the new value to put into the accessor location
* @return either {@code expectedValue} or the actual value
*/
int compareAndSwapInt(Offset offset, int expectedValue, int newValue);
/**
* @see #compareAndSwapInt(Offset, int, int)
*/
int compareAndSwapInt(int offset, int expectedValue, int newValue);
/**
* @see #compareAndSwapInt(Offset, int, int)
*/
Word compareAndSwapWord(Offset offset, Word expectedValue, Word newValue);
/**
* @see #compareAndSwapInt(Offset, int, int)
*/
Word compareAndSwapWord(int offset, Word expectedValue, Word newValue);
/**
* @see #compareAndSwapInt(Offset, int, int)
*/
Reference compareAndSwapReference(Offset offset, Reference expectedValue, Reference newValue);
/**
* @see #compareAndSwapInt(Offset, int, int)
*/
Reference compareAndSwapReference(int offset, Reference expectedValue, Reference newValue);
/**
* Copies elements from this array into a given array.
*
* @param displacement signed displacement in bytes
* @param srcIndex the index in this array from which to copy
* @param dst the array into which the elements will be read
* @param dstIndex the index in {@code dst} to which to copy
* @param length the number of elements to copy
*/
void copyElements(int displacement, int srcIndex, Object dst, int dstIndex, int length);
}