xref: /arm-trusted-firmware/include/lib/libc/endian.h (revision 91f16700b400a8c0651d24a598fc48ee2997a0d7)
1*91f16700Schasinglulu /*-
2*91f16700Schasinglulu  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3*91f16700Schasinglulu  *
4*91f16700Schasinglulu  * Copyright (c) 2002 Thomas Moestl <tmm@FreeBSD.org>
5*91f16700Schasinglulu  * All rights reserved.
6*91f16700Schasinglulu  *
7*91f16700Schasinglulu  * Redistribution and use in source and binary forms, with or without
8*91f16700Schasinglulu  * modification, are permitted provided that the following conditions
9*91f16700Schasinglulu  * are met:
10*91f16700Schasinglulu  * 1. Redistributions of source code must retain the above copyright
11*91f16700Schasinglulu  *    notice, this list of conditions and the following disclaimer.
12*91f16700Schasinglulu  * 2. Redistributions in binary form must reproduce the above copyright
13*91f16700Schasinglulu  *    notice, this list of conditions and the following disclaimer in the
14*91f16700Schasinglulu  *    documentation and/or other materials provided with the distribution.
15*91f16700Schasinglulu  *
16*91f16700Schasinglulu  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17*91f16700Schasinglulu  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18*91f16700Schasinglulu  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19*91f16700Schasinglulu  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20*91f16700Schasinglulu  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21*91f16700Schasinglulu  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22*91f16700Schasinglulu  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23*91f16700Schasinglulu  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24*91f16700Schasinglulu  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25*91f16700Schasinglulu  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26*91f16700Schasinglulu  * SUCH DAMAGE.
27*91f16700Schasinglulu  *
28*91f16700Schasinglulu  * $FreeBSD$
29*91f16700Schasinglulu  */
30*91f16700Schasinglulu /*
31*91f16700Schasinglulu  * Portions copyright (c) 2018, Arm Limited and Contributors.
32*91f16700Schasinglulu  * All rights reserved.
33*91f16700Schasinglulu  */
34*91f16700Schasinglulu 
35*91f16700Schasinglulu #ifndef ENDIAN_H
36*91f16700Schasinglulu #define ENDIAN_H
37*91f16700Schasinglulu 
38*91f16700Schasinglulu #include <cdefs.h>
39*91f16700Schasinglulu #include <stdint.h>
40*91f16700Schasinglulu #include <endian_.h>
41*91f16700Schasinglulu 
42*91f16700Schasinglulu /*
43*91f16700Schasinglulu  * General byte order swapping functions.
44*91f16700Schasinglulu  */
45*91f16700Schasinglulu #define	bswap16(x)	__bswap16(x)
46*91f16700Schasinglulu #define	bswap32(x)	__bswap32(x)
47*91f16700Schasinglulu #define	bswap64(x)	__bswap64(x)
48*91f16700Schasinglulu 
49*91f16700Schasinglulu /*
50*91f16700Schasinglulu  * Host to big endian, host to little endian, big endian to host, and little
51*91f16700Schasinglulu  * endian to host byte order functions as detailed in byteorder(9).
52*91f16700Schasinglulu  */
53*91f16700Schasinglulu #if _BYTE_ORDER == _LITTLE_ENDIAN
54*91f16700Schasinglulu #define	htobe16(x)	bswap16((x))
55*91f16700Schasinglulu #define	htobe32(x)	bswap32((x))
56*91f16700Schasinglulu #define	htobe64(x)	bswap64((x))
57*91f16700Schasinglulu #define	htole16(x)	((uint16_t)(x))
58*91f16700Schasinglulu #define	htole32(x)	((uint32_t)(x))
59*91f16700Schasinglulu #define	htole64(x)	((uint64_t)(x))
60*91f16700Schasinglulu 
61*91f16700Schasinglulu #define	be16toh(x)	bswap16((x))
62*91f16700Schasinglulu #define	be32toh(x)	bswap32((x))
63*91f16700Schasinglulu #define	be64toh(x)	bswap64((x))
64*91f16700Schasinglulu #define	le16toh(x)	((uint16_t)(x))
65*91f16700Schasinglulu #define	le32toh(x)	((uint32_t)(x))
66*91f16700Schasinglulu #define	le64toh(x)	((uint64_t)(x))
67*91f16700Schasinglulu #else /* _BYTE_ORDER != _LITTLE_ENDIAN */
68*91f16700Schasinglulu #define	htobe16(x)	((uint16_t)(x))
69*91f16700Schasinglulu #define	htobe32(x)	((uint32_t)(x))
70*91f16700Schasinglulu #define	htobe64(x)	((uint64_t)(x))
71*91f16700Schasinglulu #define	htole16(x)	bswap16((x))
72*91f16700Schasinglulu #define	htole32(x)	bswap32((x))
73*91f16700Schasinglulu #define	htole64(x)	bswap64((x))
74*91f16700Schasinglulu 
75*91f16700Schasinglulu #define	be16toh(x)	((uint16_t)(x))
76*91f16700Schasinglulu #define	be32toh(x)	((uint32_t)(x))
77*91f16700Schasinglulu #define	be64toh(x)	((uint64_t)(x))
78*91f16700Schasinglulu #define	le16toh(x)	bswap16((x))
79*91f16700Schasinglulu #define	le32toh(x)	bswap32((x))
80*91f16700Schasinglulu #define	le64toh(x)	bswap64((x))
81*91f16700Schasinglulu #endif /* _BYTE_ORDER == _LITTLE_ENDIAN */
82*91f16700Schasinglulu 
83*91f16700Schasinglulu /* Alignment-agnostic encode/decode bytestream to/from little/big endian. */
84*91f16700Schasinglulu 
85*91f16700Schasinglulu static __inline uint16_t
86*91f16700Schasinglulu be16dec(const void *pp)
87*91f16700Schasinglulu {
88*91f16700Schasinglulu 	uint8_t const *p = (uint8_t const *)pp;
89*91f16700Schasinglulu 
90*91f16700Schasinglulu 	return ((p[0] << 8) | p[1]);
91*91f16700Schasinglulu }
92*91f16700Schasinglulu 
93*91f16700Schasinglulu static __inline uint32_t
94*91f16700Schasinglulu be32dec(const void *pp)
95*91f16700Schasinglulu {
96*91f16700Schasinglulu 	uint8_t const *p = (uint8_t const *)pp;
97*91f16700Schasinglulu 
98*91f16700Schasinglulu 	return (((unsigned)p[0] << 24) | (p[1] << 16) | (p[2] << 8) | p[3]);
99*91f16700Schasinglulu }
100*91f16700Schasinglulu 
101*91f16700Schasinglulu static __inline uint64_t
102*91f16700Schasinglulu be64dec(const void *pp)
103*91f16700Schasinglulu {
104*91f16700Schasinglulu 	uint8_t const *p = (uint8_t const *)pp;
105*91f16700Schasinglulu 
106*91f16700Schasinglulu 	return (((uint64_t)be32dec(p) << 32) | be32dec(p + 4));
107*91f16700Schasinglulu }
108*91f16700Schasinglulu 
109*91f16700Schasinglulu static __inline uint16_t
110*91f16700Schasinglulu le16dec(const void *pp)
111*91f16700Schasinglulu {
112*91f16700Schasinglulu 	uint8_t const *p = (uint8_t const *)pp;
113*91f16700Schasinglulu 
114*91f16700Schasinglulu 	return ((p[1] << 8) | p[0]);
115*91f16700Schasinglulu }
116*91f16700Schasinglulu 
117*91f16700Schasinglulu static __inline uint32_t
118*91f16700Schasinglulu le32dec(const void *pp)
119*91f16700Schasinglulu {
120*91f16700Schasinglulu 	uint8_t const *p = (uint8_t const *)pp;
121*91f16700Schasinglulu 
122*91f16700Schasinglulu 	return (((unsigned)p[3] << 24) | (p[2] << 16) | (p[1] << 8) | p[0]);
123*91f16700Schasinglulu }
124*91f16700Schasinglulu 
125*91f16700Schasinglulu static __inline uint64_t
126*91f16700Schasinglulu le64dec(const void *pp)
127*91f16700Schasinglulu {
128*91f16700Schasinglulu 	uint8_t const *p = (uint8_t const *)pp;
129*91f16700Schasinglulu 
130*91f16700Schasinglulu 	return (((uint64_t)le32dec(p + 4) << 32) | le32dec(p));
131*91f16700Schasinglulu }
132*91f16700Schasinglulu 
133*91f16700Schasinglulu static __inline void
134*91f16700Schasinglulu be16enc(void *pp, uint16_t u)
135*91f16700Schasinglulu {
136*91f16700Schasinglulu 	uint8_t *p = (uint8_t *)pp;
137*91f16700Schasinglulu 
138*91f16700Schasinglulu 	p[0] = (u >> 8) & 0xff;
139*91f16700Schasinglulu 	p[1] = u & 0xff;
140*91f16700Schasinglulu }
141*91f16700Schasinglulu 
142*91f16700Schasinglulu static __inline void
143*91f16700Schasinglulu be32enc(void *pp, uint32_t u)
144*91f16700Schasinglulu {
145*91f16700Schasinglulu 	uint8_t *p = (uint8_t *)pp;
146*91f16700Schasinglulu 
147*91f16700Schasinglulu 	p[0] = (u >> 24) & 0xff;
148*91f16700Schasinglulu 	p[1] = (u >> 16) & 0xff;
149*91f16700Schasinglulu 	p[2] = (u >> 8) & 0xff;
150*91f16700Schasinglulu 	p[3] = u & 0xff;
151*91f16700Schasinglulu }
152*91f16700Schasinglulu 
153*91f16700Schasinglulu static __inline void
154*91f16700Schasinglulu be64enc(void *pp, uint64_t u)
155*91f16700Schasinglulu {
156*91f16700Schasinglulu 	uint8_t *p = (uint8_t *)pp;
157*91f16700Schasinglulu 
158*91f16700Schasinglulu 	be32enc(p, (uint32_t)(u >> 32));
159*91f16700Schasinglulu 	be32enc(p + 4, (uint32_t)(u & 0xffffffffU));
160*91f16700Schasinglulu }
161*91f16700Schasinglulu 
162*91f16700Schasinglulu static __inline void
163*91f16700Schasinglulu le16enc(void *pp, uint16_t u)
164*91f16700Schasinglulu {
165*91f16700Schasinglulu 	uint8_t *p = (uint8_t *)pp;
166*91f16700Schasinglulu 
167*91f16700Schasinglulu 	p[0] = u & 0xff;
168*91f16700Schasinglulu 	p[1] = (u >> 8) & 0xff;
169*91f16700Schasinglulu }
170*91f16700Schasinglulu 
171*91f16700Schasinglulu static __inline void
172*91f16700Schasinglulu le32enc(void *pp, uint32_t u)
173*91f16700Schasinglulu {
174*91f16700Schasinglulu 	uint8_t *p = (uint8_t *)pp;
175*91f16700Schasinglulu 
176*91f16700Schasinglulu 	p[0] = u & 0xff;
177*91f16700Schasinglulu 	p[1] = (u >> 8) & 0xff;
178*91f16700Schasinglulu 	p[2] = (u >> 16) & 0xff;
179*91f16700Schasinglulu 	p[3] = (u >> 24) & 0xff;
180*91f16700Schasinglulu }
181*91f16700Schasinglulu 
182*91f16700Schasinglulu static __inline void
183*91f16700Schasinglulu le64enc(void *pp, uint64_t u)
184*91f16700Schasinglulu {
185*91f16700Schasinglulu 	uint8_t *p = (uint8_t *)pp;
186*91f16700Schasinglulu 
187*91f16700Schasinglulu 	le32enc(p, (uint32_t)(u & 0xffffffffU));
188*91f16700Schasinglulu 	le32enc(p + 4, (uint32_t)(u >> 32));
189*91f16700Schasinglulu }
190*91f16700Schasinglulu 
191*91f16700Schasinglulu #endif /* ENDIAN_H */
192