[LTP] [PATCH v2] Add documentation for tst_parse_* helpers functions
Andrea Cervesato
andrea.cervesato@suse.com
Thu Dec 9 11:28:55 CET 2021
Signed-off-by: Andrea Cervesato <andrea.cervesato@suse.com>
---
doc/c-test-api.txt | 12 +++++++++---
1 file changed, 9 insertions(+), 3 deletions(-)
diff --git a/doc/c-test-api.txt b/doc/c-test-api.txt
index 64d0630ce..90935e5a0 100644
--- a/doc/c-test-api.txt
+++ b/doc/c-test-api.txt
@@ -457,18 +457,24 @@ NOTE: The test parameters must not collide with common test parameters defined
[source,c]
-------------------------------------------------------------------------------
int tst_parse_int(const char *str, int *val, int min, int max);
+int tst_parse_long(const char *str, long *val, long min, long max);
int tst_parse_float(const char *str, float *val, float min, float max);
+int tst_parse_filesize(const char *str, long long *val, long long min, long long max);
-------------------------------------------------------------------------------
Helpers for parsing the strings returned in the 'struct tst_option'.
-Both return zero on success and 'errno', mostly 'EINVAL' or 'ERANGE', on
+Helpers return zero on success and 'errno', mostly 'EINVAL' or 'ERANGE', on
failure.
-Both functions are no-op if 'str' is 'NULL'.
+Helpers functions are no-op if 'str' is 'NULL'.
The valid range for result includes both 'min' and 'max'.
+In particular, 'tst_parse_filesize' function accepts prefix multiplies such as
+"k/K for kilobytes, "m/M" for megabytes and "g/G" for gigabytes. For example,
+10K are converted into 10240 bytes.
+
.Example Usage
[source,c]
-------------------------------------------------------------------------------
@@ -481,7 +487,7 @@ static int threads = 10;
static struct tst_option options[] = {
{"t:", &str_threads, "Number of threads (default 10)"},
...
- {NULL, NULL, NULL}
+ {}
};
static void setup(void)
--
2.34.1
More information about the ltp
mailing list