.\" File automatically generated by doxy2man0.2
.\" Generation date: Thu Nov 23 2017
.TH knet_send_sync 3 2017-11-23 "kronosnet" "Kronosnet Programmer's Manual"
.SH "NAME"
knet_send_sync \- Synchronously send data to knet nodes.
.SH SYNOPSIS
.nf
.B #include <libknet.h>
.sp
\fBint knet_send_sync\fP(
    \fBknet_handle_t \fP\fIknet_h\fP,
    \fBconst char   *\fP\fIbuff\fP,
    \fBconst size_t  \fP\fIbuff_len\fP,
    \fBconst int8_t  \fP\fIchannel\fP
);
.fi
.SH DESCRIPTION
.PP 
knet_send_sync
.PP 
knet_h - pointer to knet_handle_t
.PP 
buff - pointer to the buffer of data to send
.PP 
buff_len - length of data to send
.PP 
channel - data channel to use (see knet_handle_add_datafd(3))
.PP 
All knet RX/TX operations are async for performance reasons. There are applications that might need a sync version of data transmission and receive errors in case of failure to deliver to another host. knet_send_sync bypasses the whole TX async layer and delivers data directly to the link layer, and returns errors accordingly. knet_send_sync allows to send only one packet to one host at a time. It does NOT support multiple destinations or multicast packets. Decision is still based on dst_host_filter_fn.
.SH RETURN VALUE
.PP
knet_send_sync returns 0 on success and -1 on error. In addition to normal sendmmsg errors, knet_send_sync can fail due to:
.TP
.B ECANCELED
- data forward is disabled 

.TP
.B EFAULT
- dst_host_filter fatal error 

.TP
.B EINVAL
- dst_host_filter did not provide dst_host_ids_entries on unicast pckts 

.TP
.B E2BIG
- dst_host_filter did return more than one dst_host_ids_entries on unicast pckts 

.TP
.B ENOMSG
- received unknown message type 

.TP
.B EHOSTDOWN
- unicast pckt cannot be delivered because dest host is not connected yet 

.TP
.B ECHILD
- crypto failed 

.TP
.B EAGAIN
- sendmmsg was unable to send all messages and there was no progress during retry 

.SH SEE ALSO
.PP
.nh
.ad l
\fIlibknet.h\fP(3), \fIknet_addrtostr\fP(3), \fIknet_get_compress_list\fP(3), \fIknet_get_crypto_list\fP(3), \fIknet_get_transport_id_by_name\fP(3), \fIknet_get_transport_list\fP(3), \fIknet_get_transport_name_by_id\fP(3), \fIknet_handle_add_datafd\fP(3), \fIknet_handle_clear_stats\fP(3), \fIknet_handle_compress\fP(3), \fIknet_handle_crypto\fP(3), \fIknet_handle_enable_filter\fP(3), \fIknet_handle_enable_pmtud_notify\fP(3), \fIknet_handle_enable_sock_notify\fP(3), \fIknet_handle_free\fP(3), \fIknet_handle_get_channel\fP(3), \fIknet_handle_get_datafd\fP(3), \fIknet_handle_get_stats\fP(3), \fIknet_handle_get_transport_reconnect_interval\fP(3), \fIknet_handle_new\fP(3), \fIknet_handle_pmtud_get\fP(3), \fIknet_handle_pmtud_getfreq\fP(3), \fIknet_handle_pmtud_setfreq\fP(3), \fIknet_handle_remove_datafd\fP(3), \fIknet_handle_set_transport_reconnect_interval\fP(3), \fIknet_handle_setfwd\fP(3), \fIknet_host_add\fP(3), \fIknet_host_enable_status_change_notify\fP(3), \fIknet_host_get_host_list\fP(3), \fIknet_host_get_id_by_host_name\fP(3), \fIknet_host_get_name_by_host_id\fP(3), \fIknet_host_get_policy\fP(3), \fIknet_host_get_status\fP(3), \fIknet_host_remove\fP(3), \fIknet_host_set_name\fP(3), \fIknet_host_set_policy\fP(3), \fIknet_link_clear_config\fP(3), \fIknet_link_get_config\fP(3), \fIknet_link_get_enable\fP(3), \fIknet_link_get_link_list\fP(3), \fIknet_link_get_ping_timers\fP(3), \fIknet_link_get_pong_count\fP(3), \fIknet_link_get_priority\fP(3), \fIknet_link_get_status\fP(3), \fIknet_link_set_config\fP(3), \fIknet_link_set_enable\fP(3), \fIknet_link_set_ping_timers\fP(3), \fIknet_link_set_pong_count\fP(3), \fIknet_link_set_priority\fP(3), \fIknet_log_get_loglevel\fP(3), \fIknet_log_get_loglevel_id\fP(3), \fIknet_log_get_loglevel_name\fP(3), \fIknet_log_get_subsystem_id\fP(3), \fIknet_log_get_subsystem_name\fP(3), \fIknet_log_set_loglevel\fP(3), \fIknet_recv\fP(3), \fIknet_send\fP(3), \fIknet_send_sync\fP(3), \fIknet_strtoaddr\fP(3)
.ad
.hy
.SH COPYRIGHT
.PP
Copyright (C) 2010-2017 Red Hat, Inc. All rights reserved.