Re: Debugger in beta3

[p5sagit/p5-mst-13.2.git] / lib / Sys / Hostname.pm

diff --git a/lib/Sys/Hostname.pm b/lib/Sys/Hostname.pm
index 4dd4fe2..457bf1a 100644 (file)
--- a/lib/Sys/Hostname.pm
+++ b/lib/Sys/Hostname.pm
@@ -1,21 +1,65 @@
-# by David Sundstrom   sunds@asictest.sc.ti.com
-#    Texas Instruments
-
 package Sys::Hostname;
 
 use Carp;
+use Config;
 require Exporter;
 @ISA = qw(Exporter);
 @EXPORT = qw(hostname);
 
-#
-# Try every conceivable way to get hostname.
-# 
+=head1 NAME
+
+Sys::Hostname - Try every conceivable way to get hostname
+
+=head1 SYNOPSIS
+
+    use Sys::Hostname;
+    $host = hostname;
+
+=head1 DESCRIPTION
+
+Attempts several methods of getting the system hostname and
+then caches the result.  It tries C<syscall(SYS_gethostname)>,
+C<`hostname`>, C<`uname -n`>, and the file F</com/host>.
+If all that fails it C<croak>s.
+
+All nulls, returns, and newlines are removed from the result.
+
+=head1 AUTHOR
+
+David Sundstrom <sunds@asictest.sc.ti.com>
+
+Texas Instruments
+
+=cut
 
 sub hostname {
 
-    # method 1 - we already know it
-    return $host if defined $host;
+  # method 1 - we already know it
+  return $host if defined $host;
+
+  if ($Config{'osname'} eq 'VMS') {
+
+    # method 2 - no sockets ==> return DECnet node name
+    if (!$Config{'d_has_sockets'}) { return $host = $ENV{'SYS$NODE'}; }
+
+    # method 3 - has someone else done the job already?  It's common for the
+    #    TCP/IP stack to advertise the hostname via a logical name.  (Are
+    #    there any other logicals which TCP/IP stacks use for the host name?)
+    $host = $ENV{'ARPANET_HOST_NAME'}  || $ENV{'INTERNET_HOST_NAME'} ||
+            $ENV{'MULTINET_HOST_NAME'} || $ENV{'UCX$INET_HOST'}      ||
+            $ENV{'TCPWARE_DOMAINNAME'} || $ENV{'NEWS_ADDRESS'};
+    return $host if $host;
+
+    # method 4 - does hostname happen to work?
+    my($rslt) = `hostname`;
+    if ($rslt !~ /IVVERB/) { ($host) = $rslt =~ /^(\S+)/; }
+    return $host if $host;
+
+    # rats!
+    Carp::croak "Cannot get host name of local machine";  
+
+  }
+  else {  # Unix
 
     # method 2 - syscall is preferred since it avoids tainting problems
     eval {
@@ -48,6 +92,7 @@ sub hostname {
     # remove garbage 
     $host =~ tr/\0\r\n//d;
     $host;
+  }
 }
 
 1;