title: Permute instruction
text: # Permute instruction
  
  Permute (and Shuffle) instructions, part of bit manipulation as well as vector processing, copy unaltered contents from a source array to a destination array, where the indices are specified by a second source array. The size (bitwidth) of the source elements is not restricted but remains the same as the destination size.
  
  There exists two important permute variants, known as gather and scatter, respectively. The gather variant is as follows:
  
  where the scatter variant is:
  
  Note that unlike in memory-based gather-scatter all three of dest, src, and indices are registers (or parts of registers in the case of bit-level permute), not memory locations.
  
  The scatter variant can be seen to "scatter" the source elements across (into) to the destination, where the "gather" variant is gathering data from the indexed source elements.
  
  Given that the indices may be repeated in both variants, the resultant output is not a strict mathematical permutation because duplicates can occur in the output.
  
  A special case of permute is also used in GPU "swizzling" (again, not strictly a permutation) which performs on-the-fly reordering of subvector data so as to align or duplicate elements with the appropriate SIMD lane.
  
  ## Occurrences of permute instructions
  
  Permute instructions occur in both scalar processors as well as vector processing engines as well as GPUs. In vector instruction sets they are typically named "Register Gather/Scatter" operations such as in RISC-V vectors, and take Vectors as input for both source elements and source array, and output another Vector.
  
  In scalar instruction sets the scalar registers are broken down into smaller sections (unpacked, SIMD style) where the fragments are then used as array sources. The (small, partial) results are then concatenated (packed) back into the scalar register as the result.
  
  Some ISAs, particularly for cryptographic applications, even have bit-level permute operations, such as
  
  bdep (bit deposit) in RISC-V bitmanip; in the Power ISA it is known as bpermd and has been included for several decades, and is still in the Power ISA v.3.0 B spec.
  
  Also in some non-vector ISAs, due to there sometimes being insufficient space in the one source input register to specify the permutation source array in full (particularly if the operation involves bit-level permutation), will include partial reordering instructions. Examples include VSHUFF32x4 from AVX-512.
  
  Permute operations in different forms are surprisingly common, occurring in AltiVec, Power ISA, PowerPC G4, AVX-512, SVE2, vector processors, and GPUs. They are sufficiently important that LLVM added the shufflevector intrinsic and GCC added the __builtin_shuffle intrinsic. GCC's intrinsic matches the functionality of OpenCL's shuffle intrinsics. Note that all of these, mathematically, are not permutations because duplicates can occur in the output.
  
  