Modify the length of a file, as the intermittently available truncate Unix utility/function.
When length and adjust are not set an empty file is created.
Table B.67: Attributes
| Name | Type | Description | Default | Required |
|---|---|---|---|---|
file
|
String
| The name of the file. | n/a | Yes |
length
|
String
| Specifies the file size. Examples: 5000B, 250K,
1M.
| n/a | No |
adjust
|
String
| The value to increase or decrease (if you specify a negative value) the size of a file.
Examples: -100, 250B, 4K.
| n/a | No |
create
|
Boolean
| Whether to create nonexistent files. |
true
| No |
mkdirs
|
Boolean
| Whether to create nonexistent parent directories when creating new files. |
false
| No |
File size can be written using IEC and SI suffixes, bytes are assumed when suffix is not specified. The following suffixes (case-insensitive) are supported:
Table B.68: Supported file size suffixes
| Standard | Suffixes | Equivalence |
|---|---|---|
| IEC | B.
| 1 byte |
K, Ki, KiB,
kibi, kibibyte.
| 1024 bytes | |
M, Mi, MiB,
mebi, mebibyte.
| 1024 kibibytes | |
G, Gi, GiB,
gibi, gibibyte.
| 1024 mebibytes | |
T, Ti, TiB,
tebi, tebibyte.
| 1024 gibibytes | |
| SI |
kB, kilo, kilobyte.
| 1000 bytes |
MB, mega, megabyte.
| 1000 kilobytes | |
GB, giga, gigabyte.
| 1000 megabytes | |
TB, tera, terabyte.
| 1000 gigabytes |