Skip to content

Commit c75c9da

Browse files
dwdoughertydwdougherty
committed
DEV: move RESP information from data to each page
1 parent 251f45f commit c75c9da

File tree

374 files changed

+5702
-3047
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

374 files changed

+5702
-3047
lines changed

‎content/commands/acl-cat.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -118,3 +118,21 @@ Then we may want to know what commands are part of a given category:
118118
30) "psync"
119119
31) "sort"
120120
```
121+
122+
## Return information
123+
124+
{{< multitabs id="acl-cat-return-info"
125+
tab1="RESP2"
126+
tab2="RESP3" >}}
127+
128+
One of the following:
129+
* [Array reply](../../develop/reference/protocol-spec#arrays): an array of [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings) elements representing ACL categories or commands in a given category.
130+
* [Simple error reply](../../develop/reference/protocol-spec#simple-errors): the command returns an error if an invalid category name is given.
131+
132+
-tab-sep-
133+
134+
One of the following:
135+
* [Array reply](../../develop/reference/protocol-spec#arrays): an array of [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings) elements representing ACL categories or commands in a given category.
136+
* [Simple error reply](../../develop/reference/protocol-spec#simple-errors): the command returns an error if an invalid category name is given.
137+
138+
{{< /multitabs >}}

‎content/commands/acl-deluser.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,3 +50,17 @@ exist, in such case no operation is performed for the non existing users.
5050
> ACL DELUSER antirez
5151
1
5252
```
53+
54+
## Return information
55+
56+
{{< multitabs id="acl-deluser-return-info"
57+
tab1="RESP2"
58+
tab2="RESP3" >}}
59+
60+
[Integer reply](../../develop/reference/protocol-spec#integers): the number of users that were deleted. This number will not always match the number of arguments since certain users may not exist.
61+
62+
-tab-sep-
63+
64+
[Integer reply](../../develop/reference/protocol-spec#integers): the number of users that were deleted. This number will not always match the number of arguments since certain users may not exist.
65+
66+
{{< /multitabs >}}

‎content/commands/acl-dryrun.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,3 +56,21 @@ This command can be used to test the permissions of a given user without having
5656
> ACL DRYRUN VIRGINIA GET foo
5757
"User VIRGINIA has no permissions to run the 'get' command"
5858
```
59+
60+
## Return information
61+
62+
{{< multitabs id="acl-dryrun-return-info"
63+
tab1="RESP2"
64+
tab2="RESP3" >}}
65+
66+
Any of the following:
67+
* [Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK` on success.
68+
* [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): an error describing why the user can't execute the command.
69+
70+
-tab-sep-
71+
72+
Any of the following:
73+
* [Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK` on success.
74+
* [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): an error describing why the user can't execute the command.
75+
76+
{{< /multitabs >}}

‎content/commands/acl-genpass.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,3 +73,17 @@ hex character.
7373
> ACL GENPASS 5
7474
"90"
7575
```
76+
77+
## Return information
78+
79+
{{< multitabs id="acl-genpass-return-info"
80+
tab1="RESP2"
81+
tab2="RESP3" >}}
82+
83+
[Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): pseudorandom data. By default it contains 64 bytes, representing 256 bits of data. If `bits` was given, the output string length is the number of specified bits (rounded to the next multiple of 4) divided by 4.
84+
85+
-tab-sep-
86+
87+
[Bulk string reply](../../develop/reference/protocol-spec#bulk-strings): pseudorandom data. By default it contains 64 bytes, representing 256 bits of data. If `bits` was given, the output string length is the number of specified bits (rounded to the next multiple of 4) divided by 4.
88+
89+
{{< /multitabs >}}

‎content/commands/acl-getuser.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -80,3 +80,21 @@ Here's an example configuration for a user
8080
9) "channels"
8181
10) "&*"
8282
```
83+
84+
## Return information
85+
86+
{{< multitabs id="acl-getuser-return-info"
87+
tab1="RESP2"
88+
tab2="RESP3" >}}
89+
90+
One of the following:
91+
* [Array reply](../../develop/reference/protocol-spec#arrays): a list of ACL rule definitions for the user.
92+
* [Nil reply](../../develop/reference/protocol-spec#bulk-strings): if user does not exist.
93+
94+
-tab-sep-
95+
96+
One of the following:
97+
* [Map reply](../../develop/reference/protocol-spec#maps): a set of ACL rule definitions for the user
98+
* [Null reply](../../develop/reference/protocol-spec#nulls): if user does not exist.
99+
100+
{{< /multitabs >}}

‎content/commands/acl-help.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,3 +28,16 @@ title: ACL HELP
2828
---
2929
The `ACL HELP` command returns a helpful text describing the different subcommands.
3030

31+
## Return information
32+
33+
{{< multitabs id="acl-help-return-info"
34+
tab1="RESP2"
35+
tab2="RESP3" >}}
36+
37+
[Array reply](../../develop/reference/protocol-spec#arrays): a list of subcommands and their descriptions.
38+
39+
-tab-sep-
40+
41+
[Array reply](../../develop/reference/protocol-spec#arrays): a list of subcommands and their descriptions.
42+
43+
{{< /multitabs >}}

‎content/commands/acl-list.md‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,3 +43,17 @@ configuration file if you wish (but make sure to check [`ACL SAVE`]({{< relref "
4343
1) "user antirez on #9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08 ~objects:* &* +@all -@admin -@dangerous"
4444
2) "user default on nopass ~* &* +@all"
4545
```
46+
47+
## Return information
48+
49+
{{< multitabs id="acl-list-return-info"
50+
tab1="RESP2"
51+
tab2="RESP3" >}}
52+
53+
[Array reply](../../develop/reference/protocol-spec#arrays): an array of [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings) elements.
54+
55+
-tab-sep-
56+
57+
[Array reply](../../develop/reference/protocol-spec#arrays): an array of [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings) elements.
58+
59+
{{< /multitabs >}}

‎content/commands/acl-load.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,3 +47,21 @@ sure to have an *all or nothing* behavior, that is:
4747
> ACL LOAD
4848
-ERR /tmp/foo:1: Unknown command or category name in ACL...
4949
```
50+
51+
## Return information
52+
53+
{{< multitabs id="acl-load-return-info"
54+
tab1="RESP2"
55+
tab2="RESP3" >}}
56+
57+
[Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK` on success.
58+
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 cases, the error will be reported to the user in the error.
59+
Finally, the command will fail if the server is not configured to use an external ACL file.
60+
61+
-tab-sep-
62+
63+
[Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK` on success.
64+
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 cases, the error will be reported to the user in the error.
65+
Finally, the command will fail if the server is not configured to use an external ACL file.
66+
67+
{{< /multitabs >}}

‎content/commands/acl-log.md‎

Lines changed: 21 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -94,4 +94,24 @@ Each log entry is composed of the following fields:
9494
7. `client-info`: Displays the client info of a client which caused one of the security events.
9595
8. `entry-id`: The sequence number of the entry (starting at 0) since the server process started. Can also be used to check if items were “lost”, if they fell between periods.
9696
9. `timestamp-created`: A UNIX timestamp in `milliseconds` at the time the entry was first created.
97-
10. `timestamp-last-updated`: A UNIX timestamp in `milliseconds` at the time the entry was last updated.
97+
10. `timestamp-last-updated`: A UNIX timestamp in `milliseconds` at the time the entry was last updated.
98+
99+
## Return information
100+
101+
{{< multitabs id="acl-log-return-info"
102+
tab1="RESP2"
103+
tab2="RESP3" >}}
104+
105+
When called to show security events:
106+
* [Array reply](../../develop/reference/protocol-spec#arrays): an array of [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings) elements representing ACL security events.
107+
When called with `RESET`:
108+
* [Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK` if the security log was cleared.
109+
110+
-tab-sep-
111+
112+
When called to show security events:
113+
* [Array reply](../../develop/reference/protocol-spec#arrays): an array of [Bulk string reply](../../develop/reference/protocol-spec#bulk-strings) elements representing ACL security events.
114+
When called with `RESET`:
115+
* [Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK` if the security log was cleared.
116+
117+
{{< /multitabs >}}

‎content/commands/acl-save.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,3 +45,19 @@ option), this command will save the currently defined ACLs from the server memor
4545
> ACL SAVE
4646
-ERR There was an error trying to save the ACLs. Please check the server logs for more information
4747
```
48+
49+
## Return information
50+
51+
{{< multitabs id="acl-save-return-info"
52+
tab1="RESP2"
53+
tab2="RESP3" >}}
54+
55+
[Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK`.
56+
The command may fail with an error for several reasons: if the file cannot be written or if the server is not configured to use an external ACL file.
57+
58+
-tab-sep-
59+
60+
[Simple string reply](../../develop/reference/protocol-spec#simple-strings): `OK`.
61+
The command may fail with an error for several reasons: if the file cannot be written or if the server is not configured to use an external ACL file.
62+
63+
{{< /multitabs >}}

0 commit comments

Comments
 (0)