Logout (O) command
Description
(see command description format info here)
| Function: | Network command: logs out the network host (ends the programming session); serial command: ends the serial programming mode |
| Can be issued through: | Network (broadcasts ignored*, login required); serial port |
| Command format: | O |
| Possible replies: | A, D |
| First introduced: | Earlier than "baseline" V3.14/V3.51 |
| See also: | Authentication, Out-of-band (UDP) commands, Inband (TCP) commands, Command-phase (TCP) commands, Serial programming |
Details
Logout command performs a different action depending on whether it was issued through the network or through the serial port.
When the Logout command is issued through the network it closes the programming session that was opened using the Login (L) command . Denied (D) reply code is returned if the programming session is not in progress or if it doesn't belong to the sender of the Logout command - the DS remembers the IP-address of the network host that opens the programming session and requires that all subsequent commands (that require prior login) are sent from the same IP.
OK (A) status code is returned if command is accepted, but only if this command was sent as an out-of-band (UDP) or inband (TCP) command. No reply is sent in case of command-phase (TCP) command, the DS simply switches into the data phase ( Denied (D) reply code is still returned).
When the Logout command is issued through the serial port it makes the DS exit the serial programming mode (and into the data routing mode). Since no authentication is required for DS programming through the serial port the only possible reply code in this case is OK (A) .
Executing Logout command does not make the DS reboot. If it is necessary to reboot the DS (i.e. to make it reread updated setting values) the Reboot (E) command should be used instead.
* Without prior selection using Select In Broadcast Mode (W) command .