View source for Protocols/OSCAR/Foodgroups/OSERVICE/Datatypes/USERINFO

{{Protocols/OSCAR}}

Due to the common nature and detailed information for the USERINFO datatype, it was separated here. It largely is in use within the [[Protocols/OSCAR/Foodgroups/OSERVICE|OSERVICE]] foodgroup.

=== Usages ===
Protocols/OSCAR/SNAC/OSERVICE_USER_INFO_QUERY

Protocols/OSCAR/SNAC/OSERVICE_USER_INFO_UPDATE

Protocols/OSCAR/SNAC/OSERVICE_SET_USERINFO_FIELDS


=== Datatype: OSERVICE__USERINFO ===

Common data structure that contains a user's username and information about their session.

{| class="wikitable"
! Name
! Type
! Notes
|-
| displayId
| string08
| Formated username
|-
| evil
| uint16 (word)
| Warning level of user
|-
| userAttributes
| [[Protocols/OSCAR/TLV|tlvBlock]]
| ''[Class: [[Protocols/OSCAR/Foodgroups/OSERVICE/Datatypes/USERINFO#TLV_Class:_OSERVICE_USER_INFO_TAGS|OSERVICE__USER_INFO_TAGS]]]'' TLV Block of user attributes
|}


==== From Aleksandr Shutko: Basic OSCAR information (Online userinfo block) ====


<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td bgcolor=#4040FF>
<table width=100% cellSpacing=0 cellPadding=0 border=0><tr><td><b>
<font color="white">&nbsp;Basic OSCAR information (Userinfo block)&nbsp;</font>
</b></td><td width=40% align=right><b><font color="white">&nbsp;</font></b>
</td></tr></table>
</td></tr></table>
</td></tr></table>

<br>

<table width=640 cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td bgcolor=#E9E9E9>
<table width=100% cellSpacing=0 cellPadding=0 bgcolor="#4040FF" border=0><tr>
<td><b><font size=2 color="white">&nbsp;
 Online userinfo block&nbsp;</font></b></td>
</tr></table>
</td></tr><tr><td bgcolor=#E9E9E9>
<table width=100% cellSpacing=0 cellPadding=0 border=0>
<tr><td width=5>&nbsp;</td><td><br>
&nbsp;&nbsp;&nbsp;&nbsp;
Many usefull SNACs contain special block with online user information. This block
allways contain screenname (uin), warning level and number of TLVs in TLV chain.
TLV chain contain additional user information like DC info, status, user class,
idle time, online time, external ip address, account registration time, etc...
<br><br>

&nbsp;&nbsp;&nbsp;&nbsp;
Here is the list of SNACs that contain userinfo block: SNAC(03,0B), SNAC(04,07),
SNAC(0E,06), SNAC(01,0F), SNAC(01,10), SNAC(02,06), ... Most of them contain just
three TLVs: user class, idle time, online time.
<br><br>

&nbsp;&nbsp;&nbsp;&nbsp;
Note that you may find TLV not listed here in userinfo block. If you have such
new TLV, please send it to author of this documentation. Here is the format of
the online userinfo block (all TLVs are optional):
<br><br>

<table width=620 cellSpacing=0 cellPadding=0 align=center border=0><tr><td width=20></td><td>
<table width=600 bgcolor=darkgreen cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td bgcolor=#FAFAFA>

<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=20></td>
<td width=125>&nbsp;xx</td>
<td width=5>&nbsp;</td>
<td>byte</td>
<td width=5>&nbsp;</td>
<td width=330>screenname (uin) length</td>
</tr>
<tr>
<td></td>
<td>&nbsp;xx ..</td>
<td>&nbsp;</td>
<td>ascii</td>
<td>&nbsp;</td>
<td>screenname (uin) string</td>
</tr>
<tr>
<td></td>
<td>&nbsp;xx xx</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>warning level</td>
</tr>
<tr>
<td></td>
<td>&nbsp;xx xx</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>number of tlvs in tlv-chain</td>
</tr>
</table>

</td></tr><tr><td bgcolor=#FAFAFA>

<!-- nested tlv(0x01) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;00 01</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x01) - user class <span >(nick flags)</span></td>
</tr>
<tr>
<td>&nbsp;00 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;xx xx xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=324>[[Protocols/OSCAR/Foodgroups/OSERVICE/Datatypes/USERINFO#Class:_OSERVICE_USER_FLAGS|User class]]</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x01) end-->

<!-- nested tlv(0x02) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0 >
<tr>
<td width=125>&nbsp;00 02</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x02) - create time</td>
</tr>
<tr>
<td>&nbsp;00 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0 >
<tr>
<td width=125>&nbsp;xx xx xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=324>create time (unix time_t format)</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x02) end-->

<!-- nested tlv(0x03) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;00 03</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x03) - signon time</td>
</tr>
<tr>
<td>&nbsp;00 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;xx xx xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=324>signon time (unix time_t format)</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x03) end-->

<!-- nested tlv(0x04) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0 >
<tr>
<td width=125>&nbsp;00 04</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x04) - idle time</td>
</tr>
<tr>
<td>&nbsp;00 02</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0 >
<tr>
<td width=125>&nbsp;xx xx</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>idle time (in seconds)</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x04) end-->

<!-- nested tlv(0x05) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;00 05</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x05) - account creation time <span><br>(member since)</span></td>
</tr>
<tr>
<td>&nbsp;00 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;xx xx xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=324>time when this account was registered</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x05) end-->

<!-- nested tlv(0x06) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;00 06</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x06) - user status [ICQ only]</td>
</tr>
<tr>
<td>&nbsp;00 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;xx xx xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=324>[[Protocols/OSCAR/Foodgroups/OSERVICE/Datatypes/USERINFO#Class:_OSERVICE_USER_STATUS|User status]]</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x06) end-->

<!-- nested tlv(0x0A) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;00 0A</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x0A) - external ip addr [ICQ only]</td>
</tr>
<tr>
<td>&nbsp;00 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;xx xx xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=324>External ip address</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x0A) end-->

<!-- nested tlv(0x0C) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;00 0C</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x0C) - user DC info [ICQ only]</td>
</tr>
<tr>
<td>&nbsp;00 25</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
   <tr>
   <td width=125>&nbsp;xx xx xx xx</td>
   <td width=5>&nbsp;</td>
   <td>dword</td>
   <td width=5>&nbsp;</td>
   <td width=324>DC internal ip address</td>
   </tr>
   <tr>
   <td>&nbsp;xx xx xx xx</td>
   <td>&nbsp;</td>
   <td>dword</td>
   <td>&nbsp;</td>
   <td>DC tcp port</td>
   </tr>
   <tr>
   <td>&nbsp;xx</td>
   <td>&nbsp;</td>
   <td>byte</td>
   <td>&nbsp;</td>
   <td>[[Protocols/OSCAR/Foodgroups/ICQ#Types|DC type]]</td>
   </tr>
   <tr>
   <td>&nbsp;xx xx</td>
   <td>&nbsp;</td>
   <td>word</td>
   <td>&nbsp;</td>
   <td>DC protocol version</td>
   </tr>
   <tr>
   <td>&nbsp;xx xx xx xx</td>
   <td>&nbsp;</td>
   <td>dword</td>
   <td>&nbsp;</td>
   <td>DC auth cookie</td>
   </tr>
   <tr>
   <td>&nbsp;xx xx xx xx</td>
   <td>&nbsp;</td>
   <td>dword</td>
   <td>&nbsp;</td>
   <td>Web front port</td>
   </tr>
   <tr>
   <td>&nbsp;00 00 00 03</td>
   <td>&nbsp;</td>
   <td>dword</td>
   <td>&nbsp;</td>
   <td>Client futures</td>
   </tr>
   <tr>
   <td>&nbsp;xx xx xx xx</td>
   <td>&nbsp;</td>
   <td>dword</td>
   <td>&nbsp;</td>
   <td>last info update time</td>
   </tr>
   <tr>
   <td>&nbsp;xx xx xx xx</td>
   <td>&nbsp;</td>
   <td>dword</td>
   <td>&nbsp;</td>
   <td>last ext info update time (i.e. icqphone status)</td>
   </tr>
   <tr>
   <td>&nbsp;xx xx xx xx</td>
   <td>&nbsp;</td>
   <td>dword</td>
   <td>&nbsp;</td>
   <td>last ext status update time (i.e. phonebook)</td>
   </tr>
   <tr>
   <td>&nbsp;xx xx</td>
   <td>&nbsp;</td>
   <td>word</td>
   <td>&nbsp;</td>
   <td>unknown</td>
   </tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x0C) end-->

<!-- nested tlv(0x0D) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;00 0D</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x0D) - client capabilities list</td>
</tr>
<tr>
<td>&nbsp;00 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;xx ..</td>
<td width=5>&nbsp;</td>
<td>CLSIDs</td>
<td width=5>&nbsp;</td>
<td width=324>Client [[Protocols/OSCAR/UUIDs|capabilities]] list</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x0A) end-->

<!-- nested tlv(0x0F) begin -->
<table width=592 cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td height=8 colspan=4></td></tr><tr><td width=20></td><td>
<table width=564 bgcolor=darkred cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 align=center border=0><tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;00 0F</td>
<td width=5>&nbsp;</td>
<td>word</td>
<td width=5>&nbsp;</td>
<td width=324>TLV.Type(0x0F) - <span>online time</span></td>
</tr>
<tr>
<td>&nbsp;00 04</td>
<td>&nbsp;</td>
<td>word</td>
<td>&nbsp;</td>
<td>TLV.Length</td>
</tr>
</table>

</td></tr>
<tr><td bgcolor=#E9E9E9>

<table width=564 cellSpacing=0 cellPadding=0 align=center border=0>
<tr>
<td width=125>&nbsp;xx xx xx xx</td>
<td width=5>&nbsp;</td>
<td>dword</td>
<td width=5>&nbsp;</td>
<td width=324>client online time (in seconds)</td>
</tr>
</table>
</td></tr>
</table>
</td></tr></table>

</td><td width=5></td></tr>
<tr><td height=5 colspan=3>
</td></tr></table>
<!-- nested tlv(0x01) end-->

</td></tr></table>
</td></tr></table>
</td></tr></table>

<br>

</td><td width=5>
</td></tr></table>
</td></tr></table>
</td></tr></table>
</td></tr></table>

=== Class: OSERVICE__USER_FLAGS ===

Bits specifying a user's characteristics; For compatibility reasons the lower 2 bytes of USER_FLAGS are sent in the USER_FLAGS tag, while the upper bytes are sent in the USER_FLAGS2 tag. 

To form the full user flags the client needs to combine USER_FLAGS and USER_FLAGS2 shifted to the left 2 bytes. USER_FLAGS is always a uint16 (word), which USER_FLAGS2 can be any size. Another way to express the math: <code>userFlags = USER_FLAG | (USER_FLAGS2 << 0x10)</code>

{| class="wikitable"
! Name
! Value
! Notes
|-
| OSERVICE__USER_FLAG_DAMNED_TRANSIENT
| 0x0001
| Unconfirmed account
|-
| OSERVICE__USER_FLAG_ADMINISTRATOR
| 0x0002
| NINA Administrator
|-
| OSERVICE__USER_FLAG_AOL
| 0x0004
| User is on an AOL client
|-
| OSERVICE__USER_FLAG_OSCAR_PAY
| 0x0008
| NINA commercial account
|-
| OSERVICE__USER_FLAG_OSCAR_FREE
| 0x0010
| NINA free account, typically AIM
|-
| OSERVICE__USER_FLAG_UNAVAILABLE
| 0x0020
| User is away
|-
| OSERVICE__USER_FLAG_ICQ
| 0x0040
| ICQ user; AIM bit will also be set
|-
| OSERVICE__USER_FLAG_WIRELESS
| 0x0080
| On a mobile device
|-
| OSERVICE__USER_FLAG_INTERNAL
| 0x0100
| Account for internal use
|-
| OSERVICE__USER_FLAG_FISH
| 0x0200
| Using IM Forwarding
|-
| OSERVICE__USER_FLAG_BOT
| 0x0400
| Bot user
|-
| OSERVICE__USER_FLAG_BEAST
| 0x0800
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_FLAG_ONE_WAY_WIRELESS
| 0x1000
| One way wireless device
|-
| OSERVICE__USER_FLAG_OFFICIAL
| 0x2000
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_FLAG_BUDDY_MATCH_DIRECT
| 0x10000
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_FLAG_BUDDY_MATCH_INDIRECT
| 0x20000
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_FLAG_NO_KNOCK_KNOCK
| 0x00040000
| Do not display the "not on your Buddy List" knock-knock as the server took care of it or the sender is trusted
|-
| FORWARD_MOBILE
| 0x00080000
| If no active instances forward to mobile
|}

==== From Aleksandr Shutko: User classes ====
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td  bgcolor=#E9E9E9 >
<table width=100% cellSpacing=0 cellPadding=0 bgcolor="#4040FF" border=0>
<tr>
<td><b><font size=2 color="white">&nbsp;<a name="user_class"></a>User classes&nbsp;</font></b></td>
</tr>
</table>
</td></tr>

<tr><td bgcolor=#E9E9E9>
<table width=100% cellSpacing=0 cellPadding=0 border=0>
<tr><td colspan=3 height=5></td></tr>
<tr><td width=5>&nbsp;</td>
<td>

<a name="m0003"></a>&nbsp;&nbsp;&nbsp;&nbsp;
AOL users are divided into several classes. User class field is a 2 byte bitmask.
For example ICQ non-commercial account with away status has user-class=0x0070
(OSERVICE__USER_FLAG_OSCAR_FREE (@RUS CLASS_FREE) | OSERVICE__USER_FLAG_UNAVAILABLE (@RUS CLASS_AWAY) | OSERVICE__USER_FLAG_ICQ (@RUS CLASS_ICQ) = 0x0070). Here is the list of known bit
values in user class bitmask:
<br><br>

<table width=100% cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td width=20></td>
<td>
<table width=570 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0>
<tr><td bgcolor=#E5E5E5>

<table width=570 cellSpacing=1 cellPadding=1 border=0>
<tr>
<td bgcolor=#f9f9f9 width=50 valign=top>&nbsp;&nbsp;<b>0x0001</b></td>
<td bgcolor=#f9f9f9 width=1 valign=top>&nbsp;&nbsp;OSERVICE__USER_FLAG_DAMNED_TRANSIENT (@RUS CLASS_UNCONFIRMED)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 width=350 valign=top>&nbsp;&nbsp;AOL unconfirmed user flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0002</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_FLAG_ADMINISTRATOR (@RUS CLASS_ADMINISTRATOR)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;AOL administrator flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0004</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_FLAG_AOL (@RUS CLASS_AOL)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;AOL staff user flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0008</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_FLAG_OSCAR_PAY (@RUS CLASS_COMMERCIAL)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;AOL commercial account flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0010</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_FLAG_OSCAR_FREE (@RUS CLASS_FREE)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;ICQ non-commercial account flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0020</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_FLAG_UNAVAILABLE (@RUS CLASS_AWAY)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Away status flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0040</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_FLAG_ICQ (@RUS CLASS_ICQ)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;ICQ user sign</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0080</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_FLAG_WIRELESS (@RUS CLASS_WIRELESS)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;AOL wireless user</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0100</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;CLASS_UNKNOWN100&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Unknown bit</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0200</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;CLASS_UNKNOWN200&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Unknown bit</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0400</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;CLASS_UNKNOWN400&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Unknown bit</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0800</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;CLASS_UNKNOWN800&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Unknown bit</td>
</tr>

</table>

</td></tr></table>
</td></tr></table>
</td></tr></table>
<br>
</td>
<td width=15></td></tr>
</table>
</td></tr></table>
</td></tr></table>

===Class: OSERVICE__USER_STATUS ===

==== From Aleksandr Shutko: User status ====
<table width=640 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0><tr><td bgcolor=#E9E9E9>
<table width=100% cellSpacing=0 cellPadding=0 bgcolor="#4040FF" border=0>
<tr>
<td><b><font size=2 color="white">&nbsp;<a name="user_status"></a>User status&nbsp;</font></b></td>
</tr>
</table>
</td></tr>

<tr><td bgcolor=#E9E9E9>
<table width=100% cellSpacing=0 cellPadding=0 border=0>
<tr><td colspan=3 height=5></td></tr>
<tr><td width=5>&nbsp;</td>
<td>

<a name="m0004"></a>&nbsp;&nbsp;&nbsp;&nbsp;
ICQ service presence notifications use user status field which consist of
two parts. First is a various flags (birthday flag, webaware flag, etc).
Second is a user status (online, away, busy, etc) flags. Each part is a two
bytes long. Here is the list of masks for both parts:<br><br>

<table width=100% cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td width=20></td>
<td>
<table width=570 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0>
<tr><td bgcolor=#E5E5E5>

<table width=570 cellSpacing=1 cellPadding=1 border=0>
<tr>
<td bgcolor=#f9f9f9 width=50 valign=top>&nbsp;&nbsp;<b>0x0001</b></td>
<td bgcolor=#f9f9f9 width=1 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_FLAG_WEBAWARE (@RUS STATUS_WEBAWARE)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 width=350 valign=top>&nbsp;&nbsp;Status webaware flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0002</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_FLAG_SHOWIP (@RUS STATUS_SHOWIP)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Status show ip flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0008</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_FLAG_BIRTHDAY (@RUS STATUS_BIRTHDAY)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;User birthday flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0020</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_FLAG_WEBFRONT (@RUS STATUS_WEBFRONT)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;User active webfront flag</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0100</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_FLAG_DCDISABLED (@RUS STATUS_DCDISABLED)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Direct connection not supported</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x1000</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_FLAG_IP_EXPOSE_NONE (@RUS STATUS_DCAUTH)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Direct connection upon authorization</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x2000</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_FLAG_IP_EXPOSE_BL (@RUS STATUS_DCCONT)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;DC only with contact users</td>
</tr>

</table>

</td></tr></table>
</td></tr></table>
</td></tr></table>

<br>

<table width=100% cellSpacing=0 cellPadding=0 align=center border=0>
<tr><td width=20></td>
<td>
<table width=570 bgcolor=darkblue cellSpacing=0 cellPadding=0 border=0><tr><td>
<table width=100% cellSpacing=2 cellPadding=0 border=0>
<tr><td bgcolor=#E5E5E5>

<table width=570 cellSpacing=1 cellPadding=1 border=0>
<tr>
<td bgcolor=#f9f9f9 width=50 valign=top>&nbsp;&nbsp;<b>0x0000</b></td>
<td bgcolor=#f9f9f9 width=1 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_MASK_NORMAL (@RUS STATUS_ONLINE)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 width=350 valign=top>&nbsp;&nbsp;Status is online</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0001</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_MASK_AWAY (@RUS STATUS_AWAY)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Status is away</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0002</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_MASK_DND (@RUS STATUS_DND)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Status is no not disturb (DND)</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0004</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_MASK_NA (@RUS STATUS_NA)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Status is not available (N/A)</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0010</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_MASK_BUSY (@RUS STATUS_OCCUPIED)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Status is occupied (BISY)</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0020</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_MASK_FREE4CHAT (@RUS STATUS_FREE4CHAT)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Status is free for chat</td>
</tr>

<tr>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;<b>0x0100</b></td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;OSERVICE__USER_STATUS_MASK_INVISIBLE (@RUS STATUS_INVISIBLE)&nbsp;&nbsp;</td>
<td bgcolor=#f9f9f9 valign=top>&nbsp;&nbsp;Status is invisible</td>
</tr>

</table>

</td></tr></table>
</td></tr></table>
</td></tr></table>
<br>
</td>
<td width=15></td></tr>
</table>
</td></tr></table>
</td></tr></table>

=== TLV Class: OSERVICE__USER_INFO_TAGS ===

These tags contain information about users and their server state.

{| class="wikitable"
! Name
! Tag
! Type
! Notes
|-
| OSERVICE__USER_INFO_USER_FLAGS
| 0x01
| uint16 (word)
| ''[Class: [[Protocols/OSCAR/Foodgroups/OSERVICE/Datatypes/USERINFO#Class:_OSERVICE_USER_FLAGS|OSERVICE__USER_FLAGS]]]'' Flags that represent the user's state
|-
| OSERVICE__USER_INFO_CREATE_TOD
| 0x02
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_SIGNON_TOD
| 0x03
| t70
| Signon time
|-
| OSERVICE__USER_INFO_IDLE_TIME
| 0x04
| uint16 (word)
| Idle time in minutes
|-
| OSERVICE__USER_INFO_MEMBER_SINCE
| 0x05
| t70
| Approximation of NINA membership
|-
| OSERVICE__USER_INFO_STATUS
| 0x06
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_CLIENTTYPE
| 0x08
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_REALIPADDRESS
| 0x0A
| uint32 (dword)
| Network byte order IPv4 address
|-
| OSERVICE__USER_INFO_REALIPV6ADDRESS
| 0x6A
| string
| String of IPv6 address
|-
| OSERVICE__USER_INFO_ICQINFO
| 0x0C
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_OSCAR_CAPS
| 0x0D
| Array of [[Protocols/OSCAR/UUIDs|UUID]]
| Client capabilities - if not present use the previous values received; if present but empty, clear previous values
|-
| OSERVICE__USER_INFO_AOL_CAPS
| 0x0E
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_OSCAR_OT
| 0x0F
| uint32 (dword)
| Online time in seconds, if user is using OSCAR
|-
| OSERVICE__USER_INFO_AOL_OT
| 0x10
| uint32 (dword)
| Online time in seconds, if user is using P3
|-
| OSERVICE__USER_INFO_ICQ_BROAD_BLOB
| 0x11
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_ICQ_BROAD_TYPE
| 0x12
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_INSTANCES
| 0x13
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_MY_INSTANCE_NUM
| 0x14
| uint8 (byte)
| Set in first user info. Identifies the instance number of this client
|-
| OSERVICE__USER_INFO_MY_PARENTAL_CONTROLS
| 0x15
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_MY_ZIP
| 0x16
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_MY_BOT_INFO
| 0x17
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_ALIAS
| 0x18
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_SHORT_OSCAR_CAPS
| 0x19
| Array of uint16 (word)
| Short form of capabilities
|-
| OSERVICE__USER_INFO_SHORT_AOL_CAPS
| 0x1A
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_ENCRYPTION_CERT_MD5
| 0x1B
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_BART_INFO
| 0x1D
| Array of [[Protocols/OSCAR/Foodgroups/BART#Datatype:_BART_ID|BART__ID]]
| Expressions
|-
| OSERVICE__USER_INFO_MY_SUBSCRIPTIONS
| 0x1E
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_USER_FLAGS2
| 0x1F
| Array of uint8 (byte)
| ''[Class: [[Protocols/OSCAR/Foodgroups/OSERVICE/Datatypes/USERINFO#Class:_OSERVICE_USER_FLAGS|OSERVICE__USER_FLAGS]]]'' Upper bytes of user flags, can be any size. userFlags = USER_FLAG | (USER_FLAGS2 << 16)
|-
| OSERVICE__USER_INFO_UNKNOWN_22
| 0x22
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_BUDDY_FEED_TIME
| 0x23
| t70
| Last Buddy Feed update time
|-
| OSERVICE__USER_INFO_SIG_TIME
| 0x26
| t70
| Time that the profile was set
|-
| OSERVICE__USER_INFO_AWAY_TIME
| 0x27
| t70
| Time that away was set
|-
| OSERVICE__USER_INFO_PRIMARY_INSTANCE
| 0x28
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_UNKNOWN_29_TIME
| 0x29
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_GEO_COUNTRY
| 0x2A
| string
| Two character country code. Sent from host to client if country is known
|-
| OSERVICE__USER_INFO_BUDDY_UPDATE_INDC_URL
| 0x2B
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_UNKNOWN_2C
| 0x2C
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_UNKNOWN_2D
| 0x2D
| ?
| NOT CURRENTLY DOCUMENTED
|-
| OSERVICE__USER_INFO_UNKNOWN_2F
| 0x2F
| ?
| NOT CURRENTLY DOCUMENTED
|}

[[Category:With_Contrib]]
[[Category:Stub]]
[[Category:AOL]]
[[Category:AIM]]
[[Category:Protocols/OSCAR]]
[[Category:Work_In_Progress]]