source: mainline/uspace/lib/ext4/src/balloc.c@ be912f53

Last change on this file since be912f53 was be912f53, checked in by Maurizio Lombardi <mlombard@…>, 7 years ago

libext4: simplify ext4_balloc_get_first_data_block_in_group()

The first data block is ALWAYS after the inode table, FLEX_BG doesn't
change that.
  • Property mode set to 100644
File size: 18.3 KB
Line 
1/*
2 * Copyright (c) 2018 Jiri Svoboda
3 * Copyright (c) 2012 Frantisek Princ
4 * All rights reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 *
10 * - Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * - Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
15 * - The name of the author may not be used to endorse or promote products
16 * derived from this software without specific prior written permission.
17 *
18 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 */
29
30/** @addtogroup libext4
31 * @{
32 */
33/**
34 * @file balloc.c
35 * @brief Physical block allocator.
36 */
37
38#include <errno.h>
39#include <stdbool.h>
40#include <stdint.h>
41#include "ext4/balloc.h"
42#include "ext4/bitmap.h"
43#include "ext4/block_group.h"
44#include "ext4/filesystem.h"
45#include "ext4/inode.h"
46#include "ext4/superblock.h"
47#include "ext4/types.h"
48
49/** Free block.
50 *
51 * @param inode_ref Inode, where the block is allocated
52 * @param block_addr Absolute block address to free
53 *
54 * @return Error code
55 *
56 */
57errno_t ext4_balloc_free_block(ext4_inode_ref_t *inode_ref, uint32_t block_addr)
58{
59 ext4_filesystem_t *fs = inode_ref->fs;
60 ext4_superblock_t *sb = fs->superblock;
61
62 /* Compute indexes */
63 uint32_t block_group = ext4_filesystem_blockaddr2group(sb, block_addr);
64 uint32_t index_in_group =
65 ext4_filesystem_blockaddr2_index_in_group(sb, block_addr);
66
67 /* Load block group reference */
68 ext4_block_group_ref_t *bg_ref;
69 errno_t rc = ext4_filesystem_get_block_group_ref(fs, block_group, &bg_ref);
70 if (rc != EOK)
71 return rc;
72
73 /* Load block with bitmap */
74 uint32_t bitmap_block_addr =
75 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
76 block_t *bitmap_block;
77 rc = block_get(&bitmap_block, fs->device, bitmap_block_addr, 0);
78 if (rc != EOK) {
79 ext4_filesystem_put_block_group_ref(bg_ref);
80 return rc;
81 }
82
83 /* Modify bitmap */
84 ext4_bitmap_free_bit(bitmap_block->data, index_in_group);
85 bitmap_block->dirty = true;
86
87 /* Release block with bitmap */
88 rc = block_put(bitmap_block);
89 if (rc != EOK) {
90 /* Error in saving bitmap */
91 ext4_filesystem_put_block_group_ref(bg_ref);
92 return rc;
93 }
94
95 uint32_t block_size = ext4_superblock_get_block_size(sb);
96
97 /* Update superblock free blocks count */
98 uint32_t sb_free_blocks =
99 ext4_superblock_get_free_blocks_count(sb);
100 sb_free_blocks++;
101 ext4_superblock_set_free_blocks_count(sb, sb_free_blocks);
102
103 /* Update inode blocks count */
104 uint64_t ino_blocks =
105 ext4_inode_get_blocks_count(sb, inode_ref->inode);
106 ino_blocks -= block_size / EXT4_INODE_BLOCK_SIZE;
107 ext4_inode_set_blocks_count(sb, inode_ref->inode, ino_blocks);
108 inode_ref->dirty = true;
109
110 /* Update block group free blocks count */
111 uint32_t free_blocks =
112 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
113 free_blocks++;
114 ext4_block_group_set_free_blocks_count(bg_ref->block_group,
115 sb, free_blocks);
116 bg_ref->dirty = true;
117
118 /* Release block group reference */
119 return ext4_filesystem_put_block_group_ref(bg_ref);
120}
121
122static errno_t ext4_balloc_free_blocks_internal(ext4_inode_ref_t *inode_ref,
123 uint32_t first, uint32_t count)
124{
125 ext4_filesystem_t *fs = inode_ref->fs;
126 ext4_superblock_t *sb = fs->superblock;
127
128 /* Compute indexes */
129 uint32_t block_group_first = ext4_filesystem_blockaddr2group(sb,
130 first);
131 uint32_t block_group_last = ext4_filesystem_blockaddr2group(sb,
132 first + count - 1);
133
134 assert(block_group_first == block_group_last);
135
136 /* Load block group reference */
137 ext4_block_group_ref_t *bg_ref;
138 errno_t rc = ext4_filesystem_get_block_group_ref(fs, block_group_first, &bg_ref);
139 if (rc != EOK)
140 return rc;
141
142 uint32_t index_in_group_first =
143 ext4_filesystem_blockaddr2_index_in_group(sb, first);
144
145 /* Load block with bitmap */
146 uint32_t bitmap_block_addr =
147 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
148
149 block_t *bitmap_block;
150 rc = block_get(&bitmap_block, fs->device, bitmap_block_addr, 0);
151 if (rc != EOK) {
152 ext4_filesystem_put_block_group_ref(bg_ref);
153 return rc;
154 }
155
156 /* Modify bitmap */
157 ext4_bitmap_free_bits(bitmap_block->data, index_in_group_first, count);
158 bitmap_block->dirty = true;
159
160 /* Release block with bitmap */
161 rc = block_put(bitmap_block);
162 if (rc != EOK) {
163 /* Error in saving bitmap */
164 ext4_filesystem_put_block_group_ref(bg_ref);
165 return rc;
166 }
167
168 uint32_t block_size = ext4_superblock_get_block_size(sb);
169
170 /* Update superblock free blocks count */
171 uint32_t sb_free_blocks =
172 ext4_superblock_get_free_blocks_count(sb);
173 sb_free_blocks += count;
174 ext4_superblock_set_free_blocks_count(sb, sb_free_blocks);
175
176 /* Update inode blocks count */
177 uint64_t ino_blocks =
178 ext4_inode_get_blocks_count(sb, inode_ref->inode);
179 ino_blocks -= count * (block_size / EXT4_INODE_BLOCK_SIZE);
180 ext4_inode_set_blocks_count(sb, inode_ref->inode, ino_blocks);
181 inode_ref->dirty = true;
182
183 /* Update block group free blocks count */
184 uint32_t free_blocks =
185 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
186 free_blocks += count;
187 ext4_block_group_set_free_blocks_count(bg_ref->block_group,
188 sb, free_blocks);
189 bg_ref->dirty = true;
190
191 /* Release block group reference */
192 return ext4_filesystem_put_block_group_ref(bg_ref);
193}
194
195/** Free continuous set of blocks.
196 *
197 * @param inode_ref Inode, where the blocks are allocated
198 * @param first First block to release
199 * @param count Number of blocks to release
200 *
201 */
202errno_t ext4_balloc_free_blocks(ext4_inode_ref_t *inode_ref,
203 uint32_t first, uint32_t count)
204{
205 errno_t r;
206 uint32_t gid;
207 uint64_t limit;
208 ext4_filesystem_t *fs = inode_ref->fs;
209 ext4_superblock_t *sb = fs->superblock;
210
211 while (count) {
212 gid = ext4_filesystem_blockaddr2group(sb, first);
213 limit = ext4_filesystem_index_in_group2blockaddr(sb, 0,
214 gid + 1);
215
216 if ((first + count) >= limit) {
217 /*
218 * This extent spans over 2 or more block groups,
219 * we'll break it into smaller parts.
220 */
221 uint32_t s = limit - first;
222
223 r = ext4_balloc_free_blocks_internal(inode_ref,
224 first, s);
225 if (r != EOK)
226 return r;
227
228 first = limit;
229 count -= s;
230 } else {
231 return ext4_balloc_free_blocks_internal(inode_ref,
232 first, count);
233 }
234 }
235
236 return EOK;
237}
238
239/** Compute first block for data in block group.
240 *
241 * @param sb Pointer to superblock
242 * @param bg Pointer to block group
243 * @param bgid Index of block group
244 *
245 * @return Absolute block index of first block
246 *
247 */
248uint32_t ext4_balloc_get_first_data_block_in_group(ext4_superblock_t *sb,
249 ext4_block_group_ref_t *bg_ref)
250{
251 uint32_t r;
252 uint64_t itable = ext4_block_group_get_inode_table_first_block(
253 bg_ref->block_group, sb);
254 uint32_t itable_sz = ext4_filesystem_bg_get_itable_size(sb,
255 bg_ref->index);
256
257 r = itable + itable_sz;
258 return ext4_filesystem_blockaddr2_index_in_group(sb, r);
259}
260
261/** Compute 'goal' for allocation algorithm.
262 *
263 * @param inode_ref Reference to inode, to allocate block for
264 *
265 * @return Goal block number
266 *
267 */
268static errno_t ext4_balloc_find_goal(ext4_inode_ref_t *inode_ref, uint32_t *goal)
269{
270 *goal = 0;
271 ext4_superblock_t *sb = inode_ref->fs->superblock;
272
273 uint64_t inode_size = ext4_inode_get_size(sb, inode_ref->inode);
274 uint32_t block_size = ext4_superblock_get_block_size(sb);
275 uint32_t inode_block_count = inode_size / block_size;
276
277 if (inode_size % block_size != 0)
278 inode_block_count++;
279
280 /* If inode has some blocks, get last block address + 1 */
281 if (inode_block_count > 0) {
282 errno_t rc = ext4_filesystem_get_inode_data_block_index(inode_ref,
283 inode_block_count - 1, goal);
284 if (rc != EOK)
285 return rc;
286
287 if (goal != 0) {
288 (*goal)++;
289 return EOK;
290 }
291 /* If goal == 0, sparse file -> continue */
292 }
293
294 /* Identify block group of inode */
295 uint32_t inodes_per_group = ext4_superblock_get_inodes_per_group(sb);
296 uint32_t block_group = (inode_ref->index - 1) / inodes_per_group;
297
298 /* Load block group reference */
299 ext4_block_group_ref_t *bg_ref;
300 errno_t rc = ext4_filesystem_get_block_group_ref(inode_ref->fs,
301 block_group, &bg_ref);
302 if (rc != EOK)
303 return rc;
304
305 *goal = ext4_balloc_get_first_data_block_in_group(sb, bg_ref);
306
307 return ext4_filesystem_put_block_group_ref(bg_ref);
308}
309
310/** Data block allocation algorithm.
311 *
312 * @param inode_ref Inode to allocate block for
313 * @param fblock Allocated block address
314 *
315 * @return Error code
316 *
317 */
318errno_t ext4_balloc_alloc_block(ext4_inode_ref_t *inode_ref, uint32_t *fblock)
319{
320 uint32_t allocated_block = 0;
321
322 uint32_t bitmap_block_addr;
323 block_t *bitmap_block;
324 uint32_t rel_block_idx = 0;
325 uint32_t free_blocks;
326 uint32_t goal;
327 uint32_t block_size;
328
329 /* Find GOAL */
330 errno_t rc = ext4_balloc_find_goal(inode_ref, &goal);
331 if (rc != EOK)
332 return rc;
333
334 ext4_superblock_t *sb = inode_ref->fs->superblock;
335
336 /* Load block group number for goal and relative index */
337 uint32_t block_group = ext4_filesystem_blockaddr2group(sb, goal);
338 uint32_t index_in_group =
339 ext4_filesystem_blockaddr2_index_in_group(sb, goal);
340
341 /* Load block group reference */
342 ext4_block_group_ref_t *bg_ref;
343 rc = ext4_filesystem_get_block_group_ref(inode_ref->fs,
344 block_group, &bg_ref);
345 if (rc != EOK)
346 return rc;
347
348 free_blocks =
349 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
350 if (free_blocks == 0) {
351 /* This group has no free blocks */
352 goto goal_failed;
353 }
354
355 /* Compute indexes */
356 uint32_t first_in_group =
357 ext4_balloc_get_first_data_block_in_group(sb, bg_ref);
358
359 uint32_t first_in_group_index =
360 ext4_filesystem_blockaddr2_index_in_group(sb, first_in_group);
361
362 if (index_in_group < first_in_group_index)
363 index_in_group = first_in_group_index;
364
365 /* Load block with bitmap */
366 bitmap_block_addr =
367 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
368
369 rc = block_get(&bitmap_block, inode_ref->fs->device,
370 bitmap_block_addr, BLOCK_FLAGS_NONE);
371 if (rc != EOK) {
372 ext4_filesystem_put_block_group_ref(bg_ref);
373 return rc;
374 }
375
376 /* Check if goal is free */
377 if (ext4_bitmap_is_free_bit(bitmap_block->data, index_in_group)) {
378 ext4_bitmap_set_bit(bitmap_block->data, index_in_group);
379 bitmap_block->dirty = true;
380 rc = block_put(bitmap_block);
381 if (rc != EOK) {
382 ext4_filesystem_put_block_group_ref(bg_ref);
383 return rc;
384 }
385
386 allocated_block =
387 ext4_filesystem_index_in_group2blockaddr(sb, index_in_group,
388 block_group);
389
390 goto success;
391 }
392
393 uint32_t blocks_in_group =
394 ext4_superblock_get_blocks_in_group(sb, block_group);
395
396 uint32_t end_idx = (index_in_group + 63) & ~63;
397 if (end_idx > blocks_in_group)
398 end_idx = blocks_in_group;
399
400 /* Try to find free block near to goal */
401 for (uint32_t tmp_idx = index_in_group + 1; tmp_idx < end_idx;
402 ++tmp_idx) {
403 if (ext4_bitmap_is_free_bit(bitmap_block->data, tmp_idx)) {
404 ext4_bitmap_set_bit(bitmap_block->data, tmp_idx);
405 bitmap_block->dirty = true;
406 rc = block_put(bitmap_block);
407 if (rc != EOK)
408 return rc;
409
410 allocated_block =
411 ext4_filesystem_index_in_group2blockaddr(sb, tmp_idx,
412 block_group);
413
414 goto success;
415 }
416 }
417
418 /* Find free BYTE in bitmap */
419 rc = ext4_bitmap_find_free_byte_and_set_bit(bitmap_block->data,
420 index_in_group, &rel_block_idx, blocks_in_group);
421 if (rc == EOK) {
422 bitmap_block->dirty = true;
423 rc = block_put(bitmap_block);
424 if (rc != EOK)
425 return rc;
426
427 allocated_block =
428 ext4_filesystem_index_in_group2blockaddr(sb, rel_block_idx,
429 block_group);
430
431 goto success;
432 }
433
434 /* Find free bit in bitmap */
435 rc = ext4_bitmap_find_free_bit_and_set(bitmap_block->data,
436 index_in_group, &rel_block_idx, blocks_in_group);
437 if (rc == EOK) {
438 bitmap_block->dirty = true;
439 rc = block_put(bitmap_block);
440 if (rc != EOK)
441 return rc;
442
443 allocated_block =
444 ext4_filesystem_index_in_group2blockaddr(sb, rel_block_idx,
445 block_group);
446
447 goto success;
448 }
449
450 /* No free block found yet */
451 rc = block_put(bitmap_block);
452 if (rc != EOK) {
453 ext4_filesystem_put_block_group_ref(bg_ref);
454 return rc;
455 }
456
457goal_failed:
458
459 rc = ext4_filesystem_put_block_group_ref(bg_ref);
460 if (rc != EOK)
461 return rc;
462
463 /* Try other block groups */
464 uint32_t block_group_count = ext4_superblock_get_block_group_count(sb);
465
466 uint32_t bgid = (block_group + 1) % block_group_count;
467 uint32_t count = block_group_count;
468
469 while (count > 0) {
470 rc = ext4_filesystem_get_block_group_ref(inode_ref->fs, bgid,
471 &bg_ref);
472 if (rc != EOK)
473 return rc;
474
475 free_blocks =
476 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
477 if (free_blocks == 0) {
478 /* This group has no free blocks */
479 goto next_group;
480 }
481
482 /* Load block with bitmap */
483 bitmap_block_addr =
484 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
485
486 rc = block_get(&bitmap_block, inode_ref->fs->device,
487 bitmap_block_addr, 0);
488 if (rc != EOK) {
489 ext4_filesystem_put_block_group_ref(bg_ref);
490 return rc;
491 }
492
493 /* Compute indexes */
494 first_in_group =
495 ext4_balloc_get_first_data_block_in_group(sb, bg_ref);
496 index_in_group =
497 ext4_filesystem_blockaddr2_index_in_group(sb, first_in_group);
498 blocks_in_group = ext4_superblock_get_blocks_in_group(sb, bgid);
499
500 first_in_group_index =
501 ext4_filesystem_blockaddr2_index_in_group(sb, first_in_group);
502
503 if (index_in_group < first_in_group_index)
504 index_in_group = first_in_group_index;
505
506 /* Try to find free byte in bitmap */
507 rc = ext4_bitmap_find_free_byte_and_set_bit(bitmap_block->data,
508 index_in_group, &rel_block_idx, blocks_in_group);
509 if (rc == EOK) {
510 bitmap_block->dirty = true;
511 rc = block_put(bitmap_block);
512 if (rc != EOK) {
513 ext4_filesystem_put_block_group_ref(bg_ref);
514 return rc;
515 }
516
517 allocated_block =
518 ext4_filesystem_index_in_group2blockaddr(sb, rel_block_idx,
519 bgid);
520
521 goto success;
522 }
523
524 /* Try to find free bit in bitmap */
525 rc = ext4_bitmap_find_free_bit_and_set(bitmap_block->data,
526 index_in_group, &rel_block_idx, blocks_in_group);
527 if (rc == EOK) {
528 bitmap_block->dirty = true;
529 rc = block_put(bitmap_block);
530 if (rc != EOK) {
531 ext4_filesystem_put_block_group_ref(bg_ref);
532 return rc;
533 }
534
535 allocated_block =
536 ext4_filesystem_index_in_group2blockaddr(sb, rel_block_idx,
537 bgid);
538
539 goto success;
540 }
541
542 rc = block_put(bitmap_block);
543 if (rc != EOK) {
544 ext4_filesystem_put_block_group_ref(bg_ref);
545 return rc;
546 }
547
548 next_group:
549 rc = ext4_filesystem_put_block_group_ref(bg_ref);
550 if (rc != EOK)
551 return rc;
552
553 /* Goto next group */
554 bgid = (bgid + 1) % block_group_count;
555 count--;
556 }
557
558 return ENOSPC;
559
560success:
561 block_size = ext4_superblock_get_block_size(sb);
562
563 /* Update superblock free blocks count */
564 uint32_t sb_free_blocks = ext4_superblock_get_free_blocks_count(sb);
565 sb_free_blocks--;
566 ext4_superblock_set_free_blocks_count(sb, sb_free_blocks);
567
568 /* Update inode blocks (different block size!) count */
569 uint64_t ino_blocks =
570 ext4_inode_get_blocks_count(sb, inode_ref->inode);
571 ino_blocks += block_size / EXT4_INODE_BLOCK_SIZE;
572 ext4_inode_set_blocks_count(sb, inode_ref->inode, ino_blocks);
573 inode_ref->dirty = true;
574
575 /* Update block group free blocks count */
576 uint32_t bg_free_blocks =
577 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
578 bg_free_blocks--;
579 ext4_block_group_set_free_blocks_count(bg_ref->block_group, sb,
580 bg_free_blocks);
581 bg_ref->dirty = true;
582
583 rc = ext4_filesystem_put_block_group_ref(bg_ref);
584
585 *fblock = allocated_block;
586 return rc;
587}
588
589/** Try to allocate concrete block.
590 *
591 * @param inode_ref Inode to allocate block for
592 * @param fblock Block address to allocate
593 * @param free Output value - if target block is free
594 *
595 * @return Error code
596 *
597 */
598errno_t ext4_balloc_try_alloc_block(ext4_inode_ref_t *inode_ref, uint32_t fblock,
599 bool *free)
600{
601 errno_t rc;
602
603 ext4_filesystem_t *fs = inode_ref->fs;
604 ext4_superblock_t *sb = fs->superblock;
605
606 /* Compute indexes */
607 uint32_t block_group = ext4_filesystem_blockaddr2group(sb, fblock);
608 uint32_t index_in_group =
609 ext4_filesystem_blockaddr2_index_in_group(sb, fblock);
610
611 /* Load block group reference */
612 ext4_block_group_ref_t *bg_ref;
613 rc = ext4_filesystem_get_block_group_ref(fs, block_group, &bg_ref);
614 if (rc != EOK)
615 return rc;
616
617 /* Load block with bitmap */
618 uint32_t bitmap_block_addr =
619 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
620 block_t *bitmap_block;
621 rc = block_get(&bitmap_block, fs->device, bitmap_block_addr, 0);
622 if (rc != EOK) {
623 ext4_filesystem_put_block_group_ref(bg_ref);
624 return rc;
625 }
626
627 /* Check if block is free */
628 *free = ext4_bitmap_is_free_bit(bitmap_block->data, index_in_group);
629
630 /* Allocate block if possible */
631 if (*free) {
632 ext4_bitmap_set_bit(bitmap_block->data, index_in_group);
633 bitmap_block->dirty = true;
634 }
635
636 /* Release block with bitmap */
637 rc = block_put(bitmap_block);
638 if (rc != EOK) {
639 /* Error in saving bitmap */
640 ext4_filesystem_put_block_group_ref(bg_ref);
641 return rc;
642 }
643
644 /* If block is not free, return */
645 if (!(*free))
646 goto terminate;
647
648 uint32_t block_size = ext4_superblock_get_block_size(sb);
649
650 /* Update superblock free blocks count */
651 uint32_t sb_free_blocks = ext4_superblock_get_free_blocks_count(sb);
652 sb_free_blocks--;
653 ext4_superblock_set_free_blocks_count(sb, sb_free_blocks);
654
655 /* Update inode blocks count */
656 uint64_t ino_blocks =
657 ext4_inode_get_blocks_count(sb, inode_ref->inode);
658 ino_blocks += block_size / EXT4_INODE_BLOCK_SIZE;
659 ext4_inode_set_blocks_count(sb, inode_ref->inode, ino_blocks);
660 inode_ref->dirty = true;
661
662 /* Update block group free blocks count */
663 uint32_t free_blocks =
664 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
665 free_blocks--;
666 ext4_block_group_set_free_blocks_count(bg_ref->block_group,
667 sb, free_blocks);
668 bg_ref->dirty = true;
669
670terminate:
671 return ext4_filesystem_put_block_group_ref(bg_ref);
672}
673
674/**
675 * @}
676 */
Note: See TracBrowser for help on using the repository browser.