summaryrefslogtreecommitdiffstats
path: root/man/systemd-dissect.xml
diff options
context:
space:
mode:
authorYu Watanabe <watanabe.yu+github@gmail.com>2023-07-21 03:26:13 +0200
committerYu Watanabe <watanabe.yu+github@gmail.com>2023-08-10 00:05:47 +0200
commit7a05926fbe6ed92e60e0afc9857ced91a532f791 (patch)
tree60bdda95a2e2ed931d78704a2c34a72c1d5769cd /man/systemd-dissect.xml
parentMerge pull request #28734 from loongarch64/dev-wu-main (diff)
downloadsystemd-7a05926fbe6ed92e60e0afc9857ced91a532f791.tar.xz
systemd-7a05926fbe6ed92e60e0afc9857ced91a532f791.zip
udev: re-introduce symlinks for loopback block device
But the directories are changed from /dev/loop/by-ref/ -> /dev/disk/by-loop-ref/ and /dev/loop/by-inode/ -> /dev/disk/by-loop-inode/. As /dev/loop/ is used by losetup command for other purpose. See issue #28475. This effectively reverts commits 9915cc60868c77e7e8cecb669ddb90516dffc7df, 5022fab15fc16204d163883ca818fd6092dc919c, and c0d998248e10e1dcf18108fdbb70f259acd452eb.
Diffstat (limited to 'man/systemd-dissect.xml')
-rw-r--r--man/systemd-dissect.xml9
1 files changed, 8 insertions, 1 deletions
diff --git a/man/systemd-dissect.xml b/man/systemd-dissect.xml
index 9a3ed6ce7b..27c5d3c7a8 100644
--- a/man/systemd-dissect.xml
+++ b/man/systemd-dissect.xml
@@ -413,7 +413,14 @@
<literal>.lo_file_name</literal> field for the block device. Note this is distinct from the
<filename>/sys/class/block/loopX/loop/backing_file</filename> attribute file that always reports a
path referring to the actual backing file. The latter is subject to mount namespace translation, the
- former is not.</para></listitem>
+ former is not.</para>
+
+ <para>This setting is particularly useful in combination with the <option>--attach</option> command,
+ as it allows later referencing the allocated loop device via
+ <filename>/dev/disk/by-loop-ref/…</filename> symlinks. Example: first, set up the loopback device
+ via <command>systemd-dissect attach --loop-ref=quux foo.raw</command>, and then reference it in a
+ command via the specified filename: <command>cfdisk /dev/disk/by-loop-ref/quux</command>.
+ </para></listitem>
</varlistentry>
<varlistentry>