xref: /linux/lib/crc32.c (revision f7af616c632ee2ac3af0876fe33bf9e0232e665a)
1 /*
2  * Aug 8, 2011 Bob Pearson with help from Joakim Tjernlund and George Spelvin
3  * cleaned up code to current version of sparse and added the slicing-by-8
4  * algorithm to the closely similar existing slicing-by-4 algorithm.
5  *
6  * Oct 15, 2000 Matt Domsch <Matt_Domsch@dell.com>
7  * Nicer crc32 functions/docs submitted by linux@horizon.com.  Thanks!
8  * Code was from the public domain, copyright abandoned.  Code was
9  * subsequently included in the kernel, thus was re-licensed under the
10  * GNU GPL v2.
11  *
12  * Oct 12, 2000 Matt Domsch <Matt_Domsch@dell.com>
13  * Same crc32 function was used in 5 other places in the kernel.
14  * I made one version, and deleted the others.
15  * There are various incantations of crc32().  Some use a seed of 0 or ~0.
16  * Some xor at the end with ~0.  The generic crc32() function takes
17  * seed as an argument, and doesn't xor at the end.  Then individual
18  * users can do whatever they need.
19  *   drivers/net/smc9194.c uses seed ~0, doesn't xor with ~0.
20  *   fs/jffs2 uses seed 0, doesn't xor with ~0.
21  *   fs/partitions/efi.c uses seed ~0, xor's with ~0.
22  *
23  * This source code is licensed under the GNU General Public License,
24  * Version 2.  See the file COPYING for more details.
25  */
26 
27 /* see: Documentation/staging/crc32.rst for a description of algorithms */
28 
29 #include <linux/crc32.h>
30 #include <linux/crc32poly.h>
31 #include <linux/module.h>
32 #include <linux/types.h>
33 #include <linux/sched.h>
34 #include "crc32defs.h"
35 
36 #if CRC_LE_BITS > 8
37 # define tole(x) ((__force u32) cpu_to_le32(x))
38 #else
39 # define tole(x) (x)
40 #endif
41 
42 #if CRC_BE_BITS > 8
43 # define tobe(x) ((__force u32) cpu_to_be32(x))
44 #else
45 # define tobe(x) (x)
46 #endif
47 
48 #include "crc32table.h"
49 
50 MODULE_AUTHOR("Matt Domsch <Matt_Domsch@dell.com>");
51 MODULE_DESCRIPTION("Various CRC32 calculations");
52 MODULE_LICENSE("GPL");
53 
54 #if CRC_LE_BITS > 8 || CRC_BE_BITS > 8
55 
56 /* implements slicing-by-4 or slicing-by-8 algorithm */
57 static inline u32 __pure
58 crc32_body(u32 crc, unsigned char const *buf, size_t len, const u32 (*tab)[256])
59 {
60 # ifdef __LITTLE_ENDIAN
61 #  define DO_CRC(x) crc = t0[(crc ^ (x)) & 255] ^ (crc >> 8)
62 #  define DO_CRC4 (t3[(q) & 255] ^ t2[(q >> 8) & 255] ^ \
63 		   t1[(q >> 16) & 255] ^ t0[(q >> 24) & 255])
64 #  define DO_CRC8 (t7[(q) & 255] ^ t6[(q >> 8) & 255] ^ \
65 		   t5[(q >> 16) & 255] ^ t4[(q >> 24) & 255])
66 # else
67 #  define DO_CRC(x) crc = t0[((crc >> 24) ^ (x)) & 255] ^ (crc << 8)
68 #  define DO_CRC4 (t0[(q) & 255] ^ t1[(q >> 8) & 255] ^ \
69 		   t2[(q >> 16) & 255] ^ t3[(q >> 24) & 255])
70 #  define DO_CRC8 (t4[(q) & 255] ^ t5[(q >> 8) & 255] ^ \
71 		   t6[(q >> 16) & 255] ^ t7[(q >> 24) & 255])
72 # endif
73 	const u32 *b;
74 	size_t    rem_len;
75 # ifdef CONFIG_X86
76 	size_t i;
77 # endif
78 	const u32 *t0=tab[0], *t1=tab[1], *t2=tab[2], *t3=tab[3];
79 # if CRC_LE_BITS != 32
80 	const u32 *t4 = tab[4], *t5 = tab[5], *t6 = tab[6], *t7 = tab[7];
81 # endif
82 	u32 q;
83 
84 	/* Align it */
85 	if (unlikely((long)buf & 3 && len)) {
86 		do {
87 			DO_CRC(*buf++);
88 		} while ((--len) && ((long)buf)&3);
89 	}
90 
91 # if CRC_LE_BITS == 32
92 	rem_len = len & 3;
93 	len = len >> 2;
94 # else
95 	rem_len = len & 7;
96 	len = len >> 3;
97 # endif
98 
99 	b = (const u32 *)buf;
100 # ifdef CONFIG_X86
101 	--b;
102 	for (i = 0; i < len; i++) {
103 # else
104 	for (--b; len; --len) {
105 # endif
106 		q = crc ^ *++b; /* use pre increment for speed */
107 # if CRC_LE_BITS == 32
108 		crc = DO_CRC4;
109 # else
110 		crc = DO_CRC8;
111 		q = *++b;
112 		crc ^= DO_CRC4;
113 # endif
114 	}
115 	len = rem_len;
116 	/* And the last few bytes */
117 	if (len) {
118 		u8 *p = (u8 *)(b + 1) - 1;
119 # ifdef CONFIG_X86
120 		for (i = 0; i < len; i++)
121 			DO_CRC(*++p); /* use pre increment for speed */
122 # else
123 		do {
124 			DO_CRC(*++p); /* use pre increment for speed */
125 		} while (--len);
126 # endif
127 	}
128 	return crc;
129 #undef DO_CRC
130 #undef DO_CRC4
131 #undef DO_CRC8
132 }
133 #endif
134 
135 
136 /**
137  * crc32_le_generic() - Calculate bitwise little-endian Ethernet AUTODIN II
138  *			CRC32/CRC32C
139  * @crc: seed value for computation.  ~0 for Ethernet, sometimes 0 for other
140  *	 uses, or the previous crc32/crc32c value if computing incrementally.
141  * @p: pointer to buffer over which CRC32/CRC32C is run
142  * @len: length of buffer @p
143  * @tab: little-endian Ethernet table
144  * @polynomial: CRC32/CRC32c LE polynomial
145  */
146 static inline u32 __pure crc32_le_generic(u32 crc, unsigned char const *p,
147 					  size_t len, const u32 (*tab)[256],
148 					  u32 polynomial)
149 {
150 #if CRC_LE_BITS == 1
151 	int i;
152 	while (len--) {
153 		crc ^= *p++;
154 		for (i = 0; i < 8; i++)
155 			crc = (crc >> 1) ^ ((crc & 1) ? polynomial : 0);
156 	}
157 # elif CRC_LE_BITS == 2
158 	while (len--) {
159 		crc ^= *p++;
160 		crc = (crc >> 2) ^ tab[0][crc & 3];
161 		crc = (crc >> 2) ^ tab[0][crc & 3];
162 		crc = (crc >> 2) ^ tab[0][crc & 3];
163 		crc = (crc >> 2) ^ tab[0][crc & 3];
164 	}
165 # elif CRC_LE_BITS == 4
166 	while (len--) {
167 		crc ^= *p++;
168 		crc = (crc >> 4) ^ tab[0][crc & 15];
169 		crc = (crc >> 4) ^ tab[0][crc & 15];
170 	}
171 # elif CRC_LE_BITS == 8
172 	/* aka Sarwate algorithm */
173 	while (len--) {
174 		crc ^= *p++;
175 		crc = (crc >> 8) ^ tab[0][crc & 255];
176 	}
177 # else
178 	crc = (__force u32) __cpu_to_le32(crc);
179 	crc = crc32_body(crc, p, len, tab);
180 	crc = __le32_to_cpu((__force __le32)crc);
181 #endif
182 	return crc;
183 }
184 
185 #if CRC_LE_BITS == 1
186 u32 __pure __weak crc32_le(u32 crc, unsigned char const *p, size_t len)
187 {
188 	return crc32_le_generic(crc, p, len, NULL, CRC32_POLY_LE);
189 }
190 u32 __pure __weak __crc32c_le(u32 crc, unsigned char const *p, size_t len)
191 {
192 	return crc32_le_generic(crc, p, len, NULL, CRC32C_POLY_LE);
193 }
194 #else
195 u32 __pure __weak crc32_le(u32 crc, unsigned char const *p, size_t len)
196 {
197 	return crc32_le_generic(crc, p, len,
198 			(const u32 (*)[256])crc32table_le, CRC32_POLY_LE);
199 }
200 u32 __pure __weak __crc32c_le(u32 crc, unsigned char const *p, size_t len)
201 {
202 	return crc32_le_generic(crc, p, len,
203 			(const u32 (*)[256])crc32ctable_le, CRC32C_POLY_LE);
204 }
205 #endif
206 EXPORT_SYMBOL(crc32_le);
207 EXPORT_SYMBOL(__crc32c_le);
208 
209 u32 __pure crc32_le_base(u32, unsigned char const *, size_t) __alias(crc32_le);
210 u32 __pure __crc32c_le_base(u32, unsigned char const *, size_t) __alias(__crc32c_le);
211 
212 /*
213  * This multiplies the polynomials x and y modulo the given modulus.
214  * This follows the "little-endian" CRC convention that the lsbit
215  * represents the highest power of x, and the msbit represents x^0.
216  */
217 static u32 __attribute_const__ gf2_multiply(u32 x, u32 y, u32 modulus)
218 {
219 	u32 product = x & 1 ? y : 0;
220 	int i;
221 
222 	for (i = 0; i < 31; i++) {
223 		product = (product >> 1) ^ (product & 1 ? modulus : 0);
224 		x >>= 1;
225 		product ^= x & 1 ? y : 0;
226 	}
227 
228 	return product;
229 }
230 
231 /**
232  * crc32_generic_shift - Append @len 0 bytes to crc, in logarithmic time
233  * @crc: The original little-endian CRC (i.e. lsbit is x^31 coefficient)
234  * @len: The number of bytes. @crc is multiplied by x^(8*@len)
235  * @polynomial: The modulus used to reduce the result to 32 bits.
236  *
237  * It's possible to parallelize CRC computations by computing a CRC
238  * over separate ranges of a buffer, then summing them.
239  * This shifts the given CRC by 8*len bits (i.e. produces the same effect
240  * as appending len bytes of zero to the data), in time proportional
241  * to log(len).
242  */
243 static u32 __attribute_const__ crc32_generic_shift(u32 crc, size_t len,
244 						   u32 polynomial)
245 {
246 	u32 power = polynomial;	/* CRC of x^32 */
247 	int i;
248 
249 	/* Shift up to 32 bits in the simple linear way */
250 	for (i = 0; i < 8 * (int)(len & 3); i++)
251 		crc = (crc >> 1) ^ (crc & 1 ? polynomial : 0);
252 
253 	len >>= 2;
254 	if (!len)
255 		return crc;
256 
257 	for (;;) {
258 		/* "power" is x^(2^i), modulo the polynomial */
259 		if (len & 1)
260 			crc = gf2_multiply(crc, power, polynomial);
261 
262 		len >>= 1;
263 		if (!len)
264 			break;
265 
266 		/* Square power, advancing to x^(2^(i+1)) */
267 		power = gf2_multiply(power, power, polynomial);
268 	}
269 
270 	return crc;
271 }
272 
273 u32 __attribute_const__ crc32_le_shift(u32 crc, size_t len)
274 {
275 	return crc32_generic_shift(crc, len, CRC32_POLY_LE);
276 }
277 
278 u32 __attribute_const__ __crc32c_le_shift(u32 crc, size_t len)
279 {
280 	return crc32_generic_shift(crc, len, CRC32C_POLY_LE);
281 }
282 EXPORT_SYMBOL(crc32_le_shift);
283 EXPORT_SYMBOL(__crc32c_le_shift);
284 
285 /**
286  * crc32_be_generic() - Calculate bitwise big-endian Ethernet AUTODIN II CRC32
287  * @crc: seed value for computation.  ~0 for Ethernet, sometimes 0 for
288  *	other uses, or the previous crc32 value if computing incrementally.
289  * @p: pointer to buffer over which CRC32 is run
290  * @len: length of buffer @p
291  * @tab: big-endian Ethernet table
292  * @polynomial: CRC32 BE polynomial
293  */
294 static inline u32 __pure crc32_be_generic(u32 crc, unsigned char const *p,
295 					  size_t len, const u32 (*tab)[256],
296 					  u32 polynomial)
297 {
298 #if CRC_BE_BITS == 1
299 	int i;
300 	while (len--) {
301 		crc ^= *p++ << 24;
302 		for (i = 0; i < 8; i++)
303 			crc =
304 			    (crc << 1) ^ ((crc & 0x80000000) ? polynomial :
305 					  0);
306 	}
307 # elif CRC_BE_BITS == 2
308 	while (len--) {
309 		crc ^= *p++ << 24;
310 		crc = (crc << 2) ^ tab[0][crc >> 30];
311 		crc = (crc << 2) ^ tab[0][crc >> 30];
312 		crc = (crc << 2) ^ tab[0][crc >> 30];
313 		crc = (crc << 2) ^ tab[0][crc >> 30];
314 	}
315 # elif CRC_BE_BITS == 4
316 	while (len--) {
317 		crc ^= *p++ << 24;
318 		crc = (crc << 4) ^ tab[0][crc >> 28];
319 		crc = (crc << 4) ^ tab[0][crc >> 28];
320 	}
321 # elif CRC_BE_BITS == 8
322 	while (len--) {
323 		crc ^= *p++ << 24;
324 		crc = (crc << 8) ^ tab[0][crc >> 24];
325 	}
326 # else
327 	crc = (__force u32) __cpu_to_be32(crc);
328 	crc = crc32_body(crc, p, len, tab);
329 	crc = __be32_to_cpu((__force __be32)crc);
330 # endif
331 	return crc;
332 }
333 
334 #if CRC_BE_BITS == 1
335 u32 __pure crc32_be(u32 crc, unsigned char const *p, size_t len)
336 {
337 	return crc32_be_generic(crc, p, len, NULL, CRC32_POLY_BE);
338 }
339 #else
340 u32 __pure crc32_be(u32 crc, unsigned char const *p, size_t len)
341 {
342 	return crc32_be_generic(crc, p, len,
343 			(const u32 (*)[256])crc32table_be, CRC32_POLY_BE);
344 }
345 #endif
346 EXPORT_SYMBOL(crc32_be);
347