---
name: "stacctl"
section: "1"
platform: "linux"
package: "nvme-stas"
version: "2.4.1-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/stacctl"
---

# stacctl(1)

STorage Appliance Connector (STAC) utility program

## NAME

stacctl - STorage Appliance Connector (STAC) utility program

## SYNOPSIS

**stacctl** \[OPTIONS...\] {COMMAND} \[OPTIONS...\]

## DESCRIPTION

**stacctl** is a tool that can be used to communicate with the [**stacd**(8)](/stacd/8.md) daemon to retrieve operational data.

## COMMANDS

The following commands are understood:

**tron**

Trace ON. Enable code tracing, which is to say that lots of debug information will be printed to the syslog (e.g. systemd-journal).

**troff**

Trace OFF. Disable code tracing.

**status**

Show runtime status information.

**ls**

Show the list of I/O controllers. This will list all the I/O controllers configured in [**stacd.conf**(5)](/stacd.conf/5.md) as well as those discovered by the [**stafd**(8)](/stafd/8.md) daemon.

## OPTIONS

The following options are understood:

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

  Print the help text and exit.

- **--version**

  Print the version string and exit.

- **-d**, **--detailed**

  Print additional details.

## EXIT STATUS

On success, 0 is returned; otherwise, a non-zero failure code is returned.

## EXAMPLES

**Example 1. List I/O controllers**

```
$ stacctl ls --detailed
[{'connect attempts': 0,
  'device': 'nvme1',
  'host-iface': '',
  'host-traddr': '',
  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',
  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',
  'model': 'Linux',
  'retry connect timer': '60.0s [off]',
  'serial': '8d22fa96da912fb13f5a',
  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34aedead',
  'traddr': '::1',
  'transport': 'tcp',
  'trsvcid': '8009'},
 {'connect attempts': 0,
  'device': 'nvme2',
  'host-iface': '',
  'host-traddr': '',
  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',
  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',
  'model': 'Linux',
  'retry connect timer': '60.0s [off]',
  'serial': 'a9987ae2fd173d100fd0',
  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34aebeef',
  'traddr': '::1',
  'transport': 'tcp',
  'trsvcid': '8009'},
 {'connect attempts': 0,
  'device': 'nvme3',
  'host-iface': '',
  'host-traddr': '',
  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',
  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',
  'model': 'Linux',
  'retry connect timer': '60.0s [off]',
  'serial': '13e122f1a8122bed5a8d',
  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34ae8e28',
  'traddr': '::1',
  'transport': 'tcp',
  'trsvcid': '8009'}]
```

**Example 2. Disable tracing**

```
$ stacctl troff
```

**Example 3.  Show [stacd(8)](/stacd/8.md) operational status.**

```
$ stacctl status
{'config soak timer': '1.5s [off]',
 'controllers': [{'connect attempts': 0,
                  'device': 'nvme1',
                  'host-iface': '',
                  'host-traddr': '',
                  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',
                  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',
                  'model': 'Linux',
                  'retry connect timer': '60.0s [off]',
                  'serial': '8d22fa96da912fb13f5a',
                  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34aedead',
                  'traddr': '::1',
                  'transport': 'tcp',
                  'trsvcid': '8009'},
                 {'connect attempts': 0,
                  'device': 'nvme2',
                  'host-iface': '',
                  'host-traddr': '',
                  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',
                  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',
                  'model': 'Linux',
                  'retry connect timer': '60.0s [off]',
                  'serial': 'a9987ae2fd173d100fd0',
                  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34aebeef',
                  'traddr': '::1',
                  'transport': 'tcp',
                  'trsvcid': '8009'},
                 {'connect attempts': 0,
                  'device': 'nvme3',
                  'host-iface': '',
                  'host-traddr': '',
                  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',
                  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',
                  'model': 'Linux',
                  'retry connect timer': '60.0s [off]',
                  'serial': '13e122f1a8122bed5a8d',
                  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34ae8e28',
                  'traddr': '::1',
                  'transport': 'tcp',
                  'trsvcid': '8009'}],
 'log-level': 'DEBUG',
 'tron': True}
```

## SEE ALSO

[**stacd.conf**(5)](/stacd.conf/5.md), [**stacd**(8)](/stacd/8.md) ()