source: mainline/uspace/lib/ext4/libext4_balloc.c@ 3495654

lfn serial ticket/834-toolchain-update topic/msim-upgrade topic/simplify-dev-export
Last change on this file since 3495654 was 38542dc, checked in by Martin Decky <martin@…>, 13 years ago

ext4 code review and coding style cleanup
  • Property mode set to 100644
File size: 18.7 KB
Line 
1/*
2 * Copyright (c) 2012 Frantisek Princ
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 libext4
30 * @{
31 */
32/**
33 * @file libext4_balloc.c
34 * @brief Physical block allocator.
35 */
36
37#include <errno.h>
38#include <sys/types.h>
39#include "libext4.h"
40
41/** Compute number of block group from block address.
42 *
43 * @param sb Superblock pointer.
44 * @param block_addr Absolute address of block.
45 *
46 * @return Block group index
47 *
48 */
49static uint32_t ext4_balloc_get_bgid_of_block(ext4_superblock_t *sb,
50 uint32_t block_addr)
51{
52 uint32_t blocks_per_group =
53 ext4_superblock_get_blocks_per_group(sb);
54 uint32_t first_block =
55 ext4_superblock_get_first_data_block(sb);
56
57 /* First block == 0 or 1 */
58 if (first_block == 0)
59 return block_addr / blocks_per_group;
60 else
61 return (block_addr - 1) / blocks_per_group;
62}
63
64/** Free block.
65 *
66 * @param inode_ref Inode, where the block is allocated
67 * @param block_addr Absolute block address to free
68 *
69 * @return Error code
70 *
71 */
72int ext4_balloc_free_block(ext4_inode_ref_t *inode_ref, uint32_t block_addr)
73{
74 ext4_filesystem_t *fs = inode_ref->fs;
75 ext4_superblock_t *sb = fs->superblock;
76
77 /* Compute indexes */
78 uint32_t block_group = ext4_balloc_get_bgid_of_block(sb, block_addr);
79 uint32_t index_in_group =
80 ext4_filesystem_blockaddr2_index_in_group(sb, block_addr);
81
82 /* Load block group reference */
83 ext4_block_group_ref_t *bg_ref;
84 int rc = ext4_filesystem_get_block_group_ref(fs, block_group, &bg_ref);
85 if (rc != EOK)
86 return rc;
87
88 /* Load block with bitmap */
89 uint32_t bitmap_block_addr =
90 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
91 block_t *bitmap_block;
92 rc = block_get(&bitmap_block, fs->device, bitmap_block_addr, 0);
93 if (rc != EOK)
94 return rc;
95
96 /* Modify bitmap */
97 ext4_bitmap_free_bit(bitmap_block->data, index_in_group);
98 bitmap_block->dirty = true;
99
100 /* Release block with bitmap */
101 rc = block_put(bitmap_block);
102 if (rc != EOK) {
103 /* Error in saving bitmap */
104 ext4_filesystem_put_block_group_ref(bg_ref);
105 return rc;
106 }
107
108 uint32_t block_size = ext4_superblock_get_block_size(sb);
109
110 /* Update superblock free blocks count */
111 uint32_t sb_free_blocks =
112 ext4_superblock_get_free_blocks_count(sb);
113 sb_free_blocks++;
114 ext4_superblock_set_free_blocks_count(sb, sb_free_blocks);
115
116 /* Update inode blocks count */
117 uint64_t ino_blocks =
118 ext4_inode_get_blocks_count(sb, inode_ref->inode);
119 ino_blocks -= block_size / EXT4_INODE_BLOCK_SIZE;
120 ext4_inode_set_blocks_count(sb, inode_ref->inode, ino_blocks);
121 inode_ref->dirty = true;
122
123 /* Update block group free blocks count */
124 uint32_t free_blocks =
125 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
126 free_blocks++;
127 ext4_block_group_set_free_blocks_count(bg_ref->block_group,
128 sb, free_blocks);
129 bg_ref->dirty = true;
130
131 /* Release block group reference */
132 rc = ext4_filesystem_put_block_group_ref(bg_ref);
133 if (rc != EOK)
134 return rc;
135
136 return EOK;
137}
138
139/** Free continuous set of blocks.
140 *
141 * @param inode_ref Inode, where the blocks are allocated
142 * @param first First block to release
143 * @param count Number of blocks to release
144 *
145 */
146int ext4_balloc_free_blocks(ext4_inode_ref_t *inode_ref,
147 uint32_t first, uint32_t count)
148{
149 ext4_filesystem_t *fs = inode_ref->fs;
150 ext4_superblock_t *sb = fs->superblock;
151
152 /* Compute indexes */
153 uint32_t block_group_first =
154 ext4_balloc_get_bgid_of_block(sb, first);
155 uint32_t block_group_last =
156 ext4_balloc_get_bgid_of_block(sb, first + count - 1);
157
158 assert(block_group_first == block_group_last);
159
160 /* Load block group reference */
161 ext4_block_group_ref_t *bg_ref;
162 int rc = ext4_filesystem_get_block_group_ref(fs, block_group_first, &bg_ref);
163 if (rc != EOK)
164 return rc;
165
166 uint32_t index_in_group_first =
167 ext4_filesystem_blockaddr2_index_in_group(sb, first);
168
169 /* Load block with bitmap */
170 uint32_t bitmap_block_addr =
171 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
172
173 block_t *bitmap_block;
174 rc = block_get(&bitmap_block, fs->device, bitmap_block_addr, 0);
175 if (rc != EOK)
176 return rc;
177
178 /* Modify bitmap */
179 ext4_bitmap_free_bits(bitmap_block->data, index_in_group_first, count);
180 bitmap_block->dirty = true;
181
182 /* Release block with bitmap */
183 rc = block_put(bitmap_block);
184 if (rc != EOK) {
185 /* Error in saving bitmap */
186 ext4_filesystem_put_block_group_ref(bg_ref);
187 return rc;
188 }
189
190 uint32_t block_size = ext4_superblock_get_block_size(sb);
191
192 /* Update superblock free blocks count */
193 uint32_t sb_free_blocks =
194 ext4_superblock_get_free_blocks_count(sb);
195 sb_free_blocks += count;
196 ext4_superblock_set_free_blocks_count(sb, sb_free_blocks);
197
198 /* Update inode blocks count */
199 uint64_t ino_blocks =
200 ext4_inode_get_blocks_count(sb, inode_ref->inode);
201 ino_blocks -= count * (block_size / EXT4_INODE_BLOCK_SIZE);
202 ext4_inode_set_blocks_count(sb, inode_ref->inode, ino_blocks);
203 inode_ref->dirty = true;
204
205 /* Update block group free blocks count */
206 uint32_t free_blocks =
207 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
208 free_blocks += count;
209 ext4_block_group_set_free_blocks_count(bg_ref->block_group,
210 sb, free_blocks);
211 bg_ref->dirty = true;
212
213 /* Release block group reference */
214 rc = ext4_filesystem_put_block_group_ref(bg_ref);
215 if (rc != EOK)
216 return rc;
217
218 return EOK;
219}
220
221/** Compute first block for data in block group.
222 *
223 * @param sb Pointer to superblock
224 * @param bg Pointer to block group
225 * @param bgid Index of block group
226 *
227 * @return Absolute block index of first block
228 *
229 */
230uint32_t ext4_balloc_get_first_data_block_in_group(ext4_superblock_t *sb,
231 ext4_block_group_ref_t *bg_ref)
232{
233 uint32_t block_group_count = ext4_superblock_get_block_group_count(sb);
234 uint32_t inode_table_first_block =
235 ext4_block_group_get_inode_table_first_block(bg_ref->block_group, sb);
236 uint16_t inode_table_item_size = ext4_superblock_get_inode_size(sb);
237 uint32_t inodes_per_group = ext4_superblock_get_inodes_per_group(sb);
238 uint32_t block_size = ext4_superblock_get_block_size(sb);
239 uint32_t inode_table_bytes;
240
241 if (bg_ref->index < block_group_count - 1) {
242 inode_table_bytes = inodes_per_group * inode_table_item_size;
243 } else {
244 /* Last block group could be smaller */
245 uint32_t inodes_count_total = ext4_superblock_get_inodes_count(sb);
246 inode_table_bytes =
247 (inodes_count_total - ((block_group_count - 1) * inodes_per_group)) *
248 inode_table_item_size;
249 }
250
251 uint32_t inode_table_blocks = inode_table_bytes / block_size;
252
253 if (inode_table_bytes % block_size)
254 inode_table_blocks++;
255
256 return inode_table_first_block + inode_table_blocks;
257}
258
259/** Compute 'goal' for allocation algorithm.
260 *
261 * @param inode_ref Reference to inode, to allocate block for
262 *
263 * @return Goal block number
264 *
265 */
266static uint32_t ext4_balloc_find_goal(ext4_inode_ref_t *inode_ref)
267{
268 uint32_t goal = 0;
269
270 ext4_superblock_t *sb = inode_ref->fs->superblock;
271
272 uint64_t inode_size = ext4_inode_get_size(sb, inode_ref->inode);
273 uint32_t block_size = ext4_superblock_get_block_size(sb);
274 uint32_t inode_block_count = inode_size / block_size;
275
276 if (inode_size % block_size != 0)
277 inode_block_count++;
278
279 /* If inode has some blocks, get last block address + 1 */
280 if (inode_block_count > 0) {
281 int rc = ext4_filesystem_get_inode_data_block_index(inode_ref,
282 inode_block_count - 1, &goal);
283 if (rc != EOK)
284 return 0;
285
286 if (goal != 0) {
287 goal++;
288 return goal;
289 }
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 block_size = ext4_superblock_get_block_size(sb);
298
299 /* Load block group reference */
300 ext4_block_group_ref_t *bg_ref;
301 int rc = ext4_filesystem_get_block_group_ref(inode_ref->fs,
302 block_group, &bg_ref);
303 if (rc != EOK)
304 return 0;
305
306 /* Compute indexes */
307 uint32_t block_group_count = ext4_superblock_get_block_group_count(sb);
308 uint32_t inode_table_first_block =
309 ext4_block_group_get_inode_table_first_block(bg_ref->block_group, sb);
310 uint16_t inode_table_item_size = ext4_superblock_get_inode_size(sb);
311 uint32_t inode_table_bytes;
312
313 /* Check for last block group */
314 if (block_group < block_group_count - 1) {
315 inode_table_bytes = inodes_per_group * inode_table_item_size;
316 } else {
317 /* Last block group could be smaller */
318 uint32_t inodes_count_total = ext4_superblock_get_inodes_count(sb);
319 inode_table_bytes =
320 (inodes_count_total - ((block_group_count - 1) * inodes_per_group)) *
321 inode_table_item_size;
322 }
323
324 uint32_t inode_table_blocks = inode_table_bytes / block_size;
325
326 if (inode_table_bytes % block_size)
327 inode_table_blocks++;
328
329 goal = inode_table_first_block + inode_table_blocks;
330
331 ext4_filesystem_put_block_group_ref(bg_ref);
332
333 return goal;
334}
335
336/** Data block allocation algorithm.
337 *
338 * @param inode_ref Inode to allocate block for
339 * @param fblock Allocated block address
340 *
341 * @return Error code
342 *
343 */
344int ext4_balloc_alloc_block(ext4_inode_ref_t *inode_ref, uint32_t *fblock)
345{
346 uint32_t allocated_block = 0;
347
348 uint32_t bitmap_block_addr;
349 block_t *bitmap_block;
350 uint32_t rel_block_idx = 0;
351
352 /* Find GOAL */
353 uint32_t goal = ext4_balloc_find_goal(inode_ref);
354 if (goal == 0) {
355 /* no goal found => partition is full */
356 return ENOSPC;
357 }
358
359 ext4_superblock_t *sb = inode_ref->fs->superblock;
360
361 /* Load block group number for goal and relative index */
362 uint32_t block_group = ext4_balloc_get_bgid_of_block(sb, goal);
363 uint32_t index_in_group =
364 ext4_filesystem_blockaddr2_index_in_group(sb, goal);
365
366 /* Load block group reference */
367 ext4_block_group_ref_t *bg_ref;
368 int rc = ext4_filesystem_get_block_group_ref(inode_ref->fs,
369 block_group, &bg_ref);
370 if (rc != EOK)
371 return rc;
372
373 /* Compute indexes */
374 uint32_t first_in_group =
375 ext4_balloc_get_first_data_block_in_group(sb, bg_ref);
376
377 uint32_t first_in_group_index =
378 ext4_filesystem_blockaddr2_index_in_group(sb, first_in_group);
379
380 if (index_in_group < first_in_group_index)
381 index_in_group = first_in_group_index;
382
383 /* Load block with bitmap */
384 bitmap_block_addr =
385 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
386
387 rc = block_get(&bitmap_block, inode_ref->fs->device,
388 bitmap_block_addr, BLOCK_FLAGS_NONE);
389 if (rc != EOK) {
390 ext4_filesystem_put_block_group_ref(bg_ref);
391 return rc;
392 }
393
394 /* Check if goal is free */
395 if (ext4_bitmap_is_free_bit(bitmap_block->data, index_in_group)) {
396 ext4_bitmap_set_bit(bitmap_block->data, index_in_group);
397 bitmap_block->dirty = true;
398 rc = block_put(bitmap_block);
399 if (rc != EOK) {
400 ext4_filesystem_put_block_group_ref(bg_ref);
401 return rc;
402 }
403
404 allocated_block =
405 ext4_filesystem_index_in_group2blockaddr(sb, index_in_group,
406 block_group);
407
408 goto success;
409 }
410
411 uint32_t blocks_in_group =
412 ext4_superblock_get_blocks_in_group(sb, block_group);
413
414 uint32_t end_idx = (index_in_group + 63) & ~63;
415 if (end_idx > blocks_in_group)
416 end_idx = blocks_in_group;
417
418 /* Try to find free block near to goal */
419 for (uint32_t tmp_idx = index_in_group + 1; tmp_idx < end_idx;
420 ++tmp_idx) {
421 if (ext4_bitmap_is_free_bit(bitmap_block->data, tmp_idx)) {
422 ext4_bitmap_set_bit(bitmap_block->data, tmp_idx);
423 bitmap_block->dirty = true;
424 rc = block_put(bitmap_block);
425 if (rc != EOK)
426 return rc;
427
428 allocated_block =
429 ext4_filesystem_index_in_group2blockaddr(sb, tmp_idx,
430 block_group);
431
432 goto success;
433 }
434 }
435
436 /* Find free BYTE in bitmap */
437 rc = ext4_bitmap_find_free_byte_and_set_bit(bitmap_block->data,
438 index_in_group, &rel_block_idx, blocks_in_group);
439 if (rc == EOK) {
440 bitmap_block->dirty = true;
441 rc = block_put(bitmap_block);
442 if (rc != EOK)
443 return rc;
444
445 allocated_block =
446 ext4_filesystem_index_in_group2blockaddr(sb, rel_block_idx,
447 block_group);
448
449 goto success;
450 }
451
452 /* Find free bit in bitmap */
453 rc = ext4_bitmap_find_free_bit_and_set(bitmap_block->data,
454 index_in_group, &rel_block_idx, blocks_in_group);
455 if (rc == EOK) {
456 bitmap_block->dirty = true;
457 rc = block_put(bitmap_block);
458 if (rc != EOK)
459 return rc;
460
461 allocated_block =
462 ext4_filesystem_index_in_group2blockaddr(sb, rel_block_idx,
463 block_group);
464
465 goto success;
466 }
467
468 /* No free block found yet */
469 block_put(bitmap_block);
470 ext4_filesystem_put_block_group_ref(bg_ref);
471
472 /* Try other block groups */
473 uint32_t block_group_count = ext4_superblock_get_block_group_count(sb);
474
475 uint32_t bgid = (block_group + 1) % block_group_count;
476 uint32_t count = block_group_count;
477
478 while (count > 0) {
479 rc = ext4_filesystem_get_block_group_ref(inode_ref->fs, bgid,
480 &bg_ref);
481 if (rc != EOK)
482 return rc;
483
484 /* Load block with bitmap */
485 bitmap_block_addr =
486 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
487
488 rc = block_get(&bitmap_block, inode_ref->fs->device,
489 bitmap_block_addr, 0);
490 if (rc != EOK) {
491 ext4_filesystem_put_block_group_ref(bg_ref);
492 return rc;
493 }
494
495 /* Compute indexes */
496 first_in_group =
497 ext4_balloc_get_first_data_block_in_group(sb, bg_ref);
498 index_in_group =
499 ext4_filesystem_blockaddr2_index_in_group(sb, first_in_group);
500 blocks_in_group = ext4_superblock_get_blocks_in_group(sb, bgid);
501
502 first_in_group_index =
503 ext4_filesystem_blockaddr2_index_in_group(sb, first_in_group);
504
505 if (index_in_group < first_in_group_index)
506 index_in_group = first_in_group_index;
507
508 /* Try to find free byte in bitmap */
509 rc = ext4_bitmap_find_free_byte_and_set_bit(bitmap_block->data,
510 index_in_group, &rel_block_idx, blocks_in_group);
511 if (rc == EOK) {
512 bitmap_block->dirty = true;
513 rc = block_put(bitmap_block);
514 if (rc != EOK)
515 return rc;
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 return rc;
532
533 allocated_block =
534 ext4_filesystem_index_in_group2blockaddr(sb, rel_block_idx,
535 bgid);
536
537 goto success;
538 }
539
540 block_put(bitmap_block);
541 ext4_filesystem_put_block_group_ref(bg_ref);
542
543 /* Goto next group */
544 bgid = (bgid + 1) % block_group_count;
545 count--;
546 }
547
548 return ENOSPC;
549
550success:
551 /* Empty command - because of syntax */
552 ;
553
554 uint32_t block_size = ext4_superblock_get_block_size(sb);
555
556 /* Update superblock free blocks count */
557 uint32_t sb_free_blocks = ext4_superblock_get_free_blocks_count(sb);
558 sb_free_blocks--;
559 ext4_superblock_set_free_blocks_count(sb, sb_free_blocks);
560
561 /* Update inode blocks (different block size!) count */
562 uint64_t ino_blocks =
563 ext4_inode_get_blocks_count(sb, inode_ref->inode);
564 ino_blocks += block_size / EXT4_INODE_BLOCK_SIZE;
565 ext4_inode_set_blocks_count(sb, inode_ref->inode, ino_blocks);
566 inode_ref->dirty = true;
567
568 /* Update block group free blocks count */
569 uint32_t bg_free_blocks =
570 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
571 bg_free_blocks--;
572 ext4_block_group_set_free_blocks_count(bg_ref->block_group, sb,
573 bg_free_blocks);
574 bg_ref->dirty = true;
575
576 ext4_filesystem_put_block_group_ref(bg_ref);
577
578 *fblock = allocated_block;
579 return EOK;
580}
581
582/** Try to allocate concrete block.
583 *
584 * @param inode_ref Inode to allocate block for
585 * @param fblock Block address to allocate
586 * @param free Output value - if target block is free
587 *
588 * @return Error code
589 *
590 */
591int ext4_balloc_try_alloc_block(ext4_inode_ref_t *inode_ref, uint32_t fblock,
592 bool *free)
593{
594 int rc = EOK;
595
596 ext4_filesystem_t *fs = inode_ref->fs;
597 ext4_superblock_t *sb = fs->superblock;
598
599 /* Compute indexes */
600 uint32_t block_group = ext4_balloc_get_bgid_of_block(sb, fblock);
601 uint32_t index_in_group =
602 ext4_filesystem_blockaddr2_index_in_group(sb, fblock);
603
604 /* Load block group reference */
605 ext4_block_group_ref_t *bg_ref;
606 rc = ext4_filesystem_get_block_group_ref(fs, block_group, &bg_ref);
607 if (rc != EOK)
608 return rc;
609
610 /* Load block with bitmap */
611 uint32_t bitmap_block_addr =
612 ext4_block_group_get_block_bitmap(bg_ref->block_group, sb);
613 block_t *bitmap_block;
614 rc = block_get(&bitmap_block, fs->device, bitmap_block_addr, 0);
615 if (rc != EOK)
616 return rc;
617
618 /* Check if block is free */
619 *free = ext4_bitmap_is_free_bit(bitmap_block->data, index_in_group);
620
621 /* Allocate block if possible */
622 if (*free) {
623 ext4_bitmap_set_bit(bitmap_block->data, index_in_group);
624 bitmap_block->dirty = true;
625 }
626
627 /* Release block with bitmap */
628 rc = block_put(bitmap_block);
629 if (rc != EOK) {
630 /* Error in saving bitmap */
631 ext4_filesystem_put_block_group_ref(bg_ref);
632 return rc;
633 }
634
635 /* If block is not free, return */
636 if (!(*free))
637 goto terminate;
638
639 uint32_t block_size = ext4_superblock_get_block_size(sb);
640
641 /* Update superblock free blocks count */
642 uint32_t sb_free_blocks = ext4_superblock_get_free_blocks_count(sb);
643 sb_free_blocks--;
644 ext4_superblock_set_free_blocks_count(sb, sb_free_blocks);
645
646 /* Update inode blocks count */
647 uint64_t ino_blocks =
648 ext4_inode_get_blocks_count(sb, inode_ref->inode);
649 ino_blocks += block_size / EXT4_INODE_BLOCK_SIZE;
650 ext4_inode_set_blocks_count(sb, inode_ref->inode, ino_blocks);
651 inode_ref->dirty = true;
652
653 /* Update block group free blocks count */
654 uint32_t free_blocks =
655 ext4_block_group_get_free_blocks_count(bg_ref->block_group, sb);
656 free_blocks--;
657 ext4_block_group_set_free_blocks_count(bg_ref->block_group,
658 sb, free_blocks);
659 bg_ref->dirty = true;
660
661terminate:
662 return ext4_filesystem_put_block_group_ref(bg_ref);
663}
664
665/**
666 * @}
667 */
Note: See TracBrowser for help on using the repository browser.