sergiotarxz/nuttx-apps
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
95acf6c904
nuttx-apps/testing/ostest/ostest.h
Zhe Weng 412505d286 ostest: Introduce basic work queue test 
The test consists of two parts:
- A tester that tries to trigger wrong states of work queue
- A verifier that checks whether the wqueue is still working properly

The tester is trying to queue and cancel work several times with
priority lower/same/higher than the work queue.

Most wrong cases are likely to happen with high priority like:
- If `cancel` never decreases semcount, the count may keep growing
  and finally overflow
- If `cancel` is decreasing semcount too much, the `work_thread` may
  be waken up less times than expected

The lower/same priority testers are just added for covering other
unexpected situations.

The verifier is trying to queue some works and check they are called as
expected:
- Frist queue a 'sleep' worker, to let a work queue thread be in busy
  status and not waiting on sem, while other work queue thread(s) (if
  any) still waiting for sem. If sem is in wrong state, it may cause
  wrong behavior in either thread waiting/not waiting on the sem.
- Then queue a few count works, if the work queue(s) are still working
  properly, these works should finally be all called once.

Signed-off-by: Zhe Weng <wengzhe@xiaomi.com>
2023-03-22 12:56:01 +02:00

269 lines
7.8 KiB
C
Raw Blame History

/****************************************************************************
* apps/testing/ostest/ostest.h
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
#ifndef __APPS_TESTING_OSTEST_OSTEST_H
#define __APPS_TESTING_OSTEST_OSTEST_H
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/config.h>
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
/* The task_create task size can be specified in the defconfig file */
#ifdef CONFIG_TESTING_OSTEST_STACKSIZE
# define STACKSIZE CONFIG_TESTING_OSTEST_STACKSIZE
#else
# define STACKSIZE 8192
#endif
/* The number of times to execute the test can be specified in the defconfig
* file.
*/
#ifndef CONFIG_TESTING_OSTEST_LOOPS
# define CONFIG_TESTING_OSTEST_LOOPS 1
#endif
/* This is the number of threads that are created in the barrier test.
* A smaller number should be selected on systems without sufficient memory
* to start so many threads.
*/
#ifndef CONFIG_TESTING_OSTEST_NBARRIER_THREADS
# define CONFIG_TESTING_OSTEST_NBARRIER_THREADS 8
#endif
/* Priority inheritance */
#if defined(CONFIG_DEBUG_FEATURES) && defined(CONFIG_PRIORITY_INHERITANCE) && defined(CONFIG_SEM_PHDEBUG)
# define dump_nfreeholders(s) printf(s " nfreeholders: %d\n", sem_nfreeholders())
#else
# define dump_nfreeholders(s)
#endif
/* If CONFIG_STDIO_LINEBUFFER is defined, the STDIO buffer will be flushed
* on each new line. Otherwise, STDIO needs to be explicitly flushed to
* see the output in context.
*/
#ifndef CONFIG_STDIO_BUFFER_SIZE
# define CONFIG_STDIO_BUFFER_SIZE 0
#endif
#if defined(CONFIG_FILE_STREAM) && CONFIG_STDIO_BUFFER_SIZE > 0 && \
!defined(CONFIG_STDIO_LINEBUFFER)
# define FFLUSH() fflush(stdout)
#else
# define FFLUSH()
#endif
/****************************************************************************
* Public Types
****************************************************************************/
/****************************************************************************
* Public Data
****************************************************************************/
/****************************************************************************
* Public Function Prototypes
****************************************************************************/
/* getopt.c *****************************************************************/
int getopt_test(void);
/* setvbuf.c ****************************************************************/
#ifndef CONFIG_STDIO_DISABLE_BUFFERING
int setvbuf_test(void);
#endif
/* dev_null.c ***************************************************************/
int dev_null(void);
/* fpu.c ********************************************************************/
void fpu_test(void);
/* aio.c ********************************************************************/
#ifdef CONFIG_TESTING_OSTEST_AIO
void aio_test(void);
#endif
/* restart.c ****************************************************************/
void restart_test(void);
/* waitpid.c ****************************************************************/
#ifdef CONFIG_SCHED_WAITPID
int waitpid_test(void);
#endif
/* wqueue.c *****************************************************************/
#if defined(CONFIG_SCHED_LPWORK) || defined(CONFIG_SCHED_HPWORK)
void wqueue_test(void);
#endif
/* mutex.c ******************************************************************/
void mutex_test(void);
/* timedmutex.c *************************************************************/
void timedmutex_test(void);
/* rmutex.c *****************************************************************/
void recursive_mutex_test(void);
/* sem.c ********************************************************************/
void sem_test(void);
/* semtimed.c ***************************************************************/
void semtimed_test(void);
/* nsem.c *******************************************************************/
void nsem_test(void);
/* cond.c *******************************************************************/
void cond_test(void);
/* specific.c ***************************************************************/
void specific_test(void);
/* mqueue.c *****************************************************************/
void mqueue_test(void);
/* timedmqueue.c ************************************************************/
void timedmqueue_test(void);
/* cancel.c *****************************************************************/
void cancel_test(void);
/* robust.c *****************************************************************/
#ifndef CONFIG_PTHREAD_MUTEX_UNSAFE
void robust_test(void);
#endif
/* timedwait.c **************************************************************/
void timedwait_test(void);
/* sigprocmask.c ************************************************************/
void sigprocmask_test(void);
/* sighand.c ****************************************************************/
void sighand_test(void);
/* signest.c ****************************************************************/
void signest_test(void);
/* suspend.c ****************************************************************/
void suspend_test(void);
/* posixtimers.c ************************************************************/
void timer_test(void);
void sigev_thread_test(void);
/* roundrobin.c *************************************************************/
void rr_test(void);
/* sporadic.c ***************************************************************/
void sporadic_test(void);
/* sporadic2.c **************************************************************/
void sporadic2_test(void);
/* tls.c ********************************************************************/
void tls_test(void);
/* pthread_rwlock.c *********************************************************/
void pthread_rwlock_test(void);
/* pthread_rwlock_cancel.c **************************************************/
void pthread_rwlock_cancel_test(void);
/* pthread_cleanup.c ********************************************************/
void pthread_cleanup_test(void);
/* barrier.c ****************************************************************/
void barrier_test(void);
/* prioinherit.c ************************************************************/
void priority_inheritance(void);
/* vfork.c ******************************************************************/
#if defined(CONFIG_ARCH_HAVE_VFORK) && defined(CONFIG_SCHED_WAITPID)
int vfork_test(void);
#endif
/* setjmp.c *****************************************************************/
void setjmp_test(void);
/* APIs exported (conditionally) by the OS specifically for testing of
* priority inheritance
*/
#if defined(CONFIG_DEBUG_FEATURES) && defined(CONFIG_PRIORITY_INHERITANCE) && defined(CONFIG_SEM_PHDEBUG)
void sem_enumholders(FAR sem_t *sem);
int sem_nfreeholders(void);
#else
# define sem_enumholders(sem)
# define sem_nfreeholders()
#endif
#endif /* __APPS_TESTING_OSTEST_OSTEST_H */
Reference in New Issue View Git Blame Copy Permalink