msnp-wiki/docs/commands/gcf.md
yellows111 ce7c3bee1c
0.2.0: The Winter Roll-up
i have basically touched every file help

* Moved all the error code stuff to one new sectional page, because the old way of doing it sucked big time.
* Rename passport (soap) to RST
* Formatting changes (many)
* Several corrections
* change git host because git.kevinthe.horse seems Dead
2024-12-18 20:16:29 +00:00

1.7 KiB

Introduction

GCF is a command introduced with MSNP11.

It is a Notification Server command, without a request payload and WITH a response payload.

It gets configuration data from a file on the server.

Client/Request

Only in MSNP11 and MSNP12.

GCF TrID filename

Where filename is the file to retrieve. Only Shields.xml is known to be this parameter.

Server/Response

From filename

GCF TrID filename length
payload

Where length is the size (in bytes) of the payload.

Where payload is the data for this file.

Asynchronously

GCF 0 length
payload

Being an asynchronous command, the Transaction ID is set to 0.

Examples

Downloading shields

For more information read the Shields Configuration Data article.

By filename

Only in MSNP11 and MSNP12.

C: GCF 1 Shields.xml
S: GCF 1 Shields.xml 145
<?xml version="1.0" encoding="utf-8" ?><config><shield><cli maj="7" min="0" minbld="0" maxbld="9999" deny=" " /></shield><block></block></config>

Automatically

Since MSNP13.

C: USR 2 TWN I example@hotmail.com
S: GCF 0 158
<Policies><Policy type="SHIELDS"><config><shield><cli maj="7" min="0" minbld="0" maxbld="9999" deny=" " /></shield><block></block></config><Policy></Policies>
S: USR 2 TWN S passport=parameters,neat=huh,lc=1033,id=507

By filename after removal

NOTE: I don't know if this is correct.

C: GCF 3 Shields.xml

Server disconnects client.

Known changes

  • MSNP13: Dropped support for getting a response via filenames, and changed how the Shields configuration data is contained.