---
name: "ib_acme"
section: "1"
platform: "linux"
package: "rdma-core"
version: "65.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/ib_acme"
---

# ib\_acme(1)

test and configuration utility for the IB ACM

## NAME

ib\_acme - test and configuration utility for the IB ACM

## SYNOPSIS

```
ib_acme [-f addr_format] [-s src_addr] -d dest_addr [-v] [-c] [-e] [-P] [-S svc_addr] [-C repetitions]
```

```
ib_acme [-A [addr_file]] [-O [opt_file]] [-D dest_dir] [-V]
```

## DESCRIPTION

ib\_acme provides assistance configuring and testing the ibacm service. The first usage of the service will test that the ibacm is running and operating correctly.  The second usage model will automatically create address and configuration files for the ibacm service.

## OPTIONS

- \-f addr\_format

  Specifies the format of the src\_addr and dest\_addr parameters.  Valid address formats are: 'i' ip address, 'n' host name, 'l' lid, 'g' gid, and 'u' unspecified.  If the -f option is omitted, an unspecified address format is assumed.  ib\_acme will use getaddrinfo or other mechanisms to determine which format the address uses.

- \-s src\_addr

  Specifies the local source address of the path to resolve.  The source address can be an IP address, system network name, or LID, as indicated by the addr\_format option.

- \-d dest\_addr

  Specifies the destination address of the path to resolve.  The destination address can be an IP address, system network name, or LID, as indicated by the addr\_format option.

- \-v

  Indicates that the resolved path information should be verified with the active IB SA.  Use of the -v option provides a sanity check that resolved path information is usable given the current cluster configuration.

- \-c

  Instructs the ACM service to only returned information that currently resides in its local cache.

- \-e \[N\]

  Displays one (N = 1, 2, ...) or all endpoints (N = 0 or not present).

- \-P \[opt\]

  Queries performance data from the destination service.  Valid options are: "col" for outputting combined data in column format,  "N" (N = 1, 2, ...) for outputting data for a specific endpoint N,  "all" for outputting data for all endpoints,  and "s" for outputting data for a specific endpoint with the address given by the -s option.

- \-S svc\_addr

  Hostname, IPv4-address or Unix-domain socket of ACM service, default: /run/ibacm.sock

- \-C repetitions

  number of repetitions to perform resolution.  Used to measure performance of ACM cache lookups.  Defaults to 1.

- \-A \[addr\_file\]

  With this option, the ib\_acme utility automatically generates the address configuration file ibacm\_addr.cfg.  The generated file is constructed using the system host name.

- \-O \[opt\_file\]

  With this option, the ib\_acme utility automatically generates the option configuration file ibacm\_opts.cfg.  The generated file is currently generated using static information.

- \-D dest\_dir

  Specify the destination directory for the output files.

- \-V

  Enables verbose output.  When combined with -A or -O options, ib\_acme will display additional details, such as generated address information saved to the ibacm\_addr.cfg file.

## NOTES

The ib\_acme utility performs two main functions.  With the -A and -O options, it automatically generates address or options configuration files.  The generated files are text based and may be edited.  These options are intended to provide a simple way to configure address and option information on all nodes on a cluster.

The other function of the ib\_acme utility is to test the ibacm service, including helping to verify that the service is usable given the current cluster configuration.  The ib\_acme utility can resolve IP addresses, network names, or IB LIDs into a path record.  It can then compare that path record against one obtained by the SA.  When used to test the ibacm service, the ib\_acme utility has the side effect of loading the ibacm caches.

Multiple, numerical destinations can be specified by adding brackets \[\] to the end of a base destination name or address.  Users may specify a list of numerical ranges inside the brackets using the following example as a guide: node\[1-3,5,7-8\].  This will result in testing node1, node2, node3, node5, node7, and node8.

## SEE ALSO

[ibacm(7)](/ibacm/7.md), [ibacm(8)](/ibacm/8.md)