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