Debian Codegraph @

upstream/debian-unstable/man8/[email protected]

raw
1 '\" t
2 .TH "SYSTEMD\-STORAGE\-BLOCK@\&.SERVICE" "8" "" "systemd 261~rc3" "[email protected]"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 [email protected], systemd-storage-block.socket, systemd-storage-block \- Storage provider exposing local block devices as storage volumes
24 .SH "SYNOPSIS"
25 .PP
26 systemd\-storage\-block@\&.service
27 .PP
28 systemd\-storage\-block\&.socket
29 .SH "DESCRIPTION"
30 .PP
31 systemd\-storage\-block@\&.service
32 is a system service that implements the
33 \fBio\&.systemd\&.StorageProvider\fR
34 \m[blue]\fBVarlink\fR\m[]\&\s-2\u[1]\d\s+2
35 interface, exposing the system\*(Aqs block devices (such as disks, partitions, and device\-mapper nodes) as storage volumes that may be acquired by other programs as file descriptors\&.
36 .PP
37 The service is socket\-activated via
38 systemd\-storage\-block\&.socket, which listens on the AF_UNIX socket
39 /run/systemd/io\&.systemd\&.StorageProvider/block\&. The socket directory
40 /run/systemd/io\&.systemd\&.StorageProvider/
41 is the well\-known location where storage providers register, see
42 \fBstoragectl\fR(1)
43 for an enumeration tool\&.
44 .PP
45 See also
46 \[email protected]\fR(8)
47 for a complementary implementation that exposes regular files and directories from a backing file system\&.
48 .SH "VOLUMES"
49 .PP
50 The volumes exposed via the provider are identified by an absolute path (which must begin with
51 /dev/), i\&.e\&. as a kernel block device node such as
52 /dev/sda
53 or
54 /dev/disk/by\-id/\&...\&. Volume names that are not normalized or that do not begin with
55 /dev/
56 are not accepted\&.
57 .SH "OPTIONS"
58 .PP
59 The following options are understood:
60 .PP
61 \fB\-h\fR, \fB\-\-help\fR
62 .RS 4
63 Print a short help text and exit\&.
64 .RE
65 .PP
66 \fB\-\-version\fR
67 .RS 4
68 Print a short version string and exit\&.
69 .RE
70 .SH "FILES"
71 .PP
72 /run/systemd/io\&.systemd\&.StorageProvider/block
73 .RS 4
74 AF_UNIX socket the service listens on\&. This is the canonical location for the
75 "block"
76 storage provider, and is enumerated by
77 \fBstoragectl providers\fR\&.
78 .sp
79 Added in version 261\&.
80 .RE
81 .SH "SEE ALSO"
82 .PP
83 \fBsystemd\fR(1), \fBstoragectl\fR(1), \[email protected]\fR(8)
84 .SH "NOTES"
85 .IP " 1." 4
86 Varlink
87 .RS 4
88 \%https://varlink.org/
89 .RE