1dpkg-fsys-usrunmess(8) dpkg suite dpkg-fsys-usrunmess(8)
2
3
4
6 dpkg-fsys-usrunmess - undoes the merged-/usr-via-aliased-dirs mess
7
9 dpkg-fsys-usrunmess [option...]
10
12 dpkg-fsys-usrunmess is a tool to fix up filesystems that have been
13 installed anew with recent installers with unfortunate defaults or
14 migrated to the broken merged /usr via aliased directories layout,
15 which is not supported by dpkg. See the dpkg FAQ.
16
17 The program will perform the following overall actions:
18
19 • Check whether the system needs to be switched, otherwise do
20 nothing,
21
22 • Check for dpkg database consistency and otherwise abort.
23
24 • Get the list of files and alternatives that need to be restored.
25
26 • Create a shadow hierarchy under /.usrunmess, by creating the
27 directories symlinks or hardlinking or copying the files as needed.
28
29 • Prompt for confirmation before proceeding, if requested on the
30 command-line.
31
32 • Lock the dpkg database.
33
34 • Mark all packages as half-configured to force running maintainer
35 scripts that might need to recreate files.
36
37 • Replace the aliased directories with the shadow ones, by creating a
38 backup of the old symlinked directories and renaming the shadow
39 ones over.
40
41 • Relabel MAC information for directories and symlinks if necessary.
42
43 • Reconfigure all packages.
44
45 • Remove backup symlinks.
46
47 • Remove old moved objects, but defer directory removal.
48
49 • Remove old deferred directories that are not referenced by dpkg-
50 query.
51
52 • Remove shadow root directory.
53
54 Note: When running the program from some shells such as bash(1) or
55 zsh(1), after executing it, you might need to request the shell to
56 forget all remembered executable locations with for example "hash -r".
57
58 Warning: Note that this operation has the potential to render the
59 system unusable or broken in case of a sudden crash or reboot,
60 unexpected state of the system, or possible bugs in the script. Be
61 prepared with recovery media and consider doing backups beforehand.
62
64 -p, --prompt
65 Prompt at the time of no return, so that the debug output or the
66 shadow hierarchy can be evaluated before proceeding.
67
68 -n, --no-act
69 --dry-run
70 This option enables the dry-run mode, where no destructive action
71 takes place, only the preparatory part.
72
73 -?, --help
74 Show the usage message and exit.
75
76 --version
77 Show the version and exit.
78
80 DPKG_USRUNMESS_NOACT
81 This setting defines whether to enable dry-run mode.
82
84 <https://wiki.debian.org/Teams/Dpkg/FAQ#Q:_Does_dpkg_support_merged-.2Fusr-via-aliased-dirs.3F>.
85
86
87
881.20.9 2021-04-13 dpkg-fsys-usrunmess(8)