lib/network.h

   1 /*
   2  * Network library header.
   3  * Copyright (C) 1998 Kunihiro Ishiguro
   4  *
   5  * This file is part of GNU Zebra.
   6  *
   7  * GNU Zebra is free software; you can redistribute it and/or modify it
   8  * under the terms of the GNU General Public License as published by the
   9  * Free Software Foundation; either version 2, or (at your option) any
  10  * later version.
  11  *
  12  * GNU Zebra is distributed in the hope that it will be useful, but
  13  * WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along
  18  * with this program; see the file COPYING; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  20  */
  21
  22 #ifndef _ZEBRA_NETWORK_H
  23 #define _ZEBRA_NETWORK_H
  24
  25 #ifdef __cplusplus
  26 extern "C" {
  27 #endif
  28
  29 /* Both readn and writen are deprecated and will be removed.  They are not
  30    suitable for use with non-blocking file descriptors.
  31  */
  32 extern int readn(int, uint8_t *, int);
  33 extern int writen(int, const uint8_t *, int);
  34
  35 /* Set the file descriptor to use non-blocking I/O.  Returns 0 for success,
  36    -1 on error. */
  37 extern int set_nonblocking(int fd);
  38
  39 extern int set_cloexec(int fd);
  40
  41 /* Does the I/O error indicate that the operation should be retried later? */
  42 #define ERRNO_IO_RETRY(EN)                                                     \
  43         (((EN) == EAGAIN) || ((EN) == EWOULDBLOCK) || ((EN) == EINTR))
  44
  45 extern float htonf(float);
  46 extern float ntohf(float);
  47
  48 /**
  49  * Helper function that returns a random long value. The main purpose of
  50  * this function is to hide a `random()` call that gets flagged by coverity
  51  * scan and put it into one place.
  52  *
  53  * The main usage of this function should be for generating jitter or weak
  54  * random values for simple purposes.
  55  *
  56  * See 'man 3 random' for more information.
  57  *
  58  * \returns random long integer.
  59  */
  60 static inline long frr_weak_random(void)
  61 {
  62         /* coverity[dont_call] */
  63         return random();
  64 }
  65
  66 #ifdef __cplusplus
  67 }
  68 #endif
  69
  70 #endif /* _ZEBRA_NETWORK_H */