Command: CMD_RESTORE_SESSION
Destination: SD_LIN
Destination Channel: 0
Description
Clients use this command to cause the to restore the internal representation of a read (parsed) LDF (LIN Description File) that had been saved just before the client previously exited. Normal clients do not need this function because when they exit, they are done interacting with a given LDF. This command is present for php programs that run intermittently on behalf of a web page. This command is used in conjuction with the CMD_SAVE_SESSION command to simulate a normal session with the LIN server.
Command Data Format
Unique Identifier variable number of bytes
Unique IdentifierResponse Data Format
This is a string of characters that is used to identify the data resulting from parsing an LDF. The php session id is a good choice to use for web page usage. The string does not have to be null terminated.
Name 32 bytes
NameThis is the filename of the LDF that was parsed (read) by the . If the name is less than 32 bytes long, it is null padded.
Response Return Codes
RESP_OK Restoration was successful. RESP_UNSUPPORTED There is no LIN channel in the . RESP_UNKNOWN_ERR An unknown error occurred.