getctarank GPU Virtual ISA NVIDIA

getctarank Data Movement and Conversion Instructions

getctarank{.space}.type d, a;

Write the destination register d with the rank of the CTA which contains the address specified in operand a.

Encoding

PTX is a virtual instruction set. It has no single, stable native binary encoding - the compiler lowers this instruction to different native machine code depending on the selected NVIDIA target architecture (compute capability). This page intentionally shows no bit-diagram; see the target/version requirements below for what governs how this instruction compiles.
PTX ISA Version Introduced PTX ISA 7.8
Minimum Target sm_90

Syntax Forms

One mnemonic covers many type / state-space / scope / modifier combinations - each row below is an independently valid form.

Syntax Data Types State Space(s) Modifiers Min. Target Description
getctarank{.space}.type d, a; sm_90 Write the destination register d with the rank of the CTA which contains the address specified in operand a. Instruction type.type indicates the type of source operand a. When space is. (see the official PTX ISA docs for the full description)

Operands

  • d
    Destination register
  • a
    Source operand

At a Glance

Data Types -

Related

More in Data Movement and Conversion Instructions

Reference

NVIDIA PTX ISA

Description

Write the destination register d with the rank of the CTA which contains the address specified in operand a. Instruction type.type indicates the type of source operand a. When space is.shared::cluster, source a is either a shared memory variable or a register containing a valid shared memory address. When the optional qualifier.space is not specified, a is a register containing a generic addresses pointing to shared memory. Destination d is always a 32-bit register which holds the rank of the CTA.

Examples

getctarank.shared::cluster.u32 d1, addr;
getctarank.shared::cluster.u64 d2, sh + 4;
getctarank.u64                 d3, src;

Reproduced from NVIDIA's official PTX ISA documentation for technical accuracy.

Sources