1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
/*
* Network library header.
* Copyright (C) 1998 Kunihiro Ishiguro
*
* This file is part of GNU Zebra.
*
* GNU Zebra is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the
* Free Software Foundation; either version 2, or (at your option) any
* later version.
*
* GNU Zebra is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; see the file COPYING; if not, write to the Free Software
* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef _ZEBRA_NETWORK_H
#define _ZEBRA_NETWORK_H
#ifdef HAVE_SYS_ENDIAN_H
#include <sys/endian.h>
#endif
#ifdef HAVE_ENDIAN_H
#include <endian.h>
#endif
#ifdef __cplusplus
extern "C" {
#endif
/* Both readn and writen are deprecated and will be removed. They are not
suitable for use with non-blocking file descriptors.
*/
extern int readn(int, uint8_t *, int);
extern int writen(int, const uint8_t *, int);
/* Set the file descriptor to use non-blocking I/O. Returns 0 for success,
-1 on error. */
extern int set_nonblocking(int fd);
extern int set_cloexec(int fd);
/* Does the I/O error indicate that the operation should be retried later? */
#define ERRNO_IO_RETRY(EN) \
(((EN) == EAGAIN) || ((EN) == EWOULDBLOCK) || ((EN) == EINTR))
extern float htonf(float);
extern float ntohf(float);
/* force type for be64toh/htobe64 to be uint64_t, *without* a direct cast
*
* this is a workaround for false-positive printfrr warnings from FRR's
* frr-format GCC plugin that would be triggered from
* { printfrr("%"PRIu64, (uint64_t)be64toh(...)); }
*
* the key element here is that "(uint64_t)expr" causes the warning, while
* "({ uint64_t x = expr; x; })" does not. (The cast is the trigger, a
* variable of the same type works correctly.)
*/
/* zap system definitions... */
#ifdef be64toh
#undef be64toh
#endif
#ifdef htobe64
#undef htobe64
#endif
#if BYTE_ORDER == LITTLE_ENDIAN
#define be64toh(x) ({ uint64_t r = __builtin_bswap64(x); r; })
#define htobe64(x) ({ uint64_t r = __builtin_bswap64(x); r; })
#elif BYTE_ORDER == BIG_ENDIAN
#define be64toh(x) ({ uint64_t r = (x); r; })
#define htobe64(x) ({ uint64_t r = (x); r; })
#else
#error nobody expects the endianish inquisition. check OS endian.h headers.
#endif
/**
* Generate a sequence number using monotonic clock with a same second call
* protection to help guarantee a unique incremental sequence number that never
* goes back (except when wrapping/overflow).
*
* **NOTE** this function is not thread safe since it uses `static` variable.
*
* This function and `frr_sequence32_next` should be used to initialize
* sequence numbers without directly calling other `time_t` returning
* functions because of `time_t` truncation warnings.
*
* \returns `uint64_t` number based on the monotonic clock.
*/
extern uint64_t frr_sequence_next(void);
/** Same as `frr_sequence_next` but returns truncated number. */
extern uint32_t frr_sequence32_next(void);
/**
* Helper function that returns a random long value. The main purpose of
* this function is to hide a `random()` call that gets flagged by coverity
* scan and put it into one place.
*
* The main usage of this function should be for generating jitter or weak
* random values for simple purposes.
*
* See 'man 3 random' for more information.
*
* \returns random long integer.
*/
static inline long frr_weak_random(void)
{
/* coverity[dont_call] */
return random();
}
#ifdef __cplusplus
}
#endif
#endif /* _ZEBRA_NETWORK_H */
|
