1.. zephyr:code-sample:: posix-philosophers
2   :name: POSIX Philosophers
3
4   Implement a solution to the Dining Philosophers problem using the POSIX API.
5
6Overview
7********
8
9This sample implements Zephyr's :zephyr:code-sample:`dining-philosophers` sample using the
10:ref:`POSIX API <posix_support>`. The source code for this sample can be found under
11:file:`samples/posix/philosophers`.
12
13Building and Running
14********************
15
16This project outputs to the console. It can be built and executed on QEMU as follows:
17
18.. zephyr-app-commands::
19   :zephyr-app: samples/posix/philosophers
20   :host-os: unix
21   :board: qemu_riscv64
22   :goals: run
23   :compact:
24
25Sample Output
26=============
27
28.. code-block:: console
29
30   Philosopher 0 [P: 3]  HOLDING ONE FORK
31   Philosopher 1 [P: 2]  HOLDING ONE FORK
32   Philosopher 2 [P: 1]  EATING  [ 1900 ms ]
33   Philosopher 3 [P: 0]  THINKING [ 2500 ms ]
34   Philosopher 4 [C:-1]  THINKING [ 2200 ms ]
35   Philosopher 5 [C:-2]  THINKING [ 1700 ms ]
36
37Exit QEMU by pressing :kbd:`CTRL+A` :kbd:`x`.
38
39Debugging
40*********
41
42Like the original philosophers sample, the POSIX variant also enables
43:kconfig:option:`CONFIG_DEBUG_THREAD_INFO` by default.
44
45.. zephyr-app-commands::
46   :zephyr-app: samples/philosophers
47   :host-os: unix
48   :board: <board_name>
49   :goals: debug
50   :compact:
51
52Additional Information
53**********************
54
55For additional information, please refer to the :zephyr:code-sample:`dining-philosophers` sample.
56