---
name: "swift-ring-composer"
section: "1"
platform: "linux"
package: "swift"
version: "2.35.1-0+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/swift-ring-composer"
---

# swift-ring-composer(1)

manual page for swift-ring-composer

## NAME

**swift-ring-composer** - manual page for swift-ring-composer

## SYNOPSIS

**swift-ring-composer** \[-h\] \<composite\_builder\_file\> {show,compose} ...

## DESCRIPTION

This is a tool for building a composite ring file from other existing ring builder files. The component ring builders must all have the same partition power. Each device must only be used in a single component builder. Each region must only be used in a single component builder.

**NOTE:** This tool is for experimental use and may be removed in future versions of Swift.

### positional arguments:

- \<composite\_builder\_file\>

  Name of composite builder file

### optional arguments:

- **-h**, **--help**

  show this help message and exit

## COMMANDS

- show composite ring builder metadata

  ### show \[-h\]

- compose composite ring

  ### compose \[-h\] \[\<builder\_file\> \<builder\_file\> \[\<builder\_file\> ...\] --output \<ring\_file\> \[--force\]

## DOCUMENTATION

More in depth documentation about the swift ring and also OpenStack Swift as a whole can be found at **https://swift.openstack.org**