]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
docs: tweak rsync flags for moving existing home dir to systemd-homed
authorwouter bolsterlee <wouter@bolsterl.ee>
Wed, 1 Feb 2023 20:15:22 +0000 (21:15 +0100)
committerLuca Boccassi <luca.boccassi@gmail.com>
Wed, 1 Feb 2023 20:47:56 +0000 (20:47 +0000)
The documentation on moving an existing homedir into a systemd-homed managed
one suggests using rsync(1) with a bunch of flags to preserve as much metadata
as possible: permissions, xattrs, timestamps, etc. The previously suggested
flags were:

    rsync -aHAXv --remove-source-files …

… which does include mtimes, but not ctimes and atimes, because -a does not
include those:

    --archive, -a            archive mode is -rlptgoD (no -A,-X,-U,-N,-H)

This change adds the -N and -U flags to preserve even more file timestamps,
turning the command into:

    rsync -aHANUXv --remove-source-files …

The new flags are:

    --crtimes, -N            preserve create times (newness)
    --atimes, -U             preserve access (use) times

docs/CONVERTING_TO_HOMED.md

index 80482a20e5686a60d899bc187ede82a6de24feda..06fc66f1950568f80475d082c6373bce87917ff3 100644 (file)
@@ -114,7 +114,7 @@ Here's the step-by-step guide:
    home directory temporarily and copy the data in.
 
     ```
-    homectl with foobar -- rsync -aHAXv --remove-source-files /home/foobar.saved/ .
+    homectl with foobar -- rsync -aHANUXv --remove-source-files /home/foobar.saved/ .
     ```
 
    This mounts the home directory of the user, and then runs the specified