ftphandler.h File Reference

Detailed Description

Derived from tcptxthandler. Attempts to connect() and then does a protocol specific service check.

If no port is provided in URL, the standard port is used.

Wire keywords (standard handler keywords documented in Wire )

url: URL (host:[port]) (port is optional and overrides default)
connect: event (optional)
noconnect: event (optional)
service: event (optional)
noservice: event (optional)
timeout: float units == seconds (optional)

Example:


set noconnect create event { name: "noconnect"  priority: 1 }
set noservice create event { name: "noservice"  priority: 1 }

create handler ftp { 
 url: ftp://ftp.mydomain.com
 noconnect: $noconnect
 noservice: $noservice
 timeout: 5
 cycletime: 60
}

Events generated:

Event Name Type Description

connect AW_EVENT_TYPE_STRING Was able to connect, send string of "url"

noconnect AW_EVENT_TYPE_STRING Was NOT able to connect, send string of "url"

service AW_EVENT_TYPE_STRING service check successful, send string of "url"

noservice AW_EVENT_TYPE_STRING service check UNsuccessful, send string of "url"

Event Name	Type	Description
connect	AW_EVENT_TYPE_STRING	Was able to connect, send string of "url"
noconnect	AW_EVENT_TYPE_STRING	Was NOT able to connect, send string of "url"
service	AW_EVENT_TYPE_STRING	service check successful, send string of "url"
noservice	AW_EVENT_TYPE_STRING	service check UNsuccessful, send string of "url"

#include "tcptxthandler.h"

Go to the source code of this file.

Typedefs

typedef aw_tcptxthandler_events_t aw_ftphandler_events_t

typedef aw_tcptxthandler_t aw_ftphandler_t

Functions

aw_ftphandler_t * aw_create_ftphandler (const aw_ftphandler_events_t *events, const byte_t *url, const aw_timestamp_t timeout, int32_t(*regevent)(aw_handler_t *h, aw_address_t *eventid, u_int32_t index), int32_t(*regmaskevent)(aw_handler_t *h, aw_address_t *eventid, u_int32_t index), const aw_alarm_sched_t *sched, aw_logger_t *logger)

Create a ftp handler.

void aw_free_ftphandler (aw_ftphandler_t *p)

Free handler and all associated resources.

aw_handler_t * aw_wire_ftphandler (aw_wire_mkhandler_args_t *args)

Create a ftp handler using "wire". See header doc for keyword documentation.

Typedef Documentation

typedef aw_tcptxthandler_events_t aw_ftphandler_events_t

typedef aw_tcptxthandler_t aw_ftphandler_t

Function Documentation

aw_ftphandler_t* aw_create_ftphandler ( const aw_ftphandler_events_t * events,

const byte_t * url,

const aw_timestamp_t timeout,

int32_t(* regevent)(aw_handler_t *h, aw_address_t *eventid, u_int32_t index),

int32_t(* regmaskevent)(aw_handler_t *h, aw_address_t *eventid, u_int32_t index),

const aw_alarm_sched_t * sched,

aw_logger_t * logger

)

Create a ftp handler.
aw_create_ftphandler

Parameters:

events Events to generate

url Url (gives us host and port)

timeout Max time to run

regevent Function pointer for event registration

regmaskevent Function pointer for event mask registration

sched Run schedule

logger Logger object

Returns:
Handler object

void aw_free_ftphandler ( aw_ftphandler_t * p )

Free handler and all associated resources.
aw_free_ftphandler

Parameters:

p The handler

aw_handler_t* aw_wire_ftphandler ( aw_wire_mkhandler_args_t * args )

Create a ftp handler using "wire". See header doc for keyword documentation.
aw_wire_ftphandler


Typedefs
typedef aw_tcptxthandler_events_t	aw_ftphandler_events_t
typedef aw_tcptxthandler_t	aw_ftphandler_t
Functions
aw_ftphandler_t *	aw_create_ftphandler (const aw_ftphandler_events_t events, const byte_t url, const aw_timestamp_t timeout, int32_t(regevent)(aw_handler_t h, aw_address_t eventid, u_int32_t index), int32_t(regmaskevent)(aw_handler_t h, aw_address_t eventid, u_int32_t index), const aw_alarm_sched_t sched, aw_logger_t logger)
	Create a ftp handler.
void	aw_free_ftphandler (aw_ftphandler_t *p)
	Free handler and all associated resources.
aw_handler_t *	aw_wire_ftphandler (aw_wire_mkhandler_args_t *args)
	Create a ftp handler using "wire". See header doc for keyword documentation.