1.. zephyr:code-sample:: net-promiscuous-mode
2   :name: Promiscuous mode
3   :relevant-api: promiscuous
4
5   Enable promiscuous mode on all interfaces and print information about incoming packets.
6
7Overview
8********
9
10This application will enable promiscuous mode for every network
11interface in the system. It will then start to listen for incoming
12network packets and show information about them.
13
14The application will also provide a shell so that user can enable
15or disable promiscuous mode at runtime. The commands are called
16``promisc on`` and ``promisc off``.
17
18Requirements
19************
20
21- :ref:`networking_with_host`
22
23Building and Running
24********************
25
26There are multiple ways to use this application. In this example QEMU
27is used:
28
29.. zephyr-app-commands::
30   :zephyr-app: samples/net/promiscuous_mode
31   :board: qemu_x86
32   :conf: <config file to use>
33   :goals: build
34   :compact:
35