NAME

CGI::AppBuilder::Net - Methods used for remote commands and network

SYNOPSIS

my $self = bless {}, "main";
use CGI::AppBuilder::Net;
$self->debug_level(2);   # set debug level to 2
# The level 3 message will not be displayed
$self->echo_msg("This is level 1 message.", 1);
$self->echo_msg("This is level 2 message.", 2);
$self->echo_msg("This is level 3 message.", 3);  

DESCRIPTION

The package contains the modules can be used for executing UNIX commands or initiate network connections.

new (ifn => 'file.cfg', opt => 'hvS:')

This is a inherited method from CGI::AppBuilder. See the same method in CGI::AppBuilder for more details.

exec_cmd ($cmd, $pr)

Input variables:

$cmd - a full unix command with paraemters and arguments
$pr  - parameter hash ref
  remote_host - Remote host name or ip address
  local_host  - local host name or ip address
  remote_usr  - Remote user name
  remote_pwd  - Remote user password

Variables used or routines called:

get_params - get values for multiple parameters

How to use:

use CGI::AppBuilder::Net qw(:all);
# Case 1: hosts are different and without id and password 
my $cmd = "cat /my/dir/file.txt"; 
my $pr = {datafax_host=>'dfsvr',local_host='svr2'};  
my @a = $self->exec_cmd($cmd,$pr);   # uses rsh to run the cmd 

# Case 2: different hosts with id and password 
my $pr = {datafax_host=>'dfsvr',local_host='svr2',
   datafax_usr=>'fusr', datafax_pwd=>'pwd' };  
my @a = $self->exec_cmd($cmd,$pr);   # uses rexec  

# Case 3: hosts are the same and just open a file
my $pr = {datafax_host=>'dfsvr',local_host='dfsvr'};  
my $ar = $self->exec_cmd('/my/file.txt',$pr); # case 2:  

# Case 4: hosts are the same and run a program
my $pr = {datafax_host=>'dfsvr',local_host='dfsvr'};  
my $ar = $self->exec_cmd('cat /my/file.txt',$pr); # case 2:  

Return: array or array ref

This method opens a file or runs a command and return the contents in array or array ref.

CODING HISTORY

• Version 0.10

  Extracted exec_cmd from DataFax::StudySubs.

• Version 0.11

  No there yet.

FUTURE IMPLEMENTATION

• no plan yet

AUTHOR

Copyright (c) 2007 Hanming Tu. All rights reserved.

This package is free software and is provided "as is" without express or implied warranty. It may be used, redistributed and/or modified under the terms of the Perl Artistic License (see http://www.perl.com/perl/misc/Artistic.html)