#!/usr/bin/env perl use warnings; use strict; use version ; our $VERSION = 'v1.0.0'; # Template for modules to be used in sysinfo # Author: R. W. Rodolico # Date: 2025-04-02 # # Enter some information about system here # # Revision History # # 20250402 v4.0.0 Rodolico # Modified for v4 of sysinfo_client, using extended tests for modules, files used and operating systems # Underlying code remains unchanged # # find our location and use it for searching for libraries. library.pm must be in the same directory as the calling script # or, if run interactively, in the parent of the modules BEGIN { use FindBin; use File::Spec; # prepend the bin directory and its parent use lib File::Spec->catdir($FindBin::Bin), File::Spec->catdir("$FindBin::Bin/.."); eval( 'use library;' ); die sprintf( "Could not find library.pm in %s, INC is %s\n", __FILE__, join( "\n", @INC ) ) if $@; } ##### ##### Change these to match your needs ##### # 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 my $modulesList = { 'Data::Dumper' => undef, }; # hash of commands that are needed for the system. key is the name of the command and, in some cases, the value will become # the full path (from which or where) my $commandsList = { 'lsb_release' => undef, 'uname' => undef, }; # list of operating systems this module can be used on. my $osList = { # 'mswin32' => undef, # 'freebsd' => undef, 'linux' => undef, }; # the category the return data should go into. See sysinfo for a list my $CATEGORY = 'operatingsystem'; ##### ##### End of required ##### # some variables needed for our system my $errorPrepend = 'error: in ' . __FILE__; # this is prepended to any error messages my @out; # temporary location for each line of output # Try to load the modules we need. If we can not, then make a list of missing modules for error message. for my $module ( keys %$modulesList ) { eval ( "use $module;" ); push @out, "$errorPrepend Could not load $module" if $@; } if ( ! @out && ! checkOS ( $osList ) ) { # check if we are on an acceptible operating system push @out, "$errorPrepend Invalid Operating System"; } if ( !@out && ! validCommandOnSystem ( $commandsList ) ) { push @out, "$errorPrepend Can not find some commands needed"; } if ( !@out ) { # we made it, we have everything, so do the processing ##### ##### Your code starts here. Remember to push all output onto @out my $command = 'lsb_release'; push @out, "$CATEGORY\tdistribution\t" . &cleanUp(':', qx($command -i)); push @out, "$CATEGORY\tdescription\t" . &cleanUp(':', qx($command -d)); push @out, "$CATEGORY\trelease\t" . &cleanUp(':', qx($command -r)); push @out, "$CATEGORY\tcodename\t" . &cleanUp(':', qx($command -c)); $command = 'uname'; push @out, "$CATEGORY\tos_name\t" . &cleanUp('', qx($command -s)); push @out, "$CATEGORY\tkernel\t" . &cleanUp('', qx($command -r)); push @out, "$CATEGORY\tos_version\t" . &cleanUp('', qx(cat /proc/version)) if -e '/proc/version'; ##### ##### Your code ends here. ##### } # If we are testing from the command line (caller is undef), print the results for debugging print join( "\n", @out ) . "\n" unless caller; # called by do, which has a value of the last assignment made, so make the assignment. The equivilent of a return my $return = join( "\n", @out );