Files
mscclpp/test/executor-tests/algos/multi_node_transfer_pkt.py
Caio Rocha 7fcaded3a4 wip
2026-05-22 21:18:13 +00:00

71 lines
2.9 KiB
Python

# Copyright (c) Microsoft Corporation.
# Licensed under the MIT License.
"""
Multi-Node Transfer Pack Test
This file tests the PUT_PACKETS and READ_PUT_PACKETS operations on
PortChannels in a multi-node environment. It implements a 2-GPU allgather
with the LL (low-latency) packet protocol, using port channels for inter-node
communication.
"""
import argparse
from mscclpp.language.channel import *
from mscclpp.language.rank import *
from mscclpp.language.general import *
from mscclpp.language.program import *
from mscclpp.language.collectives import *
def multi_node_transfer_pkt(name, num_threads_per_block, min_message_size, max_message_size):
chunksperloop = 1
gpu_size = 2
collective = AllGather(gpu_size, chunksperloop, True)
with CollectiveProgram(
name,
collective,
gpu_size,
protocol="LL",
num_threads_per_block=num_threads_per_block,
use_double_scratch_buffer=True,
min_message_size=min_message_size,
max_message_size=max_message_size,
):
# Setup ranks, channels, output and scratch buffers for 2-GPU allgather
first_rank = Rank(0)
second_rank = Rank(1)
first_ch = PortChannel(1, 0)
second_ch = PortChannel(0, 1)
first_output_buffer = first_rank.get_output_buffer()
second_output_buffer = second_rank.get_output_buffer()
first_scratch_buffer = Buffer(0, 2)
second_scratch_buffer = Buffer(1, 2)
# Each rank stages its own output chunk into its local scratch buffer as packets
first_rank.copy_packets(first_scratch_buffer[0:1], first_output_buffer[0:1], tb=0)
second_rank.copy_packets(second_scratch_buffer[1:2], second_output_buffer[1:2], tb=0)
# Rank 0 pushes packets to rank 1's scratch via port channel (PUT_PACKETS)
# Rank 1 reads from rank 0's scratch and pushes packets back via port channel (READ_PUT_PACKETS)
first_ch.put_packets(second_scratch_buffer[0:1], first_scratch_buffer[0:1], tb=0)
second_ch.read_put_packets(first_scratch_buffer[1:2], second_scratch_buffer[1:2], tb=1)
# Both ranks unpack received packets from scratch into their output buffers
first_rank.unpack_packets(first_output_buffer[1:2], first_scratch_buffer[1:2], tb=1)
second_rank.unpack_packets(second_output_buffer[0:1], second_scratch_buffer[0:1], tb=2)
print(JSON())
parser = argparse.ArgumentParser()
parser.add_argument("--name", type=str, help="name of the program")
parser.add_argument("--num_threads_per_block", type=int, default=1024, help="number of threads per block")
parser.add_argument("--min_message_size", type=int, default=0, help="minimum message size")
parser.add_argument("--max_message_size", type=int, default=2**64 - 1, help="maximum message size")
args = parser.parse_args()
multi_node_transfer_pkt(args.name, args.num_threads_per_block, args.min_message_size, args.max_message_size)