Lines Matching +full:guest +full:- +full:index +full:- +full:bits
3 Publication date 2017-09-25 08:21
5 Extracted via "pdftotext -f 547 -l 572 -layout sun4v_20170925.pdf"
16 live-migration and other system management activities.
20 …high speed processoring of database-centric operations. The coprocessors may support one or more of
28 …e Completion Area and, unless execution order is specifically restricted through the use of serial-
32 …Guest software may implement a software timeout on CCB operations, and if the timeout is exceeded,…
33 …tion may be cancelled or killed via the ccb_kill API function. It is recommended for guest software
38 …There is no fixed limit on the number of outstanding CCBs guest software may have queued in the vi…
45 …device node in the guest MD (Section 8.24.17, “Database Analytics Accelerators (DAX) virtual-device
51 36.1.1.1. "ORCL,sun4v-dax" Device Compatibility
54 • No-op/Sync
81 36.1.1.2. "ORCL,sun4v-dax-fc" Device Compatibility
82 … "ORCL,sun4v-dax-fc" is compatible with the "ORCL,sun4v-dax" interface, and includes additional CCB
85 36.1.1.3. "ORCL,sun4v-dax2" Device Compatibility
88 • No-op/Sync
112 …The DAX virtual device has multiple interrupts associated with it which may be used by the guest if
113 …desired. The number of device interrupts available to the guest is indicated in the virtual device…
114 …guest MD (Section 8.24.17, “Database Analytics Accelerators (DAX) virtual-device node”). If the de…
115 …node indicates N interrupts available, the guest may use any value from 0 to N - 1 (inclusive) in …
136 All CCBs begin with a common 32-bit header.
139 Bits Field Description
148 0x00 No Operation (No-op) or Sync
179 Bits Field Description
213 and Serial to allow execution chaining. The flags do NOT allow fan-out chaining, where multiple CCBs
220 Both the Pipeline and Serial bits must be set in the source CCB. The Conditional bit must be set in…
223 with both the Pipeline and Serial bits set, proceed through CCBs with the Pipeline, Serial, and Con…
224 bits set, and terminate at a CCB that has the Conditional bit set, but not the Pipeline bit.
240 …resubmitted after inserting the translation, or the address may be translated by guest software and
248 encoded data) and secondary data streams (meta-data for the encoded data).
252 …The primary input format code is a 4-bit field when it is used. There are 10 primary input formats…
257 …0x1 Fixed width bit packed Up to 15 bits (CCB version 0) or 23 bits (CCB vers…
258 … 1); bits are read most significant bit to least significant bit
264 … 0x5 Fixed width bit packed with run Up to 15 bits (CCB version 0) or 23 bits (CCB version
265 … length encoding 1); bits are read most significant bit to least significant bit
269 … Huffman (CCB version 0) or bits are read most significant bit to least significant bit
272 … 0x9 Fixed width bit packed with Up to 15 bits (CCB version 0) or 23 bits (CCB version
273 … Huffman (CCB version 0) or 1); compressed stream bits are read most significant bit to
277 … Huffman (CCB version 0) or bits are read most significant bit to least significant bit
289 … run length encoding, followed by bits are read most significant bit to least significant bit
293 …0xD Fixed width bit packed with Up to 15 bits (CCB version 0) or 23 bits(CCB versi…
294 … run length encoding, followed by before the encoding; compressed stream bits are read most
304 …command. The size is encoded as the number of bits or bytes, minus one. The valid value range for …
310 …always encoded in a fixed width, bit-packed format. The bits are read from most significant bit to…
327 0x1 2 bits
328 0x2 4 bits
329 0x3 8 bits
333 …Bit-wise input data streams may have any alignment within the base addressed byte. The offset, spe…
338 This field should be zero for any byte-wise primary input data streams.
349 supported for every command. The format is indicated by a 4-bit field in the CCB:
365 0xD 2 byte elements where each element is the index value of a bit,
367 0xE 4 byte elements where each element is the index value of a bit,
383 …subsequent data chunks may not be detected, so guest software should be careful to use page size c…
390 …address. When using real addresses, the guest must supply the page size in the same field as the a…
405 …The only supported output format is a padded, byte-aligned output stream, using output codes 0x0 -…
407 …ted input element. First, if the decompressed input size is not a whole number of bytes, 0 bits are
410 …CCB. If the output element size is smaller than the byte-padded input element size, the input elem…
416 The extract CCB is a 64-byte “short format” CCB.
418 …he extract CCB command format can be specified by the following packed C structure for a big-endian
440 Bits Field Description
458 Bits Field Description
468 Bits Field Description
472 the device interrupt number specified in the lower bits of this
473 completion word. If 0, the lower bits of this completion word
475 [58:6] Completion area address bits [58:6]. Address type is
480 Bits Field Description
483 [59:56] If using real address, these bits should be filled in with the
484 page size code for the page boundary checking the guest wants
488 be used as as primary input address bits [59:56].
489 [55:0] Primary input address bits [55:0]. Address type is determined
492 Bits Field Description
496 0b'01 Enable flow control (only valid with "ORCL,sun4v-
497 dax-fc" compatible virtual device variants)
508 Bits Field Description
536 0b'10 Number of primary bits
548 # of primary bits Number of input bits to process,
558 Bits Field Description
563 … bits skipped by the Primary Input
571 Bits Field Description
574 … [59:56] If using real address, these bits should be filled in with the
575 … page size code for the page boundary checking the guest wants
579 … be used as as symbol table address bits [59:56].
580 … [55:4] Symbol table address bits [55:4]. Address type is determined
596 …range commands, the boundary conditions can be specified as greater-than-or-equal-to a value, less-
597 than-or-equal-to a value, or both by using two boundary values.
599 …There are two supported formats for the output stream: the bit vector and index array formats (cod…
602 …inverted scan command inverts the polarity of the bits in the output. The most significant bit of …
603 …of the output stream corresponds to the first element in the input stream. The standard index array
612 entry is the index of an input element that matched the scan criteria. An inverted scan command pro…
619 These commands are 128-byte “long format” CCBs.
621 The scan CCB command format can be specified by the following packed C structure for a big-endian
647 Bits Field Description
671 Bits Field Description
673 operand, minus 1. Values 0xF-0x1E are reserved. A value of
679 operand, minus 1. Values 0xF-0x1E are reserved. A value of
687 than 4 bytes, the value is left-aligned to the lowest address bytes.
689 is less than 4 bytes, the value is left-aligned to the lowest address bytes.
695 is less than 8 bytes, the valid bytes are left-aligned to the lowest address.
698 operand is less than 8 bytes, the valid bytes are left-aligned to the lowest
702 is less than 12 bytes, the valid bytes are left-aligned to the lowest address.
705 operand is less than 12 bytes, the valid bytes are left-aligned to the lowest
709 is less than 16 bytes, the valid bytes are left-aligned to the lowest address.
712 operand is less than 16 bytes, the valid bytes are left-aligned to the lowest
725 …indices, and outputs a bit vector or index array created by reading the tables bit value at each i…
726 …the input array. The output should therefore contain exactly one bit per index in the input data s…
727 …when outputting as a bit vector. When outputting as an index array, the number of elements depends…
732 …The maximum table index size allowed is 15 bits, however, larger input elements may be used to pro…
733 … processing of the output values. If 2 or 3 byte values are used, the least significant 15 bits are
734 …used as an index into the bit table. The most significant 9 bits (when using 3-byte input elements…
735 …bit (when using 2-byte input elements) are compared against a fixed 9-bit test value provided in t…
740 …additional processing based on any additional non-index bits remains unchanged, and still forces t…
744 …There are two supported formats for the output stream: the bit vector and index array formats (cod…
745 …0xD, and 0xE). The index array format is an array of indices of bits which would have been set if …
748 …The return value of the CCB completion area contains the number of bits set in the output bit vect…
749 …or number of elements in the output index array. The “number of elements processed” field in the C…
752 These commands are 64-byte “short format” CCBs.
754 … translate CCB command format can be specified by the following packed C structure for a big-endian
784 Bits Field Description
799 [8:0] Test value used for comparison against the most significant bits
810 Bits Field Description
813 [59:56] If using real address, these bits should be filled in with the
814 page size code for the page boundary checking the guest wants
818 be used as as bit table address bits [59:56]
819 [55:4] Bit table address bits [55:4]. Address type is determined by
820 CCB header. Address must be 64-byte aligned (CCB version
821 0) or 16-byte aligned (CCB version 1).
835 …which input elements to include in the output. For each bit set at a given index N within the bit …
840 …The only supported output format is a padded, byte-aligned output stream. The stream follows the s…
843 …The return value of the CCB completion area contains the number of bits set in the input bit vecto…
847 The select CCB is a 64-byte “short format” CCB.
849 …The select CCB command format can be specified by the following packed C structure for a big-endian
871 Bits Field Description
891 Bits Field Description
907 36.2.1.6. No-op and Sync commands
908 … The no-op (no operation) command is a CCB which has no processing effect. The CCB, when processed
910 the serial-conditional flags set in order to restrict when it executes.
912 … The sync command is a variant of the no-op command which with restricted execution timing. A sync
922 These commands are 64-byte “short format” CCBs.
924 … The no-op CCB command format can be specified by the following packed C structure for a big-endian
948 Bits Field Description
950 CCB functions as a No-op command.
956 All CCB commands use a common 128-byte Completion Area format, which can be specified by the
957 following packed C structure for a big-endian machine:
976 … The Completion Area must be a 128-byte aligned memory location. The exact layout can be described
988 0x5-0xF Reserved
1001 0x4-0x6 Reserved
1006 0xB-0xD Reserved
1009 0x10-0x7F Reserved
1011 0x81-0xFF Reserved
1014 of remaining bits which were not decoded.
1024 The CCB completion area should be treated as read-only by guest software. The CCB execution status
1027 byte becomes non-zero.
1031 it is recommended that guest software treat the destination buffer as being in an unknown state. If…
1039 triggered if the CCB output is directed at a non-existent secondary input and the pipelining hint i…
1057 …Command timeout indicates that the CCB execution began, but did not complete within a pre-determin…
1062 …in memory when accessed by the virtual machine. Guest software should not attempt to resubmit the …
1076 …by guest software. The time units may also vary by hardware platform, and should not be construed …
1119 A guest may choose to submit addresses used in this API function, including the CCB array address,
1127 Bits Field Description
1139 [7] All-or-nothing flag
1163 …address to load data. ADI checking will still be done when loading real-addressed memory. This bit…
1176 …The all-or-nothing flag specifies whether the virtual machine should allow partial submissions of …
1177 … input CCB array. When using CCBs with serial-conditional flags, it is strongly recommended to use
1178 …the all-or-nothing flag to avoid broken conditional chains. Using long CCB chains on a machine und…
1180 …When submitting serial-conditional CCBs without the all-or-nothing flag, guest software must manua…
1181 …implement the serial-conditional behavior at any point where the chain was not submitted in a sing…
1185 …When the all-or-nothing flag is not specified, callers should check the value of length in ret1 to…
1194 length value in ret1 will be a multi-field value defined as follows:
1195 Bits Field Description
1205 …API function. Guest software implementations should treat that register as voltile across the func…
1224 EBADALIGN CCB array is not on a 64-byte boundary, or the array length is not a multiple
1227 CCBs, is not valid for the guest. Some CCBs may have been enqueued prior
1243 ETOOMANY The request was submitted with the all-or-nothing flag set, and the array size is
1247 ENOACCESS The guest does not have permission to submit CCBs, or an address used in a
1255 interpreted as permanent, and the guest should attempt to submit CCBs in
1261 and it is recommended the guest emulate the operation. The
1262 guest should continue to submit all other CCBs, and assume no
1265 and it is recommended the guest emulate the operation. The
1266 guest should continue to submit all other CCBs that use different
1277 … version, and it is recommended the guest emulate the operation.
1278 … The guest should continue to submit all other CCBs that use
1282 … and it is recommended the guest emulate the operation or resubmit
1283 … the CCB on a different vcpu. The guest should continue to submit
1287 … the guest emulate the operation. The guest should expect all CCB
1303 by the 64-byte aligned real address of the CCBs completion area.
1321 … guest software should invoke the ccb_kill hypercall prior to assuming the request CCB will never
1343 EBADALIGN address is not on a 64-byte aligned.
1347 time. The guest should retry the request.
1348 …ENOACCESS The guest does not have permission to access the coprocessor virtual dev…
1360 the 64-byte aligned real address of the CCBs completion area.
1405 EBADALIGN address is not on a 64-byte aligned.
1409 The guest should retry the request.
1410 …ENOACCESS The guest does not have permission to access the coprocessor virtual de…
1420 …Returns the number of DAX units that are enabled for the calling guest to submit CCBs. The number …
1421 …DAX units that are disabled for the calling guest are also returned. A disabled DAX unit would hav…
1422 available for CCB submission to the calling guest had it not been offlined.