[ man7.org ](../../../index.html) > Linux > [ man-pages ](../index.html) |  [ Linux/UNIX system programming training ](http://man7.org/training/)  
---|---  
  
* * *

#  pcp-shping(1) — Linux manual page

NAME  |  SYNOPSIS  |  DESCRIPTION  |  OPTIONS  |  PCP ENVIRONMENT  |  SEE ALSO  |  COLOPHON   
---  
|  
      
    
    _PCP-SHPING_(1)            General Commands Manual           _PCP-SHPING_(1)
    

##  NAME  top

    
    
           **pcp-shping** - report on shell service availability and response
    

##  SYNOPSIS  top

    
    
           **pcp**[_pcp options_] **shping**[**-cl?**]  _tag_ ...
    

##  DESCRIPTION  top

    
    
           **pcp-shping** samples and reports on the shell-ping service metrics
           exported by the [pmdashping(1)](../man1/pmdashping.1.html) agent.
    
           The default report from **pcp-shping** shows two columns for each
           service _tag_ , the first showing service status (zero indicating
           success) and the second service response time, for the last
           **pmdashping** command refresh cycle.
    
           When invoked via the [pcp(1)](../man1/pcp.1.html) command, the **-h** /**--host** , **-a** /**--archive** ,
           **-O** /**--origin** , **-s** /**--samples** , **-t** /**--interval** , **-Z** /**--timezone** and
           several other **pcp** _options_ become indirectly available, see
           [PCPIntro(1)](../man1/PCPIntro.1.html) for their descriptions.
    

##  OPTIONS  top

    
    
           The available command line options are:
    
           **-c** , **--status**
                Display a summary of the current shell-ping collector,
                including information about service refresh interval, the
                current command timeout setting, count of refreshes, and the
                full command line associated with each _tag_.
    
           **-l** , **--tags**
                Displays the valid _tag_ s.
    
           **-?** , **--help**
                Display usage message and exit.
    

##  PCP ENVIRONMENT  top

    
    
           Environment variables with the prefix **PCP_** are used to
           parameterize the file and directory names used by PCP.  On each
           installation, the file _/etc/pcp.conf_ contains the local values
           for these variables.  The **$PCP_CONF** variable may be used to
           specify an alternative configuration file, as described in
           [pcp.conf(5)](../man5/pcp.conf.5.html).
    

##  SEE ALSO  top

    
    
           [PCPIntro(1)](../man1/PCPIntro.1.html), [pcp(1)](../man1/pcp.1.html) and [pmdashping(1)](../man1/pmdashping.1.html).
    

##  COLOPHON  top

    
    
           This page is part of the _PCP_ (Performance Co-Pilot) project.
           Information about the project can be found at 
           â¨<http://www.pcp.io/>â©.  If you have a bug report for this manual
           page, send it to pcp@groups.io.  This page was obtained from the
           project's upstream Git repository
           â¨<https://github.com/performancecopilot/pcp.git>â© on 2023-12-22.
           (At that time, the date of the most recent commit that was found
           in the repository was 2023-12-16.)  If you discover any rendering
           problems in this HTML version of the page, or you believe there
           is a better or more up-to-date source for the page, or you have
           corrections or improvements to the information in this COLOPHON
           (which is _not_ part of the original manual page), send a mail to
           man-pages@man7.org
    
    Performance Co-Pilot               PCP                     _PCP-SHPING_(1)
    

* * *

Pages that refer to this page: [ pmdashping(1) ](../man1/pmdashping.1.html)

* * *

* * *

HTML rendering created 2023-12-22 by [ Michael Kerrisk ](https://man7.org/mtk/index.html) , author of [ _The Linux Programming Interface_ ](https://man7.org/tlpi/) .  For details of in-depth **Linux/UNIX system pr