Protocols/OSCAR/SNAC/ADMIN INFO CHANGE REPLY

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
0x0007, 0x0005 Host ADMIN__INFO_CHANGE_REPLY Unspecified ADMIN Active 1.9

This is the response for ADMIN__INFO_CHANGE_REQUEST and may either confirm changes or contain an error code and/or URL.

SNAC Header

Foodgroup uint16 (word) 00 07
Subgroup uint16 (word) 00 05
Flags uint16 (word) 00 00
Request ID uint32 (dword) 00 00 00 00

SNAC Data

Unconfirmed: This SNAC contains no data

@NOTE: May contain one of these TLVs (need to clarify, make context and conditions more obvious): Protocols/OSCAR/Foodgroups/ADMIN#Info_TLVs

From Aleksandr Shutko: SNAC(07,05) ADMIN__INFO_CHANGE_REPLY


This is the client account info change reply. It also may contain error code / error url instead if request failed. Known error codes may be found in SNAC(07,03) description.

 00 07   word   SNAC family
 00 03   word   SNAC subtype
 00 00   word   SNAC flags
 xx xx xx xx   dword   SNAC request-id
 

Following structure may be repeated more then once

 xx xx   word   permissions flags (1 - r/o, 2 - r/o, 3 - r/w)
 xx xx   word   number of following TLVs
 00 01   word   TLV.Type(0x01) - user screenname
 xx xx   word   TLV.Length
 xx ..   string   user formated screenname
 00 11   word   TLV.Type(0x11) - user email
 xx xx   word   TLV.Length
 xx ..   string   user email string
 00 13   word   TLV.Type(0x13) - registration status
 xx xx   word   TLV.Length
 xx xx   word   registration status (1 - no disclosure, 2 - limit disclosure, 3 - full disclosure)

 00 08   word   TLV.Type(0x08) - error code
 xx xx   word   TLV.Length
 xx xx   word   error code (request failed)
 00 04   word   TLV.Type(0x04) - error url
 xx xx   word   TLV.Length
 xx ..   string   error description url


Example SNAC dumps with flap header:


  2A 02 3D 1C 00 1F 00 07 00 05 00 00 00 01 00 04  *.=.............
  00 03 00 01 00 01 00 0D 52 45 41 4C 52 65 67 72  ........REALRegr
  65 73 73 6F 72                                   essor



ADMIN SNACs

SNAC List
Subgroup Origin Name
0x0001 Any ADMIN__ERR
This is the error SNAC for the ADMIN foodgroup.
0x0002 Client ADMIN__INFO_QUERY
Request account information. Host should reply with ADMIN__INFO_REPLY.
0x0003 Host ADMIN__INFO_REPLY
Reply to ADMIN__INFO_QUERY, may contain either account information or an error code and/or URL on failure.
0x0004 Client ADMIN__INFO_CHANGE_REQUEST
Change information request. Information may include screenname format, password, email address, and so on. Host will reply with ADMIN__INFO_CHANGE_REPLY.
0x0005 Host ADMIN__INFO_CHANGE_REPLY
This is the response for ADMIN__INFO_CHANGE_REQUEST and may either confirm changes or contain an error code and/or URL.
0x0006 Client ADMIN__ACCT_CONFIRM_REQUEST
Request to confirm account via email.
0x0007 Host ADMIN__ACCT_CONFIRM_REPLY
Response to ADMIN__ACCT_CONFIRM_REQUEST, may contain status change, pending email confirmation notice, or error message.
0x0008 Client ADMIN__ACCT_DELETE_REQUEST
Account delete request. Host will reply with ADMIN__ACCT_DELETE_REPLY.
0x0009 Host ADMIN__ACCT_DELETE_REPLY
The account delete reply will either contain confirmation or an error code and/or URL.