1App::ClusterSSH::Host(3Upsme)r Contributed Perl DocumentaAtpipo:n:ClusterSSH::Host(3pm)
2
3
4

SYNOPSIS

6           use ClusterSSH::Host;
7
8           my $host = ClusterSSH::Host->new({
9               hostname => 'hostname',
10           });
11           my $host = ClusterSSH::Host->parse_host_string('username@hostname:1234');
12

DESCRIPTION

14       Object representing a host.  Include details to contact the host such
15       as hostname/ipaddress, username and port.
16

METHODS

18       $host=ClusterSSH::Host->new ({ hostname => 'hostname' })
19           Create a new host object.  'hostname' is a required arg, 'username'
20           and 'port' are optional.  Raises exception if an error occurs.
21
22       $host->get_hostname
23       $host->get_username
24       $host->get_port
25       $host->get_master
26       $host->get_geometry
27       $host->get_type
28           Return specific details about the host
29
30       $host->set_username
31       $host->set_port
32       $host->set_master
33       $host->set_geometry
34       $host->set_type
35           Set specific details about the host after its been created.
36
37       get_realname
38           If the server name provided is not an IP address (either IPv4 or
39           IPv6) attempt to resolve it and retun the discovered names.
40
41       get_givenname
42           Alias to get_hostname, for use when " get_realname " might return
43           something different
44
45       parse_host_string
46           Given a host string, returns a host object.  Parses hosts such as
47
48       check_ssh_hostname
49           Check the objects hostname to see whether or not it may be
50           configured within the users  $HOME/.ssh/config  configuration file
51
52       read_ssh_file
53           Method to ease reading in ssh configuration files.  Used for
54           grabbing hostnames for validation when used in clusters
55
56           host
57           192.168.0.1
58           user@host
59           user@192.168.0.1
60           host:port
61           [1234:1234:1234::4567]:port
62           1234:1234:1234::4567
63
64           and so on.  Cope with IPv4 and IPv6 addresses - raises a warning if
65           the IPv6 address is ambiguous (i.e. in the last example, is the
66           4567 part of the IPv6 address or a port definition?) and assumes it
67           is part of address.  Use brackets to avoid seeing warning.
68
69
70
71perl v5.38.0                      2023-07-19        App::ClusterSSH::Host(3pm)
Impressum