1STACD(8)                                                              STACD(8)
2
3
4

NAME

6       stacd - STorage Appliance Connector
7

SYNOPSIS

9       stacd [OPTIONS...]
10

DESCRIPTION

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

OPTIONS

19       The following options are understood:
20
21       -h, --help
22           Print the help text and exit.
23
24       --version
25           Print the version string and exit.
26
27       -fFILE, --conf-file=FILE
28           Specify a different configuration file than stacd.conf(5) (default:
29           /etc/stas/stacd.conf).
30
31       -s, --syslog
32           Send messages to syslog instead of stdout. Use this when running
33           stacd as a daemon. (default: false).
34
35       --tron
36           Trace ON. (default: false)
37
38       --idl=FILE
39           Print D-Bus IDL to FILE and exit.
40

EXIT STATUS

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

DAEMONIZATION

45       stacd is managed by systemd. The following operations are supported:
46
47       Table 1.
48       ┌─────────────────────────────────────┬────────────────────────────┐
49Command                              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

DESIGN

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

CONFIGURATION

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

D-BUS API

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

SEE ALSO

100       stacd.conf(5), stacd.service(8), stacctl(1), stafd(8),
101       org.nvmexpress.stac(5).
102
103
104
105nvme-stas 2.2.2                                                       STACD(8)
Impressum