| 253 |
rodolico |
1 |
#!/usr/bin/env perl
|
|
|
2 |
use warnings;
|
|
|
3 |
use strict;
|
|
|
4 |
|
| 256 |
rodolico |
5 |
use version ; our $VERSION = '1.2.0';
|
| 253 |
rodolico |
6 |
|
|
|
7 |
# Microsoft network module for sysinfo client
|
|
|
8 |
# Author: R. W. Rodolico
|
|
|
9 |
# Date: 2025-03-30
|
| 256 |
rodolico |
10 |
#
|
| 253 |
rodolico |
11 |
# module to get network interface information for Windows systems
|
|
|
12 |
# uses Win32::Net::Info
|
|
|
13 |
# install with cpan install Win32::Net::Info
|
|
|
14 |
|
|
|
15 |
# find our location and use it for searching for libraries
|
|
|
16 |
BEGIN {
|
|
|
17 |
use FindBin;
|
|
|
18 |
use File::Spec;
|
| 256 |
rodolico |
19 |
# prepend the bin directory and its parent
|
|
|
20 |
use lib File::Spec->catdir($FindBin::Bin), File::Spec->catdir("$FindBin::Bin/..");
|
|
|
21 |
eval( 'use library;' );
|
|
|
22 |
die sprintf( "Could not find library.pm in %s, INC is %s\n", __FILE__, join( "\n", @INC ) ) if $@;
|
| 253 |
rodolico |
23 |
}
|
|
|
24 |
|
| 256 |
rodolico |
25 |
#####
|
|
|
26 |
##### Change these to match your needs
|
|
|
27 |
#####
|
| 253 |
rodolico |
28 |
|
| 256 |
rodolico |
29 |
# Make this a list of all the modules we are going to use. You can replace undef with the version you need, if you like
|
|
|
30 |
my $modulesList = {
|
|
|
31 |
'Data::Dumper' => undef,
|
|
|
32 |
'Win32::Net::Info' => undef,
|
|
|
33 |
};
|
| 253 |
rodolico |
34 |
|
| 256 |
rodolico |
35 |
# hash of commands that are needed for the system. key is the name of the command and, in some cases, the value will become
|
|
|
36 |
# the full path (from which or where)
|
|
|
37 |
my $commandsList = {
|
|
|
38 |
# 'smartctl' => undef,
|
|
|
39 |
};
|
| 253 |
rodolico |
40 |
|
| 256 |
rodolico |
41 |
# list of operating systems this module can be used on.
|
|
|
42 |
my $osList = {
|
|
|
43 |
'mswin32' => undef,
|
|
|
44 |
# 'freebsd' => undef,
|
|
|
45 |
# 'linux' => undef,
|
|
|
46 |
};
|
|
|
47 |
|
|
|
48 |
# the category the return data should go into. See sysinfo for a list
|
| 253 |
rodolico |
49 |
my $CATEGORY = 'network';
|
|
|
50 |
|
| 256 |
rodolico |
51 |
#####
|
|
|
52 |
##### End of required
|
|
|
53 |
#####
|
|
|
54 |
|
|
|
55 |
|
|
|
56 |
# some variables needed for our system
|
|
|
57 |
my $errorPrepend = 'error: in ' . __FILE__; # this is prepended to any error messages
|
|
|
58 |
my @out; # temporary location for each line of output
|
|
|
59 |
|
|
|
60 |
# Try to load the modules we need. If we can not, then make a list of missing modules for error message.
|
|
|
61 |
for my $module ( keys %$modulesList ) {
|
|
|
62 |
eval ( "use $module;" );
|
|
|
63 |
push @out, "$errorPrepend Could not load $module" if $@;
|
| 253 |
rodolico |
64 |
}
|
|
|
65 |
|
| 256 |
rodolico |
66 |
if ( ! @out && ! checkOS ( $osList ) ) { # check if we are on an acceptible operating system
|
|
|
67 |
push @out, "$errorPrepend Invalid Operating System";
|
|
|
68 |
}
|
|
|
69 |
if ( !@out && ! validCommandOnSystem ( $commandsList ) ) {
|
|
|
70 |
push @out, "$errorPrepend Can not find some commands needed";
|
|
|
71 |
}
|
|
|
72 |
if ( !@out ) { # we made it, we have everything, so do the processing
|
|
|
73 |
#####
|
|
|
74 |
##### Your code starts here. Remember to push all output onto @out
|
|
|
75 |
#####
|
|
|
76 |
foreach my $adapter ( Win32::Net::Info->interfaces) {
|
|
|
77 |
my $interface = Win32::Net::Info->new( $adapter );
|
|
|
78 |
my $name = $interface->name();
|
|
|
79 |
push @out, printf ( "%s\t$name\t%s\t%s", $CATEGORY, 'description', $interface->description() );
|
|
|
80 |
push @out, printf ( "%s\t$name\t%s\t%s", $CATEGORY, 'mac', $interface->mac() );
|
|
|
81 |
push @out, printf ( "%s\t$name\t%s\t%s", $CATEGORY, 'address', $interface->ipv4() );
|
|
|
82 |
push @out, printf ( "%s\t$name\t%s\t%s", $CATEGORY, 'netmask', $interface->ipv4_netmask() );
|
|
|
83 |
push @out, printf ( "%s\t$name\t%s\t%s", $CATEGORY, 'gateway', $interface->ipv4_default_gateway() ) if $interface->ipv4_default_gateway();
|
|
|
84 |
push @out, printf ( "%s\t$name\t%s\t%s", $CATEGORY, 'mtu', $interface->mtu() );
|
|
|
85 |
push @out, printf ( "%s\t$name\t%s\t%s", $CATEGORY, 'ip6address', $interface->ipv6() ) if $interface->ipv6();
|
|
|
86 |
push @out, printf ( "%s\t$name\t%s\t%s", $CATEGORY, 'ip6networkbits', $interface->ipv6_netmask() )if $interface->ipv6_netmask();
|
|
|
87 |
}
|
|
|
88 |
#####
|
|
|
89 |
##### Your code ends here.
|
|
|
90 |
#####
|
|
|
91 |
}
|
| 253 |
rodolico |
92 |
|
| 256 |
rodolico |
93 |
|
|
|
94 |
# If we are testing from the command line (caller is undef), print the results for debugging
|
|
|
95 |
print join( "\n", @out ) . "\n" unless caller;
|
|
|
96 |
# called by do, which has a value of the last assignment made, so make the assignment. The equivilent of a return
|
|
|
97 |
my $return = join( "\n", @out );
|
|
|
98 |
|