===========
-v: Verbose
===========

| The :doc:`-v <verbose>` option will print status messages to stderr.
| This can be useful to see whether a machine has connected to your server or whether a connection attempt was successful or not.

Example
=======

1. Create a test TCP server:

.. tab:: Unix

   .. code-block:: sh

      pync -lv localhost 8000

.. tab:: Windows

   .. code-block:: sh

      py -m pync -lv localhost 8000

.. tab:: Python

   .. code-block:: python

      import pync
      pync.run('-lv localhost 8000')

2. On a separate console, connect to the server:

.. tab:: Unix

   .. code-block:: sh

      pync -v localhost 8000

.. tab:: Windows

   .. code-block:: sh

      py -m pync -v localhost 8000

.. tab:: Python

   .. code-block:: python

      import pync
      pync.run('-v localhost 8000')

You should now be able to see messages printed on each
console indicating that the connection was successful:

.. tab:: Server

   .. code-block:: sh

      Listening on [localhost] (family 2, port 8000)
      Connection from [127.0.0.1] port 8000 [tcp/*] accepted (family 2, sport 44650)

.. tab:: Client

   .. code-block:: sh

      Connection to 127.0.0.1 8000 port [tcp/*] succeeded!

.. raw:: html

   <br>

| You can also create a simple port scanner by combining :doc:`-v <verbose>` with the :doc:`-z <zero-io>` option.
| See :doc:`../usage/port-scanning` for more.

.. raw:: html

   <br>
   <hr>

:SEE ALSO:

* :doc:`listen`
* :doc:`zero-io`
* :doc:`../usage/port-scanning`