Slurm Workload Manager -

    .LP
    \fBtopology.yaml\fR is a YAML\-formatted configuration file that defines
    multiple network topologies for optimizing job resource allocation in Slurm.
    The file must be located in the same directory as \fBslurm.conf\fR. Any text
    following a "#" in this file is treated as a comment through the end of that
    line.

    Additional details are available in \fBtopology.conf\fR(5) and in the
    Topology Guide: <https://slurm.schedmd.com/topology.html>

    \fBNOTE\fR: Slurm will first check for topology.yaml.
    If this file exists, topology.conf will be ignored.
    .LP

    .SH "PARAMETERS"
    .LP
    Each topology contains the following attributes:
    .LP

    .TP
    \fBtopology\fR
    Unique name of the topology, will be used to identify it on partition
    configurations. Must be the first attribute.
    .IP

    .TP
    \fBcluster_default\fR
    The first topology defined with \fBcluster_default: true\fR will be used for
    partitions without an explicitly specified topology and cluster-wide operations
    not tied to a partition (e.g., slurmctld-to-slurmd communication). Defaults to
    \fBfalse\fR.
    .IP

    .LP
    Each topology must also define exactly one of the following topology types:
    .RS
    .TP
    \fBblock\fR
    This topology will use the \fBtopology/block\fR plugin. Must contain additional
    fields, see below.
    .IP

    .TP
    \fBflat\fR
    If set to \fBtrue\fR, this topology will use the \fBtopology/flat\fR plugin,
    which is the default if no TopologyPlugin or topology.yaml is specified.
    .IP

    .TP
    \fBtree\fR
    This topology will use the \fBtopology/tree\fR plugin. Must contain additional
    fields, see below.

    .TP
    \fBblocks\fR
    List of blocks available in this topology. Each block contains the following
    attributes:

    .RS
    .TP
    \fBblock\fR
    The name of a block. This name is internal to Slurm and arbitrary.
    Each block should have a unique name.
    This field must be specified.
    .IP

    .TP
    \fBnodes\fR
    Child nodes of the named block.
    .IP
    .RE
    .IP

    .SS "Tree definitions"
    .LP
    Each tree topology contains the following attribute:
    .LP

    .TP
    \fBswitches\fR
    List of switches available in this topology. Each switch contains the following
    attributes:

    .RS
    .TP
    \fBswitch\fR
    The name of a switch. This name is internal to Slurm and arbitrary.
    Each switch should have a unique name.
    This field must be specified and cannot be longer than 64 characters.
    .IP

    .TP
    \fBchildren\fR
    Child switches of the named switch.
    .IP

    .TP
    \fBnodes\fR
    Child nodes of the named leaf switch.
    .IP

    .RE
    .IP

      cluster_default: false
      block:
        block_sizes:
          - 4
          - 16
        blocks:
          - block: b1
            nodes: node[01-04]
          - block: b2
            nodes: node[05-08]
          - block: b3
            nodes: node[09-12]
          - block: b4
            nodes: node[13-16]
    - topology: topo3
      cluster_default: false
      flat: true
    .fi

    .SH "COPYING"
    Copyright (C) 2025 SchedMD LLC.

    .LP
    This file is part of Slurm, a resource management program.
    For details, see <https://slurm.schedmd.com/>.
    .LP
    Slurm is free software; you can redistribute it and/or modify it under
    the terms of the GNU General Public License as published by the Free
    Software Foundation; either version 2 of the License, or (at your option)
    any later version.
    .LP
    Slurm is distributed in the hope that it will be useful, but WITHOUT ANY
    WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
    FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
    details.

    .SH "SEE ALSO"
    .LP
    \fBslurm.conf\fR(5), \fBtopology.conf\fR(5)