@@ -2446,6 +2446,14 @@ static struct tst_test test = {
};
-------------------------------------------------------------------------------
+1.44 Path to the temporary directory
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+'tst_get_tmpdir()' returns a path to the test temporary directory in a newly
+allocated buffer. Therefore it's needed to either 1) call it only once in the setup,
+or 2) free the variable after use if it's reused (i.e. run in the test function).
+Alternatively '"."' (relative path) can be used (test chdir to the temporary directory).
+
2. Common problems
------------------
@@ -126,6 +126,8 @@ New test should
* When rewriting old tests, https://en.wikipedia.org/wiki/%CE%9CClinux[uClinux]
support should be removed (project has been discontinued).
E.g. remove `#ifdef UCLINUX`, replace `FORK_OR_VFORK()` with simple `fork()` or `SAFE_FORK()`.
+* 'tst_get_tmpdir()' should be called in the setup function or the variable must be freed after use
+ (more in https://github.com/linux-test-project/ltp/wiki/C-Test-API#144-path-to-the-temporary-directory[C API]).
### Shell tests
* Use new https://github.com/linux-test-project/ltp/wiki/Test-Writing-Guidelines#23-writing-a-testcase-in-shell[shell API]
Signed-off-by: Petr Vorel <pvorel@suse.cz> --- doc/C-Test-API.asciidoc | 8 ++++++++ doc/Maintainer-Patch-Review-Checklist.asciidoc | 2 ++ 2 files changed, 10 insertions(+)