NAME

       knet_handle_new_ex - create a new instance of a knet handle

SYNOPSIS

       #include <libknet.h>

       knet_handle_t knet_handle_new_ex(
           knet_node_id_t host_id,
           int            log_fd,
           uint8_t        default_log_level,
           uint64_t       flags
       );

DESCRIPTION

       knet_handle_new_ex

       host_id  -  Each host in a knet is identified with a unique ID. when creating a new handle
       local host_id must be specified (0 to  UINT16T_MAX  are  all  valid).  It  is  the  user's
       responsibility to check that the value is unique, or bad things might happen.

       log_fd  -  Write  file  descriptor.  If  set  to a value > 0, it will be used to write log
       packets from libknet to the application. Setting to 0 will disable logging  from  libknet.
       It  is possible to enable logging at any given time (see logging API). Make sure to either
       read from this filedescriptor properly and/or mark it  O_NONBLOCK,  otherwise  if  the  fd
       becomes full, libknet could block.

       default_log_level  -  If  logfd  is specified, it will initialize all subsystems to log at
       default_log_level value. (see logging API)

       flags - bitwise OR of  some  of  the  following  flags:  KNET_HANDLE_FLAG_PRIVILEGED:  use
       privileged  operations  setting  up  the  communication  sockets.  If disabled, failure to
       acquire large enough socket buffers is ignored but logged. Inadequate buffers lead to poor
       performance.

RETURN VALUE

       on  success,  a  new  knet_handle_t is returned. on failure, NULL is returned and errno is
       set. knet-specific errno values: ENAMETOOLONG - socket buffers couldn't be set big  enough
       and  KNET_HANDLE_FLAG_PRIVILEGED  was  specified  ERANGE  -  buffer size readback returned
       unexpected type

SEE ALSO

       knet_handle_remove_datafd(3), knet_handle_get_stats(3), knet_host_add(3),
       knet_handle_pmtud_setfreq(3), knet_handle_pmtud_get(3), knet_host_get_id_by_host_name(3),
       knet_host_get_status(3), knet_link_get_pong_count(3), knet_link_get_priority(3),
       knet_handle_free(3), knet_handle_enable_sock_notify(3), knet_handle_get_datafd(3),
       knet_recv(3), knet_link_get_ping_timers(3), knet_log_get_subsystem_id(3),
       knet_host_remove(3), knet_host_enable_status_change_notify(3), knet_strtoaddr(3),
       knet_send(3), knet_handle_enable_pmtud_notify(3),
       knet_handle_get_transport_reconnect_interval(3), knet_link_get_enable(3),
       knet_link_set_priority(3), knet_log_set_loglevel(3), knet_handle_get_channel(3),
       knet_link_get_config(3), knet_link_get_link_list(3), knet_get_transport_list(3),
       knet_get_transport_id_by_name(3), knet_log_get_loglevel_id(3), knet_host_set_name(3),
       knet_addrtostr(3), knet_handle_setfwd(3), knet_get_compress_list(3),
       knet_host_set_policy(3), knet_get_transport_name_by_id(3), knet_handle_enable_filter(3),
       knet_handle_compress(3), knet_link_get_status(3), knet_handle_add_datafd(3),
       knet_send_sync(3), knet_log_get_loglevel_name(3), knet_host_get_host_list(3),
       knet_host_get_policy(3), knet_link_set_enable(3), knet_link_set_pong_count(3),
       knet_log_get_subsystem_name(3), knet_host_get_name_by_host_id(3),
       knet_link_clear_config(3), knet_log_get_loglevel(3), knet_handle_new(3),
       knet_handle_pmtud_getfreq(3), knet_handle_clear_stats(3), knet_link_set_config(3),
       knet_handle_crypto(3), knet_get_crypto_list(3),
       knet_handle_set_transport_reconnect_interval(3), knet_link_set_ping_timers(3)

COPYRIGHT

       Copyright (C) 2010-2018 Red Hat, Inc. All rights reserved.