Protocols/OSCAR/SNAC/BUCP ERR

From NINA Wiki
Jump to navigation Jump to search
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)
ID Origin Name Foodgroup Service Status Version
0x0017, 0x0001 Any BUCP__ERR BUCP BUCP Active 1.15

This is the error SNAC for the BUCP foodgroup.

SNAC Header

Foodgroup uint16 (word) 00 17
Subgroup uint16 (word) 00 01
Flags uint16 (word) 00 00
Request ID uint32 (dword) xx xx xx xx

SNAC Data

Error code is required, however the TLV chain is optional depending on the error code and/or other information the user needs to be provided.

Name Length Value Note
Code uint16 (word) xx xx [Class: ERROR__CODE]
TLV blob xx .. [Class: ERROR__TAGS]

From Aleksandr Shutko: SNAC(17,01) BUCP__ERR


Server replies with this SNAC to SNAC(17,04) - client registration request. This snac mean that registration failed for some reason.

 00 17   word   SNAC family
 00 01   word   SNAC subtype
 00 00   word   SNAC flags
 xx xx xx xx   dword   SNAC request-id
 xx xx   word   error code (see list)
 00 21   word   TLV.Type(0x21)
 xx xx   word   TLV.Length
 00 00 00 00   dword   just zeros
 00 00   word   just zeros
 xx xx xx xx   dword   registration cookie from SNAC(17,04)
 xx xx xx xx   dword   client tcp port
 xx xx xx xx   dword   client ip address
 xx xx xx xx   dword   registration cookie from SNAC(17,04)
 40 04 64 F8   dword   unknown value


Example SNAC dump with flap header:


  2A 02 38 C7 00 2E 00 17  00 01 00 00 00 00 00 00  *.8..... ........
  00 05 00 21 00 1E 00 00  00 00 00 00 00 00 39 12  ...!.... ......9.
  00 00 04 92 08 0A 0A 0A  00 00 00 04 00 00 00 04  ........ ........
  40 04 64 F8					    @.d.


BUCP SNACs

SNAC List
Subgroup Origin Name
0x0001 Any BUCP__ERR
This is the error SNAC for the BUCP foodgroup.
0x0002 Client BUCP__LOGIN_REQUEST
Client login request.
0x0003 Host BUCP__LOGIN_RESPONSE
Host login response, will contain reconnect information with login cookie or an error code and/or URL.
0x0004 Client BUCP__REGISTER_REQUEST
Client registration for legacy ICQ clients.
0x0005 Host BUCP__REGISTER_RESPONSE
Host response to BUCP__REGISTER_REQUEST. May contain confirmation of registration or an error code and/or URL.
0x0006 Client BUCP__CHALLENGE_REQUEST
Request challenge for login request.
0x0007 Host BUCP__CHALLENGE_RESPONSE
Response to BUCP__CHALLENGE_REQUEST with challenge.
0x0008 Client BUCP__ASASN_REQUEST
AOL Suggest A Screenname Request, suggests screennames based on other parameters.
0x0009 Host BUCP__ASASN_RESPONSE
Response to BUCP__ASASN_REQUEST with a list of suggestions
0x000A Host BUCP__SECURID_REQUEST
Host SecurID request for client to continue logging in.
0x000B Client BUCP__SECURID_RESPONSE
Client response to BUCP__SECURID_RESPONSE with SecurID code.
0x000C Client BUCP__REGISTRATION_IMAGE_REQUEST
Request registration image, or CAPTCHA
0x000D Host BUCP__REGISTRATION_IMAGE_REPLY
Response to BUCP__REGISTRATION_IMAGE_REQUEST containing image information