.\" File automatically generated by doxy2man0.2
.\" Generation date: Thu Nov 23 2017
.TH knet_link_get_status 3 2017-11-23 "kronosnet" "Kronosnet Programmer's Manual"
.SH "NAME"
knet_link_get_status \- Get the status (and statistics) for a link.
.SH SYNOPSIS
.nf
.B #include <libknet.h>
.sp
\fBint knet_link_get_status\fP(
    \fBknet_handle_t             \fP\fIknet_h\fP,
    \fBknet_node_id_t            \fP\fIhost_id\fP,
    \fBuint8_t                   \fP\fIlink_id\fP,
    \fBstruct knet_link_status  *\fP\fIstatus\fP,
    \fBsize_t                    \fP\fIstruct_size\fP
);
.fi
.SH DESCRIPTION
.PP 
knet_link_get_status
.PP 
knet_h - pointer to knet_handle_t
.PP 
host_id - see knet_host_add(3)
.PP 
link_id - see knet_link_set_config(3)
.PP 
status - pointer to knet_link_status struct
.PP 
struct_size - max size of knet_link_status - allows library to add fields without ABI change. Returned structure will be truncated to this length and .size member indicates the full size.
.SH STRUCTURES
.SS ""
.PP
.sp
.sp
.RS
.nf
\fB
struct knet_link_status {
  size_t                 \fIsize\fP;
  char                   \fIsrc_ipaddr\fP;
  char                   \fIsrc_port\fP;
  char                   \fIdst_ipaddr\fP;
  char                   \fIdst_port\fP;
  uint8_t                \fIenabled\fP;
  uint8_t                \fIconnected\fP;
  uint8_t                \fIdynconnected\fP;
  unsigned long long     \fIlatency\fP;
  struct timespec        \fIpong_last\fP;
  unsigned int           \fImtu\fP;
  unsigned int           \fIproto_overhead\fP;
  struct knet_link_stats \fIstats\fP;
};
\fP
.fi
.RE
.SH RETURN VALUE
.PP
knet_link_get_status returns 0 on success -1 on error and errno is set. 
.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.