|
HTML rendering created 2026-05-25 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|
|
NAME | SYNOPSIS | DESCRIPTION | VOLUMES | OPTIONS | FILES | SEE ALSO | NOTES | COLOPHON |
|
|
|
SYSTEMD....SERVICE(8) systemd-storage-block@.serviceSYSTEMD....SERVICE(8)
systemd-storage-block@.service, systemd-storage-block.socket,
systemd-storage-block - Storage provider exposing local block
devices as storage volumes
systemd-storage-block@.service
systemd-storage-block.socket
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.
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.
The following options are understood:
-h, --help
Print a short help text and exit.
--version
Print a short version string and exit.
/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.
systemd(1), storagectl(1), systemd-storage-fs@.service(8)
1. Varlink
https://varlink.org/
This page is part of the systemd (systemd system and service
manager) project. Information about the project can be found at
⟨http://www.freedesktop.org/wiki/Software/systemd⟩. If you have a
bug report for this manual page, see
⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
This page was obtained from the project's upstream Git repository
⟨https://github.com/systemd/systemd.git⟩ on 2026-05-24. (At that
time, the date of the most recent commit that was found in the
repository was 2026-05-24.) If you discover any rendering
problems in this HTML version of the page, or you believe there is
a better or more up-to-date source for the page, or you have
corrections or improvements to the information in this COLOPHON
(which is not part of the original manual page), send a mail to
man-pages@man7.org
systemd 261~rc1 SYSTEMD....SERVICE(8)
Pages that refer to this page: storagectl(1), systemd.directives(7), systemd.index(7), systemd-storage-fs@.service(8)
|
HTML rendering created 2026-05-25 by Michael Kerrisk, author of The Linux Programming Interface. For details of in-depth Linux/UNIX system programming training courses that I teach, look here. Hosting by jambit GmbH. |
|