Metadata-Version: 2.1
Name: pingtop
Version: 0.4.0
Summary: Ping multiple servers and show the result in a top like terminal UI.
Home-page: https://github.com/laixintao/pingtop
Author: laixintao
Author-email: laixintaoo@gmail.com
License: UNKNOWN
Description: pingtop 
        =======
        
        
        Ping multiple servers and show the result in a top like terminal UI.
        
        |asciicast|
        
        Install
        -------
        
        ::
        
           pip install pingtop
        
        
        ** pingtop support Python3.8 Python3.8. **
        
        There is a dependency (`blist <http://stutzbachenterprises.com/blist/>`) not supporting Python3.9, so please pingtop can't support 3.9.
        
        Usage
        -----
        
        Then ping mutiple server:
        
        ::
        
           pingtop baidu.com google.com twitter.com
        
        This project is using
        `click <https://click.palletsprojects.com/en/7.x/>`__. Check help info
        with ``pingtop -h``.
        
        ::
        
           ~ pingtop --help
           Usage: pingtop [OPTIONS] [HOST]...
        
           Options:
             -s, --packetsize INTEGER        specify the number of data bytes to be sent.
                                             The default is 56, which translates into 64
                                             ICMP data bytes when combined with the 8
                                             bytes of ICMP header data.  This option
                                             cannot be used with ping sweeps.  [default:
                                             56]
             -l, --logto PATH
             -v, --log-level [DEBUG|INFO|WARNING|ERROR|CRITICAL]
             --help                          Show this message and exit.
        
        Why do I get ``Permission denied`` ?
        ------------------------------------
        
        We use ICMP socket to send ping packet without ``sudo`` (See `this
        post <https://blog.lilydjwg.me/2013/10/29/non-privileged-icmp-ping.41390.html>`__
        by lilydjwg(in Chinese)), however, who(which group) can use this feature
        is controled by a kernel parameter: ``net.ipv4.ping_group_range``.
        
        ::
        
           cat /proc/sys/net/ipv4/ping_group_range
        
           1    0
        
        The default value is ``1 0``, this means the whose group number from 1
        to 0 can use this feature(which means nobody can use this), so you get a
        Permission denied .
        
        To fix this, change this variable to a proper range include your group
        id, like this:
        
        ::
        
           [vagrant@centos7 pingtop]$ id
           uid=1000(vagrant) gid=1000(vagrant) groups=1000(vagrant) context=unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023
        
           [vagrant@centos7 pingtop]$ sudo sysctl -w net.ipv4.ping_group_range='0 1001'
           net.ipv4.ping_group_range = 0 1001
        
        Credits
        -------
        
        -  For the credits of ping.py’s implementation please refer
           `ping.py <./pingtop/ping.py>`__.
        -  The UI was built on `panwid <https://github.com/tonycpsu/panwid>`__
           thanks to @tonycpsu.
        -  @\ `gzxultra <https://github.com/gzxultra>`__ helped to solve the
           permission issues.
        
        .. |CircleCI| image:: https://circleci.com/gh/laixintao/pingtop.svg?style=svg
           :target: https://circleci.com/gh/laixintao/pingtop
        .. |asciicast| image:: https://asciinema.org/a/onbBCmHzhltau7iqButUGx6yu.svg
           :target: https://asciinema.org/a/onbBCmHzhltau7iqButUGx6yu
        
Keywords: IP,ping,icmp
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/x-rst
