2.2.1.1 CLIENT_LOG

The CLIENT_LOG structure is used in the LinkViewerToMacLogging (section 2.2.4.20) message. The purpose of this structure is to provide logging information from the client when a stream (2) stops for any reason.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

cbSize

info (1142 bytes)

...

...

...

dwSourceId

...

dwIPAddress

...

szComputerDNS (260 bytes)

...

...

...

szOS (16 bytes)

...

...

...

qwOSVersion

...

...

szCPU (16 bytes)

...

...

...

szProto

...

...

szTransport

...

...

dwPacketsLostNet

...

dwPacketsLostContNet

...

dwResendRequests

...

dwPacketsRecoveredResent

...

dwPacketsResent

...

cbSize (4 bytes): An unsigned 32-bit integer. Specifies the length of the CLIENT_LOG structure in bytes.

info (1142 bytes): A CLIENT_LOG_INFO (section 2.2.1.2) structure.

dwSourceId (4 bytes): An unsigned 32-bit integer. It MUST be the value of the openFileId field in the LinkMacToViewerReportOpenFile (section 2.2.4.7) message.

dwIPAddress (4 bytes): An unsigned 32-bit integer. It SHOULD be set to 0xFFFFFFFF but MAY be set to the client's IPv4 address if IPv4 is used.<1>

szComputerDNS (260 bytes): A string field. It SHOULD be set to a hyphen (-) but MAY be set to the client's domain name system (DNS) name.<2>

szOS (16 bytes): A string field. It SHOULD be set to the name and version of the operating system used by the client.

qwOSVersion (8 bytes): An unsigned 64-bit integer. It MUST specify the version number of the client's operating system. The version number consists of four 16-bit integer parts. The most significant 16 bits of the qwOSVersion field MUST be set to the most significant part of the version number - that is, what is often referred to as the major version number. The second most significant bits of the qwOSVersion field MUST be set to the second most significant part of the version number, often referred to as the minor version number (and so on for the other two parts of the version number).

szCPU (16 bytes): A string field. It SHOULD be set to a string that describes the brand and model number of the CPU used on the client.

szProto (8 bytes): A string field. It MUST be set to "mms".

szTransport (8 bytes): A string field. It MUST be set to the transport protocol used by the server to transmit Data (section 2.2.2) packets to the client. The value MUST be one of the following:

Value

Meaning

"UDP"

User Datagram Protocol.

"TCP"

Transmission Control Protocol.

dwPacketsLostNet (4 bytes): An unsigned 32-bit integer. It MUST be set to the number of Data (section 2.2.2) packets lost that are lost at the network layer.

dwPacketsLostContNet (4 bytes): An unsigned 32-bit integer. It MUST be set to the largest number of consecutive missing Data (section 2.2.2) packets.

dwResendRequests (4 bytes): An unsigned 32-bit integer. It MUST be set to the number of Data (section 2.2.2) packets that the client has asked the server to resend.

dwPacketsRecoveredResent (4 bytes): An unsigned 32-bit integer. It MUST be set to the number of Data (section 2.2.2) packets that the client recovered as the result of the server resending a Data (section 2.2.2) packet.

dwPacketsResent (4 bytes): An unsigned 32-bit integer. It MUST be set to the number of Data (section 2.2.2) packets that the client received that are resent by the server.