NAME

send_ncsa - a perl implementation of netsaint's send_nsca utility

DESCRIPTION

This simple utility sends a message over a TCP/IP connection to the Netsaint main server. It's basically a command line wrapper for Nsca.pm

SYNOPSIS

        Usage: send_nsca.pl [-p port] [-t to_sec] [-d delim] [-c config_file] [-l] [-x] <host_address> 

        Options:
         <host_address> = The IP address or name of the host running the NSCA daemon
         [port]         = The port on which the daemon is running - default is 5667
         [to_sec]       = Number of seconds before connection attempt times out.
                          (default timeout is 10 seconds)
         [delim]        = Delimiter to use when parsing input (defaults to a tab)
         [config_file]  = Name of config file to use
         -l             = Use the local_message method to inform a NetSaint on the local
                          machine (default is to go over the network)
         -x             = Display internal tracing messages fro debugging
        Then supply one line on standard input, of the format:
        <host_name>[tab]<svc_description>[tab]<return_code>[tab]<plugin_output>[newline]

COPYRIGHT ETC

This software is a reimplementation of send_nsca by Ethan Galdstd. Relevant excerpts from the source appear here:

         *
         * SEND_NSCA.C - NSCA Client
         * License: GPL
         * Copyright (c) 2000-2001 Ethan Galstad (netsaint@netsaint.org)
         *
         * Last Modified: 11-19-2001
         *
         * Command line: SEND_NSCA <host_address> [-p port] [-to to_sec] [-c config_file]
         *********************************************************************************/
        /************************************************************************
         * COMMON.H - NSCA Common Include File
         * Copyright (c) 1999-2001 Ethan Galstad (netsaint@netsaint.org)
         * Last Modified: 11-19-2001
         * License:
         * 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 of the License, 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., 675 Mass Ave, Cambridge, MA 02139, USA.
         ************************************************************************/

PERL VERSION

P Kent, Started Nov 2001 $Id: send_nsca.pl,v 1.2 2001/12/14 01:25:15 piers Exp $