msnp-wiki/docs/files/shields.md

60 lines
2.0 KiB
Markdown
Raw Permalink Normal View History

# Introduction
`Shields.xml` contains the Shields Configuration Data, and was first seen in [MSNP11](../versions/msnp11.md).
It is provided by the [GCF](../commands/gcf.md) command.
# Content
*If this is in [MSNP13](../versions/msnp13.md) or above, this element will be contained in the following:*
```
<Policies><Policy type="SHIELDS"><config>...</config></Policy></Policies>
```
*Otherwise, it is prefixed with the following:*
```
<?xml version="1.0" encoding="utf-8" ?>
```
## config
The root element of the document. Nothing special.
Contains the `<shield>` and `<block>` elements.
### shield
Contains many `<cli>` elements.
#### cli
This empty attribute has 5 parameters:
* `maj`: The major version that this block applies to.
* `min`: The minor version that this block applies to.
* `minbld`: Lowest bound of builds that this block applies to.
* `maxbld`: Highest bound of builds that this block applies to
* `deny`: What features are disabled:
* `SharingFolders`: Sharing Folders. Since [MSNP13](../versions/msnp13.md).
* `protocolhandler`: Unknown.
* `dynamicbackgrounds`: Dynamic Backgrounds (Flash chat backgrounds).
* `phone`: Calling features. Since [MSNP13](../versions/msnp13.md).
* `voiceim`: Voice Clips.
* `camera`: Video Conversations.
* `audio`: Audio Conversations.
* `filexfer`: File transfer.
* `hotlinks`: Web links.
If this feature is blocked URLs sent in the chat will not be formatted as links.
* `ddp`: Dynamic Display Pictures (Flash avatars).
* `winks`: Winks (Flash full chat window animations).
### block
*Since [MSNP12](../versions/msnp12.md).*
Contains either `<hashes>` or `<regexp>` elements.
#### hashes
This element blocks file hashes from being sent.
TODO: Does anyone have an example of things that go here?
#### regexp
This element contains multiple `<imtext>` elments
##### imtext
This empty element only has the `value` attribute, which is the regular expression
to search instant message text for. This attribute is base64-encoded.