Protocols/OSCAR/Sign On: Difference between revisions

From NINA Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 160: Line 160:


-->
-->
=== TLV Class: FLAP__SIGNON_TAGS ===
These tags are used in the FLAP signon frame to BOS. They appear right after the 4 byte version number.
@MAKE NOTE: Difference between ones used if BUCP is in use and ones if clientLogin or w/e was used
{| class="wikitable"
! Name
! Tag
! Type
! Notes
|-
| OSERVICE__TLV_TAGS_CLIENT_IDENTITY
| 0x03
| string
| Yet another client name
|-
| OSERVICE__TLV_TAGS_LOGIN_COOKIE
| 0x06
| blob
| Login cookie returned by startOSCARSession
|-
| OSERVICE__TLV_TAGS_MAJOR_VERSION
| 0x17
| uint16 (word)
| Client major version: (1) if the client version is "1.2.3"
|-
| OSERVICE__TLV_TAGS_MINOR_VERSION
| 0x18
| uint16 (word)
| Client minor version: (2) if the client version is "1.2.3"
|-
| OSERVICE__TLV_TAGS_POINT_VERSION
| 0x19
| uint16 (word)
| Client minor version: (3) if the client version is "1.2.3"
|-
| OSERVICE__TLV_TAGS_BUILD_NUM
| 0x1A
| uint16 (word)
| Client build number, usually monotonically increasing
|-
| OSERVICE__TLV_TAGS_MULTICONN_LEVEL
| 0x4A
| uint8 (byte)
| ''[Class: [[Protocols/OSCAR/Sign_On#Class:_OSERVICE_MULTICONN_FLAGS|OSERVICE__MULTICONN_FLAGS]]]'' Should almost always be 0x01
|-
| OSERVICE__TLV_TAGS_CLIENT_RECONNECT
| 0x94
| uint8 (byte)
| Client claims it is reconnecting because it got knocked off
|}


=== Class: OSERVICE__MULTICONN_FLAGS ===
=== Class: OSERVICE__MULTICONN_FLAGS ===

Revision as of 21:10, 22 March 2020

OSCAR Protocol
IntroductionTermsClients
Basic
DatatypesFLAPSNACTLV
UUIDsErrorsTool IDs
Host Interaction
Rate LimitsMigrationMessages
Other Services
ADMINADVERTALERT
BARTBOSBUCPCHAT
CHAT_NAV
Tutorials
Sign OnBARTRendezvous
ICBMLocateBuddies
Foodgroups
OSERVICE (0x0001)
LOCATE (0x0002)
BUDDY (0x0003)
ICBM (0x0004)
ADVERT (0x0005)
INVITE (0x0006)
ADMIN (0x0007)
POPUP (0x0008)
PD (0x0009)
USER_LOOKUP (0x000A)
STATS (0x000B)
TRANSLATE (0x000C)
CHAT_NAV (0x000D)
CHAT (0x000E)
ODIR (0x000F)
BART (0x0010)
FEEDBAG (0x0013)
ICQ (0x0015)
BUCP (0x0017)
ALERT (0x0018)
PLUGIN (0x0022)
UNNAMED_FG_24 (0x0024)
MDIR (0x0025)
ARS (0x044A)


Connection overview

Connection Acknowledge

Authorization Request - notes from another

Authorization Successful Response - notes from another


Auth error notes from another


BOS Signon Request

TLV Class: FLAP__SIGNON_TAGS

These tags are used in the FLAP signon frame to BOS. They appear right after the 4 byte version number.

@MAKE NOTE: Difference between ones used if BUCP is in use and ones if clientLogin or w/e was used

Name Tag Type Notes
OSERVICE__TLV_TAGS_CLIENT_IDENTITY 0x03 string Yet another client name
OSERVICE__TLV_TAGS_LOGIN_COOKIE 0x06 blob Login cookie returned by startOSCARSession
OSERVICE__TLV_TAGS_MAJOR_VERSION 0x17 uint16 (word) Client major version: (1) if the client version is "1.2.3"
OSERVICE__TLV_TAGS_MINOR_VERSION 0x18 uint16 (word) Client minor version: (2) if the client version is "1.2.3"
OSERVICE__TLV_TAGS_POINT_VERSION 0x19 uint16 (word) Client minor version: (3) if the client version is "1.2.3"
OSERVICE__TLV_TAGS_BUILD_NUM 0x1A uint16 (word) Client build number, usually monotonically increasing
OSERVICE__TLV_TAGS_MULTICONN_LEVEL 0x4A uint8 (byte) [Class: OSERVICE__MULTICONN_FLAGS] Should almost always be 0x01
OSERVICE__TLV_TAGS_CLIENT_RECONNECT 0x94 uint8 (byte) Client claims it is reconnecting because it got knocked off

Class: OSERVICE__MULTICONN_FLAGS

These flags control how multiple instances are handled by the servers and if current sessions need to be bumped off when a new session signs on.

Name Value Notes
OSERVICE__MULTICONN_LEVEL_OLD_CLIENT 0x00 Don't use
OSERVICE__MULTICONN_LEVEL_MULTI 0x01 This is a recent client that understands multiple instances
OSERVICE__MULTICONN_LEVEL_SINGLE 0x03 This is a recent client that understands multiple instances but does not want them