summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/acl-load.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2020-03-21 10:28:17 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2021-02-07 11:16:53 +0000
commit06cba6ccd165ca8b224797e37fccb9e63f026d77 (patch)
treee82f1bc439997ae296f2e74f8a64d84c5d95f140 /iredis/data/commands/acl-load.md
parentInitial commit. (diff)
downloadiredis-06cba6ccd165ca8b224797e37fccb9e63f026d77.tar.xz
iredis-06cba6ccd165ca8b224797e37fccb9e63f026d77.zip
Adding upstream version 1.9.1.upstream/1.9.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'iredis/data/commands/acl-load.md')
-rw-r--r--iredis/data/commands/acl-load.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/iredis/data/commands/acl-load.md b/iredis/data/commands/acl-load.md
new file mode 100644
index 0000000..3892bb4
--- /dev/null
+++ b/iredis/data/commands/acl-load.md
@@ -0,0 +1,27 @@
+When Redis is configured to use an ACL file (with the `aclfile` configuration
+option), this command will reload the ACLs from the file, replacing all the
+current ACL rules with the ones defined in the file. The command makes sure to
+have an _all or nothing_ behavior, that is:
+
+- If every line in the file is valid, all the ACLs are loaded.
+- If one or more line in the file is not valid, nothing is loaded, and the old
+ ACL rules defined in the server memory continue to be used.
+
+@return
+
+@simple-string-reply: `OK` on success.
+
+The command may fail with an error for several reasons: if the file is not
+readable, if there is an error inside the file, and in such case the error will
+be reported to the user in the error. Finally the command will fail if the
+server is not configured to use an external ACL file.
+
+@examples
+
+```
+> ACL LOAD
++OK
+
+> ACL LOAD
+-ERR /tmp/foo:1: Unknown command or category name in ACL...
+```