summaryrefslogtreecommitdiff
path: root/toxcore/tox.h
AgeCommit message (Collapse)Author
2016-08-22Make Friend User Status statelessGregory Mullen (grayhatter)
2016-08-20Make the friend message callback statelessGregory Mullen (grayhatter)
2016-08-19Make Typing change callback statelessGregory Mullen (grayhatter)
Moved a few #defines to the top of the header for better readability
2016-08-18Make friend_status_message callback stateless.iphydf
See #40 for details.
2016-08-18Make tox_callback_friend_name stateless.iphydf
See #27 and #40 for details.
2016-08-17Make self_connection_status callback stateless.iphydf
**What are we doing?** We are moving towards stateless callbacks. This means that when registering a callback, you no longer pass a user data pointer. Instead, you pass a user data pointer to tox_iterate. This pointer is threaded through the code, passed to each callback. The callback can modify the data pointed at. An extra indirection will be needed if the pointer itself can change. **Why?** Currently, callbacks are registered with a user data pointer. This means the library has N pointers for N different callbacks. These pointers need to be managed by the client code. Managing the lifetime of the pointee can be difficult. In C++, it takes special effort to ensure that the lifetime of user data extends at least beyond the lifetime of the Tox instance. For other languages, the situation is much worse. Java and other garbage collected languages may move objects in memory, so the pointers are not stable. Tox4j goes through a lot of effort to make the Java/Scala user experience a pleasant one by keeping a global array of Tox+userdata on the C++ side, and communicating via protobufs. A Haskell FFI would have to do similarly complex tricks. Stateless callbacks ensure that a user data pointer only needs to live during a single function call. This means that the user code (or language runtime) can move the data around at will, as long as it sets the new location in the callback. **How?** We are doing this change one callback at a time. After each callback, we ensure that everything still works as expected. This means the toxcore change will require 15 Pull Requests.
2015-07-07Fix a couple API doc mistakesJfreegman
2015-06-20Merge branch 'doc' of https://github.com/zetok/ProjectTox-Coreirungentoo
2015-06-20Add real instruction on how to use APIDSL and astyleZetok Zalbavar
also add to "tox{,.in}.h" note that "tox.h" shouldn't be edited directly, pointing to "tox.in.h"
2015-06-20Improve documentation about tcp_portZetok Zalbavar
Apparently it's not entirely clear that it's not needed in clients. v2, as provided by @nurupo
2015-06-03Return error if file_id parameter is NULL.irungentoo
2015-05-29Comment fix.irungentoo
2015-05-28Fixed comment.irungentoo
2015-05-25tox_new returns NULL on failure.irungentoo
2015-05-22Move savedata to options struct.irungentoo
Add a way to select the type of savedata (normal savedata, load a secret key, potentially others?) to load.
2015-05-08Added basic TCP server hosting to tox.h api.irungentoo
TODO: tell friends we are hosting a relay and prioritize using relays hosted by friends over bootstrap ones.
2015-04-25Switched tox.h to the dsl generated one.irungentoo
Added input file to generate it. Moved the astyle stuff to the astyle directory in other/.
2015-04-17Fixed some tox.h comments.irungentoo
2015-04-09tox_hash fix.irungentoo
2015-04-02API function to get last seen timestamp of friendJfreegman
also removed remnants of the no longer used variable ping_lastrecv
2015-03-31Amend comments to reflect undefined filenumber and friendnumber behaviorJfreegman
2015-03-29Merge branch 'tox_friend_delete_additinal_documantation' of ↵irungentoo
https://github.com/Raffinate/toxcore
2015-03-29Additional description for tox_friend_delete.Aleksey Mokhovikov
2015-03-27Comment fix.irungentoo
2015-03-26Making tox_encrypted_new() use the same error codes as tox_new was a bad idea.irungentoo
They now have their own error codes.
2015-03-24Comment fix.irungentoo
2015-03-23tox.h comment fix.irungentoo
2015-03-22Fixes #1298Anurag Agarwal
2015-03-22Fixes #1297Anurag Agarwal
2015-03-22Fixes #1296Anurag Agarwal
2015-03-21Renamed tox_file_send_control to tox_file_control.irungentoo
Renamed tox_file_send_seek to tox_file_seek.
2015-03-21Transfers with filelength == 0 now behave exactly like transfers of everyirungentoo
other size (except streaming of course).
2015-03-20Allow sending of file transfer requests with length 0 but don't allocateirungentoo
any file number for them in core. These can be used to tell friends we don't have an avatar set or to unset a set avatar.
2015-03-20For file transfers UINT64_MAX is now used as the size for streamingirungentoo
transfers instead of 0. For avatar transfers file size 0 now means that the client has no avatar set. Added a test for streaming transfers.
2015-03-19callback_file_request_chunk -> callback_file_chunk_requestDubslow
A couple of minor reasons, combined warrant a PR imo: a) fileChunkRequested is a better signal name than fileRequestChunkReceived, and I don't want to break consistency by reordering words for just this signal b) "request chunk" is parsed by English speakers as a verb-object combination, implying sending the request, not receiving, whereas "chunk requested" is parsed (more correctly) as an adjective-noun combo (in particular, request is a noun not a verb), and thus reads far more like "hey heads up we just got a request" For instance some tests/testing code had some callbacks to *receive* chunk requests, and they were called "tox_file_request_chunk"... to receive a chunk, not request it. Now they're called "tox_file_chunk_request". So yeah...
2015-03-18Renamed TOX_MESSAGE_TYPE_MESSAGE to TOX_MESSAGE_TYPE_NORMAL.irungentoo
2015-03-18Merge branch 'one_more_rename' of https://github.com/dubslow/toxcore into ↵irungentoo
new_api
2015-03-18Removed TOX_USER_STATUS_INVALID.irungentoo
2015-03-18Merged normal message function and send action function into oneirungentoo
messaging function. This removes code duplication and allows us to easily add new message types to the api without having to add new functions.
2015-03-18Move get_connection_status to self pseudonamespace, to contrast ↵Dubslow
friend_get_connection_status
2015-03-18When friend goes offline all his file transfers get removed.irungentoo
This is now documented in the API. Ported programs in testing/ to this behaviour.
2015-03-18Api changes.irungentoo
receive to recv in file receive functions. Added TOX_MAX_FILENAME_LENGTH define.
2015-03-17Renamed SEND_FAILED to SENDQ.irungentoo
2015-03-17Save function renamed to tox_get_savedata()irungentoo
2015-03-17Changed INVALID_LENGTH to TOO_LONG.irungentoo
2015-03-17Added tox_file_send_seek() function to api.irungentoo
This function can be used to seek an incoming file tranfer right before accepting it. It is meant to be used to resume incomplete file tranfers by clients.
2015-03-17Allow file names to be of length 0.irungentoo
Pointer in callback will be NULL if length is 0.
2015-03-17Added and implemented file_id parameter to file tranfers.irungentoo
file_id is a 32byte identifier that can be used by users to identify file tranfers across core/client restarts in order to resume broken file tranfers. In avatar tranfers it corresponds to the hash of the avatar. Added tox_file_get_file_id() function to api to obtain the file_id of an ongoing file transfer. If not set, core will generate a random one.
2015-03-16New API fixups.iphydf
2015-03-15Avatar hash is now the filename of the file transfer instead of theirungentoo
first 32 bytes. Enforce length of filename in core when transfer is an avatar type transfer to make things more safe.