1STACD(8) STACD(8)
2
6 stacd - STorage Appliance Connector
7
9 stacd [OPTIONS...]
10
12 stacd is a system daemon that can be used to automatically connect to
13 NVMe-oF I/O Controllers using the discovery log pages collected by
14 stafd(8). It can also be manually configured with stacd.conf(5) to
15 connect to I/O Controllers that otherwise cannot be found
16 automatically.
17
19 The following options are understood:
20 -h, --help
22 Print the help text and exit.
23 --version
25 Print the version string and exit.
26 -fFILE, --conf-file=FILE
28 Specify a different configuration file than stacd.conf(5) (default:
29 /etc/stas/stacd.conf).
30 -s, --syslog
32 Send messages to syslog instead of stdout. Use this when running
33 stacd as a daemon. (default: false).
34 --tron
36 Trace ON. (default: false)
37 --idl=FILE
39 Print D-Bus IDL to FILE and exit.
40
42 On success, 0 is returned, a non-zero failure code otherwise.
43
45 stacd is managed by systemd. The following operations are supported:
46 Table 1.
48 ┌─────────────────────────────────────┬────────────────────────────┐
49 │Command │ Description │
50 ├─────────────────────────────────────┼────────────────────────────┤
51 │ $ systemctl start stacd │ Start daemon. │
52 ├─────────────────────────────────────┼────────────────────────────┤
53 │ $ systemctl stop stacd │ Stop daemon. The SIGTERM │
54 │ │ signal is used to tell the │
55 │ │ daemon to stop. │
56 ├─────────────────────────────────────┼────────────────────────────┤
57 │ $ systemctl restart stacd │ Effectively a stop + │
58 │ │ start. │
59 ├─────────────────────────────────────┼────────────────────────────┤
60 │ $ systemctl reload stacd │ Reload configuration. This │
61 │ │ is done in real time │
62 │ │ without restarting the │
63 │ │ daemon. The SIGHUP signal │
64 │ │ is used to tell the daemon │
65 │ │ to reload its │
66 │ │ configuration file. Note │
67 │ │ that configuration │
68 │ │ parameters that affect │
69 │ │ connections (e.g. kato), │
70 │ │ will not apply to existing │
71 │ │ connections. Only │
72 │ │ connections established │
73 │ │ after the configuration │
74 │ │ was changed will utilize │
75 │ │ the new configuration │
76 │ │ parameters. │
77 └─────────────────────────────────────┴────────────────────────────┘
78
80 stacd use the GLib main loop. The GLib Python module provides several
81 low-level building blocks that stacd requires. In addition, many Python
82 modules "play nice" with GLib such as dasbus (D-Bus package) and pyudev
83 (UDev package). GLib also provides additional components such as
84 timers, signal handlers, and much more.
85
87 stacd can automatically set up the I/O connections to discovered
88 storage subsystems. However, stacd can also operate in a non-automatic
89 mode based on manually entered configuration. In other words, storage
90 subsystems can be entered in a configuration file named
91 /etc/stas/stacd.conf. This configuration file also provides additional
92 parameters, as log-level attributes used for debugging purposes.
93
95 The interface to stacd is D-Bus. This allows other programs, such as
96 stacctl, to communicate with stacd. The D-Bus address is
97 org.nvmexpress.stac.
98
100 stacd.conf(5), stacd.service(8), stacctl(1), stafd(8),
101 org.nvmexpress.stac(5).
102nvme-stas 2.0-rc5 STACD(8)