aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorEric Biggers <ebiggers@google.com>2021-06-27 14:56:15 -0700
committerEric Biggers <ebiggers3@gmail.com>2021-06-27 15:15:17 -0700
commit96afc7762b4b7466f8c8fac5801c52aa58c34a4c (patch)
treee36cf7f13d326cf02a51e6e521b2dfdc998e377c /README.md
parente248d2a99aff5bef7611ac0596b0aa2d1eda6629 (diff)
README: add troubleshooting section for keyring linkage issue
Fixes https://github.com/google/fscrypt/issues/194 Update https://github.com/google/fscrypt/issues/100
Diffstat (limited to 'README.md')
-rw-r--r--README.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/README.md b/README.md
index 51b27ae..8075d48 100644
--- a/README.md
+++ b/README.md
@@ -56,6 +56,7 @@ native encryption. See [Runtime Dependencies](#runtime-dependencies).
- [I changed my login passphrase, now all my directories are inaccessible](#i-changed-my-login-passphrase-now-all-my-directories-are-inaccessible)
- [Directories using my login passphrase are not automatically unlocking.](#directories-using-my-login-passphrase-are-not-automatically-unlocking)
- [Getting "encryption not enabled" on an ext4 filesystem.](#getting-encryption-not-enabled-on-an-ext4-filesystem)
+ - [Getting "user keyring not linked into session keyring".](#getting-user-keyring-not-linked-into-session-keyring)
- [Getting "Operation not permitted" when moving files into an encrypted directory.](#getting-operation-not-permitted-when-moving-files-into-an-encrypted-directory)
- [Some processes can't access unlocked encrypted files.](#some-processes-cant-access-unlocked-encrypted-files)
- [Users can access other users' unlocked encrypted files.](#users-can-access-other-users-unlocked-encrypted-files)
@@ -868,6 +869,13 @@ If you've enabled `encrypt` but you still get the "encryption not enabled"
error, then the problem is that ext4 encryption isn't enabled in your kernel
config. See [Runtime Dependencies](#runtime-dependencies) for how to enable it.
+#### Getting "user keyring not linked into session keyring".
+
+Some older versions of Ubuntu didn't link the user keyring into the session
+keyring, which caused problems with `fscrypt`.
+
+To avoid this issue, upgrade to Ubuntu 20.04 or later.
+
#### Getting "Operation not permitted" when moving files into an encrypted directory.
This occurs when the kernel version is older than v5.1 and the source files are