CLIENT SETNAME connection-name
Time complexity: O(1)
ACL categories: @slow, @connection
CLIENT SETNAME command assigns a name to the current connection.
The assigned name is displayed in the output of
CLIENT LIST so that it is possible to identify the client that performed a given connection.
For instance when Dragonfly is used in order to implement a queue, producers and consumers of messages may want to set the name of the connection according to their role.
It is not possible to use spaces in the connection name as this would violate the format of the
CLIENT LIST reply.
It is possible to entirely remove the connection name setting it to the empty string, that is not a valid connection name since it serves to this specific purpose.
The connection name can be inspected using
Every new connection starts without an assigned name.
Tip: setting names to connections is a good way to debug connection leaks due to bugs in the application using Dragonfly.
Simple string reply:
OK if the connection name was successfully set.