zrepl/docs/configuration
Christian Schwarz fb6a9be954 fix encrypt-on-receive with placeholders
fixes https://github.com/zrepl/zrepl/issues/504

Problem:
  plain send + recv with root_fs encrypted + placeholders causes plain recvs
  whereas user would expect encrypt-on-recv
Reason:
  We create placeholder filesytems with -o encryption=off.
  Thus, children received below those placeholders won't inherit
  encryption of root_fs.
Fix:
  We'll have three values for `recv.placeholders.encryption: unspecified (default) | off | inherit`.
  When we create a placeholder, we will fail the operation if  `recv.placeholders.encryption = unspecified`.
  The exception is if the placeholder filesystem is to encode the client identity ($root_fs/$client_identity) in a pull job.
  Those are created in `inherit` mode if the config field is `unspecified` so that users who don't need
  placeholders are not bothered by these details.

Future Work:
  Automatically warn existing users of encrypt-on-recv about the problem
  if they are affected.
  The problem that I hit during implementation of this is that the
  `encryption` prop's `source` doesn't quite behave like other props:
  `source` is `default` for `encryption=off` and `-` when `encryption=on`.
  Hence, we can't use `source` to distinguish the following 2x2 cases:
  (1) placeholder created with explicit -o encryption=off
  (2) placeholder created without specifying -o encryption
  with
  (A) an encrypted parent at creation time
  (B) an unencrypted parent at creation time
2021-12-18 15:12:47 +01:00
..
filter_syntax.rst docs: filter syntax: reference 'snap' job type 2020-02-14 21:40:48 +01:00
jobs.rst client/signal: Revert "add signal 'snapshot', rename existing signal 'wakeup' to 'replication'" 2021-03-25 22:26:17 +01:00
logging.rst Spellcheck all files 2020-02-24 16:06:09 +01:00
misc.rst pre- and post-snapshot hooks 2019-09-27 21:25:59 +02:00
monitoring.rst docs/monitoring: change suggested prometheus port to 9811 2021-03-28 18:18:02 +02:00
overview.rst [#285] support setting zfs send / recv flags in the config (send: -wLcepbS, recv: -ox) 2021-02-20 17:20:45 +01:00
prune.rst docs: prune: improve docs for 'grid' rule 2021-11-14 17:34:32 +01:00
replication.rst replication: simplify parallel replication variables & expose them in config 2021-03-14 17:30:10 +01:00
sendrecvoptions.rst fix encrypt-on-receive with placeholders 2021-12-18 15:12:47 +01:00
snapshotting.rst client/signal: Revert "add signal 'snapshot', rename existing signal 'wakeup' to 'replication'" 2021-03-25 22:26:17 +01:00
transports.rst docs: transport: fix easyrsa script (fixup of 6b4c6fc) 2020-08-23 20:36:43 +02:00