#!/usr/bin/perl -w -T
# +=======================================================================+
# || cipux_rpc_test_client                                               ||
# ||                                                                     ||
# || Testclient for CipUX XML-RPC Server                                 ||
# ||                                                                     ||
# || Copyright (C) 2007 - 2008 by Christian Kuelker.                     ||
# ||                                                                     ||
# || License: GNU GPL - GNU General Public License - version 2           ||
# ||          or (at your opinion) any later version.                    ||
# ||                                                                     ||
# +=======================================================================+
# ID:       $Id$
# Revision: $Revision$
# Head URL: $HeadURL$
# Date:     $Date$
# Source:   $Source$

package cipux_rpc_test_client;

use 5.008001;
use strict;
use warnings;
use CipUX::RPC::Test::Client;
use version; our $VERSION = qv('3.4.0.0');
delete @ENV{qw(PATH IFS CDPATH ENV BASH_ENV)};    # Make %ENV safer

# +=============================================================================+
# || MAIN                                                                      ||
# +=============================================================================+
my $client
    = CipUX::RPC::Test::Client->new( { name => 'cipux_rpc_test_client' } );

$client->run();

exit 0;

__END__


=pod

=head1 NAME

cipux_rpc_test_client

=head1 VERSION

version 3.4.0.0

=head1 SYNOPSIS

 cipux_rpc_test_client [OPTIONS]
 cipux_rpc_test_client --help|-h
 cipux_rpc_test_client --version|-V

 Options:
 --debug           : prints debug messages to cipux-test.log
 --host <NAME>     : rpc server address, examples: localhost, 127.0.0.1, ldap
 --maxtest <NUMBER>: executes until and including max. number of tests
 --no-ssl          : rpc server use no SSL
 --port <NUMBER>   : rpc server port, example: 8001
 --ssl             : rpc server use SSL

=head1 DESCRIPTION

This is a test script for users admins or packages to test if the cipux-RPC
server is working.

=head1 REQUIRED ARGUMENTS

None.

=head1 OPTIONS

=over 4

I<--debug>

Prints debug messages to cipux-test.log.

I<-h>

See --help

I<--help>

Prints short usage message.

I<--host NAME>

Address of the RPC server. For example localhost, 127.0.0.1, ldap or other
names.

I<--maxtest NUMBER_OF_TESTS>

Runs up to NUMBER_OF_TESTS tests. The script can not stop after every test, but
after the next possible test. Useful for debugging.

I<--no-ssl>

Access CipUX XML-RPC server only over http, not https.

I<--port NUMBER>

Port number of the XML RPC server. For example 8001.

I<--ssl>

Access CipUX XML-RPC server over SSL aka https.

=back


=head1 DIAGNOSTICS

None.

=head1 EXIT STATUS

 1 on failure

 0 on success

 other from XML-RPC server

=head1 CONFIGURATION

not needet.

=head1 DEPENDENCIES

 CipUX::RPC::Test::Client
 version

=head1 INCOMPATIBILITIES

Not known.

=head1 BUGS AND LIMITATIONS

Not known.

=head1 AUTHOR

Christian Kuelker  E<lt>christian.kuelker@cipworx.orgE<gt>

=head1 LICENSE AND COPYRIGHT

Copyright (C) 2007 - 2008 by Christian Kuelker

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307 USA

=cut

