xref: /linux/fs/btrfs/lzo.c (revision 1fd02f6605b855b4af2883f29a2abc88bdf17857)
1 // SPDX-License-Identifier: GPL-2.0
2 /*
3  * Copyright (C) 2008 Oracle.  All rights reserved.
4  */
5 
6 #include <linux/kernel.h>
7 #include <linux/slab.h>
8 #include <linux/mm.h>
9 #include <linux/init.h>
10 #include <linux/err.h>
11 #include <linux/sched.h>
12 #include <linux/pagemap.h>
13 #include <linux/bio.h>
14 #include <linux/lzo.h>
15 #include <linux/refcount.h>
16 #include "compression.h"
17 #include "ctree.h"
18 
19 #define LZO_LEN	4
20 
21 /*
22  * Btrfs LZO compression format
23  *
24  * Regular and inlined LZO compressed data extents consist of:
25  *
26  * 1.  Header
27  *     Fixed size. LZO_LEN (4) bytes long, LE32.
28  *     Records the total size (including the header) of compressed data.
29  *
30  * 2.  Segment(s)
31  *     Variable size. Each segment includes one segment header, followed by data
32  *     payload.
33  *     One regular LZO compressed extent can have one or more segments.
34  *     For inlined LZO compressed extent, only one segment is allowed.
35  *     One segment represents at most one sector of uncompressed data.
36  *
37  * 2.1 Segment header
38  *     Fixed size. LZO_LEN (4) bytes long, LE32.
39  *     Records the total size of the segment (not including the header).
40  *     Segment header never crosses sector boundary, thus it's possible to
41  *     have at most 3 padding zeros at the end of the sector.
42  *
43  * 2.2 Data Payload
44  *     Variable size. Size up limit should be lzo1x_worst_compress(sectorsize)
45  *     which is 4419 for a 4KiB sectorsize.
46  *
47  * Example with 4K sectorsize:
48  * Page 1:
49  *          0     0x2   0x4   0x6   0x8   0xa   0xc   0xe     0x10
50  * 0x0000   |  Header   | SegHdr 01 | Data payload 01 ...     |
51  * ...
52  * 0x0ff0   | SegHdr  N | Data payload  N     ...          |00|
53  *                                                          ^^ padding zeros
54  * Page 2:
55  * 0x1000   | SegHdr N+1| Data payload N+1 ...                |
56  */
57 
58 #define WORKSPACE_BUF_LENGTH	(lzo1x_worst_compress(PAGE_SIZE))
59 #define WORKSPACE_CBUF_LENGTH	(lzo1x_worst_compress(PAGE_SIZE))
60 
61 struct workspace {
62 	void *mem;
63 	void *buf;	/* where decompressed data goes */
64 	void *cbuf;	/* where compressed data goes */
65 	struct list_head list;
66 };
67 
68 static struct workspace_manager wsm;
69 
70 void lzo_free_workspace(struct list_head *ws)
71 {
72 	struct workspace *workspace = list_entry(ws, struct workspace, list);
73 
74 	kvfree(workspace->buf);
75 	kvfree(workspace->cbuf);
76 	kvfree(workspace->mem);
77 	kfree(workspace);
78 }
79 
80 struct list_head *lzo_alloc_workspace(unsigned int level)
81 {
82 	struct workspace *workspace;
83 
84 	workspace = kzalloc(sizeof(*workspace), GFP_KERNEL);
85 	if (!workspace)
86 		return ERR_PTR(-ENOMEM);
87 
88 	workspace->mem = kvmalloc(LZO1X_MEM_COMPRESS, GFP_KERNEL);
89 	workspace->buf = kvmalloc(WORKSPACE_BUF_LENGTH, GFP_KERNEL);
90 	workspace->cbuf = kvmalloc(WORKSPACE_CBUF_LENGTH, GFP_KERNEL);
91 	if (!workspace->mem || !workspace->buf || !workspace->cbuf)
92 		goto fail;
93 
94 	INIT_LIST_HEAD(&workspace->list);
95 
96 	return &workspace->list;
97 fail:
98 	lzo_free_workspace(&workspace->list);
99 	return ERR_PTR(-ENOMEM);
100 }
101 
102 static inline void write_compress_length(char *buf, size_t len)
103 {
104 	__le32 dlen;
105 
106 	dlen = cpu_to_le32(len);
107 	memcpy(buf, &dlen, LZO_LEN);
108 }
109 
110 static inline size_t read_compress_length(const char *buf)
111 {
112 	__le32 dlen;
113 
114 	memcpy(&dlen, buf, LZO_LEN);
115 	return le32_to_cpu(dlen);
116 }
117 
118 /*
119  * Will do:
120  *
121  * - Write a segment header into the destination
122  * - Copy the compressed buffer into the destination
123  * - Make sure we have enough space in the last sector to fit a segment header
124  *   If not, we will pad at most (LZO_LEN (4)) - 1 bytes of zeros.
125  *
126  * Will allocate new pages when needed.
127  */
128 static int copy_compressed_data_to_page(char *compressed_data,
129 					size_t compressed_size,
130 					struct page **out_pages,
131 					unsigned long max_nr_page,
132 					u32 *cur_out,
133 					const u32 sectorsize)
134 {
135 	u32 sector_bytes_left;
136 	u32 orig_out;
137 	struct page *cur_page;
138 	char *kaddr;
139 
140 	if ((*cur_out / PAGE_SIZE) >= max_nr_page)
141 		return -E2BIG;
142 
143 	/*
144 	 * We never allow a segment header crossing sector boundary, previous
145 	 * run should ensure we have enough space left inside the sector.
146 	 */
147 	ASSERT((*cur_out / sectorsize) == (*cur_out + LZO_LEN - 1) / sectorsize);
148 
149 	cur_page = out_pages[*cur_out / PAGE_SIZE];
150 	/* Allocate a new page */
151 	if (!cur_page) {
152 		cur_page = alloc_page(GFP_NOFS);
153 		if (!cur_page)
154 			return -ENOMEM;
155 		out_pages[*cur_out / PAGE_SIZE] = cur_page;
156 	}
157 
158 	kaddr = kmap(cur_page);
159 	write_compress_length(kaddr + offset_in_page(*cur_out),
160 			      compressed_size);
161 	*cur_out += LZO_LEN;
162 
163 	orig_out = *cur_out;
164 
165 	/* Copy compressed data */
166 	while (*cur_out - orig_out < compressed_size) {
167 		u32 copy_len = min_t(u32, sectorsize - *cur_out % sectorsize,
168 				     orig_out + compressed_size - *cur_out);
169 
170 		kunmap(cur_page);
171 
172 		if ((*cur_out / PAGE_SIZE) >= max_nr_page)
173 			return -E2BIG;
174 
175 		cur_page = out_pages[*cur_out / PAGE_SIZE];
176 		/* Allocate a new page */
177 		if (!cur_page) {
178 			cur_page = alloc_page(GFP_NOFS);
179 			if (!cur_page)
180 				return -ENOMEM;
181 			out_pages[*cur_out / PAGE_SIZE] = cur_page;
182 		}
183 		kaddr = kmap(cur_page);
184 
185 		memcpy(kaddr + offset_in_page(*cur_out),
186 		       compressed_data + *cur_out - orig_out, copy_len);
187 
188 		*cur_out += copy_len;
189 	}
190 
191 	/*
192 	 * Check if we can fit the next segment header into the remaining space
193 	 * of the sector.
194 	 */
195 	sector_bytes_left = round_up(*cur_out, sectorsize) - *cur_out;
196 	if (sector_bytes_left >= LZO_LEN || sector_bytes_left == 0)
197 		goto out;
198 
199 	/* The remaining size is not enough, pad it with zeros */
200 	memset(kaddr + offset_in_page(*cur_out), 0,
201 	       sector_bytes_left);
202 	*cur_out += sector_bytes_left;
203 
204 out:
205 	kunmap(cur_page);
206 	return 0;
207 }
208 
209 int lzo_compress_pages(struct list_head *ws, struct address_space *mapping,
210 		u64 start, struct page **pages, unsigned long *out_pages,
211 		unsigned long *total_in, unsigned long *total_out)
212 {
213 	struct workspace *workspace = list_entry(ws, struct workspace, list);
214 	const u32 sectorsize = btrfs_sb(mapping->host->i_sb)->sectorsize;
215 	struct page *page_in = NULL;
216 	char *sizes_ptr;
217 	const unsigned long max_nr_page = *out_pages;
218 	int ret = 0;
219 	/* Points to the file offset of input data */
220 	u64 cur_in = start;
221 	/* Points to the current output byte */
222 	u32 cur_out = 0;
223 	u32 len = *total_out;
224 
225 	ASSERT(max_nr_page > 0);
226 	*out_pages = 0;
227 	*total_out = 0;
228 	*total_in = 0;
229 
230 	/*
231 	 * Skip the header for now, we will later come back and write the total
232 	 * compressed size
233 	 */
234 	cur_out += LZO_LEN;
235 	while (cur_in < start + len) {
236 		char *data_in;
237 		const u32 sectorsize_mask = sectorsize - 1;
238 		u32 sector_off = (cur_in - start) & sectorsize_mask;
239 		u32 in_len;
240 		size_t out_len;
241 
242 		/* Get the input page first */
243 		if (!page_in) {
244 			page_in = find_get_page(mapping, cur_in >> PAGE_SHIFT);
245 			ASSERT(page_in);
246 		}
247 
248 		/* Compress at most one sector of data each time */
249 		in_len = min_t(u32, start + len - cur_in, sectorsize - sector_off);
250 		ASSERT(in_len);
251 		data_in = kmap(page_in);
252 		ret = lzo1x_1_compress(data_in +
253 				       offset_in_page(cur_in), in_len,
254 				       workspace->cbuf, &out_len,
255 				       workspace->mem);
256 		kunmap(page_in);
257 		if (ret < 0) {
258 			pr_debug("BTRFS: lzo in loop returned %d\n", ret);
259 			ret = -EIO;
260 			goto out;
261 		}
262 
263 		ret = copy_compressed_data_to_page(workspace->cbuf, out_len,
264 						   pages, max_nr_page,
265 						   &cur_out, sectorsize);
266 		if (ret < 0)
267 			goto out;
268 
269 		cur_in += in_len;
270 
271 		/*
272 		 * Check if we're making it bigger after two sectors.  And if
273 		 * it is so, give up.
274 		 */
275 		if (cur_in - start > sectorsize * 2 && cur_in - start < cur_out) {
276 			ret = -E2BIG;
277 			goto out;
278 		}
279 
280 		/* Check if we have reached page boundary */
281 		if (IS_ALIGNED(cur_in, PAGE_SIZE)) {
282 			put_page(page_in);
283 			page_in = NULL;
284 		}
285 	}
286 
287 	/* Store the size of all chunks of compressed data */
288 	sizes_ptr = kmap_local_page(pages[0]);
289 	write_compress_length(sizes_ptr, cur_out);
290 	kunmap_local(sizes_ptr);
291 
292 	ret = 0;
293 	*total_out = cur_out;
294 	*total_in = cur_in - start;
295 out:
296 	if (page_in)
297 		put_page(page_in);
298 	*out_pages = DIV_ROUND_UP(cur_out, PAGE_SIZE);
299 	return ret;
300 }
301 
302 /*
303  * Copy the compressed segment payload into @dest.
304  *
305  * For the payload there will be no padding, just need to do page switching.
306  */
307 static void copy_compressed_segment(struct compressed_bio *cb,
308 				    char *dest, u32 len, u32 *cur_in)
309 {
310 	u32 orig_in = *cur_in;
311 
312 	while (*cur_in < orig_in + len) {
313 		char *kaddr;
314 		struct page *cur_page;
315 		u32 copy_len = min_t(u32, PAGE_SIZE - offset_in_page(*cur_in),
316 					  orig_in + len - *cur_in);
317 
318 		ASSERT(copy_len);
319 		cur_page = cb->compressed_pages[*cur_in / PAGE_SIZE];
320 
321 		kaddr = kmap(cur_page);
322 		memcpy(dest + *cur_in - orig_in,
323 			kaddr + offset_in_page(*cur_in),
324 			copy_len);
325 		kunmap(cur_page);
326 
327 		*cur_in += copy_len;
328 	}
329 }
330 
331 int lzo_decompress_bio(struct list_head *ws, struct compressed_bio *cb)
332 {
333 	struct workspace *workspace = list_entry(ws, struct workspace, list);
334 	const struct btrfs_fs_info *fs_info = btrfs_sb(cb->inode->i_sb);
335 	const u32 sectorsize = fs_info->sectorsize;
336 	char *kaddr;
337 	int ret;
338 	/* Compressed data length, can be unaligned */
339 	u32 len_in;
340 	/* Offset inside the compressed data */
341 	u32 cur_in = 0;
342 	/* Bytes decompressed so far */
343 	u32 cur_out = 0;
344 
345 	kaddr = kmap(cb->compressed_pages[0]);
346 	len_in = read_compress_length(kaddr);
347 	kunmap(cb->compressed_pages[0]);
348 	cur_in += LZO_LEN;
349 
350 	/*
351 	 * LZO header length check
352 	 *
353 	 * The total length should not exceed the maximum extent length,
354 	 * and all sectors should be used.
355 	 * If this happens, it means the compressed extent is corrupted.
356 	 */
357 	if (len_in > min_t(size_t, BTRFS_MAX_COMPRESSED, cb->compressed_len) ||
358 	    round_up(len_in, sectorsize) < cb->compressed_len) {
359 		btrfs_err(fs_info,
360 			"invalid lzo header, lzo len %u compressed len %u",
361 			len_in, cb->compressed_len);
362 		return -EUCLEAN;
363 	}
364 
365 	/* Go through each lzo segment */
366 	while (cur_in < len_in) {
367 		struct page *cur_page;
368 		/* Length of the compressed segment */
369 		u32 seg_len;
370 		u32 sector_bytes_left;
371 		size_t out_len = lzo1x_worst_compress(sectorsize);
372 
373 		/*
374 		 * We should always have enough space for one segment header
375 		 * inside current sector.
376 		 */
377 		ASSERT(cur_in / sectorsize ==
378 		       (cur_in + LZO_LEN - 1) / sectorsize);
379 		cur_page = cb->compressed_pages[cur_in / PAGE_SIZE];
380 		ASSERT(cur_page);
381 		kaddr = kmap(cur_page);
382 		seg_len = read_compress_length(kaddr + offset_in_page(cur_in));
383 		kunmap(cur_page);
384 		cur_in += LZO_LEN;
385 
386 		if (seg_len > WORKSPACE_CBUF_LENGTH) {
387 			/*
388 			 * seg_len shouldn't be larger than we have allocated
389 			 * for workspace->cbuf
390 			 */
391 			btrfs_err(fs_info, "unexpectedly large lzo segment len %u",
392 					seg_len);
393 			ret = -EIO;
394 			goto out;
395 		}
396 
397 		/* Copy the compressed segment payload into workspace */
398 		copy_compressed_segment(cb, workspace->cbuf, seg_len, &cur_in);
399 
400 		/* Decompress the data */
401 		ret = lzo1x_decompress_safe(workspace->cbuf, seg_len,
402 					    workspace->buf, &out_len);
403 		if (ret != LZO_E_OK) {
404 			btrfs_err(fs_info, "failed to decompress");
405 			ret = -EIO;
406 			goto out;
407 		}
408 
409 		/* Copy the data into inode pages */
410 		ret = btrfs_decompress_buf2page(workspace->buf, out_len, cb, cur_out);
411 		cur_out += out_len;
412 
413 		/* All data read, exit */
414 		if (ret == 0)
415 			goto out;
416 		ret = 0;
417 
418 		/* Check if the sector has enough space for a segment header */
419 		sector_bytes_left = sectorsize - (cur_in % sectorsize);
420 		if (sector_bytes_left >= LZO_LEN)
421 			continue;
422 
423 		/* Skip the padding zeros */
424 		cur_in += sector_bytes_left;
425 	}
426 out:
427 	if (!ret)
428 		zero_fill_bio(cb->orig_bio);
429 	return ret;
430 }
431 
432 int lzo_decompress(struct list_head *ws, unsigned char *data_in,
433 		struct page *dest_page, unsigned long start_byte, size_t srclen,
434 		size_t destlen)
435 {
436 	struct workspace *workspace = list_entry(ws, struct workspace, list);
437 	size_t in_len;
438 	size_t out_len;
439 	size_t max_segment_len = WORKSPACE_BUF_LENGTH;
440 	int ret = 0;
441 	char *kaddr;
442 	unsigned long bytes;
443 
444 	if (srclen < LZO_LEN || srclen > max_segment_len + LZO_LEN * 2)
445 		return -EUCLEAN;
446 
447 	in_len = read_compress_length(data_in);
448 	if (in_len != srclen)
449 		return -EUCLEAN;
450 	data_in += LZO_LEN;
451 
452 	in_len = read_compress_length(data_in);
453 	if (in_len != srclen - LZO_LEN * 2) {
454 		ret = -EUCLEAN;
455 		goto out;
456 	}
457 	data_in += LZO_LEN;
458 
459 	out_len = PAGE_SIZE;
460 	ret = lzo1x_decompress_safe(data_in, in_len, workspace->buf, &out_len);
461 	if (ret != LZO_E_OK) {
462 		pr_warn("BTRFS: decompress failed!\n");
463 		ret = -EIO;
464 		goto out;
465 	}
466 
467 	if (out_len < start_byte) {
468 		ret = -EIO;
469 		goto out;
470 	}
471 
472 	/*
473 	 * the caller is already checking against PAGE_SIZE, but lets
474 	 * move this check closer to the memcpy/memset
475 	 */
476 	destlen = min_t(unsigned long, destlen, PAGE_SIZE);
477 	bytes = min_t(unsigned long, destlen, out_len - start_byte);
478 
479 	kaddr = kmap_local_page(dest_page);
480 	memcpy(kaddr, workspace->buf + start_byte, bytes);
481 
482 	/*
483 	 * btrfs_getblock is doing a zero on the tail of the page too,
484 	 * but this will cover anything missing from the decompressed
485 	 * data.
486 	 */
487 	if (bytes < destlen)
488 		memset(kaddr+bytes, 0, destlen-bytes);
489 	kunmap_local(kaddr);
490 out:
491 	return ret;
492 }
493 
494 const struct btrfs_compress_op btrfs_lzo_compress = {
495 	.workspace_manager	= &wsm,
496 	.max_level		= 1,
497 	.default_level		= 1,
498 };
499