Link Search Menu Expand Document Edit GitHub

Disconnect


Disconnects a previously connected client.

mqtt> disconnect

Alias: mqtt> dis


Disconnects the currently active client context.

client@host> disconnect

Alias: client@host> dis


Options

OptionLong VersionExplanationDefault
-a--allDisconnect all connected clients. 
-i--identifierThe unique identifier of a client. 
-h--hostThe host the client is connected to.localhost
-e--sessionExpirySession expiry value in seconds.0 (No Expiry)
-r--reasonReason string for the disconnect. 
-up--userPropertyA user property of the disconnect message. 

Help Options

OptionLong VersionExplanation
 --helpDisplay help message for command.
 --versionDisplay version information of the cli.

Examples

Connect a client which is identified by myClient and disconnect it afterward using default settings

mqtt> con -i myClient
myClient@localhost> dis
mqtt>

Connect a client which is identified by myClient on specific settings and disconnect it afterward

mqtt> con -i myClient -h broker.hivemq.com
myClient@localhost> exit  # client is still connected
mqtt> dis -i myClient -h broker.hivemq.com

NOTE: When specifying the identifier in order to uniquely identify the desired client, the hostname must also be provided. If you don’t specify these the default settings for these attributes will be used which may lead to unexpected behavior.