systemd-storage-block@.service - Man Page
Storage provider exposing local block devices as storage volumes
Synopsis
systemd-storage-block@.service
systemd-storage-block.socket
Description
systemd-storage-block@.service is a system service that implements the io.systemd.StorageProvider Varlink[1] interface, exposing the system's block devices (such as disks, partitions, and device-mapper nodes) as storage volumes that may be acquired by other programs as file descriptors.
The service is socket-activated via systemd-storage-block.socket, which listens on the AF_UNIX socket /run/systemd/io.systemd.StorageProvider/block. The socket directory /run/systemd/io.systemd.StorageProvider/ is the well-known location where storage providers register, see storagectl(1) for an enumeration tool.
See also systemd-storage-fs@.service(8) for a complementary implementation that exposes regular files and directories from a backing file system.
Volumes
The volumes exposed via the provider are identified by an absolute path (which must begin with /dev/), i.e. as a kernel block device node such as /dev/sda or /dev/disk/by-id/.... Volume names that are not normalized or that do not begin with /dev/ are not accepted.
Options
The following options are understood:
- -h, ā--help
Print a short help text and exit.
- --version
Print a short version string and exit.
Files
- /run/systemd/io.systemd.StorageProvider/block
AF_UNIX socket the service listens on. This is the canonical location for the "block" storage provider, and is enumerated by storagectl providers.
Added in version 261.
See Also
Notes
- 1.
Varlink
https://varlink.org/
Referenced By
storagectl(1), systemd.directives(7), systemd.index(7), systemd-storage-fs@.service(8).