ext4_journal: add block_get(_noread)/block_set.
[lwext4.git] / lwext4 / ext4_blockdev.c
1 /*
2  * Copyright (c) 2013 Grzegorz Kostka (kostka.grzegorz@gmail.com)
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  *
9  * - Redistributions of source code must retain the above copyright
10  *   notice, this list of conditions and the following disclaimer.
11  * - Redistributions in binary form must reproduce the above copyright
12  *   notice, this list of conditions and the following disclaimer in the
13  *   documentation and/or other materials provided with the distribution.
14  * - The name of the author may not be used to endorse or promote products
15  *   derived from this software without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28
29 /** @addtogroup lwext4
30  * @{
31  */
32 /**
33  * @file  ext4_blockdev.c
34  * @brief Block device module.
35  */
36
37 #include "ext4_config.h"
38 #include "ext4_blockdev.h"
39 #include "ext4_errno.h"
40 #include "ext4_debug.h"
41
42 #include <string.h>
43 #include <stdlib.h>
44
45 int ext4_block_init(struct ext4_blockdev *bdev)
46 {
47         int rc;
48         ext4_assert(bdev);
49
50         ext4_assert(bdev->open && bdev->close && bdev->bread && bdev->bwrite);
51
52         /*Low level block init*/
53         rc = bdev->open(bdev);
54         if (rc != EOK)
55                 return rc;
56
57         bdev->flags |= EXT4_BDEV_INITIALIZED;
58
59         return EOK;
60 }
61
62 int ext4_block_bind_bcache(struct ext4_blockdev *bdev, struct ext4_bcache *bc)
63 {
64         ext4_assert(bdev && bc);
65         bdev->bc = bc;
66         return EOK;
67 }
68
69 void ext4_block_set_lb_size(struct ext4_blockdev *bdev, uint64_t lb_bsize)
70 {
71         /*Logical block size has to be multiply of physical */
72         ext4_assert(!(lb_bsize % bdev->ph_bsize));
73
74         bdev->lg_bsize = lb_bsize;
75         bdev->lg_bcnt = (bdev->ph_bcnt * bdev->ph_bsize) / lb_bsize;
76 }
77
78 int ext4_block_fini(struct ext4_blockdev *bdev)
79 {
80         ext4_assert(bdev);
81
82         bdev->flags &= ~(EXT4_BDEV_INITIALIZED);
83
84         /*Low level block fini*/
85         return bdev->close(bdev);
86 }
87
88 int ext4_block_get_noread(struct ext4_blockdev *bdev, struct ext4_block *b,
89                           uint64_t lba)
90 {
91         uint32_t i;
92         bool is_new;
93         int r;
94
95         ext4_assert(bdev && b);
96
97         if (!(bdev->flags & EXT4_BDEV_INITIALIZED))
98                 return EIO;
99
100         if (!(lba < bdev->lg_bcnt))
101                 return ERANGE;
102
103         b->dirty = 0;
104         b->lb_id = lba;
105
106         /*If cache is full we have to flush it anyway :(*/
107         if (ext4_bcache_is_full(bdev->bc) && bdev->cache_write_back) {
108
109                 uint32_t free_candidate = bdev->bc->cnt;
110                 uint32_t min_lru = 0xFFFFFFFF;
111
112                 for (i = 0; i < bdev->bc->cnt; ++i) {
113                         /*Check if buffer free was delayed.*/
114                         if (!bdev->bc->free_delay[i])
115                                 continue;
116
117                         /*Check reference counter.*/
118                         if (bdev->bc->refctr[i])
119                                 continue;
120
121                         if (bdev->bc->lru_id[i] < min_lru) {
122                                 min_lru = bdev->bc->lru_id[i];
123                                 free_candidate = i;
124                                 continue;
125                         }
126                 }
127
128                 if (free_candidate < bdev->bc->cnt) {
129                         /*Buffer free was delayed and have no reference. Flush
130                          * it.*/
131                         r = ext4_blocks_set_direct(
132                             bdev, bdev->bc->data +
133                                       bdev->bc->itemsize * free_candidate,
134                             bdev->bc->lba[free_candidate], 1);
135                         if (r != EOK)
136                                 return r;
137
138                         /*No delayed anymore*/
139                         bdev->bc->free_delay[free_candidate] = 0;
140
141                         /*Reduce reference counter*/
142                         bdev->bc->ref_blocks--;
143                 }
144         }
145
146         r = ext4_bcache_alloc(bdev->bc, b, &is_new);
147         if (r != EOK)
148                 return r;
149
150         if (!b->data)
151                 return ENOMEM;
152
153         return EOK;
154 }
155
156 int ext4_block_get(struct ext4_blockdev *bdev, struct ext4_block *b,
157                    uint64_t lba)
158 {
159         uint64_t pba;
160         uint32_t pb_cnt;
161         int r = ext4_block_get_noread(bdev, b, lba);
162         if (r != EOK)
163                 return r;
164
165         if (b->uptodate) {
166                 /* Data in the cache is up-to-date.
167                  * Reading from physical device is not required */
168                 return EOK;
169         }
170
171         pba = (lba * bdev->lg_bsize) / bdev->ph_bsize;
172         pb_cnt = bdev->lg_bsize / bdev->ph_bsize;
173
174         r = bdev->bread(bdev, b->data, pba, pb_cnt);
175
176         if (r != EOK) {
177                 ext4_bcache_free(bdev->bc, b, 0);
178                 b->lb_id = 0;
179                 return r;
180         }
181
182         /* Mark buffer up-to-date, since
183          * fresh data is read from physical device just now. */
184         ext4_bcache_set_flag(bdev->bc, b->cache_id, BC_UPTODATE);
185         b->uptodate = true;
186         bdev->bread_ctr++;
187         return EOK;
188 }
189
190 int ext4_block_set(struct ext4_blockdev *bdev, struct ext4_block *b)
191 {
192         uint64_t pba;
193         uint32_t pb_cnt;
194         int r;
195
196         ext4_assert(bdev && b);
197
198         if (!(bdev->flags & EXT4_BDEV_INITIALIZED))
199                 return EIO;
200
201         /*Buffer is not marked dirty and is stale*/
202         if (!b->uptodate && !b->dirty)
203                 ext4_bcache_clear_flag(bdev->bc, b->cache_id, BC_UPTODATE);
204
205         /*No need to write.*/
206         if (!b->dirty &&
207             !ext4_bcache_test_flag(bdev->bc, b->cache_id, BC_DIRTY)) {
208                 ext4_bcache_free(bdev->bc, b, 0);
209                 return EOK;
210         }
211         /* Data is valid, so mark buffer up-to-date. */
212         ext4_bcache_set_flag(bdev->bc, b->cache_id, BC_UPTODATE);
213
214         /*Free cache delay mode*/
215         if (bdev->cache_write_back) {
216
217                 /*Free cache block and mark as free delayed*/
218                 return ext4_bcache_free(bdev->bc, b, bdev->cache_write_back);
219         }
220
221         if (bdev->bc->refctr[b->cache_id] > 1) {
222                 ext4_bcache_set_flag(bdev->bc, b->cache_id, BC_DIRTY);
223                 return ext4_bcache_free(bdev->bc, b, 0);
224         }
225
226         pba = (b->lb_id * bdev->lg_bsize) / bdev->ph_bsize;
227         pb_cnt = bdev->lg_bsize / bdev->ph_bsize;
228
229         r = bdev->bwrite(bdev, b->data, pba, pb_cnt);
230         ext4_bcache_clear_flag(bdev->bc, b->cache_id, BC_DIRTY);
231         if (r != EOK) {
232                 b->dirty = false;
233                 ext4_bcache_clear_flag(bdev->bc, b->cache_id, BC_UPTODATE);
234                 ext4_bcache_free(bdev->bc, b, 0);
235                 return r;
236         }
237
238         bdev->bwrite_ctr++;
239         b->dirty = false;
240         ext4_bcache_free(bdev->bc, b, 0);
241         return EOK;
242 }
243
244 int ext4_blocks_get_direct(struct ext4_blockdev *bdev, void *buf, uint64_t lba,
245                            uint32_t cnt)
246 {
247         uint64_t pba;
248         uint32_t pb_cnt;
249
250         ext4_assert(bdev && buf);
251
252         pba = (lba * bdev->lg_bsize) / bdev->ph_bsize;
253         pb_cnt = bdev->lg_bsize / bdev->ph_bsize;
254
255         bdev->bread_ctr++;
256         return bdev->bread(bdev, buf, pba, pb_cnt * cnt);
257 }
258
259 int ext4_blocks_set_direct(struct ext4_blockdev *bdev, const void *buf,
260                            uint64_t lba, uint32_t cnt)
261 {
262         uint64_t pba;
263         uint32_t pb_cnt;
264
265         ext4_assert(bdev && buf);
266
267         pba = (lba * bdev->lg_bsize) / bdev->ph_bsize;
268         pb_cnt = bdev->lg_bsize / bdev->ph_bsize;
269
270         bdev->bwrite_ctr++;
271
272         return bdev->bwrite(bdev, buf, pba, pb_cnt * cnt);
273 }
274
275 int ext4_block_writebytes(struct ext4_blockdev *bdev, uint64_t off,
276                           const void *buf, uint32_t len)
277 {
278         uint64_t block_idx;
279         uint64_t block_end;
280         uint32_t blen;
281         uint32_t unalg;
282         int r = EOK;
283
284         const uint8_t *p = (void *)buf;
285
286         ext4_assert(bdev && buf);
287
288         if (!(bdev->flags & EXT4_BDEV_INITIALIZED))
289                 return EIO;
290
291         block_idx = off / bdev->ph_bsize;
292         block_end = block_idx + len / bdev->ph_bsize;
293
294         if (!(block_end < bdev->ph_bcnt))
295                 return EINVAL; /*Ups. Out of range operation*/
296
297         /*OK lets deal with the first possible unaligned block*/
298         unalg = (off & (bdev->ph_bsize - 1));
299         if (unalg) {
300
301                 uint32_t wlen = (bdev->ph_bsize - unalg) > len
302                                     ? len
303                                     : (bdev->ph_bsize - unalg);
304
305                 r = bdev->bread(bdev, bdev->ph_bbuf, block_idx, 1);
306                 if (r != EOK)
307                         return r;
308
309                 memcpy(bdev->ph_bbuf + unalg, p, wlen);
310
311                 r = bdev->bwrite(bdev, bdev->ph_bbuf, block_idx, 1);
312                 if (r != EOK)
313                         return r;
314
315                 p += wlen;
316                 len -= wlen;
317                 block_idx++;
318         }
319
320         /*Aligned data*/
321         blen = len / bdev->ph_bsize;
322         r = bdev->bwrite(bdev, p, block_idx, blen);
323         if (r != EOK)
324                 return r;
325
326         p += bdev->ph_bsize * blen;
327         len -= bdev->ph_bsize * blen;
328
329         block_idx += blen;
330
331         /*Rest of the data*/
332         if (len) {
333                 r = bdev->bread(bdev, bdev->ph_bbuf, block_idx, 1);
334                 if (r != EOK)
335                         return r;
336
337                 memcpy(bdev->ph_bbuf, p, len);
338
339                 r = bdev->bwrite(bdev, bdev->ph_bbuf, block_idx, 1);
340                 if (r != EOK)
341                         return r;
342         }
343
344         return r;
345 }
346
347 int ext4_block_readbytes(struct ext4_blockdev *bdev, uint64_t off, void *buf,
348                          uint32_t len)
349 {
350         uint64_t block_idx;
351         uint64_t block_end;
352         uint32_t blen;
353         uint32_t unalg;
354         int r = EOK;
355
356         uint8_t *p = (void *)buf;
357
358         ext4_assert(bdev && buf);
359
360         if (!(bdev->flags & EXT4_BDEV_INITIALIZED))
361                 return EIO;
362
363         block_idx = off / bdev->ph_bsize;
364         block_end = block_idx + len / bdev->ph_bsize;
365
366         if (!(block_end < bdev->ph_bcnt))
367                 return EINVAL; /*Ups. Out of range operation*/
368
369         /*OK lets deal with the first possible unaligned block*/
370         unalg = (off & (bdev->ph_bsize - 1));
371         if (unalg) {
372
373                 uint32_t rlen = (bdev->ph_bsize - unalg) > len
374                                     ? len
375                                     : (bdev->ph_bsize - unalg);
376
377                 r = bdev->bread(bdev, bdev->ph_bbuf, block_idx, 1);
378                 if (r != EOK)
379                         return r;
380
381                 memcpy(p, bdev->ph_bbuf + unalg, rlen);
382
383                 p += rlen;
384                 len -= rlen;
385                 block_idx++;
386         }
387
388         /*Aligned data*/
389         blen = len / bdev->ph_bsize;
390
391         r = bdev->bread(bdev, p, block_idx, blen);
392         if (r != EOK)
393                 return r;
394
395         p += bdev->ph_bsize * blen;
396         len -= bdev->ph_bsize * blen;
397
398         block_idx += blen;
399
400         /*Rest of the data*/
401         if (len) {
402                 r = bdev->bread(bdev, bdev->ph_bbuf, block_idx, 1);
403                 if (r != EOK)
404                         return r;
405
406                 memcpy(p, bdev->ph_bbuf, len);
407         }
408
409         return r;
410 }
411
412 int ext4_block_cache_write_back(struct ext4_blockdev *bdev, uint8_t on_off)
413 {
414         int r;
415         uint32_t i;
416
417         if (on_off)
418                 bdev->cache_write_back++;
419
420         if (!on_off && bdev->cache_write_back)
421                 bdev->cache_write_back--;
422
423
424         if (bdev->cache_write_back)
425                 return EOK;
426
427         /*Flush all delayed cache blocks*/
428         for (i = 0; i < bdev->bc->cnt; ++i) {
429
430                 /*Check if buffer free was delayed.*/
431                 if (!bdev->bc->free_delay[i])
432                         continue;
433
434                 /*Check reference counter.*/
435                 if (bdev->bc->refctr[i])
436                         continue;
437
438                 /*Buffer free was delayed and have no reference. Flush
439                  * it.*/
440                 r = ext4_blocks_set_direct(bdev, bdev->bc->data +
441                                 bdev->bc->itemsize * i, bdev->bc->lba[i], 1);
442                 if (r != EOK)
443                         return r;
444
445                 /*No delayed anymore*/
446                 bdev->bc->free_delay[i] = 0;
447
448                 /*Reduce reference counter*/
449                 bdev->bc->ref_blocks--;
450         }
451
452         return EOK;
453 }
454
455 /**
456  * @}
457  */