Protocols/OSCAR/Foodgroups/FEEDBAG
(Redirected from Protocols/OSCAR/SNAC 13)
| OSCAR Protocol |
| Introduction • Terms • Clients |
| Basic |
| Datatypes • FLAP • SNAC • TLV |
| UUIDs • Errors • Tool IDs |
| Host Interaction |
| Rate Limits • Migration • Messages |
| Other Services |
| ADMIN • ADVERT • ALERT |
| BART • BOS • BUCP • CHAT |
| CHAT_NAV |
| Tutorials |
| Sign On • BART • Rendezvous |
| ICBM • Locate • Buddies |
| 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 | Name | Service | Status | Version |
|---|---|---|---|---|
| 0x0013 | FEEDBAG | BOS | Active | 4.0 |
A Feedbag is the stored Buddy List and server based preferences for an AIM user. The client has direct access to manipulate the Feedbag in any way it sees fit, including corrupting it. The server has some checks in place to prevent destruction, but a client developer must be careful not to corrupt things.
Items
Feedbag store items are highly complex and have been separated into their own page.
SNACs
| Subgroup | Origin | Name |
|---|---|---|
| 0x0001 | Any | FEEDBAG__ERR |
| This is the error SNAC for the FEEDBAG foodgroup. | ||
| 0x0002 | Client | FEEDBAG__RIGHTS_QUERY |
| This SNAC issues a query to the host for the client's Feedbag rights and to let the system know what kind of Feedbag support it wants. | ||
| 0x0003 | Host | FEEDBAG__RIGHTS_REPLY |
| This is the response to the FEEDBAG__RIGHTS_QUERY SNAC. | ||
| 0x0004 | Client | FEEDBAG__QUERY |
| This SNAC is sent to query the Feedbag data stored on the host. | ||
| 0x0005 | Client | FEEDBAG__QUERY_IF_MODIFIED |
| Similar to FEEDBAG__QUERY except contains a Unix epoch to check against in order to only send if modified. | ||
| 0x0006 | Host | FEEDBAG__REPLY |
| This is the reply to FEEDBAG_QUERY. | ||
| 0x0007 | Client | FEEDBAG__USE |
| Directs the host to use the specified stored Feedbag information. | ||
| 0x0008 | Any | FEEDBAG__INSERT_ITEM |
| When this SNAC is sent to the host, the client is requesting that one or more new items are added to the Feedbag. | ||
| 0x0009 | Any | FEEDBAG__UPDATE_ITEM |
| When this SNAC is sent to the host, the client is requesting to update one or more items. | ||
| 0x000A | Any | FEEDBAG__DELETE_ITEM |
| When this SNAC is sent to the host, the client is requesting that one or more items be deleted from the Feedbag. | ||
| 0x000B | NCD | FEEDBAG__INSERT_CLASS |
| This is not currently documented. | ||
| 0x000C | NCD | FEEDBAG__UPDATE_CLASS |
| This is not currently documented. | ||
| 0x000D | NCD | FEEDBAG__DELETE_CLASS |
| This is not currently documented. | ||
| 0x000E | Host | FEEDBAG__STATUS |
| These are the results of one of the insert/update/delete item SNACs from above. | ||
| 0x000F | Host | FEEDBAG__REPLY_NOT_MODIFIED |
| Response to client if Feedbag data is unmodified. | ||
| 0x0010 | NCD | FEEDBAG__DELETE_USER |
| This is not currently documented. | ||
| 0x0011 | NCD | FEEDBAG__START_CLUSTER |
| The cluster SNACs bracket a set of transactions that should be handled by clients as a group to avoid "flashing" the user's screen. | ||
| 0x0012 | NCD | FEEDBAG__END_CLUSTER |
| This SNAC ends the data burst started with START_CLUSTER. See FEEDBAG__START_CLUSTER. | ||
| 0x0013 | Client | FEEDBAG__AUTHORIZE_BUDDY |
| Grant authorization to another user. | ||
| 0x0014 | Client | FEEDBAG__PRE_AUTHORIZE_BUDDY |
| Pre-authorize another user. | ||
| 0x0015 | Host | FEEDBAG__PRE_AUTHORIZED_BUDDY |
| Host notification to a user that they have been pre-authorized. | ||
| 0x0016 | Client | FEEDBAG__REMOVE_ME |
| Delete current user from another user's Buddy List. | ||
| 0x0017 | Client | FEEDBAG__REMOVE_ME2 |
| This is not currently documented. | ||
| 0x0018 | Client | FEEDBAG__REQUEST_AUTHORIZE_TO_HOST |
| Send authorization request. | ||
| 0x0019 | Host | FEEDBAG__REQUEST_AUTHORIZE_TO_CLIENT |
| Host notice of authorization request from another user. | ||
| 0x001A | Client | FEEDBAG__RESPOND_AUTHORIZE_TO_HOST |
| Send authorization response to FEEDBAG__REQUEST_AUTHORIZE_TO_CLIENT. | ||
| 0x001B | Host | FEEDBAG__RESPOND_AUTHORIZE_TO_CLIENT |
| Host notice of grant or denial of authorization. | ||
| 0x001C | Host | FEEDBAG__BUDDY_ADDED |
| Host notice that another user has added current user to their Buddy List. | ||
| 0x001D | NCD | FEEDBAG__REQUEST_AUTHORIZE_TO_BADOG |
| This is not currently documented. | ||
| 0x001E | NCD | FEEDBAG__RESPOND_AUTHORIZE_TO_BADOG |
| This is not currently documented. | ||
| 0x001F | NCD | FEEDBAG__BUDDY_ADDED_TO_BADOG |
| This is not currently documented. | ||
| 0x0021 | Any | FEEDBAG__TEST_SNAC |
| This is not currently documented. | ||
| 0x0022 | NCD | FEEDBAG__FORWARD_MSG |
| This is not currently documented. | ||
| 0x0023 | NCD | FEEDBAG__IS_AUTH_REQUIRED_QUERY |
| This is not currently documented. | ||
| 0x0024 | NCD | FEEDBAG__IS_AUTH_REQUIRED_REPLY |
| This is not currently documented. | ||
| 0x0025 | NCD | FEEDBAG__RECENT_BUDDY_UPDATE |
| This is not currently documented. | ||