| /* |
| * Copyright (c) 2000 Silicon Graphics, Inc. All Rights Reserved. |
| * Copyright (c) 2009-2013 Cyril Hrubis chrubis@suse.cz |
| * |
| * This program is free software; you can redistribute it and/or modify it |
| * under the terms of version 2 of the GNU General Public License as |
| * published by the Free Software Foundation. |
| * |
| * This program is distributed in the hope that it would be useful, but |
| * WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
| * |
| * Further, this software is distributed without any warranty that it is |
| * free of the rightful claim of any third person regarding infringement |
| * or the like. Any license provided herein, whether implied or |
| * otherwise, applies only to this software file. Patent licenses, if |
| * any, provided herein do not apply to combinations of this program with |
| * other software, or any other product whatsoever. |
| * |
| * You should have received a copy of the GNU General Public License along |
| * with this program; if not, write the Free Software Foundation, Inc., |
| * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy, |
| * Mountain View, CA 94043, or: |
| * |
| * http://www.sgi.com |
| * |
| * For further information regarding this notice, see: |
| * |
| * http://oss.sgi.com/projects/GenInfo/NoticeExplan/ |
| */ |
| |
| #ifndef __TEST_H__ |
| #define __TEST_H__ |
| |
| #include <stdio.h> |
| #include <signal.h> |
| #include <unistd.h> |
| #include <string.h> |
| #include <stdlib.h> |
| #include <stdint.h> |
| |
| #include "usctest.h" |
| |
| #include "tst_common.h" |
| #include "old_safe_file_ops.h" |
| #include "old_checkpoint.h" |
| #include "tst_process_state.h" |
| #include "old_resource.h" |
| #include "tst_res_flags.h" |
| #include "tst_timer.h" |
| #include "tst_kvercmp.h" |
| #include "tst_fs.h" |
| #include "tst_pid.h" |
| #include "tst_cmd.h" |
| #include "tst_cpu.h" |
| #include "old_device.h" |
| #include "old_tmpdir.h" |
| |
| /* |
| * Ensure that NUMSIGS is defined. |
| * It should be defined in signal.h or sys/signal.h on |
| * UNICOS/mk and IRIX systems. On UNICOS systems, |
| * it is not defined, thus it is being set to UNICOS's NSIG. |
| * Note: IRIX's NSIG (signals are 1-(NSIG-1)) |
| * is not same meaning as UNICOS/UMK's NSIG (signals 1-NSIG) |
| */ |
| #ifndef NUMSIGS |
| #define NUMSIGS NSIG |
| #endif |
| |
| |
| /* defines for unexpected signal setup routine (set_usig.c) */ |
| #define FORK 1 /* SIGCLD is to be ignored */ |
| #define NOFORK 0 /* SIGCLD is to be caught */ |
| #define DEF_HANDLER SIG_ERR /* tells set_usig() to use default signal handler */ |
| |
| /* |
| * The following defines are used to control tst_res and t_result reporting. |
| */ |
| |
| #define TOUTPUT "TOUTPUT" /* The name of the environment variable */ |
| /* that can be set to one of the following */ |
| /* strings to control tst_res output */ |
| /* If not set, TOUT_VERBOSE_S is assumed */ |
| |
| /* |
| * fork() can't be used on uClinux systems, so use FORK_OR_VFORK instead, |
| * which will run vfork() on uClinux. |
| * mmap() doesn't support MAP_PRIVATE on uClinux systems, so use |
| * MAP_PRIVATE_EXCEPT_UCLINUX instead, which will skip the option on uClinux. |
| * If MAP_PRIVATE really is required, the test can not be run on uClinux. |
| */ |
| #ifdef UCLINUX |
| # define FORK_OR_VFORK tst_vfork |
| # define MAP_PRIVATE_EXCEPT_UCLINUX 0 |
| /* tst_flush() + vfork() */ |
| pid_t tst_vfork(void); |
| #else |
| # define FORK_OR_VFORK tst_fork |
| # define MAP_PRIVATE_EXCEPT_UCLINUX MAP_PRIVATE |
| #endif |
| |
| /* |
| * Macro to use for making functions called only once in |
| * multi-threaded tests such as init or cleanup function. |
| * The first call to @name_fn function by any thread shall |
| * call the @exec_fn. Subsequent calls shall not call @exec_fn. |
| * *_fn functions must not take any arguments. |
| */ |
| #define TST_DECLARE_ONCE_FN(name_fn, exec_fn) \ |
| void name_fn(void) \ |
| { \ |
| static pthread_once_t ltp_once = PTHREAD_ONCE_INIT; \ |
| pthread_once(<p_once, exec_fn); \ |
| } |
| |
| /* |
| * lib/forker.c |
| */ |
| extern int Forker_pids[]; |
| extern int Forker_npids; |
| |
| typedef struct { |
| char *option; /* Valid option string (one option only) like "a:" */ |
| int *flag; /* Pointer to location to set true if option given */ |
| char **arg; /* Pointer to location to place argument, if needed */ |
| } option_t; |
| |
| /* lib/tst_parse_opts.c */ |
| void tst_parse_opts(int argc, char *argv[], const option_t *user_optarg, |
| void (*user_help)(void)); |
| |
| /* lib/tst_res.c */ |
| const char *strttype(int ttype); |
| |
| void tst_resm_(const char *file, const int lineno, int ttype, |
| const char *arg_fmt, ...) |
| __attribute__ ((format (printf, 4, 5))); |
| #define tst_resm(ttype, arg_fmt, ...) \ |
| tst_resm_(__FILE__, __LINE__, (ttype), \ |
| (arg_fmt), ##__VA_ARGS__) |
| |
| void tst_resm_hexd_(const char *file, const int lineno, int ttype, |
| const void *buf, size_t size, const char *arg_fmt, ...) |
| __attribute__ ((format (printf, 6, 7))); |
| #define tst_resm_hexd(ttype, buf, size, arg_fmt, ...) \ |
| tst_resm_hexd_(__FILE__, __LINE__, (ttype), (buf), (size), \ |
| (arg_fmt), ##__VA_ARGS__) |
| |
| void tst_brkm_(const char *file, const int lineno, int ttype, |
| void (*func)(void), const char *arg_fmt, ...) |
| __attribute__ ((format (printf, 5, 6))) LTP_ATTRIBUTE_NORETURN; |
| #define tst_brkm(ttype, func, arg_fmt, ...) \ |
| tst_brkm_(__FILE__, __LINE__, (ttype), (func), \ |
| (arg_fmt), ##__VA_ARGS__) |
| |
| void tst_require_root(void); |
| void tst_exit(void) LTP_ATTRIBUTE_NORETURN; |
| void tst_flush(void); |
| |
| /* |
| * tst_flush() + fork |
| * NOTE: tst_fork() will reset T_exitval to 0 for child process. |
| */ |
| pid_t tst_fork(void); |
| |
| /* lib/tst_res.c */ |
| /* |
| * In case we need do real test work in child process parent process can use |
| * tst_record_childstatus() to make child process's test results propagated to |
| * parent process correctly. |
| * |
| * The child can use tst_resm(), tst_brkm() followed by the tst_exit() or |
| * plain old exit() (with TPASS, TFAIL and TBROK). |
| * |
| * WARNING: Be wary that the child cleanup function passed to tst_brkm() |
| * must clean only resources the child has allocated. E.g. the |
| * child cleanup is different function from the parent cleanup. |
| */ |
| void tst_record_childstatus(void (*cleanup)(void), pid_t child); |
| |
| extern int tst_count; |
| |
| /* lib/tst_sig.c */ |
| void tst_sig(int fork_flag, void (*handler)(), void (*cleanup)()); |
| |
| /* lib/get_high_address.c */ |
| char *get_high_address(void); |
| |
| /* lib/self_exec.c */ |
| void maybe_run_child(void (*child)(), const char *fmt, ...); |
| int self_exec(const char *argv0, const char *fmt, ...); |
| |
| /* Functions from lib/cloner.c */ |
| int ltp_clone(unsigned long flags, int (*fn)(void *arg), void *arg, |
| size_t stack_size, void *stack); |
| int ltp_clone7(unsigned long flags, int (*fn)(void *arg), void *arg, |
| size_t stack_size, void *stack, ...); |
| int ltp_clone_malloc(unsigned long clone_flags, int (*fn)(void *arg), |
| void *arg, size_t stacksize); |
| int ltp_clone_quick(unsigned long clone_flags, int (*fn)(void *arg), |
| void *arg); |
| #define clone(...) use_the_ltp_clone_functions,do_not_use_clone |
| |
| |
| /* lib/tst_mkfs.c |
| * |
| * @dev: path to a device |
| * @fs_type: filesystem type |
| * @fs_opts: NULL or NULL terminated array of mkfs options |
| * @extra_opt: extra mkfs option which is passed after the device name |
| */ |
| void tst_mkfs(void (cleanup_fn)(void), const char *dev, |
| const char *fs_type, const char *const fs_opts[], |
| const char *extra_opt); |
| |
| /* lib/tst_net.c |
| * |
| * Return unused port |
| */ |
| unsigned short tst_get_unused_port(void (cleanup_fn)(void), |
| unsigned short family, int type); |
| |
| /* lib/tst_res.c |
| * tst_strsig converts signal's value to corresponding string. |
| * tst_strerrno converts errno to corresponding string. |
| */ |
| const char *tst_strsig(int sig); |
| const char *tst_strerrno(int err); |
| |
| /* lib/tst_path_has_mnt_flags.c |
| * |
| * Check whether a path is on a filesystem that is mounted with |
| * specified flags |
| * @path: path to file, if path is NULL tst_tmpdir is used. |
| * @flags: NULL or NULL terminated array of mount flags |
| * |
| * Return: 0..n - number of flags matched |
| */ |
| int tst_path_has_mnt_flags(void (cleanup_fn)(void), |
| const char *path, const char *flags[]); |
| |
| #ifdef TST_USE_COMPAT16_SYSCALL |
| #define TCID_BIT_SUFFIX "_16" |
| #elif TST_USE_NEWER64_SYSCALL |
| #define TCID_BIT_SUFFIX "_64" |
| #else |
| #define TCID_BIT_SUFFIX "" |
| #endif |
| #define TCID_DEFINE(ID) char *TCID = (#ID TCID_BIT_SUFFIX) |
| |
| #endif /* __TEST_H__ */ |