source: rtems-central/spec/acfg/opt/RTEMS-ACFG-OPT-IMFSMEMFILEBYTESPERBLOCK.yml @ 64987c4

Last change on this file since 64987c4 was 64987c4, checked in by Sebastian Huber <sebastian.huber@…>, on 03/17/20 at 09:06:27

spec: Add application configuration

  • Property mode set to 100644
File size: 2.2 KB
Line 
1SPDX-License-Identifier: CC-BY-SA-4.0
2active: true
3appl-config-option-data-type: |
4  Boolean feature macro.
5appl-config-option-default-value: |
6  The default IMFS block size is 128 bytes.
7appl-config-option-description: |
8  This configuration parameter specifies the block size for in-memory files
9  managed by the IMFS. The configured block size has two impacts. The first
10  is the average amount of unused memory in the last block of each file. For
11  example, when the block size is 512, on average one-half of the last block
12  of each file will remain unused and the memory is wasted. In contrast, when
13  the block size is 16, the average unused memory per file is only 8
14  bytes. However, it requires more allocations for the same size file and
15  thus more overhead per block for the dynamic memory management.
16
17  Second, the block size has an impact on the maximum size file that can be
18  stored in the IMFS. With smaller block size, the maximum file size is
19  correspondingly smaller. The following shows the maximum file size possible
20  based on the configured block size:
21
22  - when the block size is 16 bytes, the maximum file size is 1,328 bytes.
23
24  - when the block size is 32 bytes, the maximum file size is 18,656 bytes.
25
26  - when the block size is 64 bytes, the maximum file size is 279,488 bytes.
27
28  - when the block size is 128 bytes, the maximum file size is 4,329,344 bytes.
29
30  - when the block size is 256 bytes, the maximum file size is 68,173,568 bytes.
31
32  - when the block size is 512 bytes, the maximum file size is 1,082,195,456
33    bytes.
34appl-config-option-index: []
35appl-config-option-name: CONFIGURE_IMFS_MEMFILE_BYTES_PER_BLOCK
36appl-config-option-notes: |
37  None.
38appl-config-option-range: |
39  Valid values for this configuration parameter are a power of two (2)
40  between 16 and 512 inclusive.  In other words, valid values are 16, 32, 64,
41  128, 256,and 512.
42copyrights:
43- Copyright (C) 1988, 2008 On-Line Applications Research Corporation (OAR)
44derived: false
45enabled-by: []
46header: ''
47interface-type: appl-config-option
48level: 1.64
49links:
50- RTEMS-ACFG-FILESYSTEM: 9RfguldyRuN5UR-zcLUoiTYBDzow1fnI4B_ZnP_UyKk=
51normative: true
52ref: ''
53reviewed: iA2QqUff1w3cWEYU5hSqcvelHFH2rdGHHEb8TCVHTdQ=
54text: ''
55type: interface
Note: See TracBrowser for help on using the repository browser.