|
libcoap
4.2.1
|
Defines the application visible session information. More...
#include "coap_forward_decls.h"#include "coap_io.h"#include "coap_time.h"#include "pdu.h"#include "uthash.h"
Include dependency graph for coap_session.h:
This graph shows which files directly or indirectly include this file:Go to the source code of this file.
Data Structures | |
| struct | coap_fixed_point_t |
| Abstraction of a fixed point number that can be used where necessary instead of a float. More... | |
| struct | coap_session_t |
Macros | |
| #define | COAP_DEFAULT_SESSION_TIMEOUT 300 |
| #define | COAP_PARTIAL_SESSION_TIMEOUT_TICKS (30 * COAP_TICKS_PER_SECOND) |
| #define | COAP_DEFAULT_MAX_HANDSHAKE_SESSIONS 100 |
| #define | COAP_PROTO_NOT_RELIABLE(p) ((p)==COAP_PROTO_UDP || (p)==COAP_PROTO_DTLS) |
| #define | COAP_PROTO_RELIABLE(p) ((p)==COAP_PROTO_TCP || (p)==COAP_PROTO_TLS) |
| #define | COAP_SESSION_TYPE_CLIENT 1 |
| coap_session_type_t values More... | |
| #define | COAP_SESSION_TYPE_SERVER 2 |
| server-side More... | |
| #define | COAP_SESSION_TYPE_HELLO 3 |
| server-side ephemeral session for responding to a client hello More... | |
| #define | COAP_SESSION_STATE_NONE 0 |
| coap_session_state_t values More... | |
| #define | COAP_SESSION_STATE_CONNECTING 1 |
| #define | COAP_SESSION_STATE_HANDSHAKE 2 |
| #define | COAP_SESSION_STATE_CSM 3 |
| #define | COAP_SESSION_STATE_ESTABLISHED 4 |
| #define | COAP_DEFAULT_ACK_TIMEOUT ((coap_fixed_point_t){2,0}) |
| Number of seconds when to expect an ACK or a response to an outstanding CON message. More... | |
| #define | COAP_DEFAULT_ACK_RANDOM_FACTOR ((coap_fixed_point_t){1,500}) |
| A factor that is used to randomize the wait time before a message is retransmitted to prevent synchronization effects. More... | |
| #define | COAP_DEFAULT_MAX_RETRANSMIT 4 |
| Number of message retransmissions before message sending is stopped RFC 7252, Section 4.8 Default value of MAX_RETRANSMIT is 4. More... | |
| #define | COAP_DEFAULT_NSTART 1 |
| The number of simultaneous outstanding interactions that a client maintains to a given server. More... | |
| #define | SESSIONS_ADD(e, obj) HASH_ADD(hh, (e), addr_info, sizeof((obj)->addr_info), (obj)) |
| #define | SESSIONS_DELETE(e, obj) HASH_DELETE(hh, (e), (obj)) |
| #define | SESSIONS_ITER(e, el, rtmp) HASH_ITER(hh, (e), el, rtmp) |
| #define | SESSIONS_ITER_SAFE(e, el, rtmp) for ((el) = (e); (el) && ((rtmp) = (el)->hh.next, 1); (el) = (rtmp)) |
| #define | SESSIONS_FIND(e, k, res) |
Typedefs | |
| typedef struct coap_fixed_point_t | coap_fixed_point_t |
| Abstraction of a fixed point number that can be used where necessary instead of a float. More... | |
| typedef uint8_t | coap_session_type_t |
| typedef uint8_t | coap_session_state_t |
| typedef struct coap_session_t | coap_session_t |
Functions | |
| coap_session_t * | coap_session_reference (coap_session_t *session) |
| Increment reference counter on a session. More... | |
| void | coap_session_release (coap_session_t *session) |
| Decrement reference counter on a session. More... | |
| void | coap_session_set_app_data (coap_session_t *session, void *data) |
Stores data with the given session. More... | |
| void * | coap_session_get_app_data (const coap_session_t *session) |
Returns any application-specific data that has been stored with session using the function coap_session_set_app_data(). More... | |
| void | coap_session_disconnected (coap_session_t *session, coap_nack_reason_t reason) |
| Notify session that it has failed. More... | |
| void | coap_session_send_csm (coap_session_t *session) |
| Notify session transport has just connected and CSM exchange can now start. More... | |
| void | coap_session_connected (coap_session_t *session) |
| Notify session that it has just connected or reconnected. More... | |
| void | coap_session_set_mtu (coap_session_t *session, unsigned mtu) |
| Set the session MTU. More... | |
| size_t | coap_session_max_pdu_size (const coap_session_t *session) |
| Get maximum acceptable PDU size. More... | |
| coap_session_t * | coap_new_client_session (struct coap_context_t *ctx, const coap_address_t *local_if, const coap_address_t *server, coap_proto_t proto) |
| Creates a new client session to the designated server. More... | |
| coap_session_t * | coap_new_client_session_psk (struct coap_context_t *ctx, const coap_address_t *local_if, const coap_address_t *server, coap_proto_t proto, const char *identity, const uint8_t *key, unsigned key_len) |
| Creates a new client session to the designated server with PSK credentials. More... | |
| coap_session_t * | coap_new_client_session_pki (struct coap_context_t *ctx, const coap_address_t *local_if, const coap_address_t *server, coap_proto_t proto, struct coap_dtls_pki_t *setup_data) |
| Creates a new client session to the designated server with PKI credentials. More... | |
| coap_session_t * | coap_new_server_session (struct coap_context_t *ctx, struct coap_endpoint_t *ep) |
| Creates a new server session for the specified endpoint. More... | |
| ssize_t | coap_session_send (coap_session_t *session, const uint8_t *data, size_t datalen) |
| Function interface for datagram data transmission. More... | |
| ssize_t | coap_session_write (coap_session_t *session, const uint8_t *data, size_t datalen) |
| Function interface for stream data transmission. More... | |
| ssize_t | coap_session_send_pdu (coap_session_t *session, coap_pdu_t *pdu) |
| Send a pdu according to the session's protocol. More... | |
| const char * | coap_session_str (const coap_session_t *session) |
| Get session description. More... | |
| ssize_t | coap_session_delay_pdu (coap_session_t *session, coap_pdu_t *pdu, struct coap_queue_t *node) |
| coap_endpoint_t * | coap_new_endpoint (struct coap_context_t *context, const coap_address_t *listen_addr, coap_proto_t proto) |
| Create a new endpoint for communicating with peers. More... | |
| void | coap_endpoint_set_default_mtu (coap_endpoint_t *endpoint, unsigned mtu) |
| Set the endpoint's default MTU. More... | |
| void | coap_free_endpoint (coap_endpoint_t *ep) |
| const char * | coap_endpoint_str (const coap_endpoint_t *endpoint) |
| Get endpoint description. More... | |
| coap_session_t * | coap_endpoint_get_session (coap_endpoint_t *endpoint, const struct coap_packet_t *packet, coap_tick_t now) |
| Lookup the server session for the packet received on an endpoint, or create a new one. More... | |
| coap_session_t * | coap_session_new_dtls_session (coap_session_t *session, coap_tick_t now) |
Create a new DTLS session for the session. More... | |
| coap_session_t * | coap_session_get_by_peer (struct coap_context_t *ctx, const struct coap_address_t *remote_addr, int ifindex) |
| void | coap_session_free (coap_session_t *session) |
| void | coap_session_mfree (coap_session_t *session) |
| void | coap_session_set_max_retransmit (coap_session_t *session, unsigned int value) |
| Set the CoAP maximum retransmit count before failure. More... | |
| void | coap_session_set_ack_timeout (coap_session_t *session, coap_fixed_point_t value) |
| Set the CoAP initial ack response timeout before the next re-transmit. More... | |
| void | coap_session_set_ack_random_factor (coap_session_t *session, coap_fixed_point_t value) |
| Set the CoAP ack randomize factor. More... | |
| unsigned int | coap_session_get_max_transmit (coap_session_t *session) |
| Get the CoAP maximum retransmit before failure. More... | |
| coap_fixed_point_t | coap_session_get_ack_timeout (coap_session_t *session) |
| Get the CoAP initial ack response timeout before the next re-transmit. More... | |
| coap_fixed_point_t | coap_session_get_ack_random_factor (coap_session_t *session) |
| Get the CoAP ack randomize factor. More... | |
| coap_tid_t | coap_session_send_ping (coap_session_t *session) |
| Send a ping message for the session. More... | |
Defines the application visible session information.
Definition in file coap_session.h.
| #define COAP_DEFAULT_MAX_HANDSHAKE_SESSIONS 100 |
Definition at line 36 of file coap_session.h.
| #define COAP_DEFAULT_SESSION_TIMEOUT 300 |
Definition at line 34 of file coap_session.h.
| #define COAP_PARTIAL_SESSION_TIMEOUT_TICKS (30 * COAP_TICKS_PER_SECOND) |
Definition at line 35 of file coap_session.h.
| #define COAP_PROTO_NOT_RELIABLE | ( | p | ) | ((p)==COAP_PROTO_UDP || (p)==COAP_PROTO_DTLS) |
Definition at line 38 of file coap_session.h.
| #define COAP_PROTO_RELIABLE | ( | p | ) | ((p)==COAP_PROTO_TCP || (p)==COAP_PROTO_TLS) |
Definition at line 39 of file coap_session.h.
| #define COAP_SESSION_STATE_CONNECTING 1 |
Definition at line 54 of file coap_session.h.
| #define COAP_SESSION_STATE_CSM 3 |
Definition at line 56 of file coap_session.h.
| #define COAP_SESSION_STATE_ESTABLISHED 4 |
Definition at line 57 of file coap_session.h.
| #define COAP_SESSION_STATE_HANDSHAKE 2 |
Definition at line 55 of file coap_session.h.
| #define COAP_SESSION_STATE_NONE 0 |
coap_session_state_t values
Definition at line 53 of file coap_session.h.
| #define COAP_SESSION_TYPE_CLIENT 1 |
| #define COAP_SESSION_TYPE_HELLO 3 |
server-side ephemeral session for responding to a client hello
Definition at line 47 of file coap_session.h.
| #define COAP_SESSION_TYPE_SERVER 2 |
server-side
Definition at line 46 of file coap_session.h.
| #define SESSIONS_ADD | ( | e, | |
| obj | |||
| ) | HASH_ADD(hh, (e), addr_info, sizeof((obj)->addr_info), (obj)) |
Definition at line 480 of file coap_session.h.
| #define SESSIONS_DELETE | ( | e, | |
| obj | |||
| ) | HASH_DELETE(hh, (e), (obj)) |
Definition at line 483 of file coap_session.h.
| #define SESSIONS_FIND | ( | e, | |
| k, | |||
| res | |||
| ) |
Definition at line 492 of file coap_session.h.
| #define SESSIONS_ITER | ( | e, | |
| el, | |||
| rtmp | |||
| ) | HASH_ITER(hh, (e), el, rtmp) |
Definition at line 486 of file coap_session.h.
| #define SESSIONS_ITER_SAFE | ( | e, | |
| el, | |||
| rtmp | |||
| ) | for ((el) = (e); (el) && ((rtmp) = (el)->hh.next, 1); (el) = (rtmp)) |
Definition at line 489 of file coap_session.h.
| typedef struct coap_fixed_point_t coap_fixed_point_t |
Abstraction of a fixed point number that can be used where necessary instead of a float.
1,000 fractional bits equals one integer
| typedef uint8_t coap_session_state_t |
Definition at line 49 of file coap_session.h.
| typedef struct coap_session_t coap_session_t |
| typedef uint8_t coap_session_type_t |
Definition at line 41 of file coap_session.h.
| coap_session_t* coap_endpoint_get_session | ( | coap_endpoint_t * | endpoint, |
| const struct coap_packet_t * | packet, | ||
| coap_tick_t | now | ||
| ) |
Lookup the server session for the packet received on an endpoint, or create a new one.
| endpoint | Active endpoint the packet was received on. |
| packet | Received packet. |
| now | The current time in ticks. |
NULL if error. | void coap_endpoint_set_default_mtu | ( | coap_endpoint_t * | endpoint, |
| unsigned | mtu | ||
| ) |
Set the endpoint's default MTU.
This is the maximum message size that can be sent, excluding IP and UDP overhead.
| endpoint | The CoAP endpoint. |
| mtu | maximum message size |
Definition at line 1001 of file coap_session.c.
| void coap_free_endpoint | ( | coap_endpoint_t * | ep | ) |
Definition at line 1006 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| coap_session_t* coap_new_client_session | ( | struct coap_context_t * | ctx, |
| const coap_address_t * | local_if, | ||
| const coap_address_t * | server, | ||
| coap_proto_t | proto | ||
| ) |
Creates a new client session to the designated server.
| ctx | The CoAP context. |
| local_if | Address of local interface. It is recommended to use NULL to let the operating system choose a suitable local interface. If an address is specified, the port number should be zero, which means that a free port is automatically selected. |
| server | The server's address. If the port number is zero, the default port for the protocol will be used. |
| proto | Protocol. |
Definition at line 766 of file coap_session.c.
Here is the call graph for this function:| coap_session_t* coap_new_client_session_pki | ( | struct coap_context_t * | ctx, |
| const coap_address_t * | local_if, | ||
| const coap_address_t * | server, | ||
| coap_proto_t | proto, | ||
| struct coap_dtls_pki_t * | setup_data | ||
| ) |
Creates a new client session to the designated server with PKI credentials.
| ctx | The CoAP context. |
| local_if | Address of local interface. It is recommended to use NULL to let the operating system choose a suitable local interface. If an address is specified, the port number should be zero, which means that a free port is automatically selected. |
| server | The server's address. If the port number is zero, the default port for the protocol will be used. |
| proto | CoAP Protocol. |
| setup_data | PKI parameters. |
Definition at line 841 of file coap_session.c.
Here is the call graph for this function:| coap_session_t* coap_new_client_session_psk | ( | struct coap_context_t * | ctx, |
| const coap_address_t * | local_if, | ||
| const coap_address_t * | server, | ||
| coap_proto_t | proto, | ||
| const char * | identity, | ||
| const uint8_t * | key, | ||
| unsigned | key_len | ||
| ) |
Creates a new client session to the designated server with PSK credentials.
| ctx | The CoAP context. |
| local_if | Address of local interface. It is recommended to use NULL to let the operating system choose a suitable local interface. If an address is specified, the port number should be zero, which means that a free port is automatically selected. |
| server | The server's address. If the port number is zero, the default port for the protocol will be used. |
| proto | Protocol. |
| identity | PSK client identity |
| key | PSK shared key |
| key_len | PSK shared key length |
Definition at line 781 of file coap_session.c.
Here is the call graph for this function:| coap_endpoint_t* coap_new_endpoint | ( | struct coap_context_t * | context, |
| const coap_address_t * | listen_addr, | ||
| coap_proto_t | proto | ||
| ) |
Create a new endpoint for communicating with peers.
| context | The coap context that will own the new endpoint |
| listen_addr | Address the endpoint will listen for incoming requests on or originate outgoing requests from. Use NULL to specify that no incoming request will be accepted and use a random endpoint. |
| proto | Protocol used on this endpoint |
Definition at line 918 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| coap_session_t* coap_new_server_session | ( | struct coap_context_t * | ctx, |
| struct coap_endpoint_t * | ep | ||
| ) |
Creates a new server session for the specified endpoint.
| ctx | The CoAP context. |
| ep | An endpoint where an incoming connection request is pending. |
Definition at line 881 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| void coap_session_connected | ( | coap_session_t * | session | ) |
Notify session that it has just connected or reconnected.
| session | The CoAP session. |
Definition at line 330 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| ssize_t coap_session_delay_pdu | ( | coap_session_t * | session, |
| coap_pdu_t * | pdu, | ||
| struct coap_queue_t * | node | ||
| ) |
Definition at line 251 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| void coap_session_disconnected | ( | coap_session_t * | session, |
| coap_nack_reason_t | reason | ||
| ) |
Notify session that it has failed.
| session | The CoAP session. |
| reason | The reason why the session was disconnected. |
Definition at line 387 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| void coap_session_free | ( | coap_session_t * | session | ) |
Definition at line 168 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| coap_fixed_point_t coap_session_get_ack_random_factor | ( | coap_session_t * | session | ) |
Get the CoAP ack randomize factor.
A factor that is used to randomize the wait time before a message is retransmitted to prevent synchronization effects.
| session | The CoAP session. |
Definition at line 63 of file coap_session.c.
| coap_fixed_point_t coap_session_get_ack_timeout | ( | coap_session_t * | session | ) |
Get the CoAP initial ack response timeout before the next re-transmit.
Number of seconds when to expect an ACK or a response to an outstanding CON message.
| session | The CoAP session. |
Definition at line 58 of file coap_session.c.
| void* coap_session_get_app_data | ( | const coap_session_t * | session | ) |
Returns any application-specific data that has been stored with session using the function coap_session_set_app_data().
This function will return NULL if no data has been stored.
Definition at line 91 of file coap_session.c.
| coap_session_t* coap_session_get_by_peer | ( | struct coap_context_t * | ctx, |
| const struct coap_address_t * | remote_addr, | ||
| int | ifindex | ||
| ) |
| unsigned int coap_session_get_max_transmit | ( | coap_session_t * | session | ) |
Get the CoAP maximum retransmit before failure.
Number of message retransmissions before message sending is stopped
| session | The CoAP session. |
Definition at line 53 of file coap_session.c.
| size_t coap_session_max_pdu_size | ( | const coap_session_t * | session | ) |
Get maximum acceptable PDU size.
| session | The CoAP session. |
Definition at line 187 of file coap_session.c.
Here is the caller graph for this function:| void coap_session_mfree | ( | coap_session_t * | session | ) |
Definition at line 145 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| coap_session_t* coap_session_reference | ( | coap_session_t * | session | ) |
Increment reference counter on a session.
| session | The CoAP session. |
Definition at line 68 of file coap_session.c.
Here is the caller graph for this function:| void coap_session_release | ( | coap_session_t * | session | ) |
Decrement reference counter on a session.
Note that the session may be deleted as a result and should not be used after this call.
| session | The CoAP session. |
Definition at line 74 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| ssize_t coap_session_send | ( | coap_session_t * | session, |
| const uint8_t * | data, | ||
| size_t | datalen | ||
| ) |
Function interface for datagram data transmission.
This function returns the number of bytes that have been transmitted, or a value less than zero on error.
| session | Session to send data on. |
| data | The data to send. |
| datalen | The actual length of data. |
Definition at line 216 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| void coap_session_send_csm | ( | coap_session_t * | session | ) |
Notify session transport has just connected and CSM exchange can now start.
| session | The CoAP session. |
Definition at line 288 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| ssize_t coap_session_send_pdu | ( | coap_session_t * | session, |
| coap_pdu_t * | pdu | ||
| ) |
Send a pdu according to the session's protocol.
This function returns the number of bytes that have been transmitted, or a value less than zero on error.
| session | Session to send pdu on. |
| pdu | The pdu to send. |
Definition at line 683 of file net.c.
Here is the call graph for this function:
Here is the caller graph for this function:| coap_tid_t coap_session_send_ping | ( | coap_session_t * | session | ) |
Send a ping message for the session.
| session | The CoAP session. |
Definition at line 314 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function:| void coap_session_set_ack_random_factor | ( | coap_session_t * | session, |
| coap_fixed_point_t | value | ||
| ) |
Set the CoAP ack randomize factor.
A factor that is used to randomize the wait time before a message is retransmitted to prevent synchronization effects.
| session | The CoAP session. |
| value | The value to set to. The default is 1.5 and should not normally get changed. |
Definition at line 42 of file coap_session.c.
Here is the call graph for this function:| void coap_session_set_ack_timeout | ( | coap_session_t * | session, |
| coap_fixed_point_t | value | ||
| ) |
Set the CoAP initial ack response timeout before the next re-transmit.
Number of seconds when to expect an ACK or a response to an outstanding CON message.
| session | The CoAP session. |
| value | The value to set to. The default is 2 and should not normally get changed. |
Definition at line 32 of file coap_session.c.
Here is the call graph for this function:| void coap_session_set_app_data | ( | coap_session_t * | session, |
| void * | data | ||
| ) |
Stores data with the given session.
This function overwrites any value that has previously been stored with session.
Definition at line 85 of file coap_session.c.
| void coap_session_set_max_retransmit | ( | coap_session_t * | session, |
| unsigned int | value | ||
| ) |
Set the CoAP maximum retransmit count before failure.
Number of message retransmissions before message sending is stopped
| session | The CoAP session. |
| value | The value to set to. The default is 4 and should not normally get changed. |
Definition at line 23 of file coap_session.c.
Here is the call graph for this function:| void coap_session_set_mtu | ( | coap_session_t * | session, |
| unsigned | mtu | ||
| ) |
Set the session MTU.
This is the maximum message size that can be sent, excluding IP and UDP overhead.
| session | The CoAP session. |
| mtu | maximum message size |
Definition at line 204 of file coap_session.c.
Here is the caller graph for this function:| ssize_t coap_session_write | ( | coap_session_t * | session, |
| const uint8_t * | data, | ||
| size_t | datalen | ||
| ) |
Function interface for stream data transmission.
This function returns the number of bytes that have been transmitted, or a value less than zero on error. The number of bytes written may be less than datalen because of congestion control.
| session | Session to send data on. |
| data | The data to send. |
| datalen | The actual length of data. |
Definition at line 237 of file coap_session.c.
Here is the call graph for this function:
Here is the caller graph for this function: