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

#  pmhostname(1) — Linux manual page

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

##  NAME  top

    
    
           **pmhostname** - report hostname
    

##  SYNOPSIS  top

    
    
           **pmhostname**[**-?**]  [_hostname_]
    

##  DESCRIPTION  top

    
    
           **pmhostname** reports the name of the host _hostname_ as returned by
           [gethostbyname(3)](../man3/gethostbyname.3.html).
    
           If _hostname_ is not specified, then the local host name is
           retrieved using [gethostname(2)](../man2/gethostname.2.html) and this is than passed to
           [gethostbyname(3)](../man3/gethostbyname.3.html).
    
           **pmhostname** provides a service for shell scripts that mimics the
           logic formerly used by Performance Co-Pilot applications when
           trying to determine the official name of a host.  PCP
           applications no longer use DNS-based heuristics, and therefore
           this command is _deprecated_.
    
           If [gethostbyname(3)](../man3/gethostbyname.3.html) fails, the input host name (either _hostname_
           or the result from calling [gethostname(2)](../man2/gethostname.2.html)) is reported.
    

##  OPTIONS  top

    
    
           The available command line options are:
    
           **-?** , **--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

    
    
           **nslookup**(1), [gethostname(2)](../man2/gethostname.2.html), [gethostbyname(3)](../man3/gethostbyname.3.html), [pcp.conf(5)](../man5/pcp.conf.5.html),
           [pcp.env(5)](../man5/pcp.env.5.html) and [resolver(5)](../man5/resolver.5.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                     _PMHOSTNAME_(1)
    

* * *

Pages that refer to this page: [ pmcd(1) ](../man1/pmcd.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 programming training courses** that I teach, look [ here ](https://man7.org/training/) .  Hosting by [ jambit GmbH ](https://www.jambit.com/index_en.html) .  |  |  [ ![Cover of TLPI](https://man7.org/tlpi/cover/TLPI-front-cover-vsmall