| stunagent.h | | stunagent.h | |
| | | | |
| skipping to change at line 138 | | skipping to change at line 138 | |
| | | | |
| /** | | /** | |
| * StunAgentUsageFlags: | | * StunAgentUsageFlags: | |
| * @STUN_AGENT_USAGE_SHORT_TERM_CREDENTIALS: The agent should be using the
short | | * @STUN_AGENT_USAGE_SHORT_TERM_CREDENTIALS: The agent should be using the
short | |
| * term credentials mechanism for authenticating STUN messages | | * term credentials mechanism for authenticating STUN messages | |
| * @STUN_AGENT_USAGE_LONG_TERM_CREDENTIALS: The agent should be using the l
ong | | * @STUN_AGENT_USAGE_LONG_TERM_CREDENTIALS: The agent should be using the l
ong | |
| * term credentials mechanism for authenticating STUN messages | | * term credentials mechanism for authenticating STUN messages | |
| * @STUN_AGENT_USAGE_USE_FINGERPRINT: The agent should add the FINGERPRINT | | * @STUN_AGENT_USAGE_USE_FINGERPRINT: The agent should add the FINGERPRINT | |
| * attribute to the STUN messages it creates. | | * attribute to the STUN messages it creates. | |
| * @STUN_AGENT_USAGE_ADD_SOFTWARE: The agent should add the SOFTWARE attrib
ute | | * @STUN_AGENT_USAGE_ADD_SOFTWARE: The agent should add the SOFTWARE attrib
ute | |
|
| * to the STUN messages it creates | | * to the STUN messages it creates. Calling nice_agent_set_software() will | |
| | | have | |
| | | * the same effect as enabling this Usage. STUN Indications do not have the | |
| | | * SOFTWARE attributes added to them though. The SOFTWARE attribute is only | |
| | | * added for the RFC5389 and WLM2009 compatibility modes. | |
| * @STUN_AGENT_USAGE_IGNORE_CREDENTIALS: The agent should ignore any creden
tials | | * @STUN_AGENT_USAGE_IGNORE_CREDENTIALS: The agent should ignore any creden
tials | |
| * in the STUN messages it receives (the MESSAGE-INTEGRITY attribute | | * in the STUN messages it receives (the MESSAGE-INTEGRITY attribute | |
| * will never be validated by stun_agent_validate()) | | * will never be validated by stun_agent_validate()) | |
| * @STUN_AGENT_USAGE_NO_INDICATION_AUTH: The agent should ignore credential
s | | * @STUN_AGENT_USAGE_NO_INDICATION_AUTH: The agent should ignore credential
s | |
| * in the STUN messages it receives if the #StunClass of the message is | | * in the STUN messages it receives if the #StunClass of the message is | |
| * #STUN_INDICATION (some implementation require #STUN_INDICATION messages
to | | * #STUN_INDICATION (some implementation require #STUN_INDICATION messages
to | |
| * be authenticated, while others never add a MESSAGE-INTEGRITY attribute t
o a | | * be authenticated, while others never add a MESSAGE-INTEGRITY attribute t
o a | |
| * #STUN_INDICATION message) | | * #STUN_INDICATION message) | |
| * @STUN_AGENT_USAGE_FORCE_VALIDATER: The agent should always try to valida
te | | * @STUN_AGENT_USAGE_FORCE_VALIDATER: The agent should always try to valida
te | |
| * the password of a STUN message, even if it already knows what the passwo
rd | | * the password of a STUN message, even if it already knows what the passwo
rd | |
| | | | |
| skipping to change at line 183 | | skipping to change at line 186 | |
| uint8_t long_term_key[16]; | | uint8_t long_term_key[16]; | |
| bool long_term_valid; | | bool long_term_valid; | |
| bool valid; | | bool valid; | |
| } StunAgentSavedIds; | | } StunAgentSavedIds; | |
| | | | |
| struct stun_agent_t { | | struct stun_agent_t { | |
| StunCompatibility compatibility; | | StunCompatibility compatibility; | |
| StunAgentSavedIds sent_ids[STUN_AGENT_MAX_SAVED_IDS]; | | StunAgentSavedIds sent_ids[STUN_AGENT_MAX_SAVED_IDS]; | |
| uint16_t *known_attributes; | | uint16_t *known_attributes; | |
| StunAgentUsageFlags usage_flags; | | StunAgentUsageFlags usage_flags; | |
|
| | | const char *software_attribute; | |
| }; | | }; | |
| | | | |
| /** | | /** | |
| * StunDefaultValidaterData: | | * StunDefaultValidaterData: | |
| * @username: The username | | * @username: The username | |
| * @username_len: The length of the @username | | * @username_len: The length of the @username | |
| * @password: The password | | * @password: The password | |
| * @password_len: The length of the @password | | * @password_len: The length of the @password | |
| * | | * | |
| * This structure is used as an element of the user_data to the | | * This structure is used as an element of the user_data to the | |
| | | | |
| skipping to change at line 466 | | skipping to change at line 470 | |
| * created with stun_agent_finish_message() and for which no response was e
ver | | * created with stun_agent_finish_message() and for which no response was e
ver | |
| * received (timed out). The #StunAgent keeps a list of the sent transactio
ns | | * received (timed out). The #StunAgent keeps a list of the sent transactio
ns | |
| * in order to validate the responses received. If the response is never re
ceived | | * in order to validate the responses received. If the response is never re
ceived | |
| * this will allow the #StunAgent to forget about the timed out transaction
and | | * this will allow the #StunAgent to forget about the timed out transaction
and | |
| * free its slot for future transactions. | | * free its slot for future transactions. | |
| * </para> | | * </para> | |
| * Returns: %TRUE if the transaction was found, %FALSE otherwise | | * Returns: %TRUE if the transaction was found, %FALSE otherwise | |
| */ | | */ | |
| bool stun_agent_forget_transaction (StunAgent *agent, StunTransactionId id)
; | | bool stun_agent_forget_transaction (StunAgent *agent, StunTransactionId id)
; | |
| | | | |
|
| | | /** | |
| | | * stun_agent_set_software: | |
| | | * @agent: The #StunAgent | |
| | | * @software: The value of the SOFTWARE attribute to add. | |
| | | * | |
| | | * This function will set the value of the SOFTWARE attribute to be added t | |
| | | o | |
| | | * STUN requests, responses and error responses. | |
| | | * <para> | |
| | | * Calling this function will automatically enable the addition of the SOFT | |
| | | WARE | |
| | | * attribute for RFC5389 and WLM2009 compatibility modes. | |
| | | * </para> | |
| | | * <note> | |
| | | <para> | |
| | | The @software argument must be in UTF-8 encoding and only the first | |
| | | 128 characters will be sent. | |
| | | </para> | |
| | | <para> | |
| | | The value of the @software argument must stay valid throughout the l | |
| | | ife of | |
| | | the StunAgent's life. Do not free its content. | |
| | | </para> | |
| | | </note> | |
| | | * | |
| | | */ | |
| | | void stun_agent_set_software (StunAgent *agent, const char *software); | |
| | | | |
| #endif /* _STUN_AGENT_H */ | | #endif /* _STUN_AGENT_H */ | |
| | | | |
End of changes. 3 change blocks. |
| 1 lines changed or deleted | | 34 lines changed or added | |
|