OrgZephyr/zephyr
OrgZephyr
/
zephyr
mirror of https://github.com/zephyrproject-rtos/zephyr.git
1
0
Fork 0
Code Issues Releases Wiki Activity
zephyr/samples/posix/philosophers/README.rst

56 lines
1.4 KiB
ReStructuredText
Raw Normal View History

samples: posix: use zephyr:code-sample directive Describe the samples using code-sample directive in preparation for upcoming changes to the Zephyr documentation that will be leveraging the provided description and metadata. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-08-24 00:47:19 +08:00
.. zephyr:code-sample:: posix-philosophers
:name: POSIX Philosophers
samples: posix: implement philosphers using pthreads This sample takes a POSIX-y spin on the existing Dining Philosophers sample application. The objects used in the POSIX version are pthread_mutex_t, and the threads are pthread_t. Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2024-01-15 00:23:40 +08:00
samples: posix: use zephyr:code-sample directive Describe the samples using code-sample directive in preparation for upcoming changes to the Zephyr documentation that will be leveraging the provided description and metadata. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-08-24 00:47:19 +08:00
Implement a solution to the Dining Philosophers problem using the POSIX API.
samples: posix: implement philosphers using pthreads This sample takes a POSIX-y spin on the existing Dining Philosophers sample application. The objects used in the POSIX version are pthread_mutex_t, and the threads are pthread_t. Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2024-01-15 00:23:40 +08:00
Overview
********
samples: doc: convert philosophers sample to code-sample directive Adopt zephyr:code-sample directive to describe the Dining Philosophers sample and update reference accordingly. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-09-16 22:28:19 +08:00
This sample implements Zephyr's :zephyr:code-sample:`dining-philosophers` sample using the
samples: posix: implement philosphers using pthreads This sample takes a POSIX-y spin on the existing Dining Philosophers sample application. The objects used in the POSIX version are pthread_mutex_t, and the threads are pthread_t. Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2024-01-15 00:23:40 +08:00
:ref:`POSIX API <posix_support>`. The source code for this sample can be found under
:file:`samples/posix/philosophers`.
Building and Running
********************
samples: posix: philosophers: minor spacing corrections Fix spacing and wrapping in the README.rst file. Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2024-01-31 13:24:09 +08:00
This project outputs to the console. It can be built and executed on QEMU as follows:
samples: posix: implement philosphers using pthreads This sample takes a POSIX-y spin on the existing Dining Philosophers sample application. The objects used in the POSIX version are pthread_mutex_t, and the threads are pthread_t. Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2024-01-15 00:23:40 +08:00
.. zephyr-app-commands::
:zephyr-app: samples/posix/philosophers
:host-os: unix
:board: qemu_riscv64
:goals: run
:compact:
Sample Output
=============
.. code-block:: console
Philosopher 0 [P: 3] HOLDING ONE FORK
Philosopher 1 [P: 2] HOLDING ONE FORK
Philosopher 2 [P: 1] EATING [ 1900 ms ]
Philosopher 3 [P: 0] THINKING [ 2500 ms ]
Philosopher 4 [C:-1] THINKING [ 2200 ms ]
Philosopher 5 [C:-2] THINKING [ 1700 ms ]
Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.
Debugging
*********
Like the original philosophers sample, the POSIX variant also enables
:kconfig:option:`CONFIG_DEBUG_THREAD_INFO` by default.
.. zephyr-app-commands::
:zephyr-app: samples/philosophers
:host-os: unix
:board: <board_name>
:goals: debug
:compact:
Additional Information
**********************
samples: doc: convert philosophers sample to code-sample directive Adopt zephyr:code-sample directive to describe the Dining Philosophers sample and update reference accordingly. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-09-16 22:28:19 +08:00
For additional information, please refer to the :zephyr:code-sample:`dining-philosophers` sample.